@downcity/server 0.1.3

package/bin/rpc/server/InternalHandlers.js

@@ -0,0 +1,248 @@
+/**
+ * RPC internal handlers。
+ *
+ * 关键点（中文）
+ * - 只处理 `internal.*` 方法。
+ * - 这些方法服务 Town 本机管理通道，不属于 RemoteAgent 的用户 SDK 面。
+ * - 实现依赖 `@downcity/agent` 的 internal 路径，故只能由 `@downcity/server` 同进程使用。
+ */
+import { rm } from "node:fs/promises";
+import { dirname } from "node:path";
+import { getDowncityChatHistoryPath, getDowncitySessionMessagesPath, } from "@downcity/agent/internal/config/Paths.js";
+import { resolveSessionSystemMessages } from "@downcity/agent/internal/executor/composer/system/default/SystemDomain.js";
+import { controlPluginState, listPluginStates, } from "@downcity/agent/internal/plugin/core/PluginStateController.js";
+import { parsePluginCommandRequestBody } from "@downcity/agent/internal/plugin/core/PluginCommandRequest.js";
+import { runPluginCommand } from "@downcity/agent/internal/plugin/core/PluginActionRunner.js";
+/**
+ * 处理 internal RPC 请求。
+ */
+export async function handleInternalRpcRequest(params) {
+    const { request, options, write_success } = params;
+    switch (request.method) {
+        case "internal.status.get": {
+            write_success(request.id, { status: "ok" });
+            return true;
+        }
+        case "internal.sessions.clear_messages": {
+            const runtime = requireAgentRuntime(options);
+            const session_id = String(request.params.sessionId || "").trim();
+            if (!session_id)
+                throw new Error("Missing sessionId");
+            const messages_path = getDowncitySessionMessagesPath(runtime.rootPath, runtime.paths.agentId, session_id);
+            await rm(dirname(messages_path), { recursive: true, force: true });
+            runtime.getSession(session_id).clearExecutor();
+            write_success(request.id, {
+                sessionId: session_id,
+                cleared: true,
+            });
+            return true;
+        }
+        case "internal.sessions.clear_chat_history": {
+            const runtime = requireAgentRuntime(options);
+            const session_id = String(request.params.sessionId || "").trim();
+            if (!session_id)
+                throw new Error("Missing sessionId");
+            await rm(getDowncityChatHistoryPath(runtime.rootPath, session_id), {
+                recursive: true,
+                force: true,
+            });
+            write_success(request.id, {
+                sessionId: session_id,
+                cleared: true,
+            });
+            return true;
+        }
+        case "internal.sessions.resolve_system_prompt": {
+            const runtime = requireAgentRuntime(options);
+            const context = requireAgentContext(options);
+            const session_id = String(request.params.sessionId || "").trim() || "consoleui-chat-main";
+            const system_messages = await resolveSessionSystemMessages({
+                projectRoot: runtime.rootPath,
+                sessionId: session_id,
+                profile: "chat",
+                staticSystemPrompts: runtime.systems,
+                context,
+            });
+            write_success(request.id, {
+                sessionId: session_id,
+                ...toSystemPromptPayload(system_messages),
+            });
+            return true;
+        }
+        case "internal.plugins.catalog": {
+            const context = requireAgentContext(options);
+            write_success(request.id, {
+                plugins: context.plugins.list(),
+            });
+            return true;
+        }
+        case "internal.plugins.list": {
+            const context = requireAgentContext(options);
+            write_success(request.id, {
+                plugins: listPluginStates({ context }),
+            });
+            return true;
+        }
+        case "internal.plugins.control": {
+            const context = requireAgentContext(options);
+            const result = await controlPluginState({
+                pluginName: request.params.pluginName,
+                action: request.params.action,
+                context,
+            });
+            write_success(request.id, result);
+            return true;
+        }
+        case "internal.plugins.command": {
+            const context = requireAgentContext(options);
+            const body = parsePluginCommandRequestBody(request.params);
+            const result = await runPluginCommand({
+                pluginName: body.pluginName,
+                command: body.command,
+                payload: body.payload,
+                schedule: body.schedule,
+                context,
+            });
+            write_success(request.id, result);
+            return true;
+        }
+        case "internal.plugins.availability": {
+            const context = requireAgentContext(options);
+            const availability = await context.plugins.availability(request.params.pluginName);
+            write_success(request.id, {
+                pluginName: request.params.pluginName,
+                availability,
+            });
+            return true;
+        }
+        case "internal.plugins.action": {
+            const context = requireAgentContext(options);
+            const result = await context.plugins.runAction({
+                plugin: request.params.pluginName,
+                action: request.params.actionName,
+                payload: request.params.payload,
+            });
+            write_success(request.id, {
+                ...result,
+                pluginName: request.params.pluginName,
+                actionName: request.params.actionName,
+            });
+            return true;
+        }
+        case "internal.shell.approvals": {
+            const shell = requireShell(options);
+            write_success(request.id, {
+                approvals: shell.approvals(),
+            });
+            return true;
+        }
+        case "internal.shell.approvalModes": {
+            const shell = requireShell(options);
+            write_success(request.id, {
+                modes: shell.approval_modes(),
+            });
+            return true;
+        }
+        case "internal.shell.approvalMode": {
+            const shell = requireShell(options);
+            const result = shell.approval_mode({
+                session_id: String(request.params.sessionId || "").trim(),
+            });
+            write_success(request.id, result);
+            return true;
+        }
+        case "internal.shell.setApprovalMode": {
+            const shell = requireShell(options);
+            const result = shell.set_approval_mode({
+                session_id: String(request.params.sessionId || "").trim(),
+                mode: request.params.mode,
+            });
+            write_success(request.id, result);
+            return true;
+        }
+        case "internal.shell.approve": {
+            const shell = requireShell(options);
+            const result = await shell.approve({
+                approval_id: String(request.params.approvalId || "").trim(),
+            });
+            write_success(request.id, result);
+            return true;
+        }
+        case "internal.shell.deny": {
+            const shell = requireShell(options);
+            const result = await shell.deny({
+                approval_id: String(request.params.approvalId || "").trim(),
+            });
+            write_success(request.id, result);
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+function requireShell(options) {
+    const shell = options.getShell?.();
+    if (!shell) {
+        throw new Error("Agent RPC server was started without Shell");
+    }
+    return shell;
+}
+function requireAgentContext(options) {
+    const context = options.getAgentContext?.();
+    if (!context) {
+        throw new Error("Agent RPC server was started without AgentContext");
+    }
+    return context;
+}
+function requireAgentRuntime(options) {
+    const runtime = options.getAgentRuntime?.();
+    if (!runtime) {
+        throw new Error("Agent RPC server was started without AgentRuntime");
+    }
+    return runtime;
+}
+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/Town 可直接渲染的结构。
+ */
+function toSystemPromptPayload(messages) {
+    const items = messages
+        .map((message, index) => ({
+        index: index + 1,
+        content: toSystemMessageText(message),
+    }))
+        .filter((item) => item.content);
+    const totalChars = items.reduce((acc, item) => acc + String(item.content || "").length, 0);
+    return {
+        sections: [
+            {
+                key: "resolved",
+                title: "Resolved System Messages",
+                items,
+            },
+        ],
+        totalMessages: items.length,
+        totalChars,
+    };
+}
+//# sourceMappingURL=InternalHandlers.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * RPC request dispatcher。
+ *
+ * 关键点（中文）
+ * - server.ts 不直接包含业务 switch，只负责把已解析请求交给这里。
+ * - dispatcher 按命名空间分发，避免 SDK 与 Town internal 方法混在一起。
+ */
+import type { RpcRequest } from "../../types/RpcProtocol.js";
+import type { RpcRequestHandlerOptions, RpcSocketSubscription, RpcWriteError, RpcWriteEvent, RpcWriteSuccess } from "../../rpc/server/ServerTypes.js";
+/**
+ * 分发并执行单个 RPC 请求。
+ */
+export declare function dispatchRpcRequest(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/rpc/server/RequestDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestDispatcher.d.ts","sourceRoot":"","sources":["../../../src/rpc/server/RequestDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAIrC;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,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/rpc/server/RequestDispatcher.js

@@ -0,0 +1,38 @@
+/**
+ * RPC request dispatcher。
+ *
+ * 关键点（中文）
+ * - server.ts 不直接包含业务 switch，只负责把已解析请求交给这里。
+ * - dispatcher 按命名空间分发，避免 SDK 与 Town internal 方法混在一起。
+ */
+import { handleSdkSessionRpcRequest } from "../../rpc/server/SdkSessionHandlers.js";
+import { handleInternalRpcRequest } from "../../rpc/server/InternalHandlers.js";
+/**
+ * 分发并执行单个 RPC 请求。
+ */
+export async function dispatchRpcRequest(params) {
+    const { request, options, subscriptions, write_success, write_error, write_event, } = params;
+    try {
+        const handled_by_sdk = await handleSdkSessionRpcRequest({
+            request,
+            options,
+            subscriptions,
+            write_success,
+            write_event,
+        });
+        if (handled_by_sdk)
+            return;
+        const handled_by_internal = await handleInternalRpcRequest({
+            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/rpc/server/RequestDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestDispatcher.js","sourceRoot":"","sources":["../../../src/rpc/server/RequestDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAaxC;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,0BAA0B,CAAC;YACtD,OAAO;YACP,OAAO;YACP,aAAa;YACb,aAAa;YACb,WAAW;SACZ,CAAC,CAAC;QACH,IAAI,cAAc;YAAE,OAAO;QAE3B,MAAM,mBAAmB,GAAG,MAAM,wBAAwB,CAAC;YACzD,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/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 "../../rpc/server/ServerTypes.js";
+/**
+ * 处理 SDK session RPC 请求。
+ */
+export declare function handleSdkSessionRpcRequest(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/rpc/server/SdkSessionHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkSessionHandlers.d.ts","sourceRoot":"","sources":["../../../src/rpc/server/SdkSessionHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,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,CA2EnB"}

package/bin/rpc/server/SdkSessionHandlers.js

@@ -0,0 +1,86 @@
+/**
+ * RPC SDK session handlers。
+ *
+ * 关键点（中文）
+ * - 只处理 `sdk.sessions.*` 方法。
+ * - 这些方法是 RemoteAgent RPC transport 的稳定 SDK 面。
+ */
+/**
+ * 处理 SDK session RPC 请求。
+ */
+export async function handleSdkSessionRpcRequest(params) {
+    const { request, options, subscriptions, write_success, write_event } = params;
+    switch (request.method) {
+        case "sdk.sessions.list": {
+            const page = await options.sessionCollection.listSessions(request.params);
+            write_success(request.id, { page });
+            return true;
+        }
+        case "sdk.sessions.create": {
+            const session = await options.sessionCollection.createSession(request.params);
+            write_success(request.id, { session: await session.getInfo() });
+            return true;
+        }
+        case "sdk.sessions.get": {
+            const session = await options.sessionCollection.getSession(request.params.sessionId);
+            write_success(request.id, { session: await session.getInfo() });
+            return true;
+        }
+        case "sdk.sessions.prompt": {
+            const session = await options.sessionCollection.getSession(request.params.sessionId);
+            const turn = await session.prompt(request.params.input);
+            write_success(request.id, { turn: { id: turn.id } });
+            return true;
+        }
+        case "sdk.sessions.history": {
+            const session = await options.sessionCollection.getSession(request.params.sessionId);
+            const history = await session.history(request.params.input);
+            write_success(request.id, { history });
+            return true;
+        }
+        case "sdk.sessions.system": {
+            const session = await options.sessionCollection.getSession(request.params.sessionId);
+            write_success(request.id, { system: await session.system() });
+            return true;
+        }
+        case "sdk.sessions.fork": {
+            const session = await options.sessionCollection.getSession(request.params.sessionId);
+            const forked = await session.fork(request.params.messageId);
+            write_success(request.id, { session: await forked.getInfo() });
+            return true;
+        }
+        case "sdk.sessions.subscribe": {
+            const session = await options.sessionCollection.getSession(request.params.sessionId);
+            const subscription_id = [
+                request.params.sessionId,
+                Date.now(),
+                Math.random().toString(36).slice(2, 10),
+            ].join(":");
+            const unsubscribe = session.subscribe((event) => {
+                write_event({
+                    type: "event",
+                    subscriptionId: subscription_id,
+                    event,
+                });
+            });
+            subscriptions.set(subscription_id, {
+                sessionId: request.params.sessionId,
+                unsubscribe,
+            });
+            write_success(request.id, { subscriptionId: subscription_id });
+            return true;
+        }
+        case "sdk.sessions.unsubscribe": {
+            const subscription = subscriptions.get(request.params.subscriptionId);
+            if (subscription) {
+                subscription.unsubscribe();
+                subscriptions.delete(request.params.subscriptionId);
+            }
+            write_success(request.id, { unsubscribed: true });
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=SdkSessionHandlers.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * Agent RPC server 内部类型。
+ *
+ * 关键点（中文）
+ * - 这里描述 handler 需要的依赖，不承载 socket 生命周期。
+ * - `RpcServer.ts` 负责网络层，handler 把协议方法转成 Agent 操作。
+ */
+import type { AgentSessionCollection } from "@downcity/agent";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
+import type { Shell } from "@downcity/shell";
+import type { RpcEventFrame } from "../../types/RpcProtocol.js";
+/**
+ * RPC server 启动参数。
+ */
+export interface RpcServerStartOptions {
+    /** RPC 服务监听端口。 */
+    port: number;
+    /** RPC 服务监听主机。 */
+    host: string;
+    /** Session 集合访问口。 */
+    sessionCollection: AgentSessionCollection;
+    /** Agent 上下文访问口。 */
+    getAgentContext?: () => AgentContext;
+    /** Agent 运行态访问口。 */
+    getAgentRuntime?: () => AgentRuntime;
+    /** Shell 访问口。 */
+    getShell?: () => Shell | undefined;
+}
+/**
+ * RPC request handler 依赖。
+ */
+export interface RpcRequestHandlerOptions {
+    /** Session 集合访问口。 */
+    sessionCollection: AgentSessionCollection;
+    /** Agent 上下文访问口。 */
+    getAgentContext?: () => AgentContext;
+    /** Agent 运行态访问口。 */
+    getAgentRuntime?: () => AgentRuntime;
+    /** Shell 访问口。 */
+    getShell?: () => Shell | undefined;
+}
+/**
+ * 单个 socket 上的 session 订阅。
+ */
+export interface RpcSocketSubscription {
+    /** 被订阅的 session id。 */
+    sessionId: 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/rpc/server/ServerTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerTypes.d.ts","sourceRoot":"","sources":["../../../src/rpc/server/ServerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,oBAAoB;IACpB,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC;IACrC,oBAAoB;IACpB,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC;IACrC,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,KAAK,GAAG,SAAS,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,oBAAoB;IACpB,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC;IACrC,oBAAoB;IACpB,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC;IACrC,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,KAAK,GAAG,SAAS,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,kBAAkB;AAClB,MAAM,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEnE,kBAAkB;AAClB,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE,kBAAkB;AAClB,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC"}

package/bin/rpc/server/ServerTypes.js

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

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

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

package/bin/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/types/AgentHttpBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHttpBinding.d.ts","sourceRoot":"","sources":["../../src/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/types/AgentHttpBinding.js

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

package/bin/types/AgentHttpBinding.js.map

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

package/bin/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/types/AgentRpcBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRpcBinding.d.ts","sourceRoot":"","sources":["../../src/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/types/AgentRpcBinding.js

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

package/bin/types/AgentRpcBinding.js.map

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

package/bin/types/RpcProtocol.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Server 包内部使用的 RPC 协议类型 re-export。
+ *
+ * 关键点（中文）
+ * - 直接转出 `@downcity/agent/internal/types/rpc/RpcProtocol.js` 的协议类型。
+ * - 让 server 内部模块只依赖一个本地路径，避免到处写 `@downcity/agent/internal/...` 长路径。
+ */
+export type { RpcRequest, RpcEventFrame, RpcServerFrame, } from "@downcity/agent/internal/types/rpc/RpcProtocol.js";
+//# sourceMappingURL=RpcProtocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RpcProtocol.d.ts","sourceRoot":"","sources":["../../src/types/RpcProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,mDAAmD,CAAC"}

package/bin/types/RpcProtocol.js

@@ -0,0 +1,9 @@
+/**
+ * Server 包内部使用的 RPC 协议类型 re-export。
+ *
+ * 关键点（中文）
+ * - 直接转出 `@downcity/agent/internal/types/rpc/RpcProtocol.js` 的协议类型。
+ * - 让 server 内部模块只依赖一个本地路径，避免到处写 `@downcity/agent/internal/...` 长路径。
+ */
+export {};
+//# sourceMappingURL=RpcProtocol.js.map

package/bin/types/RpcProtocol.js.map

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