@downcity/agent 1.1.35 → 1.1.43

package/bin/plugin/builtins/chat/accounts/ChannelAccountManager.js

@@ -1,258 +0,0 @@
-/**
- * Chat channel account 管理器。
- *
- * 关键点（中文）
- * - 统一封装 agent 运行时下 chat channel account 的 CRUD 与探测。
- * - 账号凭据只在写入路径接收明文；列表与读取路径返回脱敏结果。
- * - city / vibecape 等上层产品都应直接复用这个实现，而不是各自维护副本。
- */
-import crypto from "node:crypto";
-import { resolveChatChannelBotInfo } from "../../../../plugin/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 "";
-}
-/**
- * ChatChannelAccountManager。
- */
-export class ChatChannelAccountManager {
-    platform;
-    constructor(platform) {
-        this.platform = platform;
-    }
-    /**
-     * 生成唯一 channel account id。
-     *
-     * 关键点（中文）
-     * - 账号 id 统一由系统生成，避免用户手填导致冲突或命名不一致。
-     * - 若碰撞则自动追加随机后缀重试。
-     */
-    async generateUniqueAccountId(params) {
-        const seed = normalizeChannelAccountIdToken(params.seed || "");
-        const prefix = `${params.channel}-${seed}`.slice(0, 36);
-        for (let index = 0; index < 8; index += 1) {
-            const suffix = crypto.randomBytes(3).toString("hex");
-            const candidate = `${prefix}-${suffix}`.slice(0, 64);
-            const existing = this.platform.getChannelAccount(candidate);
-            if (!existing)
-                return candidate;
-        }
-        return `${params.channel}-${Date.now().toString(36)}`;
-    }
-    /**
-     * 探测 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 list = this.platform.listChannelAccounts;
-        if (!list) {
-            throw new Error("Channel account listing is not available in this runtime");
-        }
-        return {
-            items: await list(),
-        };
-    }
-    /**
-     * 新增或更新账号。
-     */
-    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 current = this.platform.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;
-        const updateChannelAccount = this.platform.updateChannelAccount;
-        if (!updateChannelAccount) {
-            throw new Error("Channel account update is not available in this runtime");
-        }
-        await updateChannelAccount({
-            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 };
-    }
-    /**
-     * 删除账号。
-     */
-    async remove(idInput) {
-        const id = String(idInput || "").trim();
-        if (!id)
-            throw new Error("channel account id cannot be empty");
-        const removeChannelAccount = this.platform.removeChannelAccount;
-        if (!removeChannelAccount) {
-            throw new Error("Channel account removal is not available in this runtime");
-        }
-        await removeChannelAccount(id);
-    }
-}
-//# sourceMappingURL=ChannelAccountManager.js.map

package/bin/plugin/builtins/chat/accounts/ChannelAccountManager.js.map

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

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

@@ -1,201 +0,0 @@
-/**
- * Chat channel 基类。
- *
- * 关键点（中文）
- * - 通过 context 显式注入 runtime 依赖。
- * - 统一注册 dispatcher，暴露 sendText/sendAction 能力。
- * - 基类只保留授权、工具发送与入站编排；存储/队列细节已下沉到辅助模块。
- */
-import type { ChatDispatchAction, ChatDispatchChannel, ChatDispatchSendActionParams } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
-import type { Logger } from "../../../../utils/logger/Logger.js";
-import type { AgentContext } from "../../../../core/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/plugin/builtins/chat/channels/BaseChatChannel.d.ts.map

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