@downcity/plugins 1.0.4

package/bin/chat/channels/BaseChatChannelQueue.js

@@ -0,0 +1,237 @@
+/**
+ * BaseChatChannel 队列编排辅助函数。
+ *
+ * 关键点（中文）
+ * - audit / exec 入队都需要走同一套 prepare + emit 流程。
+ * - 这些逻辑抽离后，`BaseChatChannel` 只负责渠道层输入整理与授权判断。
+ */
+import { resolveChatQueueStore } from "../../chat/runtime/ChatQueue.js";
+import { buildQueuedUserMessageWithInfo } from "../../chat/runtime/QueuedUserMessage.js";
+import { appendExecIngress } from "../../chat/runtime/ChatIngressStore.js";
+import { resolveIncomingChatUserRole } from "../../chat/runtime/PluginDispatch.js";
+import { emitChatEnqueueEffect, prepareChatEnqueue, } from "../../chat/runtime/EnqueueDispatch.js";
+import { appendInboundChannelHistory, resolveOrCreateChannelSessionId, stripUndefinedMeta, updateChannelChatMeta, } from "./BaseChatChannelSupport.js";
+/**
+ * 写入 audit 消息并送入 chat queue。
+ */
+export async function enqueueAuditChannelMessage(params) {
+    const meta = (params.meta || {});
+    const username = typeof meta.username === "string" ? meta.username : undefined;
+    const messageThreadId = typeof meta.messageThreadId === "number" && Number.isFinite(meta.messageThreadId)
+        ? meta.messageThreadId
+        : undefined;
+    const chatType = typeof meta.chatType === "string" ? meta.chatType : undefined;
+    const chatTitle = typeof meta.chatTitle === "string" ? meta.chatTitle.trim() || undefined : undefined;
+    const sessionId = await resolveOrCreateChannelSessionId({
+        context: params.context,
+        channel: params.channel,
+        chatId: params.chatId,
+        chatType,
+        messageThreadId,
+    });
+    if (!sessionId)
+        return;
+    const extra = stripUndefinedMeta(meta);
+    await appendInboundChannelHistory({
+        context: params.context,
+        logger: params.context.logger,
+        channel: params.channel,
+        sessionId,
+        chatId: params.chatId,
+        ingressKind: "audit",
+        text: params.text,
+        targetType: chatType,
+        threadId: messageThreadId,
+        messageId: params.messageId,
+        actorId: params.userId,
+        actorName: username,
+        extra,
+    });
+    await updateChannelChatMeta({
+        context: params.context,
+        channel: params.channel,
+        sessionId,
+        chatId: params.chatId,
+        targetType: chatType,
+        threadId: messageThreadId,
+        messageId: params.messageId,
+        actorId: params.userId,
+        actorName: username,
+        chatTitle,
+    });
+    const preparedAudit = await prepareChatEnqueue({
+        context: params.context,
+        input: {
+            kind: "audit",
+            channel: params.channel,
+            chatKey: sessionId,
+            chatId: params.chatId,
+            text: params.text,
+            ...(chatType ? { chatType } : {}),
+            ...(typeof messageThreadId === "number" ? { threadId: messageThreadId } : {}),
+            ...(typeof params.messageId === "string" ? { messageId: params.messageId } : {}),
+            ...(typeof params.userId === "string" ? { actorId: params.userId } : {}),
+            ...(typeof username === "string" ? { actorName: username } : {}),
+            extra,
+        },
+    });
+    const auditEnqueued = resolveChatQueueStore(params.context).enqueue({
+        kind: "audit",
+        channel: params.channel,
+        targetId: params.chatId,
+        sessionId,
+        ...(typeof preparedAudit.actorId === "string"
+            ? { actorId: preparedAudit.actorId }
+            : {}),
+        ...(typeof preparedAudit.actorName === "string"
+            ? { actorName: preparedAudit.actorName }
+            : {}),
+        ...(typeof preparedAudit.messageId === "string"
+            ? { messageId: preparedAudit.messageId }
+            : {}),
+        text: preparedAudit.text,
+        ...(typeof preparedAudit.threadId === "number"
+            ? { threadId: preparedAudit.threadId }
+            : {}),
+        ...(typeof preparedAudit.chatType === "string"
+            ? { targetType: preparedAudit.chatType }
+            : {}),
+        extra: preparedAudit.extra && typeof preparedAudit.extra === "object"
+            ? preparedAudit.extra
+            : extra,
+    });
+    await emitChatEnqueueEffect({
+        context: params.context,
+        input: {
+            ...preparedAudit,
+            itemId: auditEnqueued.itemId,
+            lanePosition: auditEnqueued.lanePosition,
+        },
+    });
+}
+/**
+ * 写入 exec ingress 并送入 chat queue。
+ */
+export async function enqueueExecChannelMessage(params) {
+    const msg = params.message;
+    const userRole = await resolveIncomingChatUserRole({
+        context: params.context,
+        channel: params.channel,
+        userId: msg.userId,
+    });
+    const inboundExtra = msg.extra && typeof msg.extra === "object" ? stripUndefinedMeta(msg.extra) : {};
+    const mergedExtra = {
+        ...inboundExtra,
+        roleId: userRole?.roleId || "unknown",
+        permissions: userRole?.permissions || [],
+    };
+    const chatKey = await resolveOrCreateChannelSessionId({
+        context: params.context,
+        channel: params.channel,
+        chatId: msg.chatId,
+        chatType: msg.chatType,
+        messageThreadId: msg.messageThreadId,
+    });
+    if (!chatKey) {
+        throw new Error("Failed to resolve sessionId for incoming chat message");
+    }
+    const rawQueuedText = buildQueuedUserMessageWithInfo({
+        messageId: msg.messageId,
+        userId: msg.userId,
+        username: msg.username,
+        roleId: userRole?.roleId,
+        permissions: userRole?.permissions,
+        userTimezone: msg.userTimezone,
+        text: msg.text,
+    });
+    const preparedExec = await prepareChatEnqueue({
+        context: params.context,
+        input: {
+            kind: "exec",
+            channel: params.channel,
+            chatKey,
+            chatId: msg.chatId,
+            text: rawQueuedText,
+            ...(msg.chatType ? { chatType: msg.chatType } : {}),
+            ...(typeof msg.messageThreadId === "number"
+                ? { threadId: msg.messageThreadId }
+                : {}),
+            ...(typeof msg.messageId === "string" ? { messageId: msg.messageId } : {}),
+            ...(typeof msg.userId === "string" ? { actorId: msg.userId } : {}),
+            ...(typeof msg.username === "string" ? { actorName: msg.username } : {}),
+            extra: mergedExtra,
+        },
+    });
+    const queuedText = preparedExec.text;
+    const queuedExtra = preparedExec.extra && typeof preparedExec.extra === "object"
+        ? preparedExec.extra
+        : mergedExtra;
+    await appendExecIngress({
+        context: params.context,
+        sessionId: chatKey,
+        channel: params.channel,
+        chatId: msg.chatId,
+        text: queuedText,
+        ...(typeof preparedExec.chatType === "string"
+            ? { targetType: preparedExec.chatType }
+            : {}),
+        ...(typeof preparedExec.threadId === "number"
+            ? { threadId: preparedExec.threadId }
+            : {}),
+        ...(typeof preparedExec.messageId === "string"
+            ? { messageId: preparedExec.messageId }
+            : {}),
+        ...(typeof preparedExec.actorId === "string"
+            ? { actorId: preparedExec.actorId }
+            : {}),
+        ...(typeof preparedExec.actorName === "string"
+            ? { actorName: preparedExec.actorName }
+            : {}),
+        extra: queuedExtra,
+    });
+    await updateChannelChatMeta({
+        context: params.context,
+        channel: params.channel,
+        sessionId: chatKey,
+        chatId: msg.chatId,
+        targetType: msg.chatType,
+        threadId: msg.messageThreadId,
+        messageId: msg.messageId,
+        actorId: msg.userId,
+        actorName: msg.username,
+        chatTitle: msg.chatTitle,
+    });
+    const execEnqueued = resolveChatQueueStore(params.context).enqueue({
+        kind: "exec",
+        channel: params.channel,
+        targetId: msg.chatId,
+        sessionId: chatKey,
+        text: queuedText,
+        ...(typeof preparedExec.chatType === "string"
+            ? { targetType: preparedExec.chatType }
+            : {}),
+        ...(typeof preparedExec.threadId === "number"
+            ? { threadId: preparedExec.threadId }
+            : {}),
+        ...(typeof preparedExec.messageId === "string"
+            ? { messageId: preparedExec.messageId }
+            : {}),
+        ...(typeof preparedExec.actorId === "string"
+            ? { actorId: preparedExec.actorId }
+            : {}),
+        ...(typeof preparedExec.actorName === "string"
+            ? { actorName: preparedExec.actorName }
+            : {}),
+        extra: queuedExtra,
+    });
+    await emitChatEnqueueEffect({
+        context: params.context,
+        input: {
+            ...preparedExec,
+            itemId: execEnqueued.itemId,
+            lanePosition: execEnqueued.lanePosition,
+        },
+    });
+    return { chatKey, position: execEnqueued.lanePosition };
+}
+//# sourceMappingURL=BaseChatChannelQueue.js.map

package/bin/chat/channels/BaseChatChannelQueue.js.map

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

package/bin/chat/channels/BaseChatChannelSupport.d.ts

@@ -0,0 +1,189 @@
+/**
+ * BaseChatChannel 共享辅助函数。
+ *
+ * 关键点（中文）
+ * - 这里只放 session 映射、history 落盘、chat meta 更新等“通用支撑逻辑”。
+ * - `BaseChatChannel` 保留编排职责，避免基类继续承担过多存储细节。
+ */
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+import type { Logger } from "@downcity/agent/internal/utils/logger/Logger.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { JsonObject, JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+/**
+ * 渠道附加元信息。
+ */
+export type ChannelUserMessageMeta = {
+    /**
+     * 任意附加字段名。
+     */
+    [key: string]: JsonValue | undefined;
+};
+/**
+ * 基于渠道目标解析 sessionId 的输入。
+ */
+export interface ChannelSessionTargetParams {
+    /**
+     * 当前 execution runtime。
+     */
+    context: AgentContext;
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 平台 chatId。
+     */
+    chatId: string;
+    /**
+     * 可选 chatType。
+     */
+    chatType?: string;
+    /**
+     * 可选 thread / topic id。
+     */
+    messageThreadId?: number;
+}
+/**
+ * 渠道 meta 更新输入。
+ */
+export interface ChannelChatMetaParams {
+    /**
+     * 当前 execution runtime。
+     */
+    context: AgentContext;
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * sessionId。
+     */
+    sessionId: string;
+    /**
+     * 平台 chatId。
+     */
+    chatId: string;
+    /**
+     * 可选目标类型。
+     */
+    targetType?: string;
+    /**
+     * 可选 thread id。
+     */
+    threadId?: number;
+    /**
+     * 可选消息 id。
+     */
+    messageId?: string;
+    /**
+     * 可选用户 id。
+     */
+    actorId?: string;
+    /**
+     * 可选用户名。
+     */
+    actorName?: string;
+    /**
+     * 会话标题。
+     */
+    chatTitle?: string;
+}
+/**
+ * 入站 history 写入输入。
+ */
+export interface ChannelInboundHistoryParams {
+    /**
+     * 当前 execution runtime。
+     */
+    context: AgentContext;
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * sessionId。
+     */
+    sessionId: string;
+    /**
+     * 平台 chatId。
+     */
+    chatId: string;
+    /**
+     * 入站类型，audit 或 exec。
+     */
+    ingressKind: "audit" | "exec";
+    /**
+     * 文本内容。
+     */
+    text: string;
+    /**
+     * 可选目标类型。
+     */
+    targetType?: string;
+    /**
+     * 可选 thread id。
+     */
+    threadId?: number;
+    /**
+     * 可选消息 id。
+     */
+    messageId?: string;
+    /**
+     * 可选用户 id。
+     */
+    actorId?: string;
+    /**
+     * 可选用户名。
+     */
+    actorName?: string;
+    /**
+     * 附加元信息。
+     */
+    extra?: JsonObject;
+}
+/**
+ * 工具侧 outbound history 输入。
+ */
+export interface ChannelToolOutboundHistoryParams extends ChannelSessionTargetParams {
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * 文本内容。
+     */
+    text: string;
+    /**
+     * 可选消息 id。
+     */
+    messageId?: string;
+}
+/**
+ * 去除 meta 中的 undefined 字段。
+ */
+export declare function stripUndefinedMeta(meta: ChannelUserMessageMeta): JsonObject;
+/**
+ * 通过渠道目标解析或创建 sessionId。
+ */
+export declare function resolveOrCreateChannelSessionId(params: ChannelSessionTargetParams): Promise<string | null>;
+/**
+ * 通过渠道目标解析已有 sessionId。
+ */
+export declare function resolveChannelSessionId(params: ChannelSessionTargetParams): Promise<string | null>;
+/**
+ * 更新 session 对应的 chat meta。
+ */
+export declare function updateChannelChatMeta(params: ChannelChatMetaParams): Promise<void>;
+/**
+ * 追加入站 chat history。
+ */
+export declare function appendInboundChannelHistory(params: ChannelInboundHistoryParams): Promise<void>;
+/**
+ * 工具发送成功后补齐 outbound history。
+ */
+export declare function appendToolOutboundChannelHistory(params: ChannelToolOutboundHistoryParams): Promise<void>;
+//# sourceMappingURL=BaseChatChannelSupport.d.ts.map

package/bin/chat/channels/BaseChatChannelSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseChatChannelSupport.d.ts","sourceRoot":"","sources":["../../../src/chat/channels/BaseChatChannelSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iDAAiD,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAW3F;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;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;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;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;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gCAAiC,SAAQ,0BAA0B;IAClF;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,UAAU,CAM3E;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/bin/chat/channels/BaseChatChannelSupport.js

@@ -0,0 +1,141 @@
+/**
+ * BaseChatChannel 共享辅助函数。
+ *
+ * 关键点（中文）
+ * - 这里只放 session 映射、history 落盘、chat meta 更新等“通用支撑逻辑”。
+ * - `BaseChatChannel` 保留编排职责，避免基类继续承担过多存储细节。
+ */
+import { resolveSessionIdByChatTarget, resolveOrCreateSessionIdByChatTarget, upsertChatMetaBySessionId, } from "../../chat/runtime/ChatMetaStore.js";
+import { appendInboundChatHistory, appendOutboundChatHistory, } from "../../chat/runtime/ChatHistoryStore.js";
+/**
+ * 去除 meta 中的 undefined 字段。
+ */
+export function stripUndefinedMeta(meta) {
+    const out = {};
+    for (const [key, value] of Object.entries(meta)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+/**
+ * 通过渠道目标解析或创建 sessionId。
+ */
+export async function resolveOrCreateChannelSessionId(params) {
+    const chatId = String(params.chatId || "").trim();
+    if (!chatId)
+        return null;
+    return await resolveOrCreateSessionIdByChatTarget({
+        context: params.context,
+        channel: params.channel,
+        chatId,
+        ...(typeof params.chatType === "string" ? { targetType: params.chatType } : {}),
+        ...(typeof params.messageThreadId === "number"
+            ? { threadId: params.messageThreadId }
+            : {}),
+    });
+}
+/**
+ * 通过渠道目标解析已有 sessionId。
+ */
+export async function resolveChannelSessionId(params) {
+    const chatId = String(params.chatId || "").trim();
+    if (!chatId)
+        return null;
+    return await resolveSessionIdByChatTarget({
+        context: params.context,
+        channel: params.channel,
+        chatId,
+        ...(typeof params.chatType === "string" ? { targetType: params.chatType } : {}),
+        ...(typeof params.messageThreadId === "number"
+            ? { threadId: params.messageThreadId }
+            : {}),
+    });
+}
+/**
+ * 更新 session 对应的 chat meta。
+ */
+export async function updateChannelChatMeta(params) {
+    await upsertChatMetaBySessionId({
+        context: params.context,
+        sessionId: params.sessionId,
+        channel: params.channel,
+        chatId: params.chatId,
+        targetType: params.targetType,
+        threadId: params.threadId,
+        messageId: params.messageId,
+        actorId: params.actorId,
+        actorName: params.actorName,
+        chatTitle: params.chatTitle,
+    });
+}
+/**
+ * 追加入站 chat history。
+ */
+export async function appendInboundChannelHistory(params) {
+    try {
+        await appendInboundChatHistory({
+            context: params.context,
+            sessionId: params.sessionId,
+            channel: params.channel,
+            chatId: params.chatId,
+            ingressKind: params.ingressKind,
+            text: params.text,
+            targetType: params.targetType,
+            threadId: params.threadId,
+            messageId: params.messageId,
+            actorId: params.actorId,
+            actorName: params.actorName,
+            extra: params.extra,
+        });
+    }
+    catch (error) {
+        params.logger.warn("Failed to append inbound chat history", {
+            error: String(error),
+            channel: params.channel,
+            sessionId: params.sessionId,
+            chatId: params.chatId,
+            ingressKind: params.ingressKind,
+        });
+    }
+}
+/**
+ * 工具发送成功后补齐 outbound history。
+ */
+export async function appendToolOutboundChannelHistory(params) {
+    const chatId = String(params.chatId || "").trim();
+    const text = String(params.text ?? "");
+    if (!chatId || !text.trim())
+        return;
+    const sessionId = await resolveOrCreateChannelSessionId(params);
+    if (!sessionId)
+        return;
+    try {
+        await appendOutboundChatHistory({
+            context: params.context,
+            sessionId,
+            channel: params.channel,
+            chatId,
+            text,
+            targetType: params.chatType,
+            ...(typeof params.messageThreadId === "number"
+                ? { threadId: params.messageThreadId }
+                : {}),
+            ...(typeof params.messageId === "string" && params.messageId
+                ? { messageId: params.messageId }
+                : {}),
+            extra: {
+                source: "channel_send_tool_text",
+            },
+        });
+    }
+    catch (error) {
+        params.logger.warn("Failed to append outbound chat history", {
+            error: String(error),
+            channel: params.channel,
+            sessionId,
+            chatId,
+        });
+    }
+}
+//# sourceMappingURL=BaseChatChannelSupport.js.map

package/bin/chat/channels/BaseChatChannelSupport.js.map

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

package/bin/chat/channels/BotInfoProvider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Chat 渠道 Bot 信息探测器注册表。
+ *
+ * 关键点（中文）
+ * - 将不同渠道的 bot 信息探测实现统一抽象为 provider。
+ * - 业务层只依赖注册表，不直接写渠道分支。
+ */
+import type { ChatBotInfoResolveInput, ChatBotInfoResult, ChatChannelBotInfoProvider } from "../../chat/types/BotInfo.js";
+import type { ChatChannelName } from "../../chat/types/ChannelStatus.js";
+/**
+ * 获取指定渠道的 Bot 信息探测器。
+ */
+export declare function getChatChannelBotInfoProvider(channel: ChatChannelName): ChatChannelBotInfoProvider;
+/**
+ * 使用统一入口探测 Bot 信息。
+ */
+export declare function resolveChatChannelBotInfo(input: ChatBotInfoResolveInput): Promise<ChatBotInfoResult>;
+//# sourceMappingURL=BotInfoProvider.d.ts.map

package/bin/chat/channels/BotInfoProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotInfoProvider.d.ts","sourceRoot":"","sources":["../../../src/chat/channels/BotInfoProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAerE;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,GACvB,0BAA0B,CAE5B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}

package/bin/chat/channels/BotInfoProvider.js

@@ -0,0 +1,32 @@
+/**
+ * Chat 渠道 Bot 信息探测器注册表。
+ *
+ * 关键点（中文）
+ * - 将不同渠道的 bot 信息探测实现统一抽象为 provider。
+ * - 业务层只依赖注册表，不直接写渠道分支。
+ */
+import { FeishuBotInfoProvider } from "../../chat/channels/feishu/BotInfo.js";
+import { QqBotInfoProvider } from "../../chat/channels/qq/BotInfo.js";
+import { TelegramBotInfoProvider } from "../../chat/channels/telegram/BotInfo.js";
+const TELEGRAM_BOT_INFO_PROVIDER = new TelegramBotInfoProvider();
+const FEISHU_BOT_INFO_PROVIDER = new FeishuBotInfoProvider();
+const QQ_BOT_INFO_PROVIDER = new QqBotInfoProvider();
+const CHAT_CHANNEL_BOT_INFO_PROVIDER_REGISTRY = {
+    telegram: TELEGRAM_BOT_INFO_PROVIDER,
+    feishu: FEISHU_BOT_INFO_PROVIDER,
+    qq: QQ_BOT_INFO_PROVIDER,
+};
+/**
+ * 获取指定渠道的 Bot 信息探测器。
+ */
+export function getChatChannelBotInfoProvider(channel) {
+    return CHAT_CHANNEL_BOT_INFO_PROVIDER_REGISTRY[channel];
+}
+/**
+ * 使用统一入口探测 Bot 信息。
+ */
+export function resolveChatChannelBotInfo(input) {
+    const provider = getChatChannelBotInfoProvider(input.channel);
+    return provider.resolve(input.credentials);
+}
+//# sourceMappingURL=BotInfoProvider.js.map

package/bin/chat/channels/BotInfoProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotInfoProvider.js","sourceRoot":"","sources":["../../../src/chat/channels/BotInfoProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAQ9E,MAAM,0BAA0B,GAAG,IAAI,uBAAuB,EAAE,CAAC;AACjE,MAAM,wBAAwB,GAAG,IAAI,qBAAqB,EAAE,CAAC;AAC7D,MAAM,oBAAoB,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAErD,MAAM,uCAAuC,GAGzC;IACF,QAAQ,EAAE,0BAA0B;IACpC,MAAM,EAAE,wBAAwB;IAChC,EAAE,EAAE,oBAAoB;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAAwB;IAExB,OAAO,uCAAuC,CAAC,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAA8B;IAE9B,MAAM,QAAQ,GAAG,6BAA6B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC7C,CAAC"}