export type RuntimeJsonValue = null | boolean | number | string | RuntimeJsonValue[] | {
    [key: string]: RuntimeJsonValue;
};
export type RuntimeJsonSchema = {
    [key: string]: RuntimeJsonValue;
};
export interface RuntimeModel {
    readonly provider: string;
    readonly model: string;
    readonly thinking?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
}
export interface RuntimeToolCall {
    readonly id: string;
    readonly input: RuntimeJsonValue;
    readonly signal: AbortSignal;
}
export interface RuntimeToolResult {
    readonly value: RuntimeJsonValue;
    readonly isError?: boolean;
}
export interface RuntimeTool {
    readonly name: string;
    readonly description: string;
    readonly parameters: RuntimeJsonSchema;
    execute(call: RuntimeToolCall): Promise<RuntimeToolResult>;
}
export type RuntimeUsageAvailability = "complete" | "partial" | "unavailable";
export interface RuntimeUsage {
    readonly availability: RuntimeUsageAvailability;
    readonly input?: number;
    readonly output?: number;
    readonly cacheRead?: number;
    readonly cacheWrite?: number;
    readonly costUsd?: number;
}
export type RuntimeAgentProviderRecovery = "retry" | "abort" | {
    readonly model: string;
};
export interface RuntimeAgentProviderFailure {
    readonly provider: string;
    readonly model: string;
    readonly error: string;
}
export declare class RuntimeAgentProviderError extends Error {
    readonly failure: RuntimeAgentProviderFailure;
    readonly recovery: RuntimeAgentProviderRecovery | undefined;
    readonly handled: boolean;
    constructor(failure: RuntimeAgentProviderFailure, recovery: RuntimeAgentProviderRecovery | undefined, handled: boolean);
}
export interface RuntimeAgentIdentity {
    readonly id: string;
    readonly structuralPath: readonly string[];
    readonly parentId?: string;
}
export interface RuntimeRunIdentity {
    readonly id: string;
    readonly namespaceId: string;
    readonly workflowName: string;
}
export interface RuntimeAgentState {
    readonly model: RuntimeModel;
    readonly thinking?: RuntimeModel["thinking"];
    readonly tools: readonly string[];
    readonly systemPrompt?: string;
}
export interface RuntimeToolCallProgress {
    readonly id: string;
    readonly name: string;
    readonly state: "running" | "completed" | "failed";
}
export type RuntimeHandoffState = "local-running" | "takeover-pending" | "remote-running" | "returning-local" | "completed";
export interface RuntimeAgentHandoff {
    readonly state: RuntimeHandoffState;
    readonly transferred: boolean;
    observe(event: {
        readonly type: string;
    }): void;
    request(launch: () => Promise<void>): Promise<void>;
    waitForTakeover(): Promise<void>;
    takeover(): void;
    waitForResume(): Promise<void>;
    release(reason?: string): void;
}
export interface RuntimeAgentRunControl {
    readonly handoff?: RuntimeAgentHandoff;
    steer(message: string): Promise<void>;
}
export interface RuntimeAgentProgress {
    readonly usage: RuntimeUsage;
    readonly toolCalls: readonly RuntimeToolCallProgress[];
    readonly state?: RuntimeAgentState;
    readonly activity?: {
        readonly kind: "reasoning" | "tool" | "text";
        readonly text: string;
    };
    readonly lastEventAt?: number;
    readonly persist: boolean;
}
export interface RuntimeAgentTurnPolicy {
    beforeTurn(): void;
    afterTurn(usage: RuntimeUsage, final: boolean, requestInstruction?: boolean): string | undefined;
}
export interface RuntimeAgentRunRequest {
    readonly task: string;
    readonly cwd: string;
    readonly model: RuntimeModel;
    readonly enabledTools: readonly string[];
    /** Tools owned by the runtime runner; host-specific adapters may map them at session creation. */
    readonly customTools: readonly RuntimeTool[];
    /** Explicit result schema; omitted agents use the default string workflow_result schema. */
    readonly resultSchema?: RuntimeJsonSchema;
    readonly run: RuntimeRunIdentity;
    readonly agent: RuntimeAgentIdentity;
    readonly signal: AbortSignal;
    readonly timeoutMs?: number | null;
    readonly onProgress?: (progress: RuntimeAgentProgress) => void | Promise<void>;
    readonly handoff?: RuntimeAgentHandoff;
    readonly onControl?: (control: RuntimeAgentRunControl) => void | Promise<void>;
    readonly turnPolicy?: RuntimeAgentTurnPolicy;
    readonly onProviderError?: (failure: RuntimeAgentProviderFailure) => Promise<RuntimeAgentProviderRecovery>;
    readonly onProviderLimit?: () => Promise<void>;
}
export interface RuntimeAgentReference {
    readonly transport: string;
    readonly locator?: RuntimeJsonValue;
}
export interface RuntimeAgentRunResult {
    /** The accepted workflow_result string for unstructured agents, or schema value when resultSchema was requested. */
    readonly value: RuntimeJsonValue;
    readonly usage: RuntimeUsage;
    readonly reference?: RuntimeAgentReference;
}
export interface RuntimeAgentRunner {
    readonly id: string;
    readonly capabilities: {
        readonly customTools: boolean;
        readonly structuredResults: boolean;
        readonly steering: boolean;
        readonly handoff: boolean;
        readonly usage: RuntimeUsageAvailability;
    };
    run(request: Readonly<RuntimeAgentRunRequest>): Promise<RuntimeAgentRunResult>;
}