@downcity/agent 1.1.25 → 1.1.32

package/src/service/builtins/chat/runtime/ChatServiceActions.ts

@@ -1,367 +0,0 @@
-/**
- * ChatServiceActions：chat service 的 action 注册表模块。
- *
- * 关键点（中文）
- * - 这里专门负责把 chat 的 CLI/execute 定义装配成 `ServiceActions`。
- * - ChatService 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
- * - action 执行仍然复用各 runtime 模块，确保行为与现有实现保持一致。
- */
-
-import type { Command } from "commander";
-import type { ServiceActions } from "@/service/types/Service.js";
-import type {
-  ChatCloseActionPayload,
-  ChatConfigurationActionPayload,
-  ChatConfigureActionPayload,
-  ChatDeleteActionPayload,
-  ChatHistoryActionPayload,
-  ChatInfoActionPayload,
-  ChatListActionPayload,
-  ChatOpenActionPayload,
-  ChatReactActionPayload,
-  ChatReconnectActionPayload,
-  ChatSendActionPayload,
-  ChatSessionActionPayload,
-  ChatStatusActionPayload,
-  ChatTestActionPayload,
-} from "@/service/builtins/chat/types/ChatService.js";
-import type { ChatChannelState } from "@/service/builtins/chat/types/ChatRuntime.js";
-import {
-  mapChatChannelCommandInput,
-  mapChatConfigureCommandInput,
-  mapChatDeleteCommandInput,
-  mapChatHistoryCommandInput,
-  mapChatInfoCommandInput,
-  mapChatListCommandInput,
-  mapChatReactCommandInput,
-  mapChatSendCommandInput,
-} from "./ChatActionInput.js";
-import {
-  executeChatContextAction,
-  executeChatDeleteAction,
-  executeChatHistoryAction,
-  executeChatInfoAction,
-  executeChatListAction,
-  executeChatReactAction,
-  executeChatSendAction,
-} from "./ChatActionExecution.js";
-import {
-  executeChatCloseAction,
-  executeChatConfigurationAction,
-  executeChatConfigureAction,
-  executeChatOpenAction,
-  executeChatReconnectAction,
-  executeChatStatusAction,
-  executeChatTestAction,
-} from "./ChatChannelFacade.js";
-
-const CHAT_SEND_HELP_TEXT = [
-  "",
-  "消息协议：",
-  "  frontmatter metadata 字段语义与 `city chat send` 参数一致。",
-  "  附件使用 `<file type=\"...\">path</file>`，支持 `document/photo/voice/audio/video`。",
-  "  正文与 `<file>` 可以交错出现，运行时会按原顺序发送。",
-  "",
-  "常用示例：",
-  "  city chat send --text 'done'",
-  "  city chat send --chat-key <chatKey> --text 'done'",
-  "  cat <<'EOF' | city chat send --stdin --chat-key <chatKey>",
-  "  第一行",
-  "  第二行",
-  "  EOF",
-  "  city chat send --text-file ./result.md --chat-key <chatKey>",
-  "",
-  "说明：",
-  "  当前会话可省略 `--chat-key`；跨 chat 发送时必须显式传 `--chat-key`。",
-  "  `--delay` 与 `--time` 互斥；ISO 时间必须带时区。",
-].join("\n");
-
-const CHAT_REACT_HELP_TEXT = [
-  "",
-  "常用示例：",
-  "  city chat react --emoji '👍'",
-  "  city chat react --emoji '✅' --message-id <messageId>",
-  "  city chat react --chat-key <chatKey> --message-id <messageId> --emoji '🔥'",
-  "",
-  "说明：",
-  "  当前会话可省略 `--chat-key`；跨 chat 操作时显式传 `--chat-key`。",
-  "  `react` 需要目标消息，优先使用显式 `--message-id`。",
-].join("\n");
-
-function attachCommandHelpText(command: Command, text: string): void {
-  command.on("--help", () => {
-    console.log(text);
-  });
-}
-
-/**
- * 创建 chat service 的 action 定义表。
- */
-export function createChatServiceActions(params: {
-  channelState: ChatChannelState;
-}): ServiceActions {
-  return {
-    status: {
-      command: {
-        description: "查看 chat 渠道连接状态",
-        configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
-        },
-        mapInput: mapChatChannelCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatStatusAction({
-          state: params.channelState,
-          context: actionParams.context,
-          payload: actionParams.payload as ChatStatusActionPayload,
-        });
-      },
-    },
-    test: {
-      command: {
-        description: "测试 chat 渠道连通性",
-        configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
-        },
-        mapInput: mapChatChannelCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatTestAction({
-          state: params.channelState,
-          context: actionParams.context,
-          payload: actionParams.payload as ChatTestActionPayload,
-        });
-      },
-    },
-    reconnect: {
-      command: {
-        description: "重连 chat 渠道（默认全部）",
-        configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
-        },
-        mapInput: mapChatChannelCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatReconnectAction({
-          state: params.channelState,
-          context: actionParams.context,
-          payload: actionParams.payload as ChatReconnectActionPayload,
-        });
-      },
-    },
-    open: {
-      command: {
-        description: "打开 chat 渠道（enabled=true，已配置则尝试启动）",
-        configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
-        },
-        mapInput: mapChatChannelCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatOpenAction({
-          state: params.channelState,
-          context: actionParams.context,
-          payload: actionParams.payload as ChatOpenActionPayload,
-        });
-      },
-    },
-    close: {
-      command: {
-        description: "关闭 chat 渠道（enabled=false，并停止运行）",
-        configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
-        },
-        mapInput: mapChatChannelCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatCloseAction({
-          state: params.channelState,
-          context: actionParams.context,
-          payload: actionParams.payload as ChatCloseActionPayload,
-        });
-      },
-    },
-    configuration: {
-      command: {
-        description: "查看 chat 渠道配置元信息（字段、类型、说明）",
-        configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
-        },
-        mapInput: mapChatChannelCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatConfigurationAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatConfigurationActionPayload,
-        });
-      },
-    },
-    configure: {
-      command: {
-        description: "更新 chat 渠道参数（写入 downcity.json，可选立即重载）",
-        configure(command: Command) {
-          command
-            .requiredOption("--channel <name>", "指定渠道（telegram|feishu|qq）")
-            .requiredOption(
-              "--config-json <json>",
-              "配置 patch JSON（例如 '{\"channelAccountId\":\"qq-main\",\"enabled\":true}'）",
-            )
-            .option("--restart", "配置后立即重载渠道", false);
-        },
-        mapInput: mapChatConfigureCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatConfigureAction({
-          state: params.channelState,
-          context: actionParams.context,
-          payload: actionParams.payload as ChatConfigureActionPayload,
-        });
-      },
-    },
-    list: {
-      command: {
-        description: "列出当前 agent 已记录的 chat 会话（chatTitle/chatKey）",
-        configure(command: Command) {
-          command
-            .option("--channel <name>", "渠道过滤（telegram|feishu|qq）")
-            .option("--limit <n>", "返回最近 N 条（默认 50）")
-            .option("--q <text>", "关键词过滤（title/chatId/sessionId/actor）");
-        },
-        mapInput: mapChatListCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatListAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatListActionPayload,
-        });
-      },
-    },
-    info: {
-      command: {
-        description: "查看指定 chat 会话信息（路由/本地路径/上下文快照）",
-        configure(command: Command) {
-          command
-            .option("--chat-key <chatKey>", "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）")
-            .option("--session-id <sessionId>", "显式指定 sessionId（优先级更高）");
-        },
-        mapInput: mapChatInfoCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatInfoAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatInfoActionPayload,
-        });
-      },
-    },
-    send: {
-      command: {
-        description: "发送消息到目标 chatKey",
-        configure(command: Command) {
-          command
-            .option("--text <text>", "消息正文")
-            .option("--stdin", "从标准输入读取消息正文", false)
-            .option("--text-file <file>", "从文件读取消息正文（相对当前目录）")
-            .option("--reply", "显式使用 reply_to_message 回复目标消息", false)
-            .option("--message-id <id>", "显式指定 reply 目标消息 ID")
-            .option(
-              "--chat-key <chatKey>",
-              "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）",
-            );
-          attachCommandHelpText(command, CHAT_SEND_HELP_TEXT);
-        },
-        mapInput: mapChatSendCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatSendAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatSendActionPayload,
-        });
-      },
-    },
-    react: {
-      command: {
-        description: "给目标消息贴表情（当前仅 Telegram 支持）",
-        configure(command: Command) {
-          command
-            .option("--emoji <emoji>", "表情字符（默认 👍）")
-            .option("--big", "使用大表情效果（Telegram is_big）", false)
-            .option("--message-id <id>", "目标消息 ID（默认尝试从 chat meta 回填）")
-            .option(
-              "--chat-key <chatKey>",
-              "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）",
-            );
-          attachCommandHelpText(command, CHAT_REACT_HELP_TEXT);
-        },
-        mapInput: mapChatReactCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatReactAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatReactActionPayload,
-        });
-      },
-    },
-    context: {
-      command: {
-        description: "查看当前会话上下文快照",
-        configure(command: Command) {
-          command.option("--chat-key <chatKey>", "显式覆盖 chatKey");
-        },
-        mapInput(input) {
-          const chatKey =
-            typeof input.opts.chatKey === "string" ? String(input.opts.chatKey).trim() : "";
-          return {
-            ...(chatKey ? { chatKey } : {}),
-          };
-        },
-      },
-      execute: async (actionParams) => {
-        return executeChatContextAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatSessionActionPayload,
-        });
-      },
-    },
-    delete: {
-      command: {
-        description: "彻底删除指定 chat 会话（映射+历史+context）",
-        configure(command: Command) {
-          command
-            .option("--chat-key <chatKey>", "显式指定 chatKey")
-            .option("--session-id <sessionId>", "显式指定 sessionId");
-        },
-        mapInput: mapChatDeleteCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatDeleteAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatDeleteActionPayload,
-        });
-      },
-    },
-    history: {
-      command: {
-        description: "读取 chat 历史消息（默认最近 30 条）",
-        configure(command: Command) {
-          command
-            .option("--chat-key <chatKey>", "显式覆盖 chatKey")
-            .option("--session-id <sessionId>", "显式覆盖 sessionId")
-            .option("--limit <n>", "返回最近 N 条（默认 30）")
-            .option(
-              "--direction <direction>",
-              "方向过滤（all|inbound|outbound）",
-            )
-            .option("--before-ts <ts>", "仅返回 ts 小于该值的记录（毫秒）")
-            .option("--after-ts <ts>", "仅返回 ts 大于该值的记录（毫秒）");
-        },
-        mapInput: mapChatHistoryCommandInput,
-      },
-      execute: async (actionParams) => {
-        return executeChatHistoryAction({
-          context: actionParams.context,
-          payload: actionParams.payload as ChatHistoryActionPayload,
-        });
-      },
-    },
-  };
-}

package/src/service/builtins/chat/runtime/ChatServiceSystem.ts

@@ -1,70 +0,0 @@
-/**
- * ChatServiceSystem：chat service 的 system prompt 组装模块。
- *
- * 关键点（中文）
- * - chat service prompt 与 channel prompt 都属于静态资产。
- * - 当前请求只注入当前 channel 的 prompt，避免平台规则串味。
- * - 该模块只负责 prompt 解析与拼装，不承担运行态控制职责。
- */
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import {
-  buildCurrentChatEnvironmentPrompt,
-  resolveCurrentChatEnvironmentPromptInput,
-} from "@/service/builtins/chat/runtime/SystemPrompt.js";
-import {
-  CHAT_SERVICE_PROMPT,
-  FEISHU_CHAT_CHANNEL_PROMPT,
-  QQ_CHAT_CHANNEL_PROMPT,
-  TELEGRAM_CHAT_CHANNEL_PROMPT,
-} from "@/service/builtins/chat/runtime/ChatPromptAssets.js";
-
-const CHAT_CHANNEL_PROMPTS: Record<"telegram" | "feishu" | "qq", string> = {
-  telegram: TELEGRAM_CHAT_CHANNEL_PROMPT,
-  feishu: FEISHU_CHAT_CHANNEL_PROMPT,
-  qq: QQ_CHAT_CHANNEL_PROMPT,
-};
-
-function resolveCurrentChatPromptChannel(
-  channel: string,
-): "telegram" | "feishu" | "qq" | null {
-  if (channel === "telegram" || channel === "feishu" || channel === "qq") {
-    return channel;
-  }
-  return null;
-}
-
-/**
- * 构建当前请求所属 channel 的提示词片段。
- *
- * 关键点（中文）
- * - 仅注入当前 context 对应的 channel prompt，避免把其他平台规则混入本轮会话。
- * - 若当前 context 不是 chat channel（如 consoleui）或尚无路由元信息，则不注入 channel prompt。
- */
-export async function buildCurrentChannelPrompts(
-  context: AgentContext,
-): Promise<string[]> {
-  const chatEnvironment = await resolveCurrentChatEnvironmentPromptInput(context);
-  if (!chatEnvironment) return [];
-  const channel = resolveCurrentChatPromptChannel(
-    String(chatEnvironment.channel || "")
-      .trim()
-      .toLowerCase(),
-  );
-  if (!channel) return [];
-  return [CHAT_CHANNEL_PROMPTS[channel]].filter(Boolean);
-}
-
-/**
- * 构建 chat service 注入到 session 的 system 文本。
- */
-export async function buildChatServiceSystem(
-  context: AgentContext,
-): Promise<string> {
-  return [
-    CHAT_SERVICE_PROMPT,
-    await buildCurrentChatEnvironmentPrompt(context),
-    ...(await buildCurrentChannelPrompts(context)),
-  ]
-    .filter(Boolean)
-    .join("\n\n");
-}

package/src/service/builtins/chat/runtime/ChatSession.ts

@@ -1,156 +0,0 @@
-/**
- * ChatSession：chat 专用 Executor 实现。
- *
- * 关键点（中文）
- * - ChatSession 在实例化时持有自己的 context composer 实例。
- * - chat 当前 turn 的 step 合并/step 回发状态都绑定在 Session 自身，不再新增 `runChat` 一层入口。
- * - 外层仍只调用标准 `run(...)`；chat 语义由 ChatSession 内部收敛。
- */
-
-import type { LanguageModel, Tool } from "ai";
-import { Executor } from "@session/Executor.js";
-import type { SessionHistoryComposer } from "@session/composer/history/SessionHistoryComposer.js";
-import type { SessionHistoryStore } from "@/session/store/history/SessionHistoryStore.js";
-import type { SessionCompactionComposer } from "@session/composer/compaction/SessionCompactionComposer.js";
-import type { SessionSystemComposer } from "@session/composer/system/SessionSystemComposer.js";
-import type { ChatSessionContextComposer } from "@/service/builtins/chat/runtime/ChatSessionContextComposer.js";
-import type { Logger } from "@/utils/logger/Logger.js";
-import type { SessionAssistantStepCallback } from "@/session/types/SessionRun.js";
-import type { SessionRunResult } from "@/session/types/SessionRun.js";
-import type { ChatSessionTurnState } from "@/service/builtins/chat/runtime/ChatSessionTypes.js";
-
-type ChatSessionOptions = {
-  /**
-   * 当前会话 ID。
-   */
-  sessionId: string;
-
-  /**
-   * 当前 session 的 history store。
-   */
-  historyStore: SessionHistoryStore;
-
-  /**
-   * 当前 session 的 history composer。
-   */
-  historyComposer: SessionHistoryComposer;
-
-  /**
-   * 读取当前 session 使用的模型实例。
-   */
-  getModel: () => LanguageModel | undefined;
-
-  /**
-   * 统一日志器。
-   */
-  logger: Logger;
-
-  /**
-   * 当前 session 对应的 compaction Composer。
-   */
-  compactionComposer: SessionCompactionComposer;
-
-  /**
-   * 当前 session 对应的 system Composer。
-   */
-  systemComposer: SessionSystemComposer;
-
-  /**
-   * 获取当前可用工具集合。
-   */
-  getTools: () => Record<string, Tool>;
-
-  /**
-   * 当前 session 绑定的 chat context composer。
-   */
-  contextComposer: ChatSessionContextComposer;
-
-  /**
-   * session 更新后的异步回调。
-   */
-  runAfterSessionUpdated?: (sessionId: string) => Promise<void>;
-};
-
-/**
- * Chat 专用 Session。
- */
-export class ChatSession extends Executor {
-  /**
-   * ChatSession 持有的 composer 实例。
-   */
-  readonly contextComposer: ChatSessionContextComposer;
-
-  private activeTurnState: ChatSessionTurnState | null = null;
-
-  constructor(options: ChatSessionOptions) {
-    const contextComposer = options.contextComposer;
-    super({
-      sessionId: options.sessionId,
-      historyStore: options.historyStore,
-      historyComposer: options.historyComposer,
-      getModel: options.getModel,
-      logger: options.logger,
-      compactionComposer: options.compactionComposer,
-      systemComposer: options.systemComposer,
-      getTools: options.getTools,
-      contextComposer,
-      ...(options.runAfterSessionUpdated
-        ? { runAfterSessionUpdated: options.runAfterSessionUpdated }
-        : {}),
-    });
-    this.contextComposer = contextComposer;
-  }
-
-  /**
-   * 读取当前绑定的 chat turn 状态。
-   */
-  getTurnState(): ChatSessionTurnState | null {
-    return this.activeTurnState;
-  }
-
-  /**
-   * 处理一次 assistant step 回发。
-   *
-   * 关键点（中文）
-   * - step 持久化由基类 `Session.run` 先完成。
-   * - 这里仅负责把当前 turn 绑定的外部回发钩子继续调出去。
-   */
-  private readonly forwardAssistantStep: SessionAssistantStepCallback = async (
-    step,
-  ): Promise<void> => {
-    const callback = this.activeTurnState?.onAssistantStepCallback;
-    if (typeof callback !== "function") return;
-    await callback(step);
-  };
-
-  /**
-   * 运行当前 chat session 的一次请求。
-   *
-   * 关键点（中文）
-   * - 外层继续走统一的内部执行入口。
-   * - ChatSession 只是在 run 生命周期里临时绑定 turn 状态给自己的 composer。
-   */
-  override async run(params: {
-    query: string;
-    onStepCallback?: ChatSessionTurnState["onStepCallback"];
-    onAssistantStepCallback?: ChatSessionTurnState["onAssistantStepCallback"];
-  }): Promise<SessionRunResult> {
-    this.activeTurnState = {
-      ...(typeof params.onStepCallback === "function"
-        ? { onStepCallback: params.onStepCallback }
-        : {}),
-      ...(typeof params.onAssistantStepCallback === "function"
-        ? { onAssistantStepCallback: params.onAssistantStepCallback }
-        : {}),
-    };
-    try {
-      return await super.run({
-        query: params.query,
-        onStepCallback: params.onStepCallback,
-        onAssistantStepCallback: this.forwardAssistantStep,
-      });
-    } finally {
-      this.activeTurnState = null;
-    }
-  }
-}

package/src/service/builtins/chat/runtime/ChatSessionContextComposer.ts

@@ -1,106 +0,0 @@
-/**
- * ChatSessionContextComposer：chat 专用 context composer。
- *
- * 关键点（中文）
- * - 由 chat 层在 Session 实例化时注入，不再依赖 run 时层层传 callback。
- * - step 合并消息读取自 ChatSession 当前绑定的 turn context。
- * - 其余能力（tools / fallback assistant）继续复用默认本地实现。
- */
-
-import type { ModelMessage, Tool } from "ai";
-import { drainInjectedUserMessages } from "@session/SessionRunScope.js";
-import { LocalSessionContextComposer } from "@session/composer/context/LocalSessionContextComposer.js";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import type { SessionSystemMessage } from "@/session/types/SessionPrompts.js";
-import type { ChatSessionTurnState } from "@/service/builtins/chat/runtime/ChatSessionTypes.js";
-
-type ChatSessionContextComposerOptions = {
-  /**
-   * 当前 session 标识。
-   */
-  sessionId: string;
-
-  /**
-   * 读取当前可用工具集合。
-   */
-  getTools: () => Record<string, Tool>;
-
-  /**
-   * 读取当前已绑定的 chat turn 状态。
-   */
-  getTurnState: () => ChatSessionTurnState | null;
-};
-
-/**
- * ChatSession 专用 context composer。
- */
-export class ChatSessionContextComposer extends LocalSessionContextComposer {
-  private readonly getTurnState: ChatSessionContextComposerOptions["getTurnState"];
-
-  constructor(options: ChatSessionContextComposerOptions) {
-    super({
-      sessionId: options.sessionId,
-      getTools: options.getTools,
-    });
-    this.getTurnState = options.getTurnState;
-  }
-
-  createPrepareStepHandler(
-    input: {
-      system: SessionSystemMessage[];
-      appendMergedUserMessages: (
-        messages: SessionMessageV1[],
-      ) => Promise<ModelMessage[]>;
-    },
-  ): (input: { messages?: ModelMessage[] }) => Promise<{
-    system: SessionSystemMessage[];
-    messages?: ModelMessage[];
-  }> {
-    return async ({
-      messages,
-    }: {
-      messages?: ModelMessage[];
-    }): Promise<{
-      system: SessionSystemMessage[];
-      messages?: ModelMessage[];
-    }> => {
-      const injectedMessages = drainInjectedUserMessages();
-      const turnState = this.getTurnState();
-      const onStepCallback = turnState?.onStepCallback;
-      if (
-        typeof onStepCallback !== "function" &&
-        injectedMessages.length === 0
-      ) {
-        return { system: input.system };
-      }
-
-      const incomingMessages: ModelMessage[] = Array.isArray(messages)
-        ? messages
-        : [];
-      let outMessages: ModelMessage[] | undefined;
-      try {
-        const mergedMessages =
-          typeof onStepCallback === "function"
-            ? await onStepCallback()
-            : [];
-        const mergedWithInjected = [
-          ...injectedMessages,
-          ...(Array.isArray(mergedMessages) ? mergedMessages : []),
-        ];
-        const mergedModelMessages = await input.appendMergedUserMessages(
-          mergedWithInjected,
-        );
-        if (mergedModelMessages.length > 0) {
-          // 关键点（中文）：保持当前 step 顺序，仅把新增 chat user 消息追加到末尾。
-          outMessages = [...incomingMessages, ...mergedModelMessages];
-        }
-      } catch {
-        // ignore merge hook failures
-      }
-      return {
-        system: input.system,
-        ...(Array.isArray(outMessages) ? { messages: outMessages } : {}),
-      };
-    };
-  }
-}