@coralai/sps-cli 0.63.6 → 0.65.0

package/dist/runtime/agentd/protocol.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @module agentd/protocol
+ * P2:agentd 线协议。Unix domain socket(D4:socket 先行,HTTP 延后),
+ * 帧 = 一行 JSON(`\n` 分隔,NDJSON)。控制通道绑 socket 而非父进程 stdio,
+ * 故消费者(tick/console)重启后可重连仍存活的会话(P2 北极星)。
+ *
+ * 请求/响应按 `id` 配对;事件帧无 `id`、带 `sub`(订阅号)异步推送。
+ */
+import type { SessionConfig } from '../contract/AgentBackend.js';
+import type { SessionRecord } from '../contract/service.js';
+import type { StopReason } from '../contract/lifecycle.js';
+import type { WorkerOutputEvent } from '../contract/events.js';
+import type { JsonValue } from '../contract/processProtocol.js';
+export declare const DEFAULT_SOCKET_PATH = "/tmp/coral-agentd.sock";
+/** 客户端 → 服务:请求帧。 */
+export type Req = {
+    id: number;
+    op: 'ensureSession';
+    slot: string;
+    config: SessionConfig;
+} | {
+    id: number;
+    op: 'startRun';
+    slot: string;
+    prompt: string;
+} | {
+    id: number;
+    op: 'submitInteraction';
+    slot: string;
+    interactionId: string;
+    answer: JsonValue;
+} | {
+    id: number;
+    op: 'subscribe';
+    slot: string;
+    sub: number;
+} | {
+    id: number;
+    op: 'unsubscribe';
+    sub: number;
+} | {
+    id: number;
+    op: 'cancelRun';
+    slot: string;
+} | {
+    id: number;
+    op: 'stopSession';
+    slot: string;
+    reason?: StopReason;
+} | {
+    id: number;
+    op: 'inspect';
+    slot?: string;
+};
+/** 服务 → 客户端:响应帧(`ok`)/ 错误帧 / 事件帧。 */
+export type Res = {
+    id: number;
+    ok: true;
+    result: SessionRecord | SessionRecord[] | null;
+} | {
+    id: number;
+    ok: false;
+    error: string;
+} | {
+    event: WorkerOutputEvent;
+    sub: number;
+};
+export declare function encode(frame: Req | Res): string;
+/** 把 socket 上的字节流切成整行 JSON 帧(处理半包/粘包)。 */
+export declare class FrameDecoder {
+    private buf;
+    push(chunk: string): Array<Req | Res>;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/runtime/agentd/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/runtime/agentd/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D,oBAAoB;AACpB,MAAM,MAAM,GAAG,GACX;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D;IACE,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,mBAAmB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC;CACnB,GACD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GACpE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,qCAAqC;AACrC,MAAM,MAAM,GAAG,GACX;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,IAAI,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,CAE/C;AAED,0CAA0C;AAC1C,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAM;IACjB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;CAWtC"}

package/dist/runtime/agentd/protocol.js

@@ -0,0 +1,21 @@
+export const DEFAULT_SOCKET_PATH = '/tmp/coral-agentd.sock';
+export function encode(frame) {
+    return JSON.stringify(frame) + '\n';
+}
+/** 把 socket 上的字节流切成整行 JSON 帧(处理半包/粘包)。 */
+export class FrameDecoder {
+    buf = '';
+    push(chunk) {
+        this.buf += chunk;
+        const out = [];
+        let nl;
+        while ((nl = this.buf.indexOf('\n')) >= 0) {
+            const line = this.buf.slice(0, nl);
+            this.buf = this.buf.slice(nl + 1);
+            if (line.trim())
+                out.push(JSON.parse(line));
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/runtime/agentd/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/runtime/agentd/protocol.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAyB5D,MAAM,UAAU,MAAM,CAAC,KAAgB;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC;AAED,0CAA0C;AAC1C,MAAM,OAAO,YAAY;IACf,GAAG,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;QAClB,MAAM,GAAG,GAAqB,EAAE,CAAC;QACjC,IAAI,EAAU,CAAC;QACf,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/runtime/agentd/server.d.ts

@@ -0,0 +1,15 @@
+import type { AgentService } from '../contract/service.js';
+export interface AgentdServerOpts {
+    service: AgentService;
+    socketPath: string;
+}
+export declare class AgentdServer {
+    private readonly opts;
+    private server?;
+    constructor(opts: AgentdServerOpts);
+    listen(): Promise<void>;
+    private onConn;
+    private handle;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/runtime/agentd/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/runtime/agentd/server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IAEX,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,OAAO,CAAC,MAAM,CAAC,CAAS;gBACK,IAAI,EAAE,gBAAgB;IAE7C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B,OAAO,CAAC,MAAM;YA0BA,MAAM;IAwDd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/runtime/agentd/server.js

@@ -0,0 +1,116 @@
+/**
+ * @module agentd/server
+ * P2:agentd socket 外壳。把 {@link AgentRuntime} 内核暴露到 Unix domain socket。
+ * 多客户端可同时连;某客户端断开只清它的订阅,**会话仍在内核里存活** → 消费者重启可重连。
+ */
+import { createServer } from 'node:net';
+import { existsSync, unlinkSync } from 'node:fs';
+import { encode, FrameDecoder } from './protocol.js';
+export class AgentdServer {
+    opts;
+    server;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async listen() {
+        const { socketPath } = this.opts;
+        if (existsSync(socketPath))
+            unlinkSync(socketPath); // 清残留 socket(上次未优雅退出)
+        this.server = createServer((sock) => this.onConn(sock));
+        await new Promise((resolve, reject) => {
+            this.server.once('error', reject);
+            this.server.listen(socketPath, () => {
+                this.server.off('error', reject);
+                resolve();
+            });
+        });
+    }
+    onConn(sock) {
+        sock.setEncoding('utf8');
+        const decoder = new FrameDecoder();
+        // 本连接的订阅:sub 号 → cancel 函数。连接断开时全部退订(但不停会话)。
+        const subs = new Map();
+        const send = (frame) => {
+            if (!sock.writableEnded)
+                sock.write(encode(frame));
+        };
+        sock.on('data', (chunk) => {
+            let frames;
+            try {
+                frames = decoder.push(chunk);
+            }
+            catch (e) {
+                send({ id: -1, ok: false, error: `bad frame: ${String(e)}` });
+                return;
+            }
+            for (const f of frames)
+                void this.handle(f, send, subs);
+        });
+        sock.on('error', () => { });
+        sock.on('close', () => {
+            for (const cancel of subs.values())
+                cancel();
+            subs.clear();
+        });
+    }
+    async handle(req, send, subs) {
+        const svc = this.opts.service;
+        try {
+            switch (req.op) {
+                case 'ensureSession':
+                    send({ id: req.id, ok: true, result: await svc.ensureSession(req.slot, req.config) });
+                    break;
+                case 'startRun':
+                    send({ id: req.id, ok: true, result: await svc.startRun(req.slot, req.prompt) });
+                    break;
+                case 'submitInteraction':
+                    if (!svc.submitInteraction) {
+                        throw new Error('Runtime does not support interactions');
+                    }
+                    send({
+                        id: req.id,
+                        ok: true,
+                        result: await svc.submitInteraction(req.slot, req.interactionId, req.answer),
+                    });
+                    break;
+                case 'cancelRun':
+                    await svc.cancelRun(req.slot);
+                    send({ id: req.id, ok: true, result: null });
+                    break;
+                case 'stopSession':
+                    await svc.stopSession(req.slot, req.reason);
+                    send({ id: req.id, ok: true, result: null });
+                    break;
+                case 'inspect':
+                    send({ id: req.id, ok: true, result: await svc.inspect(req.slot) });
+                    break;
+                case 'subscribe': {
+                    const stream = svc.subscribe(req.slot);
+                    subs.set(req.sub, () => stream.cancel());
+                    send({ id: req.id, ok: true, result: null }); // ack
+                    void (async () => {
+                        for await (const event of stream)
+                            send({ event, sub: req.sub });
+                    })();
+                    break;
+                }
+                case 'unsubscribe': {
+                    subs.get(req.sub)?.();
+                    subs.delete(req.sub);
+                    send({ id: req.id, ok: true, result: null });
+                    break;
+                }
+            }
+        }
+        catch (e) {
+            send({ id: req.id, ok: false, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    async close() {
+        const socketPath = this.opts.socketPath;
+        await new Promise((resolve) => this.server?.close(() => resolve()));
+        if (existsSync(socketPath))
+            unlinkSync(socketPath);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/runtime/agentd/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/runtime/agentd/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAA4B,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAsB,MAAM,eAAe,CAAC;AAOzE,MAAM,OAAO,YAAY;IAEM;IADrB,MAAM,CAAU;IACxB,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,MAAM;QACV,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACjC,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB;QAC1E,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,MAAO,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE;gBACnC,IAAI,CAAC,MAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAClC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,IAAY;QACzB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;QACnC,6CAA6C;QAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,KAAU,EAAQ,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,aAAa;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAChC,IAAI,MAAwB,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,MAAM;gBAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE;gBAAE,MAAM,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,GAAQ,EAAE,IAAsB,EAAE,IAA6B;QAClF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC;YACH,QAAQ,GAAG,CAAC,EAAE,EAAE,CAAC;gBACf,KAAK,eAAe;oBAClB,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACtF,MAAM;gBACR,KAAK,UAAU;oBACb,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACjF,MAAM;gBACR,KAAK,mBAAmB;oBACtB,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;wBAC3B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;oBAC3D,CAAC;oBACD,IAAI,CAAC;wBACH,EAAE,EAAE,GAAG,CAAC,EAAE;wBACV,EAAE,EAAE,IAAI;wBACR,MAAM,EAAE,MAAM,GAAG,CAAC,iBAAiB,CACjC,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,aAAa,EACjB,GAAG,CAAC,MAAM,CACX;qBACF,CAAC,CAAC;oBACH,MAAM;gBACR,KAAK,WAAW;oBACd,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAC9B,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC7C,MAAM;gBACR,KAAK,aAAa;oBAChB,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC5C,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC7C,MAAM;gBACR,KAAK,SAAS;oBACZ,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACpE,MAAM;gBACR,KAAK,WAAW,CAAC,CAAC,CAAC;oBACjB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;oBACzC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM;oBACpD,KAAK,CAAC,KAAK,IAAI,EAAE;wBACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM;4BAAE,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;oBAClE,CAAC,CAAC,EAAE,CAAC;oBACL,MAAM;gBACR,CAAC;gBACD,KAAK,aAAa,CAAC,CAAC,CAAC;oBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACrB,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC7C,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;QACxC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1E,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/runtime/backends/claude/ClaudeBackend.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @module backends/claude/ClaudeBackend
+ * P1 第一卡:`AgentBackend` 的 claude 适配器。进程内直调 `@anthropic-ai/claude-agent-sdk`
+ * 的 `query()`(逻辑平移自 sps-cli `ClaudeSdkBackend`,2026-06-29 验通的真件),
+ * 在其上补齐 agent-runtime 厚契约的字段(全量事件 / resume / 权限 / mcp / env / tuning)。
+ *
+ * 结构决策(已拍):SDK **不静态 import** —— `query`/`getSessionInfo` 由 {@link ClaudeSdkModule}
+ * **构造注入**(按结构类型收)。P1 测试塞 devDep 那份;P3 换 `VersionManager.load()` 那份,零改本文件。
+ *
+ * R1(类型化 resume 失败,实地敲定):实装 SDK 0.3.196 已**砍掉** 0.2.132 的 `unstable_v2_*` 会话 API,
+ * 只剩 `getSessionInfo(id) → info | undefined`(查无即 undefined)。故:
+ *   - resume 路:`getSessionInfo` 命中 → `resumed:true`;`undefined` → `resumeFailed:'not_found'` 起新会话。
+ *   - 运行期会话被回收 → `error` 事件(recoverable)+ 失败 result,对应 'session_lost'。
+ *   - fresh 路:claude 无 id 直到首轮 → `ensure` 返回 `resumed:false`,真 id 经 `session` 事件在首轮交付。
+ */
+import type { AgentBackend, SessionConfig } from '../../contract/AgentBackend.js';
+import type { WorkerOutputListener } from '../../contract/events.js';
+import type { RunState, StopReason } from '../../contract/lifecycle.js';
+/**
+ * 注入式 SDK 边界 —— 不锁 SDK 具体版本(P3 版本管理之锚)。
+ * Query 的**全部运行时控制方法**都列在此(对照官方 `Query` 接口);老版本缺的标 optional,调用即 no-op。
+ */
+export interface ClaudeQuery extends AsyncIterable<unknown> {
+    interrupt(): Promise<void>;
+    setModel?: (model?: string) => Promise<void>;
+    setMaxThinkingTokens?: (n: number | null, thinkingDisplay?: 'summarized' | 'omitted' | null) => Promise<void>;
+    setPermissionMode?: (mode: string) => Promise<void>;
+    applyFlagSettings?: (settings: unknown) => Promise<unknown>;
+    initializationResult?: () => Promise<unknown>;
+    supportedCommands?: () => Promise<unknown[]>;
+    supportedModels?: () => Promise<unknown[]>;
+    supportedAgents?: () => Promise<unknown[]>;
+    mcpServerStatus?: () => Promise<unknown>;
+    accountInfo?: () => Promise<unknown>;
+    reconnectMcpServer?: (serverName: string) => Promise<unknown>;
+    toggleMcpServer?: (serverName: string, enabled: boolean) => Promise<unknown>;
+    setMcpServers?: (servers: unknown) => Promise<unknown>;
+    rewindFiles?: (userMessageId: string, options?: unknown) => Promise<unknown>;
+    stopTask?: (taskId: string) => Promise<unknown>;
+    streamInput?: (stream: unknown) => Promise<unknown>;
+    close?: () => void;
+    setMcpPermissionModeOverride?: (serverName: string, mode: 'default' | 'auto' | null) => Promise<unknown>;
+    reinitialize?: () => Promise<unknown>;
+}
+/**
+ * 完整 SDK 模块面(对照 claude-agent-sdk 顶层导出)。`query` 必有;其余按 SDK 版本 optional。
+ * 经 `VersionManager.load()` 拿到的整模块即可直接当它用(结构匹配)。
+ */
+export interface ClaudeSdkModule {
+    query(args: {
+        prompt: string | AsyncIterable<unknown>;
+        options?: Record<string, unknown>;
+    }): ClaudeQuery;
+    getSessionInfo?: (sessionId: string, options?: unknown) => Promise<unknown | undefined>;
+    getSessionMessages?: (sessionId: string, options?: unknown) => Promise<unknown[]>;
+    listSessions?: (options?: unknown) => Promise<unknown[]>;
+    forkSession?: (sessionId: string, options?: unknown) => Promise<unknown>;
+    deleteSession?: (sessionId: string, options?: unknown) => Promise<unknown>;
+    renameSession?: (sessionId: string, title: string, options?: unknown) => Promise<unknown>;
+    tagSession?: (...args: unknown[]) => Promise<unknown>;
+    foldSessionSummary?: (...args: unknown[]) => Promise<unknown>;
+    importSessionToStore?: (...args: unknown[]) => Promise<unknown>;
+    listSubagents?: (options?: unknown) => Promise<unknown[]>;
+    getSubagentMessages?: (...args: unknown[]) => Promise<unknown[]>;
+    resolveSettings?: (opts?: unknown) => Promise<unknown>;
+    createSdkMcpServer?: (cfg: {
+        name: string;
+        version?: string;
+        tools: unknown[];
+    }) => unknown;
+    tool?: (...args: unknown[]) => unknown;
+    /** 其余顶层导出(InMemorySessionStore 等)经原模块直达,见 ClaudeBackend.raw()。 */
+    [extra: string]: unknown;
+}
+export declare class ClaudeBackend implements AgentBackend {
+    private readonly cfg;
+    private readonly sdk;
+    readonly kind = "claude";
+    private sessionId?;
+    private current?;
+    private abort?;
+    private state;
+    private cancelled;
+    /** 最近一次 system.init(含 model/tools/mcp_servers/slash_commands/...);供无在飞 Query 时回退查询。 */
+    private lastInit?;
+    /** 保活模式:开着的输入流 + 是否已启动持续输出循环。 */
+    private input?;
+    private loopStarted;
+    private readonly listeners;
+    constructor(cfg: SessionConfig, sdk: ClaudeSdkModule);
+    subscribe(listener: WorkerOutputListener): () => void;
+    private emit;
+    ensure(): Promise<{
+        sessionId: string;
+        resumed: boolean;
+        resumeFailed?: 'session_lost' | 'not_found';
+    }>;
+    dispatch(prompt: string): Promise<void>;
+    /** 保活模式:首轮建一个流式 query(常驻子进程),后续 dispatch 把消息喂进同一个流。 */
+    private dispatchPersistent;
+    /** SDKMessage → 状态 + WorkerOutputEvent(全量映射)。 */
+    private translate;
+    private mapModelUsage;
+    /** SessionConfig → claude query options(全字段落地)。 */
+    private buildOptions;
+    /** 运行时切模型(下一个/当前轮生效,取决于 SDK)。 */
+    setModel(model?: string): Promise<void>;
+    /** 运行时改思考预算。 */
+    setMaxThinkingTokens(n: number | null): Promise<void>;
+    /** 运行时改权限模式(中立值映射到 SDK)。 */
+    setPermissionMode(mode: NonNullable<SessionConfig['permission']>['mode']): Promise<void>;
+    /** 单 MCP server 的权限模式覆盖。 */
+    setMcpPermissionModeOverride(serverName: string, mode: 'default' | 'auto' | null): Promise<unknown>;
+    /** 运行时套用 flag settings。 */
+    applyFlagSettings(settings: unknown): Promise<unknown>;
+    /** 初始化结果(模型/工具/MCP 状态等);无在飞 Query 时回退到最近一次 system.init。 */
+    initializationResult(): Promise<unknown>;
+    /** 重新初始化(重载配置)。 */
+    reinitialize(): Promise<unknown>;
+    /** 当前支持的斜杠命令;无在飞 Query 时回退到 init 里的 slash_commands。 */
+    supportedCommands(): Promise<unknown[]>;
+    /** 当前可用模型。 */
+    supportedModels(): Promise<unknown[]>;
+    /** 当前可用子代理(回退到 init 的 agents)。 */
+    supportedAgents(): Promise<unknown[]>;
+    /** MCP server 连接状态(回退到 init 的 mcp_servers)。 */
+    mcpServerStatus(): Promise<unknown>;
+    /** 账户信息。 */
+    accountInfo(): Promise<unknown>;
+    /** 重连指定 MCP server。 */
+    reconnectMcpServer(serverName: string): Promise<unknown>;
+    /** 启/停指定 MCP server。 */
+    toggleMcpServer(serverName: string, enabled: boolean): Promise<unknown>;
+    /** 运行时整体替换 MCP servers。 */
+    setMcpServers(servers: unknown): Promise<unknown>;
+    /** 回退文件到某条用户消息时的状态(checkpointing)。 */
+    rewindFiles(userMessageId: string, options?: unknown): Promise<unknown>;
+    /** 停止某个后台任务。 */
+    stopTask(taskId: string): Promise<unknown>;
+    /** 流式多轮输入(streaming input mode)。 */
+    streamInput(stream: unknown): Promise<unknown>;
+    /** 关闭并终止底层进程(等同更彻底的 stop)。 */
+    closeQuery(): void;
+    /** 当前在飞的 Query 句柄(无则 undefined)—— 触达任何未显式封装的方法。 */
+    query(): ClaudeQuery | undefined;
+    /** 注入的完整 SDK 模块 —— 触达会话管理(listSessions/forkSession/…)/ createSdkMcpServer / tool / 任何顶层导出。 */
+    raw(): ClaudeSdkModule;
+    private mapMcp;
+    runState(): Promise<RunState>;
+    /** 中断本轮、保活会话(可续)。 */
+    cancel(): Promise<void>;
+    /** 收尾:关输入流(保活模式→结束流→子进程退出)+ abort + 复位。 */
+    stop(_reason?: StopReason): Promise<void>;
+}
+//# sourceMappingURL=ClaudeBackend.d.ts.map

package/dist/runtime/backends/claude/ClaudeBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeBackend.d.ts","sourceRoot":"","sources":["../../../../src/runtime/backends/claude/ClaudeBackend.ts"],"names":[],"mappings":"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"}