import type { SessionView, WorkUnit } from './types.js';
/** The subdirectory of an evidence root the walkthrough author writes under. */
export declare const WALKTHROUGH_AUTHOR_SUBDIR = "author";
/**
 * A run id usable as ONE path segment (`[A-Za-z0-9._-]`, not starting with `.`, ≤ 128 chars) — the
 * engine's step-id rule. `POST /runs` takes a caller-chosen `sessionId`, so anything else (`../x`)
 * gets no evidence root rather than a directory outside `WICKED_WALKTHROUGH_DIR` (codex on #758).
 */
export declare function isPlainRunId(runId: string): boolean;
/** The run's evidence root. Throws for a run id that is not one plain path segment ({@link isPlainRunId}). */
export declare function walkthroughRootDir(runId: string): string;
/** The step id of a unit (`<run>:<step>` → `<step>`). */
export declare function stepIdOf(view: SessionView, unit: WorkUnit): string;
/**
 * The PROOF ROOT of a `walkthrough_review` step — `<session.evidence_root>/<step>` — only when it is a
 * plain directory directly under the evidence root (never through a planted link: the engine's
 * `check_proof_root` rule), and its step id is one plain path segment other than `author`. `null`
 * otherwise, and for a run with no evidence root.
 */
export declare function walkthroughProofRoot(view: SessionView, review: WorkUnit): Promise<string | null>;
//# sourceMappingURL=walkthrough-root.d.ts.map