import { Effect, Schema } from "effect";
import { Prompt, Tool } from "effect/unstable/ai";
import { type Agent, type Result, type RunRequirements } from "./agent.js";
import { type RunBudget } from "../durable/run-budget.js";
import { type Registration } from "../policy/handoff.js";
type AgentToolRunOptions = {
    readonly prompt: Prompt.RawInput;
    readonly inheritedBudget?: RunBudget;
};
declare const defaultParameters: Schema.Struct<{
    readonly prompt: Schema.String;
}>;
type DefaultParameters = typeof defaultParameters;
type DefaultSuccess = typeof Schema.String;
/** @experimental */
export interface AsToolOptions<Name extends string = string, Parameters extends Schema.Top = DefaultParameters, Success extends Schema.Top = DefaultSuccess> {
    readonly name?: Name;
    readonly description?: string;
    readonly parameters?: Parameters;
    readonly success?: Success;
    readonly toPrompt?: (params: Parameters["Type"]) => Prompt.RawInput;
    readonly fromResult?: (result: Result) => Success["Type"];
}
/** @experimental A schema-backed tool with a stable name and closed invocation. */
export type AgentToolTool<Parameters extends Schema.Top, Success extends Schema.Top> = Tool.Tool<string, {
    readonly parameters: Parameters | DefaultParameters;
    readonly success: Success | DefaultSuccess;
    readonly failure: typeof Schema.String;
    readonly failureMode: "return";
}, never>;
/** @experimental */
export interface AgentToolToolkit<_Name extends string, Parameters extends Schema.Top, Success extends Schema.Top, R> {
    readonly name: string;
    readonly tool: AgentToolTool<Parameters, Success>;
    readonly tools: {
        readonly [name: string]: AgentToolTool<Parameters, Success>;
    };
    readonly parametersSchema: Schema.Top;
    readonly successSchema: Schema.Top;
    readonly invoke: (params: unknown) => Effect.Effect<Success["Type"], string, R>;
    readonly requirements: (value: R) => R;
}
/** @experimental */
export declare const asTool: {
    <const Name extends string = string, Parameters extends Schema.Top = DefaultParameters, Success extends Schema.Top = DefaultSuccess>(options?: AsToolOptions<Name, Parameters, Success>): <Tools extends Record<string, Tool.Any>, R>(agent: Agent<Tools, R> | Registration<Tools, R>) => AgentToolToolkit<Name, Parameters, Success, RunRequirements<Tools, R, AgentToolRunOptions>>;
    <Tools extends Record<string, Tool.Any>, R, const Name extends string = string, Parameters extends Schema.Top = DefaultParameters, Success extends Schema.Top = DefaultSuccess>(agent: Agent<Tools, R> | Registration<Tools, R>, options?: AsToolOptions<Name, Parameters, Success>): AgentToolToolkit<Name, Parameters, Success, RunRequirements<Tools, R, AgentToolRunOptions>>;
};
export {};