import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
/**
 * Lifecycle phases for the workflow explain flow.
 *
 * Simplified single-turn flow (no multi-turn, no YAML extraction):
 * - `idle` — not started
 * - `starting` — creating session + execution
 * - `streaming` — agent is working
 * - `complete` — explanation received
 * - `error` — something failed
 */
export type ExplainPhase = "idle" | "starting" | "streaming" | "complete" | "error";
/** Options for {@link useExplainWorkflowFlow}. */
export interface UseExplainWorkflowFlowOptions {
    /** Organization slug. */
    readonly org: string;
    /** Current workflow YAML to explain. */
    readonly currentYaml: string;
    /** Called on error. */
    readonly onError?: (message: string) => void;
}
/** Return value of {@link useExplainWorkflowFlow}. */
export interface UseExplainWorkflowFlowReturn {
    readonly phase: ExplainPhase;
    readonly explanation: string | null;
    readonly execution: AgentExecution | null;
    readonly isStreaming: boolean;
    readonly error: string | null;
    readonly explain: () => Promise<void>;
    readonly reset: () => void;
}
/**
 * Behavior hook for the "Explain Workflow" feature.
 *
 * Single-turn flow using the `workflow-architect` agent with
 * `action: "no_changes"` (explanation only, no YAML returned).
 *
 * @since T14 (AI-Assisted Workflow Creation)
 */
export declare function useExplainWorkflowFlow(options: UseExplainWorkflowFlowOptions): UseExplainWorkflowFlowReturn;
//# sourceMappingURL=useExplainWorkflowFlow.d.ts.map