@kvman/kernel 0.1.0

package/dist/jobs/dispatcher.js

@@ -0,0 +1,201 @@
+import { ProblemError } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+import { backoffMs, isRetried } from "./retry-policy.js";
+export function createDispatcher(options) {
+    const { connection, rows, schedules, clock } = options;
+    let pool;
+    let handlers = [];
+    let mode = 'running';
+    let timer;
+    // Set when due jobs may be waiting for a free slot, so a slot freed by a sync job only wakes the loop then.
+    let waitingForSlot = false;
+    const attempts = new Map();
+    const endWaiters = new Map();
+    let settleWaiters = [];
+    const deliver = (point, input, workspaceId, onlyExtension) => handlers
+        .filter((handler) => handler.point === point && (onlyExtension === undefined || handler.extension === onlyExtension))
+        .map((handler) => rows.insert({ name: point, input, workspaceId, caller: { kind: 'kernel' }, retries: handler.retries, fromHandler: true, handlerExtension: handler.extension, runAt: clock.now() }));
+    const ended = (id) => {
+        const job = rows.get(id);
+        if (job === undefined || job.endedAt === undefined)
+            return;
+        for (const resolve of endWaiters.get(id) ?? [])
+            resolve(job);
+        endWaiters.delete(id);
+    };
+    const base = (job) => ({ jobId: job.id, rootId: job.id, name: job.name, caller: job.caller, workspaceId: job.workspaceId });
+    const record = (job, outcome) => {
+        const deliverFor = (point, extra) => {
+            if (!job.fromHandler)
+                deliver(point, { ...base(job), ...extra }, job.workspaceId);
+        };
+        connection.transaction(() => {
+            if ('output' in outcome) {
+                rows.succeed(job.id, outcome.output);
+                deliverFor('kernel.job.succeeded', {});
+            }
+            else if (outcome.problem.code === 'CANCELLED') {
+                rows.cancel(job.id);
+                deliverFor('kernel.job.cancelled', { reason: 'cancel' });
+            }
+            else if (isRetried(outcome.problem) && job.attempts <= job.retries && !(job.name === 'kernel.stopping' && job.handlerExtension !== undefined)) {
+                rows.requeue(job.id, outcome.problem, clock.now() + backoffMs(job.attempts));
+            }
+            else {
+                rows.fail(job.id, outcome.problem);
+                deliverFor('kernel.job.failed', { problem: outcome.problem, attempts: job.attempts });
+            }
+        })();
+        ended(job.id);
+    };
+    const dispatch = (active, job) => {
+        const run = async () => {
+            try {
+                const workspace = options.workspaceOf(job.workspaceId);
+                const root = { id: job.id, name: job.name, input: job.input, workspace, caller: job.caller, async: true, fromHandler: job.fromHandler };
+                return { output: await active.run(job.handlerExtension === undefined ? root : { ...root, handlerExtension: job.handlerExtension }) };
+            }
+            catch (error) {
+                if (error instanceof ProblemError)
+                    return { problem: error.problem };
+                throw error;
+            }
+        };
+        attempts.set(job.id, run().then((outcome) => {
+            record(job, outcome);
+            attempts.delete(job.id);
+            tick();
+        }));
+    };
+    const nextDue = () => {
+        const times = [rows.earliestRunAt(), mode === 'running' ? schedules.earliestNextRun() : undefined].filter((time) => time !== undefined);
+        return times.length === 0 ? undefined : Math.min(...times);
+    };
+    const checkSettled = () => {
+        const due = nextDue();
+        if (attempts.size > 0 || (due !== undefined && due <= clock.now() && mode !== 'stopped'))
+            return;
+        const waiters = settleWaiters;
+        settleWaiters = [];
+        for (const resolve of waiters)
+            resolve();
+    };
+    const arm = () => {
+        timer?.();
+        timer = undefined;
+        const due = nextDue();
+        if (due !== undefined && due > clock.now() && mode !== 'stopped')
+            timer = clock.setTimer(due - clock.now(), tick);
+    };
+    const tick = () => {
+        const active = pool;
+        if (active === undefined || mode === 'stopped')
+            return;
+        const scheduleDue = schedules.earliestNextRun();
+        if (mode === 'running' && scheduleDue !== undefined && scheduleDue <= clock.now()) {
+            connection.transaction(() => schedules.queueDue((job) => rows.insert(job)))();
+        }
+        const free = active.freeSlots();
+        const claimed = free > 0 ? rows.claimDue(free, mode === 'stopping' ? 'kernel.stopping' : undefined) : [];
+        for (const job of claimed)
+            dispatch(active, job);
+        const due = rows.earliestRunAt();
+        waitingForSlot = claimed.length === free && due !== undefined && due <= clock.now();
+        arm();
+        checkSettled();
+    };
+    return {
+        attach(active, summaries) {
+            pool = active;
+            handlers = summaries;
+        },
+        wake: tick,
+        slotFreed() {
+            if (waitingForSlot)
+                tick();
+        },
+        setMode(next) {
+            mode = next;
+            if (next === 'stopped') {
+                timer?.();
+                timer = undefined;
+            }
+            tick();
+        },
+        queue(job) {
+            const id = rows.insert(job);
+            tick();
+            return id;
+        },
+        // For a job a handler queues: it starts on the next turn of the event loop, after the reply with its id has gone to
+        // the worker, so a handler that reports the id (kvcoder's follow chunk) always does so before the new job runs.
+        queueAfterReply(job) {
+            const id = rows.insert(job);
+            setImmediate(tick);
+            return id;
+        },
+        deliver(point, input, workspaceId) {
+            const ids = connection.transaction(() => deliver(point, input, workspaceId))();
+            tick();
+            return ids;
+        },
+        deliverTo(point, extension, input, workspaceId) {
+            const ids = connection.transaction(() => deliver(point, input, workspaceId, extension))();
+            tick();
+            return ids;
+        },
+        // Runs `work` in one transaction with the handler jobs it delivers, then starts what is due.
+        deliverAlong(work) {
+            const result = connection.transaction(() => work((point, input, workspaceId) => void deliver(point, input, workspaceId)))();
+            tick();
+            return result;
+        },
+        deliverSyncEnd(end) {
+            connection.transaction(() => deliver(end.point, end.input, end.workspaceId))();
+            tick();
+        },
+        // Attempts left running by a stop or a crash end INTERRUPTED, and are retried like any failure (plan 02 §2.3).
+        interruptLeftovers() {
+            for (const job of rows.running())
+                record(job, { problem: kernelProblem('INTERRUPTED', 'kvman stopped during the attempt.').problem });
+        },
+        // A handler that never started before the end of shutdown is dropped (ADR 0009, 18).
+        dropQueued(point) {
+            for (const job of rows.queuedHandlers(point))
+                record({ ...job, retries: 0 }, { problem: kernelProblem('INTERRUPTED', 'kvman stopped before the handler ran.').problem });
+        },
+        cancel(jobId) {
+            const job = rows.claimed(jobId);
+            if (job === undefined) {
+                if (pool?.abort(jobId, 'cancel') !== true)
+                    throw kernelProblem('NOT_FOUND', `There is no running job ${jobId}.`, { jobId });
+                return;
+            }
+            const status = rows.get(jobId)?.status;
+            if (status === 'queued')
+                record(job, { problem: kernelProblem('CANCELLED', 'The job was cancelled.').problem });
+            else if (status === 'running')
+                pool?.abort(jobId, 'cancel');
+        },
+        waitForJob(id) {
+            const job = rows.get(id);
+            if (job === undefined)
+                return Promise.reject(kernelProblem('NOT_FOUND', `There is no job ${id}.`, { jobId: id }));
+            if (job.endedAt !== undefined)
+                return Promise.resolve(job);
+            return new Promise((resolve) => endWaiters.set(id, [...(endWaiters.get(id) ?? []), resolve]));
+        },
+        settled() {
+            const done = new Promise((resolve) => settleWaiters.push(resolve));
+            checkSettled();
+            return done;
+        },
+        running() {
+            return attempts.size;
+        },
+        drained: async () => {
+            await Promise.all(attempts.values());
+        },
+    };
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/jobs/dispatcher.js.map

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

package/dist/jobs/handlers.d.ts

@@ -0,0 +1,19 @@
+import { type HandlerPoint, type HandlerRegistration } from '@kvman/sdk';
+import type { Owner, Registry, StartedJob } from './registry.ts';
+export declare const handlerPoints: string[];
+export type HandlerEntry = {
+    point: string;
+    owner: string;
+    description: string;
+    retries: number;
+    timeoutMs: number;
+    start: (input: unknown) => StartedJob;
+};
+export type HandlerSummary = {
+    point: string;
+    extension: string;
+    retries: number;
+};
+export declare function registerHandler<Point extends HandlerPoint>(registry: Registry, owner: Owner, point: Point, registration: HandlerRegistration<Point>): void;
+export declare function handlerSummaries(registry: Registry): HandlerSummary[];
+//# sourceMappingURL=handlers.d.ts.map

package/dist/jobs/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,YAAY,EAAsB,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7H,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAiBjE,eAAO,MAAM,aAAa,UAAiC,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAiBnF,wBAAgB,eAAe,CAAC,KAAK,SAAS,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,IAAI,CAkB1J;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,EAAE,CAErE"}

package/dist/jobs/handlers.js

@@ -0,0 +1,54 @@
+import { callerSchema, problemSchema, z } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+// Handlers for the kernel's points (plan 02 §2.15): one per extension and point, run as async jobs.
+const jobPointSchema = z.object({ jobId: z.string(), rootId: z.string(), name: z.string(), caller: callerSchema, workspaceId: z.string() });
+const emptySchema = z.object({}).strict();
+const pointInputSchemas = {
+    'kernel.job.failed': jobPointSchema.extend({ problem: problemSchema, attempts: z.number().int() }),
+    'kernel.job.succeeded': jobPointSchema,
+    'kernel.job.cancelled': jobPointSchema.extend({ reason: z.string() }),
+    'kernel.process.exited': z.object({ extension: z.string(), workspaceId: z.string(), name: z.string(), exitCode: z.number().nullable(), signal: z.string().nullable() }),
+    'kernel.workspace.opened': z.object({ workspaceId: z.string() }),
+    'kernel.started': emptySchema,
+    'kernel.stopping': emptySchema,
+};
+export const handlerPoints = Object.keys(pointInputSchemas);
+function isPoint(point) {
+    return Object.hasOwn(pointInputSchemas, point);
+}
+const registrationSchema = z.object({
+    description: z.string().trim().min(1),
+    handle: z.custom((value) => typeof value === 'function', 'handle must be a function'),
+    retries: z.number().int().nonnegative().optional(),
+    timeoutMs: z.number().int().positive().optional(),
+});
+function invalid(owner, message) {
+    return kernelProblem('EXTENSION_INVALID', `${owner.name}: ${message}`, { extension: owner.name });
+}
+export function registerHandler(registry, owner, point, registration) {
+    if (registry.sealed)
+        throw invalid(owner, `a handler for "${point}" was registered after the entry returned; registrations are sealed.`);
+    if (!isPoint(point))
+        throw invalid(owner, `"${String(point)}" is not a kernel handler point.`);
+    if (registry.handlers.some((entry) => entry.point === point && entry.owner === owner.name))
+        throw invalid(owner, `it registers two handlers for "${point}".`);
+    const parsed = registrationSchema.safeParse(registration);
+    if (!parsed.success)
+        throw invalid(owner, `the handler for "${point}" is invalid (${z.prettifyError(parsed.error)}).`);
+    const schema = pointInputSchemas[point];
+    registry.handlers.push({
+        point,
+        owner: owner.name,
+        description: parsed.data.description,
+        retries: registration.retries ?? 3,
+        timeoutMs: registration.timeoutMs ?? 600_000,
+        start: (input) => {
+            const checked = schema.safeParse(input);
+            return checked.success ? { run: () => registration.handle(checked.data) } : { error: checked.error };
+        },
+    });
+}
+export function handlerSummaries(registry) {
+    return registry.handlers.map((entry) => ({ point: entry.point, extension: entry.owner, retries: entry.retries }));
+}
+//# sourceMappingURL=handlers.js.map

package/dist/jobs/handlers.js.map

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

package/dist/jobs/job-rows.d.ts

@@ -0,0 +1,63 @@
+import { type Caller, type Job, type JobStatus, type Problem } from '@kvman/sdk';
+import type { Clock } from '../clock.ts';
+import type { IdGenerator } from '../ids.ts';
+import type { Connection } from '../storage/database.ts';
+import { type ClosedWorkspaces } from '../workspaces/workspaces.ts';
+export type NewJob = {
+    name: string;
+    input: unknown;
+    workspaceId: string;
+    caller: Caller;
+    retries: number;
+    fromHandler: boolean;
+    handlerExtension?: string;
+    runAt: number;
+};
+export type ClaimedJob = {
+    id: string;
+    name: string;
+    input: unknown;
+    workspaceId: string;
+    caller: Caller;
+    attempts: number;
+    retries: number;
+    fromHandler: boolean;
+    handlerExtension: string | undefined;
+};
+type Row = {
+    id: string;
+    name: string;
+    input: string;
+    workspace_id: string;
+    caller: string;
+    status: string;
+    attempts: number;
+    retries: number;
+    output: string | null;
+    problem: string | null;
+    created_at: string;
+    started_at: string | null;
+    ended_at: string | null;
+    from_handler: number;
+    handler_extension: string | null;
+};
+export declare function jobOfRow(row: Row): Job;
+export declare function readJob(connection: Connection, id: string): Job;
+export declare function listJobs(connection: Connection, workspaceId: string, status: JobStatus | undefined, limit: number): Job[];
+export type JobRows = ReturnType<typeof createJobRows>;
+export declare function createJobRows(connection: Connection, clock: Clock, ids: IdGenerator, closedWorkspaces: ClosedWorkspaces): {
+    insert(job: NewJob): string;
+    claimDue(limit: number, onlyPoint: string | undefined): ClaimedJob[];
+    succeed: (id: string, output: unknown) => void;
+    fail: (id: string, problem: Problem) => void;
+    cancel: (id: string) => void;
+    requeue(id: string, problem: Problem, runAt: number): void;
+    get: (id: string) => Job | undefined;
+    claimed: (id: string) => ClaimedJob | undefined;
+    queuedHandlers: (point: string) => ClaimedJob[];
+    running: () => ClaimedJob[];
+    earliestRunAt(): number | undefined;
+    deleteFinishedBefore(time: number): number;
+};
+export {};
+//# sourceMappingURL=job-rows.d.ts.map

package/dist/jobs/job-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-rows.d.ts","sourceRoot":"","sources":["../../src/jobs/job-rows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAInF,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,KAAK,GAAG,GAAG;IACT,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAQF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAgBtC;AAGD,wBAAgB,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,GAAG,CAI/D;AAGD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,CAMzH;AAiBD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AAEvD,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB;gBAQxG,MAAM,GAAG,MAAM;oBAWX,MAAM,aAAa,MAAM,GAAG,SAAS,GAAG,UAAU,EAAE;kBAetD,MAAM,UAAU,OAAO;eAC1B,MAAM,WAAW,OAAO;iBACtB,MAAM;gBACP,MAAM,WAAW,OAAO,SAAS,MAAM,GAAG,IAAI;cAGhD,MAAM,KAAG,GAAG,GAAG,SAAS;kBAIpB,MAAM,KAAG,UAAU,GAAG,SAAS;4BAIrB,MAAM,KAAG,UAAU,EAAE;mBAEhC,UAAU,EAAE;qBACR,MAAM,GAAG,SAAS;+BAKR,MAAM,GAAG,MAAM;EAI7C"}

package/dist/jobs/job-rows.js

@@ -0,0 +1,111 @@
+import { jobSchema } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+import { outsideClosed } from "../workspaces/workspaces.js";
+const iso = (time) => new Date(time).toISOString();
+function parsed(text) {
+    return JSON.parse(text);
+}
+export function jobOfRow(row) {
+    return jobSchema.parse({
+        id: row.id,
+        name: row.name,
+        input: parsed(row.input),
+        workspaceId: row.workspace_id,
+        caller: parsed(row.caller),
+        status: row.status,
+        attempts: row.attempts,
+        retries: row.retries,
+        ...(row.output === null ? {} : { output: parsed(row.output) }),
+        ...(row.problem === null ? {} : { problem: parsed(row.problem) }),
+        createdAt: row.created_at,
+        ...(row.started_at === null ? {} : { startedAt: row.started_at }),
+        ...(row.ended_at === null ? {} : { endedAt: row.ended_at }),
+    });
+}
+// A job of any workspace, by id (ADR 0009, 24); an unknown id fails NOT_FOUND.
+export function readJob(connection, id) {
+    const row = connection.prepare('SELECT * FROM jobs WHERE id = ?').get(id);
+    if (row === undefined)
+        throw kernelProblem('NOT_FOUND', `There is no job ${id}.`, { jobId: id });
+    return jobOfRow(row);
+}
+// A workspace's jobs, newest first, optionally of one status.
+export function listJobs(connection, workspaceId, status, limit) {
+    const rows = status === undefined
+        ? connection.prepare('SELECT * FROM jobs WHERE workspace_id = ? ORDER BY id DESC LIMIT ?').all(workspaceId, limit)
+        : connection.prepare('SELECT * FROM jobs WHERE workspace_id = ? AND status = ? ORDER BY id DESC LIMIT ?').all(workspaceId, status, limit);
+    return rows.map(jobOfRow);
+}
+function claimedOfRow(row) {
+    const job = jobOfRow(row);
+    return {
+        id: job.id,
+        name: job.name,
+        input: job.input,
+        workspaceId: job.workspaceId,
+        caller: job.caller,
+        attempts: job.attempts,
+        retries: job.retries,
+        fromHandler: row.from_handler === 1,
+        handlerExtension: row.handler_extension ?? undefined,
+    };
+}
+export function createJobRows(connection, clock, ids, closedWorkspaces) {
+    const byId = (id) => connection.prepare('SELECT * FROM jobs WHERE id = ?').get(id);
+    const end = (id, status, output, problem) => {
+        connection
+            .prepare("UPDATE jobs SET status = ?, output = ?, problem = ?, ended_at = ? WHERE id = ? AND status IN ('queued', 'running')")
+            .run(status, output === undefined ? null : JSON.stringify(output), problem === undefined ? null : JSON.stringify(problem), iso(clock.now()), id);
+    };
+    return {
+        insert(job) {
+            const id = ids();
+            connection
+                .prepare(`INSERT INTO jobs (id, name, input, workspace_id, caller, status, attempts, retries, created_at, run_at, from_handler, handler_extension)
+           VALUES (?, ?, ?, ?, ?, 'queued', 0, ?, ?, ?, ?, ?)`)
+                .run(id, job.name, JSON.stringify(job.input), job.workspaceId, JSON.stringify(job.caller), job.retries, iso(clock.now()), iso(job.runAt), job.fromHandler ? 1 : 0, job.handlerExtension ?? null);
+            return id;
+        },
+        // Due queued jobs of open workspaces, first-in, first-out; while kvman stops, only the handlers of one point start.
+        claimDue(limit, onlyPoint) {
+            const now = iso(clock.now());
+            const closed = closedWorkspaces();
+            const rows = onlyPoint === undefined
+                ? connection.prepare(`SELECT * FROM jobs WHERE status = 'queued' AND run_at <= ?${outsideClosed('AND', closed)} ORDER BY id LIMIT ?`).all(now, ...closed, limit)
+                : connection
+                    .prepare(`SELECT * FROM jobs WHERE status = 'queued' AND run_at <= ? AND name = ? AND handler_extension IS NOT NULL${outsideClosed('AND', closed)} ORDER BY id LIMIT ?`)
+                    .all(now, onlyPoint, ...closed, limit);
+            const start = connection.prepare("UPDATE jobs SET status = 'running', attempts = attempts + 1, started_at = ? WHERE id = ?");
+            connection.transaction(() => {
+                for (const row of rows)
+                    start.run(now, row.id);
+            })();
+            return rows.map((row) => claimedOfRow({ ...row, attempts: row.attempts + 1 }));
+        },
+        succeed: (id, output) => end(id, 'succeeded', output, undefined),
+        fail: (id, problem) => end(id, 'failed', undefined, problem),
+        cancel: (id) => end(id, 'cancelled', undefined, undefined),
+        requeue(id, problem, runAt) {
+            connection.prepare("UPDATE jobs SET status = 'queued', problem = ?, run_at = ? WHERE id = ?").run(JSON.stringify(problem), iso(runAt), id);
+        },
+        get: (id) => {
+            const row = byId(id);
+            return row === undefined ? undefined : jobOfRow(row);
+        },
+        claimed: (id) => {
+            const row = byId(id);
+            return row === undefined ? undefined : claimedOfRow(row);
+        },
+        queuedHandlers: (point) => connection.prepare("SELECT * FROM jobs WHERE status = 'queued' AND name = ? AND handler_extension IS NOT NULL ORDER BY id").all(point).map(claimedOfRow),
+        running: () => connection.prepare("SELECT * FROM jobs WHERE status = 'running' ORDER BY id").all().map(claimedOfRow),
+        earliestRunAt() {
+            const closed = closedWorkspaces();
+            const row = connection.prepare(`SELECT min(run_at) AS run_at FROM jobs WHERE status = 'queued'${outsideClosed('AND', closed)}`).get(...closed);
+            return row?.run_at === null || row === undefined ? undefined : Date.parse(row.run_at);
+        },
+        deleteFinishedBefore(time) {
+            return connection.prepare("DELETE FROM jobs WHERE status IN ('succeeded', 'failed', 'cancelled') AND ended_at < ?").run(iso(time)).changes;
+        },
+    };
+}
+//# sourceMappingURL=job-rows.js.map

package/dist/jobs/job-rows.js.map

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

package/dist/jobs/progress-hub.d.ts

@@ -0,0 +1,12 @@
+import type { Json } from '@kvman/sdk';
+export type ProgressChunk = {
+    source: string;
+    data: Json;
+};
+export type ProgressHub = {
+    publish(rootId: string, chunk: ProgressChunk): void;
+    watch(jobId: string, listener: (chunk: ProgressChunk) => void): () => void;
+};
+/** `ended` settles when a root job has ended (or has no row, as a sync job's), which drops its buffer. */
+export declare function createProgressHub(ended: (rootId: string) => Promise<unknown>, replayBytes?: number): ProgressHub;
+//# sourceMappingURL=progress-hub.d.ts.map

package/dist/jobs/progress-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-hub.d.ts","sourceRoot":"","sources":["../../src/jobs/progress-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5E,CAAC;AAIF,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,SAAsB,GAAG,WAAW,CAgC7H"}

package/dist/jobs/progress-hub.js

@@ -0,0 +1,40 @@
+import { progressReplayBytes } from "../limits.js";
+/** `ended` settles when a root job has ended (or has no row, as a sync job's), which drops its buffer. */
+export function createProgressHub(ended, replayBytes = progressReplayBytes) {
+    const listeners = new Map();
+    const buffers = new Map();
+    const buffer = (rootId, chunk) => {
+        let held = buffers.get(rootId);
+        if (held === undefined) {
+            held = { chunks: [], bytes: 0 };
+            buffers.set(rootId, held);
+            const drop = () => void buffers.delete(rootId);
+            ended(rootId).then(drop, drop);
+        }
+        const bytes = Buffer.byteLength(JSON.stringify(chunk));
+        held.chunks.push({ chunk, bytes });
+        held.bytes += bytes;
+        while (held.bytes > replayBytes && held.chunks.length > 1)
+            held.bytes -= held.chunks.shift()?.bytes ?? 0;
+    };
+    return {
+        publish: (rootId, chunk) => {
+            buffer(rootId, chunk);
+            for (const listener of listeners.get(rootId) ?? [])
+                listener(chunk);
+        },
+        watch: (jobId, listener) => {
+            for (const { chunk } of buffers.get(jobId)?.chunks ?? [])
+                listener(chunk);
+            const set = listeners.get(jobId) ?? new Set();
+            set.add(listener);
+            listeners.set(jobId, set);
+            return () => {
+                set.delete(listener);
+                if (set.size === 0)
+                    listeners.delete(jobId);
+            };
+        },
+    };
+}
+//# sourceMappingURL=progress-hub.js.map

package/dist/jobs/progress-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-hub.js","sourceRoot":"","sources":["../../src/jobs/progress-hub.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcnD,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAC,KAA2C,EAAE,WAAW,GAAG,mBAAmB;IAC9G,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+C,CAAC;IACzE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,KAAoB,EAAQ,EAAE;QAC5D,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrD,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC,KAAK,GAAG,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC;IAC3G,CAAC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YACzB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACtB,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;gBAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACzB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,EAAE;gBAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC1E,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;YAC9C,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAClB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,GAAG,EAAE;gBACV,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACrB,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;oBAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/jobs/registry.d.ts

@@ -0,0 +1,38 @@
+import { z, type CommandRegistration, type QueryRegistration, type SettingRegistration } from '@kvman/sdk';
+import type { SettingDefinition } from '../settings/settings.ts';
+import type { JobKind } from './current-job.ts';
+import type { HandlerEntry } from './handlers.ts';
+export type Registration = {
+    kind: JobKind;
+    name: string;
+    owner: string;
+    description: string;
+    input: z.ZodType;
+    output: z.ZodType;
+    start: (input: unknown) => StartedJob;
+    public: boolean;
+    timeoutMs: number;
+    retries: number;
+    maxInputBytes: number;
+    maxOutputBytes: number;
+    syncOnly: boolean;
+};
+export type Owner = {
+    name: string;
+    namespace: string;
+};
+export type StartedJob = {
+    error: z.ZodError;
+} | {
+    run: () => unknown;
+};
+export type Registry = {
+    jobs: Map<string, Registration>;
+    settings: Map<string, SettingDefinition>;
+    handlers: HandlerEntry[];
+    sealed: boolean;
+};
+export declare function createRegistry(): Registry;
+export declare function registerJob<Input extends z.ZodType, Output extends z.ZodType>(registry: Registry, owner: Owner, kind: JobKind, name: string, options: CommandRegistration<Input, Output> | QueryRegistration<Input, Output>): void;
+export declare function registerSetting(registry: Registry, owner: Owner, key: string, options: SettingRegistration<z.ZodType>): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/jobs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/jobs/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAalD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAClB,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAGxD,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AAyBxE,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAeD,wBAAgB,WAAW,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC,CAAC,OAAO,EAC3E,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC7E,IAAI,CAwBN;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,CAe5H"}