@downcity/agent 1.1.337 → 1.1.399

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

@@ -0,0 +1,146 @@
+/**
+ * RPC SDK session handlers。
+ *
+ * 关键点（中文）
+ * - 只处理 `sdk.sessions.*` 方法。
+ * - 这些方法是 RemoteAgent RPC transport 的稳定 SDK 面。
+ */
+import { resolve_remote_session_set_input } from "../../session/RemoteSessionConfig.js";
+/**
+ * 处理 SDK session RPC 请求。
+ */
+export async function handle_sdk_session_rpc_request(params) {
+    const { request, options, subscriptions, write_success, write_event } = params;
+    switch (request.method) {
+        case "sdk.sessions.list": {
+            const page = await options.sessions.list(request.params);
+            write_success(request.id, { page });
+            return true;
+        }
+        case "sdk.sessions.create": {
+            const session = await options.sessions.create(request.params);
+            write_success(request.id, { session: await session.get_info() });
+            return true;
+        }
+        case "sdk.sessions.get": {
+            const session = await options.sessions.get(request.params.session_id);
+            write_success(request.id, { session: await session.get_info() });
+            return true;
+        }
+        case "sdk.sessions.prompt": {
+            const session = await options.sessions.get(request.params.session_id);
+            const turn = await session.prompt(request.params.input);
+            write_success(request.id, { turn: { id: turn.id } });
+            return true;
+        }
+        case "sdk.sessions.stop": {
+            const session = await options.sessions.get(request.params.session_id);
+            const result = await session.stop();
+            write_success(request.id, { result });
+            return true;
+        }
+        case "sdk.sessions.compact": {
+            const session = await options.sessions.get(request.params.session_id);
+            const compact = await session.compact();
+            write_success(request.id, { compact: { id: compact.id } });
+            return true;
+        }
+        case "sdk.sessions.messages": {
+            const session = await options.sessions.get(request.params.session_id);
+            const messages = await session.messages(request.params.input);
+            write_success(request.id, { messages });
+            return true;
+        }
+        case "sdk.sessions.interactions": {
+            const session = await options.sessions.get(request.params.session_id);
+            write_success(request.id, { interactions: await session.interactions() });
+            return true;
+        }
+        case "sdk.sessions.status": {
+            const session = await options.sessions.get(request.params.session_id);
+            write_success(request.id, { status: await session.status() });
+            return true;
+        }
+        case "sdk.sessions.set": {
+            const session = await options.sessions.get(request.params.session_id);
+            const input = await resolve_remote_session_set_input({
+                config: request.params.input,
+                resolve_session_model: options.resolve_session_model,
+            });
+            await session.set(input, request.params.options);
+            write_success(request.id, { queued: true });
+            return true;
+        }
+        case "sdk.sessions.respond": {
+            const session = await options.sessions.get(request.params.session_id);
+            write_success(request.id, {
+                result: await session.respond(request.params.input),
+            });
+            return true;
+        }
+        case "sdk.sessions.system": {
+            const session = await options.sessions.get(request.params.session_id);
+            write_success(request.id, { system: await session.system() });
+            return true;
+        }
+        case "sdk.sessions.fork": {
+            const session = await options.sessions.get(request.params.session_id);
+            const forked = await session.fork(request.params.message_id ? {
+                message_id: request.params.message_id,
+                include_message: request.params.include_message,
+            } : undefined);
+            write_success(request.id, { session: await forked.get_info() });
+            return true;
+        }
+        case "sdk.sessions.subscribe": {
+            const session = await options.sessions.get(request.params.session_id);
+            const subscription_id = [
+                request.params.session_id,
+                Date.now(),
+                Math.random().toString(36).slice(2, 10),
+            ].join(":");
+            const unsubscribe = session.subscribe((event) => {
+                write_event({
+                    type: "event",
+                    subscription_id: subscription_id,
+                    event,
+                });
+            });
+            subscriptions.set(subscription_id, {
+                session_id: request.params.session_id,
+                unsubscribe,
+            });
+            write_success(request.id, { subscription_id: subscription_id });
+            return true;
+        }
+        case "sdk.sessions.unsubscribe": {
+            const subscription = subscriptions.get(request.params.subscription_id);
+            if (subscription) {
+                subscription.unsubscribe();
+                subscriptions.delete(request.params.subscription_id);
+            }
+            write_success(request.id, { unsubscribed: true });
+            return true;
+        }
+        case "sdk.sessions.archive": {
+            const result = await options.sessions.archive({
+                id: request.params.session_id,
+            });
+            write_success(request.id, { result });
+            return true;
+        }
+        case "sdk.sessions.archived.list": {
+            const page = await options.sessions.archived(request.params);
+            write_success(request.id, { page });
+            return true;
+        }
+        case "sdk.sessions.archived.clean": {
+            const result = await options.sessions.clean_archive();
+            write_success(request.id, { removed_session_ids: result.removed_session_ids });
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=SdkSessionHandlers.js.map

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

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

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

@@ -0,0 +1,94 @@
+/**
+ * Agent RPC server 内部类型。
+ *
+ * 关键点（中文）
+ * - 这里描述 handler 需要的依赖，不承载 socket 生命周期。
+ * - `RpcServer.ts` 负责网络层，handler 把协议方法转成 Agent 操作。
+ */
+import type { AgentSessionCollection } from "../../../../types/agent/AgentSessionCollection.js";
+import type { Agent } from "../../../../agent/Agent.js";
+import type { AgentPlugins } from "../../../../types/plugin/PluginRuntime.js";
+import type { PluginSnapshot } from "../../../../types/plugin/PluginState.js";
+import type { WorkspaceBase } from "@downcity/workspace";
+import type { SessionSystemMessage } from "../../../../executor/types/SessionPrompts.js";
+import type { RpcEventFrame } from "../../types/RpcProtocol.js";
+import type { AgentSessionModelResolver } from "../../types/AgentSessionModelResolver.js";
+/**
+ * RPC server 启动参数。
+ */
+export interface RpcServerStartOptions {
+    /** RPC 服务监听端口。 */
+    port: number;
+    /** RPC 服务监听主机。 */
+    host: string;
+    /** Session 集合访问口。 */
+    sessions: AgentSessionCollection;
+    /** 当前请求对应的 Agent 执行能力。 */
+    get_agent_context?: () => RpcAgentContext;
+    /** 将远程模型 ID 解析为当前宿主可执行的模型实例。 */
+    resolve_session_model?: AgentSessionModelResolver;
+    /** 由宿主重新加载并提交 Workspace Env 的能力。 */
+    reload_workspace_env?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** 按请求选择 Agent 级 handler 依赖；CityRPC 使用该入口完成多 Agent 路由。 */
+    resolve_request_options?: (request: import("../../types/RpcProtocol.js").RpcRequest) => RpcRequestHandlerOptions | Promise<RpcRequestHandlerOptions>;
+}
+/**
+ * RPC request handler 依赖。
+ */
+export interface RpcRequestHandlerOptions {
+    /** Session 集合访问口。 */
+    sessions: AgentSessionCollection;
+    /** 当前请求对应的 Agent 执行能力。 */
+    get_agent_context?: () => RpcAgentContext;
+    /** 将远程模型 ID 解析为当前宿主可执行的模型实例。 */
+    resolve_session_model?: AgentSessionModelResolver;
+    /** 由宿主重新加载并提交 Workspace Env 的能力。 */
+    reload_workspace_env?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** 返回 City 宿主身份；仅 CityRPC 提供。 */
+    get_city_status?: () => {
+        /** 当前 City 加载的 Agent ID。 */
+        agent_ids: string[];
+    };
+    /** 请求当前宿主优雅退出。 */
+    shutdown_city?: () => void | Promise<void>;
+}
+/**
+ * RPC internal handler 所需的最小 Agent 能力集合。
+ *
+ * 这是传输层的依赖投影，不是新的领域对象，也不拥有 Agent 或 Session。
+ */
+export interface RpcAgentContext {
+    /** 当前 Agent 实例。 */
+    agent: Agent;
+    /** 当前请求绑定的 Workspace。 */
+    workspace: WorkspaceBase;
+    /** 当前 Agent 唯一的 Session 集合。 */
+    sessions: AgentSessionCollection;
+    /** 当前 Agent 在 Workspace 中可用的 Plugin 调用面。 */
+    plugins: AgentPlugins;
+    /** 读取当前 Agent 的 Plugin 状态。 */
+    list_plugin_states: () => PluginSnapshot[];
+    /** 解析当前 Session 的 system messages。 */
+    resolve_system_messages: (input: {
+        /** 目标 Session ID。 */
+        session_id: string;
+        /** system message profile。 */
+        profile?: "chat" | "task";
+    }) => Promise<SessionSystemMessage[]>;
+}
+/**
+ * 单个 socket 上的 session 订阅。
+ */
+export interface RpcSocketSubscription {
+    /** 被订阅的 session id。 */
+    session_id: string;
+    /** 取消订阅函数。 */
+    unsubscribe: () => void;
+}
+/** 写入 RPC 成功帧。 */
+export type RpcWriteSuccess = (id: string, data?: unknown) => void;
+/** 写入 RPC 失败帧。 */
+export type RpcWriteError = (id: string, error: unknown) => void;
+/** 写入 RPC 事件帧。 */
+export type RpcWriteEvent = (frame: RpcEventFrame) => void;
+//# sourceMappingURL=ServerTypes.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Agent RPC server 内部类型。
+ *
+ * 关键点（中文）
+ * - 这里描述 handler 需要的依赖，不承载 socket 生命周期。
+ * - `RpcServer.ts` 负责网络层，handler 把协议方法转成 Agent 操作。
+ */
+export {};
+//# sourceMappingURL=ServerTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ServerTypes.js","sourceRoot":"","sources":["../../../../../src/city/transport/rpc/server/ServerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/city/transport/session/RemoteSessionConfig.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 远程 Session 配置解析器。
+ *
+ * 负责把 transport 上可序列化的配置转换为本地 Session 输入；模型目录仍由宿主拥有。
+ */
+import type { AgentSessionSetInput, RemoteSessionSetInput } from "../../../index.js";
+import type { AgentSessionModelResolver } from "../types/AgentSessionModelResolver.js";
+/** 把远程配置输入解析为本地 Session 可执行输入。 */
+export declare function resolve_remote_session_set_input(input: {
+    /** 远程 transport 收到的可序列化配置。 */
+    config: RemoteSessionSetInput;
+    /** 宿主提供的模型解析能力。 */
+    resolve_session_model?: AgentSessionModelResolver;
+}): Promise<AgentSessionSetInput>;
+//# sourceMappingURL=RemoteSessionConfig.d.ts.map

package/bin/city/transport/session/RemoteSessionConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteSessionConfig.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/session/RemoteSessionConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAErG,kCAAkC;AAClC,wBAAsB,gCAAgC,CAAC,KAAK,EAAE;IAC5D,8BAA8B;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,mBAAmB;IACnB,qBAAqB,CAAC,EAAE,yBAAyB,CAAC;CACnD,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAehC"}

package/bin/city/transport/session/RemoteSessionConfig.js

@@ -0,0 +1,23 @@
+/**
+ * 远程 Session 配置解析器。
+ *
+ * 负责把 transport 上可序列化的配置转换为本地 Session 输入；模型目录仍由宿主拥有。
+ */
+/** 把远程配置输入解析为本地 Session 可执行输入。 */
+export async function resolve_remote_session_set_input(input) {
+    const model_id = String(input.config.model_id || "").trim();
+    if (!model_id && !input.config.security) {
+        throw new Error("remote session.set requires model_id or security");
+    }
+    if (model_id && !input.resolve_session_model) {
+        throw new Error("Remote Session model switching is not configured by the host");
+    }
+    const model = model_id
+        ? await input.resolve_session_model?.(model_id)
+        : undefined;
+    return {
+        ...(model ? { model } : {}),
+        ...(input.config.security ? { security: input.config.security } : {}),
+    };
+}
+//# sourceMappingURL=RemoteSessionConfig.js.map

package/bin/city/transport/session/RemoteSessionConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteSessionConfig.js","sourceRoot":"","sources":["../../../../src/city/transport/session/RemoteSessionConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,KAKtD;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ;QACpB,CAAC,CAAC,MAAM,KAAK,CAAC,qBAAqB,EAAE,CAAC,QAAQ,CAAC;QAC/C,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC;AACJ,CAAC"}

package/bin/city/transport/types/AgentHttpBinding.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AgentHTTP server 监听绑定类型。
+ */
+/**
+ * AgentHTTP server 监听绑定信息。
+ */
+export interface AgentHttpBinding {
+    /** 完整 HTTP 访问 URL。 */
+    url: string;
+    /** 当前监听主机。 */
+    host: string;
+    /** 当前监听端口。 */
+    port: number;
+}
+/**
+ * AgentHTTP server 监听参数。
+ */
+export interface AgentHttpListenOptions {
+    /** 监听主机，默认 `127.0.0.1`。 */
+    host?: string;
+    /** 监听端口（必填）。 */
+    port: number;
+}
+//# sourceMappingURL=AgentHttpBinding.d.ts.map

package/bin/city/transport/types/AgentHttpBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHttpBinding.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentHttpBinding.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/bin/city/transport/types/AgentHttpBinding.js

@@ -0,0 +1,5 @@
+/**
+ * AgentHTTP server 监听绑定类型。
+ */
+export {};
+//# sourceMappingURL=AgentHttpBinding.js.map

package/bin/city/transport/types/AgentHttpBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHttpBinding.js","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentHttpBinding.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/bin/city/transport/types/AgentHttpRuntime.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agent HTTP 宿主运行时能力类型。
+ *
+ * 这里只声明 SDK HTTP transport 需要宿主补充的解析能力。
+ */
+import type { AgentSessionModelResolver } from "./AgentSessionModelResolver.js";
+/** Agent HTTP 宿主运行时能力。 */
+export interface AgentHttpRuntimeOptions {
+    /** 将远程模型 ID 解析为当前宿主可执行的模型实例。 */
+    resolve_session_model?: AgentSessionModelResolver;
+}
+//# sourceMappingURL=AgentHttpRuntime.d.ts.map

package/bin/city/transport/types/AgentHttpRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHttpRuntime.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentHttpRuntime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAErG,0BAA0B;AAC1B,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,qBAAqB,CAAC,EAAE,yBAAyB,CAAC;CACnD"}

package/bin/city/transport/types/AgentHttpRuntime.js

@@ -0,0 +1,7 @@
+/**
+ * Agent HTTP 宿主运行时能力类型。
+ *
+ * 这里只声明 SDK HTTP transport 需要宿主补充的解析能力。
+ */
+export {};
+//# sourceMappingURL=AgentHttpRuntime.js.map

package/bin/city/transport/types/AgentHttpRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHttpRuntime.js","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentHttpRuntime.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/city/transport/types/AgentRpcBinding.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AgentRPC 监听绑定类型。
+ *
+ * 关键点（中文）
+ * - 仅描述监听后的可观测信息，不暴露底层 net.Server。
+ */
+/**
+ * AgentRPC 监听绑定信息。
+ */
+export interface AgentRpcBinding {
+    /** 完整 RPC 访问 URL，例如 `rpc://127.0.0.1:15314`。 */
+    url: string;
+    /** 当前监听主机。 */
+    host: string;
+    /** 当前监听端口。 */
+    port: number;
+}
+/**
+ * AgentRPC 监听参数。
+ */
+export interface AgentRpcListenOptions {
+    /** 监听主机，默认 `127.0.0.1`。 */
+    host?: string;
+    /** 监听端口，默认 `15314`。 */
+    port?: number;
+}
+//# sourceMappingURL=AgentRpcBinding.d.ts.map

package/bin/city/transport/types/AgentRpcBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRpcBinding.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentRpcBinding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/bin/city/transport/types/AgentRpcBinding.js

@@ -0,0 +1,8 @@
+/**
+ * AgentRPC 监听绑定类型。
+ *
+ * 关键点（中文）
+ * - 仅描述监听后的可观测信息，不暴露底层 net.Server。
+ */
+export {};
+//# sourceMappingURL=AgentRpcBinding.js.map

package/bin/city/transport/types/AgentRpcBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRpcBinding.js","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentRpcBinding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/city/transport/types/AgentRpcRuntime.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent RPC 宿主运行时能力类型。
+ *
+ * 该类型只投影 internal 管理命令需要的宿主能力，不让 RPC Server 理解 City 的配置文件位置。
+ */
+import type { AgentSessionModelResolver } from "./AgentSessionModelResolver.js";
+/** Agent RPC 宿主运行时能力。 */
+export interface AgentRpcRuntimeOptions {
+    /** 将远程模型 ID 解析为当前宿主可执行的模型实例。 */
+    resolve_session_model?: AgentSessionModelResolver;
+    /**
+     * 从宿主事实源重新解析 Workspace Env，并把完整快照提交给 Workspace。
+     *
+     * 返回值用于 RPC 响应确认，调用方不得把 Env 明文写入日志。
+     */
+    reload_workspace_env?: () => Record<string, string> | Promise<Record<string, string>>;
+}
+//# sourceMappingURL=AgentRpcRuntime.d.ts.map

package/bin/city/transport/types/AgentRpcRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRpcRuntime.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentRpcRuntime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAErG,yBAAyB;AACzB,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,qBAAqB,CAAC,EAAE,yBAAyB,CAAC;IAElD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvF"}

package/bin/city/transport/types/AgentRpcRuntime.js

@@ -0,0 +1,7 @@
+/**
+ * Agent RPC 宿主运行时能力类型。
+ *
+ * 该类型只投影 internal 管理命令需要的宿主能力，不让 RPC Server 理解 City 的配置文件位置。
+ */
+export {};
+//# sourceMappingURL=AgentRpcRuntime.js.map

package/bin/city/transport/types/AgentRpcRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRpcRuntime.js","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentRpcRuntime.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/city/transport/types/AgentSessionModelResolver.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent transport 的 Session 模型解析能力。
+ *
+ * Transport 只接收远程协议中的模型 ID；具体目录、鉴权和运行时模型创建由宿主实现。
+ */
+import type { AgentModel } from "../../../index.js";
+/** 把宿主模型 ID 解析为 Agent 可执行模型实例。 */
+export type AgentSessionModelResolver = (
+/** 远程调用方请求的宿主模型 ID。 */
+model_id: string) => AgentModel | Promise<AgentModel>;
+//# sourceMappingURL=AgentSessionModelResolver.d.ts.map

package/bin/city/transport/types/AgentSessionModelResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSessionModelResolver.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentSessionModelResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,kCAAkC;AAClC,MAAM,MAAM,yBAAyB,GAAG;AACtC,uBAAuB;AACvB,QAAQ,EAAE,MAAM,KACb,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC"}

package/bin/city/transport/types/AgentSessionModelResolver.js

@@ -0,0 +1,7 @@
+/**
+ * Agent transport 的 Session 模型解析能力。
+ *
+ * Transport 只接收远程协议中的模型 ID；具体目录、鉴权和运行时模型创建由宿主实现。
+ */
+export {};
+//# sourceMappingURL=AgentSessionModelResolver.js.map

package/bin/city/transport/types/AgentSessionModelResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSessionModelResolver.js","sourceRoot":"","sources":["../../../../src/city/transport/types/AgentSessionModelResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/city/transport/types/CityHttpRuntime.d.ts

@@ -0,0 +1,36 @@
+/**
+ * City HTTP 宿主运行时能力类型。
+ *
+ * City transport 先按 Agent ID 选中 Agent，再把模型解析等宿主能力投影给单
+ * Agent HTTP router，避免路由层理解本地 Store 的实现。
+ */
+import type { AgentSessionModelResolver } from "./AgentSessionModelResolver.js";
+import type { Agent } from "../../../index.js";
+import type { AgentPlugins } from "../../../types/plugin/PluginRuntime.js";
+import type { WorkspaceBase } from "@downcity/workspace";
+import type { Hono } from "hono";
+/** 宿主为一个 Agent 提供的 HTTP 扩展。 */
+export interface CityAgentHttpExtension {
+    /** 已组合 SDK Router 的 Agent 子路由。 */
+    router: Hono;
+    /** CityHTTP 关闭时需要同步释放的宿主资源。 */
+    dispose?(): void | Promise<void>;
+}
+/** City HTTP transport 所需的宿主能力。 */
+export interface CityHttpRuntimeOptions {
+    /** 为指定 Agent 创建远程 Session 所需的模型解析器。 */
+    resolve_session_model?: (agent_id: string, workspace_id: string, model_id: string) => ReturnType<AgentSessionModelResolver>;
+    /** 为一个 Agent 组合 Auth、控制台和应用专属路由。 */
+    create_agent_extension?: (input: {
+        /** 当前路由对应的本地 Agent。 */
+        agent: Agent;
+        /** 当前路由对应的 Agent Workspace 执行作用域。 */
+        workspace: WorkspaceBase;
+        plugins: AgentPlugins;
+        /** City 提供的标准 RemoteAgent SDK Router。 */
+        sdk_router: Hono;
+    }) => CityAgentHttpExtension;
+    /** 挂载到 City HTTP 根路径的宿主扩展 Router。 */
+    city_router?: Hono;
+}
+//# sourceMappingURL=CityHttpRuntime.d.ts.map

package/bin/city/transport/types/CityHttpRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityHttpRuntime.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/CityHttpRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AACrG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,+BAA+B;AAC/B,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,MAAM,EAAE,IAAI,CAAC;IAEb,+BAA+B;IAC/B,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,mCAAmC;AACnC,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,qBAAqB,CAAC,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,KACb,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAE3C,oCAAoC;IACpC,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC/B,uBAAuB;QACvB,KAAK,EAAE,KAAK,CAAC;QACb,qCAAqC;QACrC,SAAS,EAAE,aAAa,CAAC;QACzB,OAAO,EAAE,YAAY,CAAC;QACtB,yCAAyC;QACzC,UAAU,EAAE,IAAI,CAAC;KAClB,KAAK,sBAAsB,CAAC;IAE7B,qCAAqC;IACrC,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB"}

package/bin/city/transport/types/CityHttpRuntime.js

@@ -0,0 +1,8 @@
+/**
+ * City HTTP 宿主运行时能力类型。
+ *
+ * City transport 先按 Agent ID 选中 Agent，再把模型解析等宿主能力投影给单
+ * Agent HTTP router，避免路由层理解本地 Store 的实现。
+ */
+export {};
+//# sourceMappingURL=CityHttpRuntime.js.map

package/bin/city/transport/types/CityHttpRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityHttpRuntime.js","sourceRoot":"","sources":["../../../../src/city/transport/types/CityHttpRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/city/transport/types/CityRpcRuntime.d.ts

@@ -0,0 +1,17 @@
+/**
+ * City RPC 宿主运行时能力类型。
+ *
+ * 所有回调都显式接收 Agent ID，使 transport 不依赖任何持久化层，也不会把
+ * 多 Agent 的运行时配置复制成第二份事实源。
+ */
+import type { AgentSessionModelResolver } from "./AgentSessionModelResolver.js";
+/** City RPC transport 所需的宿主能力。 */
+export interface CityRpcRuntimeOptions {
+    /** 处理宿主关闭请求；调用方负责安排实际进程退出。 */
+    shutdown?: () => void | Promise<void>;
+    /** 为指定 Agent 创建远程 Session 所需的模型解析器。 */
+    resolve_session_model?: (agent_id: string, workspace_id: string, model_id: string) => ReturnType<AgentSessionModelResolver>;
+    /** 从事实源重新加载指定 Agent 的 Workspace Env。 */
+    reload_workspace_env?: (agent_id: string, workspace_id: string) => Record<string, string> | Promise<Record<string, string>>;
+}
+//# sourceMappingURL=CityRpcRuntime.d.ts.map

package/bin/city/transport/types/CityRpcRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityRpcRuntime.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/CityRpcRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAErG,kCAAkC;AAClC,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC,uCAAuC;IACvC,qBAAqB,CAAC,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,KACb,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAE3C,wCAAwC;IACxC,oBAAoB,CAAC,EAAE,CACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,KACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D"}

package/bin/city/transport/types/CityRpcRuntime.js

@@ -0,0 +1,8 @@
+/**
+ * City RPC 宿主运行时能力类型。
+ *
+ * 所有回调都显式接收 Agent ID，使 transport 不依赖任何持久化层，也不会把
+ * 多 Agent 的运行时配置复制成第二份事实源。
+ */
+export {};
+//# sourceMappingURL=CityRpcRuntime.js.map

package/bin/city/transport/types/CityRpcRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityRpcRuntime.js","sourceRoot":"","sources":["../../../../src/city/transport/types/CityRpcRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/city/transport/types/RpcProtocol.d.ts

@@ -0,0 +1,24 @@
+/**
+ * City transport 内部使用的 RPC 协议类型 re-export。
+ *
+ * 关键点（中文）
+ * - Agent 请求复用 `@/index.js` 的公开 RPC 协议。
+ * - City 宿主控制方法只在本包扩展，不进入单 Agent SDK。
+ */
+export type { RpcEventFrame, RpcServerFrame, } from "../../../index.js";
+import type { RpcRequest as AgentRpcRequest } from "../../../index.js";
+/** City 宿主自身的 RPC 控制请求。 */
+export type CityControlRpcRequest = {
+    /** 请求 ID，用于匹配响应。 */
+    id: string;
+    /** 读取 City 宿主进程状态。 */
+    method: "internal.city.status";
+} | {
+    /** 请求 ID，用于匹配响应。 */
+    id: string;
+    /** 请求 City 宿主优雅退出。 */
+    method: "internal.city.shutdown";
+};
+/** City transport 接受单 Agent 请求和 City 控制请求。 */
+export type RpcRequest = AgentRpcRequest | CityControlRpcRequest;
+//# sourceMappingURL=RpcProtocol.d.ts.map

package/bin/city/transport/types/RpcProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcProtocol.d.ts","sourceRoot":"","sources":["../../../../src/city/transport/types/RpcProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE,2BAA2B;AAC3B,MAAM,MAAM,qBAAqB,GAC7B;IACE,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,MAAM,EAAE,sBAAsB,CAAC;CAChC,GACD;IACE,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC;AAEN,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,qBAAqB,CAAC"}