@downcity/agent 1.1.23 → 1.1.32

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

@@ -1,85 +0,0 @@
-/**
- * ReplyContextFormatter：reply 引用上下文格式化工具。
- *
- * 关键点（中文）
- * - 把平台 reply 信息稳定地拼进模型输入正文。
- * - 同时提供额外 metadata，便于 history / 调试链路查看。
- */
-
-import type { JsonObject } from "@/types/common/Json.js";
-import type { InboundReplyContext } from "@/service/builtins/chat/types/ReplyContext.js";
-
-function normalizeReplyValue(value: string | undefined): string | undefined {
-  const text = String(value || "").trim();
-  return text ? text : undefined;
-}
-
-/**
- * 将 reply 上下文转换为执行输入正文。
- *
- * 说明（中文）
- * - 当前消息正文为空时，也会保留 reply block，避免“只看见 reply、看不见被引用内容”。
- * - quote 与完整正文相同则自动去重，避免重复噪声。
- */
-export function buildReplyContextInstruction(params: {
-  text: string;
-  replyContext?: InboundReplyContext;
-}): string {
-  const body = String(params.text ?? "").trim();
-  const replyContext = params.replyContext;
-  if (!replyContext) return body;
-
-  const messageId = normalizeReplyValue(replyContext.messageId);
-  const actorName = normalizeReplyValue(replyContext.actorName);
-  const quoteText = normalizeReplyValue(replyContext.quoteText);
-  const replyText = normalizeReplyValue(replyContext.text);
-  const normalizedQuote =
-    quoteText && quoteText !== replyText ? quoteText : undefined;
-
-  if (!messageId && !actorName && !normalizedQuote && !replyText) {
-    return body;
-  }
-
-  const lines: string[] = ["<reply_context>"];
-  if (messageId) lines.push(`reply_message_id: ${messageId}`);
-  if (actorName) lines.push(`reply_actor_name: ${actorName}`);
-  if (normalizedQuote) {
-    lines.push("reply_quote:");
-    lines.push(normalizedQuote);
-  }
-  if (replyText) {
-    lines.push("reply_message:");
-    lines.push(replyText);
-  }
-  lines.push("</reply_context>");
-
-  if (!body) return lines.join("\n");
-  return `${lines.join("\n")}\n\n${body}`;
-}
-
-/**
- * 将 reply 上下文转换为 ingress extra。
- *
- * 说明（中文）
- * - 仅保留稳定、短小的字段。
- * - 方便在 Console / history 中直接看到引用信息。
- */
-export function buildReplyContextExtra(
-  replyContext?: InboundReplyContext,
-): JsonObject | undefined {
-  if (!replyContext) return undefined;
-
-  const messageId = normalizeReplyValue(replyContext.messageId);
-  const actorName = normalizeReplyValue(replyContext.actorName);
-  const text = normalizeReplyValue(replyContext.text);
-  const quoteText = normalizeReplyValue(replyContext.quoteText);
-  if (!messageId && !actorName && !text && !quoteText) return undefined;
-
-  return {
-    hasReplyContext: true,
-    ...(messageId ? { replyMessageId: messageId } : {}),
-    ...(actorName ? { replyActorName: actorName } : {}),
-    ...(text ? { replyText: text } : {}),
-    ...(quoteText ? { replyQuoteText: quoteText } : {}),
-  };
-}

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

@@ -1,78 +0,0 @@
-/**
- * Chat reply dispatch helper。
- *
- * 关键点（中文）
- * - 把 chat 回复前/回复后的扩展点统一收敛到这里。
- * - 仅服务 agent 执行生命周期，不覆盖手动 `chat send`。
- */
-
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { ChatReplyDispatchInput, ChatReplyEffectInput } from "@/service/builtins/chat/types/ChatPlugin.js";
-import type { JsonValue } from "@/types/common/Json.js";
-import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
-import { CHAT_PLUGIN_POINTS } from "@/service/builtins/chat/runtime/PluginPoints.js";
-import { resolveDispatchTargetByChatKey } from "@/service/builtins/chat/runtime/ChatkeySend.js";
-
-function normalizeText(value: string | undefined): string {
-  return String(value || "").trim();
-}
-
-/**
- * 回复前文本增强。
- */
-export async function prepareChatReplyText(params: {
-  context: AgentContext;
-  input: ChatReplyDispatchInput;
-}): Promise<string> {
-  const input = {
-    ...params.input,
-    text: normalizeText(params.input.text),
-  };
-  if (!input.text) return "";
-
-  const next = await params.context.plugins.pipeline<JsonValue>(
-    CHAT_PLUGIN_POINTS.beforeReply,
-    input as unknown as JsonValue,
-  );
-  const record =
-    next && typeof next === "object" && !Array.isArray(next)
-      ? (next as Record<string, unknown>)
-      : {};
-  return normalizeText(typeof record.text === "string" ? record.text : input.text);
-}
-
-/**
- * 回复后事件分发。
- */
-export async function emitChatReplyEffect(params: {
-  context: AgentContext;
-  input: ChatReplyEffectInput;
-}): Promise<void> {
-  await params.context.plugins.effect(
-    CHAT_PLUGIN_POINTS.afterReply,
-    params.input as unknown as JsonValue,
-  );
-}
-
-/**
- * 基于 chatKey 补齐回复目标上下文。
- */
-export async function resolveChatReplyTarget(params: {
-  context: AgentContext;
-  chatKey: string;
-}): Promise<{
-  channel?: ChatDispatchChannel;
-  chatId?: string;
-  messageId?: string;
-}> {
-  const target = await resolveDispatchTargetByChatKey({
-    context: params.context,
-    chatKey: params.chatKey,
-  });
-  if (!target) return {};
-  return {
-    channel: target.channel,
-    chatId: target.chatId,
-    ...(target.messageId ? { messageId: target.messageId } : {}),
-  };
-}

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

@@ -1,84 +0,0 @@
-/**
- * Chat SystemPrompt：chat 运行时 system prompt 辅助。
- *
- * 关键点（中文）
- * - 把当前 chat 路由环境从入站 `<info>` 中剥离，改由 system prompt 注入。
- * - 仅描述当前会话环境，不承载用户身份字段。
- * - 统一从 request context + ChatMetaStore 读取当前 chat 元信息。
- */
-
-import { getSessionRunScope } from "@session/SessionRunScope.js";
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { ChatEnvironmentPromptInput } from "@/service/builtins/chat/types/ChatPromptContext.js";
-import { readChatMetaBySessionId } from "@/service/builtins/chat/runtime/ChatMetaStore.js";
-
-function normalizePromptValue(value: unknown, fallback: string): string {
-  const text = String(value ?? "").trim();
-  return text || fallback;
-}
-
-/**
- * 解析当前请求的 chat 环境输入。
- *
- * 说明（中文）
- * - 非 chat session 或尚未建立 chat route 时返回 `null`。
- */
-export async function resolveCurrentChatEnvironmentPromptInput(
-  context: AgentContext,
-): Promise<ChatEnvironmentPromptInput | null> {
-  const sessionId = String(getSessionRunScope()?.sessionId || "").trim();
-  if (!sessionId) return null;
-
-  const meta = await readChatMetaBySessionId({
-    context,
-    sessionId,
-  }).catch(() => null);
-  if (!meta?.channel || !meta.chatId) return null;
-
-  return {
-    sessionId: meta.sessionId,
-    chatKey: meta.sessionId,
-    channel: meta.channel,
-    chatId: meta.chatId,
-    ...(meta.targetType ? { chatType: meta.targetType } : {}),
-    ...(typeof meta.threadId === "number" ? { threadId: meta.threadId } : {}),
-    ...(meta.chatTitle ? { chatTitle: meta.chatTitle } : {}),
-  };
-}
-
-/**
- * 构造当前 chat 环境说明文本。
- */
-export function buildChatEnvironmentPrompt(input: ChatEnvironmentPromptInput): string {
-  const lines = [
-    "# Current Chat Environment",
-    "以下字段只描述当前 chat 会话环境与路由，不是用户身份信息：",
-    `- channel: ${normalizePromptValue(input.channel, "unknown")}`,
-    `- session_id: ${normalizePromptValue(input.sessionId, "unknown")}`,
-    `- chat_key: ${normalizePromptValue(input.chatKey, "unknown")}`,
-    `- chat_id: ${normalizePromptValue(input.chatId, "unknown")}`,
-    `- chat_type: ${normalizePromptValue(input.chatType, "unknown")}`,
-    `- thread_id: ${normalizePromptValue(
-      typeof input.threadId === "number" ? String(input.threadId) : "",
-      "none",
-    )}`,
-  ];
-
-  const chatTitle = normalizePromptValue(input.chatTitle, "");
-  if (chatTitle) {
-    lines.push(`- chat_title: ${chatTitle}`);
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * 读取并渲染当前请求的 chat 环境 prompt。
- */
-export async function buildCurrentChatEnvironmentPrompt(
-  context: AgentContext,
-): Promise<string> {
-  const input = await resolveCurrentChatEnvironmentPromptInput(context);
-  if (!input) return "";
-  return buildChatEnvironmentPrompt(input);
-}

package/src/service/builtins/chat/types/BotInfo.ts

@@ -1,101 +0,0 @@
-/**
- * Chat Bot 信息探测类型定义。
- *
- * 关键点（中文）
- * - 将“凭据 -> bot 基础信息”的探测输入输出结构标准化。
- * - Console、Channel Account 存储、后续自动化流程都复用该结构。
- */
-
-import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
-
-/**
- * Bot 信息探测凭据。
- */
-export interface ChatBotInfoCredentialInput {
-  /**
-   * Telegram 机器人 token（仅 Telegram 渠道使用）。
-   */
-  botToken?: string;
-  /**
-   * 应用 ID（Feishu/QQ 使用）。
-   */
-  appId?: string;
-  /**
-   * 应用密钥（Feishu/QQ 使用）。
-   */
-  appSecret?: string;
-  /**
-   * 平台域名（可选，主要用于 Feishu 私有部署或特殊网关）。
-   */
-  domain?: string;
-  /**
-   * 是否使用沙箱环境（QQ 使用）。
-   */
-  sandbox?: boolean;
-}
-
-/**
- * Bot 信息探测请求。
- */
-export interface ChatBotInfoResolveInput {
-  /**
-   * 目标渠道名称。
-   */
-  channel: ChatChannelName;
-  /**
-   * 渠道对应的认证凭据。
-   */
-  credentials: ChatBotInfoCredentialInput;
-}
-
-/**
- * Bot 信息探测结果。
- */
-export interface ChatBotInfoResult {
-  /**
-   * 渠道名称。
-   */
-  channel: ChatChannelName;
-  /**
-   * Bot 展示名称（用于 Console 列表展示和默认命名）。
-   */
-  name: string;
-  /**
-   * Bot 身份标识（通常是用户名/open_id/appId 等）。
-   */
-  identity?: string;
-  /**
-   * Bot 所有者信息（可选；平台可获取时返回）。
-   */
-  owner?: string;
-  /**
-   * Bot 创建者信息（可选；平台可获取时返回）。
-   */
-  creator?: string;
-  /**
-   * 平台返回的 bot 用户唯一 ID（若可获取）。
-   */
-  botUserId?: string;
-  /**
-   * 建议用于生成 channel account id 的稳定种子。
-   */
-  idSeed?: string;
-  /**
-   * 探测结果描述。
-   */
-  message: string;
-}
-
-/**
- * 渠道级 Bot 信息探测器接口。
- */
-export interface ChatChannelBotInfoProvider {
-  /**
-   * 当前探测器对应渠道。
-   */
-  readonly channel: ChatChannelName;
-  /**
-   * 使用凭据探测并返回标准化 bot 信息。
-   */
-  resolve(credentials: ChatBotInfoCredentialInput): Promise<ChatBotInfoResult>;
-}

package/src/service/builtins/chat/types/ChannelConfiguration.ts

@@ -1,161 +0,0 @@
-/**
- * Chat 渠道配置元信息类型。
- *
- * 关键点（中文）
- * - 每个 channel 通过统一结构声明“需要哪些参数、类型、描述、来源”。
- * - 该结构用于 Console / DB / CLI 直接消费，不依赖硬编码字段。
- */
-
-import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
-
-/**
- * 配置字段基础值类型。
- */
-export type ChatChannelConfigurationPrimitive = string | number | boolean | null;
-
-/**
- * 配置字段类型枚举。
- */
-export type ChatChannelConfigurationFieldType =
-  | "string"
-  | "boolean"
-  | "number"
-  | "secret"
-  | "enum";
-
-/**
- * 配置字段来源枚举。
- */
-export type ChatChannelConfigurationFieldSource =
-  | "ship_json"
-  | "bot_account"
-  | "env_fallback";
-
-/**
- * 枚举型字段可选项。
- */
-export interface ChatChannelConfigurationFieldOption {
-  /**
-   * 枚举值（真实写入值）。
-   */
-  value: string;
-  /**
-   * 展示标签（用于 UI 下拉选项）。
-   */
-  label: string;
-  /**
-   * 选项说明（用于帮助用户理解差异）。
-   */
-  description: string;
-}
-
-/**
- * 单个配置字段描述。
- */
-export interface ChatChannelConfigurationField {
-  /**
-   * 字段键名（例如 `channelAccountId`、`enabled`）。
-   */
-  key: string;
-  /**
-   * 字段展示名。
-   */
-  label: string;
-  /**
-   * 字段用途说明。
-   */
-  description: string;
-  /**
-   * 字段值类型。
-   */
-  type: ChatChannelConfigurationFieldType;
-  /**
-   * 字段值来源（downcity.json / channel account / env fallback）。
-   */
-  source: ChatChannelConfigurationFieldSource;
-  /**
-   * 该字段是否必填。
-   */
-  required: boolean;
-  /**
-   * 字段是否允许 `null`（用于清空）。
-   */
-  nullable: boolean;
-  /**
-   * 是否允许通过 `chat.configure` 写入。
-   */
-  writable: boolean;
-  /**
-   * 修改该字段后是否建议重载 channel。
-   */
-  restartRequired: boolean;
-  /**
-   * 默认值（可选）。
-   */
-  defaultValue?: ChatChannelConfigurationPrimitive;
-  /**
-   * 示例值（可选）。
-   */
-  example?: ChatChannelConfigurationPrimitive;
-  /**
-   * 枚举选项（仅 `type=enum` 时使用）。
-   */
-  options?: ChatChannelConfigurationFieldOption[];
-}
-
-/**
- * 单个渠道配置说明。
- */
-export interface ChatChannelConfigurationDescriptor {
-  /**
-   * 渠道名称。
-   */
-  channel: ChatChannelName;
-  /**
-   * 配置卡片标题。
-   */
-  title: string;
-  /**
-   * 配置说明（面向用户）。
-   */
-  description: string;
-  /**
-   * 描述器版本号（便于 UI 做兼容升级）。
-   */
-  version: string;
-  /**
-   * 该渠道支持的写入动作能力。
-   */
-  capabilities: {
-    /**
-     * 是否支持启用/禁用开关。
-     */
-    canToggleEnabled: boolean;
-    /**
-     * 是否支持 channel account 绑定。
-     */
-    canBindChannelAccount: boolean;
-    /**
-     * 是否支持 `chat.configure`。
-     */
-    canConfigure: boolean;
-  };
-  /**
-   * 渠道配置字段集合（按来源分组）。
-   */
-  fields: {
-    /**
-     * `downcity.json` 可声明字段。
-     */
-    ship: ChatChannelConfigurationField[];
-    /**
-     * `channel_accounts` 字段。
-     */
-    channelAccount: ChatChannelConfigurationField[];
-    /**
-     * 环境变量回退字段。
-     */
-    envFallback: ChatChannelConfigurationField[];
-  };
-}
-

package/src/service/builtins/chat/types/ChatHistory.ts

@@ -1,42 +0,0 @@
-/**
- * ChatHistory 类型定义。
- *
- * 关键点（中文）
- * - chat history 是聊天平台事件流（审计向），与 session message history 分离。
- * - 支持入站（inbound）与出站（outbound）事件，便于完整回放对话链路。
- */
-
-import type { JsonObject } from "@/types/common/Json.js";
-import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
-
-export type ChatHistoryIngressKind = "audit" | "exec";
-export type ChatHistoryDirection = "inbound" | "outbound";
-
-type ChatHistoryBaseEventV1 = {
-  v: 1;
-  id: string;
-  ts: number;
-  sessionId: string;
-  channel: ChatDispatchChannel;
-  chatId: string;
-  text: string;
-  targetType?: string;
-  threadId?: number;
-  messageId?: string;
-  actorId?: string;
-  actorName?: string;
-  extra?: JsonObject;
-};
-
-export type ChatHistoryInboundEventV1 = ChatHistoryBaseEventV1 & {
-  direction: "inbound";
-  ingressKind: ChatHistoryIngressKind;
-};
-
-export type ChatHistoryOutboundEventV1 = ChatHistoryBaseEventV1 & {
-  direction: "outbound";
-};
-
-export type ChatHistoryEventV1 =
-  | ChatHistoryInboundEventV1
-  | ChatHistoryOutboundEventV1;