import { Effect } from "effect";
import type { Tools } from "./tools.js";
export type Services<T> = ServicesOf<T, []>;
type ServicesOf<T, Depth extends ReadonlyArray<unknown>> = Depth["length"] extends 8 ? never : T extends {
    readonly _tag: "CodeModeTool";
    readonly execute: (input: unknown) => Effect.Effect<unknown, unknown, infer R>;
} ? R : T extends object ? string extends keyof T ? ServicesOf<T[string], [...Depth, unknown]> : ServicesOf<T[keyof T], [...Depth, unknown]> : never;
export type ToolCall = {
    readonly name: string;
};
export type ToolCallStarted = {
    readonly index: number;
    readonly name: string;
    readonly input: unknown;
};
export type ToolCallEnded = {
    readonly index: number;
    readonly name: string;
    readonly input: unknown;
    readonly durationMs: number;
    readonly outcome: "success" | "failure" | "interrupted";
    readonly message?: string;
};
export type ToolCallHooks<R = never> = {
    readonly onToolCallStart?: ((call: ToolCallStarted) => Effect.Effect<void, never, R>) | undefined;
    readonly onToolCallEnd?: ((call: ToolCallEnded) => Effect.Effect<void, never, R>) | undefined;
};
export type ToolDescription = {
    readonly path: string;
    readonly description: string;
    readonly signature: string;
};
export type SafeObject = Record<string, unknown>;
export declare const toolExpression: (path: string) => string;
export declare class ToolReference {
    readonly path: ReadonlyArray<string>;
    constructor(path: ReadonlyArray<string>);
}
export declare class ToolRuntimeError extends Error {
    readonly kind: "UnknownTool" | "InvalidToolInput" | "InvalidToolOutput" | "InvalidDataValue" | "ToolCallLimitExceeded";
    readonly suggestions: ReadonlyArray<string>;
    constructor(kind: "UnknownTool" | "InvalidToolInput" | "InvalidToolOutput" | "InvalidDataValue" | "ToolCallLimitExceeded", message: string, suggestions?: ReadonlyArray<string>);
}
export declare const isBlockedMember: (name: string) => boolean;
export declare const copyIn: (value: unknown, label: string, preserveCodeModeValues?: boolean) => unknown;
export type CopyOutMode = "json" | "nullify";
export declare const copyOut: (value: unknown, mode: CopyOutMode) => unknown;
export type DiscoveryPlan = {
    readonly catalog: ReadonlyArray<ToolDescription>;
    readonly searchIndex: ReadonlyArray<SearchEntry>;
};
export type SearchEntry = {
    readonly description: ToolDescription;
    readonly searchText: string;
};
/** Exact callable signature of the built-in `search` function, for host-owned instructions. */
export declare const searchSignature: string;
export declare const searchIndex: <R>(tools: Tools<R>) => ReadonlyArray<SearchEntry>;
export declare const prepare: <R>(tools: Tools<R>) => DiscoveryPlan;
export type ToolRuntime<R = never> = {
    readonly root: ToolReference;
    readonly calls: Array<ToolCall>;
    readonly execute: (path: ReadonlyArray<string>, args: Array<unknown>) => Effect.Effect<unknown, unknown, R>;
    readonly search: (args: Array<unknown>) => Effect.Effect<unknown, unknown, R>;
    readonly keys: (path: ReadonlyArray<string>) => ReadonlyArray<string>;
};
export declare const make: <R>(tools: Tools<R>, maxToolCalls: number | undefined, searchIndex: ReadonlyArray<SearchEntry>, hooks?: ToolCallHooks<R>) => ToolRuntime<R>;
export * as ToolRuntime from "./tool-runtime.js";