@downcity/agent 1.1.1

package/bin/shared/types/ChatPlugin.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Chat service plugin 交互类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述 chat service 与 plugin 之间的扩展 payload。
+ * - service 负责定义结构，plugin 只消费这些稳定字段。
+ * - 字段全部保持 Json 兼容，避免把函数或运行时私有对象塞进 plugin 点。
+ */
+import type { ChatDispatchChannel } from "../../services/chat/types/ChatDispatcher.js";
+/**
+ * chat 入站附件类型。
+ */
+export type ChatPluginAttachmentKind = "document" | "photo" | "voice" | "audio" | "video" | "unknown";
+/**
+ * chat plugin 可见的入站附件描述。
+ */
+export interface ChatPluginAttachment {
+    /**
+     * 当前消息来源渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 归一化后的附件类型。
+     */
+    kind: ChatPluginAttachmentKind;
+    /**
+     * 附件本地绝对路径。
+     *
+     * 说明（中文）
+     * - 若 service 尚未把附件落地，则该字段可为空。
+     * - 依赖本地文件的 plugin 应在缺失时跳过处理。
+     */
+    path?: string;
+    /**
+     * 附件展示描述。
+     */
+    desc?: string;
+    /**
+     * 附件文件名。
+     */
+    fileName?: string;
+    /**
+     * MIME 类型。
+     */
+    contentType?: string;
+    /**
+     * 平台附件 ID。
+     */
+    attachmentId?: string;
+}
+/**
+ * chat 入站增强输入。
+ */
+export interface ChatInboundAugmentInput {
+    /**
+     * 当前消息来源渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 当前会话 ID。
+     */
+    chatId: string;
+    /**
+     * 当前消息所属会话类型。
+     */
+    chatType?: string;
+    /**
+     * 当前 lane / context 对应键。
+     */
+    chatKey?: string;
+    /**
+     * 当前消息 ID。
+     */
+    messageId?: string;
+    /**
+     * 当前工程根目录。
+     */
+    rootPath: string;
+    /**
+     * service 已生成的附件文本块。
+     *
+     * 说明（中文）
+     * - 一般是 `<file ...>` 标签拼接后的结果。
+     */
+    attachmentText?: string;
+    /**
+     * service 已抽取的正文文本。
+     */
+    bodyText?: string;
+    /**
+     * plugin 追加的中间文本块。
+     *
+     * 说明（中文）
+     * - pipeline 默认在这里继续追加内容，例如语音转写。
+     */
+    pluginSections?: string[];
+    /**
+     * 归一化后的附件列表。
+     */
+    attachments: ChatPluginAttachment[];
+}
+/**
+ * chat 回复前文本管道输入。
+ */
+export interface ChatReplyDispatchInput {
+    /**
+     * 当前消息来源渠道。
+     */
+    channel?: ChatDispatchChannel;
+    /**
+     * 当前会话 key。
+     */
+    chatKey: string;
+    /**
+     * 目标会话 ID。
+     */
+    chatId?: string;
+    /**
+     * 目标消息 ID。
+     */
+    messageId?: string;
+    /**
+     * 当前回复文本。
+     */
+    text: string;
+    /**
+     * 当前回复阶段。
+     */
+    phase: "step" | "final" | "error";
+    /**
+     * 当前分发模式。
+     */
+    mode: "direct" | "fallback";
+}
+/**
+ * chat 回复后事件输入。
+ */
+export interface ChatReplyEffectInput {
+    /**
+     * 当前消息来源渠道。
+     */
+    channel?: ChatDispatchChannel;
+    /**
+     * 当前会话 key。
+     */
+    chatKey: string;
+    /**
+     * 目标会话 ID。
+     */
+    chatId?: string;
+    /**
+     * 目标消息 ID。
+     */
+    messageId?: string;
+    /**
+     * 最终尝试发送的文本。
+     */
+    text: string;
+    /**
+     * 当前回复阶段。
+     */
+    phase: "step" | "final" | "error";
+    /**
+     * 当前分发模式。
+     */
+    mode: "direct" | "fallback";
+    /**
+     * 本次发送是否成功。
+     */
+    success: boolean;
+    /**
+     * 错误信息。
+     */
+    error?: string;
+}
+/**
+ * chat 入队前管道输入。
+ */
+export interface ChatEnqueuePipelineInput {
+    /**
+     * 入队类型。
+     */
+    kind: "exec" | "audit";
+    /**
+     * 当前消息来源渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 当前 lane / context 键。
+     */
+    chatKey: string;
+    /**
+     * 目标会话 ID。
+     */
+    chatId: string;
+    /**
+     * 当前消息文本。
+     */
+    text: string;
+    /**
+     * 会话类型。
+     */
+    chatType?: string;
+    /**
+     * 线程 ID。
+     */
+    threadId?: number;
+    /**
+     * 消息 ID。
+     */
+    messageId?: string;
+    /**
+     * 发送者 ID。
+     */
+    actorId?: string;
+    /**
+     * 发送者名称。
+     */
+    actorName?: string;
+    /**
+     * 附加元信息。
+     */
+    extra?: Record<string, unknown>;
+}
+/**
+ * chat 入队后事件输入。
+ */
+export interface ChatEnqueueEffectInput extends ChatEnqueuePipelineInput {
+    /**
+     * 队列项 ID。
+     */
+    itemId: string;
+    /**
+     * 当前 lane 排队位置。
+     */
+    lanePosition: number;
+}
+//# sourceMappingURL=ChatPlugin.d.ts.map

package/bin/shared/types/ChatPlugin.d.ts.map

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

package/bin/shared/types/ChatPlugin.js

@@ -0,0 +1,10 @@
+/**
+ * Chat service plugin 交互类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述 chat service 与 plugin 之间的扩展 payload。
+ * - service 负责定义结构，plugin 只消费这些稳定字段。
+ * - 字段全部保持 Json 兼容，避免把函数或运行时私有对象塞进 plugin 点。
+ */
+export {};
+//# sourceMappingURL=ChatPlugin.js.map

package/bin/shared/types/ChatPlugin.js.map

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

package/bin/shared/types/ChatPromptContext.d.ts

@@ -0,0 +1,125 @@
+/**
+ * ChatPromptContext：chat prompt 注入相关类型。
+ *
+ * 关键点（中文）
+ * - 统一描述“当前 chat 环境”与“入站用户信息”两类 prompt 数据。
+ * - chat 路由环境与用户身份信息分离，避免把平台路由字段混入 user info。
+ * - 所有字段均保持可序列化，便于 system prompt 与入站消息文本复用。
+ */
+import type { ChatAuthorizationPermission } from "../../shared/types/AuthPlugin.js";
+import type { ChatDispatchChannel } from "../../services/chat/types/ChatDispatcher.js";
+/**
+ * 当前 chat 环境提示输入。
+ */
+export interface ChatEnvironmentPromptInput {
+    /**
+     * 当前会话对应的 sessionId。
+     *
+     * 说明（中文）
+     * - 对外统一使用 `sessionId` 语义。
+     * - chat service 内部统一按 session 语义路由与持久化。
+     */
+    sessionId: string;
+    /**
+     * 当前 chatKey。
+     *
+     * 说明（中文）
+     * - chat service 里通常与 `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/shared/types/ChatPromptContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatPromptContext.d.ts","sourceRoot":"","sources":["../../../src/shared/types/ChatPromptContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF;;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/shared/types/ChatPromptContext.js

@@ -0,0 +1,10 @@
+/**
+ * ChatPromptContext：chat prompt 注入相关类型。
+ *
+ * 关键点（中文）
+ * - 统一描述“当前 chat 环境”与“入站用户信息”两类 prompt 数据。
+ * - chat 路由环境与用户身份信息分离，避免把平台路由字段混入 user info。
+ * - 所有字段均保持可序列化，便于 system prompt 与入站消息文本复用。
+ */
+export {};
+//# sourceMappingURL=ChatPromptContext.js.map

package/bin/shared/types/ChatPromptContext.js.map

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

package/bin/shared/types/ChatQueueWorker.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ChatQueueWorker 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 chat queue worker 相关的共享配置类型。
+ * - 运行态实现细节仍在 service/runtime 中，跨模块共享的契约提升到 `src/types/`。
+ */
+/**
+ * ChatQueueWorker 的运行配置。
+ */
+export type ChatQueueWorkerConfig = {
+    /**
+     * 最大并发 lane 数。
+     */
+    maxConcurrency: number;
+    /**
+     * burst merge 防抖窗口（毫秒）。
+     */
+    mergeDebounceMs: number;
+    /**
+     * burst merge 最长等待时间（毫秒）。
+     */
+    mergeMaxWaitMs: number;
+};
+//# sourceMappingURL=ChatQueueWorker.d.ts.map

package/bin/shared/types/ChatQueueWorker.d.ts.map

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

@@ -0,0 +1,9 @@
+/**
+ * ChatQueueWorker 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 chat queue worker 相关的共享配置类型。
+ * - 运行态实现细节仍在 service/runtime 中，跨模块共享的契约提升到 `src/types/`。
+ */
+export {};
+//# sourceMappingURL=ChatQueueWorker.js.map

package/bin/shared/types/ChatQueueWorker.js.map

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

package/bin/shared/types/ChatRuntime.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ChatRuntime 类型定义。
+ *
+ * 关键点（中文）
+ * - 这些类型描述 chat service 的实例级运行态。
+ * - channel bots 的状态所有权归属于 ChatService 实例，而不是模块级单例。
+ */
+import type { FeishuBot } from "../../services/chat/channels/feishu/Feishu.js";
+import type { QQBot } from "../../services/chat/channels/qq/QQ.js";
+import type { TelegramBot } from "../../services/chat/channels/telegram/Bot.js";
+/**
+ * ChatService 实例持有的渠道状态。
+ *
+ * 关键点（中文）
+ * - 这里显式把 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/shared/types/ChatRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatRuntime.d.ts","sourceRoot":"","sources":["../../../src/shared/types/ChatRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E;;;;;;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/shared/types/ChatRuntime.js

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

package/bin/shared/types/ChatRuntime.js.map

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

package/bin/shared/types/ChatService.d.ts

@@ -0,0 +1,145 @@
+/**
+ * ChatService 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 chat service action 的输入 payload。
+ * - 这些类型属于跨模块共享契约，因此统一放到 `types/` 下。
+ * - 字段命名保持与 CLI/API 参数一致，降低映射心智负担。
+ */
+import type { JsonValue } from "../../shared/types/Json.js";
+import type { ChatDeleteRequest, ChatHistoryRequest, ChatInfoRequest, ChatListRequest, ChatReactRequest } from "../../services/chat/types/ChatCommand.js";
+import type { ChatChannelName } from "../../services/chat/types/ChannelStatus.js";
+/**
+ * `chat.send` action 的输入载荷。
+ */
+export type ChatSendActionPayload = {
+    /**
+     * 要发送的正文文本。
+     */
+    text: string;
+    /**
+     * 目标 chatKey；未显式传入时可由执行上下文补全。
+     */
+    chatKey?: string;
+    /**
+     * 延迟发送毫秒数；与 `sendAtMs` 互斥。
+     */
+    delayMs?: number;
+    /**
+     * 绝对发送时间戳（毫秒）；与 `delayMs` 互斥。
+     */
+    sendAtMs?: number;
+    /**
+     * 是否使用 reply_to_message 语义回复目标消息。
+     */
+    replyToMessage?: boolean;
+    /**
+     * 显式指定目标消息 ID；通常用于 reply/react 等场景。
+     */
+    messageId?: string;
+};
+/**
+ * 读取会话上下文类 action 的输入载荷。
+ */
+export type ChatSessionActionPayload = {
+    /**
+     * 目标 chatKey；与 sessionId 二选一即可。
+     */
+    chatKey?: string;
+    /**
+     * 目标 sessionId；优先级高于 chatKey。
+     */
+    sessionId?: string;
+};
+/**
+ * `chat.history` action 的输入载荷。
+ */
+export type ChatHistoryActionPayload = ChatHistoryRequest;
+/**
+ * `chat.react` action 的输入载荷。
+ */
+export type ChatReactActionPayload = ChatReactRequest;
+/**
+ * `chat.delete` action 的输入载荷。
+ */
+export type ChatDeleteActionPayload = ChatDeleteRequest;
+/**
+ * `chat.list` action 的输入载荷。
+ */
+export type ChatListActionPayload = ChatListRequest;
+/**
+ * `chat.info` action 的输入载荷。
+ */
+export type ChatInfoActionPayload = ChatInfoRequest;
+/**
+ * `chat.status` action 的输入载荷。
+ */
+export type ChatStatusActionPayload = {
+    /**
+     * 指定目标渠道；省略时表示全部渠道。
+     */
+    channel?: ChatChannelName;
+};
+/**
+ * `chat.test` action 的输入载荷。
+ */
+export type ChatTestActionPayload = {
+    /**
+     * 指定目标渠道；省略时表示全部渠道。
+     */
+    channel?: ChatChannelName;
+};
+/**
+ * `chat.reconnect` action 的输入载荷。
+ */
+export type ChatReconnectActionPayload = {
+    /**
+     * 指定目标渠道；省略时表示全部渠道。
+     */
+    channel?: ChatChannelName;
+};
+/**
+ * `chat.open` action 的输入载荷。
+ */
+export type ChatOpenActionPayload = {
+    /**
+     * 指定目标渠道；省略时表示全部渠道。
+     */
+    channel?: ChatChannelName;
+};
+/**
+ * `chat.close` action 的输入载荷。
+ */
+export type ChatCloseActionPayload = {
+    /**
+     * 指定目标渠道；省略时表示全部渠道。
+     */
+    channel?: ChatChannelName;
+};
+/**
+ * `chat.configuration` action 的输入载荷。
+ */
+export type ChatConfigurationActionPayload = {
+    /**
+     * 指定目标渠道；省略时表示全部渠道。
+     */
+    channel?: ChatChannelName;
+};
+/**
+ * `chat.configure` action 的输入载荷。
+ */
+export type ChatConfigureActionPayload = {
+    /**
+     * 要更新的目标渠道。
+     */
+    channel: ChatChannelName;
+    /**
+     * 渠道配置 patch；值类型遵循 channel configuration 元信息。
+     */
+    config: Record<string, JsonValue>;
+    /**
+     * 配置完成后是否立即重启目标渠道；默认由上层解释为 true。
+     */
+    restart?: boolean;
+};
+//# sourceMappingURL=ChatService.d.ts.map

package/bin/shared/types/ChatService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatService.d.ts","sourceRoot":"","sources":["../../../src/shared/types/ChatService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC"}

package/bin/shared/types/ChatService.js

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

package/bin/shared/types/ChatService.js.map

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