agy-worker-mcp 0.3.1

package/dist/broker/reconcile.d.ts

@@ -0,0 +1,74 @@
+import type { JobRow } from '../contract/types.js';
+import type { Store } from '../store/db.js';
+/**
+ * The daemon replacement.
+ *
+ * Every MCP tool handler calls this first. It has to be cheap, idempotent, and
+ * guarded by `BEGIN IMMEDIATE` so two servers racing to finalize the same job
+ * write the result exactly once.
+ *
+ * | observation                              | action                                        |
+ * | ---------------------------------------- | --------------------------------------------- |
+ * | `exit_code` exists, lifecycle = running   | finalize → verify → outcome/headline → unlock  |
+ * | pid gone, runner alive (`runner_pid`)     | still running — the runner is in `verifying`  |
+ * |                                          | or its writeback window; leave it alone        |
+ * | pid gone, runner gone, no `exit_code`     | `process_error` (the runner was killed)        |
+ * | `deadline_at` elapsed, pid alive         | `timed_out` after killpg                      |
+ * | `deadline_at` elapsed, runner `verifying`| wait: verify has its own clock (backstop below)|
+ * | pid alive but start_time mismatch        | pid reused → `orphaned`                       |
+ *
+ * `pid` is agy's, not the runner's (`spawn.ts`). Between agy's exit and the
+ * runner's final write the runner may be running `verify_command` for
+ * minutes (0.2.2 PR1): `state.json.phase === 'verifying'`
+ * with a live `state.json.runner_pid` is the only way to tell that apart from
+ * a lost runner, and every row above that would otherwise conclude "gone"
+ * checks it first.
+ *
+ * The order above is the order these are checked in, and it matters: `exit_code`
+ * existing always wins (even over a passed deadline — the runner beat us to it),
+ * and a passed deadline is checked before a pid-reuse mismatch. Among the last
+ * two, pid reuse is checked first: it is the only *positive* observation of the
+ * three, while "pid gone" covers both an ordinary exit and a lost runner.
+ */
+export interface ReconcileOptions {
+    /** Freeze the clock in tests. */
+    now?: number;
+    /** Skip the (more expensive) verification pass; used by hot read-only paths. */
+    skipVerify?: boolean;
+}
+export interface ReconcileReport {
+    checked: number;
+    finalized: string[];
+    timedOut: string[];
+    orphaned: string[];
+    processErrors: string[];
+    locksReleased: number;
+    durationMs: number;
+}
+/** Sweep every live job. Safe to call on every tool invocation. */
+export declare function reconcile(store: Store, opts?: ReconcileOptions): Promise<ReconcileReport>;
+/**
+ * Reconcile one job and return its current row.
+ *
+ * A no-op when the job is already `finished`: a second caller arriving after
+ * finalization reads the existing `broker-result.json`, not rebuilds it.
+ */
+export declare function reconcileJob(store: Store, job: JobRow, opts?: ReconcileOptions): Promise<JobRow>;
+/**
+ * Finalize a job whose `exit_code` file has appeared: run verification, decide
+ * the outcome, write `broker-result.json`, set `lifecycle = 'finished'`, release
+ * locks. All inside one transaction.
+ *
+ * The job's *incoming* lifecycle carries one more fact: `'canceling'` means
+ * `agy_cancel` had already asked for this exit, so the outcome is `canceled`
+ * even though a normal exit code came back. `timedOut` carries the other one,
+ * from `state.json`: the runner's watchdog killed the group at the deadline,
+ * which is not an ordinary failure however the exit code reads.
+ */
+export declare function finalizeJob(store: Store, job: JobRow, exitCode: number, nowMs: number, timedOut?: boolean): JobRow;
+export type AbnormalKind = 'process_error' | 'orphaned' | 'timed_out';
+/** Opportunistic cleanup of old job directories, triggered from `agy_start`. */
+export declare function cleanupOldJobs(store: Store, maxAgeMs: number): number;
+/** Convenience: reconcile one job by id, fetching its current row first. */
+export declare function reconcileJobById(store: Store, jobId: string, opts?: ReconcileOptions): Promise<JobRow>;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/broker/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/broker/reconcile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,MAAM,EAAgB,MAAM,sBAAsB,CAAA;AAMjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAO3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AA0BD,mEAAmE;AACnE,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0C/F;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0GtG;AA0CD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,UAAQ,GACf,MAAM,CAiBR;AAED,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,UAAU,GAAG,WAAW,CAAA;AAmIrE,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBrE;AA8BD,4EAA4E;AAC5E,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5G"}

package/dist/broker/reconcile.js

@@ -0,0 +1,415 @@
+import { readFileSync, rmSync } from 'node:fs';
+import { jobPaths, readJsonIfExists } from '../contract/paths.js';
+import { readLinesFrom } from '../events/cursor.js';
+import { okEvents, parseEventLines } from '../events/parse.js';
+import { removeGateHook } from '../gate/hooks-file.js';
+import { checkProcessIdentity, isPidAlive, isSameProcess, killProcessGroup } from '../runner/reap.js';
+import { now, transaction } from '../store/db.js';
+import { getJob, listJobs, LIVE_LIFECYCLES, tryGetJob, updateJob } from '../store/jobs.js';
+import { listLocks, releaseJobLocks } from '../store/locks.js';
+import { bindConversationId, getSession } from '../store/sessions.js';
+import { buildBrokerResult, writeBrokerResult } from './result.js';
+/**
+ * How long the runner is given to write `exit_code` after its agy child is
+ * already gone. The runner only has to `writeFileAtomic` a couple of bytes from
+ * an `exit` handler, so this is generous; it only ever costs latency on a run
+ * that really did lose its runner.
+ */
+const RUNNER_WRITEBACK_GRACE_MS = 1500;
+/**
+ * How long past `deadline_at + verify.timeout_ms` a `verifying` runner is
+ * still trusted to finish on its own before reconcile stops deferring to it.
+ * The runner enforces `verify_timeout_ms` itself; this only bounds the case
+ * where that enforcement somehow never returns.
+ */
+const VERIFY_BACKSTOP_MS = 60_000;
+/** Lifecycles that can have a live process and so are worth reconciling. */
+const RECONCILABLE_LIFECYCLES = [
+    'queued',
+    'starting',
+    'running',
+    'canceling',
+];
+/** Sweep every live job. Safe to call on every tool invocation. */
+export async function reconcile(store, opts) {
+    const start = Date.now();
+    const nowMs = opts?.now ?? now();
+    const candidates = listJobs(store, { lifecycle: [...RECONCILABLE_LIFECYCLES], limit: 10000 });
+    const locksBefore = listLocks(store).length;
+    const report = {
+        checked: 0,
+        finalized: [],
+        timedOut: [],
+        orphaned: [],
+        processErrors: [],
+        locksReleased: 0,
+        durationMs: 0,
+    };
+    for (const job of candidates) {
+        report.checked++;
+        const before = job.lifecycle;
+        const after = await reconcileJob(store, job, { ...opts, now: nowMs, skipVerify: opts?.skipVerify });
+        if (before === 'finished' || after.lifecycle !== 'finished')
+            continue;
+        switch (after.outcome) {
+            case 'timed_out':
+                report.timedOut.push(after.job_id);
+                break;
+            case 'orphaned':
+                report.orphaned.push(after.job_id);
+                break;
+            case 'process_error':
+                report.processErrors.push(after.job_id);
+                break;
+            default:
+                report.finalized.push(after.job_id);
+        }
+    }
+    const locksAfter = listLocks(store).length;
+    report.locksReleased = Math.max(0, locksBefore - locksAfter);
+    report.durationMs = Date.now() - start;
+    return report;
+}
+/**
+ * Reconcile one job and return its current row.
+ *
+ * A no-op when the job is already `finished`: a second caller arriving after
+ * finalization reads the existing `broker-result.json`, not rebuilds it.
+ */
+export async function reconcileJob(store, job, opts) {
+    if (job.lifecycle === 'finished')
+        return job;
+    const nowMs = opts?.now ?? now();
+    const paths = jobPaths(store.paths, job.job_id);
+    // The runner (which must never import `src/server/**`) records pid/pgid/
+    // proc_start_time/lifecycle only in `state.json`; reconcile is the sole place
+    // that absorbs it into the jobs row, since nothing else reads it back.
+    job = ingestRunnerState(store, job, paths.state);
+    const exitCode = readExitCode(paths.exitCode);
+    if (exitCode !== null) {
+        // The runner's own watchdog may have produced this exit code by killing the
+        // process group at the deadline. Only `state.json` carries that fact — the
+        // exit code alone is indistinguishable from an ordinary failure.
+        const runnerTimedOut = readJsonIfExists(paths.state)?.timed_out === true;
+        return finalizeJob(store, job, exitCode, nowMs, runnerTimedOut);
+    }
+    // Row 3 (checked ahead of the pid-null early return): a deadline that has
+    // passed must finalize the job even when the runner never published a pid —
+    // otherwise a runner that fails to start (or dies before spawning agy) leaves
+    // the job, and its locks, live forever.
+    const state = readJsonIfExists(paths.state);
+    if (job.deadline_at !== null && nowMs >= job.deadline_at) {
+        // `verify_command` runs on its own clock, past `deadline_at` by design
+        // (`docs/tools.md`, `verify_timeout_ms`). A runner that is verifying is
+        // not late — until even the verify clock plus a backstop has run out.
+        if (runnerIsVerifying(state)) {
+            const config = readJsonIfExists(paths.effectiveConfig);
+            const verifyBudget = job.deadline_at + (config?.verify?.timeout_ms ?? 0) + VERIFY_BACKSTOP_MS;
+            if (nowMs < verifyBudget)
+                return job;
+        }
+        if (job.pid !== null &&
+            job.pgid !== null &&
+            isPidAlive(job.pid) &&
+            isSameProcess(job.pid, job.proc_start_time)) {
+            await killProcessGroup(job.pgid);
+        }
+        const exitAfterKill = await pollExitCode(paths.exitCode);
+        if (exitAfterKill !== null) {
+            // We killed it for the deadline, so the exit code it produced is a
+            // timeout's exit code, not a failure's.
+            return finalizeJob(store, job, exitAfterKill, now(), true);
+        }
+        return finalizeAbnormal(store, job, 'timed_out', now());
+    }
+    if (job.pid === null) {
+        // Not spawned yet (still `queued`/`starting`) and its deadline (if any)
+        // has not passed. Nothing observable to reconcile.
+        return job;
+    }
+    const identity = checkProcessIdentity(job.pid, job.proc_start_time);
+    // Row 4: pid alive, but the start-time token belongs to a *different*
+    // process. Checked before row 2 because it is the only positive conclusion of
+    // the three — `gone` covers both an ordinary exit and a lost runner, and
+    // telling those apart is row 2's job.
+    if (identity === 'different') {
+        return finalizeAbnormal(store, job, 'orphaned', nowMs);
+    }
+    // Row 2: pid gone, no exit_code file. The runner was killed before it could
+    // record a result.
+    //
+    // `agy` dying is NOT by itself evidence of that: between agy's exit and the
+    // runner's `writeExitCode` there is a short window in which the pid is
+    // already gone while a perfectly healthy run is about to record exit 0.
+    // Reading only `isPidAlive` here misclassifies every normally-finishing job
+    // caught in that window as `process_error`, which a caller polling reconcile
+    // in a loop hits reliably. So re-poll for the exit_code first, and only
+    // conclude the runner is lost once the grace elapses with nothing written.
+    if (identity === 'gone') {
+        // The runner is still there (verifying, or about to write `exit_code`):
+        // nothing is lost, and the next reconcile will find the exit code. Without
+        // this check every job whose verify outlived the grace below was judged
+        // `process_error` with a real exit 0 landing seconds later (audit `08`).
+        if (runnerIsAlive(state))
+            return job;
+        const exitAfterDeath = await pollExitCode(paths.exitCode, RUNNER_WRITEBACK_GRACE_MS);
+        if (exitAfterDeath !== null) {
+            return finalizeJob(store, job, exitAfterDeath, now());
+        }
+        return finalizeAbnormal(store, job, 'process_error', now());
+    }
+    // Row 5: the gate marked this job `canceling` (on_denial: 'abort'). The gate
+    // only marks it — reconcile owns the actual killpg, and does it here rather
+    // than waiting for the deadline.
+    if (job.lifecycle === 'canceling' && job.pgid !== null) {
+        await killProcessGroup(job.pgid);
+        const exitAfterKill = await pollExitCode(paths.exitCode);
+        if (exitAfterKill !== null) {
+            return finalizeJob(store, job, exitAfterKill, now());
+        }
+        return finalizeAbnormal(store, job, 'timed_out', now());
+    }
+    // Still genuinely running.
+    return job;
+}
+/**
+ * Absorb `state.json` (written only by the runner) into the jobs row: pid,
+ * pgid, proc_start_time and started_at are filled in once and never
+ * contradicted (the runner never rewrites them to null), and lifecycle is only
+ * ever moved forward (`queued` → `starting` → `running`) — never used to
+ * downgrade a `canceling` mark the gate made, and `finished` is decided
+ * exclusively by the presence of `exit_code`, never by `state.json` alone.
+ */
+function ingestRunnerState(store, job, statePath) {
+    const state = readJsonIfExists(statePath);
+    if (!state)
+        return job;
+    const patch = {};
+    if (state.pid !== null && job.pid === null)
+        patch.pid = state.pid;
+    if (state.pgid !== null && job.pgid === null)
+        patch.pgid = state.pgid;
+    if (state.proc_start_time !== null && job.proc_start_time === null) {
+        patch.proc_start_time = state.proc_start_time;
+    }
+    if (state.started_at !== null && job.started_at === null)
+        patch.started_at = state.started_at;
+    if (state.lifecycle === 'running' && (job.lifecycle === 'queued' || job.lifecycle === 'starting')) {
+        patch.lifecycle = 'running';
+    }
+    else if (state.lifecycle === 'starting' && job.lifecycle === 'queued') {
+        patch.lifecycle = 'starting';
+    }
+    if (Object.keys(patch).length === 0)
+        return job;
+    return updateJob(store, job.job_id, patch);
+}
+/** `state.json` names a runner pid and that pid is alive. */
+function runnerIsAlive(state) {
+    return state?.runner_pid != null && isPidAlive(state.runner_pid);
+}
+/** The runner announced `verify_command` is running, and it is still there to run it. */
+function runnerIsVerifying(state) {
+    return state?.phase === 'verifying' && runnerIsAlive(state);
+}
+/**
+ * Finalize a job whose `exit_code` file has appeared: run verification, decide
+ * the outcome, write `broker-result.json`, set `lifecycle = 'finished'`, release
+ * locks. All inside one transaction.
+ *
+ * The job's *incoming* lifecycle carries one more fact: `'canceling'` means
+ * `agy_cancel` had already asked for this exit, so the outcome is `canceled`
+ * even though a normal exit code came back. `timedOut` carries the other one,
+ * from `state.json`: the runner's watchdog killed the group at the deadline,
+ * which is not an ordinary failure however the exit code reads.
+ */
+export function finalizeJob(store, job, exitCode, nowMs, timedOut = false) {
+    return transaction(store.db, () => {
+        const fresh = tryGetJob(store, job.job_id);
+        if (fresh === null)
+            return job;
+        if (fresh.lifecycle === 'finished')
+            return fresh;
+        const canceled = fresh.lifecycle === 'canceling';
+        return finalizeCore(store, fresh, {
+            exitCode,
+            // An explicit cancel outranks the deadline: the user asked for this exit.
+            timedOut: timedOut && !canceled,
+            canceled,
+            runnerLost: false,
+            pidReused: false,
+            nowMs,
+        });
+    });
+}
+/**
+ * Finalize a job with no real `exit_code` — the runner vanished, the pid was
+ * reused, or our own deadline enforcement had to kill it directly.
+ */
+function finalizeAbnormal(store, job, kind, nowMs) {
+    return transaction(store.db, () => {
+        const fresh = tryGetJob(store, job.job_id);
+        if (fresh === null)
+            return job;
+        if (fresh.lifecycle === 'finished')
+            return fresh;
+        const canceled = fresh.lifecycle === 'canceling';
+        return finalizeCore(store, fresh, {
+            exitCode: null,
+            timedOut: kind === 'timed_out' && !canceled,
+            canceled,
+            runnerLost: kind === 'process_error' && !canceled,
+            pidReused: kind === 'orphaned' && !canceled,
+            nowMs,
+        });
+    });
+}
+/** Shared body of {@link finalizeJob} / {@link finalizeAbnormal}. Must run inside a transaction. */
+function finalizeCore(store, job, flags) {
+    const paths = jobPaths(store.paths, job.job_id);
+    const config = readJsonIfExists(paths.effectiveConfig);
+    const expectedArtifacts = config?.expected_artifacts ?? [];
+    const jsonSchemaPath = config?.json_schema_path ?? null;
+    // Only `state.json` records that the runner's idle watchdog closed stdin; the
+    // exit code it produces is an ordinary 0.
+    const state = readJsonIfExists(paths.state);
+    const idleClosed = state?.idle_closed === true;
+    const idleClosedAfterMs = idleClosed ? (config?.idle_timeout_ms ?? null) : null;
+    // I4: null on a `state.json` predating this field, or on a job that ended
+    // before any tool step ever ran — neither forces `outcome`.
+    const gateConfirmed = state?.gate_confirmed ?? null;
+    // The runner's own end time, when it recorded one (it writes `state.json`
+    // before `exit_code`, so on the normal path it is always there). Abnormal
+    // finalization has no runner-recorded end; the discovery time stands in.
+    const finishedAt = flags.exitCode !== null && state?.finished_at != null ? state.finished_at : flags.nowMs;
+    const read = readLinesFrom(paths.events, 0);
+    const parsed = parseEventLines(read.lines, 0);
+    const events = okEvents(parsed);
+    const malformedLines = parsed.filter((p) => !p.ok).length;
+    const result = buildBrokerResult(store, {
+        job,
+        events,
+        malformedLines,
+        exitCode: flags.exitCode,
+        timedOut: flags.timedOut,
+        canceled: flags.canceled,
+        runnerLost: flags.runnerLost,
+        pidReused: flags.pidReused,
+        expectedArtifacts,
+        jsonSchemaPath,
+        idleClosedAfterMs,
+        gateConfirmed,
+        finishedAt,
+        now: flags.nowMs,
+    });
+    writeBrokerResult(paths, result);
+    releaseJobLocks(store, job.job_id);
+    // Write the conversation id back to the session the moment the broker result
+    // knows it, independent of whether the gate ever bound this conversation
+    // (finding 14) — otherwise a later `agy_start({session_id})` reads
+    // `conversation_id: null` and silently starts a brand-new conversation
+    // instead of resuming this one.
+    if (result.conversation_id && job.session_id) {
+        const session = getSession(store, job.session_id);
+        if (session && session.conversation_id === null) {
+            try {
+                bindConversationId(store, job.session_id, result.conversation_id);
+            }
+            catch {
+                // Best effort — a concurrent bind from the gate already won.
+            }
+        }
+    }
+    const finalized = updateJob(store, job.job_id, {
+        lifecycle: 'finished',
+        outcome: result.broker_summary.outcome,
+        headline: result.broker_summary.headline,
+        exit_code: result.broker_summary.exit_code,
+        agent_status: result.agent_status,
+        contract_status: result.contract_status,
+        finished_at: finishedAt,
+    });
+    removeGateHookIfIdle(store, finalized);
+    return finalized;
+}
+/**
+ * Once a job lands in `finished`, remove only our own `hooks.json` entry
+ * (`GATE_HOOK_KEY`), and only when no other job
+ * with the same canonical `cwd` is still live — a second live job on that
+ * workspace still needs the hook. Runs *after* `updateJob` above so this job's
+ * own row already reads `finished` and does not count itself as a live holdout.
+ *
+ * The runner never opens the store (it must run even when every server process is dead),
+ * so reconcile is the only place that
+ * can know "is anything else on this cwd still live" and act on it. Best
+ * effort: `removeGateHook` swallows its own failures, and a stale entry left
+ * behind here is harmless until the next `agy_start` on the same workspace,
+ * which overwrites it unconditionally.
+ */
+function removeGateHookIfIdle(store, job) {
+    try {
+        const stillLive = listJobs(store, { lifecycle: [...LIVE_LIFECYCLES], cwd: job.cwd, limit: 1 });
+        if (stillLive.length === 0)
+            removeGateHook(job.cwd);
+    }
+    catch {
+        // Best effort — hook-file housekeeping must never break reconcile.
+    }
+}
+/** Opportunistic cleanup of old job directories, triggered from `agy_start`. */
+export function cleanupOldJobs(store, maxAgeMs) {
+    const cutoff = now() - maxAgeMs;
+    const finished = listJobs(store, { lifecycle: 'finished', limit: 10000 });
+    let removed = 0;
+    for (const job of finished) {
+        const ts = job.finished_at ?? job.created_at;
+        if (ts >= cutoff)
+            continue;
+        const paths = jobPaths(store.paths, job.job_id);
+        try {
+            rmSync(paths.dir, { recursive: true, force: true });
+        }
+        catch {
+            // Best effort: an already-gone directory is not a failure.
+        }
+        store.db.prepare('DELETE FROM jobs WHERE job_id = ?').run(job.job_id);
+        removed++;
+    }
+    return removed;
+}
+/** `jobs/<id>/exit_code` holds a bare integer; missing or unparsable reads as null. */
+function readExitCode(path) {
+    try {
+        const raw = readFileSync(path, 'utf8').trim();
+        if (raw.length === 0)
+            return null;
+        const n = Number.parseInt(raw, 10);
+        return Number.isFinite(n) ? n : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * After a forced `killpg`, give a still-alive runner a short window to observe
+ * the child's exit and write `exit_code` itself, so the finalize path reuses the
+ * real exit code instead of manufacturing one. Bounded so reconcile stays cheap
+ * even when the runner is not there to write anything.
+ */
+async function pollExitCode(path, totalMs = 2000, intervalMs = 200) {
+    const deadline = Date.now() + totalMs;
+    for (;;) {
+        const code = readExitCode(path);
+        if (code !== null)
+            return code;
+        if (Date.now() >= deadline)
+            return null;
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+}
+/** Convenience: reconcile one job by id, fetching its current row first. */
+export async function reconcileJobById(store, jobId, opts) {
+    const job = getJob(store, jobId);
+    return reconcileJob(store, job, opts);
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/broker/reconcile.js.map

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

package/dist/broker/result.d.ts

@@ -0,0 +1,88 @@
+import type { AgentReport, AgyEvent, BrokerResult, JobRow, JudgementPacket } from '../contract/types.js';
+import type { JobPaths } from '../contract/paths.js';
+import type { Store } from '../store/db.js';
+/**
+ * `broker-result.json` is the single source of truth.
+ *
+ * `agy_wait` projects a subset of it, `agy_result` pages all of it, and nothing
+ * else recomputes `outcome` — if a tool derives its own verdict, two callers can
+ * be told different things about the same job.
+ */
+export interface BuildResultInput {
+    job: JobRow;
+    events: AgyEvent[];
+    malformedLines: number;
+    exitCode: number | null;
+    timedOut: boolean;
+    canceled: boolean;
+    runnerLost: boolean;
+    pidReused: boolean;
+    expectedArtifacts: string[];
+    jsonSchemaPath: string | null;
+    /**
+     * `idle_timeout_ms` when the runner's idle watchdog ended the session, null
+     * otherwise. A clean exit 0, so nothing here changes the outcome — but the
+     * caller cannot otherwise tell an idle close from an ordinary finish, and the
+     * two call for different next steps.
+     */
+    idleClosedAfterMs: number | null;
+    /**
+     * `state.json.gate_confirmed`, verbatim (I4). `false` adds a `source:'broker'`
+     * blocker and forces `outcome: 'process_error'`; `null` (no tool step ever
+     * ran, or an older `state.json`) changes nothing.
+     */
+    gateConfirmed: boolean | null;
+    /**
+     * When the runner actually finished (`state.json.finished_at`), if known.
+     * `finished_at` / `duration_ms` come from this; `now` is only when the
+     * broker got around to judging it (`finalized_at`). Absent on abnormal
+     * finalization (no `exit_code`, so no runner-recorded end) — `now` then.
+     * 0.2.2 (PR1): a job nobody polled for four days used to
+     * report an 86-hour duration for a 30-minute run.
+     */
+    finishedAt?: number | null;
+    now: number;
+}
+export declare function buildBrokerResult(store: Store, input: BuildResultInput): BrokerResult;
+/** Extract agy's unverified self-report. Quarantined from `broker_summary` on purpose. */
+export declare function buildAgentReport(events: AgyEvent[]): AgentReport;
+/** Atomic write, so a concurrent reader never sees a half-written result. */
+export declare function writeBrokerResult(paths: JobPaths, result: BrokerResult): void;
+/**
+ * Null when the job has not been finalized yet.
+ *
+ * A `broker-result.json` written by an older server is migrated in memory
+ * (see {@link migrateBrokerResult}) rather than crashing a tool call — job
+ * directories outlive an upgrade, and `agy_result` on yesterday's job must keep
+ * working. A version we do not know how to read is refused loudly instead of
+ * being handed on half-typed.
+ *
+ * @throws {import('../contract/errors.js').ValidationError} on an unknown version.
+ */
+export declare function loadBrokerResult(paths: JobPaths): BrokerResult | null;
+/**
+ * Bring a stored result up to {@link BROKER_RESULT_VERSION}.
+ *
+ * Version 1 kept `verification.permission_denials` and
+ * `verification.environment_blocks`; version 2 collapsed those into the single
+ * `verification.blockers`; version 3 adds `verification.verify` (PR6,
+ * `verify_command`) — always `null` on a migrated file, since no job written
+ * before 0.2.0 ever ran a verify command. The version-1 migration runs the
+ * same constructors the live path uses, so an old job is judged by exactly
+ * today's rules — and nothing in the old records is dropped, since each one is
+ * carried in `Blocker.detail`.
+ */
+export declare function migrateBrokerResult(raw: BrokerResult, path: string): BrokerResult;
+export interface ProjectOptions {
+    maxLogTailLines?: number;
+    maxBytes?: number;
+    /** Cursor to report back for the caller's next `agy_logs` / `agy_wait`. */
+    cursor?: number;
+}
+/**
+ * Project the judgement packet `agy_wait` returns: counts, warnings, headline,
+ * and a short log tail. No lists, no raw response text — those live in
+ * `agy_result`.
+ */
+export declare function projectJudgementPacket(result: BrokerResult, opts?: ProjectOptions): JudgementPacket;
+//# sourceMappingURL=result.d.ts.map

package/dist/broker/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/broker/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EAIZ,MAAM,EACN,eAAe,EAEhB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAIpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAY3C;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;;;;OAIG;IACH,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,MAAM,CAAA;CACZ;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAkFrF;AA+BD,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAchE;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAE7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI,CAIrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CA0CjF;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,eAAe,CA6BnG"}