import type { Tool as AiTool, ToolSet as AiToolSet } from 'ai';
import type { Runtime } from '../runtime/Runtime.js';
import type { ZodTypeAny } from 'zod';
export type Tool<TInput = unknown, TResult = unknown> = AiTool<TInput, TResult>;
export type ToolSet = AiToolSet;
export interface ToolExecutionContext {
    session?: unknown;
    sessionId?: string;
    agentId?: string;
    step?: number;
    turn?: number;
    toolName?: string;
    toolCallId?: string;
    idempotencyKey?: string;
    runtime?: unknown;
    [key: string]: unknown;
}
export interface ToolExecutionOptions {
    toolCallId?: string;
    messages?: unknown[];
    abortSignal?: AbortSignal;
    experimental_context?: ToolExecutionContext;
    [key: string]: unknown;
}
export type ToolExecutionContextWithRuntime = ToolExecutionContext & {
    runtime: Runtime;
};
export declare function isAgentContext(value: unknown): value is ToolExecutionContextWithRuntime;
export declare function getRuntimeFromContext(context: ToolExecutionContext | undefined): Runtime | undefined;
export interface ToolDefinition<TInput = unknown, TResult = unknown> {
    description: string;
    inputSchema: ZodTypeAny;
    execute: (input: TInput, options?: ToolExecutionOptions) => Promise<TResult> | TResult;
    /** If true (default), failure blocks turn success completion. */
    critical?: boolean;
    /** Action to take on execution error. */
    errorPolicy?: 'abort' | 'warn' | 'continue';
}
export interface ToolWithFiller<TInput = unknown, TResult = unknown> extends ToolDefinition<TInput, TResult> {
    /** Optional filler message to display while tool is executing */
    filler?: string;
    /** Optional estimated duration in ms for showing filler */
    estimatedDurationMs?: number;
}
export declare function createTool<TInput = unknown, TResult = unknown>(definition: ToolDefinition<TInput, TResult>): Tool<TInput, TResult> & ToolDefinition<TInput, TResult>;
export declare function createToolWithFiller<TInput = unknown, TResult = unknown>(definition: ToolWithFiller<TInput, TResult>): Tool<TInput, TResult> & ToolWithFiller<TInput, TResult>;