@downcity/city 1.1.1 → 1.1.5

package/src/services/chat/runtime/ChatServiceSystem.ts

@@ -1,119 +0,0 @@
-/**
- * ChatServiceSystem：chat service 的 system prompt 组装模块。
- *
- * 关键点（中文）
- * - chat service prompt 与 channel prompt 都属于静态资产。
- * - 当前请求只注入当前 channel 的 prompt，避免平台规则串味。
- * - 该模块只负责 prompt 解析与拼装，不承担运行态控制职责。
- */
-
-import { readFileSync } from "node:fs";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
-import {
-  buildCurrentChatEnvironmentPrompt,
-  resolveCurrentChatEnvironmentPromptInput,
-} from "@services/chat/runtime/SystemPrompt.js";
-
-const CHAT_DIRECT_PROMPT_FILE_URL = new URL("../PROMPT.direct.txt", import.meta.url);
-const TELEGRAM_DIRECT_PROMPT_FILE_URL = new URL(
-  "../channels/telegram/PROMPT.direct.txt",
-  import.meta.url,
-);
-const FEISHU_DIRECT_PROMPT_FILE_URL = new URL(
-  "../channels/feishu/PROMPT.direct.txt",
-  import.meta.url,
-);
-const QQ_DIRECT_PROMPT_FILE_URL = new URL(
-  "../channels/qq/PROMPT.direct.txt",
-  import.meta.url,
-);
-
-/**
- * 加载 chat service 使用说明提示词。
- *
- * 关键点（中文）
- * - 启动阶段即加载，缺失时直接抛错，避免静默失效。
- */
-function loadChatServicePrompt(fileUrl: URL): string {
-  try {
-    return readFileSync(fileUrl, "utf-8").trim();
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    throw new Error(
-      `failed to load chat service prompt from ${fileUrl.pathname}: ${reason}`,
-    );
-  }
-}
-
-const CHAT_SERVICE_PROMPT = loadChatServicePrompt(CHAT_DIRECT_PROMPT_FILE_URL);
-
-/**
- * 加载单个 channel 提示词。
- *
- * 关键点（中文）
- * - channel 提示词属于强依赖资产，缺失时直接抛错，避免运行时悄悄丢失规则。
- */
-function loadChatChannelPrompt(fileUrl: URL, channelName: string): string {
-  try {
-    return readFileSync(fileUrl, "utf-8").trim();
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    throw new Error(
-      `failed to load ${channelName} chat channel prompt from ${fileUrl.pathname}: ${reason}`,
-    );
-  }
-}
-
-const CHAT_CHANNEL_PROMPTS: Record<"telegram" | "feishu" | "qq", string> = {
-  telegram: loadChatChannelPrompt(
-    TELEGRAM_DIRECT_PROMPT_FILE_URL,
-    "telegram-direct",
-  ),
-  feishu: loadChatChannelPrompt(FEISHU_DIRECT_PROMPT_FILE_URL, "feishu-direct"),
-  qq: loadChatChannelPrompt(QQ_DIRECT_PROMPT_FILE_URL, "qq-direct"),
-};
-
-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/services/chat/runtime/ChatSession.ts

@@ -1,125 +0,0 @@
-/**
- * ChatSession：chat 专用 Session 实现。
- *
- * 关键点（中文）
- * - ChatSession 在实例化时持有自己的 execution composer 实例。
- * - chat 当前 turn 的 step 合并/step 回发状态都绑定在 Session 自身，不再新增 `runChat` 一层入口。
- * - 外层仍只调用标准 `run(...)`；chat 语义由 ChatSession 内部收敛。
- */
-
-import { Session } from "@session/Session.js";
-import type { SessionHistoryComposer } from "@session/composer/history/SessionHistoryComposer.js";
-import type { ChatSessionExecutionComposer } from "@services/chat/runtime/ChatSessionExecutionComposer.js";
-import type { SessionExecutor } from "@/types/session/SessionExecutor.js";
-import type { SessionAssistantStepCallback } from "@/types/session/SessionRun.js";
-import type { SessionRunResult } from "@/types/session/SessionRun.js";
-import type { ChatSessionTurnState } from "@/types/chat/ChatSession.js";
-
-type ChatSessionOptions = {
-  /**
-   * 当前会话 ID。
-   */
-  sessionId: string;
-
-  /**
-   * 当前 session 的 history composer。
-   */
-  historyComposer: SessionHistoryComposer;
-
-  /**
-   * 当前 session 绑定的 chat execution composer。
-   */
-  executionComposer: ChatSessionExecutionComposer;
-
-  /**
-   * 创建当前 session 的执行器。
-   */
-  createExecutor: (
-    historyComposer: SessionHistoryComposer,
-    executionComposer: ChatSessionExecutionComposer,
-  ) => SessionExecutor;
-
-  /**
-   * session 更新后的异步回调。
-   */
-  runAfterSessionUpdated?: (sessionId: string) => Promise<void>;
-};
-
-/**
- * Chat 专用 Session。
- */
-export class ChatSession extends Session {
-  /**
-   * ChatSession 持有的 composer 实例。
-   */
-  readonly executionComposer: ChatSessionExecutionComposer;
-
-  private activeTurnState: ChatSessionTurnState | null = null;
-
-  constructor(options: ChatSessionOptions) {
-    const executionComposer = options.executionComposer;
-    super({
-      sessionId: options.sessionId,
-      historyComposer: options.historyComposer,
-      createExecutor: (historyComposer) =>
-        options.createExecutor(historyComposer, executionComposer),
-      ...(options.runAfterSessionUpdated
-        ? { runAfterSessionUpdated: options.runAfterSessionUpdated }
-        : {}),
-    });
-    this.executionComposer = executionComposer;
-  }
-
-  /**
-   * 读取当前绑定的 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 的一次请求。
-   *
-   * 关键点（中文）
-   * - 外层继续走统一的 `session.run(...)` 入口。
-   * - 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/services/chat/runtime/ChatSessionDelete.ts

@@ -1,95 +0,0 @@
-/**
- * ChatSessionDelete：按 sessionId 彻底删除 chat 会话数据。
- *
- * 关键点（中文）
- * - 删除路由映射（`.downcity/channel/meta.json`）
- * - 删除 chat 审计目录（`.downcity/chat/<sessionId>/`）
- * - 删除 core session 目录（`.downcity/session/<sessionId>/`）
- * - 清理运行中 agent 与队列，避免残留任务继续执行
- */
-
-import fs from "fs-extra";
-import path from "node:path";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
-import { resolveChatQueueStore } from "@services/chat/runtime/ChatQueue.js";
-import { removeChatMetaBySessionId } from "@services/chat/runtime/ChatMetaStore.js";
-
-function normalizeSessionId(sessionId: string): string {
-  return String(sessionId || "").trim();
-}
-
-/**
- * 彻底删除一个 chat session。
- *
- * 关键点（中文）
- * - 幂等：目标不存在时返回 success + deleted=false，避免上层重试复杂化。
- */
-export async function deleteChatSessionById(params: {
-  context: AgentContext;
-  sessionId: string;
-}): Promise<{
-  success: boolean;
-  sessionId: string;
-  deleted: boolean;
-  removedMeta: boolean;
-  removedChatDir: boolean;
-  removedSessionDir: boolean;
-  error?: string;
-}> {
-  const sessionId = normalizeSessionId(params.sessionId);
-  if (!sessionId) {
-    return {
-      success: false,
-      sessionId: "",
-      deleted: false,
-      removedMeta: false,
-      removedChatDir: false,
-      removedSessionDir: false,
-      error: "Missing sessionId",
-    };
-  }
-
-  try {
-    // 关键点（中文）：先停执行，再删文件，避免删除过程中仍有任务写入。
-    params.context.session.get(sessionId).clearExecutor();
-    resolveChatQueueStore(params.context).clear(sessionId);
-
-    const removedMetaResult = await removeChatMetaBySessionId({
-      context: params.context,
-      sessionId,
-    });
-
-    const chatDir = path.join(params.context.rootPath, ".downcity", "chat", sessionId);
-    const sessionDir = params.context.paths.getDowncitySessionDirPath(sessionId);
-    const hadChatDir = await fs.pathExists(chatDir);
-    const hadSessionDir = await fs.pathExists(sessionDir);
-    if (hadChatDir) {
-      await fs.remove(chatDir);
-    }
-    if (hadSessionDir) {
-      await fs.remove(sessionDir);
-    }
-
-    const deleted =
-      removedMetaResult.removed || hadChatDir || hadSessionDir;
-
-    return {
-      success: true,
-      sessionId,
-      deleted,
-      removedMeta: removedMetaResult.removed,
-      removedChatDir: hadChatDir,
-      removedSessionDir: hadSessionDir,
-    };
-  } catch (error) {
-    return {
-      success: false,
-      sessionId,
-      deleted: false,
-      removedMeta: false,
-      removedChatDir: false,
-      removedSessionDir: false,
-      error: String(error),
-    };
-  }
-}

package/src/services/chat/runtime/ChatSessionExecutionComposer.ts

@@ -1,106 +0,0 @@
-/**
- * ChatSessionExecutionComposer：chat 专用 execution 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 { LocalSessionExecutionComposer } from "@session/composer/execution/LocalSessionExecutionComposer.js";
-import type { SessionMessageV1 } from "@/types/session/SessionMessages.js";
-import type { SessionSystemMessage } from "@/types/session/SessionPrompts.js";
-import type { ChatSessionTurnState } from "@/types/chat/ChatSession.js";
-
-type ChatSessionExecutionComposerOptions = {
-  /**
-   * 当前 session 标识。
-   */
-  sessionId: string;
-
-  /**
-   * 读取当前可用工具集合。
-   */
-  getTools: () => Record<string, Tool>;
-
-  /**
-   * 读取当前已绑定的 chat turn 状态。
-   */
-  getTurnState: () => ChatSessionTurnState | null;
-};
-
-/**
- * ChatSession 专用 execution composer。
- */
-export class ChatSessionExecutionComposer extends LocalSessionExecutionComposer {
-  private readonly getTurnState: ChatSessionExecutionComposerOptions["getTurnState"];
-
-  constructor(options: ChatSessionExecutionComposerOptions) {
-    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 } : {}),
-      };
-    };
-  }
-}

package/src/services/chat/runtime/ChatkeySend.ts

@@ -1,187 +0,0 @@
-/**
- * Send text to a target chat using chatKey.
- *
- * 设计动机（中文）
- * - Task runner / scheduler 需要在“非当前对话上下文”向指定 chatKey 投递消息
- * - 复用现有 dispatcher 与 chat meta（尤其 QQ 的被动回复依赖 messageId）
- *
- * 注意
- * - 这里是运行时内部能力（不是 tool）；tool `chat_contact_send` 也会复用本实现
- */
-
-import { getChatSender } from "./ChatSendRegistry.js";
-import type {
-  ChatDispatchAction,
-  ChatDispatchChannel,
-} from "@services/chat/types/ChatDispatcher.js";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
-import { readChatMetaBySessionId } from "./ChatMetaStore.js";
-
-/**
- * 解析实际分发目标。
- *
- * 规则（中文）
- * - 仅使用 services/chat 维护的 session 路由映射。
- * - 不再支持 legacy chatKey 字符串解析回退。
- */
-export async function resolveDispatchTargetByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
-}): Promise<{
-  channel: ChatDispatchChannel;
-  chatId: string;
-  chatType?: string;
-  messageThreadId?: number;
-  messageId?: string;
-} | null> {
-  const storedMeta = await readChatMetaBySessionId({
-    context: params.context,
-    sessionId: params.chatKey,
-  });
-  const channel = storedMeta?.channel;
-  const chatId = String(storedMeta?.chatId || "").trim();
-  if (!channel || !chatId) return null;
-
-  const chatType =
-    typeof storedMeta?.targetType === "string" && storedMeta.targetType
-      ? storedMeta.targetType
-      : undefined;
-  const messageThreadId =
-    typeof storedMeta?.threadId === "number" &&
-    Number.isFinite(storedMeta.threadId)
-      ? storedMeta.threadId
-      : undefined;
-  const messageId =
-    typeof storedMeta?.messageId === "string" && storedMeta.messageId
-      ? storedMeta.messageId
-      : undefined;
-
-  return {
-    channel: channel as ChatDispatchChannel,
-    chatId,
-    ...(typeof chatType === "string" && chatType ? { chatType } : {}),
-    ...(typeof messageThreadId === "number" ? { messageThreadId } : {}),
-    ...(typeof messageId === "string" && messageId ? { messageId } : {}),
-  };
-}
-
-/**
- * 按 chatKey 发送文本到对应平台。
- *
- * 流程（中文）
- * 1) 通过 sessionId 读取映射并定位 channel dispatcher
- * 2) 从 chat meta 回填 chatType/threadId/messageId
- * 3) 合并参数后调用 dispatcher 发送
- */
-export async function sendTextByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
-  text: string;
-  replyToMessage?: boolean;
-  messageId?: string;
-}): Promise<{ success: boolean; error?: string }> {
-  const context = params.context;
-  const chatKey = String(params.chatKey || "").trim();
-  const text = String(params.text ?? "");
-  if (!chatKey) return { success: false, error: "Missing chatKey" };
-  if (!text.trim()) return { success: true };
-
-  const target = await resolveDispatchTargetByChatKey({ context, chatKey });
-  if (!target) {
-    return {
-      success: false,
-      error: `Unsupported sessionId for dispatch: ${chatKey}`,
-    };
-  }
-
-  const channel = target.channel;
-  const chatId = target.chatId;
-
-  const dispatcher = getChatSender(channel);
-  if (!dispatcher) {
-    return {
-      success: false,
-      error: `No dispatcher registered for channel: ${channel}`,
-    };
-  }
-
-  const chatType = target.chatType;
-  const messageThreadId = target.messageThreadId;
-  const explicitMessageId = String(params.messageId || "").trim();
-  const messageId = explicitMessageId || target.messageId;
-  const shouldReplyToMessage = params.replyToMessage === true;
-
-  if (channel === "qq") {
-    if (!chatType || !messageId) {
-      return {
-        success: false,
-        error:
-          "QQ requires chatType + messageId to send a reply. Ask the target user to send a message first so Downcity can record latest chat meta.",
-      };
-    }
-  }
-
-  return dispatcher.sendText({
-    chatId,
-    text,
-    ...(typeof messageThreadId === "number" ? { messageThreadId } : {}),
-    ...(typeof chatType === "string" && chatType ? { chatType } : {}),
-    ...(typeof messageId === "string" && messageId ? { messageId } : {}),
-    ...(shouldReplyToMessage ? { replyToMessage: true } : {}),
-  });
-}
-
-/**
- * 按 chatKey 发送平台动作（typing/react）。
- *
- * 流程（中文）
- * 1) 通过 sessionId 读取映射并定位 channel dispatcher
- * 2) 合并目标元信息与显式参数（显式 messageId 优先）
- * 3) 调用 dispatcher.sendAction
- */
-export async function sendActionByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
-  action: ChatDispatchAction;
-  messageId?: string;
-  reactionEmoji?: string;
-  reactionIsBig?: boolean;
-}): Promise<{ success: boolean; error?: string }> {
-  const context = params.context;
-  const chatKey = String(params.chatKey || "").trim();
-  if (!chatKey) return { success: false, error: "Missing chatKey" };
-  if (!params.action) return { success: false, error: "Missing action" };
-
-  const target = await resolveDispatchTargetByChatKey({ context, chatKey });
-  if (!target) {
-    return {
-      success: false,
-      error: `Unsupported sessionId for dispatch: ${chatKey}`,
-    };
-  }
-
-  const dispatcher = getChatSender(target.channel);
-  if (!dispatcher || typeof dispatcher.sendAction !== "function") {
-    return {
-      success: false,
-      error: `No action dispatcher registered for channel: ${target.channel}`,
-    };
-  }
-
-  const messageId = String(params.messageId || "").trim() || target.messageId;
-  return dispatcher.sendAction({
-    chatId: target.chatId,
-    action: params.action,
-    ...(typeof target.messageThreadId === "number"
-      ? { messageThreadId: target.messageThreadId }
-      : {}),
-    ...(typeof target.chatType === "string" && target.chatType
-      ? { chatType: target.chatType }
-      : {}),
-    ...(typeof messageId === "string" && messageId ? { messageId } : {}),
-    ...(typeof params.reactionEmoji === "string" && params.reactionEmoji.trim()
-      ? { reactionEmoji: params.reactionEmoji.trim() }
-      : {}),
-    ...(params.reactionIsBig === true ? { reactionIsBig: true } : {}),
-  });
-}