@tencent-ai/agent-sdk 0.3.252 → 0.3.253

package/cli/dist-server/types/node/plugins/plugin-policy-service.d.ts

@@ -1,53 +0,0 @@
-import { Event, Logger } from '@celljs/core';
-import { BuiltInMarketPluginMerge } from '@genie/product';
-/**
- * 插件策略服务
- * 通过 builtInMarketPluginsMerge（由 Unleash 远程下发）控制插件的权限
- *
- * 职责：纯策略查询服务，不执行安装/卸载操作
- * 策略执行由 PluginManager 负责
- */
-export declare const PluginPolicyServiceSymbol: unique symbol;
-export interface PluginPolicyService {
-    /** 策略变更事件 */
-    readonly onDidChange: Event<void>;
-    /** 获取所有合并插件策略 */
-    getMergedPlugins(): BuiltInMarketPluginMerge[];
-    /** 获取指定插件的合并策略 */
-    getMergedPlugin(pluginId: string): BuiltInMarketPluginMerge | undefined;
-    /** 插件是否不可删除 */
-    isPluginCannotRemove(pluginId: string): boolean;
-    /** 插件是否不可禁用 */
-    isPluginCannotSwitchoff(pluginId: string): boolean;
-    /** 插件是否不可编辑 */
-    isPluginCannotEdit(pluginId: string): boolean;
-    /** 插件是否需要自动安装（存在于 merge 列表中） */
-    isPluginAutoInstall(pluginId: string): boolean;
-    /** 市场是否被策略阻止（预留扩展） */
-    isMarketplaceBlockedByPolicy(marketplaceName: string): boolean;
-}
-export declare class PluginPolicyServiceImpl implements PluginPolicyService {
-    protected readonly logger: Logger;
-    /** 当前生效的合并插件策略 */
-    private mergedPlugins;
-    /** 策略变更事件发射器 */
-    private readonly onDidChangeEmitter;
-    readonly onDidChange: Event<void>;
-    protected init(): void;
-    /**
-     * 从产品配置加载合并插件策略
-     * 包含格式校验 + 深比较变更检测
-     */
-    private loadPolicies;
-    /**
-     * 深比较两个策略 Map 是否有差异
-     */
-    private hasPluginsChanged;
-    getMergedPlugins(): BuiltInMarketPluginMerge[];
-    getMergedPlugin(pluginId: string): BuiltInMarketPluginMerge | undefined;
-    isPluginCannotRemove(pluginId: string): boolean;
-    isPluginCannotSwitchoff(pluginId: string): boolean;
-    isPluginCannotEdit(pluginId: string): boolean;
-    isPluginAutoInstall(pluginId: string): boolean;
-    isMarketplaceBlockedByPolicy(_marketplaceName: string): boolean;
-}

package/cli/dist-server/types/node/plugins/plugin-validator.d.ts

@@ -1,48 +0,0 @@
-import { PluginValidator as IPluginValidator } from './plugin-protocol';
-export interface ValidationError {
-    path: string;
-    message: string;
-}
-export interface ValidationResult {
-    success: boolean;
-    errors: ValidationError[];
-    warnings: ValidationError[];
-    filePath: string;
-    fileType: 'plugin' | 'marketplace';
-}
-/**
- * 清单验证失败错误
- */
-export declare class ManifestValidationError extends Error {
-    filePath: string;
-    validationResult: ValidationResult;
-    constructor(message: string, filePath: string, validationResult: ValidationResult);
-}
-/**
- * 插件验证器实现
- * 负责验证插件和市场清单文件的有效性
- */
-export declare class PluginValidatorImpl implements IPluginValidator {
-    /**
-     * 验证插件或市场清单
-     * @param inputPath 文件或目录路径
-     */
-    validateManifest(inputPath: string): Promise<ValidationResult>;
-    /**
-     * 验证目录中的清单文件
-     */
-    private validateDirectory;
-    /**
-     * 验证文件
-     */
-    private validateFile;
-    /**
-     * 验证插件清单文件
-     */
-    private validatePluginManifestFile;
-    /**
-     * 验证市场清单文件
-     */
-    private validateMarketplaceManifestFile;
-    private validateDependencies;
-}

package/cli/dist-server/types/node/plugins/zip-utils.d.ts

@@ -1,93 +0,0 @@
-import * as http from 'http';
-/**
- * 从 zip URL 里提取 UUID 版本号，用于内置市场更新检查。
- *
- * 命中规则：URL basename 必须是 `<name>-<UUID>.zip`，UUID 形如
- *     `cb_teams_marketplace-e4456ec2-6d1a-4af9-86a9-83a4bea4bbda.zip`
- * 只接受标准 UUID v4 字面量（8-4-4-4-12），不做其他兜底解析；解析失败返回
- * `null`，由调用方决定是否走 ETag 兜底。
- *
- * 外部更新调度与 CLI checker 必须共用本函数；同一个 URL 若被解析成不同版本，
- * 两层更新判据会出现无限震荡。
- */
-export declare function parseVersionFromUrl(url: string): string | null;
-/**
- * ZIP metadata persisted after a successful install/update.
- * Used to decide whether a remote source has new content without re-downloading the archive.
- */
-export interface ZipMetadata {
-    /** Source URL or local file path this archive came from. */
-    url: string;
-    /** Last-Modified header value returned by the server (or local file mtime). */
-    lastModified?: string;
-    /** ETag header value returned by the server. */
-    etag?: string;
-    /** ISO timestamp of when this archive was downloaded. */
-    downloadedAt: string;
-    /**
-     * Indicates the install/extract step finished without error.
-     * Absent on legacy metadata, which we treat as "unverified" and trigger re-download.
-     */
-    installComplete?: boolean;
-}
-/** Headers captured from a successful download response. */
-export interface DownloadResult {
-    lastModified?: string;
-    etag?: string;
-}
-/** Result of a freshness check against a remote (or local) archive source. */
-export interface ZipUpdateCheckResult {
-    needsUpdate: boolean;
-    lastModified?: string;
-    etag?: string;
-}
-/** Resolve the metadata path for a given install location. */
-export declare function getMetadataPath(installLocation: string): string;
-/** Read metadata if it exists; returns undefined on any read/parse error. */
-export declare function readZipMetadata(installLocation: string): Promise<ZipMetadata | undefined>;
-/** Write metadata to the install location. */
-export declare function writeZipMetadata(installLocation: string, metadata: ZipMetadata): Promise<void>;
-/** A "local file path" is anything that isn't an HTTP or HTTPS URL. */
-export declare function isLocalFilePath(source: string): boolean;
-/** Detect whether a URL points to a ZIP/TGZ/TAR.GZ archive by extension. */
-export declare function isZipUrl(url: string): boolean;
-/**
- * Fetch headers via HEAD request, following up to `maxRedirects` redirects.
- * Some hosts (e.g. git archive URLs) reject HEAD; callers should fall back to
- * treating that as "needs update" rather than a hard failure.
- */
-export declare function getRemoteHeaders(url: string, maxRedirects?: number): Promise<http.IncomingHttpHeaders>;
-/**
- * Fetch a small UTF-8 text resource with bounded connect/read time and
- * redirect handling. Used for Product-declared marketplace version metadata.
- */
-export declare function fetchText(url: string, timeoutMs?: number, maxRedirects?: number): Promise<string>;
-/**
- * Download `url` to `destPath`, handling HTTP redirects.
- * Returns the ETag / Last-Modified headers so the caller can persist them for future freshness checks.
- */
-export declare function downloadFile(url: string, destPath: string, maxRedirects?: number): Promise<DownloadResult>;
-/** Copy a local archive to a destination path; mirrors downloadFile's return shape. */
-export declare function copyLocalFile(sourcePath: string, destPath: string): Promise<DownloadResult>;
-/**
- * Decide whether a remote ZIP needs to be re-downloaded by comparing ETag/Last-Modified.
- *
- * The precedence mirrors `agent-craft`'s implementation:
- *   1. No existing metadata → update (first install)
- *   2. `installComplete` flag missing → update (legacy or interrupted install)
- *   3. URL changed → update
- *   4. ETag available on both sides → trust ETag equality
- *   5. Last-Modified available on both sides → compare timestamps
- *   6. HEAD request failed or server returns neither header → update (safe default)
- */
-export declare function checkZipNeedsUpdate(url: string, installLocation: string, maxRedirects?: number): Promise<ZipUpdateCheckResult>;
-/** Decide whether a local-path ZIP has changed since last install by comparing mtime. */
-export declare function checkLocalZipNeedsUpdate(sourcePath: string, installLocation: string): Promise<ZipUpdateCheckResult>;
-/**
- * Extract a ZIP / TGZ / TAR.GZ archive to `targetDir`.
- *
- * @param flatten When a single top-level directory is detected in a .zip (common for
- *   `git archive` output), move its contents up one level. Ignores `__MACOSX`.
- *   Defaults to true.
- */
-export declare function extractZip(zipPath: string, targetDir: string, flatten?: boolean): Promise<void>;

package/cli/dist-server/types/node/remote-control/clients/liveness-watchdog.d.ts

@@ -1,56 +0,0 @@
-/**
- * Liveness Watchdog
- *
- * 定期检查"最近一次活动时间"是否陈旧，陈旧即触发 onStuck 让调用方自定义恢复。
- *
- * 主要场景：macOS 屏幕锁屏 / App Nap 会冻结进程的定时器和网络栈：
- * - HTTP 长轮询：fetch 卡在 await，调用方 abort 当前请求让 catch 路径恢复
- * - WebSocket 心跳：ping 没回 pong，调用方 ws.close() 触发 onclose → 重连
- *
- * 关键：watchdog 定时器**不能 unref()**。unref 的定时器在 App Nap 下会被冻结
- * 而且不会"补发"——保留 ref 后系统才会在解冻瞬间触发回调，这才是恢复的核心机制。
- */
-import type { Logger } from '@genie/telemetry';
-/** watchdog 默认检查间隔（30s）。 */
-export declare const DEFAULT_LIVENESS_CHECK_INTERVAL_MS = 30000;
-/**
- * 默认卡死阈值（90s）。
- * HTTP 长轮询：35s 长轮询 + 10s timeout = 45s，给一倍 buffer 应付正常网络抖动。
- * WebSocket：30s 心跳 + 30s 等待 = 60s，加 30s buffer。
- */
-export declare const DEFAULT_LIVENESS_STUCK_MS = 90000;
-export interface LivenessWatchdogDeps {
-    /** 是否仍应继续监测。watchdog 在 false 时跳过检查（如 disconnected 状态）。 */
-    isActive(): boolean;
-    /** 取得最近一次活动时间戳（ms since epoch）。 */
-    getLastActivityAt(): number;
-    /**
-     * 卡死时由调用方决定如何恢复：
-     * - HTTP 长轮询场景：abort 当前请求
-     * - WebSocket 场景：ws.close() 触发 onclose 重连
-     * 实现内**应当**自己刷新 lastActivityAt 或确保短期不会再被 stuck 触发。
-     * elapsedMs 是当前 stuck 持续时间，便于日志和打点。
-     */
-    onStuck(elapsedMs: number): void;
-    /** 日志输出（stuck 触发时打 warn）。 */
-    logger: Logger;
-    /** 日志 / 异常打印用的标签，例如 'wechat-poll' / 'wecom-ws'。 */
-    label: string;
-}
-export interface LivenessWatchdogOptions {
-    /** 检查间隔，默认 DEFAULT_LIVENESS_CHECK_INTERVAL_MS */
-    intervalMs?: number;
-    /** 卡死阈值，默认 DEFAULT_LIVENESS_STUCK_MS */
-    stuckMs?: number;
-}
-export declare class LivenessWatchdog {
-    private readonly deps;
-    private timer;
-    private readonly intervalMs;
-    private readonly stuckMs;
-    constructor(deps: LivenessWatchdogDeps, options?: LivenessWatchdogOptions);
-    start(): void;
-    stop(): void;
-    /** 单次检查（暴露用于单测，不需要等真实定时器） */
-    tick(): void;
-}

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

@@ -1,23 +0,0 @@
-/**
- * One-line WeCom activity. Full-replace only; never a template card.
- * Do not leak Bash command, file contents, or Agent prompt.
- */
-export declare const WECOM_PROGRESS_MIN_INTERVAL_MS = 800;
-export declare const WECOM_PROGRESS_HEARTBEAT_MS = 15000;
-export interface WecomToolActivity {
-    phase: 'start' | 'end';
-    name: string;
-    callId?: string;
-    preview?: string;
-    fromSubAgent: boolean;
-}
-export declare function isHiddenWecomActivityTool(name: string | undefined): boolean;
-export declare function stripWecomThinkBlocks(text: string): string;
-export declare function isWecomProgressText(text: string | undefined | null): boolean;
-export declare function wecomFilePreviewFromArgs(name: string, raw: unknown): string | undefined;
-export declare function wecomToolActivityFromEvent(event: unknown): WecomToolActivity | undefined;
-export declare function formatWecomActivity(tools: Array<{
-    name: string;
-    fromSubAgent?: boolean;
-    preview?: string;
-}>, elapsedSec?: number): string;

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

@@ -1,64 +0,0 @@
-/**
- * WeChat Work AI Bot Credential Management
- *
- * Credentials are stored as a JSON array in a single file:
- *   ~/.codebuddy/channels/wecom/instances.json
- *
- * Each entry: { instanceId, displayName, credentials: WecomBotCredentials }
- *
- * Environment variables (CODEBUDDY_WECOM_BOT_ID, CODEBUDDY_WECOM_BOT_SECRET)
- * are still supported: when instances.json is empty and env vars are set,
- * an instance is auto-created from them.
- */
-export interface WecomBotCredentials {
-    botId: string;
-    secret: string;
-    wsUrl: string;
-}
-export interface WecomInstanceEntry {
-    instanceId: string;
-    displayName: string;
-    credentials: WecomBotCredentials;
-    /** daemon 启动时是否自动连接（默认 true） */
-    autoConnect?: boolean;
-    /**
-     * Whether this bot streams assistant text into WeCom.
-     * Omitted / true → stream; false → 2.140.0-style WeComReply only.
-     */
-    streaming?: boolean;
-    /**
-     * Whether Ask / permission / suggestion use template cards.
-     * Omitted / true → vote cards; false → 2.140.0-style text (y/n / 编号).
-     */
-    cards?: boolean;
-}
-/** Streaming is on unless the instance explicitly opts out. */
-export declare function isWecomStreamingEnabled(streaming?: boolean): boolean;
-/** Cards are on unless the instance explicitly opts out. */
-export declare function isWecomCardsEnabled(cards?: boolean): boolean;
-export declare function wecomDeliveryMode(streaming?: boolean): 'stream' | 'reply';
-/** Load all instance entries from instances.json (with legacy migration). */
-export declare function loadAllInstances(): WecomInstanceEntry[];
-/** Load credentials for a specific instance. */
-export declare function loadWecomCredentials(instanceId: string): WecomBotCredentials | undefined;
-/** Save (upsert) credentials for an instance. Preserves streaming / cards / autoConnect. */
-export declare function saveWecomCredentials(credentials: WecomBotCredentials, instanceId: string, displayName?: string): void;
-/**
- * Patch instance options. If the instance has no disk row yet, upsert one when
- * credentials are provided or resolvable from env (env-created `default`).
- */
-export declare function updateWecomInstanceOptions(instanceId: string, patch: Partial<Pick<WecomInstanceEntry, 'streaming' | 'cards' | 'autoConnect' | 'displayName'>>, credentials?: WecomBotCredentials): WecomInstanceEntry | undefined;
-/** Remove credentials for an instance. */
-export declare function clearWecomCredentials(instanceId: string): void;
-/** List all saved instance IDs. */
-export declare function listWecomCredentialInstances(): string[];
-export declare function wecomInstanceIdFromBotId(botId: string): string;
-export declare function isWecomQrPendingInstanceId(instanceId: string): boolean;
-/**
- * Resolve credentials from environment variables or disk for a given instance.
- * Environment variables take priority over saved credentials.
- *
- * Env var naming: CODEBUDDY_WECOM_BOT_ID_{INSTANCE} / CODEBUDDY_WECOM_BOT_SECRET_{INSTANCE}
- * Legacy no-suffix env vars (CODEBUDDY_WECOM_BOT_ID) are checked for the 'default' instance.
- */
-export declare function resolveWecomCredentials(instanceId: string): WecomBotCredentials | undefined;

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

@@ -1,47 +0,0 @@
-/**
- * WeChat Work AI Bot Client Factory
- *
- * Creates and manages multiple WecomBotClient instances.
- * All instances are loaded from ~/.codebuddy/channels/wecom/instances.json on startup.
- * No DI singleton — all instances are managed here.
- */
-import { type WecomBotCredentials } from './wecom-bot-auth';
-import { WecomBotClient } from './wecom-bot-client';
-export declare const WecomBotClientFactory: unique symbol;
-export interface IWecomBotClientFactory {
-    /** Get all instances */
-    getAll(): WecomBotClient[];
-    /** Get instance by instanceId */
-    get(instanceId: string): WecomBotClient | undefined;
-    /** Create a new instance and register it. Credentials optional — connect() will prompt if missing. */
-    create(instanceId: string, credentials?: WecomBotCredentials, displayName?: string): WecomBotClient;
-    /** Reuse one QR pending instance; drop extra unbound pendings. */
-    ensureQrPending(): WecomBotClient;
-    /** After QR bind, expose the live client under the botId-derived id. */
-    adoptPending(pendingId: string): string | undefined;
-    /** Remove an instance */
-    remove(instanceId: string): void;
-}
-export declare class WecomBotClientFactoryImpl implements IWecomBotClientFactory {
-    private readonly logger;
-    private readonly clientRegistry;
-    private readonly instances;
-    protected initialize(): void;
-    /**
-     * Load all instances from instances.json (includes legacy migration),
-     * then create instances from environment variables if not already present.
-     */
-    private loadAllSavedInstances;
-    /**
-     * If CODEBUDDY_WECOM_BOT_ID + CODEBUDDY_WECOM_BOT_SECRET env vars are set
-     * and no 'default' instance exists yet, create one from the env vars.
-     */
-    private loadInstanceFromEnv;
-    getAll(): WecomBotClient[];
-    get(instanceId: string): WecomBotClient | undefined;
-    ensureQrPending(): WecomBotClient;
-    adoptPending(pendingId: string): string | undefined;
-    private removeUnboundQrPendings;
-    create(instanceId: string, credentials?: WecomBotCredentials, displayName?: string): WecomBotClient;
-    remove(instanceId: string): void;
-}

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

@@ -1,191 +0,0 @@
-/**
- * WeChat Work AI Bot Long Connection Client
- *
- * Implements ILongConnectionClient for enterprise WeChat AI Bot WebSocket connections.
- * Uses the aibot WebSocket API (wss://openws.work.weixin.qq.com) with bot_id + secret auth.
- *
- * Credential resolution order:
- * 1. Environment variables (CODEBUDDY_WECOM_BOT_ID, CODEBUDDY_WECOM_BOT_SECRET)
- * 2. Saved credentials on disk (~/.codebuddy/channels/wecom/instances.json)
- * 3. WeCom official QR bind (same pairing page as @wecom/wecom-openclaw-cli), then hand-fill fallback
- *
- * Messages are handled via WecomBotChannelBridge (usesChannelBridge = true),
- * which injects them into the channel system as <channel source="wecom"> events.
- * Replies are sent via sendAsyncReply (aibot_send_msg proactive push).
- *
- * Features:
- * - WebSocket connection with aibot_subscribe authentication
- * - 30s heartbeat (ping)
- * - Exponential backoff reconnection with jitter
- * - Message deduplication (LRU Set)
- * - Proactive message push (aibot_send_msg) for channel bridge replies
- * - Stream reply support (aibot_respond_msg) — retained for interface compatibility
- * - Event handling (enter_chat welcome, disconnected_event reconnect)
- * - Runtime detection: uses Bun global WebSocket or Node.js ws package
- *
- * Reference: https://developer.work.weixin.qq.com/document/path/101463
- */
-import type { Logger } from '@genie/telemetry';
-import { Subject } from 'rxjs';
-import { type ILongConnectionClient, type LongConnectionMessage, type LongConnectionReplyContext, type QRAuthStatus, type RemoteControlConfig, type RemoteControlConnectionState, type RemoteControlConnectionStatus } from '../../remote-control-protocol';
-import { type WecomBotCredentials } from './wecom-bot-auth';
-import { type WecomCardClick, type WecomTemplateCard } from './wecom-bot-interaction';
-export declare class WecomBotClient implements ILongConnectionClient {
-    readonly clientType = "wecom";
-    instanceId: string;
-    displayName?: string;
-    readonly shouldAutoConnect = false;
-    readonly usesChannelBridge = true;
-    /** 扫码中的临时实例不进 /remote-control 列表，避免前端重挂载刷出一堆 connecting。 */
-    get hidden(): boolean;
-    readonly onMessage: Subject<LongConnectionMessage>;
-    readonly onCardEvent: Subject<WecomCardClick>;
-    readonly onStatusChange: Subject<RemoteControlConnectionState>;
-    readonly onQRAuthStateChange: Subject<QRAuthStatus>;
-    private logger;
-    private ws;
-    private heartbeatTimer;
-    private reconnectTimer;
-    private reconnectAttempts;
-    private _status;
-    private shouldReconnect;
-    /**
-     * 最近一次收到 ws 帧（消息或 pong）的时间戳。watchdog 用它判定连接是否还活着。
-     * 必须在每条消息到达时刷新。
-     */
-    private lastWsActivityAt;
-    /**
-     * Liveness watchdog：监测心跳活动是否陈旧。
-     *
-     * 背景：macOS 屏幕锁屏 / App Nap 会冻结网络栈和定时器。
-     * - heartbeatTimer 被冻结 → 不再发 ping
-     * - 即便底层 TCP 已断（路由器空闲超时等），ws 对象的 onclose 也可能延迟很久才触发
-     * - 解锁后我们看到的是"还连着"，但其实远端早把 session 抛了
-     *
-     * watchdog 在解冻瞬间触发，关掉僵尸 ws → onclose → scheduleReconnect 走原有重连路径。
-     */
-    private watchdog;
-    private readonly processedMsgIds;
-    private readonly msgIdQueue;
-    private readonly pendingResponses;
-    private readonly respondQueue;
-    private credentials;
-    private credentialPromptAbort;
-    private streamingEnabled;
-    private cardsEnabled;
-    get status(): RemoteControlConnectionStatus;
-    get streaming(): boolean;
-    setStreaming(enabled: boolean): boolean;
-    get cards(): boolean;
-    setCards(enabled: boolean): boolean;
-    /** Initialize the client. Called by the factory after construction. */
-    init(logger: Logger, instanceId: string, displayName?: string, credentials?: WecomBotCredentials | null, options?: {
-        streaming?: boolean;
-        cards?: boolean;
-    }): void;
-    /**
-     * Configure this client for a specific instance (called by factory before connect).
-     * @deprecated Use init() instead.
-     */
-    configureInstance(instanceId: string, displayName?: string, credentials?: WecomBotCredentials): void;
-    /** Check if credentials are available and valid */
-    isConfigured(): boolean;
-    getCredentials(): WecomBotCredentials | null;
-    /** Move a QR pending client onto a stable instance id after bind. */
-    rekeyInstance(instanceId: string, displayName?: string): void;
-    connect(_config?: RemoteControlConfig): Promise<void>;
-    /**
-     * Show the official WeCom pairing QR (or hand-fill instructions if generate fails).
-     */
-    private promptForCredentials;
-    disconnect(): void;
-    /** Clear in-memory credentials so next connect() triggers re-auth (interactive prompt). */
-    clearCredentials(): void;
-    dispose(): void;
-    /**
-     * Send reply via WebSocket as a single stream message with finish=true.
-     * Retained for ILongConnectionClient interface compatibility.
-     */
-    sendReply(context: LongConnectionReplyContext, content: string): Promise<void>;
-    /**
-     * Send streaming response chunk via stream message type.
-     * Same req_id is serialized through the respond queue.
-     */
-    sendStreamChunk(context: LongConnectionReplyContext, chunk: string, streamId: string, finished: boolean): Promise<void>;
-    /** First frame: finish=false, content=`<think></think>`. */
-    openStream(reqId: string, streamId: string): Promise<void>;
-    /** Full-replace stream update. Empty finish is dropped so the thinking animation is not locked. */
-    pushStream(reqId: string, streamId: string, content: string, finish: boolean): Promise<void>;
-    /**
-     * Send proactive message via aibot_send_msg (no stream timeout).
-     * Used by WecomBotChannelBridge for channel bridge replies.
-     * Only requires chatid, not the original req_id.
-     */
-    sendAsyncReply(context: LongConnectionReplyContext, content: string): Promise<void>;
-    sendTemplateCard(context: LongConnectionReplyContext, card: WecomTemplateCard): Promise<void>;
-    updateTemplateCard(reqId: string, card: WecomTemplateCard): Promise<void>;
-    /**
-     * Send a WebSocket frame and wait for the response with matching req_id.
-     * Implements request-response pattern over the fire-and-forget WebSocket.
-     */
-    private sendFrameWithResponse;
-    /**
-     * Upload media file to WeCom via WebSocket chunked upload protocol.
-     *
-     * Protocol (3 steps):
-     * 1. aibot_upload_media_init  → returns upload_id
-     * 2. aibot_upload_media_chunk → sends base64-encoded chunks
-     * 3. aibot_upload_media_finish → returns media_id
-     *
-     * @param fileBuffer - File content as Buffer
-     * @param options - Upload options (type, filename)
-     * @returns Upload result with media_id
-     */
-    uploadMedia(fileBuffer: Buffer, options: {
-        type: 'image' | 'file' | 'video' | 'voice';
-        filename: string;
-    }): Promise<{
-        media_id: string;
-        type: string;
-    }>;
-    /**
-     * Send a media message to a chat via aibot_send_msg.
-     *
-     * @param chatId - Target chat ID (user ID for single, group ID for group)
-     * @param mediaType - Media type (image, file, video, voice)
-     * @param mediaId - The media_id from uploadMedia
-     * @param chatType - Chat type: 1=single, 2=group (default: inferred from chatId)
-     */
-    sendMediaMessage(chatId: string, mediaType: 'image' | 'file' | 'video' | 'voice', mediaId: string, chatType?: 1 | 2): Promise<void>;
-    private doConnect;
-    private sendSubscribe;
-    private handleFrame;
-    private handleMsgCallback;
-    private handleEventCallback;
-    private handleEnterChat;
-    private startHeartbeat;
-    private stopHeartbeat;
-    /**
-     * 启动 ws liveness watchdog。详见 ../liveness-watchdog.ts。
-     *
-     * 策略：超过 90s 没收到任何 ws 帧 → 强制 ws.close() → 触发 onclose →
-     * shouldReconnect=true 时进入 scheduleReconnect 走原有重连路径。
-     * 这样 macOS 锁屏解冻后能在 ~30s 内（一个 watchdog tick）恢复，
-     * 而不是等 TCP keepalive 或远端清理 session。
-     */
-    private startWatchdog;
-    private stopWatchdog;
-    private scheduleReconnect;
-    private clearReconnectTimer;
-    private isDuplicate;
-    private recordMsgId;
-    /**
-     * Extract text and download media files from a WeCom AI Bot message.
-     * Media files (image/file/voice) are downloaded to a temp directory and referenced by path.
-     * Pattern: same as wechat-client.ts extractContent()
-     */
-    private extractContent;
-    private rejectAllPendingResponses;
-    private sendFrame;
-    private setStatus;
-}

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

@@ -1,7 +0,0 @@
-/**
- * Sync peek of aibot_msg_callback text so the bridge can route (permission / slash)
- * and open a stream before media download awaits.
- */
-import type { WecomBotMsgCallback } from './wecom-bot-types';
-export declare function peekWecomCallbackText(body: WecomBotMsgCallback['body']): string;
-export declare function composeWecomPrompt(text: string, mediaFiles: string[]): string;