humanish 0.105.0 → 0.106.1

package/dist/run-detail.js

@@ -1,137 +0,0 @@
-// What ONE run is doing right now (#455).
-//
-// The run index answers "which runs exist and are any alive" for every run in a project, cheaply
-// and without opening evidence. This answers a different question about a SINGLE run — who is in
-// it, what are they thinking, how far have they got — and it does open the bundle, because that is
-// where the answer lives. That trade is only affordable for the one run someone is looking at,
-// which is exactly when it is asked.
-//
-// The shape it reads from is the actor trace (`humanish.actor-trace.v1`), in two places:
-//   - `stream.liveActor` while a run is in flight (the mid-run flush), and
-//   - `stream.actor` once it has finished.
-// Reading both means the same screen renders a run the whole way through rather than going blank
-// at the moment it completes.
-import { readAutomaticStudyAnalysis } from "./automatic-study-analysis.js";
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { estimateActorCostForExecution } from "./pricing.js";
-import { resolveRunPath } from "./run.js";
-export const RUN_DETAIL_SCHEMA = "humanish.run-detail.v1";
-/**
- * The latest reasoning a participant has recorded.
- *
- * Takes the LAST reasoning item rather than the newest by timestamp: the trace is append-ordered by
- * construction, and half of a live flush may not carry `at` yet. An item still in flight is skipped
- * — a partial thought read mid-write would be quoted as though the participant had finished it.
- */
-function latestThought(trace) {
-    const items = trace.items ?? [];
-    for (let index = items.length - 1; index >= 0; index -= 1) {
-        const item = items[index];
-        if (item?.kind !== "reasoning")
-            continue;
-        if (item.lifecycle !== undefined && item.lifecycle !== "completed")
-            continue;
-        const text = typeof item.text === "string" ? item.text.trim() : "";
-        if (text === "")
-            continue;
-        return {
-            text,
-            ...(typeof item.title === "string" && item.title !== "" ? { title: item.title } : {}),
-            ...(typeof item.at === "string" ? { at: item.at } : {})
-        };
-    }
-    return undefined;
-}
-function participantFrom(stream, index) {
-    // A live run's flush wins over the finished trace: while both exist, the live one is the newer
-    // account of what is happening.
-    const trace = stream.liveActor ?? stream.actor ?? {};
-    const id = stream.id ?? `stream-${index + 1}`;
-    const personaId = trace.persona?.id;
-    // Computed once: calling it twice to test-then-use reads as though the two could differ.
-    const thought = latestThought(trace);
-    const status = trace.status ?? stream.status;
-    const thoughts = (trace.items ?? []).filter((item) => item?.kind === "reasoning").length;
-    return {
-        id,
-        label: stream.label ?? personaId ?? id,
-        ...(personaId === undefined ? {} : { personaId }),
-        traits: Array.isArray(trace.persona?.traitsApplied) ? trace.persona.traitsApplied : [],
-        ...(status === undefined ? {} : { status }),
-        ...(trace.completionReason === undefined ? {} : { completionReason: trace.completionReason }),
-        ...(thought === undefined ? {} : { thought }),
-        ...(typeof trace.counts?.turns === "number" ? { turns: trace.counts.turns } : {}),
-        ...(typeof trace.counts?.actions === "number" ? { actions: trace.counts.actions } : {}),
-        ...(thoughts > 0 ? { thoughts } : {}),
-        ...costOf(trace)
-    };
-}
-/**
- * What a participant has spent, priced the same way whether the run is finished or in flight.
- *
- * A finished trace carries its own `estimatedCost`. A live one carries the RUNNING usage and the
- * model it prices at, so the same estimator gives a figure mid-run instead of the screen reporting
- * the cost as unknown until the moment the run ends — which is the half of a run where knowing what
- * it is costing actually changes what you do.
- */
-function costOf(trace) {
-    if (trace.executionProfile?.billing === "account-unknown")
-        return { estimatedCostUsd: null };
-    const recorded = trace.estimatedCost?.estimatedCostUsd;
-    if (recorded !== undefined)
-        return { estimatedCostUsd: recorded };
-    const usage = trace.tokenUsage;
-    const model = trace.ids?.model;
-    if (usage === undefined || typeof model !== "string")
-        return {};
-    try {
-        const estimated = estimateActorCostForExecution(usage, model, trace.executionProfile);
-        // A model `src/pricing.ts` cannot price yields no figure rather than a wrong one.
-        return typeof estimated?.estimatedCostUsd === "number" ? { estimatedCostUsd: estimated.estimatedCostUsd } : {};
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Read one run's participants. Returns null when the run has no readable bundle yet — an ordinary
- * state for a run that has just started, not a failure.
- *
- * Reads the bundle NARROWLY rather than through `loadRunBundle`, which applies the strict
- * evidence-of-record guard. That guard is right for verification and wrong here: a mid-run flush is
- * a partial document by definition, so validating it as a complete bundle would make the live view
- * — the only view that needs this — the one case that never renders. Nothing read here is treated
- * as a claim about what a participant did; it is what to put on a screen.
- */
-export async function readRunDetail(cwdInput, runId) {
-    const runPaths = await resolveRunPath(path.resolve(cwdInput), runId).catch(() => null);
-    if (runPaths === null)
-        return null;
-    let bundle;
-    try {
-        const raw = await readFile(path.join(runPaths.absoluteRunRoot, "run.json"), "utf8");
-        const parsed = JSON.parse(raw);
-        if (parsed === null || typeof parsed !== "object")
-            return null;
-        bundle = parsed;
-    }
-    catch {
-        // Absent or torn: the run has not written one yet, or is writing it now.
-        return null;
-    }
-    const streams = Array.isArray(bundle.streams) ? bundle.streams : [];
-    const cwd = path.resolve(cwdInput);
-    const observerAbsolute = path.join(runPaths.absoluteRunRoot, "observer", "index.html");
-    const automaticAnalysis = await readAutomaticStudyAnalysis(cwd, runId);
-    return {
-        ...(automaticAnalysis === undefined ? {} : { automaticAnalysis }),
-        schema: RUN_DETAIL_SCHEMA,
-        runId: bundle.runId ?? runId,
-        participants: streams.map(participantFrom),
-        ...(observerAbsolute.startsWith(cwd)
-            ? { observerPath: path.relative(cwd, observerAbsolute) }
-            : { observerPath: observerAbsolute })
-    };
-}
-//# sourceMappingURL=run-detail.js.map

package/dist/run-detail.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-detail.js","sourceRoot":"","sources":["../src/run-detail.ts"],"names":[],"mappings":"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"}

package/dist/run-index.d.ts

@@ -1,71 +0,0 @@
-import { type RunLabProvenance, type RunLiveness } from "./run-status.js";
-export declare const RUN_INDEX_SCHEMA = "humanish.run-index.v1";
-export interface RunIndexEntry {
-    runId: string;
-    /** Where the entry's facts came from: the status record, the bundle, or the directory alone. */
-    derivedFrom: "status" | "bundle" | "directory";
-    liveness: RunLiveness;
-    mode?: "dry-run" | "live";
-    /**
-     * The pid that owns a run, when it recorded one. This is how a surface identifies the run IT just
-     * started without minting an id or guessing at a new directory: it spawned a process, and exactly
-     * one run's record carries that pid.
-     */
-    pid?: number;
-    lab?: RunLabProvenance;
-    startedAt?: string;
-    updatedAt?: string;
-    completedAt?: string;
-    verdict?: string;
-    participants?: {
-        total: number;
-        reachedGoal: number;
-        reportedFriction?: number;
-    };
-    estimatedCostUsd?: number | null;
-    /** Wall-clock span when both ends are known; used for per-lab medians. */
-    durationMs?: number;
-}
-export interface RunIndexResult {
-    schema: typeof RUN_INDEX_SCHEMA;
-    cwd: string;
-    /** Newest first, by the best timestamp each entry has. */
-    runs: RunIndexEntry[];
-    /** Directories that could not be read at all, by name — surfaced, never silently dropped. */
-    unreadable: string[];
-}
-/** What a cached entry was derived from, so a changed file invalidates exactly that entry. */
-interface CacheKey {
-    file: string;
-    mtimeMs: number;
-    size: number;
-    ino: number;
-}
-/**
- * A process-lifetime cache. Deliberately explicit rather than module-global state: a caller that
- * refreshes on a cadence keeps one and passes it back, and a caller that wants a cold read passes
- * nothing. Nothing here is authoritative, so a stale slot can only ever cost a re-read.
- */
-export declare class RunIndexCache {
-    private readonly slots;
-    get(runId: string, key: CacheKey): RunIndexEntry | undefined;
-    set(runId: string, key: CacheKey, entry: RunIndexEntry): void;
-    /** Drop entries for runs that no longer exist, so a long-lived surface cannot leak. */
-    retain(runIds: Iterable<string>): void;
-    get size(): number;
-}
-export interface ReadRunIndexOptions {
-    /** Reused across refreshes so unchanged runs are not re-read. */
-    cache?: RunIndexCache;
-    /** Injectable clock, so liveness classification is reproducible in tests. */
-    nowMs?: number;
-    /** Cap the number of runs returned (newest first). The full directory is still enumerated —
-     *  a cap on reads, not on truth — and the count reflects what was read. */
-    limit?: number;
-}
-/**
- * Read every run in `.humanish/runs`, cheapest source first. Never throws for a bad run directory;
- * an unreadable one is named in `unreadable`.
- */
-export declare function readRunIndex(cwdInput: string, options?: ReadRunIndexOptions): Promise<RunIndexResult>;
-export {};

package/dist/run-index.js

@@ -1,206 +0,0 @@
-// The run index (#455 PR 2): list and classify every run in a project WITHOUT parsing bundles.
-//
-// The existing `listRuns` walks each run tree — screenshots included — validating symlinks and
-// then parses each `run.json`: measured 197ms cold / 152ms warm at 25 runs. That is fine for a
-// command that prints once and exits, and much too hot for a surface that refreshes on a cadence
-// over SSH. This module reads the small `status.json` record each run now writes (586 bytes beside
-// a 92KB bundle) and caches per-run entries keyed on the stat of the file each was derived from.
-//
-// HONESTY RULES, unchanged from the record itself:
-//   - `run.json` is the evidence-of-record. Every field here is a projection for listing and
-//     classification; nothing here is a claim about what a participant did.
-//   - A run with no status record is NOT assumed finished. It is classified from what is on disk:
-//     a bundle means finished, receipts without a bundle mean interrupted. That is the honest
-//     reading of a run whose process died — and, before this contract existed, of every run.
-//   - One unreadable run directory degrades that run, never the listing.
-import { readdir, readFile, stat } from "node:fs/promises";
-import path from "node:path";
-import { RUN_STATUS_FILE, classifyRunStatus, inferLegacyLabId, isRunStatusRecord } from "./run-status.js";
-export const RUN_INDEX_SCHEMA = "humanish.run-index.v1";
-/**
- * A process-lifetime cache. Deliberately explicit rather than module-global state: a caller that
- * refreshes on a cadence keeps one and passes it back, and a caller that wants a cold read passes
- * nothing. Nothing here is authoritative, so a stale slot can only ever cost a re-read.
- */
-export class RunIndexCache {
-    slots = new Map();
-    get(runId, key) {
-        const slot = this.slots.get(runId);
-        if (slot === undefined)
-            return undefined;
-        const same = slot.key.file === key.file &&
-            slot.key.mtimeMs === key.mtimeMs &&
-            slot.key.size === key.size &&
-            slot.key.ino === key.ino;
-        return same ? slot.entry : undefined;
-    }
-    set(runId, key, entry) {
-        this.slots.set(runId, { key, entry });
-    }
-    /** Drop entries for runs that no longer exist, so a long-lived surface cannot leak. */
-    retain(runIds) {
-        const keep = new Set(runIds);
-        for (const runId of [...this.slots.keys()]) {
-            if (!keep.has(runId))
-                this.slots.delete(runId);
-        }
-    }
-    get size() {
-        return this.slots.size;
-    }
-}
-async function statKey(file) {
-    try {
-        const stats = await stat(file);
-        return { file, mtimeMs: stats.mtimeMs, size: stats.size, ino: Number(stats.ino) };
-    }
-    catch {
-        return null;
-    }
-}
-async function readJson(file) {
-    try {
-        return JSON.parse(await readFile(file, "utf8"));
-    }
-    catch {
-        // A torn read cannot happen (writes are tmp+rename), so this is a genuinely absent or
-        // malformed file: the caller degrades that run rather than the listing.
-        return null;
-    }
-}
-function entryFromStatus(record, nowMs) {
-    const started = Date.parse(record.startedAt);
-    const ended = record.completedAt === undefined ? Number.NaN : Date.parse(record.completedAt);
-    return {
-        runId: record.runId,
-        derivedFrom: "status",
-        liveness: classifyRunStatus(record, nowMs),
-        mode: record.mode,
-        ...(typeof record.pid === "number" ? { pid: record.pid } : {}),
-        ...(record.lab === undefined ? {} : { lab: record.lab }),
-        startedAt: record.startedAt,
-        updatedAt: record.updatedAt,
-        ...(record.completedAt === undefined ? {} : { completedAt: record.completedAt }),
-        ...(record.outcome?.verdict === undefined ? {} : { verdict: record.outcome.verdict }),
-        ...(record.outcome?.participants === undefined ? {} : { participants: record.outcome.participants }),
-        ...(record.outcome?.estimatedCostUsd === undefined ? {} : { estimatedCostUsd: record.outcome.estimatedCostUsd }),
-        ...(Number.isFinite(started) && Number.isFinite(ended) ? { durationMs: ended - started } : {})
-    };
-}
-function entryFromBundle(runId, bundle) {
-    // A bundle on disk USUALLY means the run reached its final write. But a live run now flushes an
-    // IN-PROGRESS bundle as it goes (so anything asking what a participant is doing has something to
-    // read), and that bundle marks its simulations `running`. Reaching this branch at all means there
-    // was no status record to classify from, so there is no freshness to judge — and the honest
-    // reading of "it started, and nothing here says it finished" is interrupted, not finished.
-    const inProgress = (bundle.simulations ?? []).some((simulation) => simulation?.status === "running");
-    const legacyLabId = bundle.lab === undefined ? inferLegacyLabId(bundle) : undefined;
-    return {
-        runId,
-        derivedFrom: "bundle",
-        liveness: inProgress ? "interrupted" : "finished",
-        ...(bundle.mode === "dry-run" || bundle.mode === "live" ? { mode: bundle.mode } : {}),
-        ...(bundle.lab !== undefined ? { lab: bundle.lab } : legacyLabId === undefined ? {} : { lab: { id: legacyLabId } }),
-        ...(bundle.createdAt === undefined ? {} : { startedAt: bundle.createdAt }),
-        ...(bundle.review?.verdict === undefined ? {} : { verdict: bundle.review.verdict }),
-        ...(bundle.review?.participants === undefined ? {} : { participants: bundle.review.participants }),
-        ...(bundle.cost?.estimatedTotalUsd === undefined ? {} : { estimatedCostUsd: bundle.cost.estimatedTotalUsd })
-    };
-}
-/**
- * Read every run in `.humanish/runs`, cheapest source first. Never throws for a bad run directory;
- * an unreadable one is named in `unreadable`.
- */
-export async function readRunIndex(cwdInput, options = {}) {
-    const cwd = path.resolve(cwdInput);
-    const runsRoot = path.join(cwd, ".humanish", "runs");
-    const nowMs = options.nowMs ?? Date.now();
-    const cache = options.cache;
-    let dirents;
-    try {
-        dirents = await readdir(runsRoot, { withFileTypes: true });
-    }
-    catch {
-        // No runs directory yet is an ordinary empty state, not a failure.
-        return { schema: RUN_INDEX_SCHEMA, cwd, runs: [], unreadable: [] };
-    }
-    const runIds = dirents.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
-    const runs = [];
-    const unreadable = [];
-    for (const runId of runIds) {
-        const runDir = path.join(runsRoot, runId);
-        const statusFile = path.join(runDir, RUN_STATUS_FILE);
-        const bundleFile = path.join(runDir, "run.json");
-        // Cheapest source first: the status record. Its stat is the cache key, so a live run whose
-        // record ticks every 5s re-reads 586 bytes and nothing else.
-        const statusKey = await statKey(statusFile);
-        if (statusKey !== null) {
-            const cached = cache?.get(runId, statusKey);
-            if (cached !== undefined) {
-                // Liveness is time-dependent, so it is recomputed even on a cache hit — a record that has
-                // not changed can still have gone stale since the last read.
-                runs.push(cached.derivedFrom === "status" && cached.updatedAt !== undefined
-                    ? { ...cached, liveness: classifyRunStatus({ state: cached.completedAt === undefined ? "running" : "finished", updatedAt: cached.updatedAt }, nowMs) }
-                    : cached);
-                continue;
-            }
-            const raw = await readJson(statusFile);
-            if (isRunStatusRecord(raw) && raw.runId === runId) {
-                const entry = entryFromStatus(raw, nowMs);
-                cache?.set(runId, statusKey, entry);
-                runs.push(entry);
-                continue;
-            }
-        }
-        // No usable status record: fall back to the bundle. This is every run written before the
-        // contract existed, and it is why an old project still lists correctly.
-        const bundleKey = await statKey(bundleFile);
-        if (bundleKey !== null) {
-            const cached = cache?.get(runId, bundleKey);
-            if (cached !== undefined) {
-                runs.push(cached);
-                continue;
-            }
-            const raw = await readJson(bundleFile);
-            if (raw !== null && typeof raw === "object") {
-                const entry = entryFromBundle(runId, raw);
-                cache?.set(runId, bundleKey, entry);
-                runs.push(entry);
-                continue;
-            }
-            unreadable.push(runId);
-            continue;
-        }
-        // Neither record nor bundle: receipts without an outcome. That is precisely an interrupted
-        // run — the shape a dropped connection leaves — and saying so is more useful than hiding it.
-        runs.push({ runId, derivedFrom: "directory", liveness: "interrupted" });
-    }
-    cache?.retain(runIds);
-    runs.sort((left, right) => sortKey(right) - sortKey(left));
-    return {
-        schema: RUN_INDEX_SCHEMA,
-        cwd,
-        runs: options.limit === undefined ? runs : runs.slice(0, Math.max(0, options.limit)),
-        unreadable
-    };
-}
-/** Newest-first ordering: the most recent thing known about a run, else its id's own timestamp. */
-function sortKey(entry) {
-    for (const candidate of [entry.completedAt, entry.updatedAt, entry.startedAt]) {
-        if (candidate === undefined)
-            continue;
-        const parsed = Date.parse(candidate);
-        if (Number.isFinite(parsed))
-            return parsed;
-    }
-    // Run ids embed an ISO-ish stamp (`cua-2026-08-19T07-44-13-489Z-…`); recover it when present so
-    // a directory-only entry still sorts sensibly instead of sinking to the bottom.
-    const match = /(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z/.exec(entry.runId);
-    if (match) {
-        const parsed = Date.parse(`${match[1]}T${match[2]}:${match[3]}:${match[4]}.${match[5]}Z`);
-        if (Number.isFinite(parsed))
-            return parsed;
-    }
-    return 0;
-}
-//# sourceMappingURL=run-index.js.map

package/dist/run-index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-index.js","sourceRoot":"","sources":["../src/run-index.ts"],"names":[],"mappings":"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"}

package/dist/run-narration-secrets.js

@@ -1,68 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-const scopes = new AsyncLocalStorage();
-const MAX_VALUES = 8192;
-const MAX_BYTES = 1024 * 1024;
-const MAX_VALUE_BYTES = 65_536;
-function usable(scope) {
-    if (scope.closed)
-        throw new Error("TRANSIENT_NARRATION_SCOPE_CLOSED");
-    if (scope.failed)
-        throw new Error("TRANSIENT_NARRATION_SECRET_LIMIT");
-}
-function fail(scope) {
-    scope.failed = true;
-    scope.values.clear();
-    delete scope.pattern;
-    throw new Error("TRANSIENT_NARRATION_SECRET_LIMIT");
-}
-/** Enclose both participant execution and its automatic analysis in one scope. Nested runs isolate too. */
-export async function withTransientCommsSecrets(work) {
-    const scope = { values: new Set(), bytes: 0, closed: false, failed: false };
-    try {
-        return await scopes.run(scope, work);
-    }
-    finally {
-        // Detached work can retain an async context after return. Clear its values and refuse future
-        // scrubbing/registration there; never turn an expired scope into an unprotected analysis.
-        scope.closed = true;
-        scope.values.clear();
-        scope.bytes = 0;
-        delete scope.pattern;
-    }
-}
-export function registerTransientCommsSecrets(values) {
-    const scope = scopes.getStore();
-    if (!scope)
-        return;
-    usable(scope);
-    for (const value of values) {
-        // Match the existing narration registry: short subjects such as "Hi" are ordinary prose.
-        // Received OTP extraction starts at four characters; management keys and addresses are longer.
-        if (value.length < 4 || scope.values.has(value))
-            continue;
-        const bytes = Buffer.byteLength(value);
-        if (bytes > MAX_VALUE_BYTES || scope.values.size >= MAX_VALUES || scope.bytes + bytes > MAX_BYTES)
-            fail(scope);
-        scope.values.add(value);
-        scope.bytes += bytes;
-        delete scope.pattern;
-    }
-}
-/** Literal, longest-first replacement in one pass; replacement text is never matched recursively. */
-export function scrubTransientCommsText(text) {
-    const scope = scopes.getStore();
-    if (!scope)
-        return text;
-    usable(scope);
-    if (!scope.values.size)
-        return text;
-    try {
-        scope.pattern ??= new RegExp([...scope.values].sort((a, b) => b.length - a.length)
-            .map(value => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|"), "g");
-        return text.replace(scope.pattern, "[REDACTED_SECRET]");
-    }
-    catch {
-        return fail(scope);
-    }
-}
-//# sourceMappingURL=run-narration-secrets.js.map

package/dist/run-narration-secrets.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-narration-secrets.js","sourceRoot":"","sources":["../src/run-narration-secrets.ts"],"names":[],"mappings":"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"}

package/dist/run-paths.d.ts

@@ -1,56 +0,0 @@
-export declare const RUNS_RELATIVE_ROOT: string;
-export declare const LATEST_RUN_RELATIVE_PATH: string;
-export interface RunArtifactPaths {
-    absoluteRunRoot: string;
-    relativeRunRoot: string;
-    absoluteLatestPointer: string;
-    relativeLatestPointer: string;
-}
-export interface PreparedRunArtifactPaths extends RunArtifactPaths {
-    readonly physicalLatestPointer: string;
-    readonly physicalRunRoot: string;
-    readonly physicalRunsRoot: string;
-    readonly runRootIdentity: FileIdentity;
-    readonly runsRootIdentity: FileIdentity;
-}
-interface FileIdentity {
-    readonly birthtimeNs: bigint;
-    readonly dev: bigint;
-    readonly ino: bigint;
-}
-export interface LatestRunPathPointer {
-    runId: string;
-    path: string;
-}
-/**
- * Run ids are directory names, not paths. Keep the accepted grammar broad so
- * existing runs remain readable while rejecting every path-shaped input.
- */
-export declare function isSafeRunIdSegment(runId: string): boolean;
-export declare function resolveRunsRoot(cwdInput: string): string;
-export declare function resolveRunDirectory(cwdInput: string, runId: string): string;
-export declare function tryResolveRunDirectory(cwdInput: string, runId: string): string | null;
-export declare function resolveRunArtifactPaths(cwdInput: string, runId: string): RunArtifactPaths;
-export declare function prepareRunArtifactPaths(cwdInput: string, runId: string): Promise<PreparedRunArtifactPaths>;
-export declare function validatePreparedRunArtifactPaths(prepared: PreparedRunArtifactPaths): Promise<PreparedRunArtifactPaths>;
-/** Cheap revalidation for repeated contained reads/writes within one prepared run. */
-export declare function validatePreparedRunRootIdentity(prepared: PreparedRunArtifactPaths): Promise<PreparedRunArtifactPaths>;
-/** Bind an already-existing safe run as a new identity; this is not prior-preparation proof. */
-export declare function bindExistingRunArtifactPaths(cwdInput: string, runId: string): Promise<PreparedRunArtifactPaths>;
-export declare function resolveExistingRunDirectory(cwdInput: string, runId: string): Promise<string | null>;
-/**
- * A latest pointer is valid only when both fields identify the same direct
- * child of .humanish/runs. Callers must never use pointer.path directly.
- */
-export declare function resolveLatestRunDirectory(cwdInput: string, pointer: LatestRunPathPointer): string | null;
-export declare function resolveExistingLatestRunDirectory(cwdInput: string, pointer: LatestRunPathPointer): Promise<string | null>;
-export declare function isRegularHumanishStorageFile(cwdInput: string, ...segments: string[]): Promise<boolean>;
-export declare function prepareHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string>;
-export declare function prepareReusableHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string>;
-export declare function prepareExclusiveHumanishStorageDirectories(cwdInput: string, segmentSets: string[][]): Promise<string[]>;
-export declare function prepareExclusiveHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string>;
-export declare function prepareHumanishStorageFile(cwdInput: string, ...segments: string[]): Promise<string>;
-export declare function resolveHumanishStorageDirectory(cwdInput: string, ...segments: string[]): string;
-export declare function resolveExistingHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string | null>;
-export declare function isPathInside(rootInput: string, candidateInput: string): boolean;
-export {};