mosse-agent-bridge 0.1.4 → 0.1.5

package/dist/acp/client.d.ts

@@ -0,0 +1,47 @@
+import type { Readable, Writable } from "node:stream";
+import { type ContentBlock, type InitializeResult, type LoadSessionParams, type McpServer, type NewSessionResult, type PromptResult, type SessionUpdateNotification } from "./types.js";
+/** initialize 阶段协议版本/capability 校验失败时抛出(受控,不静默继续)。见 §9.4。 */
+export declare class AcpProtocolError extends Error {
+    constructor(message: string);
+}
+export type SessionUpdateHandler = (n: SessionUpdateNotification) => void;
+export interface InitializeOptions {
+    /** 客户端期望的协议大版本(默认 ACP_PROTOCOL_VERSION=1)。agent 回的版本须 === 此值,否则受控报错。 */
+    expectedVersion?: number;
+    /** 上报给 agent 的 clientCapabilities(默认空对象)。 */
+    clientCapabilities?: Record<string, unknown>;
+}
+export interface NewSessionArgs {
+    cwd: string;
+    mcpServers?: McpServer[];
+}
+export interface PromptArgs {
+    sessionId: string;
+    content: ContentBlock[];
+}
+export declare class AcpClient {
+    private readonly conn;
+    private readonly updateHandlers;
+    private initialized;
+    constructor(readable: Readable, writable: Writable);
+    /** 订阅服务端推送的 session/update(原样透传;F2.2 driver 负责映射成 CcEvent)。 */
+    onSessionUpdate(cb: SessionUpdateHandler): void;
+    /** initialize:协商协议版本 + 交换 capabilities。版本不匹配 → AcpProtocolError(§9.4)。 */
+    initialize(opts?: InitializeOptions): Promise<InitializeResult>;
+    /** session/new:开新会话,返回 sessionId。 */
+    newSession(args: NewSessionArgs): Promise<NewSessionResult>;
+    /** session/load:恢复已有会话(agent 先经 session/update 重放历史,再 resolve)。 */
+    loadSession(args: LoadSessionParams): Promise<void>;
+    /** session/load 的语义别名(Hermes 文档里有 resume_session;映射到官方 session/load)。 */
+    resumeSession(args: LoadSessionParams): Promise<void>;
+    /** session/prompt:发一轮 prompt content blocks,等回合结束的 PromptResponse{stopReason}。
+     *  回合中服务端经 onSessionUpdate 推流。 */
+    prompt(args: PromptArgs): Promise<PromptResult>;
+    /** session/set_model:覆盖该会话的模型(D6;Mosse agent 指定 model 时用,否则用 Hermes 配置默认)。
+     *  Hermes acp_adapter 文档作 set_session_model;映射到 ACP 的 session/set_model(modelId)。 */
+    setSessionModel(sessionId: string, modelId: string): Promise<void>;
+    /** session/cancel:通知 agent 取消进行中的回合(无响应;进行中的 prompt 将回 stopReason:"cancelled")。 */
+    cancel(sessionId: string): void;
+    /** 是否已成功 initialize(供消费方防御性检查)。 */
+    get isInitialized(): boolean;
+}

package/dist/acp/client.js

@@ -0,0 +1,94 @@
+// 最小 ACP 客户端 —— Hermes 适配 M2 F2.1。
+// 通用(不含 Hermes 具体 spawn / 事件映射,那是 F2.2)。对一对 readable/writable 流工作,
+// 将来接子进程 stdout/stdin。只封装我们要用的方法 + session/update 订阅。
+//
+// 方法集与 schema 来源见 ./types.ts 顶部注释(官方 ACP 规范 + Hermes acp_adapter)。
+// 分帧 = newline-delimited JSON-RPC(见 ./jsonrpc.ts)。
+import { JsonRpcConnection } from "./jsonrpc.js";
+import { ACP_PROTOCOL_VERSION, } from "./types.js";
+/** initialize 阶段协议版本/capability 校验失败时抛出(受控,不静默继续)。见 §9.4。 */
+export class AcpProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AcpProtocolError";
+    }
+}
+export class AcpClient {
+    conn;
+    updateHandlers = [];
+    initialized = false;
+    constructor(readable, writable) {
+        this.conn = new JsonRpcConnection(readable, writable);
+        // 把 ACP 的 session/update 通知分发给订阅者;其它通知忽略(本通用客户端不需要)。
+        this.conn.onNotification((m) => {
+            if (m.method === "session/update") {
+                const n = m.params;
+                for (const cb of this.updateHandlers)
+                    cb(n);
+            }
+        });
+    }
+    /** 订阅服务端推送的 session/update(原样透传;F2.2 driver 负责映射成 CcEvent)。 */
+    onSessionUpdate(cb) {
+        this.updateHandlers.push(cb);
+    }
+    /** initialize:协商协议版本 + 交换 capabilities。版本不匹配 → AcpProtocolError(§9.4)。 */
+    async initialize(opts = {}) {
+        const expected = opts.expectedVersion ?? ACP_PROTOCOL_VERSION;
+        const params = {
+            protocolVersion: expected,
+            clientCapabilities: opts.clientCapabilities ?? {},
+        };
+        const res = await this.conn.request("initialize", params);
+        // 协议版本是单整数大版本号;不匹配则受控报错(防协议漂移静默破坏)。
+        if (typeof res?.protocolVersion !== "number") {
+            throw new AcpProtocolError(`ACP initialize: agent did not return a numeric protocolVersion (got ${JSON.stringify(res?.protocolVersion)})`);
+        }
+        if (res.protocolVersion !== expected) {
+            throw new AcpProtocolError(`ACP protocol version mismatch: client expected ${expected}, agent reported ${res.protocolVersion}`);
+        }
+        this.initialized = true;
+        return res;
+    }
+    /** session/new:开新会话,返回 sessionId。 */
+    newSession(args) {
+        return this.conn.request("session/new", {
+            cwd: args.cwd,
+            ...(args.mcpServers ? { mcpServers: args.mcpServers } : {}),
+        });
+    }
+    /** session/load:恢复已有会话(agent 先经 session/update 重放历史,再 resolve)。 */
+    async loadSession(args) {
+        await this.conn.request("session/load", {
+            sessionId: args.sessionId,
+            cwd: args.cwd,
+            ...(args.mcpServers ? { mcpServers: args.mcpServers } : {}),
+        });
+    }
+    /** session/load 的语义别名(Hermes 文档里有 resume_session;映射到官方 session/load)。 */
+    resumeSession(args) {
+        return this.loadSession(args);
+    }
+    /** session/prompt:发一轮 prompt content blocks,等回合结束的 PromptResponse{stopReason}。
+     *  回合中服务端经 onSessionUpdate 推流。 */
+    prompt(args) {
+        return this.conn.request("session/prompt", {
+            sessionId: args.sessionId,
+            prompt: args.content,
+        });
+    }
+    /** session/set_model:覆盖该会话的模型(D6;Mosse agent 指定 model 时用,否则用 Hermes 配置默认)。
+     *  Hermes acp_adapter 文档作 set_session_model;映射到 ACP 的 session/set_model(modelId)。 */
+    async setSessionModel(sessionId, modelId) {
+        await this.conn.request("session/set_model", { sessionId, modelId });
+    }
+    /** session/cancel:通知 agent 取消进行中的回合(无响应;进行中的 prompt 将回 stopReason:"cancelled")。 */
+    cancel(sessionId) {
+        this.conn.notify("session/cancel", { sessionId });
+    }
+    /** 是否已成功 initialize(供消费方防御性检查)。 */
+    get isInitialized() {
+        return this.initialized;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/acp/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/acp/client.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,mEAAmE;AACnE,sDAAsD;AACtD,EAAE;AACF,mEAAmE;AACnE,mDAAmD;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,oBAAoB,GASrB,MAAM,YAAY,CAAC;AAEpB,6DAA6D;AAC7D,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAqBD,MAAM,OAAO,SAAS;IACH,IAAI,CAAoB;IACxB,cAAc,GAA2B,EAAE,CAAC;IACrD,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,QAAkB,EAAE,QAAkB;QAChD,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtD,qDAAqD;QACrD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAmC,CAAC;gBAChD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc;oBAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IAC/D,eAAe,CAAC,EAAwB;QACtC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,UAAU,CAAC,OAA0B,EAAE;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,IAAI,oBAAoB,CAAC;QAC9D,MAAM,MAAM,GAAqB;YAC/B,eAAe,EAAE,QAAQ;YACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,EAAE;SAClD,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmB,YAAY,EAAE,MAAM,CAAC,CAAC;QAC5E,oCAAoC;QACpC,IAAI,OAAO,GAAG,EAAE,eAAe,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,IAAI,gBAAgB,CACxB,uEAAuE,IAAI,CAAC,SAAS,CACnF,GAAG,EAAE,eAAe,CACrB,GAAG,CACL,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,gBAAgB,CACxB,kDAAkD,QAAQ,oBAAoB,GAAG,CAAC,eAAe,EAAE,CACpG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,qCAAqC;IACrC,UAAU,CAAC,IAAoB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmB,aAAa,EAAE;YACxD,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,WAAW,CAAC,IAAuB;QACvC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YACtC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,aAAa,CAAC,IAAuB;QACnC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;sCACkC;IAClC,MAAM,CAAC,IAAgB;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAe,gBAAgB,EAAE;YACvD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;IAED;yFACqF;IACrF,KAAK,CAAC,eAAe,CAAC,SAAiB,EAAE,OAAe;QACtD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,mFAAmF;IACnF,MAAM,CAAC,SAAiB;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,mCAAmC;IACnC,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/acp/index.d.ts

@@ -0,0 +1,5 @@
+export { AcpClient, AcpProtocolError } from "./client.js";
+export type { InitializeOptions, NewSessionArgs, PromptArgs, SessionUpdateHandler, } from "./client.js";
+export { JsonRpcConnection, LineFramer } from "./jsonrpc.js";
+export type { NotificationHandler } from "./jsonrpc.js";
+export * from "./types.js";

package/dist/acp/index.js

@@ -0,0 +1,6 @@
+// ACP(Agent Client Protocol)最小客户端 —— Hermes 适配 M2 F2.1。
+// 通用 JSON-RPC-over-stdio 客户端;Hermes 具体 spawn / 事件映射在 F2.2。
+export { AcpClient, AcpProtocolError } from "./client.js";
+export { JsonRpcConnection, LineFramer } from "./jsonrpc.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,2DAA2D;AAC3D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAO1D,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7D,cAAc,YAAY,CAAC"}

package/dist/acp/jsonrpc.d.ts

@@ -0,0 +1,37 @@
+import type { Readable, Writable } from "node:stream";
+/** 把任意切分的字节流(stdout chunk)重组成完整文本行(按 \n 切,跳过空行 / \r)。
+ *  纯状态机,易单测半包组装。 */
+export declare class LineFramer {
+    private buf;
+    /** 喂入一段文本,返回本次可完整产出的行(已去掉换行 / \r,跳过空行)。 */
+    push(chunk: string): string[];
+}
+export type NotificationHandler = (msg: {
+    method: string;
+    params: unknown;
+}) => void;
+/** 一对 readable(agent stdout)/writable(agent stdin)上的 JSON-RPC 连接:
+ *  - request(method, params):写带 id 的请求,按 id 配对响应(result→resolve / error→reject)。
+ *  - notify(method, params):写无 id 的通知。
+ *  - onNotification(cb):订阅服务端推来的通知(如 session/update)。
+ *  坏 JSON 行被跳过(不崩);流关闭时挂起请求全部 reject。 */
+export declare class JsonRpcConnection {
+    private readonly readable;
+    private readonly writable;
+    private readonly framer;
+    private readonly pending;
+    private readonly notifyHandlers;
+    private nextId;
+    private closed;
+    constructor(readable: Readable, writable: Writable);
+    /** 发请求,返回响应 result(或在 error / 流关闭时 reject)。 */
+    request<T = unknown>(method: string, params?: unknown): Promise<T>;
+    /** 发通知(无响应)。 */
+    notify(method: string, params?: unknown): void;
+    /** 订阅服务端通知。 */
+    onNotification(cb: NotificationHandler): void;
+    private write;
+    private onData;
+    private dispatch;
+    private onClosed;
+}

package/dist/acp/jsonrpc.js

@@ -0,0 +1,120 @@
+// 最小 JSON-RPC 2.0 over stdio —— newline-delimited 分帧(ACP §分帧:一行一帧,无内嵌换行)。
+// D4 终裁:手写,不引第三方 ACP 库。stdout=协议帧、stderr=日志(由消费方保证,客户端不混入)。
+/** 把任意切分的字节流(stdout chunk)重组成完整文本行(按 \n 切,跳过空行 / \r)。
+ *  纯状态机,易单测半包组装。 */
+export class LineFramer {
+    buf = "";
+    /** 喂入一段文本,返回本次可完整产出的行(已去掉换行 / \r,跳过空行)。 */
+    push(chunk) {
+        this.buf += chunk;
+        const lines = [];
+        let nl = this.buf.indexOf("\n");
+        while (nl >= 0) {
+            const line = this.buf.slice(0, nl).replace(/\r$/, "");
+            this.buf = this.buf.slice(nl + 1);
+            if (line.length > 0)
+                lines.push(line);
+            nl = this.buf.indexOf("\n");
+        }
+        return lines;
+    }
+}
+/** 一对 readable(agent stdout)/writable(agent stdin)上的 JSON-RPC 连接:
+ *  - request(method, params):写带 id 的请求,按 id 配对响应(result→resolve / error→reject)。
+ *  - notify(method, params):写无 id 的通知。
+ *  - onNotification(cb):订阅服务端推来的通知(如 session/update)。
+ *  坏 JSON 行被跳过(不崩);流关闭时挂起请求全部 reject。 */
+export class JsonRpcConnection {
+    readable;
+    writable;
+    framer = new LineFramer();
+    pending = new Map();
+    notifyHandlers = [];
+    nextId = 1;
+    closed = false;
+    constructor(readable, writable) {
+        this.readable = readable;
+        this.writable = writable;
+        this.readable.setEncoding("utf8");
+        this.readable.on("data", (chunk) => this.onData(chunk));
+        this.readable.on("close", () => this.onClosed());
+        this.readable.on("end", () => this.onClosed());
+        this.readable.on("error", (e) => this.onClosed(e));
+    }
+    /** 发请求,返回响应 result(或在 error / 流关闭时 reject)。 */
+    request(method, params) {
+        if (this.closed)
+            return Promise.reject(new Error("ACP connection closed"));
+        const id = this.nextId++;
+        const req = { jsonrpc: "2.0", id, method, params };
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve: resolve, reject });
+            this.write(req);
+        });
+    }
+    /** 发通知(无响应)。 */
+    notify(method, params) {
+        if (this.closed)
+            return;
+        const note = { jsonrpc: "2.0", method, params };
+        this.write(note);
+    }
+    /** 订阅服务端通知。 */
+    onNotification(cb) {
+        this.notifyHandlers.push(cb);
+    }
+    write(msg) {
+        // 单行一帧:JSON.stringify 不产出内嵌换行(payload 内换行被转义为 \\n),行尾补 \n。
+        this.writable.write(`${JSON.stringify(msg)}\n`);
+    }
+    onData(chunk) {
+        for (const line of this.framer.push(chunk)) {
+            let msg;
+            try {
+                msg = JSON.parse(line);
+            }
+            catch {
+                // 坏 JSON / 误入 stdout 的非协议行 → 跳过,不崩(消费方应把日志走 stderr)。
+                continue;
+            }
+            this.dispatch(msg);
+        }
+    }
+    dispatch(msg) {
+        // 带 id 且有 result/error → 响应;带 method 且无 id → 通知;带 id+method → 服务端请求(本客户端暂不处理,忽略)。
+        const m = msg;
+        if (m.id !== undefined && m.method === undefined) {
+            const p = this.pending.get(m.id);
+            if (!p)
+                return; // 未知 id → 丢弃
+            this.pending.delete(m.id);
+            if (m.error)
+                p.reject(rpcError(m.error));
+            else
+                p.resolve(m.result);
+            return;
+        }
+        if (m.method !== undefined && m.id === undefined) {
+            for (const cb of this.notifyHandlers)
+                cb({ method: m.method, params: m.params });
+            return;
+        }
+        // 服务端→客户端请求(ACP 双向)本通用客户端不需要 → 忽略(F2.x 如需可扩展)。
+    }
+    onClosed(err) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const reason = err ? `ACP connection closed: ${err.message}` : "ACP connection closed";
+        for (const [, p] of this.pending)
+            p.reject(new Error(reason));
+        this.pending.clear();
+    }
+}
+function rpcError(e) {
+    const err = new Error(`ACP RPC error ${e.code}: ${e.message}`);
+    err.code = e.code;
+    err.data = e.data;
+    return err;
+}
+//# sourceMappingURL=jsonrpc.js.map

package/dist/acp/jsonrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/acp/jsonrpc.ts"],"names":[],"mappings":"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"}

package/dist/acp/mock-server.d.ts

@@ -0,0 +1,15 @@
+import type { PassThrough } from "node:stream";
+export interface MockServerOptions {
+    /** initialize 回报的协议版本(默认 = 客户端期望版本,用于测"版本不符"时传别的)。 */
+    protocolVersion?: number;
+    /** prompt 期间推送的 session/update 序列(默认给一组有序文本/思考/工具)。 */
+    updates?: Record<string, unknown>[];
+    /** prompt 最终 stopReason(默认 end_turn)。 */
+    stopReason?: string;
+    /** session/new 返回的 sessionId。 */
+    sessionId?: string;
+}
+/** 接 fromClient(客户端写给 agent 的流 = agent stdin)/ toClient(agent 写给客户端 = agent stdout)。 */
+export declare function startMockAcpServer(fromClient: PassThrough, toClient: PassThrough, opts?: MockServerOptions): {
+    cancelled: boolean;
+};

package/dist/acp/mock-server.js

@@ -0,0 +1,100 @@
+// 确定性 mock ACP server(stdio 形状)—— F2.1 TDD fixture。
+// 不依赖子进程:对一对 PassThrough(模拟 agent stdin/stdout)回应固定的 JSON-RPC,
+// 行为镜像真 hermes acp 的协议骨架(以官方 ACP schema 为准):
+//   - initialize → 回 { protocolVersion, agentCapabilities }
+//   - session/new → 回 { sessionId }
+//   - session/load → 回 null(先重放历史 session/update 再 resolve,可选)
+//   - session/prompt → 先推几条 session/update(agent_message_chunk / agent_thought_chunk /
+//     tool_call),再回 { stopReason: "end_turn" }
+//   - session/cancel(通知)→ 记录,被取消的 prompt 回 { stopReason: "cancelled" }
+//
+// 用 LineFramer 解析客户端写入,确定性、无定时器(除 prompt 的微任务排序)。
+import { LineFramer } from "./jsonrpc.js";
+import { ACP_PROTOCOL_VERSION } from "./types.js";
+/** 接 fromClient(客户端写给 agent 的流 = agent stdin)/ toClient(agent 写给客户端 = agent stdout)。 */
+export function startMockAcpServer(fromClient, toClient, opts = {}) {
+    const state = { cancelled: false };
+    const framer = new LineFramer();
+    const sessionId = opts.sessionId ?? "sess_mock_1";
+    const protocolVersion = opts.protocolVersion ?? ACP_PROTOCOL_VERSION;
+    const stopReason = opts.stopReason ?? "end_turn";
+    const updates = opts.updates ??
+        [
+            { sessionUpdate: "agent_thought_chunk", content: { type: "text", text: "thinking…" } },
+            { sessionUpdate: "agent_message_chunk", content: { type: "text", text: "Hello" } },
+            { sessionUpdate: "agent_message_chunk", content: { type: "text", text: " world" } },
+            { sessionUpdate: "tool_call", toolCallId: "t1", title: "Read", status: "pending" },
+        ];
+    function send(obj) {
+        toClient.write(`${JSON.stringify(obj)}\n`);
+    }
+    function reply(id, result) {
+        send({ jsonrpc: "2.0", id, result });
+    }
+    function replyError(id, code, message) {
+        send({ jsonrpc: "2.0", id, error: { code, message } });
+    }
+    function notify(method, params) {
+        send({ jsonrpc: "2.0", method, params });
+    }
+    fromClient.setEncoding("utf8");
+    fromClient.on("data", (chunk) => {
+        for (const line of framer.push(chunk)) {
+            let msg;
+            try {
+                msg = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            handle(msg);
+        }
+    });
+    function handle(msg) {
+        switch (msg.method) {
+            case "initialize":
+                reply(msg.id, {
+                    protocolVersion,
+                    agentCapabilities: { loadSession: true, promptCapabilities: { image: false } },
+                });
+                return;
+            case "session/new":
+                reply(msg.id, { sessionId });
+                return;
+            case "session/set_model":
+                // 模型覆盖(D6);ACP 回 null。
+                reply(msg.id, null);
+                return;
+            case "session/load":
+                // 先重放一条历史 user_message_chunk,再 resolve null。
+                notify("session/update", {
+                    sessionId: msg.params?.sessionId ?? sessionId,
+                    update: { sessionUpdate: "user_message_chunk", content: { type: "text", text: "prev" } },
+                });
+                reply(msg.id, null);
+                return;
+            case "session/prompt": {
+                const sid = msg.params?.sessionId ?? sessionId;
+                if (state.cancelled) {
+                    reply(msg.id, { stopReason: "cancelled" });
+                    return;
+                }
+                // 有序推送 session/update,然后回 PromptResponse(确定性:同步顺序写入)。
+                for (const u of updates)
+                    notify("session/update", { sessionId: sid, update: u });
+                reply(msg.id, { stopReason });
+                return;
+            }
+            case "session/cancel":
+                // 通知,无响应。标记取消(影响后续 prompt 在某些测试里)。
+                state.cancelled = true;
+                return;
+            default:
+                if (msg.id !== undefined)
+                    replyError(msg.id, -32601, `method not found: ${msg.method}`);
+                return;
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=mock-server.js.map

package/dist/acp/mock-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.js","sourceRoot":"","sources":["../../src/acp/mock-server.ts"],"names":[],"mappings":"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"}

package/dist/acp/types.d.ts

@@ -0,0 +1,138 @@
+/** ACP 当前协议大版本(单整数);见 §9.4 协议版本校验。 */
+export declare const ACP_PROTOCOL_VERSION = 1;
+/** 文本内容块(prompt / agent_message_chunk 主用)。 */
+export interface TextContentBlock {
+    type: "text";
+    text: string;
+    annotations?: unknown;
+}
+/** 图片内容块。 */
+export interface ImageContentBlock {
+    type: "image";
+    data: string;
+    mimeType: string;
+    uri?: string;
+    annotations?: unknown;
+}
+/** 音频内容块。 */
+export interface AudioContentBlock {
+    type: "audio";
+    data: string;
+    mimeType: string;
+    annotations?: unknown;
+}
+/** 内嵌资源。 */
+export interface ResourceContentBlock {
+    type: "resource";
+    resource: {
+        uri: string;
+        text?: string;
+        blob?: string;
+        mimeType?: string;
+    };
+    annotations?: unknown;
+}
+/** 资源链接。 */
+export interface ResourceLinkContentBlock {
+    type: "resource_link";
+    uri: string;
+    name: string;
+    mimeType?: string;
+    title?: string;
+    description?: string;
+    size?: number;
+    annotations?: unknown;
+}
+export type ContentBlock = TextContentBlock | ImageContentBlock | AudioContentBlock | ResourceContentBlock | ResourceLinkContentBlock;
+/** stdio transport MCP server(name + 绝对 command + args + env)。 */
+export interface McpServerStdio {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: {
+        name: string;
+        value: string;
+    }[];
+}
+/** http / sse transport MCP server。 */
+export interface McpServerHttp {
+    type: "http" | "sse";
+    name: string;
+    url: string;
+    headers?: {
+        name: string;
+        value: string;
+    }[];
+}
+export type McpServer = McpServerStdio | McpServerHttp;
+/** initialize 请求 params。capabilities 形状由各端自定义,本客户端只声明并校验版本。 */
+export interface InitializeParams {
+    protocolVersion: number;
+    clientCapabilities?: Record<string, unknown>;
+}
+/** initialize 响应:agent 回报它支持的版本 + capabilities + 可选 authMethods。 */
+export interface InitializeResult {
+    protocolVersion: number;
+    agentCapabilities?: Record<string, unknown>;
+    authMethods?: unknown[];
+}
+export interface NewSessionParams {
+    cwd: string;
+    mcpServers?: McpServer[];
+}
+export interface NewSessionResult {
+    sessionId: string;
+}
+export interface LoadSessionParams {
+    sessionId: string;
+    cwd: string;
+    mcpServers?: McpServer[];
+}
+export interface PromptParams {
+    sessionId: string;
+    prompt: ContentBlock[];
+}
+/** PromptResponse:本回合为何停。 */
+export type StopReason = "end_turn" | "max_tokens" | "max_turn_requests" | "refusal" | "cancelled";
+export interface PromptResult {
+    stopReason: StopReason;
+    /** 部分 agent(含 Hermes)附带用量;形状不固定,原样透传。 */
+    usage?: unknown;
+}
+export interface CancelParams {
+    sessionId: string;
+}
+/** session/update 的 update 体:判别字段 sessionUpdate(snake_case 值);其余字段随变体而定。
+ *  本通用客户端不解释内容 —— 原样透传给订阅者(F2.2 driver 负责映射成 CcEvent)。 */
+export interface SessionUpdate {
+    sessionUpdate: string;
+    [k: string]: unknown;
+}
+export interface SessionUpdateNotification {
+    sessionId: string;
+    update: SessionUpdate;
+}
+export type JsonRpcId = number | string;
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;

package/dist/acp/types.js

@@ -0,0 +1,20 @@
+// ACP (Agent Client Protocol) 线协议类型 —— Hermes 适配 M2 F2.1。
+//
+// 来源(以官方 schema 为准,代码据实不臆造):
+//   - 规范站 https://agentclientprotocol.com(Zed 开放标准)
+//     · 概览/方法集:initialize / authenticate / session/new / session/load /
+//       session/prompt / session/cancel + session/update 通知。
+//     · 分帧:newline-delimited JSON-RPC 2.0 over stdio(stdout=协议帧、stderr=日志);
+//       一行一个 JSON 对象,**不得含内嵌换行**(LSP 风格 Content-Length **不**使用)。
+//     · 字段命名:对象属性 camelCase;唯有判别字段(如 update.sessionUpdate 的值、
+//       content.type)用 snake_case。protocolVersion 是**单个整数**(当前 = 1)。
+//   - Hermes acp_adapter(github NousResearch/hermes-agent acp_adapter/server.py):
+//     实现 initialize/authenticate/session/new|load|resume|fork/prompt/cancel +
+//     set_model/set_mode;session_update 变体含 agent_message_chunk /
+//     agent_thought_chunk / tool_start / tool_complete / plan_update / usage_update /
+//     user_message_chunk(注:tool/plan 变体名 Hermes 用 tool_start/tool_complete/
+//     plan_update,官方 schema 用 tool_call/tool_call_update/plan —— 本通用客户端
+//     **不解释 update 内容**,原样透传给 onSessionUpdate,由 F2.2 driver 做收敛映射)。
+/** ACP 当前协议大版本(单整数);见 §9.4 协议版本校验。 */
+export const ACP_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/acp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/acp/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,6BAA6B;AAC7B,oDAAoD;AACpD,wEAAwE;AACxE,6DAA6D;AAC7D,4EAA4E;AAC5E,iEAAiE;AACjE,8DAA8D;AAC9D,qEAAqE;AACrE,kFAAkF;AAClF,8EAA8E;AAC9E,kEAAkE;AAClE,sFAAsF;AACtF,4EAA4E;AAC5E,wEAAwE;AACxE,oEAAoE;AAEpE,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/drivers/hermes-map.d.ts

@@ -0,0 +1,34 @@
+import type { McpServer } from "../acp/types.js";
+import type { CcEvent } from "./types.js";
+/** session/update 的 update 体(判别字段 sessionUpdate,其余随变体)。 */
+export interface SessionUpdate {
+    sessionUpdate: string;
+    [k: string]: unknown;
+}
+/**
+ * ACP `session_update` → CcEvent(或 null=忽略)。映射表(§9.2):
+ *  - agent_message_chunk                       → {type:"text", delta}     (driver 累积成最终文本)
+ *  - agent_thought_chunk                       → {type:"activity", tool:"thinking"}   (思考摘要)
+ *  - tool_call / tool_call_update / tool_start / tool_complete
+ *                                              → {type:"activity", tool, summary}     (工具摘要)
+ *  - plan / plan_update                        → {type:"activity", tool:"plan"}       (计划摘要)
+ *  - usage_update                              → null(忽略;用量并入 result 由 driver 处理)
+ *  - user_message_chunk                        → null(resume 时历史重放,非本轮 agent 产出)
+ *  - 其它/未知                                 → null
+ */
+export declare function mapSessionUpdate(update: SessionUpdate): CcEvent | null;
+/**
+ * daemon 的 `mcpConfig`(claude `--mcp-config` 形状:`{mcpServers:{name:{type,url,headers}|{command,args,env}}}`)
+ * → ACP `session/new` 的 `mcpServers` 数组(F2.6)。
+ *
+ * **knowledge token 透传与 claude 对齐**:daemon 给 claude 和 hermes 两个 driver 的是**同一个** mcpConfig JSON
+ * (见 agent-bridge/src/index.ts cc_turn:知识 MCP = `{type:"http", url, headers:{Authorization:"Bearer <turnToken>"}}`)。
+ * claude 经 `--mcp-config` 注入;hermes 在此转成 ACP `mcpServers`,token 原样落到 ACP http server 的 `headers`
+ * (或 stdio server 的 `env`)。Mosse 不在此处生成/改写 token —— 只搬运 daemon 已组好的形状。
+ *
+ * 形状判别:
+ *  - http / sse transport:有 `type:"http"|"sse"` 或仅有 `url`(claude http 配置必带 url);headers → ACP `{name,value}[]`。
+ *  - stdio transport:有 `command`;`args` 透传、`env`(可携带 token,如 `*_API_KEY`/`MOSSE_KNOWLEDGE_TOKEN`)→ `{name,value}[]`。
+ *  - 既无 url 也无 command 的坏项跳过(不注入坏 server)。
+ */
+export declare function mcpConfigToAcpServers(mcpConfig?: string): McpServer[] | undefined;