@downcity/agent 1.1.25 → 1.1.35

package/bin/plugin/builtins/chat/types/ChatPluginActionPayload.js

@@ -0,0 +1,10 @@
+/**
+ * ChatPlugin action 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 chat plugin runtime action 的输入 payload。
+ * - 这些类型属于跨模块共享契约，因此统一放到 `types/` 下。
+ * - 字段命名保持与 CLI/API 参数一致，降低映射心智负担。
+ */
+export {};
+//# sourceMappingURL=ChatPluginActionPayload.js.map

package/bin/plugin/builtins/chat/types/ChatPluginActionPayload.js.map

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

package/bin/plugin/builtins/chat/types/ChatPromptContext.d.ts

@@ -0,0 +1,125 @@
+/**
+ * ChatPromptContext：chat prompt 注入相关类型。
+ *
+ * 关键点（中文）
+ * - 统一描述“当前 chat 环境”与“入站用户信息”两类 prompt 数据。
+ * - chat 路由环境与用户身份信息分离，避免把平台路由字段混入 user info。
+ * - 所有字段均保持可序列化，便于 system prompt 与入站消息文本复用。
+ */
+import type { ChatAuthorizationPermission } from "../../../../plugin/builtins/auth/types/AuthPlugin.js";
+import type { ChatDispatchChannel } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
+/**
+ * 当前 chat 环境提示输入。
+ */
+export interface ChatEnvironmentPromptInput {
+    /**
+     * 当前会话对应的 sessionId。
+     *
+     * 说明（中文）
+     * - 对外统一使用 `sessionId` 语义。
+     * - chat plugin runtime 内部统一按 session 语义路由与持久化。
+     */
+    sessionId: string;
+    /**
+     * 当前 chatKey。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 里通常与 `sessionId` 一致。
+     * - 保留独立字段，避免未来路由键语义调整时影响调用方。
+     */
+    chatKey: string;
+    /**
+     * 当前消息来源渠道。
+     *
+     * 说明（中文）
+     * - 例如 `telegram`、`feishu`、`qq`。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 平台原始 chatId。
+     *
+     * 说明（中文）
+     * - 该值仅用于路由，不应被模型当作用户身份字段理解。
+     */
+    chatId: string;
+    /**
+     * 平台侧会话类型。
+     *
+     * 说明（中文）
+     * - 例如 `private`、`group`、`channel`、`topic`、`c2c`。
+     */
+    chatType?: string;
+    /**
+     * 平台 thread/topic 标识。
+     *
+     * 说明（中文）
+     * - 仅在支持 topic/thread 的平台中提供。
+     */
+    threadId?: number;
+    /**
+     * 当前会话展示名。
+     *
+     * 说明（中文）
+     * - 例如群名、频道名、私聊对象名。
+     * - 仅用于帮助模型理解上下文，不参与路由匹配。
+     */
+    chatTitle?: string;
+}
+/**
+ * 入站用户信息提示输入。
+ */
+export interface QueuedUserInfoInput {
+    /**
+     * 当前消息 ID。
+     *
+     * 说明（中文）
+     * - 这是本次入站事件对应的平台消息标识。
+     * - 保留在 user/request info 中，便于 reply/react 等操作定位本轮输入。
+     */
+    messageId?: string;
+    /**
+     * 当前发言用户 ID。
+     *
+     * 说明（中文）
+     * - 来自平台侧用户标识，可能为空或不可得。
+     */
+    userId?: string;
+    /**
+     * 当前发言用户名或昵称。
+     *
+     * 说明（中文）
+     * - 渠道适配器按 best-effort 提供。
+     */
+    username?: string;
+    /**
+     * 当前用户在授权系统中的角色 ID。
+     *
+     * 说明（中文）
+     * - 例如 `default`、`member`、`admin`。
+     */
+    roleId?: string;
+    /**
+     * 当前用户拥有的权限集合。
+     *
+     * 说明（中文）
+     * - 仅描述授权快照，不代表平台原生权限模型。
+     */
+    permissions?: ChatAuthorizationPermission[];
+    /**
+     * 当前消息接收时间。
+     *
+     * 说明（中文）
+     * - 推荐传入 ISO8601 字符串。
+     * - 为空时由构造器回退到当前系统时间。
+     */
+    receivedAt?: string;
+    /**
+     * 当前用户时区。
+     *
+     * 说明（中文）
+     * - 仅在上游网关或客户端显式提供时传入。
+     * - Telegram / Feishu / QQ 等 bot 入站通常不会直接提供该字段。
+     */
+    userTimezone?: string;
+}
+//# sourceMappingURL=ChatPromptContext.d.ts.map

package/bin/plugin/builtins/chat/types/ChatPromptContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatPromptContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/ChatPromptContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAE7B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAE5C;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/bin/plugin/builtins/chat/types/ChatPromptContext.js.map

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

package/bin/plugin/builtins/chat/types/ChatQueue.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ChatQueue 类型定义。
+ *
+ * 关键点（中文）
+ * - 描述 chat 队列的数据结构与入队协议
+ * - 供 services 与 process 统一复用
+ */
+import type { JsonObject } from "../../../../types/common/Json.js";
+export type ChatQueueItemKind = "exec" | "audit" | "control";
+export type ChatQueueControl = {
+    type: "clear";
+};
+export type ChatQueueItem = {
+    id: string;
+    enqueuedAt: number;
+    kind: ChatQueueItemKind;
+    channel: "telegram" | "feishu" | "qq";
+    targetId: string;
+    sessionId: string;
+    text: string;
+    targetType?: string;
+    threadId?: number;
+    messageId?: string;
+    actorId?: string;
+    actorName?: string;
+    extra?: JsonObject;
+    control?: ChatQueueControl;
+};
+export type ChatQueueEnqueueParams = Omit<ChatQueueItem, "id" | "enqueuedAt"> & {
+    kind?: ChatQueueItemKind;
+};
+export type ChatQueueEnqueueResult = {
+    lanePosition: number;
+    itemId: string;
+};
+//# sourceMappingURL=ChatQueue.d.ts.map

package/bin/plugin/builtins/chat/types/ChatQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatQueue.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/ChatQueue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,YAAY,CAAC,GAAG;IAC9E,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/bin/plugin/builtins/chat/types/ChatQueue.js.map

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

package/bin/plugin/builtins/chat/types/ChatQueueWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatQueueWorker.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/ChatQueueWorker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/bin/plugin/builtins/chat/types/ChatQueueWorker.js.map

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

package/bin/plugin/builtins/chat/types/ChatRuntime.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ChatRuntime 类型定义。
+ *
+ * 关键点（中文）
+ * - 这些类型描述 chat plugin runtime 的实例级运行态。
+ * - channel bots 的状态所有权归属于 `ChatPlugin` 实例，而不是模块级单例。
+ */
+import type { FeishuBot } from "../../../../plugin/builtins/chat/channels/feishu/Feishu.js";
+import type { QQBot } from "../../../../plugin/builtins/chat/channels/qq/QQ.js";
+import type { TelegramBot } from "../../../../plugin/builtins/chat/channels/telegram/Bot.js";
+/**
+ * `ChatPlugin` 实例持有的渠道状态。
+ *
+ * 关键点（中文）
+ * - 这里显式把 3 个内建渠道拆成独立槽位，避免继续使用弱类型 map。
+ * - 未初始化的渠道统一为 `null`，不使用 `undefined`。
+ */
+export type ChatChannelState = {
+    /**
+     * Telegram 渠道 bot 实例。
+     */
+    telegram: TelegramBot | null;
+    /**
+     * Feishu 渠道 bot 实例。
+     */
+    feishu: FeishuBot | null;
+    /**
+     * QQ 渠道 bot 实例。
+     */
+    qq: QQBot | null;
+};
+//# sourceMappingURL=ChatRuntime.d.ts.map

package/bin/plugin/builtins/chat/types/ChatRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/ChatRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kDAAkD,CAAC;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,EAAE,EAAE,KAAK,GAAG,IAAI,CAAC;CAClB,CAAC"}

package/bin/plugin/builtins/chat/types/ChatRuntime.js

@@ -0,0 +1,9 @@
+/**
+ * ChatRuntime 类型定义。
+ *
+ * 关键点（中文）
+ * - 这些类型描述 chat plugin runtime 的实例级运行态。
+ * - channel bots 的状态所有权归属于 `ChatPlugin` 实例，而不是模块级单例。
+ */
+export {};
+//# sourceMappingURL=ChatRuntime.js.map

package/bin/plugin/builtins/chat/types/ChatRuntime.js.map

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

package/bin/plugin/builtins/chat/types/DirectDispatch.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Direct dispatch 协议类型。
+ *
+ * 关键点（中文）
+ * - 仅用于当前 chat assistant 出站解析。
+ * - frontmatter metadata 语义与 `city chat send` 保持一致，再额外支持 `react`。
+ */
+import type { ChatMessageFileTag, ChatMessageFileType } from "../../../../plugin/builtins/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[];
+}
+//# sourceMappingURL=DirectDispatch.d.ts.map

package/bin/plugin/builtins/chat/types/DirectDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectDispatch.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/DirectDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,mDAAmD,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AACjD,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;MAME;IACF,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAEvC;;;;;OAKG;IACH,SAAS,EAAE,6BAA6B,EAAE,CAAC;CAC5C"}

package/bin/plugin/builtins/chat/types/DirectDispatch.js.map

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

package/bin/plugin/builtins/chat/types/FeishuAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuAttachment.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/FeishuAttachment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;;;OAKG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAE3B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/bin/plugin/builtins/chat/types/FeishuAttachment.js.map

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

package/bin/plugin/builtins/chat/types/FeishuInboundAttachment.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Feishu 入站附件类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述飞书消息中的附件资源，供 channel 下载落地后再转成 `<file>` 标签。
+ * - 把“平台原始 message_type”和“Agent 侧附件语义类型”拆开，避免后续多模态扩展时耦合。
+ */
+import type { FeishuAttachmentType } from "../../../../plugin/builtins/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/plugin/builtins/chat/types/FeishuInboundAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuInboundAttachment.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/FeishuInboundAttachment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAE7F;;;;;;;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/plugin/builtins/chat/types/FeishuInboundAttachment.js.map

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

package/bin/plugin/builtins/chat/types/FeishuPost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPost.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/types/FeishuPost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,GAAG,OAAO,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,EAAE,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,GACrB,qBAAqB,GACrB,wBAAwB,GACxB,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,GACxB,mBAAmB,GACnB,wBAAwB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,GAAG,EAAE,GAAG,CAAC;IAET;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,GAAG,EAAE,IAAI,CAAC;IAEV;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC;IAEX;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,GAAG,EAAE,SAAS,CAAC;IAEf;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,GAAG,EAAE,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/bin/plugin/builtins/chat/types/FeishuPost.js.map

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

package/bin/plugin/builtins/chat/types/QqInboundDedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqInboundDedupe.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/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/plugin/builtins/chat/types/QqInboundDedupe.js.map

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

package/bin/plugin/builtins/chat/types/QqVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqVoice.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/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/plugin/builtins/chat/types/QqVoice.js.map

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

package/bin/plugin/builtins/chat/types/ReplyContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/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/plugin/builtins/chat/types/ReplyContext.js.map

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

package/bin/plugin/builtins/contact/Action.d.ts

@@ -0,0 +1,62 @@
+/**
+ * contact action 注册表。
+ *
+ * 关键点（中文）
+ * - 这里只负责 CLI action 与内部远端 command action 映射，不承载 contact 业务实现。
+ * - 业务动作通过 handlers 注入，保持 `ContactPlugin` 类本身更薄。
+ */
+import type { AgentContext } from "../../../core/AgentContextTypes.js";
+import type { JsonValue } from "../../../types/common/Json.js";
+import type { PluginActions } from "../../../plugin/types/Plugin.js";
+import type { ContactApproveCommandPayload, ContactChatCommandPayload, ContactCheckCommandPayload, ContactLinkCommandPayload, ContactShareCommandPayload } from "../../../plugin/builtins/contact/types/ContactCommand.js";
+import type { ContactApproveLinkRequest, ContactApproveLinkResponse } from "../../../plugin/builtins/contact/types/ContactLink.js";
+import type { ContactConfirmRequest, ContactConfirmResponse } from "../../../plugin/builtins/contact/types/ContactApproval.js";
+import type { ContactPingResponse } from "../../../plugin/builtins/contact/types/ContactCheck.js";
+/**
+ * ContactPlugin 注入给 action 注册表的业务动作。
+ */
+export type ContactActionHandlers = {
+    /**
+     * 生成一次性联系码。
+     */
+    link: (context: AgentContext, payload: ContactLinkCommandPayload) => Promise<JsonValue>;
+    /**
+     * 使用联系码建立 contact。
+     */
+    approve: (context: AgentContext, payload: ContactApproveCommandPayload) => Promise<JsonValue>;
+    /**
+     * 检查 contact 或 endpoint 可用性。
+     */
+    check: (context: AgentContext, payload: ContactCheckCommandPayload) => Promise<JsonValue>;
+    /**
+     * 与 contact 对话或读取对话历史。
+     */
+    chat: (context: AgentContext, payload: ContactChatCommandPayload) => Promise<JsonValue>;
+    /**
+     * 向 contact 分享内容。
+     */
+    share: (context: AgentContext, payload: ContactShareCommandPayload) => Promise<JsonValue>;
+    /**
+     * 处理远端 ping 请求。
+     */
+    remotePing: (context: AgentContext, payload: {
+        token?: string;
+    }) => Promise<ContactPingResponse>;
+    /**
+     * 处理远端 approve 请求。
+     */
+    remoteApprove: (context: AgentContext, request: ContactApproveLinkRequest) => Promise<ContactApproveLinkResponse>;
+    /**
+     * 处理远端 confirm 请求。
+     */
+    remoteConfirm: (context: AgentContext, request: ContactConfirmRequest) => Promise<ContactConfirmResponse>;
+    /**
+     * 处理远端 share 请求。
+     */
+    remoteShare: (context: AgentContext, rawPayload: JsonValue) => Promise<JsonValue>;
+};
+/**
+ * 创建 contact plugin action 表。
+ */
+export declare function createContactActions(handlers: ContactActionHandlers): PluginActions;
+//# sourceMappingURL=Action.d.ts.map

package/bin/plugin/builtins/contact/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/contact/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EAEzB,0BAA0B,EAC3B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAU3F;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxF;;OAEG;IACH,OAAO,EAAE,CACP,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,4BAA4B,KAClC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1F;;OAEG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxF;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1F;;OAEG;IACH,UAAU,EAAE,CACV,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACxB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC;;OAEG;IACH,aAAa,EAAE,CACb,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC;;OAEG;IACH,aAAa,EAAE,CACb,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACnF,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,aAAa,CA6NnF"}