@downcity/agent 1.1.13 → 1.1.14

package/src/runtime/AgentContext.ts

@@ -1,182 +0,0 @@
-/**
- * AgentContext：agent 能力上下文构造模块。
- *
- * 关键点（中文）
- * - 这里负责从 `AgentRuntime` 派生统一执行上下文，供 service、plugin、session tool 复用。
- * - `AgentContext` 表达的是“执行期能力面”，不是宿主本体；真正的宿主状态仍由 `AgentRuntime` 持有。
- * - 该模块把 service invoke、plugin port、chat runtime port 收敛成稳定端口集合。
- */
-
-import type {
-  ChatRuntimePort,
-  AgentContext,
-  InvokeServicePort,
-  SessionCollectionPort,
-} from "@/runtime/AgentContextTypes.js";
-import type { JsonValue } from "@/types/common/Json.js";
-import type {
-  PluginAvailability,
-  PluginPort,
-  PluginView,
-} from "@/plugin/types/Plugin.js";
-import type { AgentRuntime } from "@/runtime/AgentRuntimeTypes.js";
-import { runServiceCommand } from "@/service/core/Manager.js";
-import { getPluginManager } from "@/plugin/core/PluginManager.js";
-import { getAgentRuntime } from "@/runtime/AgentRuntimeState.js";
-import { appendExecSessionMessage } from "@/service/builtins/chat/runtime/ChatIngressStore.js";
-import { readChatMetaBySessionId } from "@/service/builtins/chat/runtime/ChatMetaStore.js";
-import { resolveChatQueueStore } from "@/service/builtins/chat/runtime/ChatQueue.js";
-
-/**
- * service 调用端口实现。
- */
-const serviceInvokePort: InvokeServicePort = {
-  async invoke(params: {
-    service: string;
-    action: string;
-    payload?: JsonValue;
-  }) {
-    const serviceName = String(params.service || "").trim();
-    const action = String(params.action || "").trim();
-    if (!serviceName) {
-      return {
-        success: false,
-        error: "invoke.service is required",
-      };
-    }
-    if (!action) {
-      return {
-        success: false,
-        error: "invoke.action is required",
-      };
-    }
-
-    const result = await runServiceCommand({
-      serviceName,
-      command: action,
-      payload: params.payload,
-      context: getAgentContext(),
-    });
-    if (!result.success) {
-      return {
-        success: false,
-        error: result.message || "service invoke failed",
-      };
-    }
-
-    return {
-      success: true,
-      ...(result.data !== undefined ? { data: result.data } : {}),
-    };
-  },
-};
-
-/**
- * 构建 session 端口。
- */
-function buildSessionPort(input: AgentRuntime): SessionCollectionPort {
-  return {
-    get: (sessionId) => input.getSession(sessionId),
-    listExecutingSessionIds: () => input.listExecutingSessionIds(),
-    getExecutingSessionCount: () => input.getExecutingSessionCount(),
-    ...(input.model ? { model: input.model } : {}),
-  };
-}
-
-/**
- * 构建 plugin 端口。
- */
-function buildPluginPort(input: AgentRuntime): PluginPort {
-  return {
-    list(): PluginView[] {
-      return getPluginManager().list();
-    },
-    async availability(pluginName: string): Promise<PluginAvailability> {
-      return getPluginManager().availability(pluginName);
-    },
-    async runAction(params: {
-      plugin: string;
-      action: string;
-      payload?: JsonValue;
-    }) {
-      return getPluginManager().runAction(params);
-    },
-    async pipeline<T = JsonValue>(pointName: string, value: T): Promise<T> {
-      return getPluginManager().pipeline(pointName, value);
-    },
-    async guard<T = JsonValue>(pointName: string, value: T): Promise<void> {
-      return getPluginManager().guard(pointName, value);
-    },
-    async effect<T = JsonValue>(pointName: string, value: T): Promise<void> {
-      return getPluginManager().effect(pointName, value);
-    },
-    async resolve<TInput = JsonValue, TOutput = JsonValue>(
-      pointName: string,
-      value: TInput,
-    ): Promise<TOutput> {
-      return getPluginManager().resolve<TInput, TOutput>(pointName, value);
-    },
-  };
-}
-
-/**
- * 构建 chat 运行时端口。
- */
-function buildChatPort(getContext: () => AgentContext): ChatRuntimePort {
-  return {
-    async readMetaBySessionId(sessionId: string) {
-      return readChatMetaBySessionId({
-        context: getContext(),
-        sessionId,
-      });
-    },
-    async appendExecSessionMessage(params) {
-      await appendExecSessionMessage({
-        context: getContext(),
-        sessionId: params.sessionId,
-        text: params.text,
-        extra: params.extra,
-      });
-    },
-    enqueue(params) {
-      return resolveChatQueueStore(getContext()).enqueue(params);
-    },
-  };
-}
-
-/**
- * 从 agent 状态派生统一执行上下文。
- */
-export function createAgentContext(input: AgentRuntime): AgentContext {
-  let context!: AgentContext;
-  context = {
-    agent: input,
-    cwd: input.cwd,
-    rootPath: input.rootPath,
-    logger: input.logger,
-    config: input.config,
-    env: input.env,
-    globalEnv: input.globalEnv,
-    systems: input.systems,
-    paths: input.paths,
-    pluginConfig: input.pluginConfig,
-    platform: input.platform,
-    session: buildSessionPort(input),
-    invoke: serviceInvokePort,
-    chat: buildChatPort(() => context),
-    plugins: buildPluginPort(input),
-  };
-  return context;
-}
-
-/**
- * 读取当前 agent 的统一执行上下文。
- */
-export function getAgentContext(): AgentContext {
-  return createAgentContext(getAgentRuntime());
-}
-
-/**
- * 关键点（中文）
- * - 当前文件内的 service invoke port 既服务于 AgentContext，也可直接注入 shell tool。
- */

package/src/runtime/AgentRuntime.ts

@@ -1,366 +0,0 @@
-/**
- * AgentRuntime：agent 宿主装配与导出模块。
- *
- * 关键点（中文）
- * - 这里是单 agent 宿主的主装配入口，负责把 config、model、session、service、plugin 串起来。
- * - 完整运行态类型仍由 `AgentRuntimeState.ts` 维护；本模块只负责装配与对外导出。
- * - 该模块同时负责热重载提示词系统与导出统一的 `getAgentContext()` 入口。
- * - 当前只有 `api` 执行模式：从 console 模型池取模型，走 Runner。
- */
-
-import path from "path";
-import fs from "fs";
-import { logger as defaultLogger } from "@/utils/logger/Logger.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 { 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 "@/runtime/AgentContext.js";
-import {
-  getAgentRuntime,
-  getAgentRuntimeBase,
-  setAgentRuntime,
-  setAgentRuntimeBase,
-  type AgentRuntime,
-} from "@/runtime/AgentRuntimeState.js";
-import { createRegisteredServiceInstances } from "@/service/core/ServiceClassRegistry.js";
-import { readProjectPrimaryModelId } from "@/project/ProjectExecutionBinding.js";
-import { initializePluginManager, resetPluginManager } from "@/plugin/core/PluginManager.js";
-import {
-  clearPluginRuntimeContextResolver,
-  setPluginRuntimeContextResolver,
-} from "@/host/runtime/PluginRuntime.js";
-import {
-  createAgentPathRuntime,
-  createAgentPluginConfigRuntime,
-} from "@/host/runtime/AgentHostRuntime.js";
-import { updateAgentRuntimeConfig } from "@/runtime/AgentRuntimeState.js";
-import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
-
-export type { AgentRuntimeBase, AgentRuntime } from "@/runtime/AgentRuntimeState.js";
-export {
-  getAgentRuntime,
-  getAgentRuntimeBase,
-  setAgentRuntime,
-  setAgentRuntimeBase,
-  requireAgentModel,
-} from "@/runtime/AgentRuntimeState.js";
-export { getAgentContext } from "@/runtime/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 模型池创建模型 → Executor → Runner。
- */
-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,
-      getModel: () => model,
-      logger: defaultLogger,
-      compactionComposer,
-      systemComposer,
-      getTools: () => shellTools,
-    });
-    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();
-}