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

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

@@ -1,116 +0,0 @@
-import { type AgentRunScope as IAgentRunScope, type Session } from '../../vendor/cbc-core/node/index.js';
-import { type RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { Logger } from '@genie/telemetry';
-import { z } from 'zod';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-/**
- * Structured data for SendMessage tool rendering.
- * This is passed to the UI layer via renderer.value for human-like display.
- */
-export interface SendMessageRenderData {
-    /** Message type: message, broadcast, shutdown_request, shutdown_response, plan_approval_response */
-    type: 'message' | 'broadcast' | 'shutdown_request' | 'shutdown_response' | 'plan_approval_response';
-    /** Sender name (for display context) */
-    sender: string;
-    /** Recipient name or '@team' for broadcast */
-    recipient?: string;
-    /** Recipient's color for display */
-    recipientColor?: string;
-    /** Short summary/preview text */
-    summary?: string;
-    /** Result message shown below the header */
-    resultMessage: string;
-    /** For shutdown/plan_approval: whether approved */
-    approved?: boolean;
-    /** Number of recipients for broadcast */
-    recipientCount?: number;
-}
-/**
- * SendMessage tool - unified messaging for Agent Team communication.
- *
- * Supports 5 message types:
- *   - message: Direct message to a specific teammate
- *   - broadcast: Message to all teammates (use sparingly)
- *   - shutdown_request: Request a teammate to shut down
- *   - shutdown_response: Respond to a shutdown request
- *   - plan_approval_response: Approve or reject a plan
- */
-export declare class SendMessageTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly agentRunScope?: IAgentRunScope;
-    name: ToolNames;
-    description: string;
-    shouldShowInToolSearch: () => boolean;
-    parameters: z.ZodObject<{
-        type: z.ZodEnum<["message", "broadcast", "shutdown_request", "shutdown_response", "plan_approval_response"]>;
-        recipient: z.ZodOptional<z.ZodString>;
-        content: z.ZodOptional<z.ZodString>;
-        summary: z.ZodOptional<z.ZodString>;
-        request_id: z.ZodOptional<z.ZodString>;
-        approve: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        type: "broadcast" | "message" | "plan_approval_response" | "shutdown_request" | "shutdown_response";
-        recipient?: string | undefined;
-        content?: string | undefined;
-        summary?: string | undefined;
-        request_id?: string | undefined;
-        approve?: boolean | undefined;
-    }, {
-        type: "broadcast" | "message" | "plan_approval_response" | "shutdown_request" | "shutdown_response";
-        recipient?: string | undefined;
-        content?: string | undefined;
-        summary?: string | undefined;
-        request_id?: string | undefined;
-        approve?: boolean | undefined;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    needsApproval: boolean;
-    /**
-     * Auto mode classifier projection (Claude alignment, decision D1): a plain
-     * message projects `to ${recipient}: ${content}`; structured control messages
-     * (shutdown / plan-approval) project a short summary. Consumed in history —
-     * SendMessage has `needsApproval = false`, so the current action never reaches
-     * the classifier directly.
-     */
-    toAutoClassifierInput(input: unknown): string;
-    isEnabled: () => boolean;
-    execute(input: {
-        type: string;
-        recipient?: string;
-        content?: string;
-        summary?: string;
-        request_id?: string;
-        approve?: boolean;
-    }, context?: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * Resolve a recipient by name, checking both formal TeamManager and implicit TeamMemberRegistry.
-     * `teamName` scopes the implicit registry lookup so cross-team same-name members
-     * cannot be matched as this sender's recipient.
-     *
-     * Falls back to a single `refreshFromDisk()` re-read when neither in-memory
-     * source has the recipient. This closes the spawn-race window where one
-     * teammate has been persisted to `config.json` but not yet reflected in
-     * the current process's TeamManager snapshot (e.g. concurrent spawns).
-     */
-    private resolveRecipient;
-    /**
-     * Map a recipient name to its canonical form (e.g. "main" → "team-lead").
-     */
-    private resolveRecipientName;
-    /**
-     * Notify an in-process logical actor after its inbox append is durable.
-     * The actor owns serialization and revalidates the human-turn lease at the
-     * actual paused -> running boundary.
-     */
-    private kickRecipient;
-    /**
-     * Get all known member names from both formal TeamManager and TeamMemberRegistry.
-     */
-    private getAllMemberNames;
-    private handleMessage;
-    private handleBroadcast;
-    private handleShutdownRequest;
-    private handleShutdownResponse;
-    private handlePlanApprovalResponse;
-}

package/cli/dist-server/types/node/tools/send-user-message-attachments.d.ts

@@ -1,22 +0,0 @@
-/**
- * SendUserMessage 工具解析后的附件元信息（issue #82025，对齐 claude-code）。
- *
- * `file_uuid` 预留给远程上传场景（BRIDGE_MODE 专属），本期只解析本地元信息、
- * 不做上传，因此始终为 undefined。上传与客户端消费按 issue 备注另行拆分。
- */
-export interface ResolvedAttachment {
-    path: string;
-    size: number;
-    isImage: boolean;
-    file_uuid?: string;
-}
-/**
- * 校验附件路径：文件须存在且为常规文件。任一不满足抛出可读错误，
- * 让模型看到失败原因（cwd 一并带上，便于定位相对路径）。
- */
-export declare function validateAttachmentPaths(rawPaths: string[]): Promise<void>;
-/**
- * 解析附件路径为元信息 `{ path, size, isImage }`。串行 stat 保持顺序确定，
- * 与入参顺序一致。本期不做远程上传。
- */
-export declare function resolveAttachments(rawPaths: string[]): Promise<ResolvedAttachment[]>;

package/cli/dist-server/types/node/tools/send-user-message-tool.d.ts

@@ -1,60 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { z } from 'zod';
-import { RunContext } from '../../vendor/cbc-shared/node/index.js';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { BaseTool } from './base-tool';
-import { BriefModeService } from './brief-mode-service';
-import { ResolvedAttachment } from './send-user-message-attachments';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-/**
- * SendUserMessage 工具的结构化返回数据（issue #82025，对齐 claude-code）。
- *
- * 挂在 `ToolResult.rawResponse` 上，供 hooks /客户端渲染侧消费。
- */
-export interface SendUserMessageOutput {
-    /** 面向用户的消息（markdown）。 */
-    message: string;
-    /** 解析后的附件元信息；无附件时缺省。 */
-    attachments?: ResolvedAttachment[];
-    /** 工具执行时刻的 ISO 时间戳。 */
-    sentAt: string;
-}
-/**
- * SendUserMessage 工具 —— Agent 面向用户的显式通信通道（Brief 模式，issue #82025）。
- *
- * 对齐 claude-code 的 BriefTool：开启 `--brief` 后作为 Agent 面向用户的主要可见输出通道。
- * 工具常驻工具列表，`isEnabled` 在未开 Brief 模式时隐藏它。
- */
-export declare class SendUserMessageTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly briefModeService: BriefModeService;
-    name: ToolNames;
-    description: string;
-    shouldShowInToolSearch: () => boolean;
-    parameters: z.ZodObject<{
-        message: z.ZodString;
-        attachments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        status: z.ZodEnum<["normal", "proactive"]>;
-    }, "strip", z.ZodTypeAny, {
-        message: string;
-        attachments?: string[] | undefined;
-        status: "normal" | "proactive";
-    }, {
-        message: string;
-        attachments?: string[] | undefined;
-        status: "normal" | "proactive";
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    needsApproval: boolean;
-    /**
-     * Auto mode classifier projection: 面向用户的消息本身即分类相关文本。
-     */
-    toAutoClassifierInput(input: unknown): string;
-    isEnabled: () => boolean;
-    execute(input: {
-        message: string;
-        attachments?: string[];
-        status: 'normal' | 'proactive';
-    }, _context?: RunContext<Session>): Promise<ToolResult>;
-}

package/cli/dist-server/types/node/tools/shell-stream-pusher.d.ts

@@ -1,25 +0,0 @@
-import { Logger } from '@celljs/core';
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-export declare const ShellStreamPusher: unique symbol;
-export interface ShellStreamPusherOptions {
-    toolName: string;
-    resultId: string;
-    callId: string;
-    /** 从工具开始执行攒到当下的**全量**输出 buffer（追加 statusText 后的整体文本），不是增量 delta。
-     *  \r 折叠与半截序列收尾都依赖全量语义：传 delta 会导致帧间内容错乱且无任何报错。 */
-    value: string;
-}
-export interface ShellStreamPusherService {
-    push(session: Session | undefined, opts: ShellStreamPusherOptions): void;
-}
-/**
- * shell 类工具（Bash / REPL）的流式进度推送：统一拼 function_call_result 帧，
- * value 过 toShellDisplayText 后作为 `renderer.value` 与流式 `content` 下发。
- *
- * 流式帧直接走 inputSubject（不进 history、不过 AgentInputItemProcessor 链），
- * 因此最终结果的清洗出口（input-item-processors）覆盖不到这里，由本服务补位。
- */
-export declare class ShellStreamPusherImpl implements ShellStreamPusherService {
-    protected readonly logger: Logger;
-    push(session: Session | undefined, opts: ShellStreamPusherOptions): void;
-}

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

@@ -1,77 +0,0 @@
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { Agent, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { ProductManager } from '@genie/product';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-declare const SkillManageParameters: z.ZodObject<{
-    action: z.ZodEnum<["list", "create", "modify", "delete"]>;
-    name: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    action: "create" | "delete" | "list" | "modify";
-    name?: string | undefined;
-}, {
-    action: "create" | "delete" | "list" | "modify";
-    name?: string | undefined;
-}>;
-export declare class SkillManageTool extends BaseTool implements Tool {
-    protected readonly productManager: ProductManager;
-    protected readonly logger: Logger;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        action: z.ZodEnum<["list", "create", "modify", "delete"]>;
-        name: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        action: "create" | "delete" | "list" | "modify";
-        name?: string | undefined;
-    }, {
-        action: "create" | "delete" | "list" | "modify";
-        name?: string | undefined;
-    }>;
-    needsApproval: boolean;
-    argumentRenderer: ToolCallArgumentRenderer;
-    /**
-     * Controlled by ProductFeature.SkillManage.
-     * Disabled by default; can be enabled via product config or client settings.
-     */
-    isEnabled: (_args: {
-        runContext: RunContext<Session>;
-        agent: Agent;
-    }) => Promise<boolean>;
-    execute(input: z.infer<typeof SkillManageParameters>, context: RunContext<Session>): Promise<ToolResult>;
-    private handleList;
-    private handleCreate;
-    private handleModify;
-    private handleDelete;
-    /**
-     * Read the agent-created-skills.json registry file.
-     * Returns empty registry if file doesn't exist or is malformed.
-     */
-    private readRegistry;
-    /**
-     * Check if a skill name exists in the registry file.
-     */
-    private isInRegistry;
-    /**
-     * Check if a skill's SKILL.md file contains `agent_created: true` in frontmatter.
-     */
-    private hasAgentCreatedFrontmatter;
-    /**
-     * Dual validation: checks both the registry file and SKILL.md frontmatter.
-     * Either source confirming agent-created is sufficient (fault-tolerant design).
-     * Returns error message string if validation fails, undefined if OK.
-     */
-    private validateAgentCreated;
-    private findSkillByName;
-    private listDirectoryContents;
-    private generateSkillTemplate;
-    /**
-     * Truncate output to MAX_TOOL_OUTPUT_LENGTH to prevent context overflow.
-     * Preserves the beginning of the output and appends a truncation marker.
-     */
-    private truncateOutput;
-}
-export {};

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

@@ -1,129 +0,0 @@
-import { AgentManager, PromptRenderer, Session } from '../../vendor/cbc-core/node/index.js';
-import { type FunctionCallItem, ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { ProductManager } from '@genie/product';
-import { EventService, Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { AgentTaskManager } from '../agent-task/agent-task-protocol';
-import { CommandManager, CustomCommandRenderer } from '../command';
-import { SettingsManager } from '../settings/settings-protocol';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-declare const SkillParameters: z.ZodEffects<z.ZodObject<{
-    skill: z.ZodOptional<z.ZodString>;
-    command: z.ZodOptional<z.ZodString>;
-    args: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    skill?: string | undefined;
-    command?: string | undefined;
-    args?: string | undefined;
-}, {
-    skill?: string | undefined;
-    command?: string | undefined;
-    args?: string | undefined;
-}>, {
-    skill?: string | undefined;
-    command?: string | undefined;
-    args?: string | undefined;
-}, {
-    skill?: string | undefined;
-    command?: string | undefined;
-    args?: string | undefined;
-}>;
-export declare class SkillTool extends BaseTool implements Tool {
-    protected readonly productManager: ProductManager;
-    protected readonly customCommandRenderer: CustomCommandRenderer;
-    protected readonly promptRenderer: PromptRenderer;
-    protected readonly logger: Logger;
-    protected readonly taskManager: AgentTaskManager;
-    protected readonly commandManager: CommandManager;
-    protected readonly agentManager: AgentManager;
-    protected readonly eventService: EventService;
-    protected readonly settingsManager: SettingsManager;
-    private readonly disabledCallsBySession;
-    name: ToolNames;
-    readonly promptCacheStability: 'volatile';
-    aliases: string[];
-    parameters: z.ZodEffects<z.ZodObject<{
-        skill: z.ZodOptional<z.ZodString>;
-        command: z.ZodOptional<z.ZodString>;
-        args: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        skill?: string | undefined;
-        command?: string | undefined;
-        args?: string | undefined;
-    }, {
-        skill?: string | undefined;
-        command?: string | undefined;
-        args?: string | undefined;
-    }>, {
-        skill?: string | undefined;
-        command?: string | undefined;
-        args?: string | undefined;
-    }, {
-        skill?: string | undefined;
-        command?: string | undefined;
-        args?: string | undefined;
-    }>;
-    needsApproval: (runContext: RunContext<Session>, input: unknown, callId?: string) => Promise<boolean>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    resolveNeedPermissionArgs(runContext: RunContext, input: z.infer<typeof SkillParameters>, callId?: string): ToolArg[];
-    execute(input: z.infer<typeof SkillParameters>, context: RunContext<Session>, details?: {
-        toolCall: FunctionCallItem;
-    }): Promise<ToolResult>;
-    /**
-     * Execute a slash command (from commands configuration or built-in commands)
-     */
-    private executeSlashCommand;
-    /**
-     * Try to execute a built-in command. Returns null if not a built-in command.
-     */
-    private tryExecuteBuiltinCommand;
-    /**
-     * Find a skill by name, supporting exact match, short name match, and displayName fallback.
-     * For short names (without ':'), if multiple skills share the same short name,
-     * returns undefined and sets an ambiguity error message.
-     */
-    private findSkill;
-    /**
-     * Execute a skill (from skills configuration)
-     * If skill not found, try to find as slash command
-     */
-    private executeSkill;
-    protected safeRender(promptToRender: string): Promise<string>;
-    /**
-     * 上报插件 skill 能力调用埋点。
-     * 仅当 skill 带 pluginInfo 时触发。
-     * 仅在 WorkBuddy Desktop 宿主下上报；其他宿主（VSCode 插件、纯 CLI 等）各自有独立的上报链路。
-     */
-    private reportPluginCapabilityCall;
-    /**
-     * 上报插件 command 能力调用埋点。
-     * 插件 command 的 tags 形如 [CUSTOM_COMMAND_TAG, PLUGIN_TAG, source]，
-     * 其中 source 形如 "pluginName@marketplaceName"。
-     * 仅在 WorkBuddy Desktop 宿主下上报。
-     */
-    private reportPluginCommandCall;
-    private rememberDisabledCall;
-    private consumeDisabledCall;
-    private validateToolParams;
-    /**
-     * Execute skill in fork context (isolated subagent)
-     * The subagent runs independently without access to main conversation history,
-     * but will load CODEBUDDY.md through the session mechanism.
-     *
-     * Aligns with Claude Code's fork context execution:
-     * - Skill content becomes the prompt (via buildForkPrompt)
-     * - No conversation history is inherited
-     */
-    private executeSkillInForkContext;
-    /**
-     * Build prompt for fork context execution
-     * Aligns with Claude Code's Q06 function behavior:
-     * - Uses getPromptForCommand pattern (Base directory prefix + skill content)
-     * - Processes content through the standard pipeline: $ARGUMENTS → !`command` → @file references
-     * - Does NOT add extra "You are executing skill" prefix
-     */
-    private buildForkPrompt;
-}
-export {};

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

@@ -1,45 +0,0 @@
-import { PromptRenderer, Session } from '../../vendor/cbc-core/node/index.js';
-import { ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { ProductManager } from '@genie/product';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { CommandManager, CustomCommandRenderer } from '../command';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-declare const SlashCommandParameters: z.ZodObject<{
-    command: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    command: string;
-}, {
-    command: string;
-}>;
-export declare class SlashCommandTool extends BaseTool implements Tool {
-    protected readonly productManager: ProductManager;
-    protected readonly customCommandRenderer: CustomCommandRenderer;
-    protected readonly promptRenderer: PromptRenderer;
-    protected readonly commandManager: CommandManager;
-    protected readonly logger: Logger;
-    name: ToolNames;
-    readonly promptCacheStability: 'volatile';
-    aliases: string[];
-    parameters: z.ZodObject<{
-        command: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        command: string;
-    }, {
-        command: string;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    needsApproval: (runContext: RunContext<Session>, input: z.infer<typeof SlashCommandParameters>, callId?: string) => Promise<boolean>;
-    resolveNeedPermissionArgs(runContext: RunContext, input: z.infer<typeof SlashCommandParameters>, callId?: string): ToolArg[];
-    execute(input: z.infer<typeof SlashCommandParameters>, context: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * Execute a built-in command via CommandManager.
-     */
-    protected executeBuiltinCommand(trimmedCommand: string, commandName: string, context: RunContext<Session>): Promise<ToolResult>;
-    protected safeRender(promptToRender: string): Promise<string>;
-    private extractCommandName;
-    private validateToolParams;
-}
-export {};

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

@@ -1,178 +0,0 @@
-/**
- * SpeakInChannel —— 往频道 jsonl 说话。
- * 不是 MessageColleague，不写对方 1:1，不进 jobAssignments。
- * 落盘走带锁的 applyChannelSpeech；成功后叫醒其他成员，不叫醒自己。
- *
- * 频道解析走 agent-home-channel-context，叫醒走 ChannelWakeService——
- * 工具里不再出现 ContainerUtil.get / 目录读写的样板。
- */
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-import { type RunContext, ToolNames } 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, ToolResult } from './tool-protocol';
-declare const SpeakInChannelParameters: z.ZodObject<{
-    content: z.ZodOptional<z.ZodString>;
-    channel: z.ZodOptional<z.ZodString>;
-    mentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    replyTo: z.ZodOptional<z.ZodString>;
-    attachments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    widget: z.ZodOptional<z.ZodObject<{
-        prompt: z.ZodString;
-        helpText: z.ZodOptional<z.ZodString>;
-        options: z.ZodArray<z.ZodObject<{
-            label: z.ZodString;
-            value: z.ZodOptional<z.ZodString>;
-            style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
-            value?: string | undefined;
-            style?: "danger" | "default" | "primary" | undefined;
-        }, {
-            label: string;
-            value?: string | undefined;
-            style?: "danger" | "default" | "primary" | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        prompt: string;
-        helpText?: string | undefined;
-        options: {
-            label: string;
-            value?: string | undefined;
-            style?: "danger" | "default" | "primary" | undefined;
-        }[];
-    }, {
-        prompt: string;
-        helpText?: string | undefined;
-        options: {
-            label: string;
-            value?: string | undefined;
-            style?: "danger" | "default" | "primary" | undefined;
-        }[];
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    content?: string | undefined;
-    channel?: string | undefined;
-    mentions?: string[] | undefined;
-    replyTo?: string | undefined;
-    attachments?: string[] | undefined;
-    widget?: {
-        prompt: string;
-        helpText?: string | undefined;
-        options: {
-            label: string;
-            value?: string | undefined;
-            style?: "danger" | "default" | "primary" | undefined;
-        }[];
-    } | undefined;
-}, {
-    content?: string | undefined;
-    channel?: string | undefined;
-    mentions?: string[] | undefined;
-    replyTo?: string | undefined;
-    attachments?: string[] | undefined;
-    widget?: {
-        prompt: string;
-        helpText?: string | undefined;
-        options: {
-            label: string;
-            value?: string | undefined;
-            style?: "danger" | "default" | "primary" | undefined;
-        }[];
-    } | undefined;
-}>;
-type SpeakInChannelInput = z.infer<typeof SpeakInChannelParameters>;
-export declare class SpeakInChannelTool 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<{
-        content: z.ZodOptional<z.ZodString>;
-        channel: z.ZodOptional<z.ZodString>;
-        mentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        replyTo: z.ZodOptional<z.ZodString>;
-        attachments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        widget: z.ZodOptional<z.ZodObject<{
-            prompt: z.ZodString;
-            helpText: z.ZodOptional<z.ZodString>;
-            options: z.ZodArray<z.ZodObject<{
-                label: z.ZodString;
-                value: z.ZodOptional<z.ZodString>;
-                style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
-            }, "strip", z.ZodTypeAny, {
-                label: string;
-                value?: string | undefined;
-                style?: "danger" | "default" | "primary" | undefined;
-            }, {
-                label: string;
-                value?: string | undefined;
-                style?: "danger" | "default" | "primary" | undefined;
-            }>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            prompt: string;
-            helpText?: string | undefined;
-            options: {
-                label: string;
-                value?: string | undefined;
-                style?: "danger" | "default" | "primary" | undefined;
-            }[];
-        }, {
-            prompt: string;
-            helpText?: string | undefined;
-            options: {
-                label: string;
-                value?: string | undefined;
-                style?: "danger" | "default" | "primary" | undefined;
-            }[];
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        content?: string | undefined;
-        channel?: string | undefined;
-        mentions?: string[] | undefined;
-        replyTo?: string | undefined;
-        attachments?: string[] | undefined;
-        widget?: {
-            prompt: string;
-            helpText?: string | undefined;
-            options: {
-                label: string;
-                value?: string | undefined;
-                style?: "danger" | "default" | "primary" | undefined;
-            }[];
-        } | undefined;
-    }, {
-        content?: string | undefined;
-        channel?: string | undefined;
-        mentions?: string[] | undefined;
-        replyTo?: string | undefined;
-        attachments?: string[] | undefined;
-        widget?: {
-            prompt: string;
-            helpText?: string | undefined;
-            options: {
-                label: string;
-                value?: string | undefined;
-                style?: "danger" | "default" | "primary" | undefined;
-            }[];
-        } | undefined;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    toAutoClassifierInput(_input: unknown): string;
-    isEnabled: (args?: {
-        runContext?: RunContext<Session>;
-        agent?: {
-            name?: string;
-        };
-    }) => Promise<boolean>;
-    /** 有可说话的频道：同步读目录（设置闸门走 agentHomeRoomToolRefusal）。 */
-    private hasSpeakableChannel;
-    execute(input: SpeakInChannelInput, context?: RunContext<Session>): Promise<ToolResult>;
-}
-export {};