@weavecode/weave 0.1.2 → 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' | 'statusline';
+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,6 +84,61 @@ 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`），
@@ -96,18 +151,35 @@ export interface EventSource {
  * 类型住这里而非 server：它出现在 [[AssetSurface]] 的方法签名上，server 反向
  * import 会绕回来。
  */
-export interface McpServerConfig {
+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 消费）。
@@ -171,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' | 'sideQuestion';
+export type MessagingChannel = 'discovery' | 'prompt' | 'inject' | 'headless' | 'watch' | 'sideQuestion' | 'pathRefs';
 /** 非抢占注入通道规格：注入可骑乘的事件（hook-handler 在这些事件上消化 outbox 行）。 */
 export interface InjectChannelSpec {
     rideEvents: readonly string[];
@@ -204,23 +289,72 @@ 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 type AttachKind = 'image' | 'file';
+/**
+ * 附件随 prompt 投递的对齐面：「一个已落盘的文件怎么被这个 harness 认出来」是
+ * harness 表示法（claude = 裸绝对路径、一行一条），server 只传语义参数（原文 +
+ * 落盘件的可读路径 / 媒体类型 / 原文件名），怎么引用归这里。null = 该 harness
+ * 不接受任何附件。
  */
-export interface ImageAttachSpec {
+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`），
@@ -371,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 = 完整参考实现，
@@ -385,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 槽规格对象，不复制。 */
@@ -393,8 +546,10 @@ 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 直用）。 */
@@ -541,6 +696,230 @@ export interface StatuslineSurface {
 }
 /** 缓存里的块事实：与 `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;
@@ -557,6 +936,11 @@ export interface HarnessDriver {
     questions?: BlockingPromptSpec;
     capture?: CaptureSurface;
     statusline?: StatuslineSurface;
+    logs?: LogSource;
+    config?: ConfigSurface;
+    edits?: EditsSurface;
+    images?: ImagesSurface;
+    commands?: CommandsSurface;
 }
 /**
  * 能力槽注册表：先到先得（同 id 重复注册抛错，对齐插件先加载者胜）；

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/shared/json-cap.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 归一化 payload 的叶子上限（各 harness 的 normalize 共用）。
+ *
+ * 工具结果正文动辄整份文件（claude 实测库里 64k 行占 557MB，PostToolUse 一条平均
+ * 14KB、最大 7MB），而消费方只读开头一截（事件链摘要取 90 字符）+ 几个标量键。
+ * 4KB 高于问答预览面的 2000 字符阈值，故不会动到需要保真的字段。
+ */
+export declare const MAX_FIELD_CHARS = 4000;
+export declare const MAX_ARRAY_ITEMS = 200;
+/** 逐层裁掉超限的字符串叶子与数组尾巴（对象结构原样保留，键不丢）。 */
+export declare function capFields(value: unknown): unknown;

package/node_modules/@weavecode/harness/dist/shared/json-cap.js

@@ -0,0 +1 @@
+export const MAX_FIELD_CHARS=4e3,MAX_ARRAY_ITEMS=200;export function capFields(e){if(typeof e=="string")return e.length>4e3?`${e.slice(0,4e3)}\u2026`:e;if(Array.isArray(e))return e.slice(0,200).map(capFields);if(e&&typeof e=="object"){const r={};for(const[n,o]of Object.entries(e))r[n]=capFields(o);return r}return e}

package/node_modules/@weavecode/harness/dist/shared/turn-output.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 每轮收尾事件上带的「这一轮最后说了什么」（`raw.last_assistant_message`）：claude 由
+ * 宿主原样上报，codex 适配器按同一键形归一（`codex/event-source.ts`），故读侧只有这一
+ * 处键形知识。非字符串 / 空 → null（空回合不摆空壳，调用方继续往前找）。
+ */
+export declare function turnOutputOf(raw: unknown): string | null;

package/node_modules/@weavecode/harness/dist/shared/turn-output.js

@@ -0,0 +1 @@
+export function turnOutputOf(n){const t=n?.last_assistant_message;return typeof t=="string"&&t.trim()?t:null}

package/node_modules/@weavecode/harness/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weavecode/harness",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Pluggable harness drivers — registry, init pipeline template method, and harness integration modules",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
     "node": ">=22.5.0"
   },
   "dependencies": {
-    "@weavecode/core": "^0.1.2",
+    "@weavecode/core": "^0.1.3",
     "smol-toml": "^1.3.0"
   }
 }

package/node_modules/@weavecode/server/dist/config/dotted.d.ts

@@ -0,0 +1,10 @@
+/** 配置表单的一次改动：`path` 是点号路径（`sandbox.filesystem.allowWrite`）。 */
+export interface ConfigUpdate {
+    path: string;
+    value?: unknown;
+    remove?: boolean;
+}
+/** 点号路径取值（不存在 → undefined）。 */
+export declare function getDotted(root: Record<string, unknown>, dotted: string): unknown;
+/** 批量落值/删键，返回新对象（不改入参）。 */
+export declare function applyUpdates(root: Record<string, unknown>, updates: readonly ConfigUpdate[]): Record<string, unknown>;

package/node_modules/@weavecode/server/dist/config/dotted.js

@@ -0,0 +1 @@
+function s(o){return o==="__proto__"||o==="constructor"||o==="prototype"}function f(o){const r=o.split(".");if(r.some(t=>!t||s(t)))throw new Error(`\u975E\u6CD5\u914D\u7F6E\u952E\uFF1A${o}`);return r}function u(o){return typeof o=="object"&&o!==null&&!Array.isArray(o)}const c=Symbol("absent");function i(o,r){let t=o;for(const n of r){if(!u(t))return c;t=t[n]}return t===void 0?c:t}function l(o,r){let t=o;for(const n of r.slice(0,-1)){const e=t[n];if(!u(e))return;t=e}delete t[r[r.length-1]]}function p(o,r,t){let n=o;for(const e of r.slice(0,-1))u(n[e])||(n[e]={}),n=n[e];n[r[r.length-1]]=t}export function getDotted(o,r){const t=i(o,f(r));return t===c?void 0:t}export function applyUpdates(o,r){const t=structuredClone(o);for(const n of r){const e=f(n.path);n.remove?l(t,e):p(t,e,n.value)}return t}

package/node_modules/@weavecode/server/dist/config/profiles.d.ts

@@ -0,0 +1,30 @@
+import type { ConfigFileId } from '@weavecode/harness';
+/**
+ * 配置快照的落盘面。`root` = `local/harness-config`（由调用方给，测试用临时目录）：
+ * 快照里可能带 API key ⇒ 本机专属、不进 settings 表、不随迁移带走。
+ */
+export interface ConfigProfileMeta {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ConfigProfileState {
+    activeId: string | null;
+    profiles: ConfigProfileMeta[];
+}
+export declare function listProfiles(root: string, harness: string, file: ConfigFileId): Promise<ConfigProfileState>;
+/** 落一份快照（整份 JSON）。 */
+export declare function writeSnapshot(root: string, harness: string, file: ConfigFileId, id: string, values: Record<string, unknown>): Promise<void>;
+export declare function readSnapshot(root: string, harness: string, file: ConfigFileId, id: string): Promise<Record<string, unknown> | null>;
+export declare function createProfile(root: string, harness: string, file: ConfigFileId, name: string, values: Record<string, unknown>): Promise<ConfigProfileMeta>;
+/** 覆盖某份快照的内容并刷新 updatedAt。 */
+export declare function saveProfile(root: string, harness: string, file: ConfigFileId, id: string, values: Record<string, unknown>): Promise<void>;
+export declare function renameProfile(root: string, harness: string, file: ConfigFileId, id: string, name: string): Promise<void>;
+export declare function removeProfile(root: string, harness: string, file: ConfigFileId, id: string): Promise<void>;
+export declare function setActive(root: string, harness: string, file: ConfigFileId, id: string | null): Promise<void>;
+/** 写盘前把当前活配置存一份（每档留最新 20 份，超出按时间删旧）。 */
+export declare function pushBackup(root: string, harness: string, file: ConfigFileId, values: Record<string, unknown>): Promise<void>;
+/** 备份列表（新 → 旧）。 */
+export declare function listBackups(root: string, harness: string, file: ConfigFileId): Promise<string[]>;
+export declare function readBackup(root: string, harness: string, file: ConfigFileId, id: string): Promise<Record<string, unknown> | null>;

package/node_modules/@weavecode/server/dist/config/profiles.js

@@ -0,0 +1,2 @@
+import s from"node:fs/promises";import u from"node:path";import{randomUUID as v}from"node:crypto";const A=20;function d(n,t){return u.join(n,t)}function h(n,t){return u.join(d(n,t),"profiles.json")}function w(n,t,i,r){return u.join(d(n,t),`${i}-${r}.json`)}function l(n,t){return u.join(d(n,t),"backups")}function j(n,t,i,r){return u.join(l(n,t),`${i}-${r}.json`)}async function y(n){try{const t=JSON.parse(await s.readFile(n,"utf8"));return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:null}catch{return null}}async function m(n,t){await s.mkdir(u.dirname(n),{recursive:!0});const i=`${n}.${process.pid}.${Date.now()}.tmp`;await s.writeFile(i,`${JSON.stringify(t,null,2)}
+`,"utf8"),await s.rename(i,n)}async function x(n,t){return await y(h(n,t))??{}}function I(){return{activeId:null,profiles:[]}}function $(n,t){return n[t]??I()}export async function listProfiles(n,t,i){return $(await x(n,t),i)}async function f(n,t,i,r){const a=await x(n,t),e=$(a,i);return r(e),a[i]=e,await m(h(n,t),a),e}function p(){return new Date().toISOString()}export async function writeSnapshot(n,t,i,r,a){await m(w(n,t,i,r),a)}export async function readSnapshot(n,t,i,r){return y(w(n,t,i,r))}export async function createProfile(n,t,i,r,a){const e={id:v().slice(0,8),name:r,createdAt:p(),updatedAt:p()};return await writeSnapshot(n,t,i,e.id,a),await f(n,t,i,o=>{o.profiles.push(e)}),e}export async function saveProfile(n,t,i,r,a){await writeSnapshot(n,t,i,r,a),await f(n,t,i,e=>{const o=e.profiles.find(c=>c.id===r);o&&(o.updatedAt=p())})}export async function renameProfile(n,t,i,r,a){await f(n,t,i,e=>{const o=e.profiles.find(c=>c.id===r);o&&(o.name=a,o.updatedAt=p())})}export async function removeProfile(n,t,i,r){await f(n,t,i,a=>{a.profiles=a.profiles.filter(e=>e.id!==r),a.activeId===r&&(a.activeId=null)}),await s.rm(w(n,t,i,r),{force:!0})}export async function setActive(n,t,i,r){await f(n,t,i,a=>{a.activeId=r})}export async function pushBackup(n,t,i,r){const a=p().replace(/[:.]/g,"-");await m(j(n,t,i,a),r);const e=`${i}-`,o=(await s.readdir(l(n,t)).catch(()=>[])).filter(c=>c.startsWith(e)&&c.endsWith(".json")).sort().reverse();for(const c of o.slice(A))await s.rm(u.join(l(n,t),c),{force:!0})}export async function listBackups(n,t,i){const r=`${i}-`;return(await s.readdir(l(n,t)).catch(()=>[])).filter(a=>a.startsWith(r)&&a.endsWith(".json")).sort().reverse().map(a=>a.slice(r.length,-5))}export async function readBackup(n,t,i,r){return/^[A-Za-z0-9-]+$/.test(r)?y(j(n,t,i,r)):null}

package/node_modules/@weavecode/server/dist/daemon/ai-config.js

@@ -1,2 +1,2 @@
-import{chmodSync as o,existsSync as c,mkdirSync as i,readFileSync as u,renameSync as y,rmSync as m,writeFileSync as p}from"node:fs";import a from"node:path";import{getAiKeyPath as n}from"../db/paths.js";export function readAiKey(t=n()){if(!c(t))return null;try{const r=JSON.parse(u(t,"utf8"));return typeof r.apiKey=="string"&&r.apiKey!==""?r.apiKey:null}catch{return null}}export function writeAiKey(t,r=n()){if(t===null||t===""){m(r,{force:!0});return}i(a.dirname(r),{recursive:!0});const e=`${r}.tmp`;p(e,`${JSON.stringify({apiKey:t},null,2)}
-`,{encoding:"utf8",mode:384}),y(e,r);try{o(r,384)}catch{}}export function hasAiKey(t=n()){return readAiKey(t)!==null}
+import{chmodSync as t,existsSync as a,mkdirSync as c,readFileSync as o,renameSync as y,rmSync as u,writeFileSync as s}from"node:fs";import l from"node:path";import{getAiKeyPath as r}from"../db/paths.js";export function readAiKey(n=r()){if(!a(n))return null;try{const e=JSON.parse(o(n,"utf8"));return typeof e.apiKey=="string"&&e.apiKey!==""?e.apiKey:null}catch{return null}}export function writeAiKey(n,e=r()){if(n===null||n===""){u(e,{force:!0});return}c(l.dirname(e),{recursive:!0});const i=`${e}.tmp`;s(i,`${JSON.stringify({apiKey:n},null,2)}
+`,{encoding:"utf8",mode:384}),y(i,e);try{t(e,384)}catch{}}export function hasAiKey(n=r()){return readAiKey(n)!==null}

package/node_modules/@weavecode/server/dist/daemon/ai-context.d.ts

@@ -12,6 +12,6 @@ export declare function findDocsDir(start: string): string | null;
 export declare function collectSkillFiles(root: string, limit?: number): string[];
 /** 装配系统提示词（三源 + 固定前言）。 */
 export declare function buildSystemPrompt(deps: {
-    dataDir: string;
+    dataRoot: string;
     cwd?: string;
 }): AiContextResult;