@tencent-ai/agent-sdk 0.3.252 → 0.3.253

package/cli/dist-server/types/node/remote-control/clients/wecom-bot/wecom-bot-interaction.d.ts

@@ -1,142 +0,0 @@
-/**
- * WeCom template-card adapter for interactive tools.
- *
- * Tools (permission adapter / AskUserQuestion / prompt suggestion) stay unchanged.
- * This module converts their prompts into vote_interaction cards so options stay
- * a vertical list. WeCom lays button_interaction actions in one row and squeezes
- * the labels; vote_interaction does not.
- *
- * Send card: https://developer.work.weixin.qq.com/document/path/101032
- * Update card: https://developer.work.weixin.qq.com/document/path/94888
- * Click event: event.template_card_event.{task_id,event_key,selected_items}
- */
-/** vote_interaction 没有 sub_title_text，命令参数只能放 main_title.desc。 */
-export declare const WECOM_VOTE_DESC_MAX = 160;
-/** Official vote_interaction option_list cap. */
-export declare const WECOM_ASK_OPTION_MAX = 20;
-export declare const WECOM_CARD_TYPE_BUTTON = "button_interaction";
-export declare const WECOM_CARD_TYPE_VOTE = "vote_interaction";
-export declare const WECOM_INTERACTION_QUESTION_KEY = "choice";
-export declare const WECOM_INTERACTION_KEY: {
-    readonly ALLOW: 'allow';
-    readonly DENY: 'deny';
-    readonly ALLOW_ALWAYS: 'allow_always';
-    readonly EXIT_PLAN: 'deny_and_exit_plan';
-    readonly SUGGEST_YES: 'suggest_yes';
-    readonly SUGGEST_NO: 'suggest_no';
-    readonly SUBMIT: 'submit';
-    readonly ASK_SUBMIT: 'ask_submit';
-};
-export type WecomInteractionKey = (typeof WECOM_INTERACTION_KEY)[keyof typeof WECOM_INTERACTION_KEY];
-export interface WecomTemplateCardButton {
-    text: string;
-    style: 1 | 2 | 3 | 4;
-    key: string;
-}
-export interface WecomButtonCard {
-    card_type: typeof WECOM_CARD_TYPE_BUTTON;
-    main_title: {
-        title: string;
-        desc?: string;
-    };
-    sub_title_text?: string;
-    button_list: WecomTemplateCardButton[];
-    task_id: string;
-    replace_text?: string;
-}
-export interface WecomVoteOption {
-    id: string;
-    text: string;
-    is_checked?: boolean;
-}
-export interface WecomVoteCard {
-    card_type: typeof WECOM_CARD_TYPE_VOTE;
-    main_title: {
-        title: string;
-        desc?: string;
-    };
-    sub_title_text?: string;
-    checkbox: {
-        question_key: string;
-        option_list: WecomVoteOption[];
-        mode: 0 | 1;
-        disable?: boolean;
-    };
-    submit_button: {
-        text: string;
-        key: string;
-    };
-    task_id: string;
-    replace_text?: string;
-}
-export type WecomTemplateCard = WecomVoteCard | WecomButtonCard;
-export interface WecomCardClick {
-    taskId: string;
-    eventKey: string;
-    reqId: string;
-    chatid?: string;
-    chattype?: string;
-    userid?: string;
-    selectedOptionIds?: string[];
-}
-export declare function isWecomVoteCard(card: WecomTemplateCard): card is WecomVoteCard;
-export declare function isWecomSubmitKey(key: string): boolean;
-export declare function sanitizeWecomTaskId(raw: string): string;
-export declare function clipWecomCardText(text: string, max: number): string;
-export declare function askOptionKey(index: number): string;
-export declare function parseAskOptionKey(key: string): number | undefined;
-export declare function interactionOptionText(option: {
-    label: string;
-    description?: string;
-}): string;
-export declare function parseSelectedOptionIds(source: unknown): string[];
-export declare function clickActionKeys(click: WecomCardClick): string[];
-export declare function buildVoteInteractionCard(input: {
-    taskId: string;
-    title: string;
-    desc?: string;
-    questionKey?: string;
-    multiSelect?: boolean;
-    options: Array<{
-        id: string;
-        text: string;
-        checked?: boolean;
-    }>;
-    submitKey?: string;
-    submitText?: string;
-    disable?: boolean;
-    replaceText?: string;
-}): WecomVoteCard;
-export declare function buildPermissionCard(input: {
-    taskId: string;
-    body: string;
-    exitPlan: boolean;
-    toolName?: string;
-}): WecomVoteCard;
-export declare function formatAskSelectedAnswer(options: Array<{
-    label: string;
-}>, selected: number[]): string;
-export declare function buildAskQuestionCard(input: {
-    taskId: string;
-    question: string;
-    header?: string;
-    options: Array<{
-        label: string;
-        description?: string;
-    }>;
-    index: number;
-    total: number;
-    multiSelect?: boolean;
-    selected?: number[];
-}): WecomVoteCard;
-export declare function buildSuggestionCard(input: {
-    taskId: string;
-    suggestion: string;
-}): WecomVoteCard;
-export declare function buildResolvedCard(input: {
-    taskId: string;
-    title: string;
-    desc?: string;
-}): WecomVoteCard;
-export declare function parseTemplateCardClick(payload: unknown, reqId: string): WecomCardClick | undefined;
-export declare function permissionBehaviorFromKey(key: string, exitPlan: boolean): 'allow' | 'allow_always' | 'deny' | 'deny_and_exit_plan' | undefined;

package/cli/dist-server/types/node/remote-control/clients/wecom-bot/wecom-bot-live.d.ts

@@ -1,78 +0,0 @@
-/**
- * One aibot_msg_callback → many stream.id bubbles on the same req_id.
- * Streams assistant text only. Tool and sub-agent activity stay off WeCom.
- */
-interface Bindable {
-    subscribe: (listener: (event: unknown) => void) => {
-        unsubscribe: () => void;
-    };
-}
-export interface WecomStreamTransport {
-    open(reqId: string, streamId: string): Promise<void>;
-    push(reqId: string, streamId: string, content: string, finish: boolean): Promise<void>;
-}
-export declare function isRealWecomAssistantText(text: string | undefined | null): boolean;
-export declare function wecomCanonicalTextDelta(event: unknown): string;
-/**
- * WeCom mobile treats a later frame as "old + suffix" and appends the suffix
- * as a new line. Intermediate frames start with an alternating blank-looking
- * mark so the next full replace is not a prefix of the last displayed snapshot.
- * finish=true must keep that same marked snapshot — a clean body is treated as
- * a shorter replace and the bubble loses the rest of the text.
- */
-export declare function wecomStreamWireContent(text: string, finish: boolean, generation?: number): string;
-export declare class WecomBotLive {
-    readonly reqId: string;
-    readonly streamId: string;
-    private readonly transport;
-    private readonly minIntervalMs;
-    private acc;
-    private overflow;
-    private bound;
-    private closed;
-    private finished;
-    private sealed;
-    private needBreak;
-    private flip;
-    private lastPushAt;
-    private lastPushed;
-    private lastWire;
-    private timer;
-    private segmentTimer;
-    private sub?;
-    private currentStreamId;
-    private segmentChain;
-    private rotating;
-    constructor(reqId: string, streamId: string, transport: WecomStreamTransport, minIntervalMs?: number);
-    /** Wait for in-flight bubble commits. Tests use this after a segment break. */
-    whenIdle(): Promise<void>;
-    get text(): string;
-    get hasText(): boolean;
-    get isSealed(): boolean;
-    /** First frame. Must be invoked before any inbound await, then awaited before bind. */
-    open(): Promise<void>;
-    bind(subject: Bindable, _input?: Bindable, _phase?: Bindable): void;
-    /** Stop receiving tokens. Allows a later bind after a superseded run. */
-    detach(): void;
-    /** Final unbind. Remaining model frames are dropped so the next live does not see them. */
-    close(): void;
-    ingest(event: unknown): void;
-    /**
-     * Close the current stream bubble so a template card can appear below it.
-     * Later assistant tokens are buffered and sent as a new message.
-     */
-    sealForInteraction(placeholder?: string): Promise<void>;
-    takeOverflow(): string;
-    finish(): Promise<boolean>;
-    private schedulePush;
-    private flush;
-    private emitFrame;
-    private runSerial;
-    private scheduleSegmentCommit;
-    private commitCurrentSegment;
-    private clearSegmentTimer;
-    private commitArticleIfNeeded;
-    private commitBubble;
-    private ingestOverflow;
-}
-export {};

package/cli/dist-server/types/node/remote-control/clients/wecom-bot/wecom-bot-media.d.ts

@@ -1,35 +0,0 @@
-/**
- * WeCom AI Bot Media Handler
- *
- * Handles media download for WeCom AI Bot WebSocket messages.
- *
- * WeCom AI Bot message media fields:
- *   - image: { url: string; aeskey: string }
- *   - voice: { url: string; aeskey: string }
- *   - file:  { url: string; aeskey: string; filename: string }
- *
- * Download flow: validate URL (SSRF allowlist) → fetch → detect/decrypt → save to temp file
- *
- * Decryption algorithm aligned with @wecom/aibot-node-sdk `decryptFile`:
- *   - Algorithm: AES-256-CBC
- *   - Key: Base64-decoded aeskey (32 bytes)
- *   - IV: first 16 bytes of the decoded key
- *   - Padding: PKCS#7 with 32-byte block size (manual removal)
- */
-/**
- * Download a WeCom AI Bot media file to a local temp file.
- *
- * Strategy:
- *   1. Validate URL against SSRF allowlist (https + WeCom domains)
- *   2. Fetch the raw data from the URL
- *   3. If the raw data is already a valid image (magic bytes), save it directly
- *   4. Otherwise, attempt AES-256-CBC decryption with aeskey
- *   5. Auto-correct file extension based on detected format
- *   6. Fallback: save raw data as-is (when no aeskey or decryption produces empty result)
- *
- * @param url - Media download URL from the message callback
- * @param aeskey - AES key for decryption (base64 encoded, 32 bytes when decoded)
- * @param extension - File extension including dot (e.g. '.jpg', '.silk')
- * @returns Path to the saved local file
- */
-export declare function downloadWecomBotMedia(url: string, aeskey: string | undefined, extension: string): Promise<string>;

package/cli/dist-server/types/node/remote-control/clients/wecom-bot/wecom-bot-qr-bind.d.ts

@@ -1,49 +0,0 @@
-/**
- * WeCom AI Bot QR bind — same pairing page as @wecom/wecom-openclaw-cli.
- *
- * 不依赖那个 CLI 包：它的 scanQRCodeForBotInfo 会在超时后 process.exit。
- * 出码 / 轮询协议与 dist/utils/qrcode.js 一致。
- *
- * 1. GET /ai/qc/generate?source=wecom-cli&plat= → { scode, auth_url }
- * 2. 把 auth_url 画成二维码，企业微信扫开后一键建机器人
- * 3. GET /ai/qc/query_result?scode= → success 时回传 botid / secret
- */
-import type { QRAuthStatus } from '../../remote-control-protocol';
-import type { WecomBotCredentials } from './wecom-bot-auth';
-export declare const WECOM_QR_BIND_ORIGIN = "https://work.weixin.qq.com";
-/** 企微给 OpenClaw CLI 开的配对来源；换 source 会出不了码。 */
-export declare const WECOM_QR_BIND_SOURCE = "wecom-cli";
-export declare const WECOM_QR_BIND_POLL_INTERVAL_MS = 3000;
-export declare const WECOM_QR_BIND_TIMEOUT_MS: number;
-export interface WecomQrBindSession {
-    scode: string;
-    authUrl: string;
-}
-export interface WecomQrBindHttp {
-    (url: string): Promise<unknown>;
-}
-export interface WecomQrBindDeps {
-    fetchJson?: WecomQrBindHttp;
-    renderQr?: (url: string) => Promise<string>;
-    sleep?: (ms: number) => Promise<void>;
-    now?: () => number;
-    platform?: NodeJS.Platform;
-}
-export interface PerformWecomQrBindOptions extends WecomQrBindDeps {
-    onStatus: (status: QRAuthStatus) => void;
-    resolveManual?: () => WecomBotCredentials | undefined;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-    /** generate 失败时展示的兜底文案（手填说明），不画码。 */
-    manualFallbackMessage?: string;
-}
-export declare function wecomQrBindPlatCode(platform?: NodeJS.Platform): number;
-export declare function wecomQrGenerateUrl(platform?: NodeJS.Platform): string;
-export declare function wecomQrQueryUrl(scode: string): string;
-export declare function wecomQrPageUrl(scode: string): string;
-export declare function parseWecomQrGeneratePayload(payload: unknown): WecomQrBindSession;
-export declare function parseWecomQrQueryPayload(payload: unknown): WecomBotCredentials | 'pending';
-export declare function requestWecomQrBindSession(deps?: WecomQrBindDeps): Promise<WecomQrBindSession>;
-export declare function queryWecomQrBindResult(scode: string, deps?: WecomQrBindDeps): Promise<WecomBotCredentials | 'pending'>;
-export declare function performWecomQrBind(options: PerformWecomQrBindOptions): Promise<WecomBotCredentials | undefined>;

package/cli/dist-server/types/node/remote-control/clients/wecom-bot/wecom-bot-respond-queue.d.ts

@@ -1,33 +0,0 @@
-/**
- * Serial aibot_respond_msg per callback req_id.
- *
- * Official SDK: send one frame, wait for errcode, then send the next.
- * Same stream.id coalesces to the latest full replace. finish=true seals that
- * stream.id only — a new stream.id on the same req_id is a new chat bubble.
- */
-import { type WecomBotWsFrame, type WecomBotWsResponse } from './wecom-bot-types';
-export interface WecomRespondJob {
-    reqId: string;
-    streamId: string;
-    content: string;
-    finish: boolean;
-}
-export declare class WecomRespondQueue {
-    private readonly send;
-    private readonly timeoutMs;
-    private readonly logger?;
-    private seq;
-    private readonly inFlight;
-    private readonly queues;
-    /** Late ack after timeout must not complete the next in-flight frame. */
-    private readonly staleAck;
-    /** finish=true seals one stream.id, not the whole req_id. */
-    private readonly sealed;
-    constructor(send: (frame: WecomBotWsFrame) => void, timeoutMs?: number, logger?: {
-        warn(msg: string): void;
-    } | undefined);
-    enqueue(job: WecomRespondJob): Promise<void>;
-    handleAck(reqId: string, response: WecomBotWsResponse): boolean;
-    dispose(): void;
-    private pump;
-}

package/cli/dist-server/types/node/remote-control/clients/wecom-bot/wecom-bot-types.d.ts

@@ -1,207 +0,0 @@
-/**
- * WeChat Work AI Bot WebSocket API Types
- *
- * Type definitions for the enterprise WeChat AI Bot WebSocket long connection API.
- * Reference: https://developer.work.weixin.qq.com/document/path/101463
- */
-/** Generic WebSocket frame structure */
-export interface WecomBotWsFrame {
-    cmd: string;
-    headers: {
-        req_id: string;
-        [key: string]: string;
-    };
-    body: unknown;
-}
-/** Subscribe request (cmd: 'aibot_subscribe') */
-export interface WecomBotSubscribeFrame extends WecomBotWsFrame {
-    cmd: 'aibot_subscribe';
-    body: {
-        bot_id: string;
-        secret: string;
-    };
-}
-/** Message callback (cmd: 'aibot_msg_callback') */
-export interface WecomBotMsgCallback extends WecomBotWsFrame {
-    cmd: 'aibot_msg_callback';
-    body: {
-        msgid: string;
-        aibotid: string;
-        chatid: string;
-        chattype: 'group' | 'single';
-        from: {
-            userid: string;
-        };
-        msgtype: 'text' | 'image' | 'mixed' | 'voice' | 'file';
-        text?: {
-            content: string;
-        };
-        image?: {
-            url: string;
-            aeskey: string;
-        };
-        /**
-         * mixed 消息结构（实测，2026-04-28 诊断日志确认）：
-         * {
-         *   msg_item: [
-         *     { msgtype: 'image', image: { url, aeskey } },
-         *     { msgtype: 'text', text: { content: '...' } },
-         *     // 还可能是 voice/file
-         *   ]
-         * }
-         * 注意：此前错写为 `items: [{type, content}]`，实际字段名是 `msg_item`，
-         *   子项字段是 `msgtype`，内容嵌套在 `sub[msgtype]` 下（和顶层 body 同结构）。
-         */
-        mixed?: {
-            msg_item: Array<{
-                msgtype: 'text';
-                text: {
-                    content: string;
-                };
-            } | {
-                msgtype: 'image';
-                image: {
-                    url: string;
-                    aeskey: string;
-                };
-            } | {
-                msgtype: 'voice';
-                voice: {
-                    url: string;
-                    aeskey: string;
-                };
-            } | {
-                msgtype: 'file';
-                file: {
-                    url: string;
-                    aeskey: string;
-                    filename: string;
-                };
-            }>;
-        };
-        voice?: {
-            url: string;
-            aeskey: string;
-        };
-        file?: {
-            url: string;
-            aeskey: string;
-            filename: string;
-        };
-    };
-}
-/** Event callback (cmd: 'aibot_event_callback') */
-export interface WecomBotEventCallback extends WecomBotWsFrame {
-    cmd: 'aibot_event_callback';
-    body: {
-        msgid: string;
-        create_time: number;
-        aibotid: string;
-        from: {
-            userid: string;
-        };
-        chatid?: string;
-        chattype?: 'group' | 'single';
-        msgtype: 'event';
-        event: {
-            eventtype: 'enter_chat' | 'template_card_event' | 'feedback_event' | 'disconnected_event';
-            event_key?: string;
-            task_id?: string;
-            template_card_event?: {
-                card_type?: string;
-                event_key?: string;
-                task_id?: string;
-            };
-            [key: string]: unknown;
-        };
-    };
-}
-/** Stream reply frame (cmd: 'aibot_respond_msg') */
-export interface WecomBotRespondMsgFrame extends WecomBotWsFrame {
-    cmd: 'aibot_respond_msg';
-    body: {
-        msgtype: 'stream';
-        stream: {
-            id: string;
-            finish: boolean;
-            content: string;
-        };
-    };
-}
-/** Welcome message frame (cmd: 'aibot_respond_welcome_msg') */
-export interface WecomBotWelcomeMsgFrame extends WecomBotWsFrame {
-    cmd: 'aibot_respond_welcome_msg';
-    body: {
-        msgtype: 'text';
-        text: {
-            content: string;
-        };
-    };
-}
-/** Proactive push frame (cmd: 'aibot_send_msg') */
-export interface WecomBotSendMsgFrame extends WecomBotWsFrame {
-    cmd: 'aibot_send_msg';
-    body: {
-        chatid: string;
-        chat_type: number;
-        msgtype: 'markdown' | 'template_card';
-        markdown?: {
-            content: string;
-        };
-        template_card?: Record<string, unknown>;
-    };
-}
-/** Update a template card after a click (cmd: 'aibot_respond_update_msg') */
-export interface WecomBotUpdateMsgFrame extends WecomBotWsFrame {
-    cmd: 'aibot_respond_update_msg';
-    body: {
-        response_type: 'update_template_card';
-        /** 94888 更新按钮为不可点击状态 */
-        button?: {
-            replace_name: string;
-        };
-        template_card: Record<string, unknown>;
-    };
-}
-/** Heartbeat frame (cmd: 'ping') */
-export interface WecomBotPingFrame extends WecomBotWsFrame {
-    cmd: 'ping';
-    body: Record<string, never>;
-}
-/** Generic WebSocket response (for subscribe/ping/send acks) */
-export interface WecomBotWsResponse {
-    headers: {
-        req_id: string;
-    };
-    errcode: number;
-    errmsg: string;
-}
-export declare const WECOM_BOT_WS_URL = "wss://openws.work.weixin.qq.com";
-export declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000;
-export declare const DEFAULT_MAX_RECONNECT_DELAY_MS = 60000;
-export declare const DEFAULT_DEDUP_WINDOW_SIZE = 1000;
-export declare const STREAM_TIMEOUT_MS: number;
-/** Official thinking animation: empty `<think>` tags render as three bouncing dots. */
-export declare const WECOM_STREAM_THINK = "<think></think>";
-/** Same req_id must wait for errcode; 400ms keeps the bubble from sticking on the first frame. */
-export declare const STREAM_REPLY_ACK_TIMEOUT_MS = 400;
-/**
- * Alternating leading marks on intermediate frames. WeCom strips ZW / trailing
- * cursors then treats a later frame as "old + suffix" and inserts a newline.
- * Changing the first character makes consecutive full-text frames fail that check.
- * Block cursors (▌/▍) survived the strip but stayed visible after finish; use
- * two blank-looking spaces that CJK fonts have and WeCom does not treat as ZW.
- */
-export declare const WECOM_STREAM_MARK_A = "\u3000";
-export declare const WECOM_STREAM_MARK_B = "\u00A0";
-export declare const WECOM_STREAM_MARK_RE: RegExp;
-/** Intermediate stream frames are coalesced; finish still flushes immediately. */
-export declare const WECOM_STREAM_PUSH_INTERVAL_MS = 80;
-/**
- * Wait after response_done so late tokens of the same response still join this
- * bubble. A later model response is hundreds of ms away; trailing deltas are not.
- */
-export declare const WECOM_SEGMENT_GRACE_MS = 160;
-export declare const ENV_KEY_WECOM_BOT_ID = "CODEBUDDY_WECOM_BOT_ID";
-export declare const ENV_KEY_WECOM_BOT_SECRET = "CODEBUDDY_WECOM_BOT_SECRET";
-export declare const ENV_KEY_WECOM_BOT_WS_URL = "CODEBUDDY_WECOM_BOT_WS_URL";