@downcity/agent 1.1.126 → 1.1.135

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

@@ -1,27 +0,0 @@
-/**
- * RPC request dispatcher。
- *
- * 关键点（中文）
- * - Server.ts 不直接包含业务 switch，只负责把已解析请求交给这里。
- * - dispatcher 按命名空间分发，避免 SDK 与 Town internal 方法混在一起。
- */
-import type { RpcRequest } from "../../types/rpc/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

@@ -1 +0,0 @@
-{"version":3,"file":"RequestDispatcher.d.ts","sourceRoot":"","sources":["../../../src/rpc/server/RequestDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,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

@@ -1,38 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,25 +0,0 @@
-/**
- * RPC SDK session handlers。
- *
- * 关键点（中文）
- * - 只处理 `sdk.sessions.*` 方法。
- * - 这些方法是 RemoteAgent RPC transport 的稳定 SDK 面。
- */
-import type { RpcRequest } from "../../types/rpc/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

@@ -1 +0,0 @@
-{"version":3,"file":"SdkSessionHandlers.d.ts","sourceRoot":"","sources":["../../../src/rpc/server/SdkSessionHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,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

@@ -1,86 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,64 +0,0 @@
-/**
- * Agent RPC server 内部类型。
- *
- * 关键点（中文）
- * - 这里描述 handler 需要的依赖，不承载 socket 生命周期。
- * - Server.ts 负责网络，handler 负责把协议方法转成 Agent 操作。
- */
-import type { AgentSessionCollection } from "../../types/agent/AgentTypes.js";
-import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
-import type { AgentRuntime } from "../../types/runtime/agent/AgentRuntime.js";
-import type { RpcEventFrame } from "../../types/rpc/RpcProtocol.js";
-import type { Shell } from "@downcity/shell";
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"ServerTypes.d.ts","sourceRoot":"","sources":["../../../src/rpc/server/ServerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;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;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC"}

package/bin/rpc/server/ServerTypes.js

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

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

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

package/src/agent/local/services/AgentLifecycleService.ts

@@ -1,198 +0,0 @@
-/**
- * AgentLifecycleService：本地 Agent 生命周期服务。
- *
- * 关键点（中文）
- * - 统一管理 plugins、ActionSchedule 与本机 RPC 的启动/停止。
- * - 该服务只负责长期后台能力生命周期，不负责 session 构造与运行时装配。
- * - facade 通过它暴露 `start()` / `stop()` 语义，避免生命周期状态散落在 Agent 主类中。
- */
-
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-import type {
-  AgentRpcBinding,
-  AgentRpcStartOptions,
-  AgentSessionCollection,
-  AgentStartOptions,
-  AgentStartResult,
-  AgentStopResult,
-} from "@/types/agent/AgentTypes.js";
-import type { Logger } from "@/utils/logger/Logger.js";
-import type { ActionScheduleRuntimeHandle } from "@/plugin/core/ActionScheduleRuntime.js";
-import { startActionScheduleRuntime } from "@/plugin/core/ActionScheduleRuntime.js";
-import { startAllPlugins, stopAllPlugins } from "@/plugin/core/Manager.js";
-import { startRpcServer } from "@/rpc/Server.js";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-import type { Shell } from "@downcity/shell";
-
-type AgentLifecycleServiceOptions = {
-  /**
-   * 当前统一日志器。
-   */
-  logger: Logger;
-
-  /**
-   * 当前 agent context。
-   */
-  agent_context: AgentContext;
-
-  /**
-   * 当前 session collection。
-   */
-  session_collection: AgentSessionCollection;
-
-  /**
-   * 读取当前 agent runtime。
-   */
-  get_runtime: () => AgentRuntime;
-
-  /**
-   * 读取当前 agent 挂载的 Shell。
-   */
-  get_shell?: () => Shell | undefined;
-};
-
-/**
- * 本地 Agent 生命周期服务。
- */
-export class AgentLifecycleService {
-  private readonly logger: Logger;
-  private readonly agent_context: AgentContext;
-  private readonly session_collection: AgentSessionCollection;
-  private readonly get_runtime: AgentLifecycleServiceOptions["get_runtime"];
-  private readonly get_shell: AgentLifecycleServiceOptions["get_shell"];
-
-  private plugins_started = false;
-  private action_schedule_runtime: ActionScheduleRuntimeHandle | null = null;
-  private start_promise: Promise<AgentStartResult> | null = null;
-  private rpc_binding: AgentRpcBinding | null = null;
-
-  constructor(options: AgentLifecycleServiceOptions) {
-    this.logger = options.logger;
-    this.agent_context = options.agent_context;
-    this.session_collection = options.session_collection;
-    this.get_runtime = options.get_runtime;
-    this.get_shell = options.get_shell;
-  }
-
-  /**
-   * 启动当前 agent 实例的长期运行能力。
-   */
-  async start(options?: AgentStartOptions): Promise<AgentStartResult> {
-    if (this.start_promise) {
-      return await this.start_promise;
-    }
-    this.start_promise = (async () => {
-      const should_start_plugins = options?.plugins !== false;
-      if (should_start_plugins) {
-        await this.ensure_plugins_started();
-      }
-      const rpc_binding =
-        options?.rpc === false || options?.rpc === undefined
-          ? undefined
-          : await this.start_rpc(options.rpc);
-      return {
-        ...(rpc_binding ? { rpc: rpc_binding } : {}),
-        pluginsStarted: this.plugins_started,
-      };
-    })();
-    try {
-      return await this.start_promise;
-    } catch (error) {
-      this.start_promise = null;
-      throw error;
-    }
-  }
-
-  /**
-   * 停止当前 agent 实例的长期运行能力。
-   */
-  async stop(): Promise<AgentStopResult> {
-    const plugins_started = this.plugins_started;
-    const rpc_started = this.rpc_binding !== null;
-
-    if (plugins_started) {
-      await this.stop_action_schedule_runtime();
-      await stopAllPlugins(this.agent_context);
-      this.plugins_started = false;
-    }
-
-    if (rpc_started) {
-      await this.stop_rpc();
-    }
-
-    await this.get_shell?.()?.dispose();
-
-    this.start_promise = null;
-
-    return {
-      rpcStopped: rpc_started,
-      pluginsStopped: plugins_started,
-    };
-  }
-
-  private async ensure_plugins_started(): Promise<void> {
-    if (this.plugins_started) return;
-    const lifecycle = await startAllPlugins(this.agent_context);
-    this.plugins_started = true;
-    for (const item of lifecycle.results) {
-      if (!item.success) {
-        this.logger.error(
-          `Plugin start failed: ${item.plugin?.name || "unknown"} - ${item.error || "unknown error"}`,
-        );
-      }
-    }
-    await this.ensure_action_schedule_runtime_started();
-  }
-
-  private async ensure_action_schedule_runtime_started(): Promise<void> {
-    if (this.action_schedule_runtime) return;
-    try {
-      this.action_schedule_runtime = await startActionScheduleRuntime(
-        this.agent_context,
-      );
-    } catch (error) {
-      this.logger.error(`ActionSchedule start failed: ${String(error)}`);
-    }
-  }
-
-  private async stop_action_schedule_runtime(): Promise<void> {
-    const runtime = this.action_schedule_runtime;
-    this.action_schedule_runtime = null;
-    runtime?.stop();
-  }
-
-  private async start_rpc(
-    options?: AgentRpcStartOptions,
-  ): Promise<AgentRpcBinding> {
-    if (this.rpc_binding) {
-      return this.rpc_binding;
-    }
-    const host = String(options?.host || "127.0.0.1").trim() || "127.0.0.1";
-    const port =
-      typeof options?.port === "number" && Number.isInteger(options.port)
-        ? options.port
-        : 15314;
-    const server = await startRpcServer({
-      host,
-      port,
-      sessionCollection: this.session_collection,
-      getAgentContext: () => this.agent_context,
-      getAgentRuntime: () => this.get_runtime(),
-      getShell: () => this.get_shell?.(),
-    });
-    this.rpc_binding = {
-      url: `rpc://${host}:${port}`,
-      host,
-      port,
-      server,
-    };
-    return this.rpc_binding;
-  }
-
-  private async stop_rpc(): Promise<void> {
-    if (!this.rpc_binding) return;
-    const current = this.rpc_binding;
-    this.rpc_binding = null;
-    await current.server.stop();
-  }
-}

package/src/rpc/Server.ts

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