agent-nuvira 3.1.3 → 3.2.0

package/dist/learning/unattended-job.js

@@ -0,0 +1,544 @@
+/**
+ * Unattended jobs — the engine that finishes long work WITHOUT the user having
+ * to say "continue" (enterprise-grade hardening, G11).
+ *
+ * THE BUG THIS CLOSES. The long-form ledger (G8) made a 100-page book
+ * *possible*: it split the ask into bounded units and recorded progress. But it
+ * left the CADENCE manual. Every batch ended with
+ *
+ *   "Reply \"continue\" and I will write the next batch"
+ *
+ * so a 39-unit book needed ~10 human turns. The user asked for a book and got a
+ * job they had to keep pressing. That is a shortcut, not a delivery: "write me
+ * a 100-page book" is itself the authorization to spend the time, and an
+ * assistant that stops after 4 of 39 units to ask whether to continue has
+ * substituted a protocol for the work.
+ *
+ * WHAT THIS MODULE IS. A persisted queue of IN-PROGRESS WORK, plus a runner
+ * that keeps executing it until it is done, blocked on a genuine question, or
+ * out of its own time budget. It is deliberately NOT the retry queue
+ * (`deferred-task.ts`):
+ *
+ *   | | deferred-task | unattended-job |
+ *   |---|---|---|
+ *   | triggered by | a FAILURE | unfinished WORK |
+ *   | authorization | the user replying "yes" | the original ask |
+ *   | wait shape | backoff between attempts | run continuously |
+ *   | budget | ~6h of retries | hours of actual work (default 10h) |
+ *   | stops on | attempts/TTL | completion, a real question, or no progress |
+ *
+ * Merging the two would make "keep retrying the model" and "keep writing the
+ * book" the same switch, and the consent semantics of each are opposites.
+ *
+ * THREE GUARANTEES THE RUNNER ENFORCES
+ *  1. PROGRESS IS MEASURED, NOT CLAIMED. A batch that did not move the ledger
+ *     is a stall even if every step reported success. Three stalls in a row
+ *     stop the run and ask, because an agent looping without progress is the
+ *     exact "goes in a loop and never delivers" behaviour this exists to end.
+ *  2. IT STOPS FOR QUESTIONS, NOT FOR PERMISSION. The only thing that pauses
+ *     work is a decision the user genuinely owns (see `autonomy-policy.ts`).
+ *  3. IT NEVER RUNS UNBOUNDED. A deadline (default 10 hours), a stall cap, a
+ *     failure cap and a per-drain batch cap.
+ *
+ * Storage: `<memory>/unattended-jobs.json`. Best-effort writes — bookkeeping
+ * must never break the turn that scheduled the work.
+ */
+import { envBuff, resolveNuviraHome } from '../config/paths.js';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── Constants ──────────────────────────────────────────────────────────────
+/**
+ * How long a job may keep working before it gives up and reports.
+ *
+ * Ten hours because the ask this module exists for is "a 100/200-page book" or
+ * "a phased build", and the user's requirement is explicit: those must run to
+ * completion unattended rather than in 4-turn increments. It is a CEILING, not
+ * a target — a job that finishes in ten minutes leaves the queue immediately.
+ */
+export const DEFAULT_DEADLINE_MS = 10 * 3_600_000;
+/** Consecutive no-progress batches before the run stops and asks. */
+export const MAX_STALLED_BATCHES = 3;
+/** Consecutive hard failures (provider errors, verification failures). */
+export const MAX_CONSECUTIVE_FAILURES = 6;
+/** Batches one drain may run before yielding (keeps a tick responsive). */
+export const MAX_BATCHES_PER_DRAIN = 6;
+/**
+ * How long a job may sit in `running` before it is treated as abandoned.
+ *
+ * A batch is claimed before it runs; if the process dies mid-batch — a restart,
+ * a reboot, a crash, all normal over a ten-hour job — nothing resets it and a
+ * `running` job is invisible to every query. The work would be stranded
+ * silently, which is the failure mode the whole ledger exists to prevent. The
+ * ceiling is generous (well past a single batch) so a live batch is never
+ * stolen.
+ */
+export const STALE_RUNNING_MS = 25 * 60_000;
+/** Bounded store — a queue is a convenience, not a backlog. */
+const MAX_JOBS = 25;
+const FILE_NAME = 'unattended-jobs.json';
+const CURRENT_VERSION = 1;
+function envBuffSafe(name) {
+    try {
+        return envBuff(name);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Memory dir, honouring the same test/dev override the long-form ledger uses. */
+function memoryDir() {
+    const override = envBuffSafe('MEMORY_DIR');
+    if (override)
+        return override;
+    try {
+        return join(resolveNuviraHome(), 'memory');
+    }
+    catch {
+        return join(process.cwd(), '.nuvira-memory');
+    }
+}
+function storePath() {
+    return join(memoryDir(), FILE_NAME);
+}
+function isJobShape(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const j = value;
+    return (typeof j.id === 'string' &&
+        typeof j.goal === 'string' &&
+        typeof j.projectPath === 'string' &&
+        typeof j.createdAt === 'number' &&
+        typeof j.deadline === 'number' &&
+        typeof j.continuationPrompt === 'string' &&
+        !!j.surface &&
+        typeof j.surface.platform === 'string' &&
+        typeof j.surface.channelId === 'string');
+}
+/**
+ * Self-heal jobs abandoned mid-batch (see STALE_RUNNING_MS), applied on READ so
+ * no process has to remember a recovery pass, and written back so the next
+ * reader sees the repair too.
+ */
+function recoverStaleRunning(jobs, now) {
+    let repaired = false;
+    for (const job of jobs) {
+        if (job.status !== 'running')
+            continue;
+        const startedAt = job.lastRunAt || job.createdAt;
+        if (now - startedAt <= STALE_RUNNING_MS)
+            continue;
+        job.status = 'pending';
+        job.stopReason = undefined;
+        repaired = true;
+    }
+    if (repaired)
+        writeJobs(jobs);
+    return jobs;
+}
+/** Read the queue. Best-effort: a corrupt file is an empty queue, never a throw. */
+export function loadUnattendedJobs(now = Date.now()) {
+    try {
+        const path = storePath();
+        if (!existsSync(path))
+            return [];
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (!parsed || !Array.isArray(parsed.jobs))
+            return [];
+        return recoverStaleRunning(parsed.jobs.filter(isJobShape), now);
+    }
+    catch {
+        return [];
+    }
+}
+function writeJobs(jobs) {
+    try {
+        const dir = memoryDir();
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        // Newest first, bounded: the oldest job is the one most likely to have been
+        // forgotten, and dropping it silently beats an unbounded file.
+        const ordered = [...jobs].sort((a, b) => b.updatedAt - a.updatedAt).slice(0, MAX_JOBS);
+        const payload = { version: CURRENT_VERSION, jobs: ordered };
+        writeFileSync(storePath(), JSON.stringify(payload, null, 2), 'utf-8');
+    }
+    catch {
+        // Best-effort — bookkeeping must never break the turn that scheduled work.
+    }
+}
+function newId() {
+    try {
+        if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+            return `job-${crypto.randomUUID().slice(0, 8)}`;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return `job-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+// ─── Lifecycle ──────────────────────────────────────────────────────────────
+/** Stable identity for "the ongoing work in this project, for this surface". */
+function jobIdentity(kind, projectPath, surface) {
+    return `${kind}|${projectPath}|${surface.platform}:${surface.channelId}`;
+}
+/**
+ * Schedule ongoing work — or return the job already carrying it.
+ *
+ * Idempotent per (kind, project, surface) on purpose: every batch of a book
+ * re-enters this function, and treating each re-entry as a new job would spawn
+ * a duplicate worker per batch and have them race on the same chapters.
+ */
+export function startUnattendedJob(input) {
+    const jobs = loadUnattendedJobs();
+    const now = Date.now();
+    const identity = jobIdentity(input.kind, input.projectPath, input.surface);
+    const existing = jobs.find((j) => jobIdentity(j.kind, j.projectPath, j.surface) === identity && j.status !== 'cancelled' && j.status !== 'done');
+    if (existing) {
+        // A live job keeps its own counters and deadline — re-entering must not
+        // reset the time budget, or a job that keeps re-planning could run forever.
+        existing.goal = input.goal;
+        existing.updatedAt = now;
+        if (input.continuationPrompt)
+            existing.continuationPrompt = input.continuationPrompt;
+        writeJobs(jobs);
+        return { job: existing, created: false };
+    }
+    const job = {
+        id: newId(),
+        kind: input.kind,
+        goal: input.goal,
+        projectPath: input.projectPath,
+        surface: input.surface,
+        continuationPrompt: input.continuationPrompt ?? 'continue',
+        createdAt: now,
+        updatedAt: now,
+        lastRunAt: 0,
+        deadline: now + Math.max(60_000, input.deadlineMs ?? DEFAULT_DEADLINE_MS),
+        batches: 0,
+        stalledBatches: 0,
+        failures: 0,
+        status: 'pending',
+        progress: 0,
+        notify: input.notify !== false,
+        ...(input.expectedArtifacts?.length ? { expectedArtifacts: input.expectedArtifacts } : {}),
+    };
+    writeJobs([job, ...jobs]);
+    return { job, created: true };
+}
+export function getUnattendedJob(id) {
+    return loadUnattendedJobs().find((j) => j.id === id);
+}
+/** The live job for a surface (newest first), if any. */
+export function findUnattendedJob(surface) {
+    return loadUnattendedJobs().find((j) => j.surface.platform === surface.platform &&
+        j.surface.channelId === surface.channelId &&
+        (j.status === 'pending' || j.status === 'running' || j.status === 'blocked'));
+}
+/** Every job still waiting for a turn (for status surfaces, newest first). */
+export function listUnattendedJobs() {
+    return loadUnattendedJobs();
+}
+/**
+ * Jobs ready to run now: pending, inside their deadline, and not out of road.
+ *
+ * `blocked` jobs are deliberately excluded — they are waiting on the user, not
+ * on the scheduler.
+ */
+export function dueUnattendedJobs(now = Date.now(), owns = () => true) {
+    return loadUnattendedJobs(now).filter((j) => j.status === 'pending' &&
+        j.deadline > now &&
+        j.stalledBatches < MAX_STALLED_BATCHES &&
+        j.failures < MAX_CONSECUTIVE_FAILURES &&
+        owns(j));
+}
+/** Jobs whose time budget ran out — the user must be told, not ghosted. */
+export function expiredUnattendedJobs(now = Date.now(), owns = () => true) {
+    return loadUnattendedJobs(now).filter((j) => j.status === 'pending' && j.deadline <= now && owns(j));
+}
+/**
+ * Stop a job with a reason, without touching its counters.
+ *
+ * Used by the runner to expire jobs whose time budget ran out — the reason
+ * must be RECORDED (the user is told why the promised work stopped), and doing
+ * it here keeps the runner free of ledger-write logic.
+ */
+export function stopUnattendedJob(id, status, reason, now = Date.now()) {
+    const jobs = loadUnattendedJobs(now);
+    const job = jobs.find((j) => j.id === id);
+    if (!job)
+        return undefined;
+    job.status = status;
+    job.stopReason = reason;
+    job.updatedAt = now;
+    if (status === 'done')
+        job.progress = 100;
+    writeJobs(jobs);
+    return job;
+}
+/** Stop a job (the user said stop, or the work is being replaced). */
+export function cancelUnattendedJob(id, reason = 'cancelled by the user') {
+    const jobs = loadUnattendedJobs();
+    const job = jobs.find((j) => j.id === id);
+    if (!job)
+        return;
+    job.status = 'cancelled';
+    job.stopReason = reason;
+    job.updatedAt = Date.now();
+    writeJobs(jobs);
+}
+/** Drop every job for a surface (`stop`, `cancel`, a fresh unrelated ask). */
+export function cancelUnattendedJobsFor(surface, reason = 'cancelled by the user') {
+    const jobs = loadUnattendedJobs();
+    let changed = 0;
+    for (const job of jobs) {
+        if (job.surface.platform !== surface.platform || job.surface.channelId !== surface.channelId)
+            continue;
+        if (job.status === 'done' || job.status === 'cancelled' || job.status === 'failed')
+            continue;
+        job.status = 'cancelled';
+        job.stopReason = reason;
+        job.updatedAt = Date.now();
+        changed++;
+    }
+    if (changed > 0)
+        writeJobs(jobs);
+    return changed;
+}
+/** Claim a job for one batch. Returns the claimed job, or undefined. */
+export function claimUnattendedJob(id, now = Date.now()) {
+    const jobs = loadUnattendedJobs(now);
+    const job = jobs.find((j) => j.id === id);
+    if (!job || job.status !== 'pending')
+        return undefined;
+    job.status = 'running';
+    job.lastRunAt = now;
+    job.updatedAt = now;
+    writeJobs(jobs);
+    return job;
+}
+/**
+ * Record what one batch actually did, and decide what happens next.
+ *
+ * This is where "no manual cadence" is enforced: the batch's own outcome
+ * determines whether the job keeps running, stops because it is DONE, or stops
+ * because it needs the user — nobody has to say "continue".
+ *
+ * @returns the updated job (undefined when the id is unknown).
+ */
+export function recordBatchOutcome(id, outcome, now = Date.now()) {
+    const jobs = loadUnattendedJobs(now);
+    const job = jobs.find((j) => j.id === id);
+    if (!job)
+        return undefined;
+    job.batches += 1;
+    job.updatedAt = now;
+    job.stopReason = undefined;
+    job.pendingQuestion = undefined;
+    if (outcome.progressLine)
+        job.progressLine = outcome.progressLine;
+    // ── A hard failure is checked FIRST, before completion. ──────────────────
+    // A batch that failed verification can leave every file on disk and still
+    // not be a delivered deliverable (a site that does not present the chapters).
+    // Letting `finished` win would report success over exactly the failure the
+    // verify step exists to catch.
+    if (outcome.error) {
+        job.failures += 1;
+        if (job.failures >= MAX_CONSECUTIVE_FAILURES) {
+            job.status = 'failed';
+            job.stopReason = `stopped after ${job.failures} consecutive failed batches — last error: ${outcome.error.slice(0, 300)}`;
+            writeJobs(jobs);
+            return job;
+        }
+        job.status = 'pending';
+        writeJobs(jobs);
+        return job;
+    }
+    // ── Finished: the deliverable exists. ────────────────────────────────────
+    if (outcome.finished) {
+        job.status = 'done';
+        job.progress = 100;
+        job.stopReason = 'complete';
+        writeJobs(jobs);
+        return job;
+    }
+    // ── A genuine question: stop the RUN, not the work. ──────────────────────
+    // Marked blocked rather than failed so the answer resumes from the ledger.
+    if (outcome.question) {
+        job.status = 'blocked';
+        job.pendingQuestion = outcome.question;
+        job.stopReason = 'waiting on a decision only the user can make';
+        writeJobs(jobs);
+        return job;
+    }
+    job.failures = 0;
+    // ── Progress is MEASURED. A batch that did not move is a stall. ──────────
+    const measured = typeof outcome.progress === 'number' ? outcome.progress : job.progress;
+    const moved = measured > job.progress;
+    job.progress = Math.max(job.progress, measured);
+    job.stalledBatches = moved ? 0 : job.stalledBatches + 1;
+    if (job.stalledBatches >= MAX_STALLED_BATCHES) {
+        job.status = 'blocked';
+        job.stopReason = `no measurable progress in ${job.stalledBatches} batches`;
+        job.pendingQuestion =
+            `I've run ${job.stalledBatches} batches with NO measurable progress — the deliverable has not grown ` +
+                `(still ${job.progress}% — ${job.progressLine ?? 'no progress recorded'}). ` +
+                'Something is genuinely wrong that I cannot resolve on my own; how would you like me to proceed?';
+        writeJobs(jobs);
+        return job;
+    }
+    if (now >= job.deadline) {
+        job.status = 'failed';
+        job.stopReason = 'time budget exhausted before the work finished';
+        writeJobs(jobs);
+        return job;
+    }
+    job.status = 'pending';
+    writeJobs(jobs);
+    return job;
+}
+/** Resume a blocked job after the user answered. */
+export function resumeUnattendedJob(id, extraDeadlineMs = 0, now = Date.now()) {
+    const jobs = loadUnattendedJobs(now);
+    const job = jobs.find((j) => j.id === id);
+    if (!job)
+        return undefined;
+    job.status = 'pending';
+    job.pendingQuestion = undefined;
+    job.stopReason = undefined;
+    // An answer is fresh authorization: the stall counter and the clock both get
+    // a new run at it, or the job would stop again on the very next batch.
+    job.stalledBatches = 0;
+    job.failures = 0;
+    if (extraDeadlineMs > 0)
+        job.deadline = Math.max(job.deadline, now + extraDeadlineMs);
+    job.updatedAt = now;
+    writeJobs(jobs);
+    return job;
+}
+// ─── Reporting ──────────────────────────────────────────────────────────────
+/** Percentage complete, clamped. */
+export function jobPercent(job) {
+    return Math.max(0, Math.min(100, Math.round(job.progress)));
+}
+/**
+ * The honest status line for a job.
+ *
+ * Deliberately quotes MEASURED progress and says explicitly that no reply is
+ * needed — the user's complaint was having to reply at all, so a progress
+ * report that ends by asking for one would repeat the mistake in miniature.
+ */
+export function unattendedStatusLine(job) {
+    const head = job.kind === 'long-form' ? '📖' : '🛠️';
+    const pct = jobPercent(job);
+    switch (job.status) {
+        case 'done':
+            return `${head} Job complete — ${job.progressLine ?? 'deliverable written'} (${job.batches} batch${job.batches === 1 ? '' : 'es'}).`;
+        case 'blocked':
+            return `${head} ${pct}% ${job.progressLine ?? ''}\n\n❓ ${job.pendingQuestion ?? job.stopReason ?? 'I need your input to continue.'}`.trim();
+        case 'failed':
+            return `${head} I could not finish this one — ${pct}% done${job.progressLine ? ` (${job.progressLine})` : ''}. ${job.stopReason ?? ''}`.trim();
+        case 'cancelled':
+            return `${head} Stopped — ${job.stopReason ?? 'cancelled'}.`;
+        default:
+            return (`${head} Still working — ${pct}%${job.progressLine ? ` · ${job.progressLine}` : ''} ` +
+                `(batch ${job.batches + 1}). No reply needed; I'll keep going and report when it's done.`);
+    }
+}
+/** How long the job may still run, in ms (0 when the budget is spent). */
+export function remainingBudgetMs(job, now = Date.now()) {
+    return Math.max(0, job.deadline - now);
+}
+/** Test/reset hook. */
+export function clearUnattendedJobs() {
+    writeJobs([]);
+}
+/**
+ * The unattended continuation loop.
+ *
+ * One instance per surface process. `drain()` is the periodic tick: it expires
+ * anything out of time, reports it, then runs whatever is due — looping so a
+ * single tick advances a long job as far as its budget allows instead of one
+ * chapter per tick. Drains are serialized through an internal chain, because
+ * two overlapping drains would run the same job twice and race on the same
+ * files (exactly how the first end-to-end run produced four copies of the last
+ * chapter).
+ */
+export class UnattendedRunner {
+    deps;
+    chain = Promise.resolve();
+    active = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    now() {
+        return this.deps.now ? this.deps.now() : Date.now();
+    }
+    /** Is a drain currently running? Status surfaces use this to show activity. */
+    get isRunning() {
+        return this.active;
+    }
+    /** The jobs this runner would pick up right now. */
+    due() {
+        return dueUnattendedJobs(this.now(), this.deps.owns ?? (() => true));
+    }
+    /**
+     * Advance every due job as far as one tick may.
+     *
+     * @returns how many batches were run.
+     */
+    async drain() {
+        this.chain = this.chain.then(() => this.runOnce()).catch(() => undefined);
+        await this.chain;
+        return this.lastBatches;
+    }
+    lastBatches = 0;
+    async runOnce() {
+        this.active = true;
+        this.lastBatches = 0;
+        try {
+            const now = this.now();
+            // Expiry FIRST: a user who was promised the work must hear the outcome
+            // even when the queue is busy with something else.
+            for (const job of expiredUnattendedJobs(now, this.deps.owns ?? (() => true))) {
+                const expired = stopUnattendedJob(job.id, 'failed', 'time budget exhausted before the work finished', now) ?? job;
+                await this.safeNotify(expired, unattendedStatusLine(expired));
+            }
+            const budget = Math.max(1, this.deps.maxBatchesPerDrain ?? MAX_BATCHES_PER_DRAIN);
+            for (let i = 0; i < budget; i++) {
+                const next = this.due().find((job) => !(this.deps.isBusy?.(job) ?? false));
+                if (!next)
+                    break;
+                const claimed = claimUnattendedJob(next.id, this.now());
+                if (!claimed)
+                    continue;
+                let outcome;
+                try {
+                    outcome = await this.deps.runBatch(claimed);
+                }
+                catch (err) {
+                    outcome = { error: err instanceof Error ? err.message : String(err) };
+                }
+                this.lastBatches += 1;
+                const updated = recordBatchOutcome(claimed.id, outcome, this.now());
+                if (updated && claimed.notify) {
+                    await this.safeNotify(updated, unattendedStatusLine(updated));
+                }
+            }
+        }
+        finally {
+            this.active = false;
+        }
+    }
+    /** A notification must never break the run that produced it. */
+    async safeNotify(job, line) {
+        if (!this.deps.notify)
+            return;
+        try {
+            await this.deps.notify(job, line);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+//# sourceMappingURL=unattended-job.js.map

package/dist/learning/unattended-job.js.map

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

package/dist/learning/unattended-progress.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Measured progress for an unattended job (enterprise-grade hardening, G11).
+ *
+ * WHY THIS IS ITS OWN MODULE. The runner's central guarantee is that progress
+ * is MEASURED, not claimed: a batch that reports success but did not move the
+ * deliverable is a stall, and three stalls stop the run and ask. That rule is
+ * only as good as the measurement, so the measurement lives in one place,
+ * reading artifacts off disk — and every surface (CLI, dashboard, gateway)
+ * measures the same way instead of each inventing its own idea of "done".
+ *
+ * The two inputs:
+ *   1. the long-form ledger — how much of the CONTENT exists (words, units);
+ *   2. the job's `expectedArtifacts` — the files the deliverable promises
+ *      (site, chapter index, optional tools). For a composite ask this is what
+ *      stops "the prose phase finished" being reported as "the deliverable is
+ *      done" while the site is still missing.
+ */
+import { type BatchOutcome, type UnattendedJob, type UnattendedSurface } from './unattended-job.js';
+/**
+ * Weight of the content phase in a composite deliverable's percentage.
+ *
+ * The content IS the deliverable, so it dominates; the surrounding artifacts
+ * are the remaining third. Weighting them any lower would let a beautiful
+ * empty shell sit at 99% after one chapter.
+ */
+export declare const CONTENT_WEIGHT = 0.7;
+/**
+ * How many expected artifacts exist on disk (relative paths resolved against
+ * the project root).
+ *
+ * Split out from the job-shaped wrapper because the orchestrator asks the same
+ * question at planning time — "has this deliverable already been produced?" —
+ * before any job record exists.
+ */
+export declare function artifactsPresence(projectPath: string, expected: string[] | undefined): {
+    present: number;
+    total: number;
+    missing: string[];
+};
+/** How many of a job's expected artifacts exist on disk. */
+export declare function countPresentArtifacts(job: UnattendedJob): {
+    present: number;
+    total: number;
+    missing: string[];
+};
+/**
+ * Measure the job from disk.
+ *
+ * Never throws: a measurement failure must degrade to "no progress recorded",
+ * which the runner correctly treats as a stall, rather than crashing the drain
+ * that is holding the user's promised work.
+ */
+export declare function measureUnattendedProgress(job: UnattendedJob): BatchOutcome;
+/**
+ * Is the deliverable complete right now?
+ *
+ * Used by surfaces to decide whether to keep scheduling a job at all — a
+ * resumed "continue" turn that finds the work already done must not start a
+ * second book (the ledger's oldest failure mode).
+ */
+export declare function isDeliverableComplete(job: UnattendedJob): boolean;
+/**
+ * The slice of an orchestrator result a surface needs to schedule the rest of
+ * the work.
+ *
+ * Declared STRUCTURALLY (not imported from the orchestrator) because the
+ * gateway, the CLI and the dashboard all consume it, and a shared consumer must
+ * not drag the whole agent graph into its import closure.
+ */
+export interface PendingWorkLike {
+    kind: 'long-form' | 'phased';
+    goal: string;
+    projectPath: string;
+    continuationPrompt: string;
+    expectedArtifacts?: string[];
+    progressLine: string;
+    percent: number;
+    reason: string;
+}
+/**
+ * Schedule the continuation of a run that ended with unfinished work — the
+ * replacement for asking the user to type "continue".
+ *
+ * Returns the scheduled job, or `null` when there is nothing left to do. That
+ * second case matters as much as the first: a run that finished its deliverable
+ * must not enqueue a continuation that would immediately re-run and rebuild it.
+ *
+ * @param pending the orchestrator's `result.pendingWork` (may be undefined)
+ * @param surface who to report to and which drain owns the work
+ */
+export declare function scheduleFromPendingWork(pending: PendingWorkLike | undefined, surface: UnattendedSurface, options?: {
+    deadlineMs?: number;
+    notify?: boolean;
+}): UnattendedJob | null;
+//# sourceMappingURL=unattended-progress.d.ts.map

package/dist/learning/unattended-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unattended-progress.d.ts","sourceRoot":"","sources":["../../src/learning/unattended-progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAWvD;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAE/G;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CA+C1E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAGjE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,aAAa,GAAG,IAAI,CAiBtB"}