@downcity/agent 1.1.12 → 1.1.14

package/bin/sdk/AgentSdkTypes.d.ts

@@ -12,6 +12,9 @@ import type { JsonValue } from "../types/common/Json.js";
 import type { Plugin } from "../plugin/types/Plugin.js";
 import type { SessionMessageV1 } from "../session/types/SessionMessages.js";
 import type { AgentPlatformRuntime } from "../types/host/AgentHost.js";
+import type { LocalRpcServerHandle } from "../types/rpc/LocalRpc.js";
+import type { ServerInstance } from "../server/http/Server.js";
+import type { Session } from "../sdk/Session.js";
 /**
  * 本地 Agent 构造参数。
  */
@@ -54,6 +57,14 @@ export interface AgentOptions {
      * - v1 推荐显式传入 `new ChatService(...)` 这类实例，而不是依赖包内隐式注册表。
      */
     services?: BaseService[];
+    /**
+     * 是否自动装配全部内建 service。
+     *
+     * 关键点（中文）
+     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
+     * - 未开启时，默认只使用显式传入的 `services`。
+     */
+    useBuiltinServices?: boolean;
     /**
      * 当前 agent 显式注册的 plugin 定义集合。
      *
@@ -63,6 +74,14 @@ export interface AgentOptions {
      * - 同名 plugin 会直接报错，避免 action / hook / resolve 行为被静默覆盖。
      */
     plugins?: Plugin[];
+    /**
+     * 是否自动装配全部内建 plugin。
+     *
+     * 关键点（中文）
+     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
+     * - 未开启时，默认只使用显式传入的 `plugins`。
+     */
+    useBuiltinPlugins?: boolean;
     /**
      * 当前 agent 显式注入的平台能力集合。
      *
@@ -71,6 +90,125 @@ export interface AgentOptions {
      * - 推荐由宿主产品显式传入，避免 SDK 本地实例隐式依赖 city。
      */
     platform?: AgentPlatformRuntime;
+    /**
+     * 在 session 初始化后执行的宿主配置钩子。
+     *
+     * 关键点（中文）
+     * - SDK 不负责默认模型策略，宿主可在这里统一为 session 注入 model 等运行配置。
+     * - 该钩子只在 session 首次创建时触发一次，适合做实例级默认装配。
+     */
+    configureSession?: (session: Session) => Promise<void> | void;
+}
+/**
+ * Agent 启动参数。
+ */
+export interface AgentStartOptions {
+    /**
+     * 是否启动 HTTP 服务。
+     *
+     * 关键点（中文）
+     * - `false` 表示不启动。
+     * - 传对象时会按给定 host/port 启动。
+     * - 省略时默认不启动，避免 SDK 本地嵌入场景误开端口。
+     */
+    http?: false | AgentHttpStartOptions;
+    /**
+     * 是否启动本地 RPC 服务。
+     *
+     * 关键点（中文）
+     * - `true` 时启动主 local RPC server。
+     * - 省略或 `false` 时不启动。
+     */
+    rpc?: boolean;
+    /**
+     * 是否启动当前 agent 的 services。
+     *
+     * 关键点（中文）
+     * - 默认 `true`。
+     * - `false` 适合只需要 session 能力、不希望启动后台能力的嵌入场景。
+     */
+    services?: boolean;
+}
+/**
+ * Agent 停止结果快照。
+ */
+export interface AgentStopResult {
+    /**
+     * 本次是否实际停止了 HTTP 服务。
+     */
+    httpStopped: boolean;
+    /**
+     * 本次是否实际停止了本地 RPC 服务。
+     */
+    rpcStopped: boolean;
+    /**
+     * 本次是否实际停止了 services。
+     */
+    servicesStopped: boolean;
+}
+/**
+ * Agent 启动后的状态快照。
+ */
+export interface AgentStartResult {
+    /**
+     * 当前 agent 是否已启动 HTTP 服务。
+     */
+    http?: AgentHttpBinding;
+    /**
+     * 当前 agent 是否已启动本地 RPC 服务。
+     */
+    rpc?: AgentRpcBinding;
+    /**
+     * 当前 agent 是否已启动 services。
+     */
+    servicesStarted: boolean;
+}
+/**
+ * Agent HTTP 启动参数。
+ */
+export interface AgentHttpStartOptions {
+    /**
+     * HTTP 监听主机。
+     */
+    host?: string;
+    /**
+     * HTTP 监听端口。
+     */
+    port?: number;
+}
+/**
+ * Agent HTTP 绑定信息。
+ */
+export interface AgentHttpBinding {
+    /**
+     * 对外访问地址。
+     */
+    baseUrl: string;
+    /**
+     * 当前 host。
+     */
+    host: string;
+    /**
+     * 当前 port。
+     */
+    port: number;
+    /**
+     * HTTP server 句柄。
+     */
+    server: ServerInstance;
+}
+/**
+ * Agent RPC 绑定信息。
+ */
+export interface AgentRpcBinding {
+    /**
+     * 当前本地 RPC endpoint。
+     */
+    endpoint: string;
+    /**
+     * 本地 RPC server 句柄。
+     */
+    server: LocalRpcServerHandle;
 }
 /**
  * 远程 Agent 构造参数。

package/bin/sdk/AgentSdkTypes.d.ts.map

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

package/bin/sdk/HttpServer.d.ts

@@ -2,39 +2,29 @@
  * SDK HTTP Server。
  *
  * 关键点（中文）
- * - 面向 `RemoteAgent` 暴露最小 session 能力集合。
- * - v1 先聚焦 session 创建、列表、history、run、stream、fork。
+ * - 这里承接单个 Agent 实例的主 HTTP server 生命周期。
+ * - 对外仍暴露 `RemoteAgent` 兼容的 SDK session API，同时保留完整 server 路由能力。
  */
 import type { Agent } from "../sdk/Agent.js";
-type SdkHttpStartOptions = {
-    /**
-     * 监听主机。
-     */
-    host?: string;
-    /**
-     * 监听端口。
-     */
-    port?: number;
-};
+import type { AgentHttpBinding, AgentHttpStartOptions } from "../sdk/AgentSdkTypes.js";
 /**
  * SDK HTTP Server 管理器。
  */
 export declare class SdkAgentHttpServer {
     private readonly agent;
-    private server;
-    private baseUrlValue;
+    private binding;
     constructor(agent: Agent);
     /**
      * 启动 HTTP Server。
      */
-    start(options?: SdkHttpStartOptions): Promise<{
-        baseUrl: string;
-    }>;
+    start(options?: AgentHttpStartOptions): Promise<AgentHttpBinding>;
     /**
      * 停止 HTTP Server。
      */
     stop(): Promise<void>;
-    private readRequestBody;
+    /**
+     * 返回当前是否已启动。
+     */
+    isStarted(): boolean;
 }
-export {};
 //# sourceMappingURL=HttpServer.d.ts.map

package/bin/sdk/HttpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpServer.d.ts","sourceRoot":"","sources":["../../src/sdk/HttpServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,KAAK,mBAAmB,GAAG;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAuB;gBAE/B,KAAK,EAAE,KAAK;IAIxB;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAuKxE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUb,eAAe;CAU9B"}
+{"version":3,"file":"HttpServer.d.ts","sourceRoot":"","sources":["../../src/sdk/HttpServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGtF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,OAAO,CAAiC;gBAEpC,KAAK,EAAE,KAAK;IAIxB;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBvE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}

package/bin/sdk/HttpServer.js

@@ -2,19 +2,16 @@
  * SDK HTTP Server。
  *
  * 关键点（中文）
- * - 面向 `RemoteAgent` 暴露最小 session 能力集合。
- * - v1 先聚焦 session 创建、列表、history、run、stream、fork。
+ * - 这里承接单个 Agent 实例的主 HTTP server 生命周期。
+ * - 对外仍暴露 `RemoteAgent` 兼容的 SDK session API，同时保留完整 server 路由能力。
  */
-import http from "node:http";
-import { Hono } from "hono";
-import { cors } from "hono/cors";
+import { startServer } from "../server/http/Server.js";
 /**
  * SDK HTTP Server 管理器。
  */
 export class SdkAgentHttpServer {
     agent;
-    server = null;
-    baseUrlValue = null;
+    binding = null;
     constructor(agent) {
         this.agent = agent;
     }
@@ -22,168 +19,41 @@ export class SdkAgentHttpServer {
      * 启动 HTTP Server。
      */
     async start(options) {
-        if (this.server && this.baseUrlValue) {
-            return { baseUrl: this.baseUrlValue };
+        if (this.binding) {
+            return this.binding;
         }
-        await this.agent.ensureServicesStarted();
         const host = String(options?.host || "127.0.0.1").trim() || "127.0.0.1";
         const port = typeof options?.port === "number" && Number.isInteger(options.port)
             ? options.port
             : 15314;
-        const app = new Hono();
-        app.use("*", cors({
-            origin: "*",
-            allowMethods: ["GET", "POST", "OPTIONS"],
-            allowHeaders: ["Content-Type"],
-        }));
-        app.get("/api/sdk/sessions", async (c) => {
-            return c.json({
-                success: true,
-                sessions: await this.agent.sessions(),
-            });
-        });
-        app.post("/api/sdk/sessions", async (c) => {
-            const body = await c.req.json().catch(() => ({}));
-            const session = await this.agent.session(typeof body?.sessionId === "string" ? body.sessionId : undefined);
-            return c.json({
-                success: true,
-                session: await session.toMetadata(),
-            });
-        });
-        app.get("/api/sdk/sessions/:sessionId/messages", async (c) => {
-            const session = await this.agent.session(String(c.req.param("sessionId") || ""));
-            return c.json({
-                success: true,
-                sessionId: session.id,
-                messages: await session.history(),
-            });
-        });
-        app.get("/api/sdk/sessions/:sessionId/system", async (c) => {
-            const session = await this.agent.session(String(c.req.param("sessionId") || ""));
-            return c.json({
-                success: true,
-                sessionId: session.id,
-                system: await session.system(),
-            });
-        });
-        app.post("/api/sdk/sessions/:sessionId/run", async (c) => {
-            const session = await this.agent.session(String(c.req.param("sessionId") || ""));
-            const body = await c.req.json().catch(() => ({}));
-            const query = String(body?.query || "").trim();
-            if (!query) {
-                return c.json({ success: false, error: "query is required" }, 400);
-            }
-            const result = await session.run({ query });
-            return c.json({
-                success: true,
-                sessionId: session.id,
-                result,
-            });
-        });
-        app.post("/api/sdk/sessions/:sessionId/fork", async (c) => {
-            const session = await this.agent.session(String(c.req.param("sessionId") || ""));
-            const body = await c.req.json().catch(() => ({}));
-            const forked = await session.fork(typeof body?.messageId === "string" ? body.messageId : undefined);
-            return c.json({
-                success: true,
-                session: await forked.toMetadata(),
-            });
-        });
-        app.post("/api/sdk/sessions/:sessionId/stream", async (c) => {
-            const session = await this.agent.session(String(c.req.param("sessionId") || ""));
-            const body = await c.req.json().catch(() => ({}));
-            const query = String(body?.query || "").trim();
-            if (!query) {
-                return c.json({ success: false, error: "query is required" }, 400);
-            }
-            const encoder = new TextEncoder();
-            const stream = new ReadableStream({
-                start: async (controller) => {
-                    try {
-                        for await (const event of session.stream({ query })) {
-                            controller.enqueue(encoder.encode(`${JSON.stringify(event)}\n`));
-                        }
-                        controller.close();
-                    }
-                    catch (error) {
-                        controller.enqueue(encoder.encode(`${JSON.stringify({
-                            type: "error",
-                            error: error instanceof Error ? error.message : String(error),
-                        })}\n`));
-                        controller.close();
-                    }
-                },
-            });
-            return new Response(stream, {
-                headers: {
-                    "Content-Type": "application/x-ndjson; charset=utf-8",
-                    "Cache-Control": "no-cache, no-transform",
-                },
-            });
-        });
-        const server = http.createServer(async (req, res) => {
-            try {
-                const url = new URL(req.url || "/", `http://${host}:${port}`);
-                const method = req.method || "GET";
-                const bodyBuffer = await this.readRequestBody(req);
-                const request = new Request(url.toString(), {
-                    method,
-                    headers: new Headers(req.headers),
-                    body: bodyBuffer.length > 0 ? bodyBuffer : undefined,
-                });
-                const response = await app.fetch(request);
-                res.statusCode = response.status;
-                response.headers.forEach((value, key) => {
-                    res.setHeader(key, value);
-                });
-                if (!response.body) {
-                    res.end();
-                    return;
-                }
-                const reader = response.body.getReader();
-                while (true) {
-                    const { done, value } = await reader.read();
-                    if (done)
-                        break;
-                    if (value)
-                        res.write(Buffer.from(value));
-                }
-                res.end();
-            }
-            catch (error) {
-                res.statusCode = 500;
-                res.end(String(error));
-            }
-        });
-        await new Promise((resolve) => {
-            server.listen(port, host, () => resolve());
-        });
-        this.server = server;
-        this.baseUrlValue = `http://${host}:${port}`;
-        return {
-            baseUrl: this.baseUrlValue,
+        const server = await startServer({
+            host,
+            port,
+            core: this.agent.core,
+        });
+        this.binding = {
+            baseUrl: `http://${host}:${port}`,
+            host,
+            port,
+            server,
         };
+        return this.binding;
     }
     /**
      * 停止 HTTP Server。
      */
     async stop() {
-        if (!this.server)
+        if (!this.binding)
             return;
-        const current = this.server;
-        this.server = null;
-        this.baseUrlValue = null;
-        await new Promise((resolve) => {
-            current.close(() => resolve());
-        });
+        const current = this.binding;
+        this.binding = null;
+        await current.server.stop();
     }
-    async readRequestBody(req) {
-        return await new Promise((resolve, reject) => {
-            const chunks = [];
-            req.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
-            req.on("end", () => resolve(Buffer.concat(chunks)));
-            req.on("error", reject);
-        });
+    /**
+     * 返回当前是否已启动。
+     */
+    isStarted() {
+        return this.binding !== null;
     }
 }
 //# sourceMappingURL=HttpServer.js.map

package/bin/sdk/HttpServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpServer.js","sourceRoot":"","sources":["../../src/sdk/HttpServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAejC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACZ,KAAK,CAAQ;IACtB,MAAM,GAAuB,IAAI,CAAC;IAClC,YAAY,GAAkB,IAAI,CAAC;IAE3C,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAA6B;QACvC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,WAAW,CAAC,CAAC,IAAI,EAAE,IAAI,WAAW,CAAC;QACxE,MAAM,IAAI,GACR,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;YACjE,CAAC,CAAC,OAAO,CAAC,IAAI;YACd,CAAC,CAAC,KAAK,CAAC;QAEZ,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CACL,GAAG,EACH,IAAI,CAAC;YACH,MAAM,EAAE,GAAG;YACX,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC;YACxC,YAAY,EAAE,CAAC,cAAc,CAAC;SAC/B,CAAC,CACH,CAAC;QAEF,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACvC,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;aACtC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtC,OAAO,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACjE,CAAC;YACF,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE;aACpC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,CAAC,uCAAuC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE;aAClC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,CAAC,qCAAqC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE;aAC/B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,MAAM;aACP,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,mCAAmC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACxD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,OAAO,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACjE,CAAC;YACF,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE;aACnC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,qCAAqC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAa;gBAC5C,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;oBAC1B,IAAI,CAAC;wBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;4BACpD,UAAU,CAAC,OAAO,CAChB,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAC7C,CAAC;wBACJ,CAAC;wBACD,UAAU,CAAC,KAAK,EAAE,CAAC;oBACrB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,UAAU,CAAC,OAAO,CAChB,OAAO,CAAC,MAAM,CACZ,GAAG,IAAI,CAAC,SAAS,CAAC;4BAChB,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAC9D,CAAC,IAAI,CACP,CACF,CAAC;wBACF,UAAU,CAAC,KAAK,EAAE,CAAC;oBACrB,CAAC;gBACH,CAAC;aACF,CAAC,CAAC;YAEH,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;gBAC1B,OAAO,EAAE;oBACP,cAAc,EAAE,qCAAqC;oBACrD,eAAe,EAAE,wBAAwB;iBAC1C;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAClD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC9D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;gBACnC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;gBACnD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;oBAC1C,MAAM;oBACN,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,OAAiC,CAAC;oBAC3D,IAAI,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;iBACrD,CAAC,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC1C,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACjC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACtC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC5B,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACnB,GAAG,CAAC,GAAG,EAAE,CAAC;oBACV,OAAO;gBACT,CAAC;gBACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACzC,OAAO,IAAI,EAAE,CAAC;oBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;oBAC5C,IAAI,IAAI;wBAAE,MAAM;oBAChB,IAAI,KAAK;wBAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3C,CAAC;gBACD,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,YAAY;SAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,GAAyB;QAEzB,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3D,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACpD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"HttpServer.js","sourceRoot":"","sources":["../../src/sdk/HttpServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACZ,KAAK,CAAQ;IACtB,OAAO,GAA4B,IAAI,CAAC;IAEhD,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAA+B;QACzC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,WAAW,CAAC,CAAC,IAAI,EAAE,IAAI,WAAW,CAAC;QACxE,MAAM,IAAI,GACR,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;YACjE,CAAC,CAAC,OAAO,CAAC,IAAI;YACd,CAAC,CAAC,KAAK,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAC/B,IAAI;YACJ,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG;YACb,OAAO,EAAE,UAAU,IAAI,IAAI,IAAI,EAAE;YACjC,IAAI;YACJ,IAAI;YACJ,MAAM;SACP,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IAC/B,CAAC;CACF"}

package/bin/sdk/RpcServer.d.ts

@@ -2,30 +2,29 @@
  * SDK 本地 RPC Server。
  *
  * 关键点（中文）
- * - 面向同机受信任进程提供最小 session JSON RPC 能力。
- * - v1 先支持 session 列表、加载、run、history、fork。
- * - stream 仍建议优先走 HTTP NDJSON。
+ * - 这里承接单个 Agent 实例的主 local RPC server 生命周期。
+ * - 启动后暴露的是完整本机受信任 IPC 能力，而不是仅 SDK session 子集。
  */
 import type { Agent } from "../sdk/Agent.js";
+import type { AgentRpcBinding } from "../sdk/AgentSdkTypes.js";
 /**
  * SDK RPC Server 管理器。
  */
 export declare class SdkAgentRpcServer {
     private readonly agent;
-    private server;
-    private endpoint;
+    private binding;
     constructor(agent: Agent);
     /**
      * 启动本地 RPC server。
      */
-    start(): Promise<{
-        endpoint: string;
-    }>;
+    start(): Promise<AgentRpcBinding>;
     /**
      * 停止本地 RPC server。
      */
     stop(): Promise<void>;
-    private respond;
-    private dispatch;
+    /**
+     * 返回当前是否已启动。
+     */
+    isStarted(): boolean;
 }
 //# sourceMappingURL=RpcServer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RpcServer.d.ts","sourceRoot":"","sources":["../../src/sdk/RpcServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAO5C;;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;CA0IvB"}
+{"version":3,"file":"RpcServer.d.ts","sourceRoot":"","sources":["../../src/sdk/RpcServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,OAAO,CAAgC;gBAEnC,KAAK,EAAE,KAAK;IAIxB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAcvC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}