@downcity/agent 1.1.129 → 1.1.148

package/src/agent/local/AgentRuntimeFactory.ts

@@ -1,152 +0,0 @@
-/**
- * Agent runtime / context 装配工厂。
- *
- * 关键点（中文）
- * - 这里只创建长期 runtime 视图与执行期 context 视图。
- * - Agent 仍然持有 session/plugin 状态；这里通过函数参数读取状态。
- */
-
-import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
-import type { Logger } from "@/utils/logger/Logger.js";
-import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-import type { LanguageModel } from "ai";
-import type { JsonValue } from "@/types/common/Json.js";
-import type {
-  AgentContext,
-  SessionPort,
-} from "@/types/runtime/agent/AgentContext.js";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-import type { AgentPlugins } from "@/plugin/types/Plugin.js";
-import type { AgentManagedSession } from "@/types/agent/AgentTypes.js";
-import {
-  createAgentPathRuntime,
-  createAgentPluginConfigRuntime,
-} from "@/agent/local/AgentRuntimeAssembly.js";
-
-/**
- * 创建 AgentRuntime 的参数。
- */
-export interface CreateAgentRuntimeOptions {
-  /** 当前 agent id。 */
-  agent_id: string;
-  /** 当前项目根目录。 */
-  project_root: string;
-  /** 统一日志器。 */
-  logger: Logger;
-  /** 当前解析后的配置。 */
-  config: DowncityConfig;
-  /** 当前环境变量快照。 */
-  env: Record<string, string>;
-  /** 当前静态 system 文本集合。 */
-  systems: string[];
-  /** 当前 plugin 实例集合。 */
-  plugin_instances: Map<string, BasePlugin>;
-  /** 获取或创建 session runtime port。 */
-  get_session_port: (session_id: string) => SessionPort;
-  /** 读取当前已缓存的 session 实例。 */
-  list_cached_sessions: () => AgentManagedSession[];
-}
-
-/**
- * 创建 AgentContext 的参数。
- */
-export interface CreateAgentContextOptions {
-  /** 当前 AgentRuntime。 */
-  runtime: AgentRuntime;
-  /** 当前项目根目录。 */
-  project_root: string;
-  /** 统一日志器。 */
-  logger: Logger;
-  /** 当前解析后的配置。 */
-  config: DowncityConfig;
-  /** 当前环境变量快照。 */
-  env: Record<string, string>;
-  /** 当前静态 system 文本集合。 */
-  systems: string[];
-  /** 当前 plugin 实例集合。 */
-  plugin_instances: Map<string, BasePlugin>;
-  /** 对外 plugin 调用端口。 */
-  plugins: AgentPlugins;
-  /** 获取或创建 session runtime port。 */
-  get_session_port: (session_id: string) => SessionPort;
-  /** 解析 session 当前绑定的模型实例。 */
-  resolve_session_model: (session_id: string) => Promise<LanguageModel | undefined>;
-}
-
-/**
- * 创建实例级 runtime 视图。
- */
-export function createAgentRuntime(
-  options: CreateAgentRuntimeOptions,
-): AgentRuntime {
-  return {
-    cwd: options.project_root,
-    rootPath: options.project_root,
-    logger: options.logger,
-    config: options.config,
-    env: options.env,
-    systems: options.systems,
-    paths: createAgentPathRuntime(options.project_root, options.agent_id),
-    pluginConfig: createAgentPluginConfigRuntime(options.project_root),
-    getSession: (session_id: string): SessionPort =>
-      options.get_session_port(session_id),
-    listExecutingSessionIds: () =>
-      options
-        .list_cached_sessions()
-        .filter((session) => session.isExecuting())
-        .map((session) => session.id),
-    getExecutingSessionCount: () =>
-      options
-        .list_cached_sessions()
-        .filter((session) => session.isExecuting()).length,
-    pluginInstances: options.plugin_instances,
-  };
-}
-
-/**
- * 创建统一执行上下文。
- */
-export function createAgentContext(
-  options: CreateAgentContextOptions,
-): AgentContext {
-  let context!: AgentContext;
-  context = {
-    agent: options.runtime,
-    cwd: options.project_root,
-    rootPath: options.project_root,
-    logger: options.logger,
-    config: options.config,
-    env: options.env,
-    systems: options.systems,
-    paths: options.runtime.paths,
-    pluginConfig: options.runtime.pluginConfig,
-    session: {
-      get: (session_id) => options.get_session_port(session_id),
-      listExecutingSessionIds: () => options.runtime.listExecutingSessionIds(),
-      getExecutingSessionCount: () => options.runtime.getExecutingSessionCount(),
-      resolveModel: async (session_id) =>
-        await options.resolve_session_model(session_id),
-    },
-    invoke: {
-      invoke: async (params: {
-        plugin: string;
-        action: string;
-        payload?: JsonValue;
-      }) => {
-        const result = await options.plugins.runAction(params);
-        if (!result.success) {
-          return {
-            success: false,
-            error: result.error || result.message || "plugin action failed",
-          };
-        }
-        return {
-          success: true,
-          ...(result.data !== undefined ? { data: result.data } : {}),
-        };
-      },
-    },
-    plugins: options.plugins,
-  };
-  return context;
-}

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());
-      });
-    },
-  };
-}