import type { AgentToolErrorCode, ToolExecutionTarget } from "@inupedia/spotlight-protocol";
import { type HostToolEffect } from "./agentRegistry.js";
export interface ToolTraceEvent {
    phase: "dependency" | "context" | "execution";
    source: "executor" | "spotlight_action";
    type: "start" | "missing" | "cycle" | "require" | "prerequisites_resolved" | "precondition_failed" | "retry_scheduled" | "retrying" | "recovery_action" | "rollback_applied" | "rollback_failed" | "run_failed" | "done";
    tool: string;
    detail?: string;
    at: number;
    elapsedMs: number;
}
export interface ToolResult<T = unknown> {
    success: boolean;
    data?: T;
    error?: string;
    errorCode?: AgentToolErrorCode;
    executionTarget?: ToolExecutionTarget;
    hostEffect?: HostToolEffect;
    trace: ToolTraceEvent[];
}
export type AgentExecutorContext = Record<string, unknown>;
export type AgentExecutorNavigation = {
    getContext: () => AgentExecutorContext;
    ensureMainScene?: () => Promise<void>;
    ensureMidScene?: () => Promise<void>;
    ensureSmallScene?: () => Promise<void>;
    ensureMainTab?: (tab: string) => Promise<void>;
    ensureSmallTab?: (tab: string) => Promise<void>;
};
export type CreateAgentExecutorOptions = AgentExecutorNavigation & {
    loadTools?: () => Promise<unknown>;
    onToolComplete?: (toolName: string, input: unknown, result: ToolResult<unknown>) => void;
};
export declare function createAgentExecutor(options: CreateAgentExecutorOptions): <TInput = unknown, TOutput = unknown>(toolName: string, input: TInput) => Promise<ToolResult<TOutput>>;
//# sourceMappingURL=agentExecutor.d.ts.map