import type { MaybePromise, ShellActionResult } from "./types.js";
export declare const COMMAND_BATCH_RESULT_SCHEMA = "pi-workflows.command-batch-result.v1";
export declare const MAX_COMMAND_BATCH_ITEMS = 64;
export declare const MAX_COMMAND_BATCH_CONCURRENCY = 8;
export declare const MAX_COMMAND_BATCH_TIMEOUT_MS: number;
export declare const MAX_COMMAND_BATCH_OUTPUT_CHARS = 1000000;
export type CommandBatchItem = {
    id: string;
    command: string;
    args: string[];
    cwd: string;
    timeoutMs: number;
    maxOutputChars: number;
};
export type CommandBatchRequest = {
    items: CommandBatchItem[];
    maxConcurrency: number;
};
export type CommandBatchItemOutcome = "succeeded" | "failed" | "timedOut" | "cancelled";
export type CommandBatchItemResult = ShellActionResult & {
    id: string;
    outcome: CommandBatchItemOutcome;
    stdoutTruncated: boolean;
    stderrTruncated: boolean;
    error?: string;
};
export type CommandBatchResult = {
    schema: typeof COMMAND_BATCH_RESULT_SCHEMA;
    items: CommandBatchItemResult[];
    completed: number;
    total: number;
};
export type RunCommandBatchOptions = {
    signal?: AbortSignal;
    onItemSettled?: (result: CommandBatchItemResult, completed: number, total: number) => MaybePromise<void>;
};
export declare function validateCommandBatchRequest(value: unknown): CommandBatchRequest;
export declare function runCommandBatch(input: CommandBatchRequest, options?: RunCommandBatchOptions): Promise<CommandBatchResult>;