import type { z } from 'zod';
import type { ToolContext, ToolDefinition, ToolPermission, ToolResult } from '../types/tool/index.js';
import type { ToolPresentation } from '../types/tool/presentation.js';
export interface DefineToolOptions<S extends z.ZodType> {
    name: string;
    description: string;
    inputSchema: S;
    modelInputSchema?: Record<string, unknown>;
    enforceModelInput?: boolean;
    validationErrorHint?: string;
    category: ToolDefinition['category'];
    permissions: ToolPermission[];
    /** Whether this exact call only observes state; conservative for unknown inputs. */
    readOnly: boolean | ((input: z.infer<S>) => boolean);
    destructive: boolean | ((input: z.infer<S>) => boolean);
    concurrencySafe: boolean;
    /** Batch ordering boundary; see {@link ToolDefinition.executionBarrier}. */
    executionBarrier?: boolean;
    tier?: string;
    /**
     * How this tool's call and result should be shown; see
     * {@link ToolPresentation}.
     *
     * Here rather than only on `ToolDefinition` for the reason `maxRetries`
     * is: this builder is the sanctioned way to author a tool, and a field
     * the executor reads that the builder cannot set is a field only
     * hand-written definitions can use.
     */
    presentCall?: ToolPresentation<z.infer<S>>['presentCall'];
    presentResult?: ToolPresentation<z.infer<S>>['presentResult'];
    /** Per-execution deadline; see {@link ToolDefinition.timeoutMs}. */
    timeoutMs?: number;
    /**
     * In-loop retry budget for a FAILED execution; see
     * {@link ToolDefinition.maxRetries}.
     *
     * The executor has always read this field, and this builder — the
     * sanctioned way to author a tool — had no way to set it, so the
     * documented "the tool author opts in, per tool" was reachable only by
     * hand-writing the interface.
     */
    maxRetries?: number;
    /** Return shape shown to the model; see {@link ToolDefinition.outputSchema}. */
    outputSchema?: Record<string, unknown>;
    /** Settle the turn with this tool's output; see {@link ToolDefinition.terminal}. */
    terminal?: boolean;
    /**
     * The argument holding a shell command line; see
     * {@link ToolDefinition.commandArgument}.
     *
     * Here as well as on the definition for the reason `maxRetries` and
     * `presentCall` are: this builder is the sanctioned way to author a tool,
     * and a field a host reads that the builder cannot set is a field only
     * hand-written definitions can use.
     */
    commandArgument?: string;
    /** The argument holding a filesystem path; see {@link ToolDefinition.pathArgument}. */
    pathArgument?: string;
    /** The argument asking to leave the sandbox; see {@link ToolDefinition.sandboxEscapeArgument}. */
    sandboxEscapeArgument?: string;
    execute(input: z.infer<S>, context: ToolContext): Promise<ToolResult>;
}
export declare function defineTool<S extends z.ZodType>(options: DefineToolOptions<S>): ToolDefinition<z.infer<S>>;
//# sourceMappingURL=defineTool.d.ts.map