/**
 * Structured output types.
 */
/** Structured file entry in a flow's output. */
export interface FileEntry {
    /** Path to the file, relative or absolute. */
    path: string;
    /** Semantic role of this file in the flow's work. */
    role?: "reference" | "read" | "modified" | "created" | "deleted" | "test";
    /** Why this file matters (1 sentence). */
    description?: string;
    /** Short excerpt or snippet (not full content). */
    snippet?: string;
    /** Specific line ranges of interest. */
    ranges?: Array<{
        start: number;
        end: number;
        /** Free-form label like "bug", "fix", "ref", "added". */
        label?: string;
    }>;
}
/** Structured command/tool invocation entry in a flow's output. */
export interface CommandEntry {
    /** The exact verbatim command string or tool call that was executed. */
    command: string;
    /** Tool used: bash, grep, find, ls, batch, read, write, edit, flow, web. */
    tool?: string;
    /** Execution time classification from the timed bash wrapper (e.g. "3.5s (normal)"). */
    executionTime?: string;
}
/** Action performed or attempted by a flow. */
export interface Action {
    type: string;
    description: string;
    target?: string;
    result?: "success" | "failure" | "partial" | "skipped";
    evidence?: string;
}
/** Incomplete, skipped, blocked, or deferred work reported by a flow. */
export interface NotDoneItem {
    /** The unfinished item. */
    item: string;
    /** Why the item was not completed. */
    reason?: string;
    /** Concrete blocker preventing completion, when applicable. */
    blocker?: string;
    /** Suggested follow-up for this item. */
    nextStep?: string;
}
/** Structured JSON output from a flow run. */
export interface FlowStructuredOutput {
    /** Schema version for forward compatibility. */
    version: string;
    /** Overall completion status. */
    status: "complete" | "partial" | "blocked" | "failed";
    /** 1–3 sentence summary of what was accomplished. */
    summary: string;
    /** Files touched, read, or referenced. */
    files: FileEntry[];
    /** Actions performed or attempted. */
    actions: Action[];
    /** Commands or tool calls executed during the flow. */
    commands: CommandEntry[];
    /** Incomplete, skipped, blocked, or deferred work. */
    notDone: NotDoneItem[];
    /** Recommended next steps or follow-up flows. */
    nextSteps: string[];
    /** Reasoning chains, hypotheses, inferences made during the flow. */
    reasoning: string[];
    /** Observations, warnings, caveats, side notes. */
    notes: string[];
    /** Audit verdict: pass or rework. Used by the audit flow to signal whether the audited work needs rework. */
    verdict?: "pass" | "rework";
    /** Audit feedback: required when verdict is 'rework'; optional free-form text when 'pass'. Contains specific actionable findings. */
    feedback?: string;
    /** Per-build verdicts when an audit reviews multiple builds. Each entry maps a build index to its verdict and optional feedback. */
    builds?: Array<{
        index: number;
        verdict: "pass" | "rework";
        feedback?: string;
    }>;
    /** Escape hatch for flow-specific data (audit findings, debug root cause, etc.). */
    extensions?: Record<string, unknown>;
}
/** Structured JSON output from a trace flow run. */
export interface TraceStructuredOutput {
    /** A 1–3 sentence orientation summary of what was looked at and why it matters (under 50 words). */
    note: string;
    /** The tool call IDs containing the verbatim evidence. */
    tool_ids: string[];
}
//# sourceMappingURL=output.d.ts.map