/**
 * @license
 * Copyright 2025 Google LLC
 * SPDX-License-Identifier: Apache-2.0
 */
import type { SandboxPermissions } from '../services/sandboxManager.js';
import { BaseDeclarativeTool, BaseToolInvocation, ToolConfirmationOutcome, type ToolInvocation, type ToolResult, type ToolCallConfirmationDetails, type PolicyUpdateOptions, type ToolLiveOutput, type ExecuteOptions } from './tools.js';
import { PARAM_ADDITIONAL_PERMISSIONS } from './definitions/base-declarations.js';
import type { MessageBus } from '../confirmation-bus/message-bus.js';
import type { AgentLoopContext } from '../config/agent-loop-context.js';
export declare const OUTPUT_UPDATE_INTERVAL_MS = 1000;
export interface ShellToolParams {
    command: string;
    description?: string;
    dir_path?: string;
    is_background?: boolean;
    [PARAM_ADDITIONAL_PERMISSIONS]?: SandboxPermissions;
}
export declare class ShellToolInvocation extends BaseToolInvocation<ShellToolParams, ToolResult> {
    private readonly context;
    constructor(context: AgentLoopContext, params: ShellToolParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string);
    private getContextualDetails;
    getDescription(): string;
    getDisplayTitle(): string;
    getExplanation(): string;
    getPolicyUpdateOptions(outcome: ToolConfirmationOutcome): PolicyUpdateOptions | undefined;
    shouldConfirmExecute(abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
    protected getConfirmationDetails(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
    execute(signal: AbortSignal, updateOutput?: (output: ToolLiveOutput) => void, options?: ExecuteOptions): Promise<ToolResult>;
}
export declare class ShellTool extends BaseDeclarativeTool<ShellToolParams, ToolResult> {
    private readonly context;
    static readonly Name = "run_shell_command";
    constructor(context: AgentLoopContext, messageBus: MessageBus);
    protected validateToolParamValues(params: ShellToolParams): string | null;
    protected createInvocation(params: ShellToolParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<ShellToolParams, ToolResult>;
    getSchema(modelId?: string): import("@google/genai").FunctionDeclaration;
}
