@downcity/agent 1.1.1

package/bin/services/chat/types/FeishuInboundAttachment.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Feishu 入站附件类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述飞书消息中的附件资源，供 channel 下载落地后再转成 `<file>` 标签。
+ * - 把“平台原始 message_type”和“Agent 侧附件语义类型”拆开，避免后续多模态扩展时耦合。
+ */
+import type { FeishuAttachmentType } from "../../chat/types/FeishuAttachment.js";
+/**
+ * 飞书入站消息类型。
+ *
+ * 说明（中文）
+ * - `media` 在飞书中通常表示视频类消息。
+ * - `post` 为飞书富文本消息，内部可能夹带文本、链接、@、图片等节点。
+ * - `video` 作为兜底兼容值保留，便于兼容新旧 payload 或未来扩展。
+ */
+export type FeishuInboundMessageType = "text" | "post" | "image" | "file" | "audio" | "media" | "video";
+/**
+ * 飞书消息资源下载类型。
+ *
+ * 说明（中文）
+ * - 该值会传给 `im/v1/messages/:message_id/resources/:file_key` 的 `type` 参数。
+ */
+export type FeishuInboundResourceType = "image" | "file" | "audio" | "media" | "video";
+/**
+ * 飞书入站附件的原始 content 载荷。
+ *
+ * 说明（中文）
+ * - 飞书不同消息类型的 content 字段结构并不完全一致，因此这里采用宽松定义。
+ * - 只保留当前下载与注入链路真正需要的字段。
+ */
+export interface FeishuInboundAttachmentPayload {
+    /**
+     * 资源 key。
+     *
+     * 说明（中文）
+     * - 图片消息常见为 `image_key`。
+     * - 文件、音频、视频等消息常见为 `file_key`。
+     */
+    resourceKey: string;
+    /**
+     * 原始文件名。
+     *
+     * 说明（中文）
+     * - 某些消息类型不会提供文件名，这里允许为空。
+     * - 若为空，后续会根据 headers / MIME 做兜底命名。
+     */
+    fileName?: string;
+    /**
+     * 可选时长（秒）。
+     *
+     * 说明（中文）
+     * - 主要用于音频/视频类消息。
+     * - 当前仅作信息保留，不参与主流程判断。
+     */
+    duration?: number;
+    /**
+     * 原始图片 key。
+     *
+     * 说明（中文）
+     * - `media` 类消息可能同时携带预览图 `image_key`。
+     * - 当前仅保留原始字段，便于后续多模态增强或预览扩展。
+     */
+    imageKey?: string;
+}
+/**
+ * 飞书归一化后的入站附件描述。
+ */
+export interface FeishuIncomingAttachmentDescriptor {
+    /**
+     * Agent 侧附件类型。
+     *
+     * 说明（中文）
+     * - 会直接映射到 `<file type="...">...</file>`。
+     */
+    type: FeishuAttachmentType;
+    /**
+     * 飞书资源下载类型。
+     *
+     * 说明（中文）
+     * - 会传给消息资源下载接口。
+     */
+    resourceType: FeishuInboundResourceType;
+    /**
+     * 飞书消息资源 key。
+     *
+     * 说明（中文）
+     * - 该值会作为下载接口路径中的 `file_key` 参数使用。
+     */
+    resourceKey: string;
+    /**
+     * 归一化后的展示名称。
+     *
+     * 说明（中文）
+     * - 优先使用飞书原始文件名。
+     * - 若平台未提供，则后续下载阶段会继续兜底。
+     */
+    fileName?: string;
+    /**
+     * 可选的附件说明。
+     *
+     * 说明（中文）
+     * - 当前主要用于生成更友好的 `<file caption="...">` 文案。
+     */
+    description?: string;
+    /**
+     * 原始 payload 信息。
+     *
+     * 说明（中文）
+     * - 便于后续扩展和调试，不必再次回头解析原始 JSON。
+     */
+    raw: FeishuInboundAttachmentPayload;
+}
+//# sourceMappingURL=FeishuInboundAttachment.d.ts.map

package/bin/services/chat/types/FeishuInboundAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuInboundAttachment.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/types/FeishuInboundAttachment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAErF;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;;;OAKG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAE3B;;;;;OAKG;IACH,YAAY,EAAE,yBAAyB,CAAC;IAExC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,GAAG,EAAE,8BAA8B,CAAC;CACrC"}

package/bin/services/chat/types/FeishuInboundAttachment.js

@@ -0,0 +1,9 @@
+/**
+ * Feishu 入站附件类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述飞书消息中的附件资源，供 channel 下载落地后再转成 `<file>` 标签。
+ * - 把“平台原始 message_type”和“Agent 侧附件语义类型”拆开，避免后续多模态扩展时耦合。
+ */
+export {};
+//# sourceMappingURL=FeishuInboundAttachment.js.map

package/bin/services/chat/types/FeishuInboundAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuInboundAttachment.js","sourceRoot":"","sources":["../../../../src/services/chat/types/FeishuInboundAttachment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/services/chat/types/FeishuPost.d.ts

@@ -0,0 +1,287 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=FeishuPost.d.ts.map

package/bin/services/chat/types/FeishuPost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPost.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/types/FeishuPost.ts"],"names":[],"mappings":"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"}

package/bin/services/chat/types/FeishuPost.js

@@ -0,0 +1,9 @@
+/**
+ * Feishu `post` 富文本消息类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述飞书 `msg_type=post` 的核心结构，供入站解析与出站构建复用。
+ * - 这里只保留当前 chat channel 真正会消费的字段，避免把平台超大 schema 整体引入运行时。
+ */
+export {};
+//# sourceMappingURL=FeishuPost.js.map

package/bin/services/chat/types/FeishuPost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPost.js","sourceRoot":"","sources":["../../../../src/services/chat/types/FeishuPost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/services/chat/types/QqInboundDedupe.d.ts

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

package/bin/services/chat/types/QqInboundDedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqInboundDedupe.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/types/QqInboundDedupe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,CAAC,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,EAAE,CAAC;CACf"}

package/bin/services/chat/types/QqInboundDedupe.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QqInboundDedupe.js.map

package/bin/services/chat/types/QqInboundDedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqInboundDedupe.js","sourceRoot":"","sources":["../../../../src/services/chat/types/QqInboundDedupe.ts"],"names":[],"mappings":""}

package/bin/services/chat/types/QqVoice.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=QqVoice.d.ts.map

package/bin/services/chat/types/QqVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqVoice.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/types/QqVoice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,uBAAuB,CAAC;IAC9B;;OAEG;IACH,GAAG,EAAE,sBAAsB,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/bin/services/chat/types/QqVoice.js

@@ -0,0 +1,9 @@
+/**
+ * QQ 语音/附件处理相关类型。
+ *
+ * 关键点（中文）
+ * - 统一描述 QQ 入站附件的“原始形态”与“归一化形态”。
+ * - 仅覆盖 chat 语音转写链路所需字段，避免过度耦合平台全量 schema。
+ */
+export {};
+//# sourceMappingURL=QqVoice.js.map

package/bin/services/chat/types/QqVoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqVoice.js","sourceRoot":"","sources":["../../../../src/services/chat/types/QqVoice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/services/chat/types/ReplyContext.d.ts

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

package/bin/services/chat/types/ReplyContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyContext.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/types/ReplyContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/bin/services/chat/types/ReplyContext.js

@@ -0,0 +1,10 @@
+/**
+ * ReplyContext：入站 reply / 引用消息上下文。
+ *
+ * 关键点（中文）
+ * - 统一描述“当前消息所引用的上一条消息”。
+ * - 供 Telegram / Feishu / 未来其他渠道复用。
+ * - 该结构只表达模型真正需要的引用信息，不绑定具体平台原始 payload。
+ */
+export {};
+//# sourceMappingURL=ReplyContext.js.map

package/bin/services/chat/types/ReplyContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyContext.js","sourceRoot":"","sources":["../../../../src/services/chat/types/ReplyContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/services/contact/Action.d.ts

@@ -0,0 +1,9 @@
+/**
+ * contact action 兼容入口。
+ *
+ * 关键点（中文）
+ * - 当前 contact action 直接内聚在 `ContactService` 中。
+ * - 预留该文件，便于后续拆分更复杂的 action helper。
+ */
+export {};
+//# sourceMappingURL=Action.d.ts.map

package/bin/services/contact/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../src/services/contact/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC"}