@downcity/server 0.1.3

package/bin/http/routes/SessionRoutes.js

@@ -0,0 +1,249 @@
+/**
+ * SDK HTTP session 路由。
+ *
+ * 关键点（中文）
+ * - 这组路由面向 `RemoteAgent`，只暴露最小 Session actor 使用面。
+ * - 当前公开输入收口到 `prompt()`，公开输出收口到 `events` 长连接。
+ * - 不复用 control API 的控制台语义，避免 transport 面混入非 SDK 约束。
+ */
+const NDJSON_CONTENT_TYPE = "application/x-ndjson; charset=utf-8";
+const SDK_EVENTS_READY_FRAME = {
+    type: "sdk-events-ready",
+};
+/**
+ * 注册 SDK session 路由。
+ */
+export function registerSdkSessionRoutes(app, sessionCollection) {
+    app.get("/api/sdk/sessions", async (c) => {
+        try {
+            const input = {
+                ...(c.req.query("limit") ? { limit: Number(c.req.query("limit")) } : {}),
+                ...(c.req.query("cursor") ? { cursor: c.req.query("cursor") } : {}),
+                ...(c.req.query("query") ? { query: c.req.query("query") } : {}),
+            };
+            const page = await sessionCollection.listSessions(input);
+            return c.json({
+                success: true,
+                page,
+                sessions: page.items,
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.post("/api/sdk/sessions", async (c) => {
+        try {
+            const body = (await c.req.json().catch(() => ({})));
+            const session = await sessionCollection.createSession({
+                ...(body.sessionId ? { sessionId: String(body.sessionId).trim() } : {}),
+            });
+            return c.json({
+                success: true,
+                session: await session.getInfo(),
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.get("/api/sdk/sessions/:sessionId", async (c) => {
+        try {
+            const sessionId = String(c.req.param("sessionId") || "").trim();
+            if (!sessionId) {
+                return c.json({ success: false, error: "Missing sessionId" }, 400);
+            }
+            const session = await sessionCollection.getSession(sessionId);
+            return c.json({
+                success: true,
+                session: await session.getInfo(),
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.post("/api/sdk/sessions/:sessionId/prompt", async (c) => {
+        try {
+            const sessionId = String(c.req.param("sessionId") || "").trim();
+            if (!sessionId) {
+                return c.json({ success: false, error: "Missing sessionId" }, 400);
+            }
+            const body = (await c.req.json());
+            const session = await sessionCollection.getSession(sessionId);
+            const turn = await session.prompt(body);
+            return c.json({
+                success: true,
+                turn: {
+                    id: turn.id,
+                },
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.get("/api/sdk/sessions/:sessionId/events", async (c) => {
+        const sessionId = String(c.req.param("sessionId") || "").trim();
+        if (!sessionId) {
+            return c.json({ success: false, error: "Missing sessionId" }, 400);
+        }
+        try {
+            const session = await sessionCollection.getSession(sessionId);
+            const encoder = new TextEncoder();
+            const requestSignal = c.req.raw.signal;
+            let cleanupEventsConnection = () => { };
+            const stream = new ReadableStream({
+                cancel() {
+                    cleanupEventsConnection();
+                },
+                start(controller) {
+                    const writeLine = (value) => {
+                        controller.enqueue(encoder.encode(`${JSON.stringify(value)}\n`));
+                    };
+                    const unsubscribe = session.subscribe((event) => {
+                        writeLine(event);
+                    });
+                    const closeStream = () => {
+                        cleanupEventsConnection();
+                        try {
+                            controller.close();
+                        }
+                        catch {
+                            // ignore duplicate close attempts
+                        }
+                    };
+                    cleanupEventsConnection = () => {
+                        unsubscribe();
+                        requestSignal.removeEventListener("abort", closeStream);
+                    };
+                    if (requestSignal.aborted) {
+                        closeStream();
+                        return;
+                    }
+                    requestSignal.addEventListener("abort", closeStream, { once: true });
+                    writeLine(SDK_EVENTS_READY_FRAME);
+                },
+            });
+            return new Response(stream, {
+                status: 200,
+                headers: {
+                    "Content-Type": NDJSON_CONTENT_TYPE,
+                    "Cache-Control": "no-cache, no-transform",
+                    "X-Accel-Buffering": "no",
+                },
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.get("/api/sdk/sessions/:sessionId/history", async (c) => {
+        try {
+            const sessionId = String(c.req.param("sessionId") || "").trim();
+            if (!sessionId) {
+                return c.json({ success: false, error: "Missing sessionId" }, 400);
+            }
+            const session = await sessionCollection.getSession(sessionId);
+            const history = await session.history({
+                ...(c.req.query("limit") ? { limit: Number(c.req.query("limit")) } : {}),
+                ...(c.req.query("cursor") ? { cursor: c.req.query("cursor") } : {}),
+                ...(c.req.query("order")
+                    ? { order: c.req.query("order") }
+                    : {}),
+                ...(c.req.query("view")
+                    ? { view: c.req.query("view") }
+                    : {}),
+            });
+            return c.json({
+                success: true,
+                history,
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.get("/api/sdk/sessions/:sessionId/messages", async (c) => {
+        try {
+            const sessionId = String(c.req.param("sessionId") || "").trim();
+            if (!sessionId) {
+                return c.json({ success: false, error: "Missing sessionId" }, 400);
+            }
+            const session = await sessionCollection.getSession(sessionId);
+            const history = await session.history({
+                view: "message",
+            });
+            return c.json({
+                success: true,
+                messages: history.items,
+                history,
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.get("/api/sdk/sessions/:sessionId/system", async (c) => {
+        try {
+            const sessionId = String(c.req.param("sessionId") || "").trim();
+            if (!sessionId) {
+                return c.json({ success: false, error: "Missing sessionId" }, 400);
+            }
+            const session = await sessionCollection.getSession(sessionId);
+            return c.json({
+                success: true,
+                system: await session.system(),
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+    app.post("/api/sdk/sessions/:sessionId/fork", async (c) => {
+        try {
+            const sessionId = String(c.req.param("sessionId") || "").trim();
+            if (!sessionId) {
+                return c.json({ success: false, error: "Missing sessionId" }, 400);
+            }
+            const body = (await c.req.json().catch(() => ({})));
+            const session = await sessionCollection.getSession(sessionId);
+            const forked = await session.fork(String(body.messageId || "").trim() || undefined);
+            return c.json({
+                success: true,
+                session: await forked.getInfo(),
+            });
+        }
+        catch (error) {
+            return c.json({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, 500);
+        }
+    });
+}
+//# sourceMappingURL=SessionRoutes.js.map

package/bin/http/routes/SessionRoutes.js.map

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

package/bin/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @downcity/server 包公共入口。
+ *
+ * 关键点（中文）
+ * - 这里只导出 transport 适配类与必要的绑定类型。
+ * - Agent 业务能力仍由 `@downcity/agent` 提供，本包不做转出。
+ */
+export { AgentRPC } from "./rpc/AgentRPC.js";
+export { AgentHTTP } from "./http/AgentHTTP.js";
+export type { AgentHttpServerHandle } from "./http/AgentHTTP.js";
+export type { AgentRpcBinding, AgentRpcListenOptions, } from "./types/AgentRpcBinding.js";
+export type { AgentHttpBinding, AgentHttpListenOptions, } from "./types/AgentHttpBinding.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EACV,eAAe,EACf,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC"}

package/bin/index.js

@@ -0,0 +1,10 @@
+/**
+ * @downcity/server 包公共入口。
+ *
+ * 关键点（中文）
+ * - 这里只导出 transport 适配类与必要的绑定类型。
+ * - Agent 业务能力仍由 `@downcity/agent` 提供，本包不做转出。
+ */
+export { AgentRPC } from "./rpc/AgentRPC.js";
+export { AgentHTTP } from "./http/AgentHTTP.js";
+//# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/bin/rpc/AgentRPC.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AgentRPC：把本地 Agent 暴露为本机 RPC 服务的对外类。
+ *
+ * 关键点（中文）
+ * - 持有一个 `Agent` 引用，按需启动 / 关闭底层 net server。
+ * - RPC 协议本身仍是 NDJSON over TCP，不做协议变更。
+ * - 仅提供 `listen()` / `close()` / `binding()` 三个方法，端口、host 由调用方决定。
+ */
+import type { Agent } from "@downcity/agent";
+import type { AgentRpcBinding, AgentRpcListenOptions } from "../types/AgentRpcBinding.js";
+/**
+ * 把一个 `Agent` 暴露为本机 RPC 服务。
+ */
+export declare class AgentRPC {
+    private readonly agent;
+    private rpc_instance;
+    private current_binding;
+    private start_promise;
+    constructor(agent: Agent);
+    /**
+     * 监听 RPC 端口。
+     *
+     * 说明（中文）
+     * - 重复调用返回同一个 binding。
+     * - 默认 `127.0.0.1:15314`，本机调试足够。
+     */
+    listen(options?: AgentRpcListenOptions): Promise<AgentRpcBinding>;
+    /**
+     * 关闭 RPC 服务。
+     */
+    close(): Promise<void>;
+    /**
+     * 当前监听绑定信息，未 listen 时返回 `null`。
+     */
+    binding(): AgentRpcBinding | null;
+}
+//# sourceMappingURL=AgentRPC.d.ts.map

package/bin/rpc/AgentRPC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRPC.d.ts","sourceRoot":"","sources":["../../src/rpc/AgentRPC.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAKpC;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,aAAa,CAAyC;gBAElD,KAAK,EAAE,KAAK;IAIxB;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiCvE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACH,OAAO,IAAI,eAAe,GAAG,IAAI;CAGlC"}

package/bin/rpc/AgentRPC.js

@@ -0,0 +1,81 @@
+/**
+ * AgentRPC：把本地 Agent 暴露为本机 RPC 服务的对外类。
+ *
+ * 关键点（中文）
+ * - 持有一个 `Agent` 引用，按需启动 / 关闭底层 net server。
+ * - RPC 协议本身仍是 NDJSON over TCP，不做协议变更。
+ * - 仅提供 `listen()` / `close()` / `binding()` 三个方法，端口、host 由调用方决定。
+ */
+import { startRpcServer } from "../rpc/RpcServer.js";
+const DEFAULT_RPC_HOST = "127.0.0.1";
+const DEFAULT_RPC_PORT = 15314;
+/**
+ * 把一个 `Agent` 暴露为本机 RPC 服务。
+ */
+export class AgentRPC {
+    agent;
+    rpc_instance = null;
+    current_binding = null;
+    start_promise = null;
+    constructor(agent) {
+        this.agent = agent;
+    }
+    /**
+     * 监听 RPC 端口。
+     *
+     * 说明（中文）
+     * - 重复调用返回同一个 binding。
+     * - 默认 `127.0.0.1:15314`，本机调试足够。
+     */
+    async listen(options) {
+        if (this.start_promise)
+            return await this.start_promise;
+        if (this.current_binding)
+            return this.current_binding;
+        this.start_promise = (async () => {
+            const host = String(options?.host || DEFAULT_RPC_HOST).trim() || DEFAULT_RPC_HOST;
+            const port = typeof options?.port === "number" && Number.isInteger(options.port)
+                ? options.port
+                : DEFAULT_RPC_PORT;
+            const instance = await startRpcServer({
+                host,
+                port,
+                sessionCollection: this.agent.getSessionCollection(),
+                getAgentContext: () => this.agent.getContext(),
+                getAgentRuntime: () => this.agent.getRuntime(),
+                getShell: () => this.agent.getShell(),
+            });
+            this.rpc_instance = instance;
+            this.current_binding = {
+                url: instance.url,
+                host: instance.host,
+                port: instance.port,
+            };
+            return this.current_binding;
+        })();
+        try {
+            return await this.start_promise;
+        }
+        finally {
+            this.start_promise = null;
+        }
+    }
+    /**
+     * 关闭 RPC 服务。
+     */
+    async close() {
+        const instance = this.rpc_instance;
+        this.rpc_instance = null;
+        this.current_binding = null;
+        if (!instance)
+            return;
+        await instance.stop();
+    }
+    /**
+     * 当前监听绑定信息，未 listen 时返回 `null`。
+     */
+    binding() {
+        return this.current_binding;
+    }
+}
+//# sourceMappingURL=AgentRPC.js.map

package/bin/rpc/AgentRPC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRPC.js","sourceRoot":"","sources":["../../src/rpc/AgentRPC.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAA0B,MAAM,oBAAoB,CAAC;AAM5E,MAAM,gBAAgB,GAAG,WAAW,CAAC;AACrC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,QAAQ;IACF,KAAK,CAAQ;IACtB,YAAY,GAA6B,IAAI,CAAC;IAC9C,eAAe,GAA2B,IAAI,CAAC;IAC/C,aAAa,GAAoC,IAAI,CAAC;IAE9D,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,OAA+B;QAC1C,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC;QACxD,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC,eAAe,CAAC;QACtD,IAAI,CAAC,aAAa,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,IAAI,GACR,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,gBAAgB,CAAC,CAAC,IAAI,EAAE,IAAI,gBAAgB,CAAC;YACvE,MAAM,IAAI,GACR,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;gBACjE,CAAC,CAAC,OAAO,CAAC,IAAI;gBACd,CAAC,CAAC,gBAAgB,CAAC;YACvB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC;gBACpC,IAAI;gBACJ,IAAI;gBACJ,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE;gBACpD,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;gBAC9C,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;gBAC9C,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;aACtC,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;YAC7B,IAAI,CAAC,eAAe,GAAG;gBACrB,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;YACF,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC;QAClC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/bin/rpc/RpcServer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent 本机 RPC server 网络层。
+ *
+ * 职责说明（中文）
+ * - 为本机 `RemoteAgent(rpc://...)` 与 Town runtime 提供 Agent RPC 入口。
+ * - 只负责 TCP/NDJSON framing、socket 生命周期与订阅清理。
+ * - 具体 `sdk.*` / `internal.*` 方法由 server handlers 承接。
+ */
+import net from "node:net";
+import type { RpcServerStartOptions } from "../rpc/server/ServerTypes.js";
+/**
+ * RPC server 运行实例。
+ */
+export interface RpcServerInstance {
+    /** 当前监听 host。 */
+    host: string;
+    /** 当前监听 port。 */
+    port: number;
+    /** 当前访问 URL。 */
+    url: string;
+    /** 原生 net server。 */
+    server: net.Server;
+    /** 停止当前服务。 */
+    stop(): Promise<void>;
+}
+/**
+ * 启动 Agent 本机 RPC server。
+ */
+export declare function startRpcServer(options: RpcServerStartOptions): Promise<RpcServerInstance>;
+//# sourceMappingURL=RpcServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RpcServer.d.ts","sourceRoot":"","sources":["../../src/rpc/RpcServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,UAAU,CAAC;AAK3B,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,cAAc;IACd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAmG5B"}

package/bin/rpc/RpcServer.js

@@ -0,0 +1,106 @@
+/**
+ * Agent 本机 RPC server 网络层。
+ *
+ * 职责说明（中文）
+ * - 为本机 `RemoteAgent(rpc://...)` 与 Town runtime 提供 Agent RPC 入口。
+ * - 只负责 TCP/NDJSON framing、socket 生命周期与订阅清理。
+ * - 具体 `sdk.*` / `internal.*` 方法由 server handlers 承接。
+ */
+import net from "node:net";
+import { dispatchRpcRequest } from "../rpc/server/RequestDispatcher.js";
+/**
+ * 启动 Agent 本机 RPC server。
+ */
+export async function startRpcServer(options) {
+    const sockets = new Set();
+    const server = net.createServer((socket) => {
+        sockets.add(socket);
+        const subscriptions = new Map();
+        let buffered = "";
+        const cleanup_subscriptions = () => {
+            for (const subscription of subscriptions.values()) {
+                subscription.unsubscribe();
+            }
+            subscriptions.clear();
+        };
+        const write_frame = (frame) => {
+            socket.write(`${JSON.stringify(frame)}\n`);
+        };
+        const write_success = (id, data) => {
+            write_frame({
+                id,
+                success: true,
+                ...(data === undefined ? {} : { data }),
+            });
+        };
+        const write_error = (id, error) => {
+            write_frame({
+                id,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        };
+        const handle_line = (line) => {
+            try {
+                const request = JSON.parse(line);
+                void dispatchRpcRequest({
+                    request,
+                    options,
+                    subscriptions,
+                    write_success,
+                    write_error,
+                    write_event: write_frame,
+                });
+            }
+            catch (error) {
+                write_error("parse", error);
+            }
+        };
+        socket.on("data", (chunk) => {
+            buffered += chunk.toString("utf8");
+            let newline_index = buffered.indexOf("\n");
+            while (newline_index >= 0) {
+                const line = buffered.slice(0, newline_index).trim();
+                buffered = buffered.slice(newline_index + 1);
+                if (line) {
+                    handle_line(line);
+                }
+                newline_index = buffered.indexOf("\n");
+            }
+        });
+        socket.on("error", () => {
+            cleanup_subscriptions();
+        });
+        socket.on("close", () => {
+            sockets.delete(socket);
+            cleanup_subscriptions();
+        });
+        socket.on("end", () => {
+            cleanup_subscriptions();
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(options.port, options.host, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    return {
+        host: options.host,
+        port: options.port,
+        url: `rpc://${options.host}:${options.port}`,
+        server,
+        async stop() {
+            // 关键点（中文）：RPC 是长连接；停止 server 时必须主动关闭现有 socket。
+            for (const socket of sockets) {
+                socket.destroy();
+            }
+            sockets.clear();
+            await new Promise((resolve) => {
+                server.close(() => resolve());
+            });
+        },
+    };
+}
+//# sourceMappingURL=RpcServer.js.map

package/bin/rpc/RpcServer.js.map

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

package/bin/rpc/server/InternalHandlers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * RPC internal handlers。
+ *
+ * 关键点（中文）
+ * - 只处理 `internal.*` 方法。
+ * - 这些方法服务 Town 本机管理通道，不属于 RemoteAgent 的用户 SDK 面。
+ * - 实现依赖 `@downcity/agent` 的 internal 路径，故只能由 `@downcity/server` 同进程使用。
+ */
+import type { RpcRequest } from "../../types/RpcProtocol.js";
+import type { RpcRequestHandlerOptions, RpcWriteSuccess } from "../../rpc/server/ServerTypes.js";
+/**
+ * 处理 internal RPC 请求。
+ */
+export declare function handleInternalRpcRequest(params: {
+    /** 当前 RPC 请求。 */
+    request: RpcRequest;
+    /** handler 依赖。 */
+    options: RpcRequestHandlerOptions;
+    /** 成功帧写入函数。 */
+    write_success: RpcWriteSuccess;
+}): Promise<boolean>;
+//# sourceMappingURL=InternalHandlers.d.ts.map

package/bin/rpc/server/InternalHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalHandlers.d.ts","sourceRoot":"","sources":["../../../src/rpc/server/InternalHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAarC;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,iBAAiB;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,kBAAkB;IAClB,OAAO,EAAE,wBAAwB,CAAC;IAClC,eAAe;IACf,aAAa,EAAE,eAAe,CAAC;CAChC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyKnB"}