@weavecode/weave 0.1.1 → 0.1.3

package/node_modules/@weavecode/harness/dist/driver.d.ts

@@ -7,7 +7,7 @@ import type { FileAssetCategory } from './shared/file-specs.js';
  * 依赖硬约束：本包仅依赖 @weavecode/core（永不依赖 server/cli，防 statusline/i18n 成环）。
  */
 /** 可插拔能力槽——driver 声明持有哪些，注册表按能力检索。 */
-export type HarnessCapability = 'init' | 'events' | 'assets' | 'resume' | 'detect' | 'plugins' | 'pluginState' | 'messaging' | 'questions' | 'capture';
+export type HarnessCapability = 'init' | 'events' | 'assets' | 'resume' | 'detect' | 'plugins' | 'pluginState' | 'messaging' | 'questions' | 'capture' | 'statusline' | 'logs' | 'config' | 'edits' | 'images' | 'commands';
 /**
  * 采集集成的 user 档状态（tool-object-model §2.6 基石）。
  */
@@ -84,19 +84,102 @@ export interface EventSource {
     readonly events: readonly string[];
     normalize(report: unknown, projectId: number): unknown;
 }
+/**
+ * 一条从外部日志读出来的原始上报 + 它的真实时刻（历史回填不能印成插入时刻）。
+ * `report` 与 hook 上报同形，故 server 拿它走**同一个** `EventSource.normalize`。
+ */
+export interface LogRecord {
+    report: {
+        eventType: string;
+        sessionId?: string;
+        cwd?: string;
+        payload: unknown;
+    };
+    /** 事件真实时刻（ISO；日志行自带时间戳优先，缺失才用文件 mtime）。 */
+    at: string;
+}
+export interface LogPollOptions {
+    /** 游标 / 边读缓存落点（daemon 传 `<dataDir>/logs/<harness>`）。 */
+    stateDir: string;
+    /**
+     * 只采这些工作目录的会话（daemon 从 projects 表 + 项目 `.weave/config.yaml` 算出）。
+     * 命中即把**该目录原文**回填进 `report.cwd`——路径归一（大小写、分隔符、解析）
+     * 是日志源自己的事，调用方按原样等值匹配即可。
+     */
+    cwdWhitelist: readonly string[];
+    /** 单拍上限：到顶就返回，游标只推进到真读过的位置（下一拍续）。 */
+    maxRecords?: number;
+    maxBytes?: number;
+}
+/** 日志源健康（诊断面只读；「没数据」与「读不到」要分得开）。 */
+export interface LogHealth {
+    /** 宿主数据根（不存在 = 该 harness 没在本机用过）。 */
+    root: string | null;
+    /** 白名单内可读的日志文件数。 */
+    files: number;
+    /** 最近一次真读到新行的时刻（ISO）。 */
+    lastPollAt: string | null;
+    /** 最近一次错误（读不动 / 落盘失败）；正常为 null。 */
+    lastError: string | null;
+}
+/**
+ * 日志源槽：**拉取式**采集面。`events` 槽答「一份上报怎么归一」，前提是有人把
+ * 上报递进来（hook 脚本写 inbox 文件）；没有 push 面的 harness（codex 只把会话
+ * 写在自己的 rollout JSONL 里）需要第二个答案——这份数据从哪来。故本槽只负责
+ * 「读出新行」，归一化仍归同一个 harness 的 `events` 槽：server 不认识任何
+ * harness 的文件格式，harness 也不认识 projects 表。
+ *
+ * 契约：poll 幂等（游标落 `stateDir`，重启不重放）且守预算（到 maxRecords /
+ * maxBytes 即返回）；只挑白名单工作目录的会话，别的一行都不产出。
+ */
+export interface LogSource {
+    readonly harness: Harness;
+    poll(options: LogPollOptions): Promise<LogRecord[]>;
+    health(options: {
+        stateDir: string;
+    }): Promise<LogHealth>;
+}
 /**
  * 资产落盘表面查询（批 4a 补全）：「某 harness 的资产落哪 / 怎么分类」的知识
  * 从 server 六处散落收敛进本接口的实现（`claude/assets.ts` / `codex/assets.ts`），
  * server 保留原函数名作薄委托——`fileAssetTargetDir` / `skillsDirFor` /
  * `classifyAgent` / `shouldIgnore` / global-config skills 常量 / codex-toml 路径。
  */
+/**
+ * 一条 MCP 服务器的通用形（各 harness 的落盘表示法不同：claude 是 JSON 的
+ * `mcpServers[name]`，codex 是 TOML 的 `[mcp_servers.<name>]`——表示法归实现方）。
+ * 类型住这里而非 server：它出现在 [[AssetSurface]] 的方法签名上，server 反向
+ * import 会绕回来。
+ */
+export interface McpStdioConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/**
+ * Streamable HTTP 形态（daemon 托管的 MCP 用这一形）：`url` 即端点，
+ * `headers` 是客户端要带的头（本机令牌走它），`bearerTokenEnvVar` 只有 codex
+ * 支持（Bearer 必须来自环境变量，不许写死明文）。判别靠 `'command' in cfg`。
+ */
+export interface McpHttpConfig {
+    url: string;
+    /** 宿主自己的传输标签（claude 会写 `"type": "http"`），原样保留。 */
+    type?: string;
+    headers?: Record<string, string>;
+    bearerTokenEnvVar?: string;
+}
+export type McpServerConfig = McpStdioConfig | McpHttpConfig;
 export interface AssetSurface {
     /** 所属 harness——按序遍历多个 surface 时回指归属（`classifyAgent` 消费）。 */
     readonly harness: Harness;
     /** 某资产类别在指定 scope 的目标目录；无该表面则抛错（同 `fileAssetTargetDir` 语义）。 */
     targetDir(category: FileAssetCategory, scope: 'project' | 'user', projectPath: string, homedir: string): string;
-    /** 项目内 skills 目录（相对项目根，posix 分隔；`skillsDirFor` 消费）。 */
-    projectSkillsDir(): string;
+    /**
+     * 项目内 skills 根（相对项目根，posix 分隔）：[0] 为安装写入目标，其后为
+     * 只读的生态共用根（Codex 的 `.agents/skills`——它自己两处都读；installer/
+     * classifier 消费）。
+     */
+    projectSkillsRoots(): string[];
     /**
      * 全局 skills 根（绝对路径）：[0] 为安装写入目标，其后为只读遗留根
      * （Codex 的 deprecated `~/.codex/skills`；global-config 消费）。
@@ -115,6 +198,15 @@ export interface AssetSurface {
      * 的 MCP 面 → undefined。web 按行渲染提示，不自拼 harness 路径。
      */
     mcpDest(scope: 'project' | 'user', homedir: string): string | undefined;
+    /**
+     * 读某 scope 的 MCP 服务器映射（该 harness 无此 scope / 文件缺失 → 空对象）。
+     * 表示法归实现方：调用方只认名字与 `McpServerConfig`，不碰文件。
+     */
+    mcpRead(scope: 'project' | 'user', projectPath: string, homedir: string): Promise<Record<string, McpServerConfig>>;
+    /** 写/覆盖一条（scope 必须在 `mcpScopes()` 内，否则抛）。 */
+    mcpWrite(scope: 'project' | 'user', projectPath: string, homedir: string, name: string, config: McpServerConfig): Promise<void>;
+    /** 删一条；返回是否真删掉了（false → 调用方给 404）。 */
+    mcpRemove(scope: 'project' | 'user', projectPath: string, homedir: string, name: string): Promise<boolean>;
     /**
      * 宿主插件缓存根（Claude `~/.claude/plugins/cache`；Codex `~/.codex/plugins/cache`）；
      * 无插件机制的 harness 返回 undefined。全局技能枚举与「某路径归属谁」消费。
@@ -151,9 +243,22 @@ export interface ResumeCommandSpec {
      * 「在默认终端打开会话」消费；缺省 = 该 harness 不支持交互式打开（501）。
      */
     openArgs?(sessionId: string): string[];
+    /**
+     * 编排边级提取的无头 fork 参数：从上游会话派生一个**一次性 fork 回合**提炼
+     * 信息（`['--resume', sessionId, '--fork-session', '--no-session-persistence',
+     * '--session-id', forkSessionId]` 形态），不动原会话、不留转录。缺省 = 该
+     * harness 无 fork 提取能力（codex 留位，调用方回落只读上游输出）。
+     * `forkSessionId` 由 server 预生成并登记合成会话（ingest 侧过滤），harness 只定键形。
+     */
+    extractArgs?(sessionId: string, forkSessionId: string): string[];
+    /**
+     * `bin` 的版本下限（semver）：低于它的宿主，weave 的会话功能不可信 → 起不了
+     * 新会话（UI 置灰并说明）。缺省 = 不设闸。
+     */
+    minVersion?: string;
 }
 /** 消息通道名——支持矩阵与原因文案的键。 */
-export type MessagingChannel = 'discovery' | 'prompt' | 'inject' | 'headless' | 'watch';
+export type MessagingChannel = 'discovery' | 'prompt' | 'inject' | 'headless' | 'watch' | 'sideQuestion' | 'pathRefs';
 /** 非抢占注入通道规格：注入可骑乘的事件（hook-handler 在这些事件上消化 outbox 行）。 */
 export interface InjectChannelSpec {
     rideEvents: readonly string[];
@@ -184,23 +289,96 @@ export interface PromptRelaySpec {
     } | null;
 }
 /**
- * 图片随 prompt 投递的对齐面：「一张图怎么被这个 harness 认出来」是 harness 表示法
- * （claude = 裸绝对路径，它自己的粘贴处理器按 `\.(png|jpe?g|gif|webp)$` 把路径转成
- * `[Image #N]` + 真 image block），server 只传语义参数（原文 + 落盘图的可读路径 /
- * 媒体类型 / 原文件名），怎么引用归这里。null = 该 harness 不支持收图。
+ * 附件类型：`image` = 宿主认得图（claude 的粘贴处理器按
+ * `\.(png|jpe?g|gif|webp)$` 把路径变成 `[Image #N]` 占位 + 真 image block）；
+ * `file` = 其它文件，**宿主没有附件形态**，提示词里只有一条路径，由模型自己读。
  */
-export interface ImageAttachSpec {
+export type AttachKind = 'image' | 'file';
+/**
+ * 附件随 prompt 投递的对齐面：「一个已落盘的文件怎么被这个 harness 认出来」是
+ * harness 表示法（claude = 裸绝对路径、一行一条），server 只传语义参数（原文 +
+ * 落盘件的可读路径 / 媒体类型 / 原文件名），怎么引用归这里。null = 该 harness
+ * 不接受任何附件。
+ */
+export interface AttachSpec {
+    /** 收哪些类型；`image` 缺席 = 图片入口不摆，`file` 缺席 = 文件入口不摆。 */
+    readonly kinds: readonly AttachKind[];
     /**
-     * 把「用户原文 + 已落盘图片」合成投递 prompt 文本。images 恒非空；text 可为空
-     * （纯图发送）。返回值走三条层投递，**用户原文不得被改写**（回执比对靠它做包含
+     * 把「用户原文 + 已落盘附件」合成投递 prompt 文本。files 恒非空；text 可为空
+     * （纯附件发送）。返回值走三条层投递，**用户原文不得被改写**（回执比对靠它做包含
      * 匹配）——只允许追加引用形态。
      */
-    composePrompt(text: string, images: readonly {
+    composePrompt(text: string, files: readonly {
         path: string;
         mediaType: string;
         name: string;
     }[]): string;
 }
+/** 一条项目内路径的类型（`PathRefSpec.kinds` 的取值）。 */
+export type PathRefKind = 'file' | 'dir';
+/** 引用的一段行区间：1 基、含两端（`start === end` 即单行）。 */
+export interface PathRefLines {
+    start: number;
+    end: number;
+}
+/**
+ * 路径引用面：「一条项目内路径怎么被这个 harness 认出来」是 harness 表示法
+ * （claude = `@<相对路径>` 的 mention 文法），server 只传路径与类型，web 只把
+ * 服务端回给的表达式**当不透明字符串**贴进输入框——两侧都不自拼。null = 该
+ * harness 没有这种引用文法（入口不渲染）。
+ */
+export interface PathRefSpec {
+    /** 该 harness 能引用什么。 */
+    readonly kinds: readonly PathRefKind[];
+    /** 认不认行区间（false = 选择器只给整文件/整目录引用，不摆设行号选择）。 */
+    readonly lines: boolean;
+    /** 贴进 prompt 的表达式；path 为项目相对路径（会话 cwd = 项目根）。 */
+    expression(input: {
+        path: string;
+        kind: PathRefKind;
+        lines?: PathRefLines;
+    }): string;
+    /**
+     * `expression` 的逆运算：从一段**现成文本**里认出引用表达式（粘贴回填 /
+     * 取回队列消息时把表达式还原成胶囊）。只认文法、不问存在——「这个路径真在
+     * 项目里吗」是调用方拿文件索引判的，不归文法。
+     */
+    recognize(text: string): RecognizedRef[];
+}
+/** `PathRefSpec.recognize` 认出的一处引用：`start`/`end` 是在原文里的下标区间。 */
+export interface RecognizedRef {
+    start: number;
+    end: number;
+    /** 原文那一段（调用方可以拿 `expression` 归一后替换）。 */
+    ref: string;
+    path: string;
+    kind: PathRefKind;
+    lines?: PathRefLines;
+}
+/**
+ * 旁路会话（宿主 TUI 里的侧问，claude = `/btw`）规格：问一次不打断主回合的
+ * 轻量提问。**宿主既不留转录也不发 prompt 事件**（claude 侧问查询 `skipTranscript`），
+ * 问题与回答都不落任何文件——所以「谁发的谁记」：weave 打出去的提问自己记，
+ * 回答按这里给的判据从采集事件里认领。null = 该 harness 没有这种机制。
+ */
+export interface SideQuestionSpec {
+    /** 提问命令（命令文法归 harness，server 只传用户原文）。 */
+    command(question: string): string;
+    /** 形态校验：单行、无控制字符（CR 会提前提交）、长度上限。 */
+    validate(question: string): {
+        ok: true;
+        text: string;
+    } | {
+        ok: false;
+        error: string;
+    };
+    /**
+     * 这条采集事件是不是一次旁路回答；是就返回全文，否则 null。
+     * 判据归 harness（claude：`SubagentStop` 且宿主没给这个 agent 留转录——
+     * 普通子 agent 与 skill 子 agent 都有转录，skipTranscript 的 fork 才没有）。
+     */
+    answerOf(eventType: string, payload: unknown): string | null;
+}
 /** 信封渲染入参。 */
 export interface MessageMeta {
     /** 发起方展示名（dashboard / 会话标题 / cli）。 */
@@ -246,12 +424,37 @@ export interface BlockingQuestion {
      *  自定义文本走 `n` 备注行。选项文案与描述在宿主这一形态下**不渲染**（右栏取而代之）。 */
     previewMode?: boolean;
 }
+/** 一次工具调用带的计划内容（正文 / 计划文件路径，两样都可能缺）。 */
+export interface PlanDraft {
+    /** 正文（模型直接给的，或写计划文件那次调用带的 content）。 */
+    text: string | null;
+    /** 计划文件路径：正文不在事件里时由 server 现读（批准后宿主可能已删）。 */
+    filePath: string | null;
+}
+/**
+ * 计划模式面：ExitPlanMode 交出的「待批阅的计划」。正文两条来源——老模型塞在
+ * `tool_input.plan` 里；2.1.296 起 tool_input 恒空，宿主改成让模型先把计划写进
+ * 计划文件（路径随计划模式提醒下发，宿主自己不留副本），故正文也可能只在那次
+ * Write/Edit 的 content 里。dashboard 拿它当一条对话气泡摆出来给人批阅。
+ */
+export interface PlanSpec {
+    /** 提交计划待批阅的工具名。 */
+    readonly tool: string;
+    /** 写计划文件用的工具名（正文在这类调用的 content 里）。 */
+    readonly writeTools: readonly string[];
+    /** 计划文件路径里必有的一段：择行用（把整轮 Write 都捞回来太重）。 */
+    readonly fileHint: string;
+    /** 这次工具调用带的计划内容；与计划无关返回 null。 */
+    draftOf(toolName: string | null, toolInput: unknown, toolResponse: unknown): PlanDraft | null;
+}
 /**
  * 阻塞式交互面（会话卡住等输入：AskUserQuestion / 计划确认 / 权限确认）：
  * 哪些工具会挂起、权限通知类型、问题面归一化与作答键序全归 harness——
  * server 只做状态机与终端传输，web 只渲染不拼键序。
  */
 export interface BlockingPromptSpec {
+    /** 计划模式规格；null = 该 harness 没有计划概念（不摆计划气泡）。 */
+    readonly plan: PlanSpec | null;
     /** 阻塞工具名：PreToolUse 置位、PostToolUse 同名清除。 */
     readonly blockingTools: readonly string[];
     /** 权限确认的 Notification 类型（raw.notification_type）；null = 无此机制。 */
@@ -302,6 +505,23 @@ export interface PromptInboxSpec {
         text: string;
     }): string;
 }
+/**
+ * 宿主自带的排队投递（codex queue）：消息写进目标会话自己的队列——活会话 <1s 注入、
+ * 没开的会话下次 resume 自动领走，且**在宿主眼里就是用户输入**（没有带外来源位）。
+ * 这层比终端击键更接近「用户本人发送」，故手动面也允许走它（层序见 MessageDeliverer）。
+ *
+ * `command` 一次给全 bin + argv：win32 的 `codex` 是 npm `.cmd` 垫片，CreateProcess
+ * 不认，必须由 harness 换成可直接 spawn 的入口（node + 包 bin）；用户正文只出现在
+ * argv 里、不经 shell 拼接。
+ */
+export interface QueuedPromptSpec {
+    command(sessionId: string, text: string): {
+        bin: string;
+        args: string[];
+    };
+    /** 单次超时（毫秒）——队列是一次性小操作，挂住即当失败回落下一层。 */
+    readonly timeoutMs?: number;
+}
 /**
  * 会话消息能力面（session-orchestration 批 1）：每 harness 一份声明式规格，
  * server 的 MessageDeliverer 按面裁决支持状态与编排控制；claude = 完整参考实现，
@@ -316,6 +536,8 @@ export interface MessagingSurface {
     readonly prompt: PromptRelaySpec | null;
     /** 会话本地收件箱直投（层①-a，毫秒级）；null = 该 harness 没有这类机制。 */
     readonly promptInbox: PromptInboxSpec | null;
+    /** 宿主自带的排队投递（宿主侧队列）；null = 该 harness 没有这类机制。 */
+    readonly queuedPrompt: QueuedPromptSpec | null;
     /** 非抢占注入通道（忙排）；null = 不支持。 */
     readonly inject: InjectChannelSpec | null;
     /** 无头强制回合通道（闲投）；null = 不支持。引用 resume 槽规格对象，不复制。 */
@@ -324,8 +546,12 @@ export interface MessagingSurface {
     readonly idleSignals: readonly string[];
     /** 注入信封渲染（缺省 = server 的 weave 统一信封）。 */
     renderEnvelope?(text: string, meta: MessageMeta): string;
-    /** 图片随 prompt 的对齐面；null = 该 harness 不支持收图（web 据此置灰附件钮）。 */
-    readonly imageAttach: ImageAttachSpec | null;
+    /** 附件随 prompt 的对齐面；null = 该 harness 不收附件（web 据此置灰附件钮）。 */
+    readonly attach: AttachSpec | null;
+    /** 项目内路径的引用文法；null = 该 harness 没有这种文法（web 据此不渲染入口）。 */
+    readonly pathRefs: PathRefSpec | null;
+    /** 旁路会话（侧问）；null = 该 harness 没有这种机制（web 据此不渲染入口）。 */
+    readonly sideQuestion: SideQuestionSpec | null;
     /** 不支持通道的语义原因（409 文案与 UI tooltip 直用）。 */
     readonly unsupportedReasons?: Partial<Record<MessagingChannel, string>>;
 }
@@ -434,6 +660,266 @@ export interface PluginSurface {
      *  其余键保留，文件可创建）。 */
     setEnabledOverride(projectPath: string, scope: PluginScope, key: string, state: EnableOverride): Promise<void>;
 }
+/** 生成状态栏脚本的运行参数——两样都是调用方（server）的事实：缓存落点归
+ *  dataDir 布局，版本号归包身份；harness 不自取。 */
+export interface StatuslineGenerateContext {
+    cacheDir: string;
+    version: string;
+}
+/**
+ * 状态栏面：宿主能不能被注入自定义状态栏、能填哪些块、脚本落在哪、怎么接线。
+ *
+ * 「哪几块」是 harness 知识（claude 的块来自它 statusline stdin JSON 的字段），
+ * 故词表与渲染器都归各 harness 的实现；server 只做持久化与装配、web 只渲染
+ * 能力表给出来的块。`tui: 'none'` 的 harness 不是「没做」，而是宿主结构上没有
+ * 这个面（如 codex 的 `tui.status_line` 只能选内置条目、不接受 shell 命令）。
+ */
+export interface StatuslineSurface {
+    /** 该 harness 的状态栏能填哪些块（key 由 harness 定义，web 只认这串）。 */
+    readonly segments: readonly string[];
+    /** TUI 通道：`injectable` = 能注入宿主 TUI；`none` = 宿主没有这个面。 */
+    readonly tui: 'injectable' | 'none';
+    /** 脚本相对项目根的落点（posix，供 init 漂移检测比对面）。 */
+    readonly scriptRelPath: string;
+    /** 生成宿主运行的渲染脚本（配置形状归 harness，槽位不做假设）。 */
+    generate(config: unknown, ctx: StatuslineGenerateContext): string;
+    /** 把宿主指针接到脚本上（claude = `.claude/settings.json` 的 `statusLine` 键）。 */
+    wire(projectPath: string, opts: {
+        scriptPath: string;
+        refreshInterval: number;
+    }): Promise<void>;
+    /**
+     * 渲染脚本已经算好、留在缓存里的块事实（key = segment key，值 = token 表）——
+     * dashboard 侧要摆同样的块就从这儿取，不自算第二份。没有缓存即 null。
+     */
+    facts?(cacheDir: string, cwd: string): StatuslineFacts | null;
+}
+/** 缓存里的块事实：与 `buildPreviewItems` 吃的 token 表同形。 */
+export type StatuslineFacts = Record<string, Record<string, string>>;
+/**
+ * 配置档位：host 读配置文件的四个落点。`global` 指宿主单独放「全局 config」键的
+ * 那个文件（claude = `~/.claude.json`，与 settings 文件不是一回事）。
+ */
+export type ConfigFileId = 'user' | 'project' | 'projectLocal' | 'global';
+/** 一个档位的落点；`profiles` = 该档支持本地多份配置（快照/切换）。 */
+export interface ConfigFileSpec {
+    id: ConfigFileId;
+    path(ctx: {
+        projectPath: string | null;
+        homedir: string;
+    }): string;
+    profiles: boolean;
+}
+/**
+ * 词表里的一条键。条目的**类型原文**（含枚举说明）来自官方文档，web 自己决定控件；
+ * `options` 只是从类型文案里认出来的候选值，认窄了不致命（前端始终留手填口）。
+ */
+export interface ConfigKeySpec {
+    key: string;
+    /** 文档主题（分组表头）。 */
+    group: string;
+    type: string;
+    options?: readonly string[];
+    /** 文档默认值原文（展示用，不是结构化值）。 */
+    default?: string;
+    description: string;
+    /** 该键在哪个文件生效；`managed` = 只在组织托管设置里认。 */
+    scope: 'any' | 'managed' | 'user' | 'project' | 'local' | 'global';
+    deprecated?: boolean;
+    /** 由「Fields for」表补出的子字段（文档没有独立条目）。 */
+    nested?: boolean;
+    /**
+     * 值的容器形状：`map` = 键名由用户起（模型名、技能名…，拼不成点号路径）、
+     * `array` = 有序列表。有它时 `fields` / `valueType` + `valueOptions` 描述**值**。
+     */
+    shape?: 'map' | 'array';
+    /** 值（map）/ 元素（array）是对象时，它有哪些字段。 */
+    fields?: readonly ConfigFieldSpec[];
+    /** 值（map）/ 元素（array）是标量时的类型与枚举；`fields` 非空则以字段为准。 */
+    valueType?: string;
+    valueOptions?: readonly string[];
+}
+/** 对象值的一个字段（`type` / `options` 与顶层键同文法，控件也同一套）。 */
+export interface ConfigFieldSpec {
+    name: string;
+    type: string;
+    options?: readonly string[];
+    description?: string;
+}
+/** 数组里的一条 weave 托管条目：`path` 是数组的点号路径，`entry` 是那条的当前值。 */
+export interface ConfigManagedEntry {
+    path: string;
+    entry: string;
+}
+/** `env` 块里可写的环境变量（值恒为字符串，`kind` 只决定输入控件）。 */
+export interface ConfigEnvVarSpec {
+    name: string;
+    description: string;
+    kind: 'string' | 'boolean' | 'number' | 'list' | 'enum' | 'path';
+    options?: readonly string[];
+}
+export interface ConfigCatalog {
+    groups: readonly string[];
+    keys: readonly ConfigKeySpec[];
+    envVars: readonly ConfigEnvVarSpec[];
+}
+/** 模型列表接口返回的一条（字段名归 harness，web 只认 id/name）。 */
+export interface ConfigModelOption {
+    id: string;
+    name?: string;
+    createdAt?: string;
+}
+/**
+ * 配置面：一个 harness 的配置文件**词表 + 读写**。
+ *
+ * 为什么整块归 harness：文件落点、键形、哪些键是 weave 自己写进去的（改了就断
+ * 采集/插件/statusline）、模型列表接口的文法，全是 harness 知识；server 只做
+ * 存储、深路径合并与 HTTP 传输，web 只渲染词表。
+ */
+export interface ConfigSurface {
+    readonly harness: Harness;
+    /** 该 harness 的配置文件档位（project 档在 `projectPath` 缺省时路径无意义）。 */
+    files(ctx: {
+        projectPath: string | null;
+        homedir: string;
+    }): ConfigFileSpec[];
+    /** 某档可见的词表（`global` 档只列本档生效的键）。 */
+    catalog(file: ConfigFileId): ConfigCatalog;
+    /** 读该档的配置；文件不存在 → 空对象。`global` 档只回本档可见的键。 */
+    read(file: ConfigFileId, ctx: {
+        projectPath: string | null;
+        homedir: string;
+    }): Promise<Record<string, unknown>>;
+    /** 整体写（原子）：`global` 档只把可见键并回文件，其余键原样保留。 */
+    write(file: ConfigFileId, ctx: {
+        projectPath: string | null;
+        homedir: string;
+    }, values: Record<string, unknown>): Promise<void>;
+    /**
+     * weave 写进去的键（按当前值判，如 statusLine 只有指向 weave 脚本时才算）：
+     * 表单里只读并指向对应面板——手改会把采集/插件/statusline 改坏。
+     */
+    managedKeys(values: Record<string, unknown>): readonly string[];
+    /**
+     * weave 写进数组里的条目（行级托管）：只有这些行只读，同一个数组里用户自己的行照常
+     * 增删——按「整个数组」判会把 30 条用户规则一起锁死。
+     */
+    managedEntries(values: Record<string, unknown>): readonly ConfigManagedEntry[];
+    /**
+     * 模型列表（HTTP 调宿主自己的 API）。`baseUrl` / 凭据缺省时由实现从配置里取；
+     * 传输在实现侧，server 只传语义参数。
+     */
+    models(input: {
+        values: Record<string, unknown>;
+        baseUrl?: string | null;
+        apiKey?: string | null;
+        authToken?: string | null;
+        timeoutMs?: number;
+    }): Promise<{
+        models: ConfigModelOption[];
+        baseUrl: string;
+        credential: string;
+    }>;
+    /** 活文件的表示格式（raw 视图的编辑语言；快照/漂移 diff 也按它渲染）。 */
+    readonly rawFormat: 'json' | 'toml';
+    /** 活文件原文 → 值对象（解析失败抛错，调用方给 400）。 */
+    parseRaw(text: string): Record<string, unknown>;
+    /** 值对象 → 活文件原文（write 落盘前的最后一跳，格式归 harness）。 */
+    serializeRaw(values: Record<string, unknown>): string;
+}
+/** 一处改动：改前 → 改后。宿主只给片段（claude 的 Edit 就是 old_string/new_string）就只摆片段。 */
+export interface EditHunk {
+    /** 改前的文本；整文件新写 = 空串（「新建」在汇总里也是一处改动，不能消失）。 */
+    before: string;
+    /** 改后的文本。 */
+    after: string;
+}
+/** 按时间序返回的一处改动（同一文件可以有多条，汇总归 server）。 */
+export interface FileEdit {
+    /** 文件绝对路径——相对项目的展示名由 server 算，宿主不拼。 */
+    path: string;
+    hunk: EditHunk;
+    /** 这处改动的时刻（ISO）；宿主没带 → null。 */
+    at: string | null;
+}
+/**
+ * 会话改动面（「这次对话把哪些文件改成了什么样」）：读哪、怎么认改文件的调用都是
+ * harness 知识（claude = 转录里的 Edit/Write/MultiEdit 工具调用），server 不解析
+ * 宿主格式，只按文件汇总后交前端渲染 diff。
+ */
+export interface EditsSurface {
+    /** 该会话的全部改动（时间序）；读不到（无转录 / 路径未知 / 半路出错）→ null（不猜）。 */
+    sessionEdits(req: {
+        sessionId: string;
+        /** 转录路径（server 的探针答，宿主不自己拼目录）；null = 不知道在哪。 */
+        transcriptPath: string | null;
+    }): Promise<FileEdit[] | null>;
+}
+/** 一张粘贴进宿主输入框的图（转录里的 image block 解出来的原始字节）。 */
+export interface PromptImage {
+    /** MIME（`image/png` 这类）；认不出的类型上游就该丢掉。 */
+    mediaType: string;
+    bytes: Uint8Array;
+}
+/** 转录里的一条 user 消息 + 它随附的图（时间序）。 */
+export interface PromptImageSet {
+    /** 该条消息的正文（宿主保留 `[Image #N]` 占位——匹配事件时按它归一比对）。 */
+    text: string;
+    /** 消息时刻（ISO）；宿主没带 → null。 */
+    at: string | null;
+    images: PromptImage[];
+}
+/**
+ * 入站图采集面：宿主输入框里粘的图**只活在转录**（hook 载荷只有 `[Image #N]` 占位），
+ * server 因此在这里问「这段对话里的图长什么样」，再自己落 uploads + 挂到开轮事件。
+ * 缺这个槽 = 该 harness 的入站图无处可取（对话里只剩占位记号）。
+ */
+export interface ImagesSurface {
+    /** 带图的那几条 user 消息（时间序）；读不到（无转录 / 路径未知 / 半路出错）→ null（不猜）。 */
+    sessionImages(req: {
+        sessionId: string;
+        /** 转录路径（server 的探针答，宿主不自己拼目录）；null = 不知道在哪。 */
+        transcriptPath: string | null;
+    }): Promise<PromptImageSet[] | null>;
+}
+/**
+ * 聊天窗口 `/` 提示里的一条命令：内建命令来自宿主（版本快照，随升级复核），
+ * 其余按目录现扫（自定义命令 / skill / 插件 skill）。
+ */
+export interface HarnessCommand {
+    /** 不含触发符；插件/skill 命令带 `<plugin>:<skill>` 形态。 */
+    name: string;
+    /** 一句话说明（skill 取 SKILL.md frontmatter）。 */
+    description: string;
+    /** 参数提示（形如 `<model>` / `<file>`）；没有参数就省略。 */
+    argsHint?: string;
+    source: 'builtin' | 'command' | 'skill' | 'plugin';
+    /** 触发符：缺省 `/`；codex 的 skill 是 `$name`。前端按它展示与插胶囊。 */
+    sigil?: '/' | '$';
+}
+/** 转录里的一条命令执行记录（内建命令不发 hook 事件，只有转录记着）。 */
+export interface CommandExecution {
+    name: string;
+    args: string;
+    /** 执行时刻（ISO UTC）。 */
+    at: string;
+    /** 宿主回显的输出原文；命令没有输出就省略。 */
+    output?: string;
+}
+/**
+ * 命令面：聊天窗口 `/` 的候选清单 + 命令执行的返显。
+ * `executions` 答 null = 该 harness 的转录不记命令执行（前端如实说明，不空转）。
+ */
+export interface CommandsSurface {
+    readonly harness: Harness;
+    /** 该会话此刻可用的命令（项目级命令按项目路径现扫；`homedir` 缺省 = 本机家目录）。 */
+    list(req: {
+        projectPath: string;
+        homedir?: string;
+    }): Promise<HarnessCommand[]>;
+    /** 转录里的命令执行（时间序）；读不到（无转录 / 路径未知 / 半路出错）→ null（不猜）。 */
+    executions(transcriptPath: string | null): Promise<CommandExecution[] | null>;
+}
 /** 单个 harness 的驱动：id/displayName 必填，能力槽按批次补齐。 */
 export interface HarnessDriver {
     id: Harness;
@@ -449,6 +935,12 @@ export interface HarnessDriver {
     messaging?: MessagingSurface;
     questions?: BlockingPromptSpec;
     capture?: CaptureSurface;
+    statusline?: StatuslineSurface;
+    logs?: LogSource;
+    config?: ConfigSurface;
+    edits?: EditsSurface;
+    images?: ImagesSurface;
+    commands?: CommandsSurface;
 }
 /**
  * 能力槽注册表：先到先得（同 id 重复注册抛错，对齐插件先加载者胜）；

package/node_modules/@weavecode/harness/dist/driver.js

@@ -1 +1 @@
-export class HarnessRegistry{drivers=new Map;register(e){if(this.drivers.has(e.id))throw new Error(`harness driver already registered: ${e.id}`);this.drivers.set(e.id,e);let r=!1;return()=>{r||(r=!0,this.drivers.get(e.id)===e&&this.drivers.delete(e.id))}}get(e){return this.drivers.get(e)}all(){return[...this.drivers.values()]}byCapability(e){return this.all().filter(r=>r.capabilities.includes(e))}initFor(e){return this.drivers.get(e)?.init}unregister(e){return this.drivers.delete(e)}}export function supports(i,e){return i.capabilities.includes(e)}
+export class HarnessRegistry{drivers=new Map;register(r){if(this.drivers.has(r.id))throw new Error(`harness driver already registered: ${r.id}`);this.drivers.set(r.id,r);let i=!1;return()=>{i||(i=!0,this.drivers.get(r.id)===r&&this.drivers.delete(r.id))}}get(r){return this.drivers.get(r)}all(){return[...this.drivers.values()]}byCapability(r){return this.all().filter(i=>i.capabilities.includes(r))}initFor(r){return this.drivers.get(r)?.init}unregister(r){return this.drivers.delete(r)}}export function supports(e,r){return e.capabilities.includes(r)}

package/node_modules/@weavecode/harness/dist/index.d.ts

@@ -4,5 +4,6 @@ export * from './init/generated.js';
 export * from './registry-wiring.js';
 export * from './shared/file-specs.js';
 export * from './shared/install-link.js';
+export * from './shared/turn-output.js';
 export * from './claude/index.js';
 export * from './codex/index.js';

package/node_modules/@weavecode/harness/dist/index.js

@@ -1 +1 @@
-export*from"./driver.js";export*from"./init/pipeline.js";export*from"./init/generated.js";export*from"./registry-wiring.js";export*from"./shared/file-specs.js";export*from"./shared/install-link.js";export*from"./claude/index.js";export*from"./codex/index.js";
+export*from"./driver.js";export*from"./init/pipeline.js";export*from"./init/generated.js";export*from"./registry-wiring.js";export*from"./shared/file-specs.js";export*from"./shared/install-link.js";export*from"./shared/turn-output.js";export*from"./claude/index.js";export*from"./codex/index.js";

package/node_modules/@weavecode/harness/dist/init/generated.js

@@ -1,2 +1,2 @@
-import i from"node:path";import{generateHookHandler as p,readUserCapture as u}from"../claude/capture.js";import{generateAutoMemoryHook as m}from"../claude/helpers-gen.js";import{generateMcpJson as c,mergeMcpJson as f}from"../claude/mcp-gen.js";import{generateSettingsJson as h,mergeSettingsJson as g}from"../claude/settings-gen.js";export const WEAVE_CONTENT_MARKER="@version weave@";const d={preToolUse:!1,postToolUse:!1,userPromptSubmit:!1,sessionStart:!1,stop:!1,stopFailure:!1,subagentStop:!1,subagentStart:!1,notification:!1,postToolUseFailure:!1,permissionRequest:!1,permissionDenied:!1,preCompact:!1,sessionEnd:!1,preModelSwitch:!1,timeout:5e3,continueOnError:!0};function a(e){try{const o=JSON.parse(e);return typeof o=="object"&&o!==null&&!Array.isArray(o)?o:null}catch{return null}}function t(e){return JSON.stringify(e,null,2)+`
-`}function l(e){return(o,s)=>{const n=a(o),r=a(s);return n===null||r===null?null:t(e(n,r))}}async function S(e){const o=i.join(e.projectPath,".claude","helpers"),n=(await u({home:e.platform.homeDir})).installed?d:e.hooks,r=[];return e.components.helpers&&r.push({relPath:".claude/helpers/hook-handler.cjs",weaveMarker:WEAVE_CONTENT_MARKER,content:p(e.version)},{relPath:".claude/helpers/auto-memory-hook.mjs",weaveMarker:WEAVE_CONTENT_MARKER,content:m(e.version)}),e.components.settings&&r.push({relPath:".claude/settings.json",content:t(h({components:e.components,hooks:n,platform:e.platform,helpersDir:o})),merge:l(g)}),e.components.mcp&&e.mcp.weave&&r.push({relPath:".mcp.json",content:t(c({platform:e.platform,includeWeaveServer:!0})),merge:l(f)}),r}const E={claude:S,codex:async()=>[]};export function generateInitFiles(e,o){return E[e](o)}
+import l from"node:path";import{generateHookHandler as i,readUserCapture as c}from"../claude/capture.js";import{generateAutoMemoryHook as u}from"../claude/helpers-gen.js";import{generateMcpJson as m,mergeMcpJson as h}from"../claude/mcp-gen.js";import{generateSettingsJson as f,mergeSettingsJson as g}from"../claude/settings-gen.js";export const WEAVE_CONTENT_MARKER="@version weave@";const d={preToolUse:!1,postToolUse:!1,userPromptSubmit:!1,sessionStart:!1,stop:!1,stopFailure:!1,subagentStop:!1,subagentStart:!1,notification:!1,postToolUseFailure:!1,permissionRequest:!1,permissionDenied:!1,preCompact:!1,sessionEnd:!1,preModelSwitch:!1,timeout:5e3,continueOnError:!0};function a(e){try{const o=JSON.parse(e);return typeof o=="object"&&o!==null&&!Array.isArray(o)?o:null}catch{return null}}function n(e){return JSON.stringify(e,null,2)+`
+`}function p(e){return(o,r)=>{const t=a(o),s=a(r);return t===null||s===null?null:n(e(t,s))}}async function S(e){const o=l.join(e.projectPath,".claude","helpers"),r=(await c({home:e.platform.homeDir})).installed?d:e.hooks,t=[];return e.components.helpers&&t.push({relPath:".claude/helpers/hook-handler.cjs",weaveMarker:WEAVE_CONTENT_MARKER,content:i(e.version)},{relPath:".claude/helpers/auto-memory-hook.mjs",weaveMarker:WEAVE_CONTENT_MARKER,content:u(e.version)}),e.components.settings&&t.push({relPath:".claude/settings.json",content:n(f({components:e.components,hooks:r,platform:e.platform,helpersDir:o})),merge:p(g)}),e.components.mcp&&e.mcp.weave&&t.push({relPath:".mcp.json",content:n(m({platform:e.platform,includeWeaveServer:!0})),merge:p(h)}),t}const v={claude:S,codex:async()=>[]};export function generateInitFiles(e,o){return v[e](o)}