@kvman/kernel 0.1.0

package/dist/http/http-server.js

@@ -0,0 +1,38 @@
+import { Server } from 'node:http';
+import { createAdaptorServer } from '@hono/node-server';
+import { kernelProblem } from "../problems.js";
+import { createHttpApp } from "./http-app.js";
+function checkWebHome(kernel) {
+    const home = kernel.web.webHome();
+    if (!kernel.web.webFolders().has(home)) {
+        throw kernelProblem('EXTENSION_INVALID', `The web home "${home}" (kernel.web.home) is no extension of this run that declares kvman.web.`, { namespace: home });
+    }
+}
+function listen(server, port) {
+    return new Promise((resolve, reject) => {
+        server.once('error', (error) => reject(error.code === 'EADDRINUSE' ? kernelProblem('PORT_IN_USE', `The port ${port} is already in use.`, { port }) : error));
+        server.listen(port, '127.0.0.1', () => {
+            const address = server.address();
+            resolve(typeof address === 'object' && address !== null ? address.port : port);
+        });
+    });
+}
+export async function startHttp(kernel, options) {
+    checkWebHome(kernel);
+    const stopping = new AbortController();
+    let port = options.port;
+    const app = createHttpApp({ kernel, port: () => port, stopping: stopping.signal, logger: kernel.web.logger });
+    const server = createAdaptorServer({ fetch: app.fetch });
+    if (!(server instanceof Server))
+        throw new Error('the HTTP server must be node:http');
+    port = await listen(server, options.port);
+    return {
+        port,
+        close: () => new Promise((resolve) => {
+            stopping.abort();
+            server.close(() => resolve());
+            server.closeIdleConnections();
+        }),
+    };
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../../src/http/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQ9C,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,aAAa,CAAC,mBAAmB,EAAE,iBAAiB,IAAI,0EAA0E,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjK,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,EAAE,IAAY;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAgC,EAAE,EAAE,CACxD,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,YAAY,IAAI,qBAAqB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAC5H,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;YACpC,MAAM,OAAO,GAAgC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9D,OAAO,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,OAAyB;IACvE,YAAY,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACxB,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9G,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtF,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9B,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAChC,CAAC,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/http/job-events.d.ts

@@ -0,0 +1,18 @@
+import type { Job, Problem } from '@kvman/sdk';
+import type { ProgressChunk } from '../jobs/progress-hub.ts';
+export type JobEventSource = {
+    watchProgress(jobId: string, listener: (chunk: ProgressChunk) => void): () => void;
+    waitForJob(jobId: string): Promise<Job>;
+};
+export type JobEvent = {
+    event: 'progress';
+    data: ProgressChunk;
+} | {
+    event: 'result';
+    data: unknown;
+} | {
+    event: 'problem';
+    data: Problem;
+};
+export declare function jobEvents(source: JobEventSource, jobId: string, stop: AbortSignal): AsyncGenerator<JobEvent>;
+//# sourceMappingURL=job-events.d.ts.map

package/dist/http/job-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-events.d.ts","sourceRoot":"","sources":["../../src/http/job-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAO7D,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnF,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAQ7I,wBAAuB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAqCnH"}

package/dist/http/job-events.js

@@ -0,0 +1,48 @@
+import { kernelProblem } from "../problems.js";
+function endOf(job) {
+    if (job.status === 'succeeded')
+        return { event: 'result', data: job.output ?? null };
+    if (job.status === 'cancelled')
+        return { event: 'problem', data: job.problem ?? kernelProblem('CANCELLED', 'The job was cancelled.').problem };
+    return { event: 'problem', data: job.problem ?? kernelProblem('INTERRUPTED', 'The job ended without a Problem.').problem };
+}
+export async function* jobEvents(source, jobId, stop) {
+    const chunks = [];
+    let ended;
+    let wake = () => undefined;
+    const unwatch = source.watchProgress(jobId, (chunk) => {
+        chunks.push(chunk);
+        wake();
+    });
+    source.waitForJob(jobId).then((job) => {
+        ended = { job };
+        wake();
+    }, (error) => {
+        ended = { error };
+        wake();
+    });
+    const onStop = () => wake();
+    stop.addEventListener('abort', onStop);
+    try {
+        for (;;) {
+            for (let chunk = chunks.shift(); chunk !== undefined; chunk = chunks.shift())
+                yield { event: 'progress', data: chunk };
+            if (ended !== undefined) {
+                if ('error' in ended)
+                    throw ended.error;
+                yield endOf(ended.job);
+                return;
+            }
+            if (stop.aborted)
+                return;
+            await new Promise((resolve) => {
+                wake = resolve;
+            });
+        }
+    }
+    finally {
+        stop.removeEventListener('abort', onStop);
+        unwatch();
+    }
+}
+//# sourceMappingURL=job-events.js.map

package/dist/http/job-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-events.js","sourceRoot":"","sources":["../../src/http/job-events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAa/C,SAAS,KAAK,CAAC,GAAQ;IACrB,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;IACrF,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/I,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,aAAa,CAAC,aAAa,EAAE,kCAAkC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC7H,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,MAAsB,EAAE,KAAa,EAAE,IAAiB;IACvF,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,IAAI,KAAoD,CAAC;IACzD,IAAI,IAAI,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QACpD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAC3B,CAAC,GAAG,EAAE,EAAE;QACN,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,EAAE,CAAC;IACT,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;QACjB,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC;QAClB,IAAI,EAAE,CAAC;IACT,CAAC,CACF,CAAC;IACF,MAAM,MAAM,GAAG,GAAS,EAAE,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,SAAS,CAAC;YACR,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,KAAK,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE;gBAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACvH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,OAAO,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC,KAAK,CAAC;gBACxC,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO;YACzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,GAAG,OAAO,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/http/job-routes.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from 'hono';
+import type { Kernel } from '../kernel.ts';
+export declare function registerJobRoutes(app: Hono, kernel: Kernel, stopping: AbortSignal): void;
+//# sourceMappingURL=job-routes.d.ts.map

package/dist/http/job-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-routes.d.ts","sourceRoot":"","sources":["../../src/http/job-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAK3C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAaxF"}

package/dist/http/job-routes.js

@@ -0,0 +1,20 @@
+import { streamSSE } from 'hono/streaming';
+import { answer } from "./envelope.js";
+import { jobEvents } from "./job-events.js";
+// Jobs over HTTP (plan 04 §4.1, §4.4): a job's row, cancelling it, and the stream of an async or scheduled job.
+export function registerJobRoutes(app, kernel, stopping) {
+    app.get('/api/jobs/:id', (c) => answer({ job: kernel.web.job(c.req.param('id')) }));
+    app.post('/api/jobs/:id/cancel', (c) => {
+        kernel.cancel(c.req.param('id'));
+        return answer({});
+    });
+    app.get('/api/jobs/:id/stream', (c) => {
+        const id = kernel.web.job(c.req.param('id')).id;
+        const stop = AbortSignal.any([c.req.raw.signal, stopping]);
+        return streamSSE(c, async (stream) => {
+            for await (const event of jobEvents(kernel, id, stop))
+                await stream.writeSSE({ event: event.event, data: JSON.stringify(event.data) });
+        });
+    });
+}
+//# sourceMappingURL=job-routes.js.map

package/dist/http/job-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-routes.js","sourceRoot":"","sources":["../../src/http/job-routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,gHAAgH;AAChH,MAAM,UAAU,iBAAiB,CAAC,GAAS,EAAE,MAAc,EAAE,QAAqB;IAChF,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3D,OAAO,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACnC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC;gBAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzI,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/http/own-origin.d.ts

@@ -0,0 +1,2 @@
+export declare function isOwnOrigin(host: string | undefined, origin: string | undefined, port: number): boolean;
+//# sourceMappingURL=own-origin.d.ts.map

package/dist/http/own-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-origin.d.ts","sourceRoot":"","sources":["../../src/http/own-origin.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvG"}

package/dist/http/own-origin.js

@@ -0,0 +1,9 @@
+// kvman answers only its own pages and local programs (plan 04 §4.2, ADR 0009, 36): the Host is 127.0.0.1 or localhost
+// on kvman's port, and an Origin, when a browser sends one, is exactly that same Host over http. This keeps websites
+// out, including through DNS rebinding.
+export function isOwnOrigin(host, origin, port) {
+    if (host !== `127.0.0.1:${port}` && host !== `localhost:${port}`)
+        return false;
+    return origin === undefined || origin === `http://${host}`;
+}
+//# sourceMappingURL=own-origin.js.map

package/dist/http/own-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-origin.js","sourceRoot":"","sources":["../../src/http/own-origin.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,qHAAqH;AACrH,wCAAwC;AACxC,MAAM,UAAU,WAAW,CAAC,IAAwB,EAAE,MAA0B,EAAE,IAAY;IAC5F,IAAI,IAAI,KAAK,aAAa,IAAI,EAAE,IAAI,IAAI,KAAK,aAAa,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAC/E,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,UAAU,IAAI,EAAE,CAAC;AAC7D,CAAC"}

package/dist/http/request-body.d.ts

@@ -0,0 +1,19 @@
+import { type Problem } from '@kvman/sdk';
+export declare function readCapped(request: Request, limit: number): Promise<Buffer>;
+export declare function writeCapped(request: Request, limit: number, file: string): Promise<void>;
+export type CallBody = {
+    input: unknown;
+    workspaceId: string | undefined;
+    async: boolean;
+};
+export type ParsedBody = {
+    kind: 'call';
+    call: CallBody;
+} | {
+    kind: 'not-json';
+} | {
+    kind: 'invalid';
+    problem: Problem;
+};
+export declare function parseCallBody(bytes: Uint8Array, kind: 'command' | 'query'): ParsedBody;
+//# sourceMappingURL=request-body.d.ts.map

package/dist/http/request-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-body.d.ts","sourceRoot":"","sources":["../../src/http/request-body.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AA+BzD,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjF;AAGD,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9F;AAKD,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3F,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAWzH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAStF"}

package/dist/http/request-body.js

@@ -0,0 +1,72 @@
+import { open, rm } from 'node:fs/promises';
+import { jsonSchema, z } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+import { validationFailed } from "../store/json-values.js";
+// Request bodies (plan 04 §4.1, ADR 0009, 39 and 40): read no further than the limit, and parsed strictly.
+function tooLarge(limit) {
+    return kernelProblem('TOO_LARGE', `The request body is over ${limit} bytes.`, { limit });
+}
+function declaredOver(request, limit) {
+    const declared = Number(request.headers.get('content-length') ?? '0');
+    return Number.isFinite(declared) && declared > limit;
+}
+// Each chunk of the body, failing TOO_LARGE as soon as the total passes the limit (the rest is never read).
+async function* cappedChunks(request, limit) {
+    if (declaredOver(request, limit))
+        throw tooLarge(limit);
+    const reader = request.body?.getReader();
+    if (reader === undefined)
+        return;
+    let total = 0;
+    for (let read = await reader.read(); !read.done; read = await reader.read()) {
+        total += read.value.byteLength;
+        if (total > limit) {
+            await reader.cancel();
+            throw tooLarge(limit);
+        }
+        yield read.value;
+    }
+}
+export async function readCapped(request, limit) {
+    const chunks = [];
+    for await (const chunk of cappedChunks(request, limit))
+        chunks.push(chunk);
+    return Buffer.concat(chunks);
+}
+// Streams the body into a new file; a body over the limit, or any failure, leaves no file behind.
+export async function writeCapped(request, limit, file) {
+    const handle = await open(file, 'wx');
+    try {
+        for await (const chunk of cappedChunks(request, limit))
+            await handle.write(chunk);
+        await handle.close();
+    }
+    catch (error) {
+        await handle.close();
+        await rm(file, { force: true });
+        throw error;
+    }
+}
+const commandBodySchema = z.strictObject({ input: jsonSchema, workspaceId: z.string().min(1).optional(), async: z.boolean().optional() });
+const queryBodySchema = commandBodySchema.omit({ async: true });
+function parsedJson(bytes) {
+    try {
+        return { json: JSON.parse(new TextDecoder().decode(bytes)) };
+    }
+    catch {
+        return undefined;
+    }
+}
+// A command's body is `{ input, workspaceId?, async? }`, a query's has no `async`; unknown keys fail.
+export function parseCallBody(bytes, kind) {
+    const parsed = parsedJson(bytes);
+    if (parsed === undefined)
+        return { kind: 'not-json' };
+    const body = (kind === 'command' ? commandBodySchema : queryBodySchema).safeParse(parsed.json);
+    if (!body.success) {
+        const error = validationFailed('The request body', body.error);
+        return { kind: 'invalid', problem: error.problem };
+    }
+    return { kind: 'call', call: { input: body.data.input, workspaceId: body.data.workspaceId, async: 'async' in body.data && body.data.async === true } };
+}
+//# sourceMappingURL=request-body.js.map

package/dist/http/request-body.js.map

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

package/dist/http/static-files.d.ts

@@ -0,0 +1,3 @@
+export declare function fileWithin(folder: string, requestPath: string): string | undefined;
+export declare function staticResponse(file: string): Response;
+//# sourceMappingURL=static-files.d.ts.map

package/dist/http/static-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-files.d.ts","sourceRoot":"","sources":["../../src/http/static-files.ts"],"names":[],"mappings":"AAqBA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQlF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAIrD"}

package/dist/http/static-files.js

@@ -0,0 +1,35 @@
+import { createReadStream, existsSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { Readable } from 'node:stream';
+import { getMimeType } from 'hono/utils/mime';
+// Files of an extension's `kvman.web` folder (plan 04 §4.1): a path that leaves the folder, through `..` or a symbolic
+// link, or a missing file, is no file.
+function within(folder, file) {
+    return file.startsWith(folder + path.sep);
+}
+function decodedPath(requestPath) {
+    try {
+        return decodeURIComponent(requestPath);
+    }
+    catch {
+        return undefined;
+    }
+}
+// The absolute path of the file a request path names in the folder, or undefined when there is no such file there.
+export function fileWithin(folder, requestPath) {
+    const decoded = decodedPath(requestPath);
+    if (decoded === undefined || decoded.includes('\0') || !existsSync(folder))
+        return undefined;
+    const root = realpathSync(folder);
+    const candidate = path.join(root, decoded);
+    if (!within(root, candidate) || !existsSync(candidate))
+        return undefined;
+    const real = realpathSync(candidate);
+    return within(root, real) && statSync(real).isFile() ? real : undefined;
+}
+export function staticResponse(file) {
+    const body = Readable.toWeb(createReadStream(file));
+    const headers = { 'Content-Type': getMimeType(file) ?? 'application/octet-stream', 'Content-Length': String(statSync(file).size) };
+    return new Response(body, { headers });
+}
+//# sourceMappingURL=static-files.js.map

package/dist/http/static-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-files.js","sourceRoot":"","sources":["../../src/http/static-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,uHAAuH;AACvH,uCAAuC;AAEvC,SAAS,MAAM,CAAC,MAAc,EAAE,IAAY;IAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,WAAW,CAAC,WAAmB;IACtC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,WAAmB;IAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7F,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACzE,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,EAAE,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IACnI,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/http/web-routes.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from 'hono';
+import type { Kernel } from '../kernel.ts';
+export declare function registerWebRoutes(app: Hono, kernel: Kernel): void;
+//# sourceMappingURL=web-routes.d.ts.map

package/dist/http/web-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-routes.d.ts","sourceRoot":"","sources":["../../src/http/web-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAW3C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAajE"}

package/dist/http/web-routes.js

@@ -0,0 +1,23 @@
+import { kernelProblem } from "../problems.js";
+import { failure } from "./envelope.js";
+import { fileWithin, staticResponse } from "./static-files.js";
+// Static files (plan 04 §4.1, ADR 0009, 41): `/web/<namespace>/<path>` from that extension's `kvman.web` folder, and
+// every other path outside /api from the `kernel.web.home` extension's folder, falling back to its `index.html`. A miss
+// is a plain 404; an unknown /api route is the envelope.
+const notFound = () => new Response('Not Found', { status: 404 });
+export function registerWebRoutes(app, kernel) {
+    app.all('/api/*', (c) => failure(kernelProblem('NOT_FOUND', `There is no route ${c.req.method} ${c.req.path}.`).problem));
+    app.get('/web/:namespace/*', (c) => {
+        const folder = kernel.web.webFolders().get(c.req.param('namespace'));
+        const file = folder === undefined ? undefined : fileWithin(folder, c.req.path.slice(`/web/${c.req.param('namespace')}/`.length));
+        return file === undefined ? notFound() : staticResponse(file);
+    });
+    app.get('*', (c) => {
+        const folder = kernel.web.webFolders().get(kernel.web.webHome());
+        if (folder === undefined)
+            return notFound();
+        const file = fileWithin(folder, c.req.path) ?? fileWithin(folder, 'index.html');
+        return file === undefined ? notFound() : staticResponse(file);
+    });
+}
+//# sourceMappingURL=web-routes.js.map

package/dist/http/web-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-routes.js","sourceRoot":"","sources":["../../src/http/web-routes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE/D,qHAAqH;AACrH,wHAAwH;AACxH,yDAAyD;AAEzD,MAAM,QAAQ,GAAG,GAAa,EAAE,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAE5E,MAAM,UAAU,iBAAiB,CAAC,GAAS,EAAE,MAAc;IACzD,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1H,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACjI,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAChF,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ids.d.ts

@@ -0,0 +1,6 @@
+import type { Clock } from './clock.ts';
+export type RandomSource = (bytes: Uint8Array) => void;
+export declare const cryptoRandom: RandomSource;
+export type IdGenerator = () => string;
+export declare function createIdGenerator(clock: Clock, random?: RandomSource): IdGenerator;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKxC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,YAE1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC;AAavC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,GAAE,YAA2B,GAAG,WAAW,CAyBhG"}

package/dist/ids.js

@@ -0,0 +1,42 @@
+import { randomFillSync } from 'node:crypto';
+export const cryptoRandom = (bytes) => {
+    randomFillSync(bytes);
+};
+const counterMaximum = 0xfff;
+function hex(bytes) {
+    return Buffer.from(bytes).toString('hex');
+}
+function format(bytes) {
+    const text = hex(bytes);
+    return `${text.slice(0, 8)}-${text.slice(8, 12)}-${text.slice(12, 16)}-${text.slice(16, 20)}-${text.slice(20)}`;
+}
+export function createIdGenerator(clock, random = cryptoRandom) {
+    let lastTime = -1;
+    let counter = 0;
+    return () => {
+        const now = clock.now();
+        if (now > lastTime) {
+            lastTime = now;
+            const seed = new Uint8Array(2);
+            random(seed);
+            counter = ((seed[0] ?? 0) << 4 | (seed[1] ?? 0) >> 4) & 0x7ff;
+        }
+        else if (counter < counterMaximum) {
+            counter += 1;
+        }
+        else {
+            lastTime += 1;
+            counter = 0;
+        }
+        const bytes = new Uint8Array(16);
+        random(bytes.subarray(8));
+        const time = BigInt(lastTime);
+        for (let index = 0; index < 6; index += 1)
+            bytes[index] = Number((time >> BigInt(8 * (5 - index))) & 0xffn);
+        bytes[6] = 0x70 | (counter >> 8);
+        bytes[7] = counter & 0xff;
+        bytes[8] = 0x80 | ((bytes[8] ?? 0) & 0x3f);
+        return format(bytes);
+    };
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,KAAK,EAAE,EAAE;IAClD,cAAc,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC,CAAC;AAIF,MAAM,cAAc,GAAG,KAAK,CAAC;AAE7B,SAAS,GAAG,CAAC,KAAiB;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,MAAM,CAAC,KAAiB;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAClH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAY,EAAE,SAAuB,YAAY;IACjF,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,GAAG,GAAG,QAAQ,EAAE,CAAC;YACnB,QAAQ,GAAG,GAAG,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QAChE,CAAC;aAAM,IAAI,OAAO,GAAG,cAAc,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,QAAQ,IAAI,CAAC,CAAC;YACd,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC5G,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QACjC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;QAC1B,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { startKernel, type ExecOptions, type Kernel, type KernelMode, type KernelOptions } from './kernel.ts';
+export { homeWorkspaceId } from './workspaces/workspaces.ts';
+export { openSecretsFile, type SecretsFile } from './secrets/secrets-file.ts';
+export type { LogLevel } from './logging/logger.ts';
+export type { PresetSource } from './preset-edit/preset-source.ts';
+export { discardPresetBackup, presetBackupFor, restorePresetBackup } from './preset-edit/preset-backup.ts';
+export { systemClock, type Clock, type CancelTimer } from './clock.ts';
+export type { ProgressChunk } from './jobs/progress-hub.ts';
+export type { Catalog } from './localization/catalogs.ts';
+export { startHttp, type HttpServer } from './http/http-server.ts';
+export type { ExtensionVersion, TrustDecision } from './extensions/trust.ts';
+export { kernelVersion } from './kernel-version.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { startKernel } from "./kernel.js";
+export { homeWorkspaceId } from "./workspaces/workspaces.js";
+export { openSecretsFile } from "./secrets/secrets-file.js";
+export { discardPresetBackup, presetBackupFor, restorePresetBackup } from "./preset-edit/preset-backup.js";
+export { systemClock } from "./clock.js";
+export { startHttp } from "./http/http-server.js";
+export { kernelVersion } from "./kernel-version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAoB,MAAM,2BAA2B,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAgC,MAAM,YAAY,CAAC;AAGvE,OAAO,EAAE,SAAS,EAAmB,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { Caller, Workspace } from '@kvman/sdk';
+export type JobKind = 'command' | 'query';
+export type RunningJob = {
+    id: string;
+    rootId: string;
+    name: string;
+    kind: JobKind;
+    owner: string;
+    workspace: Workspace;
+    caller: Caller;
+    signal: AbortSignal;
+    depth: number;
+    fromHandler: boolean;
+};
+export declare function runInJob<Result>(job: RunningJob, run: () => Result): Result;
+export declare function currentJob(): RunningJob | undefined;
+export declare function requireJob(call: string): RunningJob;
+export declare function requireWritable(job: RunningJob, call: string): void;
+//# sourceMappingURL=current-job.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"current-job.d.ts","sourceRoot":"","sources":["../../src/jobs/current-job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAKpD,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAIF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,UAAU,IAAI,UAAU,GAAG,SAAS,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAInD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnE"}

package/dist/jobs/current-job.js

@@ -0,0 +1,20 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { kernelProblem } from "../problems.js";
+const storage = new AsyncLocalStorage();
+export function runInJob(job, run) {
+    return storage.run(job, run);
+}
+export function currentJob() {
+    return storage.getStore();
+}
+export function requireJob(call) {
+    const job = storage.getStore();
+    if (job === undefined)
+        throw kernelProblem('NO_JOB', `${call} works only inside a handler.`, { call });
+    return job;
+}
+export function requireWritable(job, call) {
+    if (job.kind === 'query')
+        throw kernelProblem('READ_ONLY', `${call} can't run inside the query ${job.name}.`, { call, name: job.name });
+}
+//# sourceMappingURL=current-job.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"current-job.js","sourceRoot":"","sources":["../../src/jobs/current-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAmB/C,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAEpD,MAAM,UAAU,QAAQ,CAAS,GAAe,EAAE,GAAiB;IACjE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC/B,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,+BAA+B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACvG,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAe,EAAE,IAAY;IAC3D,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,MAAM,aAAa,CAAC,WAAW,EAAE,GAAG,IAAI,+BAA+B,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1I,CAAC"}

package/dist/jobs/dispatcher.d.ts

@@ -0,0 +1,40 @@
+import { type Job, type Workspace } from '@kvman/sdk';
+import type { Clock } from '../clock.ts';
+import type { KernelLogger } from '../logging/logger.ts';
+import type { ScheduleRows } from '../schedules/schedule-rows.ts';
+import type { Connection } from '../storage/database.ts';
+import type { SyncEnd } from '../workers/protocol.ts';
+import type { WorkerPool } from '../workers/pool.ts';
+import type { HandlerSummary } from './handlers.ts';
+import type { JobRows, NewJob } from './job-rows.ts';
+export type DispatcherMode = 'running' | 'stopping' | 'stopped';
+export type DispatcherOptions = {
+    connection: Connection;
+    rows: JobRows;
+    schedules: ScheduleRows;
+    clock: Clock;
+    logger: KernelLogger;
+    workspaceOf: (id: string) => Workspace;
+};
+export type Dispatcher = ReturnType<typeof createDispatcher>;
+export type Deliver = (point: string, input: Record<string, unknown>, workspaceId: string) => void;
+export declare function createDispatcher(options: DispatcherOptions): {
+    attach(active: WorkerPool, summaries: readonly HandlerSummary[]): void;
+    wake: () => void;
+    slotFreed(): void;
+    setMode(next: DispatcherMode): void;
+    queue(job: NewJob): string;
+    queueAfterReply(job: NewJob): string;
+    deliver(point: string, input: Record<string, unknown>, workspaceId: string): string[];
+    deliverTo(point: string, extension: string, input: Record<string, unknown>, workspaceId: string): string[];
+    deliverAlong<Result>(work: (deliverIn: Deliver) => Result): Result;
+    deliverSyncEnd(end: SyncEnd): void;
+    interruptLeftovers(): void;
+    dropQueued(point: string): void;
+    cancel(jobId: string): void;
+    waitForJob(id: string): Promise<Job>;
+    settled(): Promise<void>;
+    running(): number;
+    drained: () => Promise<void>;
+};
+//# sourceMappingURL=dispatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/jobs/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAgB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAe,KAAK,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAOjE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;CACxC,CAAC;AAIF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAG7D,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB;mBA2GxC,UAAU,aAAa,SAAS,cAAc,EAAE,GAAG,IAAI;gBAjBvD,IAAI;iBAsBN,IAAI;kBAGH,cAAc,GAAG,IAAI;eAQxB,MAAM,GAAG,MAAM;yBAOL,MAAM,GAAG,MAAM;mBAKrB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,MAAM,GAAG,MAAM,EAAE;qBAKpE,MAAM,aAAa,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,MAAM,GAAG,MAAM,EAAE;iBAM7F,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,MAAM;wBAK9C,OAAO,GAAG,IAAI;0BAKZ,IAAI;sBAIR,MAAM,GAAG,IAAI;kBAGjB,MAAM,GAAG,IAAI;mBAUZ,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;eAMzB,OAAO,CAAC,IAAI,CAAC;eAKb,MAAM;mBAGE,OAAO,CAAC,IAAI,CAAC;EAInC"}