@sigil0/looking-glass 0.1.0

package/dist/scheduler/store.js

@@ -0,0 +1,1203 @@
+import { randomUUID } from "node:crypto";
+import { statSync } from "node:fs";
+import { isAbsolute } from "node:path";
+import { initialDue, nextCronDue, rejectNul } from "./schedule.js";
+import { sessionPromptReservation } from "./types.js";
+const MAX_DURATION_MS = 2_147_483_647;
+const MAX_OUTPUT_BYTES = 100 * 1024 * 1024;
+const SESSION_PROMPT_COMMAND_SENTINEL = ":";
+function finiteInteger(name, value, minimum, maximum = Number.MAX_SAFE_INTEGER) {
+    if (!Number.isSafeInteger(value) || value < minimum || value > maximum) {
+        throw new Error(`${name} must be an integer between ${minimum} and ${maximum}`);
+    }
+}
+function validateNow(now) {
+    finiteInteger("now", now, 0);
+}
+function jobFromRow(row) {
+    const env = row.env_json ? JSON.parse(row.env_json) : {};
+    const sessionPrompt = row.kind === "command" && row.session_id !== null && row.prompt !== null;
+    return {
+        id: row.id,
+        kind: sessionPrompt ? "session_prompt" : row.kind,
+        scheduleKind: row.schedule_kind,
+        schedule: row.schedule,
+        timezone: row.timezone,
+        message: row.message,
+        command: row.command_text,
+        sessionId: row.session_id,
+        prompt: row.prompt,
+        cwd: row.cwd,
+        env,
+        startGraceMs: row.start_grace_ms,
+        timeoutMs: row.timeout_ms,
+        outputBytes: row.output_bytes,
+        enabled: row.enabled === 1,
+        blockedReason: row.blocked_reason,
+        suspendedBySession: row.suspended_by_session === 1,
+        nextDue: row.next_due,
+        createdAt: row.created_at,
+    };
+}
+function occurrenceFromRow(row) {
+    return {
+        id: row.id,
+        jobId: row.job_id,
+        scheduledAt: row.scheduled_at,
+        state: row.state,
+        claimToken: row.claim_token,
+        claimOwner: row.claim_owner,
+        claimBootId: row.claim_boot_id,
+        claimLeaseExpiresAt: row.claim_lease_expires_at,
+        createdAt: row.created_at,
+        claimedAt: row.claimed_at,
+        startedAt: row.started_at,
+        finishedAt: row.finished_at,
+        exitCode: row.exit_code,
+        signal: row.signal,
+        reason: row.reason,
+        stdout: row.stdout ?? Buffer.alloc(0),
+        stderr: row.stderr ?? Buffer.alloc(0),
+        stdoutBytes: row.stdout_bytes,
+        stderrBytes: row.stderr_bytes,
+        stdoutTruncated: row.stdout_truncated === 1,
+        stderrTruncated: row.stderr_truncated === 1,
+    };
+}
+function leaseFromRow(row) {
+    return {
+        owner: row.owner,
+        bootId: row.boot_id,
+        acquiredAt: row.acquired_at,
+        renewedAt: row.renewed_at,
+        expiresAt: row.expires_at,
+    };
+}
+function validateIdentity(value, field) {
+    rejectNul(value, field);
+    if (value.length === 0)
+        throw new Error(`${field} must not be empty`);
+}
+function validateEnvironment(env) {
+    for (const [key, value] of Object.entries(env)) {
+        validateIdentity(key, "environment variable name");
+        if (key.includes("="))
+            throw new Error("Environment variable names must not contain '='");
+        if (typeof value !== "string")
+            throw new Error(`Environment variable ${key} must be a string`);
+        rejectNul(value, `environment variable ${key}`);
+    }
+}
+function resultInboxMessage(job, state, reason) {
+    const subject = job.kind === "session_prompt" ? "Session turn" : "Command";
+    return reason ? `${subject} ${state}: ${reason}` : `${subject} ${state}`;
+}
+function boundedUtf8(value, maximumBytes) {
+    const full = Buffer.from(value, "utf8");
+    if (full.byteLength <= maximumBytes)
+        return { buffer: full, bytes: full.byteLength, truncated: false };
+    let end = maximumBytes;
+    if (end > 0) {
+        let sequenceStart = end - 1;
+        while (sequenceStart > 0 && (full[sequenceStart] & 0xc0) === 0x80)
+            sequenceStart -= 1;
+        const lead = full[sequenceStart];
+        const sequenceBytes = lead < 0x80 ? 1 : lead < 0xe0 ? 2 : lead < 0xf0 ? 3 : 4;
+        if (sequenceStart + sequenceBytes > end)
+            end = sequenceStart;
+    }
+    return { buffer: full.subarray(0, end), bytes: full.byteLength, truncated: true };
+}
+export class SchedulerStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    createReminder(input, now = Date.now()) {
+        validateNow(now);
+        rejectNul(input.message, "message");
+        if (input.message.length === 0)
+            throw new Error("message must not be empty");
+        const nextDue = initialDue(input.scheduleKind, input.schedule, input.timezone, now);
+        const id = randomUUID();
+        this.db.prepare(`
+      INSERT INTO scheduler_jobs(
+        id, kind, schedule_kind, schedule, timezone, message, enabled, next_due, created_at
+      ) VALUES (?, 'reminder', ?, ?, ?, ?, 1, ?, ?)
+    `).run(id, input.scheduleKind, input.schedule, input.timezone, input.message, nextDue, now);
+        return this.requireJob(id);
+    }
+    createCommand(input, now = Date.now()) {
+        validateNow(now);
+        rejectNul(input.command, "command");
+        rejectNul(input.cwd, "cwd");
+        if (input.command.length === 0)
+            throw new Error("command must not be empty");
+        if (!isAbsolute(input.cwd))
+            throw new Error("Command cwd must be absolute");
+        let cwdIsDirectory = false;
+        try {
+            cwdIsDirectory = statSync(input.cwd).isDirectory();
+        }
+        catch {
+            throw new Error(`Command cwd does not exist: ${input.cwd}`);
+        }
+        if (!cwdIsDirectory)
+            throw new Error(`Command cwd is not a directory: ${input.cwd}`);
+        finiteInteger("startGraceMs", input.startGraceMs, 0, MAX_DURATION_MS);
+        finiteInteger("timeoutMs", input.timeoutMs, 1, MAX_DURATION_MS);
+        finiteInteger("outputBytes", input.outputBytes, 0, MAX_OUTPUT_BYTES);
+        if (input.env !== undefined && (input.env === null || typeof input.env !== "object" || Array.isArray(input.env))) {
+            throw new Error("env must be an object of string overrides");
+        }
+        const env = input.env ?? {};
+        validateEnvironment(env);
+        const nextDue = initialDue(input.scheduleKind, input.schedule, input.timezone, now);
+        const id = randomUUID();
+        this.db.prepare(`
+      INSERT INTO scheduler_jobs(
+        id, kind, schedule_kind, schedule, timezone, command_text, cwd, env_json,
+        start_grace_ms, timeout_ms, output_bytes, enabled, next_due, created_at
+      ) VALUES (?, 'command', ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
+    `).run(id, input.scheduleKind, input.schedule, input.timezone, input.command, input.cwd, JSON.stringify(env), input.startGraceMs, input.timeoutMs, input.outputBytes, nextDue, now);
+        return this.requireJob(id);
+    }
+    createSessionPrompt(input, now = Date.now()) {
+        validateNow(now);
+        validateIdentity(input.sessionId, "sessionId");
+        rejectNul(input.prompt, "prompt");
+        if (input.prompt.trim().length === 0)
+            throw new Error("prompt must not be empty");
+        finiteInteger("startGraceMs", input.startGraceMs, 0, MAX_DURATION_MS);
+        finiteInteger("outputBytes", input.outputBytes, 0, MAX_OUTPUT_BYTES);
+        const nextDue = initialDue(input.scheduleKind, input.schedule, input.timezone, now);
+        const id = randomUUID();
+        const create = this.db.transaction(() => {
+            const session = this.db.prepare(`
+        SELECT workspace, persistent FROM sessions WHERE id = ?
+      `).get(input.sessionId);
+            if (!session)
+                throw new Error(`Session not found: ${input.sessionId}`);
+            if (session.persistent !== 1)
+                throw new Error("Session must be persistent before scheduling prompts");
+            this.db.prepare(`
+        INSERT INTO scheduler_jobs(
+          id, kind, schedule_kind, schedule, timezone, command_text, cwd, env_json,
+          start_grace_ms, timeout_ms, output_bytes, enabled, next_due, created_at,
+          session_id, prompt
+        ) VALUES (?, 'command', ?, ?, ?, ?, ?, '{}', ?, ?, ?, 1, ?, ?, ?, ?)
+      `).run(id, input.scheduleKind, input.schedule, input.timezone, SESSION_PROMPT_COMMAND_SENTINEL, session.workspace, input.startGraceMs, MAX_DURATION_MS, input.outputBytes, nextDue, now, input.sessionId, input.prompt);
+            return this.requireJob(id);
+        });
+        return create.immediate();
+    }
+    listJobs(includeDeleted = false) {
+        const rows = (includeDeleted
+            ? this.db.prepare("SELECT * FROM scheduler_jobs ORDER BY created_at DESC, id").all()
+            : this.db.prepare(`
+          SELECT * FROM scheduler_jobs
+          WHERE blocked_reason IS NULL OR blocked_reason <> 'deleted'
+          ORDER BY created_at DESC, id
+        `).all());
+        return rows.map(jobFromRow);
+    }
+    listJobsForSession(sessionId) {
+        validateIdentity(sessionId, "sessionId");
+        const rows = this.db.prepare(`
+      SELECT * FROM scheduler_jobs
+      WHERE kind = 'command' AND session_id = ? AND prompt IS NOT NULL
+        AND (blocked_reason IS NULL OR blocked_reason <> 'deleted')
+      ORDER BY created_at DESC, id
+    `).all(sessionId);
+        return rows.map(jobFromRow);
+    }
+    setSessionJobsEnabled(sessionId, enabled, now = Date.now()) {
+        validateIdentity(sessionId, "sessionId");
+        if (typeof enabled !== "boolean")
+            throw new Error("enabled must be a boolean");
+        validateNow(now);
+        const update = this.db.transaction(() => {
+            if (enabled && !this.isPersistentSession(sessionId)) {
+                throw new Error("Session must be persistent before enabling scheduled prompts");
+            }
+            const rows = this.db.prepare(`
+        SELECT * FROM scheduler_jobs
+        WHERE kind = 'command' AND session_id = ? AND prompt IS NOT NULL
+          AND (blocked_reason IS NULL OR blocked_reason <> 'deleted')
+        ORDER BY created_at DESC, id
+      `).all(sessionId);
+            if (!enabled) {
+                for (const row of rows) {
+                    if (row.enabled === 1) {
+                        this.db.prepare("UPDATE scheduler_jobs SET enabled = 0, suspended_by_session = 1 WHERE id = ?").run(row.id);
+                        this.cancelUnstarted(row.id, "Session prompt scheduling disabled", now);
+                    }
+                }
+            }
+            else {
+                for (const row of rows) {
+                    const job = jobFromRow(row);
+                    if (!job.suspendedBySession)
+                        continue;
+                    if (job.blockedReason !== null)
+                        continue;
+                    if (job.scheduleKind === "once") {
+                        if (job.nextDue !== null) {
+                            this.db.prepare("UPDATE scheduler_jobs SET enabled = 1, suspended_by_session = 0 WHERE id = ?").run(job.id);
+                        }
+                        else {
+                            this.db.prepare("UPDATE scheduler_jobs SET suspended_by_session = 0 WHERE id = ?").run(job.id);
+                        }
+                        continue;
+                    }
+                    const nextDue = job.nextDue === null || job.nextDue <= now
+                        ? nextCronDue(job.schedule, job.timezone, now)
+                        : job.nextDue;
+                    this.db.prepare("UPDATE scheduler_jobs SET enabled = 1, suspended_by_session = 0, next_due = ? WHERE id = ?")
+                        .run(nextDue, job.id);
+                }
+            }
+            return this.listJobsForSession(sessionId);
+        });
+        return update.immediate();
+    }
+    getJob(id) {
+        const row = this.db.prepare("SELECT * FROM scheduler_jobs WHERE id = ?").get(id);
+        return row ? jobFromRow(row) : null;
+    }
+    pauseJob(id, now = Date.now()) {
+        validateNow(now);
+        const pause = this.db.transaction(() => {
+            this.requireJob(id);
+            this.db.prepare("UPDATE scheduler_jobs SET enabled = 0, suspended_by_session = 0 WHERE id = ?").run(id);
+            this.cancelUnstarted(id, "Job paused", now);
+            return this.requireJob(id);
+        });
+        return pause.immediate();
+    }
+    resumeJob(id) {
+        const resume = this.db.transaction(() => {
+            const job = this.requireJob(id);
+            if (job.blockedReason)
+                throw new Error(`Job is blocked: ${job.blockedReason}`);
+            if (job.nextDue === null)
+                throw new Error("Job has no future occurrence");
+            if (job.kind === "session_prompt" && !this.isPersistentSession(job.sessionId)) {
+                throw new Error("Session must be persistent before resuming scheduled prompts");
+            }
+            this.db.prepare("UPDATE scheduler_jobs SET enabled = 1, suspended_by_session = 0 WHERE id = ?").run(id);
+            return this.requireJob(id);
+        });
+        return resume.immediate();
+    }
+    acknowledgeUnknown(id, now = Date.now()) {
+        validateNow(now);
+        const acknowledge = this.db.transaction(() => {
+            const job = this.requireJob(id);
+            if (!job.blockedReason)
+                return job;
+            if (!/unknown outcome/i.test(job.blockedReason)) {
+                throw new Error(`Job is blocked for another reason: ${job.blockedReason}`);
+            }
+            let nextDue = job.nextDue;
+            if (job.scheduleKind === "cron" && (nextDue === null || nextDue <= now)) {
+                nextDue = nextCronDue(job.schedule, job.timezone, now);
+            }
+            const canEnable = job.scheduleKind === "cron"
+                && (job.kind !== "session_prompt" || this.isPersistentSession(job.sessionId));
+            this.db.prepare(`
+        UPDATE scheduler_jobs
+        SET blocked_reason = NULL, enabled = ?, suspended_by_session = ?, next_due = ?
+        WHERE id = ?
+      `).run(canEnable ? 1 : 0, job.kind === "session_prompt" && !canEnable ? 1 : 0, nextDue, id);
+            return this.requireJob(id);
+        });
+        return acknowledge.immediate();
+    }
+    deleteJob(id, now = Date.now()) {
+        validateNow(now);
+        const remove = this.db.transaction(() => {
+            this.requireJob(id);
+            this.db.prepare(`
+        UPDATE scheduler_jobs
+        SET enabled = 0, suspended_by_session = 0, blocked_reason = 'deleted'
+        WHERE id = ?
+      `).run(id);
+            this.cancelUnstarted(id, "Job deleted", now);
+            return this.requireJob(id);
+        });
+        return remove.immediate();
+    }
+    listInbox(options = {}) {
+        const limit = options.limit ?? 100;
+        finiteInteger("limit", limit, 1, 10_000);
+        const rows = (options.unackedOnly ?? true)
+            ? this.db.prepare(`
+          SELECT * FROM scheduler_inbox
+          WHERE acknowledged_at IS NULL
+          ORDER BY created_at DESC, id DESC LIMIT ?
+        `).all(limit)
+            : this.db.prepare(`
+          SELECT * FROM scheduler_inbox
+          ORDER BY created_at DESC, id DESC LIMIT ?
+        `).all(limit);
+        return rows.map((row) => ({
+            id: row.id,
+            kind: row.kind,
+            jobId: row.job_id,
+            occurrenceId: row.occurrence_id,
+            message: row.message,
+            createdAt: row.created_at,
+            acknowledgedAt: row.acknowledged_at,
+            occurrence: this.requireOccurrence(row.occurrence_id),
+        }));
+    }
+    listInboxForJobs(jobIds, options = {}) {
+        const limit = options.limit ?? 100;
+        finiteInteger("limit", limit, 1, 10_000);
+        if (jobIds.length === 0)
+            return [];
+        for (const id of jobIds)
+            validateIdentity(id, "job id");
+        const rows = [];
+        for (let offset = 0; offset < jobIds.length; offset += 500) {
+            const chunk = jobIds.slice(offset, offset + 500);
+            const placeholders = chunk.map(() => "?").join(", ");
+            const unread = options.unackedOnly ?? true ? "AND acknowledged_at IS NULL" : "";
+            rows.push(...this.db.prepare(`
+        SELECT * FROM scheduler_inbox
+        WHERE job_id IN (${placeholders}) ${unread}
+        ORDER BY created_at DESC, id DESC LIMIT ?
+      `).all(...chunk, limit));
+        }
+        return rows
+            .sort((left, right) => right.created_at - left.created_at || right.id - left.id)
+            .slice(0, limit)
+            .map((row) => ({
+            id: row.id,
+            kind: row.kind,
+            jobId: row.job_id,
+            occurrenceId: row.occurrence_id,
+            message: row.message,
+            createdAt: row.created_at,
+            acknowledgedAt: row.acknowledged_at,
+            occurrence: this.requireOccurrence(row.occurrence_id),
+        }));
+    }
+    getInbox(id) {
+        finiteInteger("inbox id", id, 1);
+        const row = this.db.prepare("SELECT * FROM scheduler_inbox WHERE id = ?").get(id);
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            kind: row.kind,
+            jobId: row.job_id,
+            occurrenceId: row.occurrence_id,
+            message: row.message,
+            createdAt: row.created_at,
+            acknowledgedAt: row.acknowledged_at,
+            occurrence: this.requireOccurrence(row.occurrence_id),
+        };
+    }
+    ackInbox(id, now = Date.now()) {
+        finiteInteger("inbox id", id, 1);
+        validateNow(now);
+        return this.db.prepare(`
+      UPDATE scheduler_inbox SET acknowledged_at = ?
+      WHERE id = ? AND acknowledged_at IS NULL
+    `).run(now, id).changes === 1;
+    }
+    listRuns(jobId, limit = 100) {
+        finiteInteger("limit", limit, 1, 10_000);
+        const rows = jobId
+            ? this.db.prepare(`
+          SELECT * FROM scheduler_occurrences
+          WHERE job_id = ? ORDER BY scheduled_at DESC, id DESC LIMIT ?
+        `).all(jobId, limit)
+            : this.db.prepare(`
+          SELECT * FROM scheduler_occurrences
+          ORDER BY scheduled_at DESC, id DESC LIMIT ?
+        `).all(limit);
+        return rows.map(occurrenceFromRow);
+    }
+    runNow(jobId, now = Date.now()) {
+        validateNow(now);
+        const run = this.db.transaction(() => {
+            const job = this.requireJob(jobId);
+            if (job.blockedReason)
+                throw new Error(`Job is blocked: ${job.blockedReason}`);
+            if (!job.enabled)
+                throw new Error("Job must be enabled before it can run now");
+            if (job.kind === "session_prompt" && !this.isPersistentSession(job.sessionId)) {
+                throw new Error("Session must be persistent to run scheduled prompts");
+            }
+            const latest = this.db.prepare(`
+        SELECT MAX(scheduled_at) AS scheduled_at FROM scheduler_occurrences WHERE job_id = ?
+      `).get(jobId);
+            const scheduledAt = latest.scheduled_at !== null && latest.scheduled_at >= now
+                ? latest.scheduled_at + 1
+                : now;
+            if (job.kind === "reminder") {
+                const occurrenceId = this.insertOccurrence(job.id, scheduledAt, "succeeded", now, now, null);
+                this.insertInbox("reminder", job, occurrenceId, job.message ?? "", now);
+                return this.requireOccurrence(occurrenceId);
+            }
+            const active = this.hasActiveOccurrence(job.id);
+            const state = active ? "skipped" : "pending";
+            const reason = active ? "A previous occurrence is still active" : null;
+            const occurrenceId = this.insertOccurrence(job.id, scheduledAt, state, now, state === "skipped" ? now : null, reason);
+            if (state === "skipped") {
+                this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, state, reason), now);
+            }
+            return this.requireOccurrence(occurrenceId);
+        });
+        return run.immediate();
+    }
+    materialize(now = Date.now(), batchSize = 100) {
+        validateNow(now);
+        finiteInteger("batchSize", batchSize, 1, 10_000);
+        const materializeDue = this.db.transaction(() => {
+            const created = [];
+            for (let index = 0; index < batchSize; index += 1) {
+                const row = this.db.prepare(`
+          SELECT * FROM scheduler_jobs
+          WHERE enabled = 1 AND blocked_reason IS NULL AND next_due IS NOT NULL AND next_due <= ?
+            AND (session_id IS NULL OR EXISTS (
+              SELECT 1 FROM sessions s WHERE s.id = scheduler_jobs.session_id AND s.persistent = 1
+            ))
+          ORDER BY next_due, created_at, id LIMIT 1
+        `).get(now);
+                if (!row)
+                    break;
+                const job = jobFromRow(row);
+                const scheduledAt = job.nextDue;
+                if (scheduledAt === null)
+                    break;
+                let state;
+                let reason = null;
+                if (job.kind === "reminder") {
+                    state = "succeeded";
+                }
+                else if (now - scheduledAt > (job.startGraceMs ?? 0)) {
+                    state = "skipped";
+                    reason = job.kind === "session_prompt"
+                        ? "Occurrence exceeded its session prompt start grace period"
+                        : "Occurrence exceeded its command start grace period";
+                }
+                else if (this.hasActiveOccurrence(job.id)) {
+                    state = "skipped";
+                    reason = "A previous occurrence is still active";
+                }
+                else {
+                    state = "pending";
+                }
+                const terminalAt = state === "pending" ? null : now;
+                const insert = this.db.prepare(`
+          INSERT OR IGNORE INTO scheduler_occurrences(
+            job_id, scheduled_at, state, created_at, started_at, finished_at, reason
+          ) VALUES (?, ?, ?, ?, ?, ?, ?)
+        `).run(job.id, scheduledAt, state, now, terminalAt, terminalAt, reason);
+                if (insert.changes === 1) {
+                    const occurrenceId = Number(insert.lastInsertRowid);
+                    if (job.kind === "reminder") {
+                        this.insertInbox("reminder", job, occurrenceId, job.message ?? "", now);
+                    }
+                    else if (state === "skipped") {
+                        this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, state, reason), now);
+                    }
+                    created.push(this.requireOccurrence(occurrenceId));
+                }
+                if (job.scheduleKind === "once") {
+                    this.db.prepare("UPDATE scheduler_jobs SET enabled = ?, next_due = NULL WHERE id = ?")
+                        .run(job.kind !== "reminder" && state === "pending" ? 1 : 0, job.id);
+                }
+                else {
+                    let nextDue = nextCronDue(job.schedule, job.timezone, scheduledAt);
+                    let skippedCursors = 0;
+                    while (nextDue <= now && skippedCursors < 10_000) {
+                        nextDue = nextCronDue(job.schedule, job.timezone, nextDue);
+                        skippedCursors += 1;
+                    }
+                    if (nextDue <= now)
+                        nextDue = nextCronDue(job.schedule, job.timezone, now);
+                    this.db.prepare("UPDATE scheduler_jobs SET next_due = ? WHERE id = ?").run(nextDue, job.id);
+                }
+            }
+            return created;
+        });
+        return materializeDue.immediate();
+    }
+    tick(now = Date.now(), batchSize = 100) {
+        return this.materialize(now, batchSize);
+    }
+    acquireLease(owner, bootId, now = Date.now(), leaseMs = 20_000) {
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        finiteInteger("leaseMs", leaseMs, 1, MAX_DURATION_MS);
+        const acquire = this.db.transaction(() => {
+            const current = this.db.prepare("SELECT * FROM scheduler_daemon_lease WHERE singleton = 1").get();
+            if (current && current.expires_at > now && (current.owner !== owner || current.boot_id !== bootId))
+                return false;
+            if (current && current.expires_at <= now)
+                this.recoverInterrupted(now);
+            if (current) {
+                this.db.prepare(`
+          UPDATE scheduler_daemon_lease
+          SET owner = ?, boot_id = ?, acquired_at = ?, renewed_at = ?, expires_at = ?
+          WHERE singleton = 1
+        `).run(owner, bootId, now, now, now + leaseMs);
+            }
+            else {
+                this.db.prepare(`
+          INSERT INTO scheduler_daemon_lease(singleton, owner, boot_id, acquired_at, renewed_at, expires_at)
+          VALUES (1, ?, ?, ?, ?, ?)
+        `).run(owner, bootId, now, now, now + leaseMs);
+            }
+            return true;
+        });
+        return acquire.immediate();
+    }
+    renewLease(owner, bootId, now = Date.now(), leaseMs = 20_000) {
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        finiteInteger("leaseMs", leaseMs, 1, MAX_DURATION_MS);
+        const renew = this.db.transaction(() => {
+            const result = this.db.prepare(`
+        UPDATE scheduler_daemon_lease SET renewed_at = ?, expires_at = ?
+        WHERE singleton = 1 AND owner = ? AND boot_id = ? AND expires_at > ?
+      `).run(now, now + leaseMs, owner, bootId, now);
+            if (result.changes !== 1)
+                return false;
+            this.db.prepare(`
+        UPDATE scheduler_occurrences SET claim_lease_expires_at = ?
+        WHERE state IN ('claimed', 'running') AND claim_owner = ? AND claim_boot_id = ?
+      `).run(now + leaseMs, owner, bootId);
+            return true;
+        });
+        return renew.immediate();
+    }
+    releaseLease(owner, bootId, now = Date.now()) {
+        validateNow(now);
+        const release = this.db.transaction(() => this.db.prepare(`
+      UPDATE scheduler_daemon_lease SET renewed_at = ?, expires_at = ?
+      WHERE singleton = 1 AND owner = ? AND boot_id = ?
+    `).run(now, now, owner, bootId).changes === 1);
+        return release.immediate();
+    }
+    getLease() {
+        const row = this.db.prepare("SELECT * FROM scheduler_daemon_lease WHERE singleton = 1").get();
+        return row ? leaseFromRow(row) : null;
+    }
+    claimCommands(owner, bootId, now = Date.now(), leaseMs = 20_000, limit = 1) {
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        finiteInteger("leaseMs", leaseMs, 1, MAX_DURATION_MS);
+        finiteInteger("limit", limit, 1, 1_000);
+        const claim = this.db.transaction(() => {
+            const lease = this.db.prepare(`
+        SELECT expires_at FROM scheduler_daemon_lease
+        WHERE singleton = 1 AND owner = ? AND boot_id = ? AND expires_at > ?
+      `).get(owner, bootId, now);
+            if (!lease)
+                return [];
+            const overdue = this.db.prepare(`
+        UPDATE scheduler_occurrences
+        SET state = 'skipped', started_at = ?, finished_at = ?,
+            reason = 'Occurrence exceeded its command start grace period'
+        WHERE state = 'pending' AND id IN (
+          SELECT o.id FROM scheduler_occurrences o
+           JOIN scheduler_jobs j ON j.id = o.job_id
+           WHERE o.state = 'pending' AND j.kind = 'command'
+             AND j.session_id IS NULL
+             AND o.scheduled_at + j.start_grace_ms < ?
+        )
+        RETURNING id, job_id
+      `).all(now, now, now);
+            for (const row of overdue) {
+                const job = this.requireCommandJob(row.job_id);
+                this.disableCompletedOneShot(job.id);
+                this.insertInbox("command_result", job, row.id, resultInboxMessage(job, "skipped", "Occurrence exceeded its command start grace period"), now);
+            }
+            const rows = this.db.prepare(`
+        SELECT o.* FROM scheduler_occurrences o
+        JOIN scheduler_jobs j ON j.id = o.job_id
+        WHERE o.state = 'pending' AND j.kind = 'command'
+          AND j.session_id IS NULL
+          AND j.enabled = 1 AND j.blocked_reason IS NULL
+        ORDER BY o.scheduled_at, o.id LIMIT ?
+      `).all(limit);
+            const claimed = [];
+            for (const row of rows) {
+                const token = randomUUID();
+                const claimExpiresAt = Math.min(now + leaseMs, lease.expires_at);
+                const result = this.db.prepare(`
+          UPDATE scheduler_occurrences
+          SET state = 'claimed', claim_token = ?, claim_owner = ?, claim_boot_id = ?,
+              claim_lease_expires_at = ?, claimed_at = ?
+          WHERE id = ? AND state = 'pending'
+            AND EXISTS (
+              SELECT 1 FROM scheduler_jobs j
+              WHERE j.id = scheduler_occurrences.job_id AND j.kind = 'command'
+                AND j.session_id IS NULL
+                AND j.enabled = 1 AND j.blocked_reason IS NULL
+            )
+        `).run(token, owner, bootId, claimExpiresAt, now, row.id);
+                if (result.changes !== 1)
+                    continue;
+                const occurrence = this.requireOccurrence(row.id);
+                const job = this.requireCommandJob(row.job_id);
+                if (occurrence.state !== "claimed"
+                    || occurrence.claimToken === null
+                    || occurrence.claimOwner === null
+                    || occurrence.claimBootId === null
+                    || occurrence.claimLeaseExpiresAt === null) {
+                    throw new Error("Claim transition did not persist");
+                }
+                claimed.push({
+                    job,
+                    occurrence: {
+                        ...occurrence,
+                        state: "claimed",
+                        claimToken: occurrence.claimToken,
+                        claimOwner: occurrence.claimOwner,
+                        claimBootId: occurrence.claimBootId,
+                        claimLeaseExpiresAt: occurrence.claimLeaseExpiresAt,
+                    },
+                });
+            }
+            return claimed;
+        });
+        return claim.immediate();
+    }
+    startClaimedCommand(occurrenceId, claimToken, owner, bootId, now = Date.now()) {
+        finiteInteger("occurrence id", occurrenceId, 1);
+        validateIdentity(claimToken, "claimToken");
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        const start = this.db.transaction(() => {
+            const lease = this.db.prepare(`
+        SELECT expires_at FROM scheduler_daemon_lease
+        WHERE singleton = 1 AND owner = ? AND boot_id = ? AND expires_at > ?
+      `).get(owner, bootId, now);
+            if (!lease)
+                return null;
+            const row = this.db.prepare(`
+        SELECT o.* FROM scheduler_occurrences o
+        WHERE o.id = ? AND o.claim_token = ? AND o.claim_owner = ? AND o.claim_boot_id = ?
+          AND o.claim_lease_expires_at > ?
+          AND EXISTS (
+            SELECT 1 FROM scheduler_jobs j
+            WHERE j.id = o.job_id AND j.kind = 'command' AND j.session_id IS NULL
+          )
+      `).get(occurrenceId, claimToken, owner, bootId, now);
+            if (!row)
+                return null;
+            if (row.state === "cancelled" || row.state === "skipped")
+                return occurrenceFromRow(row);
+            if (row.state !== "claimed")
+                return null;
+            const job = this.requireCommandJob(row.job_id);
+            if (!job.enabled || job.blockedReason !== null) {
+                const reason = job.blockedReason === "deleted" ? "Job deleted" : "Job paused";
+                const result = this.db.prepare(`
+          UPDATE scheduler_occurrences
+          SET state = 'cancelled', finished_at = ?, reason = ?
+          WHERE id = ? AND state = 'claimed' AND claim_token = ?
+            AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+        `).run(now, reason, occurrenceId, claimToken, owner, bootId, now);
+                if (result.changes !== 1)
+                    return null;
+                this.disableCompletedOneShot(job.id);
+                this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, "cancelled", reason), now);
+                return this.requireOccurrence(occurrenceId);
+            }
+            if (now - row.scheduled_at > (job.startGraceMs ?? 0)) {
+                const reason = "Occurrence exceeded its command start grace period";
+                const result = this.db.prepare(`
+          UPDATE scheduler_occurrences
+          SET state = 'skipped', started_at = ?, finished_at = ?, reason = ?
+          WHERE id = ? AND state = 'claimed' AND claim_token = ?
+            AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+        `).run(now, now, reason, occurrenceId, claimToken, owner, bootId, now);
+                if (result.changes !== 1)
+                    return null;
+                this.disableCompletedOneShot(job.id);
+                this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, "skipped", reason), now);
+                return this.requireOccurrence(occurrenceId);
+            }
+            const result = this.db.prepare(`
+        UPDATE scheduler_occurrences SET state = 'running', started_at = ?
+        WHERE id = ? AND state = 'claimed' AND claim_token = ?
+          AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+          AND scheduled_at + ? >= ?
+          AND EXISTS (
+            SELECT 1 FROM scheduler_jobs j
+            WHERE j.id = scheduler_occurrences.job_id
+              AND j.kind = 'command' AND j.session_id IS NULL
+              AND j.enabled = 1 AND j.blocked_reason IS NULL
+          )
+          AND EXISTS (
+            SELECT 1 FROM scheduler_daemon_lease l
+            WHERE l.singleton = 1 AND l.owner = ? AND l.boot_id = ? AND l.expires_at > ?
+          )
+      `).run(now, occurrenceId, claimToken, owner, bootId, now, job.startGraceMs ?? 0, now, owner, bootId, now);
+            return result.changes === 1 ? this.requireOccurrence(occurrenceId) : null;
+        });
+        return start.immediate();
+    }
+    releaseSessionPromptReservation(sessionId, owner, token) {
+        validateIdentity(sessionId, "sessionId");
+        validateIdentity(owner, "reservation owner");
+        validateIdentity(token, "reservation token");
+        return this.db.prepare(`
+      DELETE FROM session_operation_leases WHERE session_id = ? AND owner = ? AND token = ?
+    `).run(sessionId, owner, token).changes === 1;
+    }
+    finishCommand(occurrenceId, claimToken, owner, bootId, completion, now = Date.now()) {
+        finiteInteger("occurrence id", occurrenceId, 1);
+        validateIdentity(claimToken, "claimToken");
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        finiteInteger("stdoutBytes", completion.stdoutBytes, 0);
+        finiteInteger("stderrBytes", completion.stderrBytes, 0);
+        const finish = this.db.transaction(() => {
+            const row = this.db.prepare(`
+        SELECT j.* FROM scheduler_jobs j
+        JOIN scheduler_occurrences o ON o.job_id = j.id
+        JOIN scheduler_daemon_lease l ON l.singleton = 1
+        WHERE o.id = ? AND o.state = 'running' AND o.claim_token = ?
+          AND o.claim_owner = ? AND o.claim_boot_id = ? AND o.claim_lease_expires_at > ?
+          AND j.kind = 'command' AND j.session_id IS NULL
+          AND l.owner = ? AND l.boot_id = ? AND l.expires_at > ?
+      `).get(occurrenceId, claimToken, owner, bootId, now, owner, bootId, now);
+            if (!row)
+                return null;
+            const job = jobFromRow(row);
+            const outputLimit = job.outputBytes ?? 0;
+            const stdout = completion.stdout.subarray(0, outputLimit);
+            const stderr = completion.stderr.subarray(0, outputLimit);
+            const stdoutBytes = Math.max(completion.stdoutBytes, completion.stdout.byteLength);
+            const stderrBytes = Math.max(completion.stderrBytes, completion.stderr.byteLength);
+            const result = this.db.prepare(`
+        UPDATE scheduler_occurrences
+        SET state = ?, finished_at = ?, exit_code = ?, signal = ?, reason = ?,
+            stdout = ?, stderr = ?, stdout_bytes = ?, stderr_bytes = ?,
+            stdout_truncated = ?, stderr_truncated = ?
+        WHERE id = ? AND state = 'running' AND claim_token = ?
+          AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+          AND EXISTS (
+            SELECT 1 FROM scheduler_daemon_lease l
+            WHERE l.singleton = 1 AND l.owner = ? AND l.boot_id = ? AND l.expires_at > ?
+          )
+      `).run(completion.state, now, completion.exitCode, completion.signal, completion.reason, stdout, stderr, stdoutBytes, stderrBytes, completion.stdoutTruncated || stdoutBytes > outputLimit ? 1 : 0, completion.stderrTruncated || stderrBytes > outputLimit ? 1 : 0, occurrenceId, claimToken, owner, bootId, now, owner, bootId, now);
+            if (result.changes !== 1)
+                return null;
+            if (completion.state === "unknown")
+                this.blockUnknownJob(job.id);
+            else
+                this.disableCompletedOneShot(job.id);
+            this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, completion.state, completion.reason), now);
+            return this.requireOccurrence(occurrenceId);
+        });
+        return finish.immediate();
+    }
+    claimSessionPrompts(owner, bootId, now = Date.now(), leaseMs = 20_000, limit = 1) {
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        finiteInteger("leaseMs", leaseMs, 1, MAX_DURATION_MS);
+        finiteInteger("limit", limit, 1, 1_000);
+        const claim = this.db.transaction(() => {
+            const lease = this.db.prepare(`
+        SELECT expires_at FROM scheduler_daemon_lease
+        WHERE singleton = 1 AND owner = ? AND boot_id = ? AND expires_at > ?
+      `).get(owner, bootId, now);
+            if (!lease)
+                return [];
+            const overdue = this.db.prepare(`
+        UPDATE scheduler_occurrences
+        SET state = 'skipped', started_at = ?, finished_at = ?,
+            reason = 'Occurrence exceeded its session prompt start grace period'
+        WHERE state = 'pending' AND id IN (
+          SELECT o.id FROM scheduler_occurrences o
+          JOIN scheduler_jobs j ON j.id = o.job_id
+          JOIN sessions s ON s.id = j.session_id
+          WHERE o.state = 'pending' AND j.kind = 'command'
+            AND j.session_id IS NOT NULL AND j.prompt IS NOT NULL
+            AND j.enabled = 1 AND j.blocked_reason IS NULL AND s.persistent = 1
+            AND o.scheduled_at + j.start_grace_ms < ?
+        )
+        RETURNING id, job_id
+      `).all(now, now, now);
+            for (const row of overdue) {
+                const job = this.requireSessionPromptJob(row.job_id);
+                this.disableCompletedOneShot(job.id);
+                this.insertInbox("command_result", job, row.id, resultInboxMessage(job, "skipped", "Occurrence exceeded its session prompt start grace period"), now);
+            }
+            const rows = this.db.prepare(`
+        SELECT o.* FROM scheduler_occurrences o
+        JOIN scheduler_jobs j ON j.id = o.job_id
+        JOIN sessions s ON s.id = j.session_id
+        WHERE o.state = 'pending' AND j.kind = 'command'
+          AND j.session_id IS NOT NULL AND j.prompt IS NOT NULL
+          AND j.enabled = 1 AND j.blocked_reason IS NULL AND s.persistent = 1
+          AND NOT EXISTS (
+            SELECT 1 FROM session_operation_leases sol
+            WHERE sol.session_id = j.session_id AND sol.expires_at > ?
+          )
+          AND NOT EXISTS (
+            SELECT 1 FROM scheduler_occurrences active
+            JOIN scheduler_jobs active_job ON active_job.id = active.job_id
+            WHERE active_job.session_id = j.session_id AND active.state IN ('claimed', 'running')
+          )
+        ORDER BY o.scheduled_at, o.id LIMIT ?
+      `).all(now, limit);
+            const claimed = [];
+            for (const row of rows) {
+                const token = randomUUID();
+                const claimExpiresAt = Math.min(now + leaseMs, lease.expires_at);
+                const result = this.db.prepare(`
+          UPDATE scheduler_occurrences
+          SET state = 'claimed', claim_token = ?, claim_owner = ?, claim_boot_id = ?,
+              claim_lease_expires_at = ?, claimed_at = ?
+          WHERE id = ? AND state = 'pending'
+            AND EXISTS (
+              SELECT 1 FROM scheduler_jobs j
+              JOIN sessions s ON s.id = j.session_id
+              WHERE j.id = scheduler_occurrences.job_id AND j.kind = 'command'
+                AND j.session_id IS NOT NULL AND j.prompt IS NOT NULL
+                AND j.enabled = 1 AND j.blocked_reason IS NULL AND s.persistent = 1
+                AND NOT EXISTS (
+                  SELECT 1 FROM session_operation_leases sol
+                  WHERE sol.session_id = j.session_id AND sol.expires_at > ?
+                )
+                AND NOT EXISTS (
+                  SELECT 1 FROM scheduler_occurrences active
+                  JOIN scheduler_jobs active_job ON active_job.id = active.job_id
+                  WHERE active_job.session_id = j.session_id
+                    AND active.id <> scheduler_occurrences.id
+                    AND active.state IN ('claimed', 'running')
+                )
+            )
+        `).run(token, owner, bootId, claimExpiresAt, now, row.id, now);
+                if (result.changes !== 1)
+                    continue;
+                const occurrence = this.requireOccurrence(row.id);
+                const job = this.requireSessionPromptJob(row.job_id);
+                if (occurrence.state !== "claimed"
+                    || occurrence.claimToken === null
+                    || occurrence.claimOwner === null
+                    || occurrence.claimBootId === null
+                    || occurrence.claimLeaseExpiresAt === null) {
+                    throw new Error("Session prompt claim transition did not persist");
+                }
+                claimed.push({
+                    job,
+                    occurrence: {
+                        ...occurrence,
+                        state: "claimed",
+                        claimToken: occurrence.claimToken,
+                        claimOwner: occurrence.claimOwner,
+                        claimBootId: occurrence.claimBootId,
+                        claimLeaseExpiresAt: occurrence.claimLeaseExpiresAt,
+                    },
+                });
+            }
+            return claimed;
+        });
+        return claim.immediate();
+    }
+    startClaimedSessionPrompt(occurrenceId, claimToken, owner, bootId, now = Date.now()) {
+        finiteInteger("occurrence id", occurrenceId, 1);
+        validateIdentity(claimToken, "claimToken");
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        const start = this.db.transaction(() => {
+            const lease = this.db.prepare(`
+        SELECT expires_at FROM scheduler_daemon_lease
+        WHERE singleton = 1 AND owner = ? AND boot_id = ? AND expires_at > ?
+      `).get(owner, bootId, now);
+            if (!lease)
+                return null;
+            const row = this.db.prepare(`
+        SELECT o.* FROM scheduler_occurrences o
+        WHERE o.id = ? AND o.claim_token = ? AND o.claim_owner = ? AND o.claim_boot_id = ?
+          AND o.claim_lease_expires_at > ?
+          AND EXISTS (
+            SELECT 1 FROM scheduler_jobs j
+            WHERE j.id = o.job_id AND j.kind = 'command'
+              AND j.session_id IS NOT NULL AND j.prompt IS NOT NULL
+          )
+      `).get(occurrenceId, claimToken, owner, bootId, now);
+            if (!row)
+                return null;
+            if (row.state === "cancelled" || row.state === "skipped")
+                return occurrenceFromRow(row);
+            if (row.state !== "claimed")
+                return null;
+            const job = this.requireSessionPromptJob(row.job_id);
+            const persistent = this.isPersistentSession(job.sessionId);
+            if (!job.enabled || job.blockedReason !== null || !persistent) {
+                const reason = job.blockedReason === "deleted"
+                    ? "Job deleted"
+                    : !persistent
+                        ? "Session is no longer persistent"
+                        : "Job paused";
+                const result = this.db.prepare(`
+          UPDATE scheduler_occurrences
+          SET state = 'cancelled', finished_at = ?, reason = ?
+          WHERE id = ? AND state = 'claimed' AND claim_token = ?
+            AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+        `).run(now, reason, occurrenceId, claimToken, owner, bootId, now);
+                if (result.changes !== 1)
+                    return null;
+                this.disableCompletedOneShot(job.id);
+                this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, "cancelled", reason), now);
+                return this.requireOccurrence(occurrenceId);
+            }
+            const sessionBusy = this.db.prepare(`
+        SELECT 1 FROM session_operation_leases WHERE session_id = ? AND expires_at > ?
+      `).get(job.sessionId, now);
+            if (sessionBusy) {
+                const deferred = this.db.prepare(`
+          UPDATE scheduler_occurrences
+          SET state = 'pending', claim_token = NULL, claim_owner = NULL,
+              claim_boot_id = NULL, claim_lease_expires_at = NULL, claimed_at = NULL
+          WHERE id = ? AND state = 'claimed' AND claim_token = ?
+            AND claim_owner = ? AND claim_boot_id = ?
+        `).run(occurrenceId, claimToken, owner, bootId);
+                return deferred.changes === 1 ? this.requireOccurrence(occurrenceId) : null;
+            }
+            if (now - row.scheduled_at > (job.startGraceMs ?? 0)) {
+                const reason = "Occurrence exceeded its session prompt start grace period";
+                const result = this.db.prepare(`
+          UPDATE scheduler_occurrences
+          SET state = 'skipped', started_at = ?, finished_at = ?, reason = ?
+          WHERE id = ? AND state = 'claimed' AND claim_token = ?
+            AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+        `).run(now, now, reason, occurrenceId, claimToken, owner, bootId, now);
+                if (result.changes !== 1)
+                    return null;
+                this.disableCompletedOneShot(job.id);
+                this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, "skipped", reason), now);
+                return this.requireOccurrence(occurrenceId);
+            }
+            const reservation = sessionPromptReservation(owner, bootId, claimToken);
+            this.db.prepare(`
+        DELETE FROM session_operation_leases WHERE session_id = ? AND expires_at <= ?
+      `).run(job.sessionId, now);
+            const reserved = this.db.prepare(`
+        INSERT OR IGNORE INTO session_operation_leases(
+          session_id, owner, token, kind, acquired_at, renewed_at, expires_at
+        ) VALUES (?, ?, ?, 'turn', ?, ?, ?)
+      `).run(job.sessionId, reservation.owner, reservation.token, now, now, lease.expires_at);
+            if (reserved.changes !== 1)
+                return null;
+            const result = this.db.prepare(`
+        UPDATE scheduler_occurrences SET state = 'running', started_at = ?
+        WHERE id = ? AND state = 'claimed' AND claim_token = ?
+          AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+          AND scheduled_at + ? >= ?
+          AND EXISTS (
+            SELECT 1 FROM scheduler_jobs j
+            JOIN sessions s ON s.id = j.session_id
+            WHERE j.id = scheduler_occurrences.job_id AND j.kind = 'command'
+              AND j.session_id IS NOT NULL AND j.prompt IS NOT NULL
+              AND j.enabled = 1 AND j.blocked_reason IS NULL AND s.persistent = 1
+          )
+          AND EXISTS (
+            SELECT 1 FROM scheduler_daemon_lease l
+            WHERE l.singleton = 1 AND l.owner = ? AND l.boot_id = ? AND l.expires_at > ?
+          )
+      `).run(now, occurrenceId, claimToken, owner, bootId, now, job.startGraceMs ?? 0, now, owner, bootId, now);
+            if (result.changes !== 1) {
+                this.releaseSessionPromptReservation(job.sessionId, reservation.owner, reservation.token);
+                return null;
+            }
+            return this.requireOccurrence(occurrenceId);
+        });
+        return start.immediate();
+    }
+    finishSessionPrompt(occurrenceId, claimToken, owner, bootId, completion, now = Date.now()) {
+        finiteInteger("occurrence id", occurrenceId, 1);
+        validateIdentity(claimToken, "claimToken");
+        validateIdentity(owner, "owner");
+        validateIdentity(bootId, "bootId");
+        validateNow(now);
+        if (!["succeeded", "failed", "cancelled", "unknown"].includes(completion.state)) {
+            throw new Error(`Invalid session prompt completion state: ${String(completion.state)}`);
+        }
+        const output = completion.output ?? completion.result ?? "";
+        const error = completion.error ?? "";
+        if (typeof output !== "string")
+            throw new Error("Session prompt output must be a string");
+        if (typeof error !== "string")
+            throw new Error("Session prompt error must be a string");
+        const finish = this.db.transaction(() => {
+            const row = this.db.prepare(`
+        SELECT j.* FROM scheduler_jobs j
+        JOIN scheduler_occurrences o ON o.job_id = j.id
+        JOIN scheduler_daemon_lease l ON l.singleton = 1
+        WHERE o.id = ? AND o.state = 'running' AND o.claim_token = ?
+          AND o.claim_owner = ? AND o.claim_boot_id = ? AND o.claim_lease_expires_at > ?
+          AND j.kind = 'command' AND j.session_id IS NOT NULL AND j.prompt IS NOT NULL
+          AND l.owner = ? AND l.boot_id = ? AND l.expires_at > ?
+      `).get(occurrenceId, claimToken, owner, bootId, now, owner, bootId, now);
+            if (!row)
+                return null;
+            const job = this.requireSessionPromptJob(row.id);
+            const outputLimit = job.outputBytes ?? 0;
+            const stdout = boundedUtf8(output, outputLimit);
+            const stderr = boundedUtf8(error, outputLimit);
+            const reason = completion.reason ?? (completion.state === "failed" && error ? error : null);
+            const result = this.db.prepare(`
+        UPDATE scheduler_occurrences
+        SET state = ?, finished_at = ?, exit_code = NULL, signal = NULL, reason = ?,
+            stdout = ?, stderr = ?, stdout_bytes = ?, stderr_bytes = ?,
+            stdout_truncated = ?, stderr_truncated = ?
+        WHERE id = ? AND state = 'running' AND claim_token = ?
+          AND claim_owner = ? AND claim_boot_id = ? AND claim_lease_expires_at > ?
+          AND EXISTS (
+            SELECT 1 FROM scheduler_daemon_lease l
+            WHERE l.singleton = 1 AND l.owner = ? AND l.boot_id = ? AND l.expires_at > ?
+          )
+      `).run(completion.state, now, reason, stdout.buffer, stderr.buffer, stdout.bytes, stderr.bytes, stdout.truncated ? 1 : 0, stderr.truncated ? 1 : 0, occurrenceId, claimToken, owner, bootId, now, owner, bootId, now);
+            if (result.changes !== 1)
+                return null;
+            const reservation = sessionPromptReservation(owner, bootId, claimToken);
+            this.releaseSessionPromptReservation(job.sessionId, reservation.owner, reservation.token);
+            if (completion.state === "unknown")
+                this.blockUnknownJob(job.id);
+            else
+                this.disableCompletedOneShot(job.id);
+            this.insertInbox("command_result", job, occurrenceId, resultInboxMessage(job, completion.state, reason), now);
+            return this.requireOccurrence(occurrenceId);
+        });
+        return finish.immediate();
+    }
+    cancelUnstarted(jobId, reason, now) {
+        const rows = this.db.prepare(`
+      UPDATE scheduler_occurrences
+      SET state = 'cancelled', finished_at = ?, reason = ?
+      WHERE job_id = ? AND state IN ('pending', 'claimed')
+      RETURNING id
+    `).all(now, reason, jobId);
+        const job = this.requireJob(jobId);
+        if (job.kind === "reminder")
+            return;
+        for (const row of rows) {
+            this.insertInbox("command_result", job, row.id, resultInboxMessage(job, "cancelled", reason), now);
+        }
+    }
+    recoverInterrupted(now) {
+        const interrupted = this.db.prepare(`
+      UPDATE scheduler_occurrences
+      SET state = 'unknown', finished_at = ?, reason = 'Daemon lease expired before the result was recorded'
+      WHERE state IN ('claimed', 'running')
+      RETURNING id, job_id
+    `).all(now);
+        for (const row of interrupted) {
+            const job = this.requireJob(row.job_id);
+            if (job.kind !== "reminder") {
+                this.insertInbox("command_result", job, row.id, resultInboxMessage(job, "unknown", "Daemon lease expired before the result was recorded"), now);
+            }
+        }
+        this.db.prepare(`
+      UPDATE scheduler_jobs
+      SET enabled = 0, blocked_reason = 'An occurrence has an unknown outcome'
+      WHERE kind = 'command' AND schedule_kind = 'cron' AND id IN (
+        SELECT job_id FROM scheduler_occurrences WHERE state = 'unknown'
+      )
+    `).run();
+        this.db.prepare(`
+      UPDATE scheduler_jobs SET enabled = 0
+      WHERE kind = 'command' AND schedule_kind = 'once' AND id IN (
+        SELECT job_id FROM scheduler_occurrences WHERE state = 'unknown'
+      )
+    `).run();
+    }
+    disableCompletedOneShot(jobId) {
+        this.db.prepare(`
+      UPDATE scheduler_jobs SET enabled = 0
+      WHERE id = ? AND schedule_kind = 'once' AND next_due IS NULL
+    `).run(jobId);
+    }
+    blockUnknownJob(jobId) {
+        this.db.prepare(`
+      UPDATE scheduler_jobs
+      SET enabled = 0, blocked_reason = CASE
+        WHEN schedule_kind = 'cron' THEN 'An occurrence has an unknown outcome'
+        ELSE blocked_reason
+      END
+      WHERE id = ?
+    `).run(jobId);
+    }
+    insertOccurrence(jobId, scheduledAt, state, createdAt, finishedAt, reason) {
+        const result = this.db.prepare(`
+      INSERT INTO scheduler_occurrences(
+        job_id, scheduled_at, state, created_at, started_at, finished_at, reason
+      ) VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(jobId, scheduledAt, state, createdAt, finishedAt, finishedAt, reason);
+        return Number(result.lastInsertRowid);
+    }
+    insertInbox(kind, job, occurrenceId, message, now) {
+        this.db.prepare(`
+      INSERT OR IGNORE INTO scheduler_inbox(kind, job_id, occurrence_id, message, created_at)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(kind, job.id, occurrenceId, message, now);
+    }
+    hasActiveOccurrence(jobId) {
+        return Boolean(this.db.prepare(`
+      SELECT 1 FROM scheduler_occurrences
+      WHERE job_id = ? AND state IN ('pending', 'claimed', 'running') LIMIT 1
+    `).get(jobId));
+    }
+    requireJob(id) {
+        const job = this.getJob(id);
+        if (!job)
+            throw new Error(`Scheduler job not found: ${id}`);
+        return job;
+    }
+    requireCommandJob(id) {
+        const job = this.requireJob(id);
+        if (job.kind !== "command" || job.sessionId !== null || job.command === null || job.cwd === null) {
+            throw new Error(`Scheduler job is not a command: ${id}`);
+        }
+        return { ...job, kind: "command", command: job.command, cwd: job.cwd };
+    }
+    requireSessionPromptJob(id) {
+        const job = this.requireJob(id);
+        if (job.kind !== "session_prompt"
+            || job.sessionId === null
+            || job.prompt === null
+            || job.cwd === null) {
+            throw new Error(`Scheduler job is not a session prompt: ${id}`);
+        }
+        return {
+            ...job,
+            kind: "session_prompt",
+            sessionId: job.sessionId,
+            prompt: job.prompt,
+            cwd: job.cwd,
+        };
+    }
+    isPersistentSession(sessionId) {
+        if (sessionId === null)
+            return false;
+        return Boolean(this.db.prepare("SELECT 1 FROM sessions WHERE id = ? AND persistent = 1").get(sessionId));
+    }
+    requireOccurrence(id) {
+        const row = this.db.prepare("SELECT * FROM scheduler_occurrences WHERE id = ?").get(id);
+        if (!row)
+            throw new Error(`Scheduler occurrence not found: ${id}`);
+        return occurrenceFromRow(row);
+    }
+}
+//# sourceMappingURL=store.js.map