@downcity/plugins 1.0.4

package/bin/chat/types/ChannelAccount.js

@@ -0,0 +1,9 @@
+/**
+ * Chat channel account 管理类型。
+ *
+ * 关键点（中文）
+ * - 这些类型描述 agent 运行时内部的 chat channel account 管理输入输出。
+ * - 凭据明文只允许出现在写入输入中，读取结果必须是脱敏后的安全视图。
+ */
+export {};
+//# sourceMappingURL=ChannelAccount.js.map

package/bin/chat/types/ChannelAccount.js.map

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

package/bin/chat/types/ChannelConfiguration.d.ts

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

package/bin/chat/types/ChannelConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelConfiguration.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChannelConfiguration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,iCAAiC,GACzC,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAC3C,WAAW,GACX,aAAa,GACb,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,IAAI,EAAE,iCAAiC,CAAC;IACxC;;OAEG;IACH,MAAM,EAAE,mCAAmC,CAAC;IAC5C;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,iCAAiC,CAAC;IACjD;;OAEG;IACH,OAAO,CAAC,EAAE,iCAAiC,CAAC;IAC5C;;OAEG;IACH,OAAO,CAAC,EAAE,mCAAmC,EAAE,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,EAAE;QACZ;;WAEG;QACH,gBAAgB,EAAE,OAAO,CAAC;QAC1B;;WAEG;QACH,qBAAqB,EAAE,OAAO,CAAC;QAC/B;;WAEG;QACH,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IACF;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,IAAI,EAAE,6BAA6B,EAAE,CAAC;QACtC;;WAEG;QACH,cAAc,EAAE,6BAA6B,EAAE,CAAC;QAChD;;WAEG;QACH,WAAW,EAAE,6BAA6B,EAAE,CAAC;KAC9C,CAAC;CACH"}

package/bin/chat/types/ChannelConfiguration.js

@@ -0,0 +1,9 @@
+/**
+ * Chat 渠道配置元信息类型。
+ *
+ * 关键点（中文）
+ * - 每个 channel 通过统一结构声明“需要哪些参数、类型、描述、来源”。
+ * - 该结构用于 Console / DB / CLI 直接消费，不依赖硬编码字段。
+ */
+export {};
+//# sourceMappingURL=ChannelConfiguration.js.map

package/bin/chat/types/ChannelConfiguration.js.map

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

package/bin/chat/types/ChannelContext.d.ts

@@ -0,0 +1,107 @@
+/**
+ * ChannelContext 类型定义。
+ *
+ * 关键点（中文）
+ * - 描述渠道目标（platform target）与内部 sessionId 的映射结构。
+ * - 映射由 chat plugin runtime 维护，sessionId 对外保持稳定但不可推导。
+ */
+import type { ChatDispatchChannel } from "./ChatDispatcher.js";
+/**
+ * 渠道目标标识输入。
+ */
+export type ChannelContextTarget = {
+    /**
+     * 渠道类型（telegram/feishu/qq）。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 平台 chat 原始 ID。
+     */
+    chatId: string;
+    /**
+     * 平台 chat 类型（如 group/c2c/channel/p2p）。
+     */
+    targetType?: string;
+    /**
+     * 平台 thread/topic ID（仅部分渠道存在）。
+     */
+    threadId?: number;
+};
+/**
+ * `sessionId -> 渠道目标` 路由条目。
+ */
+export type ChannelContextRouteV1 = {
+    /**
+     * schema 版本。
+     */
+    v: 1;
+    /**
+     * 内部 sessionId（随机生成，不可推导）。
+     */
+    sessionId: string;
+    /**
+     * 渠道类型（telegram/feishu/qq）。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 平台 chat 原始 ID。
+     */
+    chatId: string;
+    /**
+     * 平台 chat 类型（group/c2c/channel/p2p...）。
+     */
+    targetType?: string;
+    /**
+     * 平台 thread/topic ID。
+     */
+    threadId?: number;
+    /**
+     * 最近入站/出站相关 messageId（用于回复语义补全）。
+     */
+    messageId?: string;
+    /**
+     * 最近触发该会话的用户 ID。
+     */
+    actorId?: string;
+    /**
+     * 最近触发该会话的用户名/昵称。
+     */
+    actorName?: string;
+    /**
+     * 会话展示名（群名/频道名/私聊对象名）。
+     *
+     * 说明（中文）
+     * - 由各渠道在入站时 best-effort 提供。
+     * - 用于 Console 展示，不参与路由键计算。
+     */
+    chatTitle?: string;
+    /**
+     * 路由条目更新时间（毫秒时间戳）。
+     */
+    updatedAt: number;
+};
+/**
+ * Channel 映射文件结构。
+ */
+export type ChannelContextMetaFileV1 = {
+    /**
+     * schema 版本。
+     */
+    v: 1;
+    /**
+     * 文件更新时间（毫秒时间戳）。
+     */
+    updatedAt: number;
+    /**
+     * 目标键 -> sessionId 映射索引。
+     *
+     * 说明（中文）
+     * - 目标键由 `channel/chatId/targetType/threadId` 归一化后拼接。
+     */
+    sessionIdByTargetKey: Record<string, string>;
+    /**
+     * sessionId -> 路由信息映射索引。
+     */
+    routesBySessionId: Record<string, ChannelContextRouteV1>;
+};
+//# sourceMappingURL=ChannelContext.d.ts.map

package/bin/chat/types/ChannelContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelContext.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChannelContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,CAAC,EAAE,CAAC,CAAC;IACL;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,CAAC,EAAE,CAAC,CAAC;IACL;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC1D,CAAC"}

package/bin/chat/types/ChannelContext.js

@@ -0,0 +1,9 @@
+/**
+ * ChannelContext 类型定义。
+ *
+ * 关键点（中文）
+ * - 描述渠道目标（platform target）与内部 sessionId 的映射结构。
+ * - 映射由 chat plugin runtime 维护，sessionId 对外保持稳定但不可推导。
+ */
+export {};
+//# sourceMappingURL=ChannelContext.js.map

package/bin/chat/types/ChannelContext.js.map

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

package/bin/chat/types/ChannelStatus.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Chat 渠道运行状态与连通性测试类型。
+ *
+ * 关键点（中文）
+ * - 统一 `status/test/reconnect` 的返回结构，供 CLI 与 Console 复用。
+ * - 字段保持稳定，避免前端按渠道分支解析。
+ */
+/**
+ * 支持的 chat 渠道名称。
+ */
+export type ChatChannelName = "telegram" | "feishu" | "qq";
+/**
+ * 渠道链路状态枚举。
+ */
+export type ChatLinkState = "connected" | "disconnected" | "unknown";
+/**
+ * 渠道诊断字段值类型。
+ *
+ * 关键点（中文）
+ * - 允许嵌套对象与数组，便于挂载 `detail.configuration.fields` 这类结构化元信息。
+ * - 仅允许 JSON 可序列化基础类型，避免传递运行时函数等不可持久化值。
+ */
+export type ChatChannelDetailValue = string | number | boolean | null | ChatChannelDetailValue[] | {
+    [key: string]: ChatChannelDetailValue;
+};
+/**
+ * 单个渠道的状态快照。
+ */
+export type ChatChannelStateSnapshot = {
+    /**
+     * 渠道名称（telegram/feishu/qq）。
+     */
+    channel: ChatChannelName;
+    /**
+     * 是否在配置中启用（`downcity.json` 的 `plugins.chat.channels.<channel>.enabled`）。
+     */
+    enabled: boolean;
+    /**
+     * 必要鉴权配置是否完整（例如 token/appId/appSecret）。
+     */
+    configured: boolean;
+    /**
+     * 当前进程内该渠道实例是否处于活动状态。
+     */
+    running: boolean;
+    /**
+     * 当前链路状态（已连接/未连接/未知）。
+     */
+    linkState: ChatLinkState;
+    /**
+     * 状态描述文本（用于面板展示与排障提示）。
+     */
+    statusText: string;
+    /**
+     * 渠道附加诊断信息（仅用于可视化，不承诺结构稳定）。
+     */
+    detail?: Record<string, ChatChannelDetailValue>;
+};
+/**
+ * 单个渠道连通性测试结果。
+ */
+export type ChatChannelTestResult = {
+    /**
+     * 渠道名称。
+     */
+    channel: ChatChannelName;
+    /**
+     * 测试是否通过。
+     */
+    success: boolean;
+    /**
+     * 测试执行时间（Unix 毫秒时间戳）。
+     */
+    testedAtMs: number;
+    /**
+     * 测试耗时（毫秒）。
+     */
+    latencyMs?: number;
+    /**
+     * 测试结果说明。
+     */
+    message: string;
+    /**
+     * 附加诊断信息（例如 bot 用户名、ws readyState）。
+     */
+    detail?: Record<string, ChatChannelDetailValue>;
+};
+//# sourceMappingURL=ChannelStatus.d.ts.map

package/bin/chat/types/ChannelStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelStatus.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChannelStatus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,sBAAsB,EAAE,GACxB;IACE,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAAC;CACvC,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACjD,CAAC"}

package/bin/chat/types/ChannelStatus.js

@@ -0,0 +1,9 @@
+/**
+ * Chat 渠道运行状态与连通性测试类型。
+ *
+ * 关键点（中文）
+ * - 统一 `status/test/reconnect` 的返回结构，供 CLI 与 Console 复用。
+ * - 字段保持稳定，避免前端按渠道分支解析。
+ */
+export {};
+//# sourceMappingURL=ChannelStatus.js.map

package/bin/chat/types/ChannelStatus.js.map

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

package/bin/chat/types/ChatCommand.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Chat 命令协议类型。
+ *
+ * 关键点（中文）
+ * - chat 模块自有请求/响应类型放在 chat/types
+ * - 避免所有业务类型集中堆到全局 types/
+ */
+export type ChatSessionSnapshot = {
+    sessionId?: string;
+    chatKey?: string;
+    channel?: string;
+    chatId?: string;
+    messageThreadId?: number;
+    chatType?: string;
+    userId?: string;
+    messageId?: string;
+};
+export type ChatSendRequest = {
+    text: string;
+    chatKey?: string;
+    delayMs?: number;
+    sendAtMs?: number;
+    replyToMessage?: boolean;
+    messageId?: string;
+};
+export type ChatSendResponse = {
+    success: boolean;
+    chatKey?: string;
+    error?: string;
+};
+export type ChatReactRequest = {
+    chatKey?: string;
+    messageId?: string;
+    emoji?: string;
+    big?: boolean;
+};
+export type ChatReactResponse = {
+    success: boolean;
+    chatKey?: string;
+    messageId?: string;
+    error?: string;
+};
+export type ChatDeleteRequest = {
+    chatKey?: string;
+    sessionId?: string;
+};
+export type ChatDeleteResponse = {
+    success: boolean;
+    sessionId?: string;
+    deleted?: boolean;
+    removedMeta?: boolean;
+    removedChatDir?: boolean;
+    removedSessionDir?: boolean;
+    error?: string;
+};
+export type ChatHistoryDirection = "all" | "inbound" | "outbound";
+export type ChatHistoryRequest = {
+    chatKey?: string;
+    sessionId?: string;
+    limit?: number;
+    direction?: ChatHistoryDirection;
+    beforeTs?: number;
+    afterTs?: number;
+};
+/**
+ * Chat 会话列表请求。
+ *
+ * 关键点（中文）
+ * - 仅列出当前 agent 本地已记录的 chat context（来自 `.downcity/channel/meta.json`）。
+ * - 不会向外部平台拉取“全部会话”，因为平台侧通常需要额外权限且成本高。
+ */
+export type ChatListRequest = {
+    /**
+     * 渠道过滤（telegram/feishu/qq）。
+     *
+     * 说明（中文）
+     * - 不传则返回全部渠道。
+     */
+    channel?: string;
+    /**
+     * 返回条数上限。
+     *
+     * 说明（中文）
+     * - 不传则使用默认值（由服务端决定）。
+     */
+    limit?: number;
+    /**
+     * 关键词查询。
+     *
+     * 说明（中文）
+     * - 会在 `sessionId/chatId/chatTitle/actorName/actorId` 中做包含匹配（不区分大小写）。
+     */
+    q?: string;
+};
+/**
+ * Chat 会话列表条目（用于展示）。
+ */
+export type ChatListItemV1 = {
+    /**
+     * 可发送的 chatKey。
+     *
+     * 关键点（中文）
+     * - 当前实现下 `chatKey === sessionId`。
+     */
+    chatKey: string;
+    /**
+     * 对外稳定的 sessionId。
+     *
+     * 说明（中文）
+     * - 当前内部以 session 语义统一建模。
+     */
+    sessionId: string;
+    /**
+     * 渠道类型（telegram/feishu/qq）。
+     */
+    channel: string;
+    /**
+     * 平台 chat 原始 ID。
+     */
+    chatId: string;
+    /**
+     * 平台 chat 类型（group/c2c/channel/p2p...）。
+     */
+    targetType?: string;
+    /**
+     * 平台 thread/topic ID（仅部分渠道存在）。
+     */
+    threadId?: number;
+    /**
+     * 会话展示名（群名/频道名/私聊对象名）。
+     */
+    chatTitle?: string;
+    /**
+     * 最近触发该会话的用户名/昵称（best-effort）。
+     */
+    actorName?: string;
+    /**
+     * 最近触发该会话的用户 ID（best-effort）。
+     */
+    actorId?: string;
+    /**
+     * 最近更新的毫秒时间戳。
+     */
+    updatedAt: number;
+    /**
+     * `updatedAt` 的 ISO 时间字符串（UTC）。
+     */
+    isoUpdatedAt: string;
+};
+/**
+ * Chat 会话信息请求（查看单个会话的元信息与本地路径）。
+ */
+export type ChatInfoRequest = {
+    /**
+     * 目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY / 当前请求上下文）。
+     */
+    chatKey?: string;
+    /**
+     * 显式 sessionId（优先级高于 chatKey）。
+     */
+    sessionId?: string;
+};
+//# sourceMappingURL=ChatCommand.d.ts.map

package/bin/chat/types/ChatCommand.d.ts.map

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

package/bin/chat/types/ChatCommand.js

@@ -0,0 +1,9 @@
+/**
+ * Chat 命令协议类型。
+ *
+ * 关键点（中文）
+ * - chat 模块自有请求/响应类型放在 chat/types
+ * - 避免所有业务类型集中堆到全局 types/
+ */
+export {};
+//# sourceMappingURL=ChatCommand.js.map

package/bin/chat/types/ChatCommand.js.map

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

package/bin/chat/types/ChatDispatcher.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Chat egress dispatcher types（对外回包能力的类型定义）。
+ *
+ * 关键点（中文）
+ * - dispatcher 只关心“怎么把消息/动作发回平台”
+ * - sendText 是必需能力；sendAction（如 typing）是可选能力
+ */
+export type ChatDispatchChannel = "telegram" | "feishu" | "qq";
+export type ChatDispatchAction = "typing" | "react";
+export type ChatDispatchSendTextParams = {
+    chatId: string;
+    text: string;
+    messageThreadId?: number;
+    chatType?: string;
+    messageId?: string;
+    replyToMessage?: boolean;
+};
+export type ChatDispatchSendActionParams = {
+    chatId: string;
+    action: ChatDispatchAction;
+    messageThreadId?: number;
+    chatType?: string;
+    messageId?: string;
+    reactionEmoji?: string;
+    reactionIsBig?: boolean;
+};
+export interface ChatDispatcher {
+    sendText(params: ChatDispatchSendTextParams): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    sendAction?(params: ChatDispatchSendActionParams): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=ChatDispatcher.d.ts.map

package/bin/chat/types/ChatDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatDispatcher.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChatDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE/D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC;QACpD,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IAEH,UAAU,CAAC,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC;QACzD,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ"}

package/bin/chat/types/ChatDispatcher.js

@@ -0,0 +1,9 @@
+/**
+ * Chat egress dispatcher types（对外回包能力的类型定义）。
+ *
+ * 关键点（中文）
+ * - dispatcher 只关心“怎么把消息/动作发回平台”
+ * - sendText 是必需能力；sendAction（如 typing）是可选能力
+ */
+export {};
+//# sourceMappingURL=ChatDispatcher.js.map

package/bin/chat/types/ChatDispatcher.js.map

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