import { type WorkflowTaskOptions } from "./shared.js";
export interface WorkflowResetOptions extends WorkflowTaskOptions {
    /** Item GUID or content-tree path. Required. */
    item: string;
    /** Plan-only — don't issue the field write. */
    whatIf?: boolean;
    /** Per-invocation write gate override. */
    allowWrite?: boolean;
}
export type WorkflowResetStatus = "reset" | "what-if" | "failed" | "skipped-no-workflow" | "skipped-already-initial";
export interface WorkflowResetResult {
    itemId: string | null;
    path: string | null;
    workflowName: string | null;
    fromState: string | null;
    toStateId: string | null;
    status: WorkflowResetStatus;
    message?: string;
}
/**
 * Force an item back to its workflow's initial state.
 *
 * **Bypasses the workflow engine.** No validation actions fire. No
 * submit actions fire. The item's `__Workflow state` field is rewritten
 * directly via `updateItem`. Workflow history is not appended.
 *
 * Use this as an admin escape hatch — recovering a stuck item that
 * the validation chain blocks, or resetting test items after a dry
 * run. For normal day-to-day transitions, use `runWorkflowAdvance`
 * which routes through `executeWorkflowCommand` and respects the
 * workflow definition.
 */
export declare const runWorkflowReset: (options: WorkflowResetOptions) => Promise<WorkflowResetResult>;