@downcity/agent 1.1.338 → 1.1.400

package/bin/city/transport/rpc/CityRPC.d.ts

@@ -0,0 +1,26 @@
+/**
+ * CityRPC：在一个原生 TCP RPC Server 上暴露 City 持有的全部 Agent。
+ *
+ * 请求必须携带 `agent_id` 与 `workspace_id`。`RemoteAgent` 会从
+ * `rpc://host:port/<agent_id>/<workspace_id>` 自动解析并附加字段。
+ */
+import type { City } from "../../runtime/City.js";
+import type { AgentRpcBinding, AgentRpcListenOptions } from "../types/AgentRpcBinding.js";
+import type { CityRpcRuntimeOptions } from "../types/CityRpcRuntime.js";
+/** 在单一 RPC 端口暴露 City 的多 Agent transport。 */
+export declare class CityRPC {
+    private readonly city;
+    private readonly runtime_options;
+    /** 当前 City RPC Server 的唯一串行生命周期。 */
+    private readonly lifecycle;
+    constructor(city: City, runtime_options?: CityRpcRuntimeOptions);
+    /** 监听 City 级 RPC 端口。 */
+    listen(options?: AgentRpcListenOptions): Promise<AgentRpcBinding>;
+    /** 创建并启动 City RPC Server。 */
+    private start_server;
+    /** 幂等关闭 RPC Server 与全部长连接。 */
+    close(): Promise<void>;
+    /** 返回当前绑定；尚未监听时返回 null。 */
+    binding(): AgentRpcBinding | null;
+}
+//# sourceMappingURL=CityRPC.d.ts.map

package/bin/city/transport/rpc/CityRPC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityRPC.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/rpc/CityRPC.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAMtF,4CAA4C;AAC5C,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIxB;gBAEU,IAAI,EAAE,IAAI,EAAE,eAAe,GAAE,qBAA0B;IASnE,wBAAwB;IAClB,MAAM,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIvE,6BAA6B;YACf,YAAY;IAkE1B,8BAA8B;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,2BAA2B;IAC3B,OAAO,IAAI,eAAe,GAAG,IAAI;CAGlC"}

package/bin/city/transport/rpc/CityRPC.js

@@ -0,0 +1,110 @@
+/**
+ * CityRPC：在一个原生 TCP RPC Server 上暴露 City 持有的全部 Agent。
+ *
+ * 请求必须携带 `agent_id` 与 `workspace_id`。`RemoteAgent` 会从
+ * `rpc://host:port/<agent_id>/<workspace_id>` 自动解析并附加字段。
+ */
+import { start_rpc_server } from "./RpcServer.js";
+import { SerializedTransport } from "../SerializedTransport.js";
+const DEFAULT_RPC_HOST = "127.0.0.1";
+const DEFAULT_RPC_PORT = 15314;
+/** 在单一 RPC 端口暴露 City 的多 Agent transport。 */
+export class CityRPC {
+    city;
+    runtime_options;
+    /** 当前 City RPC Server 的唯一串行生命周期。 */
+    lifecycle;
+    constructor(city, runtime_options = {}) {
+        this.city = city;
+        this.runtime_options = runtime_options;
+        this.lifecycle = new SerializedTransport({
+            start: async (options) => await this.start_server(options),
+            stop: async (instance) => await instance.stop(),
+        });
+    }
+    /** 监听 City 级 RPC 端口。 */
+    async listen(options) {
+        return await this.lifecycle.listen(options);
+    }
+    /** 创建并启动 City RPC Server。 */
+    async start_server(options) {
+        const host = String(options?.host || DEFAULT_RPC_HOST).trim() || DEFAULT_RPC_HOST;
+        const port = Number.isInteger(options?.port) ? Number(options?.port) : DEFAULT_RPC_PORT;
+        const unavailable_sessions = create_unavailable_sessions();
+        const instance = await start_rpc_server({
+            host,
+            port,
+            sessions: unavailable_sessions,
+            resolve_request_options: async (request) => {
+                if (request.method === "internal.city.status"
+                    || request.method === "internal.city.shutdown") {
+                    return {
+                        sessions: unavailable_sessions,
+                        get_city_status: () => ({
+                            agent_ids: this.city.agents.list().map((agent) => agent.id),
+                        }),
+                        shutdown_city: this.runtime_options.shutdown,
+                    };
+                }
+                const agent_id = String(request.agent_id || "").trim();
+                if (!agent_id)
+                    throw new Error("CityRPC request requires agent_id");
+                const workspace_id = String(request.workspace_id || "").trim();
+                if (!workspace_id)
+                    throw new Error("CityRPC request requires workspace_id");
+                const workspace_entry = await this.city.enter_workspace(agent_id, workspace_id);
+                const agent = this.city.agents.get(agent_id);
+                if (!agent)
+                    throw new Error(`Agent not found: ${agent_id}`);
+                const sessions = workspace_entry.sessions;
+                const resolve_session_model = this.runtime_options.resolve_session_model;
+                const reload_workspace_env = this.runtime_options.reload_workspace_env;
+                return {
+                    sessions,
+                    get_agent_context: () => ({
+                        agent,
+                        workspace: workspace_entry.workspace,
+                        sessions,
+                        plugins: workspace_entry.plugins,
+                        list_plugin_states: () => workspace_entry.list_plugin_states(),
+                        resolve_system_messages: async (input) => await workspace_entry.resolve_system_messages(input),
+                    }),
+                    resolve_session_model: resolve_session_model
+                        ? async (model_id) => await resolve_session_model(agent_id, workspace_id, model_id)
+                        : undefined,
+                    reload_workspace_env: reload_workspace_env
+                        ? async () => await reload_workspace_env(agent_id, workspace_id)
+                        : undefined,
+                    shutdown_city: this.runtime_options.shutdown,
+                };
+            },
+        });
+        return {
+            resource: instance,
+            binding: { url: instance.url, host: instance.host, port: instance.port },
+        };
+    }
+    /** 幂等关闭 RPC Server 与全部长连接。 */
+    async close() {
+        await this.lifecycle.close();
+    }
+    /** 返回当前绑定；尚未监听时返回 null。 */
+    binding() {
+        return this.lifecycle.binding();
+    }
+}
+/** 空 City 中拒绝 Agent SDK 请求的 Session 集合。 */
+function create_unavailable_sessions() {
+    const unavailable = async () => {
+        throw new Error("City has no Agents");
+    };
+    return {
+        create: unavailable,
+        get: unavailable,
+        list: unavailable,
+        archive: unavailable,
+        archived: unavailable,
+        clean_archive: unavailable,
+    };
+}
+//# sourceMappingURL=CityRPC.js.map

package/bin/city/transport/rpc/CityRPC.js.map

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

package/bin/city/transport/rpc/RpcServer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent 本机 RPC server 网络层。
+ *
+ * 职责说明（中文）
+ * - 为本机 `RemoteAgent(rpc://...)` 与 downcity runtime 提供 Agent RPC 入口。
+ * - 只负责 TCP/NDJSON framing、socket 生命周期与订阅清理。
+ * - 具体 `sdk.*` / `internal.*` 方法由 server handlers 承接。
+ */
+import net from "node:net";
+import type { RpcServerStartOptions } from "./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 start_rpc_server(options: RpcServerStartOptions): Promise<RpcServerInstance>;
+//# sourceMappingURL=RpcServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RpcServer.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/rpc/RpcServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,UAAU,CAAC;AAK3B,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,4CAA4C,CAAC;AAGpD;;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,gBAAgB,CACpC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAoH5B"}

package/bin/city/transport/rpc/RpcServer.js

@@ -0,0 +1,125 @@
+/**
+ * Agent 本机 RPC server 网络层。
+ *
+ * 职责说明（中文）
+ * - 为本机 `RemoteAgent(rpc://...)` 与 downcity runtime 提供 Agent RPC 入口。
+ * - 只负责 TCP/NDJSON framing、socket 生命周期与订阅清理。
+ * - 具体 `sdk.*` / `internal.*` 方法由 server handlers 承接。
+ */
+import net from "node:net";
+import { dispatch_rpc_request } from "./server/RequestDispatcher.js";
+/**
+ * 启动 Agent 本机 RPC server。
+ */
+export async function start_rpc_server(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 = async (line) => {
+            let request;
+            try {
+                request = JSON.parse(line);
+            }
+            catch (error) {
+                write_error("parse", error);
+                return;
+            }
+            try {
+                const request_options = await options.resolve_request_options?.(request) ?? options;
+                await dispatch_rpc_request({
+                    request,
+                    options: request_options,
+                    subscriptions,
+                    write_success,
+                    write_error,
+                    write_event: write_frame,
+                });
+            }
+            catch (error) {
+                write_error(request.id, 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) {
+                    void 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) => {
+        const on_error = (error) => {
+            server.off("error", on_error);
+            // 启动失败的 Server 不会交给 RpcServerInstance，必须在这里收口。
+            try {
+                server.close();
+            }
+            catch {
+                // 未进入监听态时 close 可能抛出 ERR_SERVER_NOT_RUNNING，可安全忽略。
+            }
+            reject(error);
+        };
+        server.once("error", on_error);
+        server.listen(options.port, options.host, () => {
+            server.off("error", on_error);
+            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/city/transport/rpc/RpcServer.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * RPC internal handlers。
+ *
+ * 关键点（中文）
+ * - 只处理 `internal.*` 方法。
+ * - 这些方法服务 downcity 本机管理通道，不属于 RemoteAgent 的用户 SDK 面。
+ * - Session 与 Plugin 数据通过 Agent 能力操作，不读取领域内部路径。
+ */
+import type { RpcRequest } from "../../types/RpcProtocol.js";
+import type { RpcRequestHandlerOptions, RpcWriteSuccess } from "./ServerTypes.js";
+/**
+ * 处理 internal RPC 请求。
+ */
+export declare function handle_internal_rpc_request(params: {
+    /** 当前 RPC 请求。 */
+    request: RpcRequest;
+    /** handler 依赖。 */
+    options: RpcRequestHandlerOptions;
+    /** 成功帧写入函数。 */
+    write_success: RpcWriteSuccess;
+}): Promise<boolean>;
+//# sourceMappingURL=InternalHandlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InternalHandlers.d.ts","sourceRoot":"","sources":["../../../../../src/city/transport/rpc/server/InternalHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EACV,wBAAwB,EAExB,eAAe,EAChB,MAAM,4CAA4C,CAAC;AAEpD;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,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,CAqInB"}

package/bin/city/transport/rpc/server/InternalHandlers.js

@@ -0,0 +1,196 @@
+/**
+ * RPC internal handlers。
+ *
+ * 关键点（中文）
+ * - 只处理 `internal.*` 方法。
+ * - 这些方法服务 downcity 本机管理通道，不属于 RemoteAgent 的用户 SDK 面。
+ * - Session 与 Plugin 数据通过 Agent 能力操作，不读取领域内部路径。
+ */
+/**
+ * 处理 internal RPC 请求。
+ */
+export async function handle_internal_rpc_request(params) {
+    const { request, options, write_success } = params;
+    switch (request.method) {
+        case "internal.city.status": {
+            if (!options.get_city_status) {
+                throw new Error("RPC host does not provide City status");
+            }
+            write_success(request.id, {
+                status: "ok",
+                pid: process.pid,
+                agent_ids: options.get_city_status().agent_ids,
+                instance_id: String(process.env.DOWNCITY_DAEMON_INSTANCE_ID || "").trim(),
+            });
+            return true;
+        }
+        case "internal.city.shutdown": {
+            if (!options.shutdown_city)
+                throw new Error("RPC host does not provide City shutdown");
+            write_success(request.id, { accepted: true });
+            setImmediate(() => void options.shutdown_city?.());
+            return true;
+        }
+        case "internal.status.get": {
+            const context = requireAgent(options);
+            write_success(request.id, {
+                status: "ok",
+                pid: process.pid,
+                agent_id: context.agent.id,
+                workspace_id: context.workspace.id,
+                workspace_path: context.workspace.path,
+                instance_id: String(process.env.DOWNCITY_DAEMON_INSTANCE_ID || "").trim(),
+            });
+            return true;
+        }
+        case "internal.workspace.reload_env": {
+            if (!options.reload_workspace_env) {
+                throw new Error("Agent RPC host does not provide Workspace Env reload");
+            }
+            const env = await options.reload_workspace_env();
+            write_success(request.id, {
+                reloaded: true,
+                key_count: Object.keys(env).length,
+            });
+            return true;
+        }
+        case "internal.sessions.clear_messages": {
+            const context = requireAgent(options);
+            const session_id = String(request.params.session_id || "").trim();
+            if (!session_id)
+                throw new Error("Missing session_id");
+            await context.sessions.clear_messages(session_id);
+            write_success(request.id, {
+                session_id: session_id,
+                cleared: true,
+            });
+            return true;
+        }
+        case "internal.sessions.clear_chat_history": {
+            const context = requireAgent(options);
+            const session_id = String(request.params.session_id || "").trim();
+            if (!session_id)
+                throw new Error("Missing session_id");
+            const result = await context.plugins.run_action({
+                plugin: "chat",
+                action: "history_clear",
+                payload: { session_id: session_id },
+            });
+            if (!result.success) {
+                throw new Error(result.error || result.message || "Chat history clear failed");
+            }
+            const data = result.data && typeof result.data === "object"
+                ? result.data
+                : {};
+            write_success(request.id, {
+                session_id: session_id,
+                cleared: data.cleared === true,
+            });
+            return true;
+        }
+        case "internal.sessions.resolve_system_prompt": {
+            const context = requireAgent(options);
+            const session_id = String(request.params.session_id || "").trim() || "consoleui-chat-main";
+            const system_messages = await context.resolve_system_messages({
+                session_id,
+                profile: "chat",
+            });
+            write_success(request.id, {
+                session_id: session_id,
+                ...toSystemPromptPayload(system_messages),
+            });
+            return true;
+        }
+        case "internal.plugins.catalog": {
+            const context = requireAgent(options);
+            write_success(request.id, {
+                plugins: context.plugins.list(),
+            });
+            return true;
+        }
+        case "internal.plugins.list": {
+            const context = requireAgent(options);
+            write_success(request.id, {
+                plugins: context.list_plugin_states(),
+            });
+            return true;
+        }
+        case "internal.plugins.availability": {
+            const context = requireAgent(options);
+            const availability = await context.plugins.availability(request.params.plugin_name);
+            write_success(request.id, {
+                plugin_name: request.params.plugin_name,
+                availability,
+            });
+            return true;
+        }
+        case "internal.plugins.action": {
+            const context = requireAgent(options);
+            const result = await context.plugins.run_action({
+                plugin: request.params.plugin_name,
+                action: request.params.action_name,
+                payload: request.params.payload,
+            });
+            write_success(request.id, {
+                ...result,
+                plugin_name: request.params.plugin_name,
+                action_name: request.params.action_name,
+            });
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+function requireAgent(options) {
+    const context = options.get_agent_context?.();
+    if (!context) {
+        throw new Error("Agent RPC server was started without Agent");
+    }
+    return context;
+}
+function normalizeSystemText(input) {
+    return String(input || "").trim();
+}
+function toSystemMessageText(message) {
+    const content = message.content;
+    if (typeof content === "string")
+        return normalizeSystemText(content);
+    if (!Array.isArray(content))
+        return "";
+    const parts = content;
+    const texts = [];
+    for (const part of parts) {
+        if (!part || typeof part !== "object")
+            continue;
+        const text = normalizeSystemText(String(part.text || ""));
+        if (!text)
+            continue;
+        texts.push(text);
+    }
+    return texts.join("\n").trim();
+}
+/**
+ * 把 system messages 转成 Console/downcity 可直接渲染的结构。
+ */
+function toSystemPromptPayload(messages) {
+    const items = messages
+        .map((message, index) => ({
+        index: index + 1,
+        content: toSystemMessageText(message),
+    }))
+        .filter((item) => item.content);
+    const total_chars = items.reduce((acc, item) => acc + String(item.content || "").length, 0);
+    return {
+        sections: [
+            {
+                key: "resolved",
+                title: "Resolved System Messages",
+                items,
+            },
+        ],
+        total_messages: items.length,
+        total_chars,
+    };
+}
+//# sourceMappingURL=InternalHandlers.js.map

package/bin/city/transport/rpc/server/InternalHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalHandlers.js","sourceRoot":"","sources":["../../../../../src/city/transport/rpc/server/InternalHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAOjD;IACC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAEnD,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,CAAC;YACD,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,MAAM,EAAE,IAAI;gBACZ,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,SAAS,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,SAAS;gBAC9C,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;aAC1E,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,aAAa;gBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACvF,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,MAAM,EAAE,IAAI;gBACZ,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;gBAC1B,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;gBAClC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;gBACtC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;aAC1E,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC;YACjD,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM;aACnC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,kCAAkC,CAAC,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAClE,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACvD,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAClD,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,UAAU,EAAE,UAAU;gBACtB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,sCAAsC,CAAC,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAClE,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC9C,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,eAAe;gBACvB,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE;aACpC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,2BAA2B,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;gBACzD,CAAC,CAAC,MAAM,CAAC,IAA6B;gBACtC,CAAC,CAAC,EAAE,CAAC;YACP,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,UAAU,EAAE,UAAU;gBACtB,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI;aAC/B,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,yCAAyC,CAAC,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,UAAU,GACd,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,qBAAqB,CAAC;YAC1E,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC;gBAC5D,UAAU;gBACV,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YACH,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,UAAU,EAAE,UAAU;gBACtB,GAAG,qBAAqB,CAAC,eAAe,CAAC;aAC1C,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,0BAA0B,CAAC,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;aAChC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,OAAO,EAAE,OAAO,CAAC,kBAAkB,EAAE;aACtC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CACrD,OAAO,CAAC,MAAM,CAAC,WAAW,CAC3B,CAAC;YACF,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;gBACvC,YAAY;aACb,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,yBAAyB,CAAC,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;gBAClC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;gBAClC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;aAChC,CAAC,CAAC;YACH,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxB,GAAG,MAAM;gBACT,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;gBACvC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;aACxC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,OAAiC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAgC;IAC3D,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA6B;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAkB,CAAC;IAC3C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,OAAoC,CAAC;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,QAAgC;IAS7D,MAAM,KAAK,GAAG,QAAQ;SACnB,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxB,KAAK,EAAE,KAAK,GAAG,CAAC;QAChB,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC;KACtC,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAC9B,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,EACtD,CAAC,CACF,CAAC;IACF,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,UAAU;gBACf,KAAK,EAAE,0BAA0B;gBACjC,KAAK;aACN;SACF;QACD,cAAc,EAAE,KAAK,CAAC,MAAM;QAC5B,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/bin/city/transport/rpc/server/RequestDispatcher.d.ts

@@ -0,0 +1,27 @@
+/**
+ * RPC request dispatcher。
+ *
+ * 关键点（中文）
+ * - server.ts 不直接包含业务 switch，只负责把已解析请求交给这里。
+ * - dispatcher 按命名空间分发，避免 SDK 与 downcity internal 方法混在一起。
+ */
+import type { RpcRequest } from "../../types/RpcProtocol.js";
+import type { RpcRequestHandlerOptions, RpcSocketSubscription, RpcWriteError, RpcWriteEvent, RpcWriteSuccess } from "./ServerTypes.js";
+/**
+ * 分发并执行单个 RPC 请求。
+ */
+export declare function dispatch_rpc_request(params: {
+    /** 当前 RPC 请求。 */
+    request: RpcRequest;
+    /** handler 依赖。 */
+    options: RpcRequestHandlerOptions;
+    /** 当前 socket 的订阅表。 */
+    subscriptions: Map<string, RpcSocketSubscription>;
+    /** 成功帧写入函数。 */
+    write_success: RpcWriteSuccess;
+    /** 失败帧写入函数。 */
+    write_error: RpcWriteError;
+    /** 事件帧写入函数。 */
+    write_event: RpcWriteEvent;
+}): Promise<void>;
+//# sourceMappingURL=RequestDispatcher.d.ts.map

package/bin/city/transport/rpc/server/RequestDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestDispatcher.d.ts","sourceRoot":"","sources":["../../../../../src/city/transport/rpc/server/RequestDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,4CAA4C,CAAC;AAIpD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,iBAAiB;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,kBAAkB;IAClB,OAAO,EAAE,wBAAwB,CAAC;IAClC,sBAAsB;IACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,eAAe;IACf,aAAa,EAAE,eAAe,CAAC;IAC/B,eAAe;IACf,WAAW,EAAE,aAAa,CAAC;IAC3B,eAAe;IACf,WAAW,EAAE,aAAa,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB"}

package/bin/city/transport/rpc/server/RequestDispatcher.js

@@ -0,0 +1,38 @@
+/**
+ * RPC request dispatcher。
+ *
+ * 关键点（中文）
+ * - server.ts 不直接包含业务 switch，只负责把已解析请求交给这里。
+ * - dispatcher 按命名空间分发，避免 SDK 与 downcity internal 方法混在一起。
+ */
+import { handle_sdk_session_rpc_request } from "./SdkSessionHandlers.js";
+import { handle_internal_rpc_request } from "./InternalHandlers.js";
+/**
+ * 分发并执行单个 RPC 请求。
+ */
+export async function dispatch_rpc_request(params) {
+    const { request, options, subscriptions, write_success, write_error, write_event, } = params;
+    try {
+        const handled_by_sdk = await handle_sdk_session_rpc_request({
+            request,
+            options,
+            subscriptions,
+            write_success,
+            write_event,
+        });
+        if (handled_by_sdk)
+            return;
+        const handled_by_internal = await handle_internal_rpc_request({
+            request,
+            options,
+            write_success,
+        });
+        if (handled_by_internal)
+            return;
+        throw new Error(`Unsupported RPC method: ${request.method}`);
+    }
+    catch (error) {
+        write_error(request.id, error);
+    }
+}
+//# sourceMappingURL=RequestDispatcher.js.map

package/bin/city/transport/rpc/server/RequestDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestDispatcher.js","sourceRoot":"","sources":["../../../../../src/city/transport/rpc/server/RequestDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAE9F;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAa1C;IACC,MAAM,EACJ,OAAO,EACP,OAAO,EACP,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,GACZ,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,8BAA8B,CAAC;YAC1D,OAAO;YACP,OAAO;YACP,aAAa;YACb,aAAa;YACb,WAAW;SACZ,CAAC,CAAC;QACH,IAAI,cAAc;YAAE,OAAO;QAE3B,MAAM,mBAAmB,GAAG,MAAM,2BAA2B,CAAC;YAC5D,OAAO;YACP,OAAO;YACP,aAAa;SACd,CAAC,CAAC;QACH,IAAI,mBAAmB;YAAE,OAAO;QAEhC,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/bin/city/transport/rpc/server/SdkSessionHandlers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * RPC SDK session handlers。
+ *
+ * 关键点（中文）
+ * - 只处理 `sdk.sessions.*` 方法。
+ * - 这些方法是 RemoteAgent RPC transport 的稳定 SDK 面。
+ */
+import type { RpcRequest } from "../../types/RpcProtocol.js";
+import type { RpcSocketSubscription, RpcWriteEvent, RpcWriteSuccess, RpcRequestHandlerOptions } from "./ServerTypes.js";
+/**
+ * 处理 SDK session RPC 请求。
+ */
+export declare function handle_sdk_session_rpc_request(params: {
+    /** 当前 RPC 请求。 */
+    request: RpcRequest;
+    /** handler 依赖。 */
+    options: RpcRequestHandlerOptions;
+    /** 当前 socket 的订阅表。 */
+    subscriptions: Map<string, RpcSocketSubscription>;
+    /** 成功帧写入函数。 */
+    write_success: RpcWriteSuccess;
+    /** 事件帧写入函数。 */
+    write_event: RpcWriteEvent;
+}): Promise<boolean>;
+//# sourceMappingURL=SdkSessionHandlers.d.ts.map

package/bin/city/transport/rpc/server/SdkSessionHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkSessionHandlers.d.ts","sourceRoot":"","sources":["../../../../../src/city/transport/rpc/server/SdkSessionHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,wBAAwB,EACzB,MAAM,4CAA4C,CAAC;AAGpD;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,MAAM,EAAE;IAC3D,iBAAiB;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,kBAAkB;IAClB,OAAO,EAAE,wBAAwB,CAAC;IAClC,sBAAsB;IACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,eAAe;IACf,aAAa,EAAE,eAAe,CAAC;IAC/B,eAAe;IACf,WAAW,EAAE,aAAa,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,CAAC,CAsInB"}