@downcity/agent 1.1.35 → 1.1.51

package/src/plugin/builtins/chat/channels/BaseChatChannelQueue.ts

@@ -1,320 +0,0 @@
-/**
- * BaseChatChannel 队列编排辅助函数。
- *
- * 关键点（中文）
- * - audit / exec 入队都需要走同一套 prepare + emit 流程。
- * - 这些逻辑抽离后，`BaseChatChannel` 只负责渠道层输入整理与授权判断。
- */
-
-import { resolveChatQueueStore } from "@/plugin/builtins/chat/runtime/ChatQueue.js";
-import { buildQueuedUserMessageWithInfo } from "@/plugin/builtins/chat/runtime/QueuedUserMessage.js";
-import { appendExecIngress } from "@/plugin/builtins/chat/runtime/ChatIngressStore.js";
-import { resolveIncomingChatUserRole } from "@/plugin/builtins/chat/runtime/PluginDispatch.js";
-import {
-  emitChatEnqueueEffect,
-  prepareChatEnqueue,
-} from "@/plugin/builtins/chat/runtime/EnqueueDispatch.js";
-import type { ChatDispatchChannel } from "@/plugin/builtins/chat/types/ChatDispatcher.js";
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { JsonObject } from "@/types/common/Json.js";
-import type { IncomingChatMessage } from "./BaseChatChannel.js";
-import {
-  appendInboundChannelHistory,
-  resolveOrCreateChannelSessionId,
-  stripUndefinedMeta,
-  type ChannelUserMessageMeta,
-  updateChannelChatMeta,
-} from "./BaseChatChannelSupport.js";
-
-/**
- * audit 入队输入。
- */
-export interface EnqueueAuditChannelMessageParams {
-  /**
-   * 当前 execution runtime。
-   */
-  context: AgentContext;
-  /**
-   * 当前渠道。
-   */
-  channel: ChatDispatchChannel;
-  /**
-   * 平台 chatId。
-   */
-  chatId: string;
-  /**
-   * 文本内容。
-   */
-  text: string;
-  /**
-   * 可选消息 id。
-   */
-  messageId?: string;
-  /**
-   * 可选用户 id。
-   */
-  userId?: string;
-  /**
-   * 可选扩展 meta。
-   */
-  meta?: ChannelUserMessageMeta;
-}
-
-/**
- * exec 入队输入。
- */
-export interface EnqueueExecChannelMessageParams {
-  /**
-   * 当前 execution runtime。
-   */
-  context: AgentContext;
-  /**
-   * 当前渠道。
-   */
-  channel: ChatDispatchChannel;
-  /**
-   * 标准化后的入站消息。
-   */
-  message: IncomingChatMessage;
-}
-
-/**
- * 写入 audit 消息并送入 chat queue。
- */
-export async function enqueueAuditChannelMessage(
-  params: EnqueueAuditChannelMessageParams,
-): Promise<void> {
-  const meta = (params.meta || {}) as ChannelUserMessageMeta;
-  const username = typeof meta.username === "string" ? meta.username : undefined;
-  const messageThreadId =
-    typeof meta.messageThreadId === "number" && Number.isFinite(meta.messageThreadId)
-      ? meta.messageThreadId
-      : undefined;
-  const chatType = typeof meta.chatType === "string" ? meta.chatType : undefined;
-  const chatTitle =
-    typeof meta.chatTitle === "string" ? meta.chatTitle.trim() || undefined : undefined;
-  const sessionId = await resolveOrCreateChannelSessionId({
-    context: params.context,
-    channel: params.channel,
-    chatId: params.chatId,
-    chatType,
-    messageThreadId,
-  });
-  if (!sessionId) return;
-
-  const extra = stripUndefinedMeta(meta);
-  await appendInboundChannelHistory({
-    context: params.context,
-    logger: params.context.logger,
-    channel: params.channel,
-    sessionId,
-    chatId: params.chatId,
-    ingressKind: "audit",
-    text: params.text,
-    targetType: chatType,
-    threadId: messageThreadId,
-    messageId: params.messageId,
-    actorId: params.userId,
-    actorName: username,
-    extra,
-  });
-  await updateChannelChatMeta({
-    context: params.context,
-    channel: params.channel,
-    sessionId,
-    chatId: params.chatId,
-    targetType: chatType,
-    threadId: messageThreadId,
-    messageId: params.messageId,
-    actorId: params.userId,
-    actorName: username,
-    chatTitle,
-  });
-
-  const preparedAudit = await prepareChatEnqueue({
-    context: params.context,
-    input: {
-      kind: "audit",
-      channel: params.channel,
-      chatKey: sessionId,
-      chatId: params.chatId,
-      text: params.text,
-      ...(chatType ? { chatType } : {}),
-      ...(typeof messageThreadId === "number" ? { threadId: messageThreadId } : {}),
-      ...(typeof params.messageId === "string" ? { messageId: params.messageId } : {}),
-      ...(typeof params.userId === "string" ? { actorId: params.userId } : {}),
-      ...(typeof username === "string" ? { actorName: username } : {}),
-      extra,
-    },
-  });
-  const auditEnqueued = resolveChatQueueStore(params.context).enqueue({
-    kind: "audit",
-    channel: params.channel,
-    targetId: params.chatId,
-    sessionId,
-    ...(typeof preparedAudit.actorId === "string"
-      ? { actorId: preparedAudit.actorId }
-      : {}),
-    ...(typeof preparedAudit.actorName === "string"
-      ? { actorName: preparedAudit.actorName }
-      : {}),
-    ...(typeof preparedAudit.messageId === "string"
-      ? { messageId: preparedAudit.messageId }
-      : {}),
-    text: preparedAudit.text,
-    ...(typeof preparedAudit.threadId === "number"
-      ? { threadId: preparedAudit.threadId }
-      : {}),
-    ...(typeof preparedAudit.chatType === "string"
-      ? { targetType: preparedAudit.chatType }
-      : {}),
-    extra:
-      preparedAudit.extra && typeof preparedAudit.extra === "object"
-        ? (preparedAudit.extra as JsonObject)
-        : extra,
-  });
-  await emitChatEnqueueEffect({
-    context: params.context,
-    input: {
-      ...preparedAudit,
-      itemId: auditEnqueued.itemId,
-      lanePosition: auditEnqueued.lanePosition,
-    },
-  });
-}
-
-/**
- * 写入 exec ingress 并送入 chat queue。
- */
-export async function enqueueExecChannelMessage(
-  params: EnqueueExecChannelMessageParams,
-): Promise<{ chatKey: string; position: number }> {
-  const msg = params.message;
-  const userRole = await resolveIncomingChatUserRole({
-    context: params.context,
-    channel: params.channel,
-    userId: msg.userId,
-  });
-  const inboundExtra =
-    msg.extra && typeof msg.extra === "object" ? stripUndefinedMeta(msg.extra) : {};
-  const mergedExtra: JsonObject = {
-    ...inboundExtra,
-    roleId: userRole?.roleId || "unknown",
-    permissions: userRole?.permissions || [],
-  };
-
-  const chatKey = await resolveOrCreateChannelSessionId({
-    context: params.context,
-    channel: params.channel,
-    chatId: msg.chatId,
-    chatType: msg.chatType,
-    messageThreadId: msg.messageThreadId,
-  });
-  if (!chatKey) {
-    throw new Error("Failed to resolve sessionId for incoming chat message");
-  }
-
-  const rawQueuedText = buildQueuedUserMessageWithInfo({
-    messageId: msg.messageId,
-    userId: msg.userId,
-    username: msg.username,
-    roleId: userRole?.roleId,
-    permissions: userRole?.permissions,
-    userTimezone: msg.userTimezone,
-    text: msg.text,
-  });
-  const preparedExec = await prepareChatEnqueue({
-    context: params.context,
-    input: {
-      kind: "exec",
-      channel: params.channel,
-      chatKey,
-      chatId: msg.chatId,
-      text: rawQueuedText,
-      ...(msg.chatType ? { chatType: msg.chatType } : {}),
-      ...(typeof msg.messageThreadId === "number"
-        ? { threadId: msg.messageThreadId }
-        : {}),
-      ...(typeof msg.messageId === "string" ? { messageId: msg.messageId } : {}),
-      ...(typeof msg.userId === "string" ? { actorId: msg.userId } : {}),
-      ...(typeof msg.username === "string" ? { actorName: msg.username } : {}),
-      extra: mergedExtra,
-    },
-  });
-  const queuedText = preparedExec.text;
-  const queuedExtra =
-    preparedExec.extra && typeof preparedExec.extra === "object"
-      ? (preparedExec.extra as JsonObject)
-      : mergedExtra;
-
-  await appendExecIngress({
-    context: params.context,
-    sessionId: chatKey,
-    channel: params.channel,
-    chatId: msg.chatId,
-    text: queuedText,
-    ...(typeof preparedExec.chatType === "string"
-      ? { targetType: preparedExec.chatType }
-      : {}),
-    ...(typeof preparedExec.threadId === "number"
-      ? { threadId: preparedExec.threadId }
-      : {}),
-    ...(typeof preparedExec.messageId === "string"
-      ? { messageId: preparedExec.messageId }
-      : {}),
-    ...(typeof preparedExec.actorId === "string"
-      ? { actorId: preparedExec.actorId }
-      : {}),
-    ...(typeof preparedExec.actorName === "string"
-      ? { actorName: preparedExec.actorName }
-      : {}),
-    extra: queuedExtra,
-  });
-
-  await updateChannelChatMeta({
-    context: params.context,
-    channel: params.channel,
-    sessionId: chatKey,
-    chatId: msg.chatId,
-    targetType: msg.chatType,
-    threadId: msg.messageThreadId,
-    messageId: msg.messageId,
-    actorId: msg.userId,
-    actorName: msg.username,
-    chatTitle: msg.chatTitle,
-  });
-
-  const execEnqueued = resolveChatQueueStore(params.context).enqueue({
-    kind: "exec",
-    channel: params.channel,
-    targetId: msg.chatId,
-    sessionId: chatKey,
-    text: queuedText,
-    ...(typeof preparedExec.chatType === "string"
-      ? { targetType: preparedExec.chatType }
-      : {}),
-    ...(typeof preparedExec.threadId === "number"
-      ? { threadId: preparedExec.threadId }
-      : {}),
-    ...(typeof preparedExec.messageId === "string"
-      ? { messageId: preparedExec.messageId }
-      : {}),
-    ...(typeof preparedExec.actorId === "string"
-      ? { actorId: preparedExec.actorId }
-      : {}),
-    ...(typeof preparedExec.actorName === "string"
-      ? { actorName: preparedExec.actorName }
-      : {}),
-    extra: queuedExtra,
-  });
-  await emitChatEnqueueEffect({
-    context: params.context,
-    input: {
-      ...preparedExec,
-      itemId: execEnqueued.itemId,
-      lanePosition: execEnqueued.lanePosition,
-    },
-  });
-
-  return { chatKey, position: execEnqueued.lanePosition };
-}

package/src/plugin/builtins/chat/channels/BaseChatChannelSupport.ts

@@ -1,321 +0,0 @@
-/**
- * BaseChatChannel 共享辅助函数。
- *
- * 关键点（中文）
- * - 这里只放 session 映射、history 落盘、chat meta 更新等“通用支撑逻辑”。
- * - `BaseChatChannel` 保留编排职责，避免基类继续承担过多存储细节。
- */
-
-import type { ChatDispatchChannel } from "@/plugin/builtins/chat/types/ChatDispatcher.js";
-import type { Logger } from "@/utils/logger/Logger.js";
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-import {
-  resolveSessionIdByChatTarget,
-  resolveOrCreateSessionIdByChatTarget,
-  upsertChatMetaBySessionId,
-} from "@/plugin/builtins/chat/runtime/ChatMetaStore.js";
-import {
-  appendInboundChatHistory,
-  appendOutboundChatHistory,
-} from "@/plugin/builtins/chat/runtime/ChatHistoryStore.js";
-
-/**
- * 渠道附加元信息。
- */
-export type ChannelUserMessageMeta = {
-  /**
-   * 任意附加字段名。
-   */
-  [key: string]: JsonValue | undefined;
-};
-
-/**
- * 基于渠道目标解析 sessionId 的输入。
- */
-export interface ChannelSessionTargetParams {
-  /**
-   * 当前 execution runtime。
-   */
-  context: AgentContext;
-  /**
-   * 当前渠道。
-   */
-  channel: ChatDispatchChannel;
-  /**
-   * 平台 chatId。
-   */
-  chatId: string;
-  /**
-   * 可选 chatType。
-   */
-  chatType?: string;
-  /**
-   * 可选 thread / topic id。
-   */
-  messageThreadId?: number;
-}
-
-/**
- * 渠道 meta 更新输入。
- */
-export interface ChannelChatMetaParams {
-  /**
-   * 当前 execution runtime。
-   */
-  context: AgentContext;
-  /**
-   * 当前渠道。
-   */
-  channel: ChatDispatchChannel;
-  /**
-   * sessionId。
-   */
-  sessionId: string;
-  /**
-   * 平台 chatId。
-   */
-  chatId: string;
-  /**
-   * 可选目标类型。
-   */
-  targetType?: string;
-  /**
-   * 可选 thread id。
-   */
-  threadId?: number;
-  /**
-   * 可选消息 id。
-   */
-  messageId?: string;
-  /**
-   * 可选用户 id。
-   */
-  actorId?: string;
-  /**
-   * 可选用户名。
-   */
-  actorName?: string;
-  /**
-   * 会话标题。
-   */
-  chatTitle?: string;
-}
-
-/**
- * 入站 history 写入输入。
- */
-export interface ChannelInboundHistoryParams {
-  /**
-   * 当前 execution runtime。
-   */
-  context: AgentContext;
-  /**
-   * 日志器。
-   */
-  logger: Logger;
-  /**
-   * 当前渠道。
-   */
-  channel: ChatDispatchChannel;
-  /**
-   * sessionId。
-   */
-  sessionId: string;
-  /**
-   * 平台 chatId。
-   */
-  chatId: string;
-  /**
-   * 入站类型，audit 或 exec。
-   */
-  ingressKind: "audit" | "exec";
-  /**
-   * 文本内容。
-   */
-  text: string;
-  /**
-   * 可选目标类型。
-   */
-  targetType?: string;
-  /**
-   * 可选 thread id。
-   */
-  threadId?: number;
-  /**
-   * 可选消息 id。
-   */
-  messageId?: string;
-  /**
-   * 可选用户 id。
-   */
-  actorId?: string;
-  /**
-   * 可选用户名。
-   */
-  actorName?: string;
-  /**
-   * 附加元信息。
-   */
-  extra?: JsonObject;
-}
-
-/**
- * 工具侧 outbound history 输入。
- */
-export interface ChannelToolOutboundHistoryParams extends ChannelSessionTargetParams {
-  /**
-   * 日志器。
-   */
-  logger: Logger;
-  /**
-   * 文本内容。
-   */
-  text: string;
-  /**
-   * 可选消息 id。
-   */
-  messageId?: string;
-}
-
-/**
- * 去除 meta 中的 undefined 字段。
- */
-export function stripUndefinedMeta(meta: ChannelUserMessageMeta): JsonObject {
-  const out: JsonObject = {};
-  for (const [key, value] of Object.entries(meta)) {
-    if (value !== undefined) out[key] = value;
-  }
-  return out;
-}
-
-/**
- * 通过渠道目标解析或创建 sessionId。
- */
-export async function resolveOrCreateChannelSessionId(
-  params: ChannelSessionTargetParams,
-): Promise<string | null> {
-  const chatId = String(params.chatId || "").trim();
-  if (!chatId) return null;
-  return await resolveOrCreateSessionIdByChatTarget({
-    context: params.context,
-    channel: params.channel,
-    chatId,
-    ...(typeof params.chatType === "string" ? { targetType: params.chatType } : {}),
-    ...(typeof params.messageThreadId === "number"
-      ? { threadId: params.messageThreadId }
-      : {}),
-  });
-}
-
-/**
- * 通过渠道目标解析已有 sessionId。
- */
-export async function resolveChannelSessionId(
-  params: ChannelSessionTargetParams,
-): Promise<string | null> {
-  const chatId = String(params.chatId || "").trim();
-  if (!chatId) return null;
-  return await resolveSessionIdByChatTarget({
-    context: params.context,
-    channel: params.channel,
-    chatId,
-    ...(typeof params.chatType === "string" ? { targetType: params.chatType } : {}),
-    ...(typeof params.messageThreadId === "number"
-      ? { threadId: params.messageThreadId }
-      : {}),
-  });
-}
-
-/**
- * 更新 session 对应的 chat meta。
- */
-export async function updateChannelChatMeta(
-  params: ChannelChatMetaParams,
-): Promise<void> {
-  await upsertChatMetaBySessionId({
-    context: params.context,
-    sessionId: params.sessionId,
-    channel: params.channel,
-    chatId: params.chatId,
-    targetType: params.targetType,
-    threadId: params.threadId,
-    messageId: params.messageId,
-    actorId: params.actorId,
-    actorName: params.actorName,
-    chatTitle: params.chatTitle,
-  });
-}
-
-/**
- * 追加入站 chat history。
- */
-export async function appendInboundChannelHistory(
-  params: ChannelInboundHistoryParams,
-): Promise<void> {
-  try {
-    await appendInboundChatHistory({
-      context: params.context,
-      sessionId: params.sessionId,
-      channel: params.channel,
-      chatId: params.chatId,
-      ingressKind: params.ingressKind,
-      text: params.text,
-      targetType: params.targetType,
-      threadId: params.threadId,
-      messageId: params.messageId,
-      actorId: params.actorId,
-      actorName: params.actorName,
-      extra: params.extra,
-    });
-  } catch (error) {
-    params.logger.warn("Failed to append inbound chat history", {
-      error: String(error),
-      channel: params.channel,
-      sessionId: params.sessionId,
-      chatId: params.chatId,
-      ingressKind: params.ingressKind,
-    });
-  }
-}
-
-/**
- * 工具发送成功后补齐 outbound history。
- */
-export async function appendToolOutboundChannelHistory(
-  params: ChannelToolOutboundHistoryParams,
-): Promise<void> {
-  const chatId = String(params.chatId || "").trim();
-  const text = String(params.text ?? "");
-  if (!chatId || !text.trim()) return;
-
-  const sessionId = await resolveOrCreateChannelSessionId(params);
-  if (!sessionId) return;
-
-  try {
-    await appendOutboundChatHistory({
-      context: params.context,
-      sessionId,
-      channel: params.channel,
-      chatId,
-      text,
-      targetType: params.chatType,
-      ...(typeof params.messageThreadId === "number"
-        ? { threadId: params.messageThreadId }
-        : {}),
-      ...(typeof params.messageId === "string" && params.messageId
-        ? { messageId: params.messageId }
-        : {}),
-      extra: {
-        source: "channel_send_tool_text",
-      },
-    });
-  } catch (error) {
-    params.logger.warn("Failed to append outbound chat history", {
-      error: String(error),
-      channel: params.channel,
-      sessionId,
-      chatId,
-    });
-  }
-}

package/src/plugin/builtins/chat/channels/BotInfoProvider.ts

@@ -1,49 +0,0 @@
-/**
- * Chat 渠道 Bot 信息探测器注册表。
- *
- * 关键点（中文）
- * - 将不同渠道的 bot 信息探测实现统一抽象为 provider。
- * - 业务层只依赖注册表，不直接写渠道分支。
- */
-
-import { FeishuBotInfoProvider } from "@/plugin/builtins/chat/channels/feishu/BotInfo.js";
-import { QqBotInfoProvider } from "@/plugin/builtins/chat/channels/qq/BotInfo.js";
-import { TelegramBotInfoProvider } from "@/plugin/builtins/chat/channels/telegram/BotInfo.js";
-import type {
-  ChatBotInfoResolveInput,
-  ChatBotInfoResult,
-  ChatChannelBotInfoProvider,
-} from "@/plugin/builtins/chat/types/BotInfo.js";
-import type { ChatChannelName } from "@/plugin/builtins/chat/types/ChannelStatus.js";
-
-const TELEGRAM_BOT_INFO_PROVIDER = new TelegramBotInfoProvider();
-const FEISHU_BOT_INFO_PROVIDER = new FeishuBotInfoProvider();
-const QQ_BOT_INFO_PROVIDER = new QqBotInfoProvider();
-
-const CHAT_CHANNEL_BOT_INFO_PROVIDER_REGISTRY: Record<
-  ChatChannelName,
-  ChatChannelBotInfoProvider
-> = {
-  telegram: TELEGRAM_BOT_INFO_PROVIDER,
-  feishu: FEISHU_BOT_INFO_PROVIDER,
-  qq: QQ_BOT_INFO_PROVIDER,
-};
-
-/**
- * 获取指定渠道的 Bot 信息探测器。
- */
-export function getChatChannelBotInfoProvider(
-  channel: ChatChannelName,
-): ChatChannelBotInfoProvider {
-  return CHAT_CHANNEL_BOT_INFO_PROVIDER_REGISTRY[channel];
-}
-
-/**
- * 使用统一入口探测 Bot 信息。
- */
-export function resolveChatChannelBotInfo(
-  input: ChatBotInfoResolveInput,
-): Promise<ChatBotInfoResult> {
-  const provider = getChatChannelBotInfoProvider(input.channel);
-  return provider.resolve(input.credentials);
-}