@downcity/agent 1.1.1 → 1.1.6

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

@@ -1,78 +0,0 @@
-/**
- * Chat reply dispatch helper。
- *
- * 关键点（中文）
- * - 把 chat 回复前/回复后的扩展点统一收敛到这里。
- * - 仅服务 agent 执行生命周期，不覆盖手动 `chat send`。
- */
-
-import type { AgentContext } from "@/types/agent/AgentContext.js";
-import type { ChatReplyDispatchInput, ChatReplyEffectInput } from "@/shared/types/ChatPlugin.js";
-import type { JsonValue } from "@/shared/types/Json.js";
-import type { ChatDispatchChannel } from "@services/chat/types/ChatDispatcher.js";
-import { CHAT_PLUGIN_POINTS } from "@services/chat/runtime/PluginPoints.js";
-import { resolveDispatchTargetByChatKey } from "@services/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/services/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 "@/types/agent/AgentContext.js";
-import type { ChatEnvironmentPromptInput } from "@/shared/types/ChatPromptContext.js";
-import { readChatMetaBySessionId } from "@services/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/services/chat/types/BotInfo.ts

@@ -1,101 +0,0 @@
-/**
- * Chat Bot 信息探测类型定义。
- *
- * 关键点（中文）
- * - 将“凭据 -> bot 基础信息”的探测输入输出结构标准化。
- * - Console、Channel Account 存储、后续自动化流程都复用该结构。
- */
-
-import type { ChatChannelName } from "@services/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/services/chat/types/ChannelConfiguration.ts

@@ -1,161 +0,0 @@
-/**
- * Chat 渠道配置元信息类型。
- *
- * 关键点（中文）
- * - 每个 channel 通过统一结构声明“需要哪些参数、类型、描述、来源”。
- * - 该结构用于 Console / DB / CLI 直接消费，不依赖硬编码字段。
- */
-
-import type { ChatChannelName } from "@services/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/services/chat/types/ChatHistory.ts

@@ -1,42 +0,0 @@
-/**
- * ChatHistory 类型定义。
- *
- * 关键点（中文）
- * - chat history 是聊天平台事件流（审计向），与 session message history 分离。
- * - 支持入站（inbound）与出站（outbound）事件，便于完整回放对话链路。
- */
-
-import type { JsonObject } from "@/shared/types/Json.js";
-import type { ChatDispatchChannel } from "@services/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;

package/src/services/chat/types/DirectDispatch.ts

@@ -1,133 +0,0 @@
-/**
- * Direct dispatch 协议类型。
- *
- * 关键点（中文）
- * - 仅用于当前 chat assistant 出站解析。
- * - frontmatter metadata 语义与 `city chat send` 保持一致，再额外支持 `react`。
- */
-
-import type {
-  ChatMessageFileTag,
-  ChatMessageFileType,
-} from "@services/chat/types/ChatMessageMarkup.js";
-
-export type DirectFileType = ChatMessageFileType;
-export type DirectFileTagPayload = ChatMessageFileTag;
-
-/**
- * 解析后的反应参数（来自 frontmatter metadata）。
- */
-export interface DirectReactTagPayload {
-  /**
-   * 表情内容（如 👍 / 🔥）。
-   *
-   * 说明（中文）
-   * - 不能为空字符串。
-   */
-  emoji: string;
-
-  /**
-   * 是否使用大表情。
-   *
-   * 说明（中文）
-   * - 仅平台支持时生效（如 Telegram）。
-   */
-  big?: boolean;
-}
-
-/**
- * 运行时主文本发送参数（可直接用于发送）。
- */
-export interface ResolvedDirectTextPayload {
-  /**
-   * 用户可见正文（已 trim，非空）。
-   */
-  text: string;
-
-  /**
-   * 最终目标会话键（已回填默认值）。
-   */
-  chatKey: string;
-
-  /**
-   * 是否以 reply 语义发送正文。
-   *
- * 说明（中文）
- * - 语义与 `city chat send --reply` 一致。
- * - 当 metadata 提供 `reply: true` 或显式 `messageId` 时自动为 true。
-  */
-  replyToMessage: boolean;
-
-  /**
-   * 可选 reply 目标消息 ID。
-   *
-   * 说明（中文）
-   * - 来自 metadata 的 `messageId`，或 `reply` 的旧式 messageId 写法。
-   */
-  messageId?: string;
-
-  /**
-   * 可选延迟发送毫秒数。
-   *
-   * 说明（中文）
-   * - 与 `city chat send --delay` 对齐。
-   */
-  delayMs?: number;
-
-  /**
-   * 可选定时发送毫秒时间戳。
-   *
-   * 说明（中文）
-   * - 与 `city chat send --time` 对齐。
-   */
-  sendAtMs?: number;
-}
-
-/**
- * 运行时反应发送参数（可直接用于发送）。
- */
-export interface ResolvedDirectReactionPayload {
-  /**
-   * 表情内容（已 trim，非空）。
-   */
-  emoji: string;
-
-  /**
-   * 最终目标会话键（已回填默认值）。
-   */
-  chatKey: string;
-
-  /**
-   * 可选目标消息 ID。
-   *
-   * 说明（中文）
-   * - 来自主文本 metadata 的 `reply`。
-   */
-  messageId?: string;
-
-  /**
-   * 是否使用大表情。
-   */
-  big: boolean;
-}
-
-/**
- * direct 模式一次 assistant 输出的完整执行计划。
- */
-export interface ResolvedDirectDispatchPlan {
-  /**
-   * 主文本发送计划。
-   *
-   * 说明（中文）
-   * - 为空表示本轮没有可发送正文（例如只有 reaction metadata）。
-   */
-  text: ResolvedDirectTextPayload | null;
-
-  /**
-   * 反应动作计划列表。
-   *
-   * 说明（中文）
-   * - 允许一次输出触发多个反应动作。
-   */
-  reactions: ResolvedDirectReactionPayload[];
-}