import { type WorkflowTaskOptions } from "./shared.js";
export interface WorkflowAdvanceOptions extends WorkflowTaskOptions {
    /** Item GUID or content-tree path. Required. */
    item: string;
    /** Workflow command display name (case-insensitive). Required. */
    command: string;
    /** Comment recorded with the workflow execution (audit trail). */
    comments?: string;
    /** Plan-only — don't issue the mutation. */
    whatIf?: boolean;
    /** Per-invocation write gate override (matches the `cleanup` `--allow-write` flag). */
    allowWrite?: boolean;
}
export type WorkflowAdvanceStatus = "advanced" | "what-if" | "failed" | "skipped-no-workflow" | "skipped-final" | "skipped-no-command";
export interface WorkflowAdvanceResult {
    itemId: string | null;
    path: string | null;
    workflowName: string | null;
    fromState: string | null;
    toState: string | null;
    commandRequested: string;
    commandUsed: string | null;
    status: WorkflowAdvanceStatus;
    message?: string;
}
export declare const runWorkflowAdvance: (options: WorkflowAdvanceOptions) => Promise<WorkflowAdvanceResult>;