@tencent-ai/agent-sdk 0.3.263-dev.90f0e98.202609190050 → 0.3.263

package/cli/dist-server/types/node/tools/bash-tool.d.ts

@@ -1,204 +0,0 @@
-import { Logger } from '@celljs/core';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { FunctionCallItem, ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import type { RunContext, ToolExecuteArgument } from '@openai/agents';
-import { z } from 'zod';
-import { type AcpTerminalPublisher } from '../acp/acp-protocol';
-import { BackgroundTaskNotifier } from '../agent-task/agent-task-protocol';
-import { BashSandboxManager } from '../bash-sandbox';
-import { ToolResultBlobService } from '../blob-store/tool-result-blob-service';
-import { EndpointProvider } from '../loopback/server-protocol';
-import { type SandboxOrchestrator as ISandboxOrchestrator, type SandboxPermissionGateway as ISandboxPermissionGateway } from '../permission';
-import { PluginManager } from '@genie/cbc-plugins';
-import { SettingsManager } from '../settings';
-import { ShellService } from '../shell';
-import { ShortcutManager } from '../shortcut/shortcut-protocol';
-import { BaseTool } from './base-tool';
-import { type ShellStreamPusherService } from './shell-stream-pusher';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-declare const BashParameters: z.ZodObject<{
-    readonly command: z.ZodString;
-    readonly timeout: z.ZodOptional<z.ZodNumber>;
-    readonly description: z.ZodOptional<z.ZodString>;
-    readonly run_in_background: z.ZodOptional<z.ZodBoolean>;
-    readonly dangerouslyDisableSandbox: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    command: string;
-    timeout?: number | undefined;
-    description?: string | undefined;
-    run_in_background?: boolean | undefined;
-    dangerouslyDisableSandbox?: boolean | undefined;
-}, {
-    command: string;
-    timeout?: number | undefined;
-    description?: string | undefined;
-    run_in_background?: boolean | undefined;
-    dangerouslyDisableSandbox?: boolean | undefined;
-}>;
-type BashInput = z.infer<typeof BashParameters>;
-export declare class BashTool extends BaseTool implements Tool {
-    protected readonly shellService: ShellService;
-    protected readonly sandboxOrchestrator: ISandboxOrchestrator;
-    protected readonly sandboxPermissionGateway: ISandboxPermissionGateway;
-    protected readonly shortcutManager: ShortcutManager;
-    protected readonly logger: Logger;
-    protected readonly shellStreamPusher: ShellStreamPusherService;
-    protected readonly sandboxManager: BashSandboxManager;
-    protected readonly settingsManager: SettingsManager;
-    protected readonly pluginManager?: PluginManager;
-    protected readonly toolResultBlobService: ToolResultBlobService;
-    protected readonly backgroundTaskNotifier: BackgroundTaskNotifier;
-    protected readonly endpointProvider: EndpointProvider;
-    /**
-     * 尝试解析 service proxy 端点 URL。
-     * server 模式下立即可得；非 server 模式（TUI/SDK）下 deferred 永不解锁，
-     * @returns URL 字符串，解析失败返回 null
-     */
-    private resolveServiceProxyUrl;
-    /**
-     * ACP v2 终端推送器。惰性解析而非 @Autowired：纯 TUI / SDK 运行时不会加载 acp 模块，
-     * 此时容器里没有这个绑定，取不到就整体降级为不推送。
-     */
-    private terminalPublisherRef?;
-    protected get terminalPublisher(): AcpTerminalPublisher | undefined;
-    /**
-     * 把一段终端输出投给 ACP 客户端。三个 spawn 路径（file-fd poller / pipe onOutput /
-     * 前台促升）最终都汇到这里，所以门控与异常吞噬只需要在一处成立。
-     *
-     * 整段自吞异常：推送是旁路观测，绝不能让它影响命令执行。
-     *
-     * @param bytes `Buffer` = 来自文件的原始字节（字节保真）；`string` = 来自 PTY / pipe
-     *              的解码结果（保真度较弱，见各调用点说明）。
-     */
-    private publishTerminalOutput;
-    /** 促升路径用：任务还没促升时 task 为 undefined，天然不推。 */
-    private publishBackgroundOutput;
-    name: ToolNames;
-    aliases: string[];
-    /**
-     * Tool schema is a **method** (not a static field) so ToolManager.get()
-     * re-evaluates it per invocation against the current process env. When
-     * CODEBUDDY_CODE_DISABLE_BACKGROUND_TASKS is truthy the `run_in_background`
-     * field is omitted, so the model never sees it (issue #63114 — background
-     * shell results cannot flow back in request-response SDK / print-mode
-     * consumers, so the host disables the capability outright). The runtime
-     * guard in `execute()` still coerces `run_in_background=true` from
-     * stale/cached tool calls back to foreground.
-     */
-    parameters(): z.ZodTypeAny;
-    /**
-     * On Windows, BashTool requires Git Bash. If Git Bash is not installed,
-     * this tool is disabled and PowerShellTool becomes the sole shell tool.
-     */
-    isEnabled: () => boolean;
-    argumentRenderer: ToolCallArgumentRenderer;
-    resolveNeedPermissionArgs(_runContext: RunContext, input: BashInput, _callId?: string): ToolArg[];
-    /** Auto mode classifier projection: the command is the action's risk surface. */
-    toAutoClassifierInput(input: unknown): string;
-    needsApproval: (runContext: RunContext<Session>, input: ToolExecuteArgument<any>, callId?: string) => Promise<boolean>;
-    execute(input: BashInput, context: RunContext<Session>, details?: {
-        toolCall: FunctionCallItem;
-    }): Promise<ToolResult>;
-    private executeForeground;
-    private createExecutionContext;
-    private createShellPromise;
-    private createBackgroundPromise;
-    /**
-     * shell-service 超时触发时的处理：尝试把命令转为后台任务而不是 kill。
-     *
-     * 对齐 Claude Code 的 `shellCommand.onTimeout → startBackgrounding` 行为
-     * (src/tools/BashTool/BashTool.tsx:967-971)。返回 true 告诉 shell-service "已接管,
-     * 不要 SIGTERM"，子进程继续跑；返回 false 走原 kill 路径（向后兼容老行为）。
-     *
-     * 关闭条件：
-     *   - env CODEBUDDY_BASH_AUTO_BACKGROUND_DISABLED=1 → 全局关闭
-     *   - print 模式（-p，非 stdio stream-json）→ 禁止（#61140，进程随主 turn 退出无法续跑后台任务）
-     *   - 命令在 auto-background 黑名单内（如 `sleep`） → 按原路径 kill
-     *   - execCtx.promoteToBackground 未就绪（理论上不会发生）
-     */
-    private tryPromoteToBackgroundOnTimeout;
-    private handleBackgroundedResult;
-    private buildForegroundResult;
-    /**
-     * 后台任务输出文件大小看门狗的扫描间隔。
-     */
-    private static readonly BG_SIZE_WATCHDOG_INTERVAL_MS;
-    /**
-     * 后台任务 stdout+stderr 总大小上限，超过则 SIGKILL（防写爆磁盘）。
-     * 默认 50MB；可通过 env `CODEBUDDY_BASH_BG_MAX_OUTPUT_BYTES` 调整。
-     * 参考 Claude Code `ShellCommand.ts:239-261` 的 size watchdog 机制。
-     */
-    private static readonly BG_DEFAULT_MAX_OUTPUT_BYTES;
-    private getBgMaxOutputBytes;
-    /**
-     * 给当前后台任务分配一对 stdout/stderr 落盘文件 + fd，用于直接接收子进程的 stdio。
-     *
-     * 返回 `null` 表示当前路径不适合走文件 fd（例如要走 sandbox 后端，
-     * IPC 协议不消费 fd），调用方应回退到 onOutput pipe 模式。
-     *
-     * 实际的"建目录 + 开 fd"逻辑抽到 {@link prepareBackgroundOutputFiles}（独立 module）
-     * 以便单测；此方法只做"是否走文件 fd"的策略判断。
-     */
-    private maybePrepareBackgroundOutputFiles;
-    private executeInBackground;
-    /** 关 fd 的小工具；忽略已关闭/无效错误。spawn 之后必须立刻调用，不要让父进程持有写端。 */
-    private closeFdSafely;
-    private createBackgroundTask;
-    /**
-     * 晋升路径的终端退出通知。任务未晋升（execCtx.currentBackgroundTask 为空）时静默跳过。
-     *
-     * 任何终止分支都必须调用：`exitStatus` 是客户端判定"已结束"的唯一依据，漏一条就会让
-     * 卡片永远停在运行中。
-     */
-    private notifyTerminalExit;
-    private updateBackgroundTaskStatus;
-    /**
-     * 收集本次命令声明的产物，并就地打完相关告警。
-     *
-     * 唯一来源是 `$CODEBUDDY_ARTIFACTS` 带外通道；stdout 不再被解析（原因见
-     * produced-artifact.ts 模块头）。
-     *
-     * 只返回 artifacts。malformed 不上抛是有意的：它唯一的用途就是告警，作者看不到
-     * 这个文件，被跳过的行只能靠日志暴露。
-     */
-    private collectDeclarations;
-    private buildBackgroundResult;
-    private startStreamingUpdates;
-    private stopStreamingUpdates;
-    private createStreamingText;
-    private pushStreamingText;
-    private cleanup;
-    private shouldAutoApproveInSandbox;
-    validateRuntimeInput(input: unknown): ToolResult | undefined;
-    private validateInput;
-    private errorResult;
-    /**
-     * 把参数校验类的失败原因映射到 8000 段细分错误码：
-     * 命令根无法识别（权限/解析域）→ 8014，其余保持 90000。
-     */
-    private resolveBashValidationErrorCode;
-    /**
-     * 根据 shell 执行结果推导结构化错误码。
-     * 返回 '0' 表示成功（无错误），非零纯数字为错误码。
-     */
-    private resolveBashErrorCode;
-    private findCallId;
-    private getCommandRoot;
-    private isEnvAssignment;
-    private generateTaskId;
-    private resolveTimeout;
-    /**
-     * Build a SandboxApprovalRequester that surfaces SandboxOrchestrator
-     * approval prompts through the standard InterruptionService flow.
-     *
-     * The full implementation lives in `bash-sandbox-approval-requester.ts`
-     * — this method is a thin shim that injects the tool's logger.
-     */
-    private _createApprovalRequester;
-    /**
-     * Emit a single structured log line summarising the orchestrator outcome,
-     * so it is easy to grep for bypass decisions during diagnostics.
-     */
-    private _logOrchestratorOutcome;
-}
-export {};

package/cli/dist-server/types/node/tools/channel-tasks-tool.d.ts

@@ -1,174 +0,0 @@
-/**
- * ChannelTasks —— 频道任务板（黑板 + 单写者认领）。
- *
- * 事件经 applyChannelTaskEvent 落板 + transcript（kind=task），再定向叫醒。
- * 纪律：先 claim 再动手；产出写文件 / 分支，refs 只传引用不贴正文。
- * 只对 Agent Home 自治表面开放（TUI / 通用 ACP / 子代理拿不到）。
- */
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-import type { RunContext } from '../../vendor/cbc-shared/node/index.js';
-import { Logger } from '@genie/telemetry';
-import { z } from 'zod';
-import { ChannelWakeService } from '../agent-home/channel-wake-service';
-import { SettingsManager } from '../settings/settings-protocol';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolNames, ToolResult } from './tool-protocol';
-export declare class ChannelTasksTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly wakeService?: ChannelWakeService;
-    protected readonly settingsManager?: SettingsManager;
-    name: ToolNames;
-    description: string;
-    needsApproval: boolean;
-    shouldShowInToolSearch: () => boolean;
-    parameters: z.ZodObject<{
-        action: z.ZodEnum<["list", "create", "update", "delete", "claim", "complete", "release", "dispatch", "escalate"]>;
-        channel: z.ZodOptional<z.ZodString>;
-        taskId: z.ZodOptional<z.ZodString>;
-        subject: z.ZodOptional<z.ZodString>;
-        detail: z.ZodOptional<z.ZodString>;
-        assignAgentId: z.ZodOptional<z.ZodString>;
-        refs: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            kind: z.ZodEnum<["issue", "file", "pr", "commit", "url"]>;
-            value: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            kind: "commit" | "file" | "issue" | "pr" | "url";
-            value: string;
-        }, {
-            kind: "commit" | "file" | "issue" | "pr" | "url";
-            value: string;
-        }>, "many">>;
-        requestId: z.ZodOptional<z.ZodString>;
-        assignments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            subject: z.ZodString;
-            detail: z.ZodOptional<z.ZodString>;
-            assignAgentId: z.ZodString;
-            refs: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                kind: z.ZodEnum<["issue", "file", "pr", "commit", "url"]>;
-                value: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                kind: "commit" | "file" | "issue" | "pr" | "url";
-                value: string;
-            }, {
-                kind: "commit" | "file" | "issue" | "pr" | "url";
-                value: string;
-            }>, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            subject: string;
-            detail?: string | undefined;
-            assignAgentId: string;
-            refs?: {
-                kind: "commit" | "file" | "issue" | "pr" | "url";
-                value: string;
-            }[] | undefined;
-        }, {
-            subject: string;
-            detail?: string | undefined;
-            assignAgentId: string;
-            refs?: {
-                kind: "commit" | "file" | "issue" | "pr" | "url";
-                value: string;
-            }[] | undefined;
-        }>, "many">>;
-        escalate: z.ZodOptional<z.ZodObject<{
-            mode: z.ZodEnum<["nudge", "release"]>;
-            taskIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            maxStaleMs: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            mode: "nudge" | "release";
-            taskIds?: string[] | undefined;
-            maxStaleMs?: number | undefined;
-        }, {
-            mode: "nudge" | "release";
-            taskIds?: string[] | undefined;
-            maxStaleMs?: number | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        action: "claim" | "complete" | "create" | "delete" | "dispatch" | "escalate" | "list" | "release" | "update";
-        channel?: string | undefined;
-        taskId?: string | undefined;
-        subject?: string | undefined;
-        detail?: string | undefined;
-        assignAgentId?: string | undefined;
-        refs?: {
-            kind: "commit" | "file" | "issue" | "pr" | "url";
-            value: string;
-        }[] | undefined;
-        requestId?: string | undefined;
-        assignments?: {
-            subject: string;
-            detail?: string | undefined;
-            assignAgentId: string;
-            refs?: {
-                kind: "commit" | "file" | "issue" | "pr" | "url";
-                value: string;
-            }[] | undefined;
-        }[] | undefined;
-        escalate?: {
-            mode: "nudge" | "release";
-            taskIds?: string[] | undefined;
-            maxStaleMs?: number | undefined;
-        } | undefined;
-    }, {
-        action: "claim" | "complete" | "create" | "delete" | "dispatch" | "escalate" | "list" | "release" | "update";
-        channel?: string | undefined;
-        taskId?: string | undefined;
-        subject?: string | undefined;
-        detail?: string | undefined;
-        assignAgentId?: string | undefined;
-        refs?: {
-            kind: "commit" | "file" | "issue" | "pr" | "url";
-            value: string;
-        }[] | undefined;
-        requestId?: string | undefined;
-        assignments?: {
-            subject: string;
-            detail?: string | undefined;
-            assignAgentId: string;
-            refs?: {
-                kind: "commit" | "file" | "issue" | "pr" | "url";
-                value: string;
-            }[] | undefined;
-        }[] | undefined;
-        escalate?: {
-            mode: "nudge" | "release";
-            taskIds?: string[] | undefined;
-            maxStaleMs?: number | undefined;
-        } | undefined;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    toAutoClassifierInput(_input: unknown): string;
-    isEnabled: (args?: {
-        runContext?: RunContext<Session>;
-        agent?: {
-            name?: string;
-        };
-    }) => Promise<boolean>;
-    execute(input: {
-        action?: string;
-        channel?: string;
-        taskId?: string;
-        subject?: string;
-        detail?: string;
-        assignAgentId?: string;
-        refs?: {
-            kind: 'issue' | 'file' | 'pr' | 'commit' | 'url';
-            value: string;
-        }[];
-        requestId?: string;
-        assignments?: {
-            subject: string;
-            detail?: string;
-            assignAgentId: string;
-            refs?: {
-                kind: 'issue' | 'file' | 'pr' | 'commit' | 'url';
-                value: string;
-            }[];
-        }[];
-        escalate?: {
-            mode: 'nudge' | 'release';
-            taskIds?: string[];
-            maxStaleMs?: number;
-        };
-    }, context?: RunContext<Session>): Promise<ToolResult>;
-}

package/cli/dist-server/types/node/tools/computer-use-capabilities.d.ts

@@ -1,23 +0,0 @@
-/**
- * macOS 平台硬过滤。Windows / Linux 下工具完全禁用。
- */
-export declare function isDarwin(): boolean;
-/**
- * 探测 cliclick 是否可用。cliclick 提供比 AppleScript 更快更准确的鼠标/键盘操作，
- * 但需要用户通过 Homebrew 安装。未安装时 fallback 到 osascript。
- *
- * 检测方式：which cliclick，有输出且返回 0 即可用。结果缓存。
- */
-export declare function detectCliclick(): Promise<string | null>;
-/**
- * 计算本次 cbc 进程的 computer-use 截图目录，按需创建。
- * 路径：<home>/computer-use/  （home 支持 CODEBUDDY_CONFIG_DIR 重定向）
- *
- * 不按 session/project 分目录 —— computer use 操作本身和当前会话关系紧密，
- * 但截图作为调试/审计产物，统一放一起便于用户清理。
- */
-export declare function getComputerUseDir(): string;
-/**
- * 仅测试用：重置缓存，便于 spec 里多次断言不同平台分支。
- */
-export declare function __resetComputerUseCapabilitiesCacheForTest(): void;

package/cli/dist-server/types/node/tools/computer-use-executor.d.ts

@@ -1,130 +0,0 @@
-/** 测试钩子：直接读当前 scale，便于断言。 */
-export declare function getScreenshotScaleForTest(): {
-    x: number;
-    y: number;
-};
-/** 测试钩子：手动重置 scale（spec 用）。 */
-export declare function __resetScreenshotScaleForTest(): void;
-export type ComputerUseAction = 'screenshot' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'triple_click' | 'mouse_move' | 'left_click_drag' | 'type' | 'key' | 'hold_key' | 'scroll' | 'wait' | 'cursor_position';
-export type ScrollDirection = 'up' | 'down' | 'left' | 'right';
-export interface ScreenshotResult {
-    action: 'screenshot';
-    screenshot_path: string;
-}
-export interface ClickResult {
-    action: 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'triple_click' | 'mouse_move';
-    x: number;
-    y: number;
-}
-export interface DragResult {
-    action: 'left_click_drag';
-    start_x: number;
-    start_y: number;
-    end_x: number;
-    end_y: number;
-}
-export interface TypeResult {
-    action: 'type';
-    text_length: number;
-}
-export interface KeyResult {
-    action: 'key';
-    text: string;
-}
-export interface HoldKeyResult {
-    action: 'hold_key';
-    text: string;
-    duration: number;
-}
-export interface ScrollResult {
-    action: 'scroll';
-    x: number;
-    y: number;
-    scroll_direction: ScrollDirection;
-    scroll_amount: number;
-}
-export interface WaitResult {
-    action: 'wait';
-    duration: number;
-}
-export interface CursorPositionResult {
-    action: 'cursor_position';
-    x: number;
-    y: number;
-}
-export type ComputerUseResult = ScreenshotResult | ClickResult | DragResult | TypeResult | KeyResult | HoldKeyResult | ScrollResult | WaitResult | CursorPositionResult;
-/**
- * 截图实现。通过 `/usr/sbin/screencapture -x -t jpg -T 0 <out>` 调用系统截图工具。
- *
- * 参数：
- *   -x: 不播放快门音（避免打扰用户）
- *   -t jpg: 输出 jpeg（文件小、加载快，模型推理足够）
- *   -T 0: 零延迟截图
- *   -D <id>: 可选，指定显示器
- */
-export declare function takeScreenshot(displayId?: number): Promise<ScreenshotResult>;
-/**
- * 鼠标点击/移动。优先用 cliclick（快速精准），未安装时 fallback 到 AppleScript。
- * AppleScript 的 `click at {x,y}` 在部分 macOS 版本行为不稳定（需要 System Events 焦点），
- * 但作为 fallback 可用。
- *
- * middle_click / triple_click 仅 cliclick 支持；无 cliclick 时抛错。
- */
-export declare function mouseAction(action: ClickResult['action'], x: number, y: number): Promise<ClickResult>;
-/**
- * 左键拖拽 (Anthropic left_click_drag)。仅 cliclick 支持；需要 3 步：按下→移动→松开。
- */
-export declare function leftClickDrag(startX: number, startY: number, endX: number, endY: number): Promise<DragResult>;
-/**
- * 文本输入。用 AppleScript `keystroke` 原生支持任意 Unicode 字符（含中日韩）。
- * cliclick 的 t: 对非 ASCII 支持不完整，所以这里统一走 osascript。
- *
- * 多行：AppleScript 双引号字面量不能含裸换行/CR，直接拼进去会 syntax error。
- * 按 \n 拆段，段与段之间发 `keystroke return`（key code 36），匹配"真实按回车换行"语义。
- * `\r` 归一化成 `\n`；`\t` 交给 keystroke 原生（AppleScript 字面量支持 tab 字符）。
- */
-export declare function typeText(text: string): Promise<TypeResult>;
-/**
- * 按键/快捷键。接受 xdotool 风格字符串如 `cmd+shift+a` 或单个键如 `escape` / `return`。
- */
-export declare function pressKey(text: string): Promise<KeyResult>;
-/**
- * 按住某键指定秒数（Anthropic hold_key）。
- *
- * macOS 下最稳定的实现是 keystroke + 循环重复（按键自动重复速率由系统控制）。
- * 为了精确控制时长，改用 AppleScript 的 `key down` + delay + `key up` 模式。
- * 仅支持命名键（escape/return/letter 等），不支持组合修饰键（与 Anthropic 保持一致）。
- */
-export declare function holdKey(text: string, duration: number): Promise<HoldKeyResult>;
-/**
- * 等待指定秒数。纯 setTimeout 包装，用于给 UI 动画留出时间。
- */
-export declare function wait(duration: number): Promise<WaitResult>;
-/**
- * 滚动。
- *
- * 历史实现用 `cliclick w:dx,dy` 模拟滚轮 —— **这是错的**：
- *   cliclick 的 `w:` 命令含义是 "wait <ms>"，不是滚轮。它会把 `0,3` 当作非法毫秒
- *   静默吞掉，结果就是滚不动。cliclick 在 5.x 版本之前根本没有滚轮原生命令。
- *
- * 现改用 macOS 自带的 python3 + Quartz 框架调用 CoreGraphics 的
- * `CGEventCreateScrollWheelEvent`，这是 macOS 原生滚轮事件，最贴近真实硬件行为，
- * 且 macOS 默认就装了 python3 与 Quartz（PyObjC），无需额外依赖。
- *
- * 坐标语义：模型给的是截图坐标，先 rescaleToLogical 还原为逻辑像素再用。
- *
- * 滚动方向约定（与 Anthropic computer_20250124 一致）：
- *   - up    : 内容向上 = 滚轮向下推（dy 为负）  ← 注意符号
- *   - down  : 内容向下 = 滚轮向上推（dy 为正）
- *   - left/right 同理对水平轴
- *
- * 但 macOS CGEventCreateScrollWheelEvent 的符号约定是：
- *   - vertical 正值 = 内容向上（即 "scroll up" 视觉效果）
- *   - horizontal 正值 = 内容向左
- * 所以语义直接映射即可，不需要再翻转。
- */
-export declare function scrollAt(x: number, y: number, scroll_direction: ScrollDirection, scroll_amount: number): Promise<ScrollResult>;
-/**
- * 查询鼠标当前坐标。优先 cliclick p（返回 "x,y"），fallback 到 AppleScript。
- */
-export declare function getCursorPosition(): Promise<CursorPositionResult>;

package/cli/dist-server/types/node/tools/computer-use-tool.d.ts

@@ -1,86 +0,0 @@
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { BaseTool } from './base-tool';
-import { Tool, ToolResult } from './tool-protocol';
-declare const ComputerUseParameters: z.ZodObject<{
-    action: z.ZodEnum<["screenshot", "left_click", "right_click", "middle_click", "double_click", "triple_click", "mouse_move", "left_click_drag", "type", "key", "hold_key", "scroll", "wait", "cursor_position"]>;
-    coordinate: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-    start_coordinate: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-    text: z.ZodOptional<z.ZodString>;
-    scroll_direction: z.ZodOptional<z.ZodEnum<["up", "down", "left", "right"]>>;
-    scroll_amount: z.ZodOptional<z.ZodNumber>;
-    duration: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    action: "cursor_position" | "double_click" | "hold_key" | "key" | "left_click" | "left_click_drag" | "middle_click" | "mouse_move" | "right_click" | "screenshot" | "scroll" | "triple_click" | "type" | "wait";
-    coordinate?: number[] | undefined;
-    start_coordinate?: number[] | undefined;
-    text?: string | undefined;
-    scroll_direction?: "down" | "left" | "right" | "up" | undefined;
-    scroll_amount?: number | undefined;
-    duration?: number | undefined;
-}, {
-    action: "cursor_position" | "double_click" | "hold_key" | "key" | "left_click" | "left_click_drag" | "middle_click" | "mouse_move" | "right_click" | "screenshot" | "scroll" | "triple_click" | "type" | "wait";
-    coordinate?: number[] | undefined;
-    start_coordinate?: number[] | undefined;
-    text?: string | undefined;
-    scroll_direction?: "down" | "left" | "right" | "up" | undefined;
-    scroll_amount?: number | undefined;
-    duration?: number | undefined;
-}>;
-type ComputerUseInput = z.infer<typeof ComputerUseParameters>;
-export declare class ComputerUseTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        action: z.ZodEnum<["screenshot", "left_click", "right_click", "middle_click", "double_click", "triple_click", "mouse_move", "left_click_drag", "type", "key", "hold_key", "scroll", "wait", "cursor_position"]>;
-        coordinate: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-        start_coordinate: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-        text: z.ZodOptional<z.ZodString>;
-        scroll_direction: z.ZodOptional<z.ZodEnum<["up", "down", "left", "right"]>>;
-        scroll_amount: z.ZodOptional<z.ZodNumber>;
-        duration: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        action: "cursor_position" | "double_click" | "hold_key" | "key" | "left_click" | "left_click_drag" | "middle_click" | "mouse_move" | "right_click" | "screenshot" | "scroll" | "triple_click" | "type" | "wait";
-        coordinate?: number[] | undefined;
-        start_coordinate?: number[] | undefined;
-        text?: string | undefined;
-        scroll_direction?: "down" | "left" | "right" | "up" | undefined;
-        scroll_amount?: number | undefined;
-        duration?: number | undefined;
-    }, {
-        action: "cursor_position" | "double_click" | "hold_key" | "key" | "left_click" | "left_click_drag" | "middle_click" | "mouse_move" | "right_click" | "screenshot" | "scroll" | "triple_click" | "type" | "wait";
-        coordinate?: number[] | undefined;
-        start_coordinate?: number[] | undefined;
-        text?: string | undefined;
-        scroll_direction?: "down" | "left" | "right" | "up" | undefined;
-        scroll_amount?: number | undefined;
-        duration?: number | undefined;
-    }>;
-    /**
-     * 启用条件：必须 macOS 且 env CODEBUDDY_COMPUTER_USE_ENABLED=1/true。
-     */
-    private isComputerUseEnabled;
-    isEnabled: (_args?: unknown) => Promise<boolean>;
-    /**
-     * 同步镜像 isEnabled 的 gate，用于 ToolSearch 延迟工具列表可见性过滤。
-     * gate 未开时不应出现在 "Available deferred tools" 描述里，避免模型误判此工具可用。
-     */
-    shouldShowInToolSearch: () => boolean;
-    execute(input: ComputerUseInput, _context?: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * screenshot 返图：严格照抄 read-tool 形态——读 JPEG base64 → image_url data URI。
-     */
-    private formatScreenshot;
-    private dispatch;
-    /**
-     * 非 screenshot action 返 JSON content（string 形态）+ text renderer。
-     * rawResponse 保留原始 payload 供 PostToolUse hook 消费。
-     */
-    private formatResult;
-    private describeAction;
-}
-export {};