@downcity/plugins 1.0.4

package/bin/chat/runtime/ReplyContextFormatter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ReplyContextFormatter：reply 引用上下文格式化工具。
+ *
+ * 关键点（中文）
+ * - 把平台 reply 信息稳定地拼进模型输入正文。
+ * - 同时提供额外 metadata，便于 history / 调试链路查看。
+ */
+import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
+import type { InboundReplyContext } from "../../chat/types/ReplyContext.js";
+/**
+ * 将 reply 上下文转换为执行输入正文。
+ *
+ * 说明（中文）
+ * - 当前消息正文为空时，也会保留 reply block，避免“只看见 reply、看不见被引用内容”。
+ * - quote 与完整正文相同则自动去重，避免重复噪声。
+ */
+export declare function buildReplyContextInstruction(params: {
+    text: string;
+    replyContext?: InboundReplyContext;
+}): string;
+/**
+ * 将 reply 上下文转换为 ingress extra。
+ *
+ * 说明（中文）
+ * - 仅保留稳定、短小的字段。
+ * - 方便在 Console / history 中直接看到引用信息。
+ */
+export declare function buildReplyContextExtra(replyContext?: InboundReplyContext): JsonObject | undefined;
+//# sourceMappingURL=ReplyContextFormatter.d.ts.map

package/bin/chat/runtime/ReplyContextFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyContextFormatter.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ReplyContextFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAOxE;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC,GAAG,MAAM,CA+BT;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,CAAC,EAAE,mBAAmB,GACjC,UAAU,GAAG,SAAS,CAgBxB"}

package/bin/chat/runtime/ReplyContextFormatter.js

@@ -0,0 +1,74 @@
+/**
+ * ReplyContextFormatter：reply 引用上下文格式化工具。
+ *
+ * 关键点（中文）
+ * - 把平台 reply 信息稳定地拼进模型输入正文。
+ * - 同时提供额外 metadata，便于 history / 调试链路查看。
+ */
+function normalizeReplyValue(value) {
+    const text = String(value || "").trim();
+    return text ? text : undefined;
+}
+/**
+ * 将 reply 上下文转换为执行输入正文。
+ *
+ * 说明（中文）
+ * - 当前消息正文为空时，也会保留 reply block，避免“只看见 reply、看不见被引用内容”。
+ * - quote 与完整正文相同则自动去重，避免重复噪声。
+ */
+export function buildReplyContextInstruction(params) {
+    const body = String(params.text ?? "").trim();
+    const replyContext = params.replyContext;
+    if (!replyContext)
+        return body;
+    const messageId = normalizeReplyValue(replyContext.messageId);
+    const actorName = normalizeReplyValue(replyContext.actorName);
+    const quoteText = normalizeReplyValue(replyContext.quoteText);
+    const replyText = normalizeReplyValue(replyContext.text);
+    const normalizedQuote = quoteText && quoteText !== replyText ? quoteText : undefined;
+    if (!messageId && !actorName && !normalizedQuote && !replyText) {
+        return body;
+    }
+    const lines = ["<reply_context>"];
+    if (messageId)
+        lines.push(`reply_message_id: ${messageId}`);
+    if (actorName)
+        lines.push(`reply_actor_name: ${actorName}`);
+    if (normalizedQuote) {
+        lines.push("reply_quote:");
+        lines.push(normalizedQuote);
+    }
+    if (replyText) {
+        lines.push("reply_message:");
+        lines.push(replyText);
+    }
+    lines.push("</reply_context>");
+    if (!body)
+        return lines.join("\n");
+    return `${lines.join("\n")}\n\n${body}`;
+}
+/**
+ * 将 reply 上下文转换为 ingress extra。
+ *
+ * 说明（中文）
+ * - 仅保留稳定、短小的字段。
+ * - 方便在 Console / history 中直接看到引用信息。
+ */
+export function buildReplyContextExtra(replyContext) {
+    if (!replyContext)
+        return undefined;
+    const messageId = normalizeReplyValue(replyContext.messageId);
+    const actorName = normalizeReplyValue(replyContext.actorName);
+    const text = normalizeReplyValue(replyContext.text);
+    const quoteText = normalizeReplyValue(replyContext.quoteText);
+    if (!messageId && !actorName && !text && !quoteText)
+        return undefined;
+    return {
+        hasReplyContext: true,
+        ...(messageId ? { replyMessageId: messageId } : {}),
+        ...(actorName ? { replyActorName: actorName } : {}),
+        ...(text ? { replyText: text } : {}),
+        ...(quoteText ? { replyQuoteText: quoteText } : {}),
+    };
+}
+//# sourceMappingURL=ReplyContextFormatter.js.map

package/bin/chat/runtime/ReplyContextFormatter.js.map

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

package/bin/chat/runtime/ReplyDispatch.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Chat reply dispatch helper。
+ *
+ * 关键点（中文）
+ * - 把 chat 回复前/回复后的扩展点统一收敛到这里。
+ * - 仅服务 agent 执行生命周期，不覆盖手动 `chat send`。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatReplyDispatchInput, ChatReplyEffectInput } from "../../chat/types/ChatPlugin.js";
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+/**
+ * 回复前文本增强。
+ */
+export declare function prepareChatReplyText(params: {
+    context: AgentContext;
+    input: ChatReplyDispatchInput;
+}): Promise<string>;
+/**
+ * 回复后事件分发。
+ */
+export declare function emitChatReplyEffect(params: {
+    context: AgentContext;
+    input: ChatReplyEffectInput;
+}): Promise<void>;
+/**
+ * 基于 chatKey 补齐回复目标上下文。
+ */
+export declare function resolveChatReplyTarget(params: {
+    context: AgentContext;
+    chatKey: string;
+}): Promise<{
+    channel?: ChatDispatchChannel;
+    chatId?: string;
+    messageId?: string;
+}>;
+//# sourceMappingURL=ReplyDispatch.d.ts.map

package/bin/chat/runtime/ReplyDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyDispatch.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ReplyDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAE/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAQ1E;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAWD"}

package/bin/chat/runtime/ReplyDispatch.js

@@ -0,0 +1,51 @@
+/**
+ * Chat reply dispatch helper。
+ *
+ * 关键点（中文）
+ * - 把 chat 回复前/回复后的扩展点统一收敛到这里。
+ * - 仅服务 agent 执行生命周期，不覆盖手动 `chat send`。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../chat/runtime/PluginPoints.js";
+import { resolveDispatchTargetByChatKey } from "../../chat/runtime/ChatkeySend.js";
+function normalizeText(value) {
+    return String(value || "").trim();
+}
+/**
+ * 回复前文本增强。
+ */
+export async function prepareChatReplyText(params) {
+    const input = {
+        ...params.input,
+        text: normalizeText(params.input.text),
+    };
+    if (!input.text)
+        return "";
+    const next = await params.context.plugins.pipeline(CHAT_PLUGIN_POINTS.beforeReply, input);
+    const record = next && typeof next === "object" && !Array.isArray(next)
+        ? next
+        : {};
+    return normalizeText(typeof record.text === "string" ? record.text : input.text);
+}
+/**
+ * 回复后事件分发。
+ */
+export async function emitChatReplyEffect(params) {
+    await params.context.plugins.effect(CHAT_PLUGIN_POINTS.afterReply, params.input);
+}
+/**
+ * 基于 chatKey 补齐回复目标上下文。
+ */
+export async function resolveChatReplyTarget(params) {
+    const target = await resolveDispatchTargetByChatKey({
+        context: params.context,
+        chatKey: params.chatKey,
+    });
+    if (!target)
+        return {};
+    return {
+        channel: target.channel,
+        chatId: target.chatId,
+        ...(target.messageId ? { messageId: target.messageId } : {}),
+    };
+}
+//# sourceMappingURL=ReplyDispatch.js.map

package/bin/chat/runtime/ReplyDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyDispatch.js","sourceRoot":"","sources":["../../../src/chat/runtime/ReplyDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAE/E,SAAS,aAAa,CAAC,KAAyB;IAC9C,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAG1C;IACC,MAAM,KAAK,GAAG;QACZ,GAAG,MAAM,CAAC,KAAK;QACf,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;KACvC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAChD,kBAAkB,CAAC,WAAW,EAC9B,KAA6B,CAC9B,CAAC;IACF,MAAM,MAAM,GACV,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,CAAC,CAAE,IAAgC;QACnC,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,aAAa,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAGzC;IACC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CACjC,kBAAkB,CAAC,UAAU,EAC7B,MAAM,CAAC,KAA6B,CACrC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAG5C;IAKC,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC;QAClD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/bin/chat/runtime/SystemPrompt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Chat SystemPrompt：chat 运行时 system prompt 辅助。
+ *
+ * 关键点（中文）
+ * - 把当前 chat 路由环境从入站 `<info>` 中剥离，改由 system prompt 注入。
+ * - 仅描述当前会话环境，不承载用户身份字段。
+ * - 统一从 request context + ChatMetaStore 读取当前 chat 元信息。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatEnvironmentPromptInput } from "../../chat/types/ChatPromptContext.js";
+/**
+ * 解析当前请求的 chat 环境输入。
+ *
+ * 说明（中文）
+ * - 非 chat session 或尚未建立 chat route 时返回 `null`。
+ */
+export declare function resolveCurrentChatEnvironmentPromptInput(context: AgentContext): Promise<ChatEnvironmentPromptInput | null>;
+/**
+ * 构造当前 chat 环境说明文本。
+ */
+export declare function buildChatEnvironmentPrompt(input: ChatEnvironmentPromptInput): string;
+/**
+ * 读取并渲染当前请求的 chat 环境 prompt。
+ */
+export declare function buildCurrentChatEnvironmentPrompt(context: AgentContext): Promise<string>;
+//# sourceMappingURL=SystemPrompt.d.ts.map

package/bin/chat/runtime/SystemPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemPrompt.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/SystemPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAQpF;;;;;GAKG;AACH,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAmB5C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAqBpF;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/bin/chat/runtime/SystemPrompt.js

@@ -0,0 +1,70 @@
+/**
+ * Chat SystemPrompt：chat 运行时 system prompt 辅助。
+ *
+ * 关键点（中文）
+ * - 把当前 chat 路由环境从入站 `<info>` 中剥离，改由 system prompt 注入。
+ * - 仅描述当前会话环境，不承载用户身份字段。
+ * - 统一从 request context + ChatMetaStore 读取当前 chat 元信息。
+ */
+import { getSessionRunScope } from "@downcity/agent/internal/executor/SessionRunScope.js";
+import { readChatMetaBySessionId } from "../../chat/runtime/ChatMetaStore.js";
+function normalizePromptValue(value, fallback) {
+    const text = String(value ?? "").trim();
+    return text || fallback;
+}
+/**
+ * 解析当前请求的 chat 环境输入。
+ *
+ * 说明（中文）
+ * - 非 chat session 或尚未建立 chat route 时返回 `null`。
+ */
+export async function resolveCurrentChatEnvironmentPromptInput(context) {
+    const sessionId = String(getSessionRunScope()?.sessionId || "").trim();
+    if (!sessionId)
+        return null;
+    const meta = await readChatMetaBySessionId({
+        context,
+        sessionId,
+    }).catch(() => null);
+    if (!meta?.channel || !meta.chatId)
+        return null;
+    return {
+        sessionId: meta.sessionId,
+        chatKey: meta.sessionId,
+        channel: meta.channel,
+        chatId: meta.chatId,
+        ...(meta.targetType ? { chatType: meta.targetType } : {}),
+        ...(typeof meta.threadId === "number" ? { threadId: meta.threadId } : {}),
+        ...(meta.chatTitle ? { chatTitle: meta.chatTitle } : {}),
+    };
+}
+/**
+ * 构造当前 chat 环境说明文本。
+ */
+export function buildChatEnvironmentPrompt(input) {
+    const lines = [
+        "# Current Chat Environment",
+        "以下字段只描述当前 chat 会话环境与路由，不是用户身份信息：",
+        `- channel: ${normalizePromptValue(input.channel, "unknown")}`,
+        `- session_id: ${normalizePromptValue(input.sessionId, "unknown")}`,
+        `- chat_key: ${normalizePromptValue(input.chatKey, "unknown")}`,
+        `- chat_id: ${normalizePromptValue(input.chatId, "unknown")}`,
+        `- chat_type: ${normalizePromptValue(input.chatType, "unknown")}`,
+        `- thread_id: ${normalizePromptValue(typeof input.threadId === "number" ? String(input.threadId) : "", "none")}`,
+    ];
+    const chatTitle = normalizePromptValue(input.chatTitle, "");
+    if (chatTitle) {
+        lines.push(`- chat_title: ${chatTitle}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * 读取并渲染当前请求的 chat 环境 prompt。
+ */
+export async function buildCurrentChatEnvironmentPrompt(context) {
+    const input = await resolveCurrentChatEnvironmentPromptInput(context);
+    if (!input)
+        return "";
+    return buildChatEnvironmentPrompt(input);
+}
+//# sourceMappingURL=SystemPrompt.js.map

package/bin/chat/runtime/SystemPrompt.js.map

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

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

@@ -0,0 +1,97 @@
+/**
+ * Chat Bot 信息探测类型定义。
+ *
+ * 关键点（中文）
+ * - 将“凭据 -> bot 基础信息”的探测输入输出结构标准化。
+ * - Console、Channel Account 存储、后续自动化流程都复用该结构。
+ */
+import type { ChatChannelName } from "../../chat/types/ChannelStatus.js";
+/**
+ * Bot 信息探测凭据。
+ */
+export interface ChatBotInfoCredentialInput {
+    /**
+     * Telegram 机器人 token（仅 Telegram 渠道使用）。
+     */
+    botToken?: string;
+    /**
+     * 应用 ID（Feishu/QQ 使用）。
+     */
+    appId?: string;
+    /**
+     * 应用密钥（Feishu/QQ 使用）。
+     */
+    appSecret?: string;
+    /**
+     * 平台域名（可选，主要用于 Feishu 私有部署或特殊网关）。
+     */
+    domain?: string;
+    /**
+     * 是否使用沙箱环境（QQ 使用）。
+     */
+    sandbox?: boolean;
+}
+/**
+ * Bot 信息探测请求。
+ */
+export interface ChatBotInfoResolveInput {
+    /**
+     * 目标渠道名称。
+     */
+    channel: ChatChannelName;
+    /**
+     * 渠道对应的认证凭据。
+     */
+    credentials: ChatBotInfoCredentialInput;
+}
+/**
+ * Bot 信息探测结果。
+ */
+export interface ChatBotInfoResult {
+    /**
+     * 渠道名称。
+     */
+    channel: ChatChannelName;
+    /**
+     * Bot 展示名称（用于 Console 列表展示和默认命名）。
+     */
+    name: string;
+    /**
+     * Bot 身份标识（通常是用户名/open_id/appId 等）。
+     */
+    identity?: string;
+    /**
+     * Bot 所有者信息（可选；平台可获取时返回）。
+     */
+    owner?: string;
+    /**
+     * Bot 创建者信息（可选；平台可获取时返回）。
+     */
+    creator?: string;
+    /**
+     * 平台返回的 bot 用户唯一 ID（若可获取）。
+     */
+    botUserId?: string;
+    /**
+     * 建议用于生成 channel account id 的稳定种子。
+     */
+    idSeed?: string;
+    /**
+     * 探测结果描述。
+     */
+    message: string;
+}
+/**
+ * 渠道级 Bot 信息探测器接口。
+ */
+export interface ChatChannelBotInfoProvider {
+    /**
+     * 当前探测器对应渠道。
+     */
+    readonly channel: ChatChannelName;
+    /**
+     * 使用凭据探测并返回标准化 bot 信息。
+     */
+    resolve(credentials: ChatBotInfoCredentialInput): Promise<ChatBotInfoResult>;
+}
+//# sourceMappingURL=BotInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BotInfo.d.ts","sourceRoot":"","sources":["../../../src/chat/types/BotInfo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,WAAW,EAAE,0BAA0B,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9E"}

package/bin/chat/types/BotInfo.js

@@ -0,0 +1,9 @@
+/**
+ * Chat Bot 信息探测类型定义。
+ *
+ * 关键点（中文）
+ * - 将“凭据 -> bot 基础信息”的探测输入输出结构标准化。
+ * - Console、Channel Account 存储、后续自动化流程都复用该结构。
+ */
+export {};
+//# sourceMappingURL=BotInfo.js.map

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

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

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

@@ -0,0 +1,226 @@
+/**
+ * Chat channel account 管理类型。
+ *
+ * 关键点（中文）
+ * - 这些类型描述 agent 运行时内部的 chat channel account 管理输入输出。
+ * - 凭据明文只允许出现在写入输入中，读取结果必须是脱敏后的安全视图。
+ */
+import type { StoredChannelAccountChannel } from "@downcity/agent/internal/types/runtime/host/Store.js";
+/**
+ * 支持的 chat channel account 类型。
+ */
+export type ChatChannelAccountChannel = StoredChannelAccountChannel;
+/**
+ * Channel account 探测结果。
+ */
+export interface ChatChannelAccountProbeResult {
+    /**
+     * 账号所属 chat channel。
+     */
+    channel: ChatChannelAccountChannel;
+    /**
+     * 系统生成的账号 ID。
+     */
+    accountId: string;
+    /**
+     * 账号展示名称。
+     */
+    name: string;
+    /**
+     * 平台身份展示文案，例如 bot username 或 app id。
+     */
+    identity?: string;
+    /**
+     * 平台返回的所有者信息。
+     */
+    owner?: string;
+    /**
+     * 平台返回的创建者信息。
+     */
+    creator?: string;
+    /**
+     * 平台返回的 bot 用户 ID。
+     */
+    botUserId?: string;
+    /**
+     * 面向用户的探测结果说明。
+     */
+    message: string;
+}
+/**
+ * Channel account 列表中的安全视图。
+ */
+export interface ChatChannelAccountListItem {
+    /**
+     * 账号 ID。
+     */
+    id: string;
+    /**
+     * 账号所属 chat channel。
+     */
+    channel: ChatChannelAccountChannel;
+    /**
+     * 账号展示名称。
+     */
+    name: string;
+    /**
+     * 平台身份展示文案。
+     */
+    identity?: string;
+    /**
+     * 平台所有者信息。
+     */
+    owner?: string;
+    /**
+     * 平台创建者信息。
+     */
+    creator?: string;
+    /**
+     * 渠道域名，例如 Feishu/Lark 域。
+     */
+    domain?: string;
+    /**
+     * QQ 沙箱模式开关。
+     */
+    sandbox: boolean;
+    /**
+     * 是否保存了 bot token。
+     */
+    hasBotToken: boolean;
+    /**
+     * 是否保存了 app id。
+     */
+    hasAppId: boolean;
+    /**
+     * 是否保存了 app secret。
+     */
+    hasAppSecret: boolean;
+    /**
+     * 脱敏后的 bot token。
+     */
+    botTokenMasked?: string;
+    /**
+     * 脱敏后的 app id。
+     */
+    appIdMasked?: string;
+    /**
+     * 脱敏后的 app secret。
+     */
+    appSecretMasked?: string;
+    /**
+     * 创建时间（ISO 字符串）。
+     */
+    createdAt: string;
+    /**
+     * 更新时间（ISO 字符串）。
+     */
+    updatedAt: string;
+}
+/**
+ * Channel account 列表结果。
+ */
+export interface ChatChannelAccountListResult {
+    /**
+     * 脱敏后的账号列表。
+     */
+    items: ChatChannelAccountListItem[];
+}
+/**
+ * Channel account 写入输入。
+ */
+export interface ChatChannelAccountUpsertInput {
+    /**
+     * 账号 ID。
+     */
+    id: string;
+    /**
+     * 账号所属 chat channel。
+     */
+    channel: string;
+    /**
+     * 账号展示名称。
+     */
+    name: string;
+    /**
+     * 平台身份展示文案。
+     */
+    identity?: string;
+    /**
+     * 平台所有者信息。
+     */
+    owner?: string;
+    /**
+     * 平台创建者信息。
+     */
+    creator?: string;
+    /**
+     * Telegram bot token。
+     */
+    botToken?: string;
+    /**
+     * Feishu/QQ app id。
+     */
+    appId?: string;
+    /**
+     * Feishu/QQ app secret。
+     */
+    appSecret?: string;
+    /**
+     * Feishu/Lark 域名。
+     */
+    domain?: string;
+    /**
+     * QQ 沙箱模式。
+     */
+    sandbox?: boolean;
+    /**
+     * 是否清空 bot token。
+     */
+    clearBotToken?: boolean;
+    /**
+     * 是否清空 app id。
+     */
+    clearAppId?: boolean;
+    /**
+     * 是否清空 app secret。
+     */
+    clearAppSecret?: boolean;
+}
+/**
+ * Channel account 凭据创建输入。
+ */
+export interface ChatChannelAccountCreateInput {
+    /**
+     * 账号所属 chat channel。
+     */
+    channel: string;
+    /**
+     * 账号展示名称；未传时优先使用探测结果。
+     */
+    name?: string;
+    /**
+     * Telegram bot token。
+     */
+    botToken?: string;
+    /**
+     * Feishu/QQ app id。
+     */
+    appId?: string;
+    /**
+     * Feishu/QQ app secret。
+     */
+    appSecret?: string;
+    /**
+     * Feishu/Lark 域名。
+     */
+    domain?: string;
+    /**
+     * QQ 沙箱模式。
+     */
+    sandbox?: boolean;
+    /**
+     * 是否跳过自动探测。
+     */
+    probe?: boolean;
+}
+//# sourceMappingURL=ChannelAccount.d.ts.map

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

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