@downcity/agent 1.1.8 → 1.1.11

package/src/agent/AgentRuntime.ts

@@ -1,376 +0,0 @@
-/**
- * AgentRuntime：agent 宿主装配与导出模块。
- *
- * 关键点（中文）
- * - 这里是单 agent 宿主的主装配入口，负责把 config、model、session、service、plugin 串起来。
- * - 完整运行态类型仍由 `AgentRuntimeState.ts` 维护；本模块只负责装配与对外导出。
- * - 该模块同时负责热重载提示词系统与导出统一的 `getAgentContext()` 入口。
- * - 当前只有 `api` 执行模式：从 console 模型池取模型，走 LocalSessionCore。
- */
-
-import path from "path";
-import fs from "fs";
-import { logger as defaultLogger } from "@shared/utils/logger/Logger.js";
-import { LocalSessionExecutor } from "@session/executors/local/LocalSessionExecutor.js";
-import { ensureRuntimeProjectReady } from "@/host/daemon/ProjectSetup.js";
-import { createModel } from "@/model/CreateModel.js";
-import {
-  loadGlobalEnvFromStore,
-  loadAgentEnvSnapshot,
-  loadDowncityConfig,
-} from "@/config/Config.js";
-import { getDowncityJsonPath } from "@/config/Paths.js";
-import {
-  getTaskRunDir,
-  parseTaskRunSessionId,
-} from "@/service/builtins/task/runtime/Paths.js";
-import { setShellToolRuntime, shellTools } from "@session/tools/shell/ShellToolDefinition.js";
-import { getSessionRunScope } from "@session/SessionRunScope.js";
-import { JsonlSessionHistoryComposer } from "@session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
-import { JsonlSessionCompactionComposer } from "@session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
-import { DefaultSessionSystemComposer } from "@session/composer/system/default/DefaultSessionSystemComposer.js";
-import type { SessionHistoryComposer } from "@session/composer/history/SessionHistoryComposer.js";
-import { ChatSession } from "@/service/builtins/chat/runtime/ChatSession.js";
-import { ChatSessionExecutionComposer } from "@/service/builtins/chat/runtime/ChatSessionExecutionComposer.js";
-import {
-  loadStaticSystemPrompts,
-  StaticPromptCatalog,
-} from "@session/composer/system/default/StaticPromptCatalog.js";
-import {
-  getAgentContext,
-} from "@/agent/AgentContext.js";
-import {
-  getAgentRuntime,
-  getAgentRuntimeBase,
-  setAgentRuntime,
-  setAgentRuntimeBase,
-  type AgentRuntime,
-} from "@/agent/AgentRuntimeState.js";
-import { createRegisteredServiceInstances } from "@/service/core/ServiceClassRegistry.js";
-import { readProjectPrimaryModelId } from "@/agent/project/ProjectExecutionBinding.js";
-import { initializePluginManager, resetPluginManager } from "@/plugin/PluginManager.js";
-import {
-  clearPluginRuntimeContextResolver,
-  setPluginRuntimeContextResolver,
-} from "@/host/runtime/PluginRuntime.js";
-import {
-  createAgentPathRuntime,
-  createAgentPluginConfigRuntime,
-} from "@/host/runtime/AgentHostRuntime.js";
-import { updateAgentRuntimeConfig } from "@/agent/AgentRuntimeState.js";
-import type { AgentPlatformRuntime } from "@/shared/types/AgentHost.js";
-
-export type { AgentRuntimeBase, AgentRuntime } from "@/agent/AgentRuntimeState.js";
-export {
-  getAgentRuntime,
-  getAgentRuntimeBase,
-  setAgentRuntime,
-  setAgentRuntimeBase,
-  requireAgentModel,
-} from "@/agent/AgentRuntimeState.js";
-export { getAgentContext } from "@/agent/AgentContext.js";
-
-let staticPromptCatalog: StaticPromptCatalog | null = null;
-let configWatchPath: string | null = null;
-
-const EMPTY_RUNTIME_PLATFORM: AgentPlatformRuntime = {
-  getGlobalEnv: () => ({}),
-  getAgentEnv: () => ({}),
-  listModels: () => [],
-  listProviders: async () => [],
-  getModel: () => null,
-  getChannelAccount: () => null,
-  readChatAuthorizationConfig: () => ({ roles: {}, channels: {} }),
-  writeChatAuthorizationConfig: async (_projectRoot, nextConfig) => nextConfig,
-  setChatAuthorizationUserRole: async () => ({ roles: {}, channels: {} }),
-  isPluginEnabled: (pluginName) => pluginName === "auth",
-};
-
-/**
- * 原子更新 AgentRuntime.systems（同时覆盖 base + ready）。
- */
-function applyAgentSystems(nextSystems: string[]): void {
-  const currentBase = getAgentRuntimeBase();
-  const currentReady = (() => {
-    try {
-      return getAgentRuntime();
-    } catch {
-      return null;
-    }
-  })();
-
-  setAgentRuntimeBase({
-    ...currentBase,
-    systems: nextSystems,
-  });
-
-  if (currentReady) {
-    setAgentRuntime({
-      ...currentReady,
-      systems: nextSystems,
-    });
-  }
-}
-
-/**
- * 停止 agent 提示词文件热重载监听。
- */
-export function stopAgentHotReload(): void {
-  if (staticPromptCatalog) {
-    staticPromptCatalog.stop();
-    staticPromptCatalog = null;
-  }
-  if (configWatchPath) {
-    fs.unwatchFile(configWatchPath);
-    configWatchPath = null;
-  }
-  clearPluginRuntimeContextResolver();
-}
-
-/**
- * 刷新当前 agent 的项目配置快照。
- *
- * 关键点（中文）
- * - 这里只更新 `AgentRuntime.config`，不尝试重建长期运行对象。
- * - 适用于 plugin 启用态、prompt 注入、轻量配置读取这类直接依赖 config 的链路。
- */
-export function refreshAgentProjectConfig(): boolean {
-  const currentBase = getAgentRuntimeBase();
-  const nextConfig = loadDowncityConfig(currentBase.rootPath, {
-    projectEnv: currentBase.env,
-    globalEnv: currentBase.globalEnv,
-  });
-  const prevSerialized = JSON.stringify(currentBase.config);
-  const nextSerialized = JSON.stringify(nextConfig);
-  if (prevSerialized === nextSerialized) {
-    return false;
-  }
-  updateAgentRuntimeConfig(nextConfig);
-  return true;
-}
-
-/**
- * 启动 agent 提示词文件热重载监听（PROFILE.md / SOUL.md）。
- */
-function startAgentHotReload(): void {
-  stopAgentHotReload();
-  const agent = getAgentRuntime();
-  staticPromptCatalog = new StaticPromptCatalog({
-    rootPath: agent.rootPath,
-    logger: agent.logger,
-    getCurrentSystems: () => getAgentRuntimeBase().systems,
-    applySystems: (nextSystems) => {
-      applyAgentSystems(nextSystems);
-    },
-  });
-  staticPromptCatalog.start();
-
-  const downcityJsonPath = getDowncityJsonPath(agent.rootPath);
-  configWatchPath = downcityJsonPath;
-  fs.watchFile(
-    downcityJsonPath,
-    {
-      interval: 800,
-      persistent: false,
-    },
-    () => {
-      try {
-        const changed = refreshAgentProjectConfig();
-        if (changed) {
-          agent.logger.info("Agent config reloaded", {
-            rootPath: agent.rootPath,
-            file: downcityJsonPath,
-          });
-        }
-      } catch (error) {
-        agent.logger.warn("Failed to reload agent config", {
-          rootPath: agent.rootPath,
-          file: downcityJsonPath,
-          error: String(error),
-        });
-      }
-    },
-  );
-}
-
-/**
- * 创建 session history composer。
- */
-function createSessionHistoryComposer(
-  rootPath: string,
-  sessionId: string,
-): JsonlSessionHistoryComposer {
-  const parsedRun = parseTaskRunSessionId(sessionId);
-  const paths = parsedRun
-    ? (() => {
-        const runDir = getTaskRunDir(
-          rootPath,
-          parsedRun.taskId,
-          parsedRun.timestamp,
-        );
-        return {
-          sessionDirPath: runDir,
-        };
-      })()
-    : undefined;
-  return new JsonlSessionHistoryComposer({
-    sessionId,
-    rootPath,
-    ...(paths ? { paths } : {}),
-  });
-}
-
-/**
- * 初始化入口。
- *
- * 关键点（中文）
- * - 只有 api 执行模式：从 console 模型池创建模型 → LocalSessionExecutor → LocalSessionCore。
- */
-export async function initAgentRuntime(
-  cwd: string,
-  options?: {
-    platform?: AgentPlatformRuntime;
-    globalEnv?: Record<string, string>;
-    projectEnv?: Record<string, string>;
-  },
-): Promise<void> {
-  stopAgentHotReload();
-  resetPluginManager();
-
-  const resolvedCwd = String(cwd || "").trim() || ".";
-  const rootPath = path.resolve(resolvedCwd);
-
-  defaultLogger.bindProjectRoot(rootPath);
-  ensureRuntimeProjectReady(rootPath);
-
-  const platform = options?.platform || EMPTY_RUNTIME_PLATFORM;
-  const globalEnv = options?.globalEnv || platform?.getGlobalEnv() || loadGlobalEnvFromStore();
-  const projectEnv =
-    options?.projectEnv ||
-    platform?.getAgentEnv(rootPath) ||
-    loadAgentEnvSnapshot(rootPath);
-  const config = loadDowncityConfig(rootPath, {
-    projectEnv,
-    globalEnv,
-  });
-
-  process.env.DC_AGENT_PATH = rootPath;
-  process.env.DC_AGENT_NAME = String(config.name || path.basename(rootPath));
-
-  setAgentRuntimeBase({
-    cwd: resolvedCwd,
-    rootPath,
-    logger: defaultLogger,
-    config,
-    env: projectEnv,
-    globalEnv,
-    systems: [],
-    paths: createAgentPathRuntime(rootPath),
-    pluginConfig: createAgentPluginConfigRuntime(rootPath),
-    platform: platform,
-  });
-
-  const systems = loadStaticSystemPrompts(rootPath);
-  setAgentRuntimeBase({
-    cwd: resolvedCwd,
-    rootPath,
-    logger: defaultLogger,
-    config,
-    env: projectEnv,
-    globalEnv,
-    systems,
-    paths: createAgentPathRuntime(rootPath),
-    pluginConfig: createAgentPluginConfigRuntime(rootPath),
-    platform: platform,
-  });
-
-  const primaryModelId = readProjectPrimaryModelId(config);
-  const model = await createModel({
-    config,
-    getSessionRunScope: getSessionRunScope,
-    projectRoot: rootPath,
-    platform,
-  });
-
-  const compactionComposer = new JsonlSessionCompactionComposer({
-    keepLastMessages: config.context?.messages?.keepLastMessages,
-    maxInputTokensApprox: config.context?.messages?.maxInputTokensApprox,
-    archiveOnCompact: config.context?.messages?.archiveOnCompact,
-    compactRatio: config.context?.messages?.compactRatio,
-  });
-
-  const systemComposer = new DefaultSessionSystemComposer({
-    projectRoot: rootPath,
-    getStaticSystemPrompts: () => getAgentRuntimeBase().systems,
-    getContext: () => getAgentContext(),
-    profile: "chat",
-  });
-
-  const sessionsById = new Map<string, ChatSession>();
-  const getSession = (sessionId: string): ChatSession => {
-    const key = String(sessionId || "").trim();
-    if (!key) {
-      throw new Error("AgentRuntime.getSession requires a non-empty sessionId");
-    }
-    const existing = sessionsById.get(key);
-    if (existing) return existing;
-
-    const historyComposer = createSessionHistoryComposer(rootPath, key);
-    const executionComposer = new ChatSessionExecutionComposer({
-      sessionId: key,
-      getTools: () => shellTools,
-      getTurnState: () => created.getTurnState(),
-    });
-    let created!: ChatSession;
-    created = new ChatSession({
-      sessionId: key,
-      historyComposer,
-      executionComposer,
-      createExecutor: (
-        sessionHistoryComposer: SessionHistoryComposer,
-        chatExecutionComposer: ChatSessionExecutionComposer,
-      ) =>
-        new LocalSessionExecutor({
-          model,
-          logger: defaultLogger,
-          historyComposer: sessionHistoryComposer,
-          compactionComposer,
-          systemComposer,
-          getTools: () => shellTools,
-          executionComposer: chatExecutionComposer,
-        }),
-    });
-    sessionsById.set(key, created);
-    return created;
-  };
-
-  const agentState: AgentRuntime = {
-    cwd: resolvedCwd,
-    rootPath,
-    logger: defaultLogger,
-    config,
-    env: projectEnv,
-    globalEnv,
-    systems,
-    paths: createAgentPathRuntime(rootPath),
-    pluginConfig: createAgentPluginConfigRuntime(rootPath),
-    platform: platform,
-    model,
-    getSession,
-    listExecutingSessionIds: () =>
-      [...sessionsById.entries()]
-        .filter(([, session]) => session.isExecuting())
-        .map(([sessionId]) => sessionId),
-    getExecutingSessionCount: () =>
-      [...sessionsById.values()].filter((session) => session.isExecuting())
-        .length,
-    services: new Map(),
-  };
-  agentState.services = createRegisteredServiceInstances(agentState);
-
-  setAgentRuntime(agentState);
-  setPluginRuntimeContextResolver(() => getAgentContext());
-  initializePluginManager();
-  setShellToolRuntime(getAgentContext().invoke);
-  startAgentHotReload();
-}

package/src/agent/AgentRuntimeState.ts

@@ -1,213 +0,0 @@
-/**
- * AgentRuntime 进程级状态读写模块。
- *
- * 关键点（中文）
- * - 这里统一维护当前进程中的 base / ready 两阶段状态。
- * - `AgentRuntimeBase` 只表示启动早期已经可用的基础配置；`AgentRuntime` 才表示完整运行态。
- * - 该模块只负责状态持有与读写，不负责装配具体依赖对象。
- */
-
-import type { LanguageModel } from "ai";
-import type {
-  AgentRuntime,
-  AgentRuntimeBase,
-} from "@/agent/AgentRuntimeTypes.js";
-import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
-import type {
-  AgentPathRuntime,
-  AgentPlatformRuntime,
-  AgentPluginConfigRuntime,
-} from "@/shared/types/AgentHost.js";
-import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
-export type { AgentRuntime, AgentRuntimeBase } from "@/agent/AgentRuntimeTypes.js";
-
-let baseState: AgentRuntimeBase | null = null;
-let readyState: AgentRuntime | null = null;
-
-const EMPTY_PATHS: AgentPathRuntime = {
-  projectRoot: ".",
-  getDowncityDirPath: () => ".downcity",
-  getCacheDirPath: () => ".downcity/.cache",
-  getDowncityChannelDirPath: () => ".downcity/channel",
-  getDowncityChannelMetaPath: () => ".downcity/channel/meta.json",
-  getDowncityChatHistoryPath: (sessionId) => `.downcity/chat/${sessionId}/history.jsonl`,
-  getDowncityMemoryLongTermPath: () => ".downcity/memory/MEMORY.md",
-  getDowncityMemoryDailyDirPath: () => ".downcity/memory/daily",
-  getDowncityMemoryDailyPath: (date) => `.downcity/memory/daily/${date}.md`,
-  getDowncitySessionRootDirPath: () => ".downcity/session",
-  getDowncitySessionDirPath: (sessionId) => `.downcity/session/${sessionId}`,
-};
-
-const EMPTY_PLUGIN_CONFIG: AgentPluginConfigRuntime = {
-  async persistProjectPlugins() {
-    return "";
-  },
-};
-
-const EMPTY_PLATFORM: AgentPlatformRuntime = {
-  getGlobalEnv: () => ({}),
-  getAgentEnv: () => ({}),
-  listModels: () => [],
-  listProviders: async () => [],
-  getModel: () => null,
-  getChannelAccount: () => null,
-  listChannelAccounts: async () => [],
-  probeChannelAccount: async () => {
-    throw new Error("Channel account probing is not available in this runtime");
-  },
-  createChannelAccount: async () => {
-    throw new Error("Channel account creation is not available in this runtime");
-  },
-  updateChannelAccount: async () => {
-    throw new Error("Channel account update is not available in this runtime");
-  },
-  removeChannelAccount: async () => {
-    throw new Error("Channel account removal is not available in this runtime");
-  },
-  resolveChannelAccount: (_params: {
-    projectRoot: string;
-    channel: ChatChannelName;
-    channelAccountId?: string;
-  }) => null,
-  readChatAuthorizationConfig: () => ({
-    roles: {},
-    channels: {},
-  }),
-  writeChatAuthorizationConfig: async (_projectRoot, nextConfig) => nextConfig,
-  setChatAuthorizationUserRole: async () => ({
-    roles: {},
-    channels: {},
-  }),
-  isPluginEnabled: (pluginName) => pluginName === "auth",
-  setPluginEnabled: () => {
-    throw new Error("Plugin lifecycle management is not available in this runtime");
-  },
-  listPlatformModelChoices: async () => [],
-  initializeAgentProject: async () => {
-    throw new Error("Agent project initialization is not available in this runtime");
-  },
-  ensureRuntimeExecutionBindingReady: () => {
-    throw new Error("Execution binding validation is not available in this runtime");
-  },
-};
-
-function normalizeReadyState(input: AgentRuntime): AgentRuntime {
-  if (typeof input.getSession !== "function") {
-    throw new Error("AgentRuntime requires getSession");
-  }
-
-  return {
-    cwd: input.cwd,
-    rootPath: input.rootPath,
-    logger: input.logger,
-    config: input.config,
-    env: input.env,
-    globalEnv: input.globalEnv,
-    systems: input.systems,
-    paths: input.paths || EMPTY_PATHS,
-    pluginConfig: input.pluginConfig || EMPTY_PLUGIN_CONFIG,
-    platform: input.platform || EMPTY_PLATFORM,
-    model: input.model,
-    getSession: input.getSession,
-    listExecutingSessionIds:
-      input.listExecutingSessionIds || (() => []),
-    getExecutingSessionCount:
-      input.getExecutingSessionCount || (() => 0),
-    services: input.services || new Map(),
-  };
-}
-
-function normalizeBaseState(input: AgentRuntimeBase): AgentRuntimeBase {
-  return {
-    cwd: input.cwd,
-    rootPath: input.rootPath,
-    logger: input.logger,
-    config: input.config,
-    env: input.env,
-    globalEnv: input.globalEnv,
-    systems: input.systems,
-    paths: input.paths || EMPTY_PATHS,
-    pluginConfig: input.pluginConfig || EMPTY_PLUGIN_CONFIG,
-    platform: input.platform || EMPTY_PLATFORM,
-  };
-}
-
-/**
- * 设置 agent 基础状态。
- */
-export function setAgentRuntimeBase(next: AgentRuntimeBase): void {
-  baseState = normalizeBaseState(next);
-  readyState = null;
-}
-
-/**
- * 设置完整 agent 状态。
- */
-export function setAgentRuntime(next: AgentRuntime): void {
-  const normalized = normalizeReadyState(next);
-  baseState = normalized;
-  readyState = normalized;
-}
-
-/**
- * 仅更新当前 agent 的项目配置快照。
- *
- * 关键点（中文）
- * - 运行中 agent 可能在不重启进程的情况下收到 downcity.json 变更。
- * - 这里仅替换 `config`，不重建 model / service / session 等长期对象。
- * - 目标是让 plugin 启用态、system 注入等直接依赖配置快照的能力及时生效。
- */
-export function updateAgentRuntimeConfig(nextConfig: DowncityConfig): void {
-  if (!baseState) {
-    throw new Error(
-      "Agent state is not initialized. Call initAgentRuntime() during startup.",
-    );
-  }
-
-  baseState = {
-    ...baseState,
-    config: nextConfig,
-  };
-
-  if (readyState) {
-    readyState = {
-      ...readyState,
-      config: nextConfig,
-    };
-  }
-}
-
-/**
- * 获取 agent 基础状态。
- */
-export function getAgentRuntimeBase(): AgentRuntimeBase {
-  if (baseState) return baseState;
-  throw new Error(
-    "Agent state (base) is not initialized. Call initAgentRuntime() during startup.",
-  );
-}
-
-/**
- * 获取完整 agent 状态。
- */
-export function getAgentRuntime(): AgentRuntime {
-  if (readyState) return readyState;
-  if (!baseState) {
-    throw new Error(
-      "Agent state is not initialized. Call initAgentRuntime() during startup.",
-    );
-  }
-  throw new Error(
-    "Agent state is not ready yet. Ensure session is initialized before access.",
-  );
-}
-
-/**
- * 读取当前 agent 模型实例（必填）。
- */
-export function requireAgentModel(): LanguageModel {
-  if (readyState?.model) return readyState.model;
-  throw new Error(
-    "Agent model is not initialized. Ensure initAgentRuntime() completed successfully.",
-  );
-}

package/src/agent/AgentRuntimeTypes.ts

@@ -1,91 +0,0 @@
-/**
- * AgentRuntime 类型定义。
- *
- * 关键点（中文）
- * - 这里表达的是“当前 agent 进程的长期运行状态”。
- * - 它不是抽象 host，也不是一次执行上下文。
- * - Session / Service / Plugin 这些长期对象都应从这里挂出。
- */
-
-import type { LanguageModel } from "ai";
-import type { Logger } from "@shared/utils/logger/Logger.js";
-import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
-import type {
-  AgentPathRuntime,
-  AgentPlatformRuntime,
-  AgentPluginConfigRuntime,
-} from "@/shared/types/AgentHost.js";
-import type { BaseService } from "@/service/builtins/BaseService.js";
-import type { Session } from "@session/Session.js";
-
-/**
- * AgentRuntime 启动早期的基础状态。
- */
-export interface AgentRuntimeBase {
-  /**
-   * 当前命令工作目录。
-   */
-  cwd: string;
-  /**
-   * 当前 agent 项目根目录。
-   */
-  rootPath: string;
-  /**
-   * 当前统一日志器。
-   */
-  logger: Logger;
-  /**
-   * 当前解析后的项目配置。
-   */
-  config: DowncityConfig;
-  /**
-   * 当前 agent 局部环境变量快照。
-   */
-  env: Record<string, string>;
-  /**
-   * 当前平台级全局环境变量快照。
-   */
-  globalEnv: Record<string, string>;
-  /**
-   * 当前生效的静态 system 文本集合。
-   */
-  systems: string[];
-  /**
-   * 当前 agent 可见的路径能力集合。
-   */
-  paths: AgentPathRuntime;
-  /**
-   * 当前 agent 可见的 plugin 配置持久化能力集合。
-   */
-  pluginConfig: AgentPluginConfigRuntime;
-  /**
-   * 当前 agent 可见的平台能力集合。
-   */
-  platform: AgentPlatformRuntime;
-}
-
-/**
- * Agent 进程完整运行状态。
- */
-export interface AgentRuntime extends AgentRuntimeBase {
-  /**
-   * 当前统一执行模型实例。
-   */
-  model?: LanguageModel;
-  /**
-   * 读取指定 sessionId 对应的 Session 实例。
-   */
-  getSession(sessionId: string): Session;
-  /**
-   * 返回当前执行中的 sessionId 列表。
-   */
-  listExecutingSessionIds(): string[];
-  /**
-   * 返回当前执行中的 session 数量。
-   */
-  getExecutingSessionCount(): number;
-  /**
-   * 当前 agent 持有的 service instances。
-   */
-  services: Map<string, BaseService>;
-}