weichen
a4ea66c41d
Why: Contract foundation for the inbox/command-bus/workspaces phase (proposal D28/D30): ActivityCard as the first-class state object behind the right-rail inbox, card.* stream events, inline-confirm anchoring (anchorMessageId + blocked/blockReason) on HITL, seven new UI schema vocabularies, plugin provides.commands/workspaces, workflow card step and workspace declarations. Evidence: go vet clean; conformance goldens regenerated and verified — new activity_card / hitl_card_blocked / event_card_created / event_card_resolved / ui_vocabularies samples plus extended plugin_manifest; CardStatus.Terminal helper unit-covered via build; ts/types.ts mirrors all additions. Impact: Additive only (omitempty fields, new types, new event types) — existing consumers ignore unknown values per forward-compat rule; vocabulary spec types carry a Spec suffix to avoid const-name collisions. Refs: modules/documents docs/proposals/2026-09-30-ui-inbox-command-workspace.md
96 lines
4.1 KiB
Go
96 lines
4.1 KiB
Go
package core
|
||
|
||
import "encoding/json"
|
||
|
||
// 插件 manifest（4.6）：插件 = manifest + 声明资产 + 可选代码。
|
||
// 校验失败整批拒绝（fail-closed）；卸载注销注册项，在途引用按定义缺失稳定报错。
|
||
|
||
const PluginAPIVersion = "1.0"
|
||
|
||
type PluginManifest struct {
|
||
ID string `json:"id"`
|
||
Name string `json:"name"`
|
||
Version string `json:"version"`
|
||
APIVersion string `json:"apiVersion"`
|
||
Requires PluginRequires `json:"requires,omitempty"`
|
||
Provides PluginProvides `json:"provides"`
|
||
}
|
||
|
||
type PluginRequires struct {
|
||
Network []string `json:"network,omitempty"` // 允许访问的域名（展示用，v1 自装自审）
|
||
}
|
||
|
||
type PluginProvides struct {
|
||
Tools []string `json:"tools,omitempty"` // tools/ 目录下的资产名
|
||
Workflows []string `json:"workflows,omitempty"`
|
||
Intents []string `json:"intents,omitempty"`
|
||
Prompts []string `json:"prompts,omitempty"`
|
||
Panels []string `json:"panels,omitempty"`
|
||
Cards []string `json:"cards,omitempty"`
|
||
Settings []string `json:"settings,omitempty"`
|
||
Commands []string `json:"commands,omitempty"` // commands/ 资产名（spec 权威在 Agent-Command 库）
|
||
Workspaces []string `json:"workspaces,omitempty"` // workspaces/ 资产名（工作区弹层）
|
||
}
|
||
|
||
// PluginPanel：右栏面板声明（UI schema 静态骨架 + 可选数据提供者）。
|
||
type PluginPanel struct {
|
||
ID string `json:"id"`
|
||
Title string `json:"title"`
|
||
Icon string `json:"icon,omitempty"`
|
||
Body []UINode `json:"body"`
|
||
// Tool 绑定：面板挂载时调用该工具刷新 Body 中的动态区（v1 简化为整体刷新）。
|
||
RefreshTool string `json:"refreshTool,omitempty"`
|
||
}
|
||
|
||
// WorkflowDef：工作流即数据（4.6）。Step 可产 HITL 卡片、调工具、产出工件。
|
||
type WorkflowDef struct {
|
||
ID string `json:"id"`
|
||
Title string `json:"title"`
|
||
Description string `json:"description,omitempty"`
|
||
IntentID string `json:"intentId,omitempty"` // 绑定意图（命中即启动）
|
||
Steps []WorkflowStep `json:"steps"`
|
||
}
|
||
|
||
type WorkflowStep struct {
|
||
ID string `json:"id"`
|
||
Title string `json:"title"`
|
||
Kind string `json:"kind"` // prompt | tool | hitl | artifact | card
|
||
Prompt string `json:"prompt,omitempty"` // prompt: 发给模型的指令模板
|
||
Tool string `json:"tool,omitempty"` // tool: 工具名
|
||
Args json.RawMessage `json:"args,omitempty"` // tool: 参数模板
|
||
Hitl *HITLCardTemplate `json:"hitl,omitempty"` // hitl: 卡片模板
|
||
Artifact string `json:"artifact,omitempty"` // artifact: 产出工件名模板
|
||
Card *ActivityCardTemplate `json:"card,omitempty"` // card: 产收件箱任务卡
|
||
}
|
||
|
||
// ActivityCardTemplate：工作流步骤产卡模板（kind=card）——步骤执行时生成
|
||
// ActivityCard（右栏收件箱），Body/Actions 走 UI 有限词汇；Actions 建议绑定命令。
|
||
type ActivityCardTemplate struct {
|
||
Kind CardKind `json:"kind"`
|
||
Title string `json:"title"`
|
||
Tone string `json:"tone,omitempty"`
|
||
Body []UINode `json:"body,omitempty"`
|
||
Actions []UIAction `json:"actions,omitempty"`
|
||
}
|
||
|
||
// PluginWorkspace：工作区弹层声明（深读与治理视图；Esc/遮罩关闭回对话现场，
|
||
// 不承载任何唯一步骤——每个操作必须另有命令路径，提案 D31）。
|
||
type PluginWorkspace struct {
|
||
ID string `json:"id"`
|
||
Title string `json:"title"`
|
||
Icon string `json:"icon,omitempty"`
|
||
Shortcut string `json:"shortcut,omitempty"` // "1"–"9"（⌘N / Ctrl+N 召出）
|
||
BadgeTool string `json:"badgeTool,omitempty"` // 角标提供者工具：返回 {count,tone}
|
||
Body []UINode `json:"body"`
|
||
// RefreshTool：挂载时调用刷新 Body 动态区（与 Panel 同机制，v1 整体刷新）。
|
||
RefreshTool string `json:"refreshTool,omitempty"`
|
||
}
|
||
|
||
type HITLCardTemplate struct {
|
||
Question string `json:"question"`
|
||
Kind HITLKind `json:"kind"`
|
||
Choices []HITLChoice `json:"choices,omitempty"`
|
||
AllowFreeInput bool `json:"allowFreeInput"`
|
||
FreeInputHint string `json:"freeInputHint,omitempty"`
|
||
}
|