/**
 * Structured-adaptive tool orchestration for the selectable structured loop.
 * Batches concurrency-safe tools, keeps stateful tools serial, and returns
 * ordered tool_result messages matching assistant tool_use order.
 * [WHO]: StructuredAdaptiveToolCall, StructuredAdaptiveToolRunResult, runStructuredAdaptiveTools, runToolBatch, resolveMaxToolConcurrency, buildToolMap, partitionStructuredAdaptiveToolCalls, isStructuredAdaptiveToolCallConcurrencySafe, resolveStructuredAdaptiveToolInterruptBehavior, runStructuredAdaptiveToolUse, extractApprovalRequired
 * [FROM]: @catui/ai
 * [TO]: Consumed by core/lib/agent-core/src/agent-loop.ts, core/lib/agent-core/src/index.ts, core/lib/agent-core/src/structured-adaptive-streaming-tool-executor.ts
 * [HERE]: core/lib/agent-core/src/structured-adaptive-tool-orchestration.ts - owned by core/lib/agent-core/AGENT.md
 */
import { type AssistantMessage, type ToolResultMessage } from "@catui/ai/types";
import { EventStream } from "@catui/ai/events";
import type { AgentEvent, AgentLoopConfig, AgentMessage, AgentTool, AgentToolPermissionDenial } from "./types.js";
export type StructuredAdaptiveToolCall = Extract<AssistantMessage["content"][number], {
    type: "toolCall";
}>;
export interface StructuredAdaptiveToolRunResult {
    toolResults: ToolResultMessage[];
    contextMessages: AgentMessage[];
    steeringMessages?: AgentMessage[];
    permissionDenials: AgentToolPermissionDenial[];
    approvalRequired?: {
        checkpointId: string;
        policyId?: string;
        toolCallId: string;
    };
}
interface StructuredAdaptiveToolUseResult {
    toolResult: ToolResultMessage;
    contextMessages: AgentMessage[];
}
export declare function runStructuredAdaptiveTools(toolCalls: StructuredAdaptiveToolCall[], tools: AgentTool<any>[] | undefined, signal: AbortSignal | undefined, stream: EventStream<AgentEvent, AgentMessage[]>, getSteeringMessages?: AgentLoopConfig["getSteeringMessages"], maxConcurrency?: number, canUseTool?: AgentLoopConfig["canUseTool"], toolPolicies?: AgentLoopConfig["toolPolicies"], checkpointStore?: AgentLoopConfig["checkpointStore"], checkpointTtlMs?: number, sessionId?: string, messageCount?: number): Promise<StructuredAdaptiveToolRunResult>;
export declare function runToolBatch<T, TResult>(items: T[], run: (item: T) => Promise<TResult>, maxConcurrency: number | undefined): Promise<TResult[]>;
export declare function resolveMaxToolConcurrency(maxConcurrency: number | undefined): number;
export declare function buildToolMap(tools: AgentTool<any>[] | undefined): Map<string, AgentTool<any>>;
export declare function partitionStructuredAdaptiveToolCalls(toolCalls: StructuredAdaptiveToolCall[], toolByName: Map<string, AgentTool<any>>): StructuredAdaptiveToolCall[][];
export declare function isStructuredAdaptiveToolCallConcurrencySafe(toolCall: StructuredAdaptiveToolCall, tool: AgentTool<any> | undefined): boolean;
export declare function resolveStructuredAdaptiveToolInterruptBehavior(toolCall: StructuredAdaptiveToolCall, tool: AgentTool<any> | undefined): "cancel" | "block";
export declare function runStructuredAdaptiveToolUse(toolCall: StructuredAdaptiveToolCall, tool: AgentTool<any> | undefined, signal: AbortSignal | undefined, stream: EventStream<AgentEvent, AgentMessage[]>, canUseTool?: AgentLoopConfig["canUseTool"], toolPolicies?: AgentLoopConfig["toolPolicies"], checkpointStore?: AgentLoopConfig["checkpointStore"], checkpointTtlMs?: number, sessionId?: string, messageCount?: number): Promise<StructuredAdaptiveToolUseResult>;
export declare function extractApprovalRequired(result: ToolResultMessage): {
    checkpointId: string;
    policyId?: string;
    toolCallId: string;
} | undefined;
export {};