@downcity/agent 1.1.1 → 1.1.6

package/bin/host/sdk/RemoteAgent.js

@@ -0,0 +1,153 @@
+/**
+ * RemoteAgent：远程 SDK 客户端。
+ *
+ * 关键点（中文）
+ * - 面向已启动 `agent.http.start()` 的远程/本地 HTTP 服务。
+ * - 与本地 `Agent` 尽量保持同一套 session 使用面。
+ */
+/**
+ * 远程 Session 客户端。
+ */
+class RemoteSession {
+    id;
+    baseUrl;
+    constructor(baseUrl, sessionId) {
+        this.baseUrl = baseUrl;
+        this.id = sessionId;
+    }
+    /**
+     * 远程 session 当前不支持直接注入本地模型实例。
+     */
+    async set(_input) {
+        throw new Error("Remote session.set({ model }) is not supported in v1. Configure the model on the server-side local Agent session instead.");
+    }
+    /**
+     * 执行一轮非流式请求。
+     */
+    async run(input) {
+        const response = await fetch(`${this.baseUrl}/api/sdk/sessions/${encodeURIComponent(this.id)}/run`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(input),
+        });
+        const payload = (await response.json());
+        if (!response.ok || !payload.success || !payload.result) {
+            throw new Error(String(payload.error || "Remote session run failed"));
+        }
+        return payload.result;
+    }
+    /**
+     * 读取远程消息历史。
+     */
+    async history() {
+        const response = await fetch(`${this.baseUrl}/api/sdk/sessions/${encodeURIComponent(this.id)}/messages`);
+        const payload = (await response.json());
+        if (!response.ok || !payload.success || !Array.isArray(payload.messages)) {
+            throw new Error(String(payload.error || "Remote session history failed"));
+        }
+        return payload.messages;
+    }
+    /**
+     * 分叉远程 session。
+     */
+    async fork(messageId) {
+        const response = await fetch(`${this.baseUrl}/api/sdk/sessions/${encodeURIComponent(this.id)}/fork`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                ...(messageId ? { messageId } : {}),
+            }),
+        });
+        const payload = (await response.json());
+        if (!response.ok || !payload.success || !payload.session?.sessionId) {
+            throw new Error(String(payload.error || "Remote session fork failed"));
+        }
+        return new RemoteSession(this.baseUrl, payload.session.sessionId);
+    }
+    /**
+     * 执行一轮流式请求。
+     */
+    async *stream(input) {
+        const response = await fetch(`${this.baseUrl}/api/sdk/sessions/${encodeURIComponent(this.id)}/stream`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(input),
+        });
+        if (!response.ok || !response.body) {
+            const text = await response.text().catch(() => "");
+            throw new Error(text || `Remote session stream failed (${response.status})`);
+        }
+        const decoder = new TextDecoder();
+        const reader = response.body.getReader();
+        let buffered = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffered += decoder.decode(value, { stream: true });
+            let newlineIndex = buffered.indexOf("\n");
+            while (newlineIndex >= 0) {
+                const line = buffered.slice(0, newlineIndex).trim();
+                buffered = buffered.slice(newlineIndex + 1);
+                if (line) {
+                    yield JSON.parse(line);
+                }
+                newlineIndex = buffered.indexOf("\n");
+            }
+        }
+        const tail = buffered.trim();
+        if (tail) {
+            yield JSON.parse(tail);
+        }
+    }
+}
+/**
+ * RemoteAgent：远程 Agent 客户端。
+ */
+export class RemoteAgent {
+    baseUrl;
+    constructor(options) {
+        const baseUrl = String(options.baseUrl || "").trim().replace(/\/+$/, "");
+        if (!baseUrl) {
+            throw new Error("RemoteAgent requires a non-empty baseUrl");
+        }
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * 获取或创建一个远程 session。
+     */
+    async session(sessionId) {
+        const response = await fetch(`${this.baseUrl}/api/sdk/sessions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                ...(sessionId ? { sessionId } : {}),
+            }),
+        });
+        const payload = (await response.json());
+        if (!response.ok || !payload.success || !payload.session?.sessionId) {
+            throw new Error(String(payload.error || "Remote session load failed"));
+        }
+        return new RemoteSession(this.baseUrl, payload.session.sessionId);
+    }
+    /**
+     * 列出远程 agent 的全部 session 元数据。
+     */
+    async sessions() {
+        const response = await fetch(`${this.baseUrl}/api/sdk/sessions`);
+        const payload = (await response.json());
+        if (!response.ok || !payload.success || !Array.isArray(payload.sessions)) {
+            throw new Error(String(payload.error || "Remote sessions list failed"));
+        }
+        return payload.sessions;
+    }
+}
+//# sourceMappingURL=RemoteAgent.js.map

package/bin/host/sdk/RemoteAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteAgent.js","sourceRoot":"","sources":["../../../src/host/sdk/RemoteAgent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;GAEG;AACH,MAAM,aAAa;IACR,EAAE,CAAS;IACH,OAAO,CAAS;IAEjC,YAAY,OAAe,EAAE,SAAiB;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,MAA4B;QACpC,MAAM,IAAI,KAAK,CACb,2HAA2H,CAC5H,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAA2B;QACnC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;YAClG,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIrC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAC3E,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIrC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,SAAkB;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EACtE;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC,CAAC;SACH,CACF,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIrC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,4BAA4B,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,KAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EACxE;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CACF,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,iCAAiC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,YAAY,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBAC5C,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;gBACpD,CAAC;gBACD,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACpD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAW;IACL,OAAO,CAAS;IAEjC,YAAY,OAA2B;QACrC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,SAAkB;QAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC,CAAC;SACH,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIrC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,4BAA4B,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIrC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,6BAA6B,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;CACF"}

package/bin/host/sdk/RpcServer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SDK 本地 RPC Server。
+ *
+ * 关键点（中文）
+ * - 面向同机受信任进程提供最小 session JSON RPC 能力。
+ * - v1 先支持 session 列表、加载、run、history、fork。
+ * - stream 仍建议优先走 HTTP NDJSON。
+ */
+import type { Agent } from "../../host/sdk/Agent.js";
+/**
+ * SDK RPC Server 管理器。
+ */
+export declare class SdkAgentRpcServer {
+    private readonly agent;
+    private server;
+    private endpoint;
+    constructor(agent: Agent);
+    /**
+     * 启动本地 RPC server。
+     */
+    start(): Promise<{
+        endpoint: string;
+    }>;
+    /**
+     * 停止本地 RPC server。
+     */
+    stop(): Promise<void>;
+    private respond;
+    private dispatch;
+}
+//# sourceMappingURL=RpcServer.d.ts.map

package/bin/host/sdk/RpcServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcServer.d.ts","sourceRoot":"","sources":["../../../src/host/sdk/RpcServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAOjD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,KAAK,EAAE,KAAK;IAIxB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAoC5C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAYb,OAAO;YAoBP,QAAQ;CAwHvB"}

package/bin/host/sdk/RpcServer.js

@@ -0,0 +1,193 @@
+/**
+ * SDK 本地 RPC Server。
+ *
+ * 关键点（中文）
+ * - 面向同机受信任进程提供最小 session JSON RPC 能力。
+ * - v1 先支持 session 列表、加载、run、history、fork。
+ * - stream 仍建议优先走 HTTP NDJSON。
+ */
+import fs from "fs-extra";
+import net from "node:net";
+import path from "node:path";
+import { getSdkAgentRpcEndpointPath } from "../../host/sdk/Paths.js";
+/**
+ * SDK RPC Server 管理器。
+ */
+export class SdkAgentRpcServer {
+    agent;
+    server = null;
+    endpoint = null;
+    constructor(agent) {
+        this.agent = agent;
+    }
+    /**
+     * 启动本地 RPC server。
+     */
+    async start() {
+        if (this.server && this.endpoint) {
+            return { endpoint: this.endpoint };
+        }
+        await this.agent.ensureServicesStarted();
+        const endpoint = getSdkAgentRpcEndpointPath(this.agent.path, this.agent.id);
+        await fs.ensureDir(path.dirname(endpoint));
+        await fs.remove(endpoint).catch(() => undefined);
+        const server = net.createServer((socket) => {
+            let buffered = "";
+            socket.setEncoding("utf8");
+            socket.on("data", (chunk) => {
+                buffered += String(chunk || "");
+                const newlineIndex = buffered.indexOf("\n");
+                if (newlineIndex < 0)
+                    return;
+                const raw = buffered.slice(0, newlineIndex).trim();
+                buffered = buffered.slice(newlineIndex + 1);
+                void this.respond(raw, socket);
+            });
+        });
+        await new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(endpoint, () => {
+                server.off("error", reject);
+                resolve();
+            });
+        });
+        this.server = server;
+        this.endpoint = endpoint;
+        return { endpoint };
+    }
+    /**
+     * 停止本地 RPC server。
+     */
+    async stop() {
+        if (!this.server)
+            return;
+        const current = this.server;
+        const endpoint = this.endpoint;
+        this.server = null;
+        this.endpoint = null;
+        await new Promise((resolve) => current.close(() => resolve()));
+        if (endpoint) {
+            await fs.remove(endpoint).catch(() => undefined);
+        }
+    }
+    async respond(raw, socket) {
+        let request = null;
+        try {
+            request = JSON.parse(raw);
+        }
+        catch {
+            socket.write(`${JSON.stringify({
+                requestId: "unknown",
+                status: 400,
+                success: false,
+                error: "Invalid RPC JSON payload",
+            })}\n`);
+            return;
+        }
+        const response = await this.dispatch(request);
+        socket.write(`${JSON.stringify(response)}\n`);
+    }
+    async dispatch(request) {
+        const requestId = String(request.requestId || "").trim() || "unknown";
+        try {
+            if (request.method === "GET" && request.path === "/api/sdk/sessions") {
+                return {
+                    requestId,
+                    status: 200,
+                    success: true,
+                    data: {
+                        success: true,
+                        sessions: await this.agent.sessions(),
+                    },
+                };
+            }
+            if (request.method === "POST" && request.path === "/api/sdk/sessions") {
+                const body = request.body && typeof request.body === "object" && !Array.isArray(request.body)
+                    ? request.body
+                    : {};
+                const session = await this.agent.session(typeof body.sessionId === "string" ? body.sessionId : undefined);
+                return {
+                    requestId,
+                    status: 200,
+                    success: true,
+                    data: {
+                        success: true,
+                        session: await session.toMetadata(),
+                    },
+                };
+            }
+            const runMatch = /^\/api\/sdk\/sessions\/([^/]+)\/run$/.exec(request.path);
+            if (request.method === "POST" && runMatch) {
+                const session = await this.agent.session(decodeURIComponent(runMatch[1] || ""));
+                const body = request.body && typeof request.body === "object" && !Array.isArray(request.body)
+                    ? request.body
+                    : {};
+                const query = String(body.query || "").trim();
+                if (!query) {
+                    return {
+                        requestId,
+                        status: 400,
+                        success: false,
+                        error: "query is required",
+                    };
+                }
+                return {
+                    requestId,
+                    status: 200,
+                    success: true,
+                    data: {
+                        success: true,
+                        sessionId: session.id,
+                        result: await session.run({ query }),
+                    },
+                };
+            }
+            const forkMatch = /^\/api\/sdk\/sessions\/([^/]+)\/fork$/.exec(request.path);
+            if (request.method === "POST" && forkMatch) {
+                const session = await this.agent.session(decodeURIComponent(forkMatch[1] || ""));
+                const body = request.body && typeof request.body === "object" && !Array.isArray(request.body)
+                    ? request.body
+                    : {};
+                const forked = await session.fork(typeof body.messageId === "string" ? body.messageId : undefined);
+                return {
+                    requestId,
+                    status: 200,
+                    success: true,
+                    data: {
+                        success: true,
+                        session: await forked.toMetadata(),
+                    },
+                };
+            }
+            const messagesMatch = /^\/api\/sdk\/sessions\/([^/]+)\/messages$/.exec(request.path);
+            if (request.method === "GET" && messagesMatch) {
+                const session = await this.agent.session(decodeURIComponent(messagesMatch[1] || ""));
+                return {
+                    requestId,
+                    status: 200,
+                    success: true,
+                    data: {
+                        success: true,
+                        sessionId: session.id,
+                        messages: await session.history(),
+                    },
+                };
+            }
+            return {
+                requestId,
+                status: 404,
+                success: false,
+                error: `Unknown RPC path: ${request.method} ${request.path}`,
+            };
+        }
+        catch (error) {
+            return {
+                requestId,
+                status: 500,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+//# sourceMappingURL=RpcServer.js.map

package/bin/host/sdk/RpcServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcServer.js","sourceRoot":"","sources":["../../../src/host/sdk/RpcServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,GAAoB,MAAM,UAAU,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACX,KAAK,CAAQ;IACtB,MAAM,GAAkB,IAAI,CAAC;IAC7B,QAAQ,GAAkB,IAAI,CAAC;IAEvC,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrC,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAEzC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;YACzC,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,QAAQ,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBAChC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,YAAY,GAAG,CAAC;oBAAE,OAAO;gBAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;gBACnD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBAC5C,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAC3B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC5B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACrE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAkB;QACnD,IAAI,OAAO,GAA2B,IAAI,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CACV,GAAG,IAAI,CAAC,SAAS,CAAC;gBAChB,SAAS,EAAE,SAAS;gBACpB,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA0B;aACP,CAAC,IAAI,CAClC,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,OAAwB;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QACtE,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBACrE,OAAO;oBACL,SAAS;oBACT,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,OAAO,EAAE,IAAI;wBACb,QAAQ,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;qBACC;iBACzC,CAAC;YACJ,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBACtE,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;oBAC9E,CAAC,CAAC,OAAO,CAAC,IAAI;oBACd,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAChE,CAAC;gBACF,OAAO;oBACL,SAAS;oBACT,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE;qBACG;iBACzC,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3E,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACtC,CAAC;gBACF,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;oBAC9E,CAAC,CAAC,OAAO,CAAC,IAAI;oBACd,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO;wBACL,SAAS;wBACT,MAAM,EAAE,GAAG;wBACX,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,mBAAmB;qBAC3B,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,SAAS;oBACT,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,OAAO,CAAC,EAAE;wBACrB,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;qBACE;iBACzC,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,uCAAuC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,SAAS,EAAE,CAAC;gBAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACvC,CAAC;gBACF,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;oBAC9E,CAAC,CAAC,OAAO,CAAC,IAAI;oBACd,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAChE,CAAC;gBACF,OAAO;oBACL,SAAS;oBACT,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE;qBACI;iBACzC,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GACjB,2CAA2C,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjE,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,aAAa,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAC3C,CAAC;gBACF,OAAO;oBACL,SAAS;oBACT,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,OAAO,CAAC,EAAE;wBACrB,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE;qBACK;iBACzC,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,qBAAqB,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/bin/host/sdk/SdkSessionSystemComposer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SDK Session 默认 system composer。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - v1 先只注入静态 PROFILE / SOUL / core prompt 与运行时时钟上下文。
+ * - 暂不把 service/plugin system 注入暴露到 SDK 主路径。
+ */
+import { SessionSystemComposer } from "../../session/composer/system/SessionSystemComposer.js";
+type SdkSessionSystemComposerOptions = {
+    /**
+     * 当前 agent 绑定的项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 读取当前生效的静态 system 文本集合。
+     */
+    getStaticSystemPrompts: () => string[];
+};
+/**
+ * SDK Session system composer 实现。
+ */
+export declare class SdkSessionSystemComposer extends SessionSystemComposer {
+    readonly name = "sdk_prompt_system";
+    private readonly projectRoot;
+    private readonly getStaticSystemPrompts;
+    constructor(options: SdkSessionSystemComposerOptions);
+    /**
+     * 解析本轮 SDK session system messages。
+     */
+    resolve(): Promise<import("ai").SystemModelMessage[]>;
+}
+export {};
+//# sourceMappingURL=SdkSessionSystemComposer.d.ts.map

package/bin/host/sdk/SdkSessionSystemComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkSessionSystemComposer.d.ts","sourceRoot":"","sources":["../../../src/host/sdk/SdkSessionSystemComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAK1F,KAAK,+BAA+B,GAAG;IACrC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,sBAAsB,EAAE,MAAM,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,qBAAqB;IACjE,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA4D;gBAEvF,OAAO,EAAE,+BAA+B;IASpD;;OAEG;IACG,OAAO;CA4Bd"}

package/bin/host/sdk/SdkSessionSystemComposer.js

@@ -0,0 +1,54 @@
+/**
+ * SDK Session 默认 system composer。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - v1 先只注入静态 PROFILE / SOUL / core prompt 与运行时时钟上下文。
+ * - 暂不把 service/plugin system 注入暴露到 SDK 主路径。
+ */
+import { SessionSystemComposer } from "../../session/composer/system/SessionSystemComposer.js";
+import { getSessionRunScope } from "../../session/SessionRunScope.js";
+import { transformPromptsIntoSystemMessages } from "../../session/composer/system/default/PromptRenderer.js";
+import { buildRuntimeClockSystemPrompt } from "../../session/composer/system/default/variables/VariableReplacer.js";
+/**
+ * SDK Session system composer 实现。
+ */
+export class SdkSessionSystemComposer extends SessionSystemComposer {
+    name = "sdk_prompt_system";
+    projectRoot;
+    getStaticSystemPrompts;
+    constructor(options) {
+        super();
+        this.projectRoot = String(options.projectRoot || "").trim();
+        this.getStaticSystemPrompts = options.getStaticSystemPrompts;
+        if (!this.projectRoot) {
+            throw new Error("SdkSessionSystemComposer requires a non-empty projectRoot");
+        }
+    }
+    /**
+     * 解析本轮 SDK session system messages。
+     */
+    async resolve() {
+        const sessionId = String(getSessionRunScope()?.sessionId || "").trim();
+        if (!sessionId) {
+            throw new Error("SdkSessionSystemComposer.resolve requires a non-empty sessionId");
+        }
+        const staticPrompts = this.getStaticSystemPrompts().filter((item) => String(item || "").trim());
+        const staticMessages = await transformPromptsIntoSystemMessages(staticPrompts, {
+            projectPath: this.projectRoot,
+            sessionId,
+            variableMode: "stable",
+        });
+        return [
+            ...staticMessages,
+            {
+                role: "system",
+                content: buildRuntimeClockSystemPrompt({
+                    projectPath: this.projectRoot,
+                    sessionId,
+                }),
+            },
+        ];
+    }
+}
+//# sourceMappingURL=SdkSessionSystemComposer.js.map

package/bin/host/sdk/SdkSessionSystemComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkSessionSystemComposer.js","sourceRoot":"","sources":["../../../src/host/sdk/SdkSessionSystemComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,kCAAkC,EAAE,MAAM,oDAAoD,CAAC;AACxG,OAAO,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC;AAc/G;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,qBAAqB;IACxD,IAAI,GAAG,mBAAmB,CAAC;IAEnB,WAAW,CAAS;IACpB,sBAAsB,CAA4D;IAEnG,YAAY,OAAwC;QAClD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,EAAE,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAClE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAC1B,CAAC;QACF,MAAM,cAAc,GAAG,MAAM,kCAAkC,CAC7D,aAAa,EACb;YACE,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS;YACT,YAAY,EAAE,QAAQ;SACvB,CACF,CAAC;QAEF,OAAO;YACL,GAAG,cAAc;YACjB;gBACE,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,6BAA6B,CAAC;oBACrC,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,SAAS;iBACV,CAAC;aACH;SACF,CAAC;IACJ,CAAC;CACF"}

package/bin/host/sdk/Session.d.ts

@@ -0,0 +1,130 @@
+/**
+ * SDK 本地 Session 封装。
+ *
+ * 关键点（中文）
+ * - 面向 `new Agent(...)` 的本地会话使用场景。
+ * - 统一收口消息落盘、默认模型配置、run/stream/fork 等高层 API。
+ * - 内部继续复用现有 `Session` / `JsonlSessionHistoryComposer` / `LocalSessionExecutor`。
+ */
+import type { Tool } from "ai";
+import type { AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionMetadata, AgentSessionRunInput, AgentSessionRunResult, AgentSessionSetInput, AgentSessionStreamEvent } from "../../host/sdk/AgentSdkTypes.js";
+import type { SessionMessageV1 } from "../../types/session/SessionMessages.js";
+import type { SessionPort } from "../../agent/AgentContextTypes.js";
+type SdkSessionOptions = {
+    /**
+     * 当前 agent 稳定标识。
+     */
+    agentId: string;
+    /**
+     * 当前项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 当前 sessionId。
+     */
+    sessionId: string;
+    /**
+     * 当前 agent 默认工具集合。
+     */
+    tools: Record<string, Tool>;
+    /**
+     * 统一日志器。
+     */
+    logger: {
+        info(message: string, details?: Record<string, unknown>): void;
+        warn(message: string, details?: Record<string, unknown>): void;
+    };
+    /**
+     * 读取静态 system 文本集合。
+     */
+    getStaticSystemPrompts: () => string[];
+};
+/**
+ * SDK 本地 Session。
+ */
+export declare class SdkSession {
+    readonly id: string;
+    readonly agentId: string;
+    private readonly projectRoot;
+    private readonly tools;
+    private readonly logger;
+    private readonly getStaticSystemPrompts;
+    private readonly historyComposer;
+    private readonly coreSession;
+    private sessionConfig;
+    private initializePromise;
+    private servicePort;
+    constructor(options: SdkSessionOptions);
+    /**
+     * 初始化当前 session 的 meta 信息与内存配置。
+     */
+    initialize(): Promise<this>;
+    /**
+     * 读取当前 session 配置快照。
+     */
+    get config(): AgentSessionConfigSnapshot;
+    /**
+     * 写入当前 session 默认配置。
+     */
+    set(input: AgentSessionSetInput): Promise<void>;
+    /**
+     * 追加一条 user 文本消息。
+     */
+    appendUserMessage(input: {
+        /**
+         * 需要写入的用户文本。
+         */
+        text: string;
+    }): Promise<void>;
+    /**
+     * 追加一条 assistant 文本消息。
+     */
+    appendAssistantMessage(input: {
+        /**
+         * 需要写入的 assistant 文本。
+         */
+        text: string;
+    }): Promise<void>;
+    /**
+     * 读取完整消息历史。
+     */
+    history(): Promise<SessionMessageV1[]>;
+    /**
+     * 返回当前 session 是否正在执行。
+     */
+    isExecuting(): boolean;
+    /**
+     * 清理当前 session 的执行器缓存。
+     */
+    clearExecutor(): void;
+    /**
+     * 执行一轮非流式请求。
+     */
+    run(input: AgentSessionRunInput): Promise<AgentSessionRunResult>;
+    /**
+     * 执行一轮流式请求。
+     */
+    stream(input: AgentSessionRunInput): AsyncIterable<AgentSessionStreamEvent>;
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput["messageId"]): Promise<SdkSession>;
+    /**
+     * 生成当前 session 的元数据快照。
+     */
+    toMetadata(): Promise<AgentSessionMetadata>;
+    /**
+     * 返回供 chat service 使用的 session 端口。
+     *
+     * 关键点（中文）
+     * - 这里不走 SDK `run()` 包装层，而是直接暴露底层 `CoreSession` 协议。
+     * - 这样 chat queue worker 可以复用既有 `SessionPort` 契约，不会重复补写消息。
+     */
+    getServicePort(): SessionPort;
+    private touchMetadata;
+    private persistAssistantResult;
+    private pushChunkEvent;
+    private toJsonValue;
+}
+export {};
+//# sourceMappingURL=Session.d.ts.map

package/bin/host/sdk/Session.d.ts.map

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