agent-hitch 0.2.6 → 0.2.8

package/dist/src/cli/commands/trajectory.js

@@ -1,11 +1,18 @@
 import path from "node:path";
 import { HitchError, SCHEMA_VERSION, invalidInput, statePaths } from "../../foundation/index.js";
-import { loadTrajectoryRef, readTrajectory } from "../../trajectories/index.js";
-import { assertNoArgs, takeFlag } from "../arguments.js";
+import { DEFAULT_ANALYSIS_MAX_BYTES, DEFAULT_EVENTS_LIMIT, DEFAULT_EVENTS_MAX_BYTES, loadCanonicalTrajectorySource, loadTrajectoryRef, pageTrajectoryEvents, projectTrajectoryAnalysis, readTrajectory, serializeBoundedJson, } from "../../trajectories/index.js";
+import { assertNoArgs, takeFlag, takeOption } from "../arguments.js";
 export async function trajectoryCommand(args, root) {
     const action = args.shift();
-    if (action !== "inspect")
-        throw invalidInput("trajectory requires inspect");
+    if (action === "inspect")
+        return inspectTrajectory(args, root);
+    if (action === "project")
+        return projectTrajectory(args, root);
+    if (action === "events")
+        return eventsTrajectory(args, root);
+    throw invalidInput("trajectory requires inspect, project, or events");
+}
+async function inspectTrajectory(args, root) {
     const json = takeFlag(args, "--json");
     const runId = args.shift();
     if (!runId)
@@ -18,7 +25,7 @@ export async function trajectoryCommand(args, root) {
     }
     const { header, events } = await readTrajectory(ref.path);
     if (json) {
-        process.stdout.write(`${JSON.stringify({ schema_version: SCHEMA_VERSION, run_id: runId, ref, header, events }, null, 2)}\n`);
+        process.stdout.write(`${JSON.stringify({ schema_version: SCHEMA_VERSION, run_id: runId, ref, header, events })}\n`);
         return;
     }
     process.stdout.write(`${runId}: ${ref.fidelity} trajectory (${events.length} events)\n`);
@@ -28,4 +35,88 @@ export async function trajectoryCommand(args, root) {
     const toolResults = events.filter((event) => event.type === "tool/result");
     process.stdout.write(`  assistant messages: ${assistantMessages.length}, tool results: ${toolResults.length}\n`);
 }
+async function projectTrajectory(args, root) {
+    const json = takeFlag(args, "--json");
+    const profile = takeOption(args, "--profile") ?? "analysis";
+    const maxBytes = integerOption(takeOption(args, "--max-bytes"), DEFAULT_ANALYSIS_MAX_BYTES, "--max-bytes", 1);
+    const runId = args.shift();
+    if (!runId)
+        throw invalidInput("trajectory project requires a run ID");
+    if (profile !== "analysis")
+        throw invalidInput("trajectory project --profile must be analysis");
+    assertNoArgs(args);
+    const source = await requireSource(root, runId);
+    const result = await projectTrajectoryAnalysis(source, { maxBytes });
+    if (json) {
+        process.stdout.write(serializeBoundedJson(result, maxBytes));
+        return;
+    }
+    process.stdout.write(`${runId}: bounded trajectory analysis\n`);
+    process.stdout.write(`  source: ${result.source.event_count} events, ${result.source.canonical_bytes} bytes\n`);
+    process.stdout.write(`  surface: ${result.surface.current_node_seqs.length} current nodes\n`);
+    process.stdout.write(`  diagnostic: ${result.events.length} events, ${result.chunk_summaries.length} chunk summaries\n`);
+}
+async function eventsTrajectory(args, root) {
+    const json = takeFlag(args, "--json");
+    const typesValue = takeOption(args, "--types");
+    const seqStartValue = takeOption(args, "--seq-start");
+    const seqEndValue = takeOption(args, "--seq-end");
+    const field = takeOption(args, "--field");
+    const canonicalSha256Value = takeOption(args, "--canonical-sha256");
+    const cursor = takeOption(args, "--cursor");
+    const limit = integerOption(takeOption(args, "--limit"), DEFAULT_EVENTS_LIMIT, "--limit", 1);
+    const maxBytes = integerOption(takeOption(args, "--max-bytes"), DEFAULT_EVENTS_MAX_BYTES, "--max-bytes", 1);
+    const runId = args.shift();
+    if (!runId)
+        throw invalidInput("trajectory events requires a run ID");
+    assertNoArgs(args);
+    const hasFilter = typesValue !== undefined || seqStartValue !== undefined || seqEndValue !== undefined || field !== undefined;
+    const filter = hasFilter ? {
+        ...(typesValue === undefined ? {} : { types: typesValue.split(",") }),
+        ...(seqStartValue === undefined ? {} : { seq_start: integerOption(seqStartValue, 0, "--seq-start") }),
+        ...(seqEndValue === undefined ? {} : { seq_end: integerOption(seqEndValue, 0, "--seq-end") }),
+        ...(field === undefined ? {} : { field }),
+    } : undefined;
+    if (canonicalSha256Value !== undefined && !/^sha256:[a-f0-9]{64}$/.test(canonicalSha256Value)) {
+        throw invalidInput("--canonical-sha256 must be a sha256 digest");
+    }
+    const source = await requireSource(root, runId);
+    const result = await pageTrajectoryEvents(source, {
+        limit,
+        maxBytes,
+        ...(filter === undefined ? {} : { filter }),
+        ...(cursor === undefined ? {} : { cursor }),
+        ...(canonicalSha256Value === undefined ? {} : { canonicalSha256: canonicalSha256Value }),
+    });
+    if (json) {
+        process.stdout.write(serializeBoundedJson(result, maxBytes, "trajectory_events_page_overflow"));
+        return;
+    }
+    process.stdout.write(`${runId}: ${result.events.length}/${result.total_matches} matching trajectory events${result.eof ? " (end)" : ""}\n`);
+    for (const event of result.events) {
+        const row = event;
+        process.stdout.write(`  ${row.seq ?? "?"}  ${row.type ?? "unknown"}\n`);
+    }
+    if (result.next_cursor)
+        process.stdout.write(`  next cursor: ${result.next_cursor}\n`);
+}
+async function requireSource(root, runId) {
+    if (!/^run_[a-f0-9]{32}$/.test(runId))
+        throw invalidInput("trajectory requires a valid run ID");
+    const runDirectory = path.join(statePaths(root).runs, runId);
+    const source = await loadCanonicalTrajectorySource(runDirectory, runId);
+    if (!source) {
+        throw new HitchError(`run ${runId} has no canonical trajectory`, { code: "trajectory_not_found", exitCode: 3 });
+    }
+    return source;
+}
+function integerOption(value, fallback, name, minimum = 0) {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < minimum) {
+        throw invalidInput(`${name} must be ${minimum === 0 ? "a non-negative" : "a positive"} safe integer`);
+    }
+    return parsed;
+}
 //# sourceMappingURL=trajectory.js.map

package/dist/src/cli/commands/trajectory.js.map

@@ -1 +1 @@
-{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../../../src/cli/commands/trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAc,EAAE,IAAY;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,YAAY,CAAC,6BAA6B,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,IAAI,CAAC,KAAK;QAAE,MAAM,YAAY,CAAC,sCAAsC,CAAC,CAAC;IACvE,YAAY,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,UAAU,CAAC,OAAO,KAAK,8BAA8B,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7H,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,KAAK,GAAG,CAAC,QAAQ,gBAAgB,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;IACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;IAC9C,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,iBAAiB,CAAC,MAAM,mBAAmB,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC;AACnH,CAAC"}
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../../../src/cli/commands/trajectory.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/verifier.js

@@ -0,0 +1,36 @@
+import { invalidInput } from "../../foundation/index.js";
+import { loadVerifierEvidence } from "../../runs/index.js";
+import { assertNoArgs, takeFlag } from "../arguments.js";
+export async function verifierCommand(args, root) {
+    const action = args.shift();
+    if (action !== "inspect")
+        throw invalidInput("verifier requires inspect");
+    const json = takeFlag(args, "--json");
+    const runId = args.shift();
+    if (!runId || !/^run_[a-f0-9]{32}$/.test(runId)) {
+        throw invalidInput("verifier inspect requires a valid run ID");
+    }
+    assertNoArgs(args);
+    const evidence = await loadVerifierEvidence(root, runId);
+    if (json) {
+        process.stdout.write(`${JSON.stringify(evidence, null, 2)}\n`);
+        return;
+    }
+    process.stdout.write(`${runId}: verifier ${evidence.verifier.status}\n`);
+    if (evidence.observation) {
+        const reward = evidence.observation.reward === undefined ? "" : `, reward ${evidence.observation.reward}`;
+        process.stdout.write(`  observation: ${evidence.observation.status}${reward}\n`);
+    }
+    const diagnostics = evidence.verifier.diagnostics;
+    if (diagnostics) {
+        const artifacts = [
+            ...(diagnostics.ctrf ? [diagnostics.ctrf] : []),
+            ...(diagnostics.stdout ?? []),
+            ...(diagnostics.stderr ?? []),
+        ];
+        process.stdout.write(`  diagnostics: ${artifacts.map((artifact) => artifact.name).join(", ") || "structured only"}\n`);
+    }
+    for (const issue of evidence.verifier.issues ?? [])
+        process.stdout.write(`  issue: ${issue}\n`);
+}
+//# sourceMappingURL=verifier.js.map

package/dist/src/cli/commands/verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../../../src/cli/commands/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc,EAAE,IAAY;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,YAAY,CAAC,2BAA2B,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,IAAI,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,YAAY,CAAC,0CAA0C,CAAC,CAAC;IACjE,CAAC;IACD,YAAY,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,cAAc,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1G,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;IAClD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG;YAChB,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;YAC7B,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;SAC9B,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB,IAAI,CAAC,CAAC;IACzH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC;AAClG,CAAC"}

package/dist/src/cli/commands/worker.js

@@ -0,0 +1,79 @@
+import path from "node:path";
+import { loadRemoteWorkerCredential, loadRemoteWorkerRegistration, loadRemoteWorkerToken, RemoteWorkerHttpClient, RemoteWorkerRunner, writeRemoteWorkerCredential, } from "../../control-plane/index.js";
+import { releaseRemoteHarborOffer, remoteHarborWorker } from "../../workers/index.js";
+import { invalidInput, parseDuration } from "../../foundation/index.js";
+import { assertNoArgs, takeFlag, takeOption } from "../arguments.js";
+export async function workerCommand(args, root) {
+    const action = args.shift();
+    if (action === "register")
+        return registerWorker(args);
+    if (action === "run")
+        return runWorker(args, root);
+    throw invalidInput("worker requires register or run");
+}
+async function registerWorker(args) {
+    const server = requiredOption(args, "--server");
+    const registrationFile = path.resolve(requiredOption(args, "--registration"));
+    const adminTokenFile = path.resolve(requiredOption(args, "--admin-token-file"));
+    const credentialFile = path.resolve(requiredOption(args, "--credential-file"));
+    assertNoArgs(args);
+    const registration = await loadRemoteWorkerRegistration(registrationFile);
+    const adminToken = await loadRemoteWorkerToken(adminTokenFile);
+    const credential = await RemoteWorkerHttpClient.register({ baseUrl: server, adminToken, registration });
+    await writeRemoteWorkerCredential(credentialFile, credential);
+    process.stdout.write(`Registered ${credential.worker_id} generation ${credential.generation}; credential written to ${credentialFile}\n`);
+}
+async function runWorker(args, root) {
+    const server = requiredOption(args, "--server");
+    const registrationFile = path.resolve(requiredOption(args, "--registration"));
+    const credentialFile = path.resolve(requiredOption(args, "--credential-file"));
+    const harborExecutable = takeOption(args, "--harbor");
+    const dockerExecutable = takeOption(args, "--docker");
+    const once = takeFlag(args, "--once");
+    const pollIntervalMs = durationOption(args, "--poll-interval", 1_000);
+    const heartbeatIntervalMs = durationOption(args, "--heartbeat-interval", 10_000);
+    assertNoArgs(args);
+    const registration = await loadRemoteWorkerRegistration(registrationFile);
+    const credential = await loadRemoteWorkerCredential(credentialFile);
+    if (registration.worker_id !== credential.worker_id)
+        throw invalidInput("worker registration and credential identities do not match");
+    const client = new RemoteWorkerHttpClient({ baseUrl: server, credential });
+    const controller = new AbortController();
+    const stop = () => controller.abort(new Error("worker shutdown requested"));
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+    const execution = {
+        root,
+        ...(harborExecutable ? { harborExecutable: path.resolve(harborExecutable) } : {}),
+        ...(dockerExecutable ? { dockerExecutable: path.resolve(dockerExecutable) } : {}),
+    };
+    const runner = new RemoteWorkerRunner({
+        client, capacity: registration.capacity.allocatable, execute: remoteHarborWorker(execution),
+        releaseUnknown: (offer) => releaseRemoteHarborOffer(execution, offer),
+        signal: controller.signal, once, pollIntervalMs, heartbeatIntervalMs,
+        onError: (error) => process.stderr.write(`hitch worker: ${safeMessage(error)}\n`),
+    });
+    process.stdout.write(`Running ${credential.worker_id} generation ${credential.generation}\n`);
+    try {
+        await runner.run();
+    }
+    finally {
+        process.removeListener("SIGINT", stop);
+        process.removeListener("SIGTERM", stop);
+    }
+}
+function requiredOption(args, name) {
+    const value = takeOption(args, name);
+    if (!value)
+        throw invalidInput(`${name} is required`);
+    return value;
+}
+function durationOption(args, name, fallback) {
+    const value = takeOption(args, name);
+    const parsed = value === undefined ? fallback : parseDuration(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 50 || parsed > 5 * 60_000)
+        throw invalidInput(`${name} must be between 50ms and 5m`);
+    return parsed;
+}
+function safeMessage(error) { return (error?.message || String(error)).replace(/[\0\r\n]/g, " ").slice(0, 1_024); }
+//# sourceMappingURL=worker.js.map

package/dist/src/cli/commands/worker.js.map

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

package/dist/src/cli/main.js

@@ -14,6 +14,11 @@ import { workspaceCommand } from "./commands/workspace.js";
 import { trajectoryCommand } from "./commands/trajectory.js";
 import { feedbackCommand } from "./commands/feedback.js";
 import { daemonCommand } from "./commands/daemon.js";
+import { workerCommand } from "./commands/worker.js";
+import { imagesCommand } from "./commands/images.js";
+import { benchmarkCommand } from "./commands/benchmark.js";
+import { verifierCommand } from "./commands/verifier.js";
+import { capabilitiesCommand } from "./commands/capabilities.js";
 export async function main(argv) {
     const args = [...argv];
     const root = path.resolve(takeOption(args, "--root") || defaultRoot());
@@ -27,10 +32,15 @@ export async function main(argv) {
         case "runs": return runsCommand(args, root);
         case "compare": return compareCommand(args, root);
         case "eval": return evalCommand(args, root);
+        case "benchmark": return benchmarkCommand(args);
         case "workspace": return workspaceCommand(args, root);
         case "trajectory": return trajectoryCommand(args, root);
+        case "verifier": return verifierCommand(args, root);
         case "feedback": return feedbackCommand(args, root);
         case "daemon": return daemonCommand(args, root);
+        case "worker": return workerCommand(args, root);
+        case "images": return imagesCommand(args, root);
+        case "capabilities": return capabilitiesCommand(args);
         case "help":
         case "--help":
         case "-h":

package/dist/src/cli/main.js.map

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

package/dist/src/cli/output.js

@@ -1,4 +1,4 @@
-import { delay } from "../foundation/index.js";
+import { HitchError, delay } from "../foundation/index.js";
 export function revisionLabel(resolved) {
     if (resolved.revision.type === "commit")
         return resolved.revision.commit || "";
@@ -33,6 +33,49 @@ export async function waitForDaemonRun(client, runId, output) {
         await delay(200);
     }
 }
+export async function waitForDaemonEval(client, evalId, output) {
+    let eventOffset = 0;
+    for (;;) {
+        const status = await client.request(`/v1/evals/${evalId}`);
+        if (output === "jsonl") {
+            try {
+                const response = await client.requestWithMetadata(`/v1/evals/${evalId}/events?offset=${eventOffset}`);
+                for (const line of String(response.payload).trim().split(/\r?\n/).filter(Boolean)) {
+                    JSON.parse(line);
+                    process.stdout.write(`${line}\n`);
+                }
+                eventOffset = Number(response.headers.get("x-hitch-next-offset") || eventOffset);
+            }
+            catch (error) {
+                if (error.status !== 404)
+                    throw error;
+            }
+        }
+        if (status.result) {
+            if (output === "json")
+                process.stdout.write(`${JSON.stringify(status.result, null, 2)}\n`);
+            return status.result;
+        }
+        await delay(200);
+    }
+}
+export async function waitForDaemonEvalRerun(client, evalId, rerunId) {
+    for (;;) {
+        const status = await client.request(`/v1/evals/${evalId}/reruns/${rerunId}`);
+        if (status.result && status.state?.status === "completed") {
+            process.stdout.write(`${JSON.stringify(status.result, null, 2)}\n`);
+            return status.result;
+        }
+        const state = status.state;
+        if (state?.status === "failed" || state?.status === "cancelled") {
+            throw new HitchError(typeof state.error?.message === "string" ? state.error.message : "eval rerun failed", {
+                code: typeof state.error?.code === "string" ? state.error.code : "eval_rerun_failed",
+                exitCode: 12,
+            });
+        }
+        await delay(200);
+    }
+}
 export function helpText() {
     return `Hitch — content-addressed version control and evidence storage for agent harnesses
 
@@ -45,27 +88,56 @@ Usage:
   hitch runs list [filters] [--json]
   hitch runs inspect <run-id> [--json]
   hitch runs rebuild-index [--json]
+  hitch runs candidate <run-id> [--context-license allowed|denied|unknown] [--capture-required] [--json]
   hitch compare model|harness [filters] [--reference-run <run-id>] [--json]
   hitch eval setup harbor [--version <version>] [--python <path>] [--force] [--json]
   hitch eval doctor [--harbor <path>] [--python <path>] [--docker <path>] [--json]
-  hitch eval run [--backend harbor] --dataset <ref> --harness <immutable-ref> [--model <id>] [--attempts <n>] [--infrastructure-retries <n>] [--eval-id <eval-id>]
-  hitch eval rerun <eval-id> (--invalid | --task <name> [--task <name> ...]) [--output json]
+  hitch eval run [--backend harbor] --dataset <ref> --harness <immutable-ref> [--model <id>] [--attempts <n>] [--infrastructure-retries <n>] [--eval-id <eval-id>] [--daemon] [--idempotency-key <key>] [execution policy]
+  hitch benchmark validate --package <directory>
+  hitch benchmark lock --package <directory> [--out <benchmark.lock.json>]
+  hitch benchmark compile --package <directory> --out <harbor-dataset>
+  hitch eval run --benchmark <directory> | --benchmark-lock <file> --harness <immutable-ref> [--model <id>]
+  hitch eval submit [--backend harbor] --dataset <ref> --harness <immutable-ref> [--model <id>] [--idempotency-key <key>] [execution policy]
+    execution policy: [--provider <id>] [--cpu-per-trial <integer-cpus>] [--memory-per-trial <size>]
+      [--build-mode backend|prebuild-preferred|prebuild-required]
+      [--model-capture off|native|proxy|hybrid] [--require-model-capture]
+  hitch eval watch <eval-id> [--output json|jsonl]
+  hitch eval cancel <eval-id>
+  hitch eval rerun <eval-id> (--invalid | --task <name> [--task <name> ...]) [--type <type>] [--verifier-runtime <sha256:id>] [--daemon] [--rerun-id <id>] [--output json]
+  hitch eval rerun-cancel <eval-id> <rerun-id>
   hitch eval list [--json]
   hitch eval inspect <eval-id> [--json]
   hitch workspace inspect <run-id> [--json]
   hitch workspace path <run-id>
   hitch workspace remove <run-id> [--force] [--json]
+  hitch images gc [--minimum-age <duration>] [--apply] [--json]
+  hitch images pin <sha256:image-id> [--reason <text>]
+  hitch images unpin <sha256:image-id>
   hitch trajectory inspect <run-id> [--json]
+  hitch verifier inspect <run-id> [--json]
+  hitch trajectory project <run-id> [--profile analysis] [--max-bytes <bytes>] [--json]
+  hitch trajectory events <run-id> [--types <a,b>] [--seq-start <n>] [--seq-end <n>] [--field <path>] [--canonical-sha256 <digest>] [--limit <n>] [--cursor <opaque>] [--max-bytes <bytes>] [--json]
+  hitch capabilities [--json]
   hitch feedback list <run-id> [--json]
   hitch feedback put <run-id> --message <id> --rating positive|negative [--note <text>] [--if-version <v>] [--json]
   hitch feedback delete <run-id> --message <id> [--if-version <v>] [--json]
   hitch daemon start [--foreground] [--port <port>] [--max-concurrent <n>]
+    [--capacity-cpu-millis <n>] [--capacity-memory-mib <n>]
+    [--container-slots <n>] [--build-slots <n>]
+    [--capacity-gpus <n>] [--eval-gpus <n>]
+    [--capacity-ephemeral-disk-mib <n>] [--eval-ephemeral-disk-mib <n>]
+    [--run-cpu-millis <n>] [--run-memory-mib <n>]
+    [--eval-cpu-millis <n>] [--eval-memory-mib <n>]
   hitch daemon stop | status [--json] | logs [-n <lines>]
   hitch daemon submit --harness <ref> --prompt <text> [--workspace-mode <mode>] [--wait]
   hitch daemon cancel <run-id>
+  hitch worker register --server <url> --registration <json> --admin-token-file <file> --credential-file <file>
+  hitch worker run --server <url> --registration <json> --credential-file <file> [--harbor <path>] [--docker <path>] [--once]
 
 Eval:
   Harbor runs each task in Docker; Hitch executes the selected harness inside that task container.
+  Rerun type candidate-restart is supported and is the compatibility default.
+  collect-only imports an already-finished Harbor result without executing Candidate. candidate-resume, trajectory-replay, and verifier-only fail explicitly until their recovery prerequisites exist.
   Use 'hitch eval setup harbor' for an isolated managed install and 'hitch eval doctor' to verify it.
   Eval accepts exact version:, registered commit:, or full lowercase local git+file commit refs.
   Local Git evals transport only committed Git objects; the source repository must be clean.
@@ -76,9 +148,13 @@ Eval:
   Verifier infrastructure failures are retried once by default; use --infrastructure-retries 0 to disable.
   --task selects every invalid or missing attempt for the named task.
 
-Trajectory and feedback:
+Trajectory, verifier evidence, and feedback:
   Structured adapters preserve provider-native events plus a DSH-compatible canonical view
   under runs/<run>/trajectory/, bound by trajectory.ref.json V2 checksums.
+  Verifier inspection returns bounded, redacted, run-centered result and diagnostic evidence.
+  Bounded analysis reconstructs the DSH surface, coalesces raw chunks, and exposes
+  source-filtered cursor pages without loading or printing the complete event array.
+  Field drill-down requires an exact seq window and the canonical SHA-256 from a prior view.
   Message feedback is a lifecycle-bound sidecar.
 
 Workspace modes:
@@ -95,6 +171,10 @@ Harness refs:
 
 Global:
   --root <path>    Relocate all Hitch state (default: ~/.hitch)
+
+Remote workers:
+  Use a dedicated --root on each worker host. Registration rotates the worker credential and writes it with mode 0600.
+  The worker downloads content-addressed inputs before accepting a lease, runs Harbor with the same evidence contract, and waits for an explicit release request before cleanup.
 `;
 }
 //# sourceMappingURL=output.js.map

package/dist/src/cli/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAE/C,MAAM,UAAU,aAAa,CAAC,QAAkH;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IAC/E,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACjF,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA8O,EAAE,KAAa,EAAE,MAAc;IAClT,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,SAAS,CAAC;QACR,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,YAAY,KAAK,kBAAkB,WAAW,EAAE,CAAC,CAAC;gBACpG,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;gBAC7B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;oBACrE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;gBACpC,CAAC;gBACD,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,WAAW,CAAC,CAAC;YACnF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA6B,CAAC,MAAM,KAAK,GAAG;oBAAE,MAAM,KAAK,CAAC;YACjE,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,MAAM,KAAK,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3F,OAAO,MAAM,CAAC,MAAiC,CAAC;QAClD,CAAC;QACD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6DR,CAAC;AACF,CAAC"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/output.ts"],"names":[],"mappings":"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"}

package/dist/src/control-plane/build-admission.js

@@ -0,0 +1,69 @@
+import { randomUUID } from "node:crypto";
+import { HitchError } from "../foundation/index.js";
+import { validateResourceVector } from "./resources.js";
+export class BuildSlotAdmission {
+    ledger;
+    resources;
+    waiters = [];
+    unsubscribe;
+    closed = false;
+    constructor(ledger, resources = { cpu_millis: 0, memory_bytes: 0, container_slots: 0, build_slots: 1 }) {
+        this.ledger = ledger;
+        this.resources = validateResourceVector(resources, "build admission resources");
+        if (this.resources.build_slots < 1 || !ledger.canEverFit(this.resources))
+            throw new TypeError("build admission resources exceed capacity");
+        this.unsubscribe = ledger.subscribe(() => this.drain());
+    }
+    acquire(signal) {
+        if (this.closed)
+            return Promise.reject(new HitchError("build admission is closed", { code: "build_admission_closed", exitCode: 12 }));
+        if (signal?.aborted)
+            return Promise.reject(cancelled());
+        return new Promise((resolve, reject) => {
+            const waiter = { ownerId: `build_${randomUUID().replaceAll("-", "")}`, resolve, reject, ...(signal ? { signal } : {}) };
+            const abort = () => {
+                const index = this.waiters.indexOf(waiter);
+                if (index >= 0)
+                    this.waiters.splice(index, 1);
+                reject(cancelled());
+            };
+            signal?.addEventListener("abort", abort, { once: true });
+            const originalResolve = waiter.resolve;
+            waiter.resolve = (value) => {
+                signal?.removeEventListener("abort", abort);
+                originalResolve(value);
+            };
+            this.waiters.push(waiter);
+            this.drain();
+        });
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.unsubscribe();
+        for (const waiter of this.waiters.splice(0))
+            waiter.reject(new HitchError("build admission is closed", { code: "build_admission_closed", exitCode: 12 }));
+    }
+    drain() {
+        if (this.closed)
+            return;
+        while (this.waiters.length > 0) {
+            const waiter = this.waiters[0];
+            if (waiter.signal?.aborted) {
+                this.waiters.shift();
+                waiter.reject(cancelled());
+                continue;
+            }
+            const lease = this.ledger.tryAcquire(waiter.ownerId, "build", this.resources);
+            if (!lease)
+                return;
+            this.waiters.shift();
+            waiter.resolve({ release: lease.release });
+        }
+    }
+}
+function cancelled() {
+    return new HitchError("image build admission was cancelled", { code: "cancelled", exitCode: 9 });
+}
+//# sourceMappingURL=build-admission.js.map

package/dist/src/control-plane/build-admission.js.map

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

package/dist/src/control-plane/build-records.js

@@ -0,0 +1,6 @@
+import { inspectEnvironmentBuild } from "../images/index.js";
+export async function inspectBuild(root, buildId) {
+    const inspected = await inspectEnvironmentBuild(root, buildId);
+    return inspected ? { record: inspected.record, manifest: inspected.manifest } : null;
+}
+//# sourceMappingURL=build-records.js.map

package/dist/src/control-plane/build-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-records.js","sourceRoot":"","sources":["../../../src/control-plane/build-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe;IAC9D,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvF,CAAC"}

package/dist/src/control-plane/collisions.js

@@ -0,0 +1,40 @@
+export class CollisionLockManager {
+    owners = new Map();
+    listeners = new Set();
+    tryAcquire(ownerId, keys) {
+        if (!ownerId)
+            throw new TypeError("collision owner must be non-empty");
+        const normalized = [...new Set(keys)].sort();
+        if (normalized.some((key) => !key))
+            throw new TypeError("collision key must be non-empty");
+        if (normalized.some((key) => this.owners.has(key)))
+            return null;
+        for (const key of normalized)
+            this.owners.set(key, ownerId);
+        let released = false;
+        return {
+            ownerId,
+            keys: normalized,
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                for (const key of normalized) {
+                    if (this.owners.get(key) === ownerId)
+                        this.owners.delete(key);
+                }
+                for (const listener of this.listeners)
+                    queueMicrotask(listener);
+            },
+        };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    snapshot() {
+        return [...this.owners.entries()].sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, owner_id]) => ({ key, owner_id }));
+    }
+}
+//# sourceMappingURL=collisions.js.map

package/dist/src/control-plane/collisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collisions.js","sourceRoot":"","sources":["../../../src/control-plane/collisions.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,oBAAoB;IACd,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnC,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD,UAAU,CAAC,OAAe,EAAE,IAAuB;QACjD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC3F,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAChE,KAAK,MAAM,GAAG,IAAI,UAAU;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO;YACL,OAAO;YACP,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;oBAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;wBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,CAAC;gBACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;oBAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,QAAoB;QAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACnF,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/src/control-plane/eval-control-state.js

@@ -0,0 +1,22 @@
+import path from "node:path";
+import { atomicWriteJSON, readJSON, withFileLock } from "../foundation/index.js";
+import { EvalEventSink } from "../evals/index.js";
+import { parseEvalControl } from "./eval-records.js";
+export async function updateEvalControl(directory, update) {
+    return withFileLock(path.join(directory, ".locks"), "control", async () => {
+        const current = parseEvalControl(await readJSON(path.join(directory, "control.json")));
+        const next = parseEvalControl({
+            ...update(current), schema_version: "1", eval_id: current.eval_id, generation: current.generation + 1,
+            created_at: current.created_at, updated_at: new Date().toISOString(),
+        });
+        await atomicWriteJSON(path.join(directory, "control.json"), next);
+        return next;
+    }, { timeoutCode: "eval_control_locked", timeoutExitCode: 12 });
+}
+export async function emitPersistedEvalEvent(directory, evalId, onEvent, event) {
+    const sink = new EvalEventSink(directory, evalId, onEvent);
+    await sink.open();
+    sink.emit(event);
+    await sink.close();
+}
+//# sourceMappingURL=eval-control-state.js.map