@downcity/agent 1.1.1 → 1.1.6

package/bin/service/builtins/chat/accounts/ChannelAccountService.js

@@ -0,0 +1,285 @@
+/**
+ * Chat channel account 管理服务。
+ *
+ * 关键点（中文）
+ * - 统一封装 agent 运行时下 chat channel account 的 CRUD 与探测。
+ * - 账号凭据只在写入路径接收明文；列表与读取路径返回脱敏结果。
+ * - city / vibecape 等上层产品都应直接复用这个实现，而不是各自维护副本。
+ */
+import crypto from "node:crypto";
+import { PlatformStore } from "../../../../shared/utils/store/index.js";
+import { resolveChatChannelBotInfo } from "../../../../service/builtins/chat/channels/BotInfoProvider.js";
+const SUPPORTED_CHANNELS = [
+    "telegram",
+    "feishu",
+    "qq",
+];
+function maskSecret(value) {
+    const raw = String(value || "").trim();
+    if (!raw)
+        return "";
+    if (raw.length <= 8)
+        return "***";
+    return `${raw.slice(0, 4)}***${raw.slice(-4)}`;
+}
+function assertChannel(input) {
+    const channel = String(input || "").trim().toLowerCase();
+    if (!SUPPORTED_CHANNELS.includes(channel)) {
+        throw new Error(`Unsupported channel: ${input}. Supported: ${SUPPORTED_CHANNELS.join(", ")}`);
+    }
+    return channel;
+}
+function normalizeOptionalText(value) {
+    const text = String(value || "").trim();
+    return text || undefined;
+}
+function normalizeChannelAccountIdToken(value) {
+    const token = String(value || "")
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "");
+    return token || "bot";
+}
+function pickFirstNonEmpty(inputs) {
+    for (const input of inputs) {
+        const text = String(input || "").trim();
+        if (text)
+            return text;
+    }
+    return "";
+}
+/**
+ * ChatChannelAccountService。
+ */
+export class ChatChannelAccountService {
+    /**
+     * 生成唯一 channel account id。
+     *
+     * 关键点（中文）
+     * - 账号 id 统一由系统生成，避免用户手填导致冲突或命名不一致。
+     * - 若碰撞则自动追加随机后缀重试。
+     */
+    async generateUniqueAccountId(params) {
+        const seed = normalizeChannelAccountIdToken(params.seed || "");
+        const prefix = `${params.channel}-${seed}`.slice(0, 36);
+        const store = new PlatformStore();
+        try {
+            for (let index = 0; index < 8; index += 1) {
+                const suffix = crypto.randomBytes(3).toString("hex");
+                const candidate = `${prefix}-${suffix}`.slice(0, 64);
+                const existing = await store.getChannelAccount(candidate);
+                if (!existing)
+                    return candidate;
+            }
+            return `${params.channel}-${Date.now().toString(36)}`;
+        }
+        finally {
+            store.close();
+        }
+    }
+    /**
+     * 探测 bot 凭据并返回自动填充信息。
+     */
+    async probe(input) {
+        const channel = assertChannel(input.channel);
+        const botInfo = await resolveChatChannelBotInfo({
+            channel,
+            credentials: {
+                botToken: normalizeOptionalText(input.botToken),
+                appId: normalizeOptionalText(input.appId),
+                appSecret: normalizeOptionalText(input.appSecret),
+                domain: normalizeOptionalText(input.domain),
+                sandbox: input.sandbox === true,
+            },
+        });
+        const accountId = await this.generateUniqueAccountId({
+            channel,
+            seed: pickFirstNonEmpty([
+                botInfo.idSeed,
+                botInfo.botUserId,
+                botInfo.identity,
+                botInfo.name,
+                "bot",
+            ]),
+        });
+        return {
+            channel,
+            accountId,
+            name: botInfo.name,
+            identity: botInfo.identity,
+            owner: botInfo.owner,
+            creator: botInfo.creator,
+            botUserId: botInfo.botUserId,
+            message: botInfo.message,
+        };
+    }
+    /**
+     * 使用凭据创建账号。
+     *
+     * 关键点（中文）
+     * - 默认先尝试探测 bot 信息，成功时自动填充名称与身份。
+     * - 探测失败但用户提供了名称时，仍允许先保存，便于后续排障。
+     */
+    async create(input) {
+        const channel = assertChannel(input.channel);
+        let probeResult = null;
+        if (input.probe !== false) {
+            try {
+                probeResult = await this.probe({
+                    channel,
+                    botToken: input.botToken,
+                    appId: input.appId,
+                    appSecret: input.appSecret,
+                    domain: input.domain,
+                    sandbox: input.sandbox,
+                });
+            }
+            catch (error) {
+                if (!normalizeOptionalText(input.name)) {
+                    throw error;
+                }
+            }
+        }
+        const id = probeResult?.accountId ||
+            (await this.generateUniqueAccountId({
+                channel,
+                seed: pickFirstNonEmpty([input.name, input.appId, "bot"]),
+            }));
+        const name = normalizeOptionalText(input.name) || probeResult?.name || `${channel} bot`;
+        await this.upsert({
+            id,
+            channel,
+            name,
+            identity: probeResult?.identity,
+            owner: probeResult?.owner,
+            creator: probeResult?.creator,
+            botToken: input.botToken,
+            appId: input.appId,
+            appSecret: input.appSecret,
+            domain: input.domain,
+            sandbox: input.sandbox,
+        });
+        return {
+            id,
+            probed: Boolean(probeResult),
+            message: probeResult?.message,
+        };
+    }
+    /**
+     * 列出账户池（脱敏）。
+     */
+    async list() {
+        const store = new PlatformStore();
+        try {
+            const rows = await store.listChannelAccounts();
+            return {
+                items: rows.map((item) => ({
+                    id: item.id,
+                    channel: item.channel,
+                    name: item.name,
+                    identity: item.identity,
+                    owner: item.owner,
+                    creator: item.creator,
+                    domain: item.domain,
+                    sandbox: item.sandbox === true,
+                    hasBotToken: !!String(item.botToken || "").trim(),
+                    hasAppId: !!String(item.appId || "").trim(),
+                    hasAppSecret: !!String(item.appSecret || "").trim(),
+                    botTokenMasked: item.botToken ? maskSecret(item.botToken) : undefined,
+                    appIdMasked: item.appId ? maskSecret(item.appId) : undefined,
+                    appSecretMasked: item.appSecret ? maskSecret(item.appSecret) : undefined,
+                    createdAt: item.createdAt,
+                    updatedAt: item.updatedAt,
+                })),
+            };
+        }
+        finally {
+            store.close();
+        }
+    }
+    /**
+     * 新增或更新账号。
+     */
+    async upsert(input) {
+        const id = String(input.id || "").trim();
+        if (!id)
+            throw new Error("channel account id cannot be empty");
+        const name = String(input.name || "").trim();
+        if (!name)
+            throw new Error("channel account name cannot be empty");
+        const channel = assertChannel(input.channel);
+        if (input.botToken !== undefined && input.clearBotToken === true) {
+            throw new Error("botToken and clearBotToken cannot be used together");
+        }
+        if (input.appId !== undefined && input.clearAppId === true) {
+            throw new Error("appId and clearAppId cannot be used together");
+        }
+        if (input.appSecret !== undefined && input.clearAppSecret === true) {
+            throw new Error("appSecret and clearAppSecret cannot be used together");
+        }
+        const store = new PlatformStore();
+        try {
+            const current = await store.getChannelAccount(id);
+            const nextBotToken = input.clearBotToken
+                ? undefined
+                : input.botToken !== undefined
+                    ? normalizeOptionalText(input.botToken)
+                    : current?.botToken;
+            const nextAppId = input.clearAppId
+                ? undefined
+                : input.appId !== undefined
+                    ? normalizeOptionalText(input.appId)
+                    : current?.appId;
+            const nextAppSecret = input.clearAppSecret
+                ? undefined
+                : input.appSecret !== undefined
+                    ? normalizeOptionalText(input.appSecret)
+                    : current?.appSecret;
+            const nextIdentity = Object.prototype.hasOwnProperty.call(input, "identity")
+                ? normalizeOptionalText(input.identity)
+                : current?.identity;
+            const nextOwner = Object.prototype.hasOwnProperty.call(input, "owner")
+                ? normalizeOptionalText(input.owner)
+                : current?.owner;
+            const nextCreator = Object.prototype.hasOwnProperty.call(input, "creator")
+                ? normalizeOptionalText(input.creator)
+                : current?.creator;
+            await store.upsertChannelAccount({
+                id,
+                channel,
+                name,
+                identity: nextIdentity,
+                owner: nextOwner,
+                creator: nextCreator,
+                botToken: nextBotToken,
+                appId: nextAppId,
+                appSecret: nextAppSecret,
+                domain: normalizeOptionalText(input.domain),
+                sandbox: input.sandbox === true,
+            });
+            return { id };
+        }
+        finally {
+            store.close();
+        }
+    }
+    /**
+     * 删除账号。
+     */
+    remove(idInput) {
+        const id = String(idInput || "").trim();
+        if (!id)
+            throw new Error("channel account id cannot be empty");
+        const store = new PlatformStore();
+        try {
+            store.removeChannelAccount(id);
+        }
+        finally {
+            store.close();
+        }
+    }
+}
+//# sourceMappingURL=ChannelAccountService.js.map

package/bin/service/builtins/chat/accounts/ChannelAccountService.js.map

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

package/bin/service/builtins/chat/channels/BaseChatChannel.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Chat channel 基类。
+ *
+ * 关键点（中文）
+ * - 通过 context 显式注入 runtime 依赖。
+ * - 统一注册 dispatcher，暴露 sendText/sendAction 能力。
+ * - 基类只保留授权、工具发送与入站编排；存储/队列细节已下沉到辅助模块。
+ */
+import type { ChatDispatchAction, ChatDispatchChannel, ChatDispatchSendActionParams } from "../../../../service/builtins/chat/types/ChatDispatcher.js";
+import type { Logger } from "../../../../shared/utils/logger/Logger.js";
+import type { AgentContext } from "../../../../agent/AgentContextTypes.js";
+import { type ChannelUserMessageMeta } from "./BaseChatChannelSupport.js";
+/**
+ * Channel chatKey 计算入参。
+ *
+ * 说明（中文）
+ * - chatId 必填；其余字段用于区分 topic/thread/消息上下文。
+ * - 不同平台可按需消费这些字段。
+ */
+export type ChannelChatKeyParams = {
+    chatId: string;
+    messageThreadId?: number;
+    chatType?: string;
+    messageId?: string;
+};
+export type ChannelSendTextParams = ChannelChatKeyParams & {
+    text: string;
+    replyToMessage?: boolean;
+};
+export type ChannelSendActionParams = ChannelChatKeyParams & {
+    action: ChatDispatchAction;
+    reactionEmoji?: string;
+    reactionIsBig?: boolean;
+};
+/**
+ * 入站消息统一结构（跨平台最小公共字段）。
+ *
+ * 说明（中文）
+ * - chatId 是平台原始会话标识（非 sessionId）。
+ * - messageThreadId 用于支持 topic / thread 细粒度并发。
+ * - 该结构只描述“接收侧”，不包含平台发送参数。
+ */
+export type IncomingChatMessage = {
+    chatId: string;
+    text: string;
+    chatType?: string;
+    messageId?: string;
+    messageThreadId?: number;
+    userId?: string;
+    username?: string;
+    /**
+     * 用户时区。
+     *
+     * 说明（中文）
+     * - 仅在上游显式提供时传入。
+     * - 第三方 IM 平台 bot 通常不会直接提供该字段。
+     */
+    userTimezone?: string;
+    /**
+     * 会话展示名（群名/频道名/私聊对象名）。
+     *
+     * 说明（中文）
+     * - 由各平台适配器 best-effort 提供。
+     * - 用于 Context 列表展示，不参与路由。
+     */
+    chatTitle?: string;
+    /**
+     * 入站附加元信息。
+     *
+     * 说明（中文）
+     * - 用于透传 reply 上下文等平台特有信息。
+     * - 会进入 history / context metadata，但不改变基础路由语义。
+     */
+    extra?: ChannelUserMessageMeta;
+};
+/**
+ * 入站授权判定输入。
+ */
+export type IncomingAuthorizationParams = {
+    chatId: string;
+    chatType?: string;
+    userId?: string;
+    username?: string;
+    chatTitle?: string;
+};
+/**
+ * 入站授权判定结果。
+ */
+export type IncomingAuthorizationResult = {
+    decision: "allow" | "block";
+    reason: string;
+};
+/**
+ * Chat channel 基类。
+ */
+export declare abstract class BaseChatChannel {
+    readonly channel: ChatDispatchChannel;
+    protected readonly context: AgentContext;
+    protected readonly rootPath: string;
+    protected readonly logger: Logger;
+    protected constructor(params: {
+        channel: ChatDispatchChannel;
+        context: AgentContext;
+    });
+    protected abstract getChatKey(params: ChannelChatKeyParams): string;
+    protected abstract sendTextToPlatform(params: ChannelSendTextParams): Promise<void>;
+    protected sendActionToPlatform?(params: ChannelSendActionParams): Promise<void>;
+    /**
+     * 发送授权提示文本。
+     *
+     * 关键点（中文）
+     * - 一律按普通消息发送，不挂 reply，避免把“权限提示”误挂到某条消息下面。
+     */
+    protected sendAuthorizationText(params: {
+        chatId: string;
+        text: string;
+        chatType?: string;
+        messageThreadId?: number;
+    }): Promise<void>;
+    /**
+     * 记录入站观测主体。
+     */
+    protected observeIncomingAuthorization(params: IncomingAuthorizationParams): Promise<void>;
+    /**
+     * 执行入站授权判定。
+     */
+    protected evaluateIncomingAuthorization(params: IncomingAuthorizationParams): Promise<IncomingAuthorizationResult>;
+    /**
+     * 生成未授权提示文案。
+     */
+    protected buildUnauthorizedBlockedText(params?: {
+        userId?: string;
+        chatId?: string;
+        chatType?: string;
+    }): string;
+    /**
+     * 是否在 `sendToolText` 成功后自动写入 outbound chat history。
+     *
+     * 关键点（中文）
+     * - 默认开启，覆盖 QQ / Feishu 等未自行写 outbound history 的渠道。
+     * - 已有独立 outbound 落盘逻辑的渠道（如 Telegram）应覆写为 false，避免重复记录。
+     */
+    protected shouldAppendOutboundHistoryOnSend(): boolean;
+    /**
+     * 供工具层调用的文本发送统一入口。
+     *
+     * 设计点（中文）
+     * - 空 chatId 视为参数错误。
+     * - 空文本视为幂等 no-op（返回 success）。
+     * - 平台异常收敛为 `{ success: false, error }`，避免抛出破坏工具协议。
+     */
+    sendToolText(params: ChannelSendTextParams): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 供工具层调用的动作发送入口（如 typing）。
+     *
+     * 设计点（中文）
+     * - action 可选，缺失时按 no-op 处理。
+     * - 若平台未实现 sendActionToPlatform，返回明确 not supported。
+     */
+    sendToolAction(params: ChatDispatchSendActionParams): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 清理某个 sessionId 对应的 agent 会话状态。
+     *
+     * 说明（中文）
+     * - 只清理 runtime / context 层状态，不直接删历史文件。
+     * - 常用于用户触发“重置对话”类命令。
+     */
+    clearChat(sessionId: string): void;
+    /**
+     * 按渠道目标清理会话（映射到内部 sessionId）。
+     */
+    protected clearChatByTarget(params: ChannelChatKeyParams): Promise<void>;
+    /**
+     * 入站消息写入队列（审计用途，不触发执行）。
+     */
+    protected enqueueAuditMessage(params: {
+        chatId: string;
+        messageId?: string;
+        userId?: string;
+        text: string;
+        meta?: ChannelUserMessageMeta;
+    }): Promise<void>;
+    /**
+     * 将消息送入会话调度器队列。
+     *
+     * 返回值语义（中文）
+     * - chatKey: lane 归属键（同 key 串行）。
+     * - position: 当前 lane 中排队位置（便于日志与观测）。
+     */
+    protected enqueueMessage(msg: IncomingChatMessage): Promise<{
+        chatKey: string;
+        position: number;
+    }>;
+}
+//# sourceMappingURL=BaseChatChannel.d.ts.map

package/bin/service/builtins/chat/channels/BaseChatChannel.d.ts.map

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