import type { Workflow } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
/** Return value of {@link useWorkflow}. */
export interface UseWorkflowReturn {
    /** The resolved Workflow, or `null` while loading, on error, or when not found. */
    readonly workflow: Workflow | null;
    /** `true` while the initial fetch or a refetch is in flight. */
    readonly isLoading: boolean;
    /** `true` while a background refetch is in flight and stale data is shown. */
    readonly isRefetching: boolean;
    /** Error from the last failed request, or `null` when healthy. */
    readonly error: Error | null;
    /** Discard cached data and re-fetch the workflow from the server. */
    readonly refetch: () => void;
}
/**
 * Data hook that fetches a single Workflow blueprint by organization and slug.
 *
 * Wraps `stigmer.workflow.getByReference()` with loading, error, and
 * not-found state management. When the `org` or `slug` parameters
 * change, the previous in-flight request is discarded and a fresh
 * fetch begins.
 *
 * Pass `null` for either `org` or `slug` to skip fetching (stable
 * no-op). This is useful when the slug is not yet available — for
 * example, while a parent component is still resolving route params.
 *
 * **Not-found handling:** If the API returns a 404 (NOT_FOUND), the
 * hook sets `workflow` to `null` without raising an error. Consumers
 * distinguish "not found" from "loading" by checking all three fields:
 * `workflow === null && !isLoading && !error` means the resource does
 * not exist.
 *
 * @example
 * ```tsx
 * function WorkflowDetail({ org, slug }: { org: string; slug: string }) {
 *   const { workflow, isLoading, error } = useWorkflow(org, slug);
 *
 *   if (isLoading) return <Skeleton />;
 *   if (error) return <ErrorMessage error={error} />;
 *   if (!workflow) return <NotFound />;
 *
 *   return <h1>{workflow.metadata?.name}</h1>;
 * }
 * ```
 */
export declare function useWorkflow(org: string | null, slug: string | null): UseWorkflowReturn;
//# sourceMappingURL=useWorkflow.d.ts.map