@ai-zen/agents-host 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/wire/states.d.ts

@@ -29,7 +29,7 @@ import type { MessageKey } from "../i18n/index.js";
  * 「界面显示」「客户端重排」「换个语言连回来重渲染」三种需要。
  */
 export interface LocalizedText {
-    /** 稳定码（如 `notice.settingsSaved`、`tool.failed`），与文案键分开，便于客户端分支 */
+    /** 稳定码（如 `notice.settingsApplied`、`tool.failed`），与文案键分开，便于客户端分支 */
     code: string;
     /** 文案键（`i18n` 的键空间） */
     messageKey: MessageKey;
@@ -347,8 +347,6 @@ export interface LocalSectionExtensions {
  * ```
  */
 export type LocalMessageContentSection = AgentNS.MessageContentSection & LocalSectionExtensions;
-/** 带本地扩展的正文：字符串原样，数组里的每一段可能带 `__` 字段 */
-export type LocalMessageContent = string | LocalMessageContentSection[];
 /**
  * 一个内容段里的素材 id（没有这个扩展字段时为空）。
  *
@@ -410,14 +408,16 @@ export interface AttachmentOutcome {
     problem: ProblemFact | null;
 }
 /**
- * 状态栏每一块的事实。块名固定，块内结构按块名不同而不同（判别式联合）。
+ * 状态栏每一块的事实。块 id 固定，块内结构按 id 不同而不同（判别式联合）。
  *
  * 这样的好处是：宿主给的是可排版的块，客户端决定摆哪几块、摆在哪（PRD F-I6 /
  * 「宿主给能力、客户端给交互」），双方都不需要解析一整行字符串。
+ *
+ * **块名（助手 / 模型 / 上下文 …）不在这里**：那是界面的词汇，归客户端 —— 同一块在
+ * 不同界面上叫法可能不同，也可能干脆不显示名字。宿主只给 id 与 facts。
  */
 export type StatusBlock = {
     id: "agent";
-    label: LocalizedText;
     /**
      * 助手块的三个事实。
      *
@@ -432,33 +432,26 @@ export type StatusBlock = {
     };
 } | {
     id: "model";
-    label: LocalizedText;
     facts: ModelState;
 } | {
     id: "thinking";
-    label: LocalizedText;
     facts: ThinkingState;
 } | {
     id: "context";
-    label: LocalizedText;
     facts: ContextState;
 } | {
     id: "usage";
-    label: LocalizedText;
     facts: UsageSnapshot;
 } | {
     id: "cwd";
-    label: LocalizedText;
     facts: FolderFact;
 } | {
     id: "tools";
-    label: LocalizedText;
     facts: {
         running: RunningTool[];
     };
 } | {
     id: "subagents";
-    label: LocalizedText;
     facts: {
         items: SubAgentSnapshot[];
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-zen/agents-host",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "AI-Zen Agents Host — session/workspace service shared by CLI and Desktop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -61,6 +61,7 @@
     "build": "tsc",
     "pretest": "tsc --noEmit -p tsconfig.test.json",
     "test": "vitest run",
-    "test:all": "npm run pretest && vitest run && npm run build"
+    "test:all": "npm run pretest && vitest run && npm run build && vitest run --config vitest.e2e.config.ts",
+    "test:e2e": "npm run pretest && vitest run --config vitest.e2e.config.ts"
   }
 }

package/dist/handlers/capabilities.d.ts

@@ -1,26 +0,0 @@
-/**
- * 能力清单（PRD F-E5 / F-E6 / F-F9，裁定 R6）。
- *
- * 清单是「帮助页与指令菜单渲染用的那一份真相」，所以它必须与契约同步：每一项对应
- * `MethodMap` 里的一个方法名，编号取 PRD §4 那一行的能力号（`wire/methods.ts` 里每个方法
- * 的注释就写着自己的编号）。没有编号的方法用契约注释里记的那条决定编号（`workspace.*` 是
- * `D9`/`D10`/`D11`：PRD §4 当初没给项目单列能力行），不另编一个。
- *
- * 三件事刻意分开：
- *   - **标题与说明**：`LocalizedText`，按连接语言渲染（D8），文案键在 `i18n/`；
- *   - **`blocking`**：执行期间会不会占住这段对话（F-E6 让界面显示「正在执行什么」）；
- *   - **`destructive`**：有不可撤销的后果（F-F9 的二次确认）。
- *
- * 编号撞车的场合（几个方法服务同一条能力，例如 `config.saveEndpoint` / `config.deleteEndpoint`
- * 都属于 F-F2）用 `<编号>#<动作>` 做 id：编号仍是 PRD 的那个，id 保持唯一，客户端可以按 id 存
- * 展开状态。顺序与 `METHOD_NAMES` 一致，帮助页读起来就是「按域分组的办法清单」。
- */
-import type { Language } from "../i18n/index.js";
-import type { CapabilityView } from "../wire/index.js";
-/**
- * 造能力清单。
- *
- * 默认语言渲染一份：`host.hello` 与 `host.capabilities` 的出参都要能在不知道收件人语言时
- * 先给出形状，客户端按自己的语言用 `messageKey` + `params` 重渲染（D8 的同一套口径）。
- */
-export declare function createCapabilities(language?: Language): CapabilityView[];

package/dist/handlers/capabilities.js

@@ -1,138 +0,0 @@
-/**
- * 能力清单（PRD F-E5 / F-E6 / F-F9，裁定 R6）。
- *
- * 清单是「帮助页与指令菜单渲染用的那一份真相」，所以它必须与契约同步：每一项对应
- * `MethodMap` 里的一个方法名，编号取 PRD §4 那一行的能力号（`wire/methods.ts` 里每个方法
- * 的注释就写着自己的编号）。没有编号的方法用契约注释里记的那条决定编号（`workspace.*` 是
- * `D9`/`D10`/`D11`：PRD §4 当初没给项目单列能力行），不另编一个。
- *
- * 三件事刻意分开：
- *   - **标题与说明**：`LocalizedText`，按连接语言渲染（D8），文案键在 `i18n/`；
- *   - **`blocking`**：执行期间会不会占住这段对话（F-E6 让界面显示「正在执行什么」）；
- *   - **`destructive`**：有不可撤销的后果（F-F9 的二次确认）。
- *
- * 编号撞车的场合（几个方法服务同一条能力，例如 `config.saveEndpoint` / `config.deleteEndpoint`
- * 都属于 F-F2）用 `<编号>#<动作>` 做 id：编号仍是 PRD 的那个，id 保持唯一，客户端可以按 id 存
- * 展开状态。顺序与 `METHOD_NAMES` 一致，帮助页读起来就是「按域分组的办法清单」。
- */
-import { DEFAULT_LANGUAGE, render } from "../i18n/index.js";
-import { methodDomain } from "../wire/index.js";
-/**
- * 清单本体：**每个方法一条**，且与 `METHOD_NAMES` 一一对应（用例会钉住这条）。
- *
- * `blocking` 只标「跑起来时这段对话不能发下一条」的那几个：一轮对话、交接回合、
- * 临时对话（它借的 Scope 与项目共用，跑的时候同样不能被打断）。
- * `destructive` 只标「做下去就回不来」的那几个：删项目 / 删对话 / 撤回 / 删端点 /
- * 删助手 / 删模型（含图片模型）/ 删 MCP 条目 / 恢复出厂。清通知不算：它清的是
- * 界面上的一条提示，为它弹二次确认反而是打扰。
- *
- * 两样东西刻意不在这份清单里（裁定 2026-11-13）：
- *   - `host.usage`：「按项目 / 整机」的用量聚合没有任何客户端消费，F-I5 的落点在
- *     `conversation.state` 的 `usage`；
- *   - `credential.*`：凭据由宿主自己管理（`agents-host token create|list|revoke`），
- *     客户端只有「连接管理 + 记住密码」，那里没有可渲染的能力。
- */
-const FACTS = [
-    { method: "host.hello", prd: "F-A1", blocking: false, destructive: false },
-    { method: "host.version", prd: "F-E3", blocking: false, destructive: false },
-    { method: "host.upgrade", prd: "F-E3", blocking: false, destructive: false },
-    { method: "host.shutdown", prd: "F-E1", blocking: false, destructive: false },
-    { method: "host.capabilities", prd: "F-E5", blocking: false, destructive: false },
-    { method: "host.reload", prd: "F-E1", blocking: false, destructive: false },
-    { method: "host.setLanguage", prd: "F-E4", blocking: false, destructive: false },
-    { method: "workspace.list", prd: "D9", blocking: false, destructive: false },
-    { method: "workspace.create", prd: "D10", blocking: false, destructive: false },
-    { method: "workspace.get", prd: "D9", blocking: false, destructive: false },
-    { method: "workspace.rename", prd: "D9", blocking: false, destructive: false },
-    { method: "workspace.remove", prd: "D11", blocking: false, destructive: true },
-    { method: "conversation.list", prd: "F-C5", blocking: false, destructive: false },
-    { method: "conversation.create", prd: "F-C7", blocking: false, destructive: false },
-    { method: "conversation.get", prd: "F-A6", blocking: false, destructive: false },
-    { method: "conversation.state", prd: "F-I3", blocking: false, destructive: false },
-    { method: "conversation.rename", prd: "F-C3", blocking: false, destructive: false },
-    { method: "conversation.pin", prd: "F-C5", blocking: false, destructive: false },
-    { method: "conversation.delete", prd: "F-C10", blocking: false, destructive: true },
-    { method: "conversation.send", prd: "F-C2", blocking: true, destructive: false },
-    { method: "conversation.abort", prd: "F-E1", blocking: false, destructive: false },
-    { method: "conversation.revert", prd: "F-C8", blocking: false, destructive: true },
-    { method: "conversation.setModel", prd: "F-B4", blocking: false, destructive: false },
-    { method: "conversation.setThinking", prd: "F-B6", blocking: false, destructive: false },
-    { method: "conversation.transient", prd: "F-A2", blocking: true, destructive: false },
-    { method: "message.list", prd: "F-I7", blocking: false, destructive: false },
-    { method: "question.list", prd: "F-I9", blocking: false, destructive: false },
-    { method: "question.answer", prd: "F-I9", blocking: false, destructive: false },
-    { method: "notice.list", prd: "F-I8", blocking: false, destructive: false },
-    { method: "notice.dismiss", prd: "F-I8", blocking: false, destructive: false },
-    { method: "notice.clear", prd: "F-I8", blocking: false, destructive: false },
-    { method: "config.get", prd: "F-F1", blocking: false, destructive: false },
-    { method: "config.patch", prd: "F-F1", blocking: false, destructive: false },
-    { method: "config.setDefaults", prd: "F-F7", blocking: false, destructive: false },
-    { method: "config.getDiscovery", prd: "F-G1", blocking: false, destructive: false },
-    { method: "config.saveMcp", prd: "F-F6", blocking: false, destructive: false },
-    { method: "config.deleteMcp", prd: "F-G1", blocking: false, destructive: true },
-    { method: "config.saveEndpoint", prd: "F-F2", blocking: false, destructive: false },
-    { method: "config.deleteEndpoint", prd: "F-F2", blocking: false, destructive: true },
-    { method: "agent.list", prd: "F-B2", blocking: false, destructive: false },
-    { method: "agent.get", prd: "F-B2", blocking: false, destructive: false },
-    { method: "agent.create", prd: "F-B2", blocking: false, destructive: false },
-    { method: "agent.update", prd: "F-B2", blocking: false, destructive: false },
-    { method: "agent.delete", prd: "F-F5", blocking: false, destructive: true },
-    { method: "agent.setModel", prd: "F-B4", blocking: false, destructive: false },
-    { method: "agent.setThinking", prd: "F-B6", blocking: false, destructive: false },
-    { method: "agent.restoreFactory", prd: "F-F5", blocking: false, destructive: true },
-    { method: "model.list", prd: "F-F3", blocking: false, destructive: false },
-    { method: "model.listImages", prd: "F-F4", blocking: false, destructive: false },
-    { method: "model.create", prd: "F-F3", blocking: false, destructive: false },
-    { method: "model.update", prd: "F-F3", blocking: false, destructive: false },
-    { method: "model.delete", prd: "F-F3", blocking: false, destructive: true },
-    { method: "model.restoreFactory", prd: "F-F3", blocking: false, destructive: true },
-    { method: "model.saveImage", prd: "F-F4", blocking: false, destructive: false },
-    { method: "model.deleteImage", prd: "F-F4", blocking: false, destructive: true },
-    { method: "asset.begin", prd: "F-H8", blocking: false, destructive: false },
-    { method: "asset.end", prd: "F-H8", blocking: false, destructive: false },
-    { method: "asset.get", prd: "F-H7", blocking: false, destructive: false },
-    { method: "completion.files", prd: "F-H5", blocking: false, destructive: false },
-    { method: "handoff.start", prd: "F-D5", blocking: true, destructive: false },
-    { method: "handoff.listDocuments", prd: "F-D6", blocking: false, destructive: false },
-    { method: "search.conversations", prd: "F-C6", blocking: false, destructive: false },
-    { method: "search.messages", prd: "F-C6", blocking: false, destructive: false },
-];
-/** 标题的文案键（`capability.<方法名>`） */
-function titleKey(method) {
-    return `capability.${method}`;
-}
-/** 说明的文案键（`capability.<方法名>.detail`） */
-function detailKey(method) {
-    return `capability.${method}.detail`;
-}
-/** 一句话：码 + 参数 + 按给定语言渲染的句子（存码不存句子，D8） */
-function text(key, language) {
-    return { code: key, messageKey: key, params: {}, message: render(language, key) };
-}
-/** 动作名（`conversation.send` → `send`），编号撞车时用来给 id 去重 */
-function actionOf(method) {
-    return method.slice(method.indexOf(".") + 1);
-}
-/**
- * 造能力清单。
- *
- * 默认语言渲染一份：`host.hello` 与 `host.capabilities` 的出参都要能在不知道收件人语言时
- * 先给出形状，客户端按自己的语言用 `messageKey` + `params` 重渲染（D8 的同一套口径）。
- */
-export function createCapabilities(language = DEFAULT_LANGUAGE) {
-    const used = new Set();
-    return FACTS.map((fact) => {
-        // 同一个编号下的第二个及以后的方法：`<编号>#<动作>`
-        const id = used.has(fact.prd) ? `${fact.prd}#${actionOf(fact.method)}` : fact.prd;
-        used.add(fact.prd);
-        return {
-            id,
-            domain: methodDomain(fact.method),
-            title: text(titleKey(fact.method), language),
-            description: text(detailKey(fact.method), language),
-            method: fact.method,
-            blocking: fact.blocking,
-            destructive: fact.destructive,
-        };
-    });
-}