@downcity/plugins 1.0.4

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

@@ -0,0 +1,36 @@
+/**
+ * ChatHistory 类型定义。
+ *
+ * 关键点（中文）
+ * - chat history 是聊天平台事件流（审计向），与 session message history 分离。
+ * - 支持入站（inbound）与出站（outbound）事件，便于完整回放对话链路。
+ */
+import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+export type ChatHistoryIngressKind = "audit" | "exec";
+export type ChatHistoryDirection = "inbound" | "outbound";
+type ChatHistoryBaseEventV1 = {
+    v: 1;
+    id: string;
+    ts: number;
+    sessionId: string;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    text: string;
+    targetType?: string;
+    threadId?: number;
+    messageId?: string;
+    actorId?: string;
+    actorName?: string;
+    extra?: JsonObject;
+};
+export type ChatHistoryInboundEventV1 = ChatHistoryBaseEventV1 & {
+    direction: "inbound";
+    ingressKind: ChatHistoryIngressKind;
+};
+export type ChatHistoryOutboundEventV1 = ChatHistoryBaseEventV1 & {
+    direction: "outbound";
+};
+export type ChatHistoryEventV1 = ChatHistoryInboundEventV1 | ChatHistoryOutboundEventV1;
+export {};
+//# sourceMappingURL=ChatHistory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistory.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChatHistory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,CAAC;AAE1D,KAAK,sBAAsB,GAAG;IAC5B,CAAC,EAAE,CAAC,CAAC;IACL,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,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;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAAG;IAC/D,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,sBAAsB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,GAAG;IAChE,SAAS,EAAE,UAAU,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,yBAAyB,GACzB,0BAA0B,CAAC"}

package/bin/chat/types/ChatHistory.js

@@ -0,0 +1,9 @@
+/**
+ * ChatHistory 类型定义。
+ *
+ * 关键点（中文）
+ * - chat history 是聊天平台事件流（审计向），与 session message history 分离。
+ * - 支持入站（inbound）与出站（outbound）事件，便于完整回放对话链路。
+ */
+export {};
+//# sourceMappingURL=ChatHistory.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * ChatMeta：chat plugin runtime 维护的 session 路由元信息。
+ *
+ * 关键点（中文）
+ * - 只描述“如何把 sessionId 路由回平台 chat”
+ * - 由 chat plugin runtime 在接收入站消息时更新
+ * - 不属于 core context message schema
+ */
+import type { ChatDispatchChannel } from "./ChatDispatcher.js";
+export type ChatMetaV1 = {
+    /** schema 版本 */
+    v: 1;
+    /** 更新时间戳（ms） */
+    updatedAt: number;
+    /** 会话 ID */
+    sessionId: string;
+    /** 平台通道 */
+    channel: ChatDispatchChannel;
+    /** 平台 chatId */
+    chatId: string;
+    /** 平台 chatType（group/private/topic/c2c/channel...） */
+    targetType?: string;
+    /** 平台 thread/topic ID */
+    threadId?: number;
+    /** 平台最近消息 ID（QQ/部分平台回包依赖） */
+    messageId?: string;
+    /** 最近发言用户 ID */
+    actorId?: string;
+    /** 最近发言用户昵称 */
+    actorName?: string;
+    /** 会话展示名（群名/频道名/私聊对象名） */
+    chatTitle?: string;
+};
+//# sourceMappingURL=ChatMeta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMeta.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChatMeta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG;IACvB,gBAAgB;IAChB,CAAC,EAAE,CAAC,CAAC;IACL,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/bin/chat/types/ChatMeta.js

@@ -0,0 +1,10 @@
+/**
+ * ChatMeta：chat plugin runtime 维护的 session 路由元信息。
+ *
+ * 关键点（中文）
+ * - 只描述“如何把 sessionId 路由回平台 chat”
+ * - 由 chat plugin runtime 在接收入站消息时更新
+ * - 不属于 core context message schema
+ */
+export {};
+//# sourceMappingURL=ChatMeta.js.map

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

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

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

@@ -0,0 +1,238 @@
+/**
+ * Chat plugin 交互类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述 chat plugin runtime 与 plugin 之间的扩展 payload。
+ * - chat plugin runtime 负责定义结构，plugin 只消费这些稳定字段。
+ * - 字段全部保持 Json 兼容，避免把函数或运行时私有对象塞进 plugin 点。
+ */
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+/**
+ * chat 入站附件类型。
+ */
+export type ChatPluginAttachmentKind = "document" | "photo" | "voice" | "audio" | "video" | "unknown";
+/**
+ * chat plugin 可见的入站附件描述。
+ */
+export interface ChatPluginAttachment {
+    /**
+     * 当前消息来源渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 归一化后的附件类型。
+     */
+    kind: ChatPluginAttachmentKind;
+    /**
+     * 附件本地绝对路径。
+     *
+     * 说明（中文）
+     * - 若 chat plugin runtime 尚未把附件落地，则该字段可为空。
+     * - 依赖本地文件的 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;
+    /**
+     * chat plugin runtime 已生成的附件文本块。
+     *
+     * 说明（中文）
+     * - 一般是 `<file ...>` 标签拼接后的结果。
+     */
+    attachmentText?: string;
+    /**
+     * chat plugin runtime 已抽取的正文文本。
+     */
+    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/chat/types/ChatPlugin.d.ts.map

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

package/bin/chat/types/ChatPlugin.js

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

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

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

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

@@ -0,0 +1,145 @@
+/**
+ * ChatPlugin action 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 chat plugin runtime action 的输入 payload。
+ * - 这些类型属于跨模块共享契约，因此统一放到 `types/` 下。
+ * - 字段命名保持与 CLI/API 参数一致，降低映射心智负担。
+ */
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import type { ChatDeleteRequest, ChatHistoryRequest, ChatInfoRequest, ChatListRequest, ChatReactRequest } from "../../chat/types/ChatCommand.js";
+import type { ChatChannelName } from "../../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=ChatPluginActionPayload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatPluginActionPayload.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChatPluginActionPayload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;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/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/chat/types/ChatPluginActionPayload.js.map

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

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

@@ -0,0 +1,125 @@
+/**
+ * ChatPromptContext：chat prompt 注入相关类型。
+ *
+ * 关键点（中文）
+ * - 统一描述“当前 chat 环境”与“入站用户信息”两类 prompt 数据。
+ * - chat 路由环境与用户身份信息分离，避免把平台路由字段混入 user info。
+ * - 所有字段均保持可序列化，便于 system prompt 与入站消息文本复用。
+ */
+import type { ChatAuthorizationPermission } from "../../auth/types/AuthPlugin.js";
+import type { ChatDispatchChannel } from "../../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/chat/types/ChatPromptContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatPromptContext.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ChatPromptContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;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/chat/types/ChatPromptContext.js

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

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

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