import { type SpawnParallelOptions } from "../../../agent-spawn/dist/parallel.js";
import { type SpawnUsage } from "../../../agent-spawn/dist/types.js";
import { type OtelSink } from "../observability/otel.js";
export type AgentSpawnMode = "read" | "edit" | "auto" | "yolo";
export type AgentModuleMcpServer = {
    command: string;
    args?: string[];
    env?: Record<string, string>;
    timeout?: number;
};
export type AgentModuleMcpConfig = Record<string, AgentModuleMcpServer>;
export type AgentModuleDefinition = string | {
    agent: string;
    prompt?: string;
    model?: string;
    mode?: AgentSpawnMode;
    cwd?: string;
    mcp?: AgentModuleMcpConfig;
};
export type AgentModuleSpawnOptions = {
    prompt: string;
    label?: string;
    mcp?: AgentModuleMcpConfig;
    model?: string;
    mode?: AgentSpawnMode;
    cwd?: string;
    otelSink?: OtelSink;
    timeoutMs?: number;
    signal?: AbortSignal;
};
export type SpawnAgentInput = Omit<AgentModuleSpawnOptions, "label"> & {
    agent: string;
};
export type SpawnAgentResult = {
    exitCode: number;
    stdout: string;
    stderr: string;
    summary: string;
    durationMs: number;
    usage?: SpawnUsage;
};
export type SpawnAgent = (input: SpawnAgentInput) => Promise<SpawnAgentResult>;
export type AgentModuleOptions = {
    defaultRetry?: AgentModuleRetryOptions;
    onEvent?: (event: AgentSpawnEvent) => void | Promise<void>;
    otelSink?: OtelSink;
};
export type AgentSpawnEvent = {
    type: "spawn.started";
    spawnId: number;
    agent: string;
    task: string;
    attempt: number;
    maxAttempts: number;
} | {
    type: "spawn.retry";
    spawnId: number;
    agent: string;
    task: string;
    attempt: number;
    maxAttempts: number;
    delayMs: number;
    error: string;
} | {
    type: "spawn.succeeded";
    spawnId: number;
    agent: string;
    task: string;
    attempt: number;
    maxAttempts: number;
    durationMs: number;
} | {
    type: "spawn.failed";
    spawnId: number;
    agent: string;
    task: string;
    attempt: number;
    maxAttempts: number;
    durationMs: number;
    error: string;
} | {
    type: "spawn.cancelled";
    spawnId: number;
    agent: string;
    task: string;
    attempt: number;
    maxAttempts: number;
    durationMs: number;
    reason: string;
};
export type SpawnUsageTotal = {
    inputTokens: number;
    outputTokens: number;
    cachedTokens: number;
    costUsd?: number;
    spawnCount: number;
    attemptCount?: number;
};
export type SpawnUsageAccumulator = {
    beginAttempt?(): void;
    beginSpawn?(): void;
    record(usage: SpawnUsage | undefined): void;
    reset(): void;
    snapshot(): SpawnUsageTotal;
};
export declare function createSpawnUsageAccumulator(): SpawnUsageAccumulator;
export declare function runWithSpawnUsageAccumulator<TResult>(accumulator: SpawnUsageAccumulator, operation: () => Promise<TResult>): Promise<TResult>;
export type AgentModuleRetryOptions = {
    maxAttempts: number;
    backoffMs: number;
    isErrorRetryable?: (error: unknown) => boolean;
    isRetryable?: (result: SpawnAgentResult) => boolean;
};
export type AgentModuleParallelCall = readonly [agentDef: AgentModuleDefinition, options: AgentModuleSpawnOptions] | ((signal?: AbortSignal) => {
    events: AsyncIterable<never>;
    result: Promise<SpawnAgentResult>;
});
type AgentModuleSpawn = {
    (agentDef: AgentModuleDefinition, options: AgentModuleSpawnOptions): Promise<SpawnAgentResult>;
    retry(agentDef: AgentModuleDefinition, options: AgentModuleSpawnOptions, retryOptions: AgentModuleRetryOptions): Promise<SpawnAgentResult>;
    parallel(calls: AgentModuleParallelCall[], options?: SpawnParallelOptions): Promise<SpawnAgentResult[]>;
};
export declare function makeAgentModule(spawnAgent: SpawnAgent, moduleOptions?: AgentModuleOptions): {
    spawn: AgentModuleSpawn;
};
export {};