import { type CanonicalGjcWorkflowSkill } from "../skill-state/active-state";
/**
 * Native implementation of the `gjc state read|write|clear` command surface.
 *
 * Simple file-receipt operations against session-scoped state under
 * `.gjc/_session-{id}/state/`. This is the sanctioned CLI mediator for
 * mutation-guarded GJC state — agents call it instead of editing those files directly.
 */
export interface StateCommandResult {
    status: number;
    stdout?: string;
    stderr?: string;
}
type StateWarningSink = (warning: string) => void;
/**
 * Reconcile a workflow skill's mode-state + active-state/HUD from a caller-derived
 * payload. Unlike `gjc state write`, this is a derived repair: callers reconcile from
 * an authoritative source (e.g. the ultragoal plan/ledger), where intermediate
 * aggregate phases like ultragoal `active -> pending` are legitimate, so it bypasses
 * ONLY verb transition-edge validation while preserving schema validation,
 * unknown-phase rejection, version/checksum stamping, and audit/out-of-band tamper
 * detection. Receipts carry `owner: "gjc-runtime"` and `verb: "reconcile"` so the
 * provenance is distinguishable from a user-initiated write.
 */
export declare function reconcileWorkflowSkillState(options: {
    cwd: string;
    mode: CanonicalGjcWorkflowSkill;
    sessionId?: string;
    threadId?: string;
    turnId?: string;
    active: boolean;
    phase: string;
    payload: Record<string, unknown>;
    sourceRevision?: number;
}): Promise<{
    stateFile: string;
}>;
export declare function readWorkflowStateJson(cwd: string, skill: CanonicalGjcWorkflowSkill, sessionId?: string, onWarning?: StateWarningSink): Promise<Record<string, unknown>>;
export declare function runNativeStateCommand(args: string[], cwd?: string): Promise<StateCommandResult>;
export {};