@downcity/agent 1.1.35 → 1.1.43

package/src/plugin/builtins/chat/types/FeishuPost.ts

@@ -1,338 +0,0 @@
-/**
- * Feishu `post` 富文本消息类型定义。
- *
- * 关键点（中文）
- * - 统一描述飞书 `msg_type=post` 的核心结构，供入站解析与出站构建复用。
- * - 这里只保留当前 chat channel 真正会消费的字段，避免把平台超大 schema 整体引入运行时。
- */
-
-/**
- * Feishu `post` 语言块 key。
- *
- * 说明（中文）
- * - 飞书常见语言块为 `zh_cn` / `en_us` / `ja_jp`。
- * - 为了兼容未来新增 locale，这里保留 `string` 兜底。
- */
-export type FeishuPostLocaleKey =
-  | "zh_cn"
-  | "en_us"
-  | "ja_jp"
-  | "zh_hk"
-  | "zh_tw"
-  | string;
-
-/**
- * Feishu `post` 顶层 payload。
- */
-export interface FeishuPostPayload {
-  /**
-   * 语言块映射。
-   *
-   * 说明（中文）
-   * - key 为 locale。
-   * - value 为该语言对应的标题与内容。
-   */
-  [locale: string]: FeishuPostLocaleContent | unknown;
-}
-
-/**
- * 单个 locale 下的富文本内容。
- */
-export interface FeishuPostLocaleContent {
-  /**
-   * 富文本标题。
-   *
-   * 说明（中文）
-   * - 可为空字符串。
-   * - 入站解析时会作为正文前缀保留。
-   */
-  title?: string;
-
-  /**
-   * 富文本正文二维数组。
-   *
-   * 说明（中文）
-   * - 第一维表示“段/行”。
-   * - 第二维表示这一行中的富文本节点序列。
-   */
-  content?: FeishuPostParagraph[];
-}
-
-/**
- * 一行富文本节点列表。
- */
-export type FeishuPostParagraph = FeishuPostElement[];
-
-/**
- * Feishu `post` 支持的节点联合。
- *
- * 说明（中文）
- * - 当前覆盖文本、链接、提及、图片、媒体、表情、分割线等常见节点。
- * - 未识别节点会在运行时按兜底策略处理，不依赖这里声明全部平台字段。
- */
-export type FeishuPostElement =
-  | FeishuPostTextElement
-  | FeishuPostLinkElement
-  | FeishuPostMentionElement
-  | FeishuPostImageElement
-  | FeishuPostMediaElement
-  | FeishuPostEmotionElement
-  | FeishuPostHrElement
-  | FeishuPostUnknownElement;
-
-/**
- * 文本节点。
- */
-export interface FeishuPostTextElement {
-  /**
-   * 节点类型。
-   */
-  tag: "text";
-
-  /**
-   * 文本内容。
-   *
-   * 说明（中文）
-   * - 出站时直接显示给用户。
-   * - 入站时会被拼接回自然语言正文。
-   */
-  text: string;
-
-  /**
-   * 是否对特殊字符做转义控制。
-   *
-   * 说明（中文）
-   * - 飞书 `post` 会携带该字段。
-   * - 当前 runtime 不依赖该值做逻辑判断，仅做结构兼容保留。
-   */
-  un_escape?: boolean;
-
-  /**
-   * 文本样式集合。
-   *
-   * 说明（中文）
-   * - 如 `bold` / `underline` / `lineThrough` / `italic`。
-   * - 当前仅透传兼容，不参与 runtime 主逻辑。
-   */
-  style?: string[];
-}
-
-/**
- * 超链接节点。
- */
-export interface FeishuPostLinkElement {
-  /**
-   * 节点类型。
-   */
-  tag: "a";
-
-  /**
-   * 链接展示文本。
-   */
-  text: string;
-
-  /**
-   * 链接目标地址。
-   */
-  href: string;
-
-  /**
-   * 可选文本样式集合。
-   */
-  style?: string[];
-}
-
-/**
- * @提及节点。
- */
-export interface FeishuPostMentionElement {
-  /**
-   * 节点类型。
-   */
-  tag: "at";
-
-  /**
-   * 被提及用户 ID。
-   *
-   * 说明（中文）
-   * - 可能是 `open_id` / `user_id`。
-   * - `all` 场景通常不依赖该字段。
-   */
-  user_id?: string;
-
-  /**
-   * 被提及用户展示名。
-   *
-   * 说明（中文）
-   * - 入站解析时优先使用该字段生成 `@用户名`。
-   */
-  user_name?: string;
-}
-
-/**
- * 图片节点。
- */
-export interface FeishuPostImageElement {
-  /**
-   * 节点类型。
-   */
-  tag: "img";
-
-  /**
-   * 飞书图片资源 key。
-   *
-   * 说明（中文）
-   * - 入站时用于下载消息内图片。
-   * - 出站时由图片上传接口返回。
-   */
-  image_key: string;
-
-  /**
-   * 可选替代文本。
-   *
-   * 说明（中文）
-   * - 平台不会总是返回该字段。
-   * - 当前主要用于生成更友好的文本占位与附件描述。
-   */
-  alt?: string;
-}
-
-/**
- * 媒体节点。
- */
-export interface FeishuPostMediaElement {
-  /**
-   * 节点类型。
-   *
-   * 说明（中文）
-   * - 部分 payload 可能使用 `media` / `file` / `audio` / `video`。
-   */
-  tag: "media" | "file" | "audio" | "video";
-
-  /**
-   * 飞书文件资源 key。
-   *
-   * 说明（中文）
-   * - 当前主要用于下载视频/文件/音频资源。
-   */
-  file_key?: string;
-
-  /**
-   * 可选预览图 key。
-   */
-  image_key?: string;
-
-  /**
-   * 可选文件名。
-   */
-  file_name?: string;
-
-  /**
-   * 可选标题。
-   */
-  title?: string;
-
-  /**
-   * 可选时长（秒）。
-   */
-  duration?: number;
-}
-
-/**
- * 表情节点。
- */
-export interface FeishuPostEmotionElement {
-  /**
-   * 节点类型。
-   */
-  tag: "emotion";
-
-  /**
-   * 表情类型标识。
-   *
-   * 说明（中文）
-   * - 当前入站会退化成可读文本占位，例如 `[表情:smile]`。
-   */
-  emoji_type?: string;
-}
-
-/**
- * 分割线节点。
- */
-export interface FeishuPostHrElement {
-  /**
-   * 节点类型。
-   */
-  tag: "hr";
-}
-
-/**
- * 未知节点兜底结构。
- */
-export interface FeishuPostUnknownElement {
-  /**
-   * 节点类型原文。
-   *
-   * 说明（中文）
-   * - 当平台新增新节点时，运行时仍可通过该字段做兜底处理。
-   */
-  tag: string;
-
-  /**
-   * 节点原始文本。
-   *
-   * 说明（中文）
-   * - 并非所有未知节点都有该字段。
-   * - 当前仅在兜底拼接正文时 best-effort 使用。
-   */
-  text?: string;
-
-  /**
-   * 节点原始标题。
-   */
-  title?: string;
-
-  /**
-   * 节点原始链接。
-   */
-  href?: string;
-
-  /**
-   * 节点原始图片 key。
-   */
-  image_key?: string;
-
-  /**
-   * 节点原始文件 key。
-   */
-  file_key?: string;
-
-  /**
-   * 其他平台字段。
-   *
-   * 说明（中文）
-   * - 保留开放形态，避免 schema 漂移导致类型过度僵化。
-   */
-  [key: string]: unknown;
-}
-
-/**
- * 出站 `post` 内联图片描述。
- */
-export interface FeishuPostInlineImage {
-  /**
-   * 飞书图片 key。
-   *
-   * 说明（中文）
-   * - 由 `im/v1/images` 上传接口返回。
-   */
-  imageKey: string;
-
-  /**
-   * 可选图片说明。
-   *
-   * 说明（中文）
-   * - 当前会在图片下一行追加为普通文本。
-   */
-  caption?: string;
-}

package/src/plugin/builtins/chat/types/QqInboundDedupe.ts

@@ -1,12 +0,0 @@
-/**
- * QQ 入站去重快照类型。
- *
- * 关键点（中文）
- * - 持久化到本地 JSON 文件，用于重启后去重。
- */
-export interface QqInboundDedupeSnapshotV1 {
-  v: 1;
-  updatedAt: number;
-  ids: string[];
-}
-

package/src/plugin/builtins/chat/types/QqVoice.ts

@@ -1,126 +0,0 @@
-/**
- * QQ 语音/附件处理相关类型。
- *
- * 关键点（中文）
- * - 统一描述 QQ 入站附件的“原始形态”与“归一化形态”。
- * - 仅覆盖 chat 语音转写链路所需字段，避免过度耦合平台全量 schema。
- */
-
-/**
- * QQ 网关消息中的原始附件对象（宽松字段集合）。
- *
- * 说明（中文）
- * - QQ 不同事件类型/权限集返回字段存在差异，本类型使用“可选 + 宽松”的兼容策略。
- * - 未列出的字段可通过索引签名继续透传，供调试与后续扩展。
- */
-export interface QqRawInboundAttachment {
-  /**
-   * 附件唯一标识（可能是 `id`、`file_id`、`media_id` 等）。
-   */
-  id?: string;
-  /**
-   * 文件标识（平台侧文件 ID）。
-   */
-  file_id?: string;
-  /**
-   * 附件文件名（如 `voice.ogg`）。
-   */
-  filename?: string;
-  /**
-   * 备用文件名字段（部分 payload 使用下划线命名）。
-   */
-  file_name?: string;
-  /**
-   * MIME 类型（如 `audio/ogg`）。
-   */
-  content_type?: string;
-  /**
-   * 备用 MIME 字段（如 `mime_type`）。
-   */
-  mime_type?: string;
-  /**
-   * 下载地址（标准 URL 字段）。
-   */
-  url?: string;
-  /**
-   * 备用下载地址字段。
-   */
-  download_url?: string;
-  /**
-   * 文件地址字段（部分 payload 使用）。
-   */
-  file_url?: string;
-  /**
-   * 音频地址字段（部分 payload 使用）。
-   */
-  audio_url?: string;
-  /**
-   * 语音地址字段（部分 payload 使用）。
-   */
-  voice_url?: string;
-  /**
-   * 媒体类型（如 `audio` / `image` / `video`）。
-   */
-  media_type?: string;
-  /**
-   * 附件类型（宽松字符串，可能与 `media_type` 重复）。
-   */
-  type?: string;
-  /**
-   * 附件大小（字节）。
-   */
-  size?: number;
-  /**
-   * 允许透传未知字段，避免在 schema 演进时丢信息。
-   */
-  [key: string]: unknown;
-}
-
-/**
- * QQ 附件归一化后的类型枚举。
- */
-export type QqInboundAttachmentKind =
-  | "voice"
-  | "audio"
-  | "photo"
-  | "video"
-  | "document"
-  | "unknown";
-
-/**
- * QQ 入站附件归一化结构。
- *
- * 说明（中文）
- * - `raw` 保留平台原始对象，便于日志与排障。
- * - `localPath` 在附件已落地时可直接用于转写。
- */
-export interface QqIncomingAttachment {
-  /**
-   * 归一化后的附件类型。
-   */
-  kind: QqInboundAttachmentKind;
-  /**
-   * 原始附件对象。
-   */
-  raw: QqRawInboundAttachment;
-  /**
-   * 附件 ID（若可解析）。
-   */
-  attachmentId?: string;
-  /**
-   * 附件文件名（若可解析）。
-   */
-  fileName?: string;
-  /**
-   * MIME 类型（若可解析）。
-   */
-  contentType?: string;
-  /**
-   * 可下载 URL（若可解析）。
-   */
-  url?: string;
-  /**
-   * 附件本地绝对路径（若已存在）。
-   */
-  localPath?: string;
-}

package/src/plugin/builtins/chat/types/ReplyContext.ts

@@ -1,49 +0,0 @@
-/**
- * ReplyContext：入站 reply / 引用消息上下文。
- *
- * 关键点（中文）
- * - 统一描述“当前消息所引用的上一条消息”。
- * - 供 Telegram / Feishu / 未来其他渠道复用。
- * - 该结构只表达模型真正需要的引用信息，不绑定具体平台原始 payload。
- */
-
-/**
- * 归一化后的入站引用上下文。
- */
-export interface InboundReplyContext {
-  /**
-   * 被引用消息的消息 ID。
-   *
-   * 说明（中文）
-   * - 该值来自平台原始 reply 目标。
-   * - 主要用于审计与调试，模型通常不会直接依赖它做推理。
-   */
-  messageId?: string;
-
-  /**
-   * 被引用消息发送者的展示名。
-   *
-   * 说明（中文）
-   * - 若平台未提供姓名，则允许为空。
-   * - 该字段用于帮助模型理解“这条被引用消息是谁说的”。
-   */
-  actorName?: string;
-
-  /**
-   * 被引用消息的归一化正文。
-   *
-   * 说明（中文）
-   * - 文本消息时保存原始正文。
-   * - 附件或无法直接展开的消息，会保存稳定的占位描述。
-   */
-  text?: string;
-
-  /**
-   * 用户显式框选的引用片段。
-   *
-   * 说明（中文）
-   * - 仅部分平台支持“回复时引用一小段内容”。
-   * - 若存在，该字段优先表达用户本次真正关注的局部内容。
-   */
-  quoteText?: string;
-}