@downcity/agent 1.1.338 → 1.1.400

package/bin/city/transport/SerializedTransport.js

@@ -0,0 +1,57 @@
+/**
+ * 串行 transport 生命周期。
+ *
+ * 该对象是 HTTP/RPC Server 状态的唯一拥有者。listen 与 close 按调用顺序执行，
+ * 因此启动过程中收到 close 时，会先完成启动再立即释放，不会留下失联端口。
+ */
+/** 管理一个可重复监听和关闭的底层 transport。 */
+export class SerializedTransport {
+    options;
+    /** transport 操作的唯一串行链。 */
+    operation_chain = Promise.resolve();
+    /** 当前已经成功启动的底层资源。 */
+    current_resource = null;
+    /** 当前监听地址；未监听时为空。 */
+    current_binding = null;
+    constructor(
+    /** 创建和释放底层资源的实现。 */
+    options) {
+        this.options = options;
+    }
+    /** 按调用顺序启动 transport；已监听时返回现有 binding。 */
+    async listen(options) {
+        return await this.enqueue(async () => {
+            if (this.current_binding)
+                return this.current_binding;
+            const started = await this.options.start(options);
+            this.current_resource = started.resource;
+            this.current_binding = started.binding;
+            return started.binding;
+        });
+    }
+    /** 按调用顺序关闭 transport；没有监听时直接完成。 */
+    async close() {
+        await this.enqueue(async () => {
+            const resource = this.current_resource;
+            if (!resource)
+                return;
+            await this.options.stop(resource);
+            // 释放成功后才提交 stopped 状态；失败时保留句柄，允许调用方重试收口。
+            if (this.current_resource === resource) {
+                this.current_resource = null;
+                this.current_binding = null;
+            }
+        });
+    }
+    /** 返回当前已完成监听的 binding 快照。 */
+    binding() {
+        return this.current_binding;
+    }
+    /** 将一次状态变化接到唯一操作链，并保证失败后后续操作仍可继续。 */
+    enqueue(operation) {
+        const result = this.operation_chain.then(operation);
+        this.operation_chain = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+//# sourceMappingURL=SerializedTransport.js.map

package/bin/city/transport/SerializedTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializedTransport.js","sourceRoot":"","sources":["../../../src/city/transport/SerializedTransport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,iCAAiC;AACjC,MAAM,OAAO,mBAAmB;IAYX;IAXnB,0BAA0B;IAClB,eAAe,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAE3D,qBAAqB;IACb,gBAAgB,GAAqB,IAAI,CAAC;IAElD,qBAAqB;IACb,eAAe,GAAoB,IAAI,CAAC;IAEhD;IACE,oBAAoB;IACH,OAAkE;QAAlE,YAAO,GAAP,OAAO,CAA2D;IAClF,CAAC;IAEJ,0CAA0C;IAC1C,KAAK,CAAC,MAAM,CAAC,OAAiB;QAC5B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;YACnC,IAAI,IAAI,CAAC,eAAe;gBAAE,OAAO,IAAI,CAAC,eAAe,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;YACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;YACvC,OAAO,OAAO,CAAC,OAAO,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACvC,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,yCAAyC;YACzC,IAAI,IAAI,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;gBACvC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAC7B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,OAAO;QACL,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,qCAAqC;IAC7B,OAAO,CAAU,SAAiC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,IAAI,CAChC,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/bin/city/transport/http/AgentHTTP.d.ts

@@ -0,0 +1,66 @@
+/**
+ * AgentHTTP：把本地 Agent 暴露为最小 SDK HTTP 面的对外类。
+ *
+ * 关键点（中文）
+ * - 仅承载 RemoteAgent 对应的 SDK transport（`/api/sdk/sessions/*`）。
+ * - `router()` 返回一个 `Hono` 子路由，调用方 `app.route("/", agent_http.router())` 即可挂载。
+ * - `server()` 返回一个独立 HTTP server 句柄，按需自启、自停。
+ * - 同一个实例多次取 router/server 都返回缓存对象，避免重复注册。
+ */
+import { Hono } from "hono";
+import type { Agent } from "../../../agent/Agent.js";
+import type { WorkspaceBase } from "@downcity/workspace";
+import type { AgentPlugins } from "../../../types/plugin/PluginRuntime.js";
+import type { AgentHttpBinding, AgentHttpListenOptions } from "../types/AgentHttpBinding.js";
+import type { AgentHttpRuntimeOptions } from "../types/AgentHttpRuntime.js";
+/**
+ * AgentHTTP server 句柄。
+ */
+export interface AgentHttpServerHandle {
+    /** 监听 HTTP 端口。 */
+    listen(options: AgentHttpListenOptions): Promise<AgentHttpBinding>;
+    /** 关闭当前 HTTP server。 */
+    close(): Promise<void>;
+    /** 当前监听绑定信息，未 listen 时为 `null`。 */
+    binding(): AgentHttpBinding | null;
+}
+/**
+ * 把一个 `WorkspaceEntry` 暴露为最小 SDK HTTP 面。
+ */
+export declare class AgentHTTP {
+    private readonly agent;
+    private readonly workspace?;
+    private readonly plugins;
+    private readonly session_collection;
+    private readonly runtime_options;
+    private cached_router;
+    private cached_server;
+    constructor(agent_or_workspace: Agent | {
+        agent: Agent;
+        workspace: WorkspaceBase;
+        plugins: AgentPlugins;
+    }, workspace_or_options?: WorkspaceBase | AgentHttpRuntimeOptions, runtime_options?: AgentHttpRuntimeOptions);
+    /**
+     * 返回一个挂载到外部 hono server 用的子路由。
+     *
+     * 说明（中文）
+     * - 多次调用返回同一个 hono 实例，避免重复注册。
+     * - 不在这里附加 CORS / logger，由调用方按需在自己的入口 hono 上挂中间件。
+     */
+    router(): Hono;
+    /**
+     * 返回独立 HTTP server 句柄。
+     */
+    server(): AgentHttpServerHandle;
+    /**
+     * 关闭通过本实例 `server()` 启动的 HTTP server。
+     *
+     * 说明（中文）
+     * - 仅作用于 `server()` 创建的独立 HTTP server。
+     * - `router()` 挂到外部 hono 的场景由调用方自己管理生命周期。
+     */
+    close(): Promise<void>;
+}
+/** 为已装配完成的 Hono Router 创建独立 Node HTTP Server 句柄。 */
+export declare function create_agent_http_server_handle(app: Hono): AgentHttpServerHandle;
+//# sourceMappingURL=AgentHTTP.d.ts.map

package/bin/city/transport/http/AgentHTTP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHTTP.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/http/AgentHTTP.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAKpE,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAI1F;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kBAAkB;IAClB,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnE,wBAAwB;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,mCAAmC;IACnC,OAAO,IAAI,gBAAgB,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,aAAa,CAAsC;gBAGzD,kBAAkB,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,EAC7F,oBAAoB,CAAC,EAAE,aAAa,GAAG,uBAAuB,EAC9D,eAAe,GAAE,uBAA4B;IAuB/C;;;;;;OAMG;IACH,MAAM,IAAI,IAAI;IAWd;;OAEG;IACH,MAAM,IAAI,qBAAqB;IAO/B;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED,oDAAoD;AACpD,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,IAAI,GAAG,qBAAqB,CAqDhF"}

package/bin/city/transport/http/AgentHTTP.js

@@ -0,0 +1,142 @@
+/**
+ * AgentHTTP：把本地 Agent 暴露为最小 SDK HTTP 面的对外类。
+ *
+ * 关键点（中文）
+ * - 仅承载 RemoteAgent 对应的 SDK transport（`/api/sdk/sessions/*`）。
+ * - `router()` 返回一个 `Hono` 子路由，调用方 `app.route("/", agent_http.router())` 即可挂载。
+ * - `server()` 返回一个独立 HTTP server 句柄，按需自启、自停。
+ * - 同一个实例多次取 router/server 都返回缓存对象，避免重复注册。
+ */
+import { Hono } from "hono";
+import { create_workspace_entry } from "../../../internal/index.js";
+import { register_sdk_session_routes } from "./routes/SessionRoutes.js";
+import { register_runtime_routes } from "./routes/RuntimeRoutes.js";
+import { create_node_http_server } from "./NodeHttpAdapter.js";
+import { SerializedTransport } from "../SerializedTransport.js";
+const DEFAULT_HTTP_HOST = "127.0.0.1";
+/**
+ * 把一个 `WorkspaceEntry` 暴露为最小 SDK HTTP 面。
+ */
+export class AgentHTTP {
+    agent;
+    workspace;
+    plugins;
+    session_collection;
+    runtime_options;
+    cached_router = null;
+    cached_server = null;
+    constructor(agent_or_workspace, workspace_or_options, runtime_options = {}) {
+        if (workspace_or_options && "id" in workspace_or_options && "path" in workspace_or_options) {
+            const agent = "agent" in agent_or_workspace ? agent_or_workspace.agent : agent_or_workspace;
+            this.agent = agent;
+            this.workspace = workspace_or_options;
+            this.plugins = "agent" in agent_or_workspace
+                ? agent_or_workspace.plugins
+                : create_workspace_entry(agent, workspace_or_options).plugins;
+            this.session_collection = create_workspace_entry(agent, workspace_or_options).sessions;
+            this.runtime_options = runtime_options;
+            return;
+        }
+        const entry = agent_or_workspace;
+        this.agent = entry.agent || agent_or_workspace;
+        this.workspace = entry.workspace;
+        this.plugins = entry.plugins || this.agent.plugins;
+        this.session_collection = this.workspace
+            ? create_workspace_entry(this.agent, this.workspace).sessions
+            : this.agent.sessions;
+        this.runtime_options = workspace_or_options ?? {};
+    }
+    /**
+     * 返回一个挂载到外部 hono server 用的子路由。
+     *
+     * 说明（中文）
+     * - 多次调用返回同一个 hono 实例，避免重复注册。
+     * - 不在这里附加 CORS / logger，由调用方按需在自己的入口 hono 上挂中间件。
+     */
+    router() {
+        if (this.cached_router)
+            return this.cached_router;
+        const router = new Hono();
+        register_sdk_session_routes(router, this.session_collection, this.workspace, {
+            resolve_session_model: this.runtime_options.resolve_session_model,
+        });
+        register_runtime_routes(router, this.plugins);
+        this.cached_router = router;
+        return router;
+    }
+    /**
+     * 返回独立 HTTP server 句柄。
+     */
+    server() {
+        if (this.cached_server)
+            return this.cached_server;
+        const handle = create_agent_http_server_handle(this.router());
+        this.cached_server = handle;
+        return handle;
+    }
+    /**
+     * 关闭通过本实例 `server()` 启动的 HTTP server。
+     *
+     * 说明（中文）
+     * - 仅作用于 `server()` 创建的独立 HTTP server。
+     * - `router()` 挂到外部 hono 的场景由调用方自己管理生命周期。
+     */
+    async close() {
+        const handle = this.cached_server;
+        if (!handle)
+            return;
+        await handle.close();
+    }
+}
+/** 为已装配完成的 Hono Router 创建独立 Node HTTP Server 句柄。 */
+export function create_agent_http_server_handle(app) {
+    const lifecycle = new SerializedTransport({
+        start: async (options) => {
+            const host = String(options.host || DEFAULT_HTTP_HOST).trim() || DEFAULT_HTTP_HOST;
+            const port = options.port;
+            if (!Number.isInteger(port) || port <= 0 || port > 65535) {
+                throw new Error("AgentHTTP server requires a valid TCP port");
+            }
+            const server = create_node_http_server({ app, host, port });
+            await new Promise((resolve, reject) => {
+                const on_error = (error) => {
+                    server.off("error", on_error);
+                    // listen 失败时该 Server 不会进入生命周期对象，立即清理监听器和句柄。
+                    try {
+                        server.close();
+                    }
+                    catch {
+                        // 未进入监听态时 close 可能抛出 ERR_SERVER_NOT_RUNNING，可安全忽略。
+                    }
+                    reject(error);
+                };
+                server.once("error", on_error);
+                server.listen(port, host, () => {
+                    server.off("error", on_error);
+                    resolve();
+                });
+            });
+            return {
+                resource: server,
+                binding: { url: `http://${host}:${port}`, host, port },
+            };
+        },
+        stop: async (server) => {
+            await new Promise((resolve, reject) => {
+                server.close((error) => error ? reject(error) : resolve());
+            });
+        },
+    });
+    return {
+        async listen(options) {
+            return await lifecycle.listen(options);
+        },
+        async close() {
+            await lifecycle.close();
+        },
+        binding() {
+            return lifecycle.binding();
+        },
+    };
+}
+//# sourceMappingURL=AgentHTTP.js.map

package/bin/city/transport/http/AgentHTTP.js.map

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

package/bin/city/transport/http/CityHTTP.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CityHTTP：在一个 HTTP Server 上暴露 City 持有的全部 Agent。
+ *
+ * 每个执行作用域固定挂载到 `/agents/<agent_id>/workspaces/<workspace_id>`。
+ * `RemoteAgent`，transport 只负责路由，不复制 Agent 或 Session 状态。
+ */
+import { Hono } from "hono";
+import type { City } from "../../runtime/City.js";
+import { type AgentHttpServerHandle } from "./AgentHTTP.js";
+import type { CityHttpRuntimeOptions } from "../types/CityHttpRuntime.js";
+import type { AgentHttpBinding, AgentHttpListenOptions } from "../types/AgentHttpBinding.js";
+/** 在单一 HTTP 端口暴露 City 的多 Agent transport。 */
+export declare class CityHTTP {
+    private readonly city;
+    private readonly runtime_options;
+    private readonly routers_by_workspace;
+    private readonly extension_disposers;
+    /** 每个 Agent 路由装配与释放的独立串行链。 */
+    private readonly agent_operation_chains;
+    private cached_router;
+    private cached_server;
+    constructor(city: City, runtime_options?: CityHttpRuntimeOptions);
+    /** 返回按 Agent ID 分区的 Hono Router。 */
+    router(): Hono;
+    /** 返回 City 级 HTTP Server 句柄。 */
+    server(): AgentHttpServerHandle;
+    /** 监听 City 级 HTTP 端口。 */
+    listen(options: AgentHttpListenOptions): Promise<AgentHttpBinding>;
+    /** 返回当前监听绑定；尚未监听时返回 null。 */
+    binding(): AgentHttpBinding | null;
+    /** 幂等关闭独立启动的 HTTP Server。 */
+    close(): Promise<void>;
+    /** 立即释放指定 Agent 的宿主扩展并清除路由缓存。 */
+    detach_agent(agent_id_input: string): Promise<void>;
+    /** 释放一个 WorkspaceEntry 路由对应的宿主扩展。 */
+    private detach_route;
+    /** 按请求中的 Agent ID 动态选择子路由，保证运行中新增 Agent 立即可见。 */
+    private dispatch_workspace;
+    /** 串行解析或创建指定 Agent 的唯一 Router。 */
+    private resolve_workspace_router;
+    /** 按 Agent ID 串行执行路由装配或释放，并在完成后清理空闲链。 */
+    private enqueue_agent_operation;
+}
+//# sourceMappingURL=CityHTTP.d.ts.map

package/bin/city/transport/http/CityHTTP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityHTTP.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/http/CityHTTP.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,4CAA4C,CAAC;AAGpD,6CAA6C;AAC7C,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsD;IAC3F,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAiD;IACrF,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoC;IAC3E,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,aAAa,CAAsC;gBAE/C,IAAI,EAAE,IAAI,EAAE,eAAe,GAAE,sBAA2B;IAKpE,oCAAoC;IACpC,MAAM,IAAI,IAAI;IAgBd,gCAAgC;IAChC,MAAM,IAAI,qBAAqB;IAM/B,yBAAyB;IACnB,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIxE,6BAA6B;IAC7B,OAAO,IAAI,gBAAgB,GAAG,IAAI;IAIlC,6BAA6B;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,iCAAiC;IAC3B,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzD,qCAAqC;YACvB,YAAY;IAW1B,iDAAiD;YACnC,kBAAkB;IAqBhC,kCAAkC;YACpB,wBAAwB;IAwCtC,yCAAyC;IACzC,OAAO,CAAC,uBAAuB;CAkBhC"}

package/bin/city/transport/http/CityHTTP.js

@@ -0,0 +1,171 @@
+/**
+ * CityHTTP：在一个 HTTP Server 上暴露 City 持有的全部 Agent。
+ *
+ * 每个执行作用域固定挂载到 `/agents/<agent_id>/workspaces/<workspace_id>`。
+ * `RemoteAgent`，transport 只负责路由，不复制 Agent 或 Session 状态。
+ */
+import { Hono } from "hono";
+import { AgentHTTP, create_agent_http_server_handle, } from "./AgentHTTP.js";
+import { get_workspace_entry } from "../../../internal/index.js";
+/** 在单一 HTTP 端口暴露 City 的多 Agent transport。 */
+export class CityHTTP {
+    city;
+    runtime_options;
+    routers_by_workspace = new Map();
+    extension_disposers = new Map();
+    /** 每个 Agent 路由装配与释放的独立串行链。 */
+    agent_operation_chains = new Map();
+    cached_router = null;
+    cached_server = null;
+    constructor(city, runtime_options = {}) {
+        this.city = city;
+        this.runtime_options = runtime_options;
+    }
+    /** 返回按 Agent ID 分区的 Hono Router。 */
+    router() {
+        if (this.cached_router)
+            return this.cached_router;
+        const root = new Hono();
+        root.all("/agents/:agent_id/workspaces/:workspace_id", async (context) => await this.dispatch_workspace(context));
+        root.all("/agents/:agent_id/workspaces/:workspace_id/*", async (context) => await this.dispatch_workspace(context));
+        if (this.runtime_options.city_router)
+            root.route("/", this.runtime_options.city_router);
+        root.get("/internal/status", (context) => context.json({
+            success: true,
+            status: "ok",
+            pid: process.pid,
+            agent_ids: this.city.agents.list().map((agent) => agent.id),
+        }));
+        this.cached_router = root;
+        return root;
+    }
+    /** 返回 City 级 HTTP Server 句柄。 */
+    server() {
+        if (this.cached_server)
+            return this.cached_server;
+        this.cached_server = create_agent_http_server_handle(this.router());
+        return this.cached_server;
+    }
+    /** 监听 City 级 HTTP 端口。 */
+    async listen(options) {
+        return await this.server().listen(options);
+    }
+    /** 返回当前监听绑定；尚未监听时返回 null。 */
+    binding() {
+        return this.cached_server?.binding() ?? null;
+    }
+    /** 幂等关闭独立启动的 HTTP Server。 */
+    async close() {
+        const server = this.cached_server;
+        const server_results = server
+            ? await Promise.allSettled([server.close()])
+            : [];
+        const route_keys = new Set([
+            ...this.routers_by_workspace.keys(),
+            ...this.extension_disposers.keys(),
+        ]);
+        const results = await Promise.allSettled([...route_keys].map(async (route_key) => await this.detach_route(route_key)));
+        const errors = [...server_results, ...results].flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+        if (errors.length > 0)
+            throw new AggregateError(errors, "CityHTTP extension close failed");
+    }
+    /** 立即释放指定 Agent 的宿主扩展并清除路由缓存。 */
+    async detach_agent(agent_id_input) {
+        const agent_id = String(agent_id_input || "").trim();
+        if (!agent_id)
+            return;
+        const route_keys = new Set([
+            ...[...this.routers_by_workspace.keys()].filter((key) => key.startsWith(`${agent_id}/`)),
+            ...[...this.extension_disposers.keys()].filter((key) => key.startsWith(`${agent_id}/`)),
+        ]);
+        await Promise.all([...route_keys].map(async (route_key) => await this.detach_route(route_key)));
+    }
+    /** 释放一个 WorkspaceEntry 路由对应的宿主扩展。 */
+    async detach_route(route_key) {
+        await this.enqueue_agent_operation(route_key, async () => {
+            const dispose = this.extension_disposers.get(route_key);
+            if (dispose)
+                await dispose();
+            this.routers_by_workspace.delete(route_key);
+            if (this.extension_disposers.get(route_key) === dispose) {
+                this.extension_disposers.delete(route_key);
+            }
+        });
+    }
+    /** 按请求中的 Agent ID 动态选择子路由，保证运行中新增 Agent 立即可见。 */
+    async dispatch_workspace(context) {
+        const agent_id = decodeURIComponent(String(context.req.param("agent_id") || "")).trim();
+        const workspace_id = decodeURIComponent(String(context.req.param("workspace_id") || "")).trim();
+        const agent = this.city.agents.get(agent_id);
+        if (!agent)
+            return context.json({ success: false, error: `Agent not found: ${agent_id}` }, 404);
+        const entry = await this.city.enter_workspace(agent_id, workspace_id)
+            .catch(() => null);
+        if (!entry)
+            return context.json({
+                success: false,
+                error: `Workspace not found: ${workspace_id}`,
+            }, 404);
+        const router = await this.resolve_workspace_router(agent_id, workspace_id, entry);
+        if (!router) {
+            return context.json({ success: false, error: `Agent not found: ${agent_id}` }, 404);
+        }
+        const url = new URL(context.req.url);
+        const prefix = `/agents/${encodeURIComponent(agent_id)}/workspaces/${encodeURIComponent(workspace_id)}`;
+        url.pathname = url.pathname.slice(prefix.length) || "/";
+        return await router.fetch(new Request(url, context.req.raw));
+    }
+    /** 串行解析或创建指定 Agent 的唯一 Router。 */
+    async resolve_workspace_router(agent_id, workspace_id, entry) {
+        const route_key = `${agent_id}/${workspace_id}`;
+        return await this.enqueue_agent_operation(route_key, async () => {
+            // Agent 可能在请求排队期间被 City 删除，装配前必须重新确认所有权。
+            const agent = this.city.agents.get(agent_id);
+            if (!agent || get_workspace_entry(agent, workspace_id) !== entry)
+                return null;
+            const cached = this.routers_by_workspace.get(route_key);
+            if (cached && cached.entry === entry)
+                return cached.router;
+            if (cached) {
+                const dispose = this.extension_disposers.get(route_key);
+                if (dispose)
+                    await dispose();
+                this.routers_by_workspace.delete(route_key);
+                if (this.extension_disposers.get(route_key) === dispose) {
+                    this.extension_disposers.delete(route_key);
+                }
+            }
+            const resolve_session_model = this.runtime_options.resolve_session_model;
+            const sdk_router = new AgentHTTP(agent, entry.workspace, {
+                resolve_session_model: resolve_session_model
+                    ? async (model_id) => await resolve_session_model(agent_id, workspace_id, model_id)
+                    : undefined,
+            }).router();
+            const extension = this.runtime_options.create_agent_extension?.({
+                agent: entry.agent,
+                workspace: entry.workspace,
+                plugins: entry.plugins,
+                sdk_router,
+            });
+            const router = extension?.router ?? sdk_router;
+            this.routers_by_workspace.set(route_key, { entry, router });
+            if (extension?.dispose)
+                this.extension_disposers.set(route_key, extension.dispose);
+            return router;
+        });
+    }
+    /** 按 Agent ID 串行执行路由装配或释放，并在完成后清理空闲链。 */
+    enqueue_agent_operation(agent_id, operation) {
+        const previous = this.agent_operation_chains.get(agent_id) ?? Promise.resolve();
+        const result = previous.then(operation);
+        const settled = result.then(() => undefined, () => undefined);
+        this.agent_operation_chains.set(agent_id, settled);
+        void settled.finally(() => {
+            if (this.agent_operation_chains.get(agent_id) === settled) {
+                this.agent_operation_chains.delete(agent_id);
+            }
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=CityHTTP.js.map

package/bin/city/transport/http/CityHTTP.js.map

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

package/bin/city/transport/http/NodeHttpAdapter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hono 与 Node http server 的最小适配层。
+ *
+ * 关键点（中文）
+ * - 该适配层只承担 Fetch API <-> Node http 的桥接。
+ * - AgentHTTP 通过它跑成独立 Node HTTP server。
+ */
+import http from "node:http";
+/**
+ * 最小 Fetch API 应用接口。
+ */
+export interface NodeFetchApp {
+    /** 处理一次 Fetch API 请求。 */
+    fetch(request: Request): Response | Promise<Response>;
+}
+/**
+ * 创建一个把 hono fetch 接到 node http 的 server。
+ */
+export declare function create_node_http_server(params: {
+    /** 入口 Fetch API 应用。 */
+    app: NodeFetchApp;
+    /** 监听主机。 */
+    host: string;
+    /** 监听端口。 */
+    port: number;
+}): http.Server;
+//# sourceMappingURL=NodeHttpAdapter.d.ts.map

package/bin/city/transport/http/NodeHttpAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeHttpAdapter.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/http/NodeHttpAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,uBAAuB;IACvB,GAAG,EAAE,YAAY,CAAC;IAClB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,IAAI,CAAC,MAAM,CAiCd"}

package/bin/city/transport/http/NodeHttpAdapter.js

@@ -0,0 +1,57 @@
+/**
+ * Hono 与 Node http server 的最小适配层。
+ *
+ * 关键点（中文）
+ * - 该适配层只承担 Fetch API <-> Node http 的桥接。
+ * - AgentHTTP 通过它跑成独立 Node HTTP server。
+ */
+import http from "node:http";
+import { Readable } from "node:stream";
+import { finished } from "node:stream/promises";
+/**
+ * 创建一个把 hono fetch 接到 node http 的 server。
+ */
+export function create_node_http_server(params) {
+    const { app, host, port } = params;
+    return http.createServer(async (req, res) => {
+        try {
+            const url = new URL(req.url || "/", `http://${host}:${port}`);
+            const method = req.method || "GET";
+            const body_buffer = await read_request_body(req);
+            const body_allowed = method !== "GET" && method !== "HEAD";
+            const request = new Request(url.toString(), {
+                method,
+                headers: new Headers(req.headers),
+                body: body_allowed && body_buffer.length > 0 ? body_buffer : undefined,
+            });
+            const response = await app.fetch(request);
+            res.statusCode = response.status;
+            for (const [key, value] of response.headers.entries()) {
+                res.setHeader(key, value);
+            }
+            if (!response.body) {
+                res.end();
+                return;
+            }
+            const body_stream = Readable.fromWeb(response.body);
+            body_stream.pipe(res);
+            await finished(body_stream).catch(() => undefined);
+        }
+        catch {
+            res.statusCode = 500;
+            res.end("Internal Server Error");
+        }
+    });
+}
+/**
+ * 读取 Node 原生请求体。
+ */
+async function read_request_body(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", reject);
+    });
+}
+//# sourceMappingURL=NodeHttpAdapter.js.map

package/bin/city/transport/http/NodeHttpAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeHttpAdapter.js","sourceRoot":"","sources":["../../../../src/city/transport/http/NodeHttpAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAShD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAOvC;IACC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACnC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;YACnC,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC;YAC3D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC1C,MAAM;gBACN,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,OAAiC,CAAC;gBAC3D,IAAI,EAAE,YAAY,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aACvE,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAClC,QAAQ,CAAC,IAAwD,CAClE,CAAC;YACF,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,GAAyB;IACxD,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/bin/city/transport/http/routes/RuntimeRoutes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * RemoteAgent runtime HTTP 路由。
+ *
+ * 关键点（中文）
+ * - 与 SessionRoutes 一起构成独立 AgentHTTP 的完整 RemoteAgent HTTP 调用面。
+ * - 只暴露 Agent 级 plugin action；Shell approval 已归属具体 Session。
+ * - CLI 可叠加自己的控制面路由，但不依赖这些路由承载平台语义。
+ */
+import type { Hono } from "hono";
+import type { AgentPlugins } from "../../../../types/plugin/PluginRuntime.js";
+/**
+ * 注册 RemoteAgent 顶层 runtime 路由。
+ */
+export declare function register_runtime_routes(app: Hono, plugins: AgentPlugins): void;
+//# sourceMappingURL=RuntimeRoutes.d.ts.map

package/bin/city/transport/http/routes/RuntimeRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeRoutes.d.ts","sourceRoot":"","sources":["../../../../../src/city/transport/http/routes/RuntimeRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAkC9E"}