import type { JSONSchema7 } from 'json-schema';
import { z } from 'zod';
import type { BuiltTool, InterruptibleToolContext, ToolContext } from '../types';
import type { AgentMessage } from '../types/sdk/message';
import type { ToolDescriptor } from '../types/sdk/tool-descriptor';
import type { JSONObject } from '../types/utils/json';
export declare const APPROVAL_SUSPEND_SCHEMA: z.ZodObject<{
    type: z.ZodLiteral<"approval">;
    toolName: z.ZodString;
    displayName: z.ZodOptional<z.ZodString>;
    args: z.ZodUnknown;
}, "strip", z.ZodTypeAny, {
    type: "approval";
    toolName: string;
    displayName?: string | undefined;
    args?: unknown;
}, {
    type: "approval";
    toolName: string;
    displayName?: string | undefined;
    args?: unknown;
}>;
export type ApprovalSuspendPayload = z.infer<typeof APPROVAL_SUSPEND_SCHEMA>;
export declare const APPROVAL_RESUME_SCHEMA: z.ZodObject<{
    approved: z.ZodBoolean;
}, "strip", z.ZodTypeAny, {
    approved: boolean;
}, {
    approved: boolean;
}>;
export type ApprovalResumePayload = z.infer<typeof APPROVAL_RESUME_SCHEMA>;
type ZodOrJsonSchema = z.ZodType | JSONSchema7;
type OutputType<TOutput> = TOutput extends z.ZodType ? z.infer<TOutput> : unknown;
export interface ApprovalConfig {
    requireApproval?: boolean;
    needsApprovalFn?: (args: unknown) => Promise<boolean> | boolean;
}
export declare function getToolApprovalDisplayName(tool: BuiltTool): string | undefined;
export declare function wrapToolForApproval(tool: BuiltTool, config: ApprovalConfig): BuiltTool;
type HandlerContext<S, R> = S extends z.ZodType ? R extends z.ZodType ? InterruptibleToolContext<z.infer<S>, z.infer<R>> : ToolContext : ToolContext;
export declare class Tool<TInput extends ZodOrJsonSchema = z.ZodTypeAny, TOutput extends ZodOrJsonSchema = z.ZodTypeAny, TSuspend extends ZodOrJsonSchema | undefined = undefined, TResume extends ZodOrJsonSchema | undefined = undefined> {
    private name;
    private desc?;
    private inputSchema?;
    private outputSchema?;
    private suspendSchemaValue?;
    private resumeSchemaValue?;
    private handlerFn?;
    private toMessageFn?;
    private toModelOutputFn?;
    private providerOptionsValue?;
    private handleCancellationValue?;
    private requireApprovalValue?;
    private needsApprovalFnValue?;
    private systemInstructionText?;
    constructor(name: string);
    description(desc: string): this;
    systemInstruction(text: string): this;
    input<S extends ZodOrJsonSchema>(schema: S): Tool<S, TOutput, TSuspend, TResume>;
    output<S extends ZodOrJsonSchema>(schema: S): Tool<TInput, S, TSuspend, TResume>;
    suspend<S extends ZodOrJsonSchema>(schema: S): Tool<TInput, TOutput, S, TResume>;
    resume<R extends ZodOrJsonSchema>(schema: R): Tool<TInput, TOutput, TSuspend, R>;
    handler(fn: (input: OutputType<TInput>, ctx: HandlerContext<TSuspend, TResume>) => Promise<OutputType<TOutput>>): this;
    toMessage(toMessage: (output: OutputType<TOutput>) => AgentMessage): this;
    toModelOutput(fn: (output: OutputType<TOutput>) => unknown): this;
    handleCancellation(): this;
    requireApproval(): this;
    needsApprovalFn(fn: (args: OutputType<TInput>) => Promise<boolean> | boolean): this;
    providerOptions(options: Record<string, JSONObject>): this;
    build(): BuiltTool;
    describe(): ToolDescriptor;
}
export declare function sanitizeToolName(name: string): string;
export {};