@kvman/kernel 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Deif
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @kvman/kernel
+
+The kernel of [kvman](https://github.com/ibndeif/kvman): jobs, workers, storage, extensions, and HTTP.
+
+It is a dependency of `kvman` and `@kvman/testkit`. An extension never imports it: an extension uses [`@kvman/sdk`](https://www.npmjs.com/package/@kvman/sdk), and tests use [`@kvman/testkit`](https://www.npmjs.com/package/@kvman/testkit).
+
+See [Architecture](https://github.com/ibndeif/kvman/blob/main/docs/developers/architecture.md).
+
+## License
+
+MIT

package/dist/clock.d.ts

@@ -0,0 +1,8 @@
+export type CancelTimer = () => void;
+export type Clock = {
+    now(): number;
+    setTimer(delayMs: number, run: () => void): CancelTimer;
+};
+export declare const systemClock: Clock;
+export declare function isoTime(clock: Clock): string;
+//# sourceMappingURL=clock.d.ts.map

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,MAAM,KAAK,GAAG;IAClB,GAAG,IAAI,MAAM,CAAC;IACd,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;CACzD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAMzB,CAAC;AAEF,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE5C"}

package/dist/clock.js

@@ -0,0 +1,13 @@
+// The kernel's source of time and its timers: retries, schedules, and retention wait on it. Tests inject a fake one
+// that moves only when told (plan 10).
+export const systemClock = {
+    now: () => Date.now(),
+    setTimer: (delayMs, run) => {
+        const timer = setTimeout(run, delayMs);
+        return () => clearTimeout(timer);
+    },
+};
+export function isoTime(clock) {
+    return new Date(clock.now()).toISOString();
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,uCAAuC;AASvC,MAAM,CAAC,MAAM,WAAW,GAAU;IAChC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,KAAY;IAClC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC"}

package/dist/ctx/extension-ctx.d.ts

@@ -0,0 +1,22 @@
+import { type Ctx, type Json } from '@kvman/sdk';
+import type { Files } from '../files/files.ts';
+import type { KernelLogger } from '../logging/logger.ts';
+import type { SecretsFile } from '../secrets/secrets-file.ts';
+import type { Settings } from '../settings/settings.ts';
+import type { Connection } from '../storage/database.ts';
+import { type Owner } from '../jobs/registry.ts';
+import { type JobCallServices } from './job-calls.ts';
+export type WorkerServices = JobCallServices & {
+    home: string;
+    connection: Connection;
+    files: Files;
+    logger: KernelLogger;
+    settings: Settings;
+    secrets: SecretsFile;
+    sendProgress: (rootId: string, chunk: {
+        source: string;
+        data: Json;
+    }) => void;
+};
+export declare function createExtensionCtx(owner: Owner, services: WorkerServices): Ctx;
+//# sourceMappingURL=extension-ctx.d.ts.map

package/dist/ctx/extension-ctx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-ctx.d.ts","sourceRoot":"","sources":["../../src/ctx/extension-ctx.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,GAAG,EAAmB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAgC,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAK/E,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMhE,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/E,CAAC;AA+CF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,GAAG,GAAG,CAuB9E"}

package/dist/ctx/extension-ctx.js

@@ -0,0 +1,78 @@
+import { jsonSchema, problemCodeSchema, ProblemError } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+import { createStore } from "../store/store.js";
+import { currentJob, requireJob, requireWritable } from "../jobs/current-job.js";
+import { registerJob, registerSetting } from "../jobs/registry.js";
+import { registerHandler } from "../jobs/handlers.js";
+import { progressLimitBytes } from "../limits.js";
+import { filesCalls } from "./files-calls.js";
+import { jobCalls } from "./job-calls.js";
+import { processesCalls } from "./processes-calls.js";
+import { settingsCalls } from "./settings-calls.js";
+function logWith(logger, owner) {
+    const tagged = (fields) => {
+        const job = currentJob();
+        return job === undefined ? { ...fields, extension: owner.name } : { ...fields, extension: owner.name, jobId: job.id };
+    };
+    return {
+        debug: (message, fields) => logger.debug(message, tagged(fields)),
+        info: (message, fields) => logger.info(message, tagged(fields)),
+        warn: (message, fields) => logger.warn(message, tagged(fields)),
+        error: (message, fields) => logger.error(message, tagged(fields)),
+    };
+}
+function problemFor(owner, code, params) {
+    if (!problemCodeSchema.safeParse(code).success || !code.startsWith(`${owner.namespace}/`)) {
+        return kernelProblem('VALIDATION_FAILED', `${owner.name}: a problem code is "${owner.namespace}/UPPER_SNAKE", not "${code}".`, { code });
+    }
+    return new ProblemError(params === undefined ? { code, message: code } : { code, message: code, params: { ...params } });
+}
+function progressOf(owner, services, rootId) {
+    return (data) => {
+        if (!jsonSchema.safeParse(data).success)
+            throw kernelProblem('VALIDATION_FAILED', 'A progress chunk must be JSON.');
+        if (Buffer.byteLength(JSON.stringify(data)) > progressLimitBytes) {
+            throw kernelProblem('TOO_LARGE', `A progress chunk is over ${progressLimitBytes} bytes of JSON.`, { limit: progressLimitBytes });
+        }
+        services.sendProgress(rootId, { source: owner.name, data });
+    };
+}
+function secretsOf(owner, services) {
+    const write = async (call, request) => {
+        requireWritable(requireJob(call), call);
+        await services.request(request);
+    };
+    return {
+        get: async (name) => {
+            requireJob('ctx.secrets.get');
+            return services.secrets.get(owner.name, name);
+        },
+        set: (name, value) => write('ctx.secrets.set', { kind: 'write-secret', write: { action: 'set', extension: owner.name, name, value } }),
+        delete: (name) => write('ctx.secrets.delete', { kind: 'write-secret', write: { action: 'delete', extension: owner.name, name } }),
+    };
+}
+export function createExtensionCtx(owner, services) {
+    const registry = services.environment.registry;
+    return {
+        registerCommand: (name, registration) => registerJob(registry, owner, 'command', name, registration),
+        registerQuery: (name, registration) => registerJob(registry, owner, 'query', name, registration),
+        registerSetting: (key, registration) => registerSetting(registry, owner, key, registration),
+        registerHandler: (point, registration) => registerHandler(registry, owner, point, registration),
+        ...jobCalls(owner, services),
+        problem: (code, params) => problemFor(owner, code, params),
+        get job() {
+            const job = requireJob('ctx.job');
+            return { id: job.id, rootId: job.rootId, workspace: job.workspace, caller: job.caller, signal: job.signal, progress: progressOf(owner, services, job.rootId) };
+        },
+        get store() {
+            const job = requireJob('ctx.store');
+            return createStore(services.connection, { extension: owner.name, workspaceId: job.workspace.id }, services.ids, () => requireWritable(job, 'A store write'));
+        },
+        files: filesCalls(owner, services.files),
+        settings: settingsCalls(owner, registry, services.settings),
+        secrets: secretsOf(owner, services),
+        processes: processesCalls(owner, services),
+        log: logWith(services.logger, owner),
+    };
+}
+//# sourceMappingURL=extension-ctx.js.map

package/dist/ctx/extension-ctx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-ctx.js","sourceRoot":"","sources":["../../src/ctx/extension-ctx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAwC,MAAM,YAAY,CAAC;AAG/G,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAc,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAwB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAcpD,SAAS,OAAO,CAAC,MAAoB,EAAE,KAAY;IACjD,MAAM,MAAM,GAAG,CAAC,MAA6B,EAAa,EAAE;QAC1D,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IACxH,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAY,EAAE,IAAY,EAAE,MAAkD;IAChG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC1F,OAAO,aAAa,CAAC,mBAAmB,EAAE,GAAG,KAAK,CAAC,IAAI,wBAAwB,KAAK,CAAC,SAAS,uBAAuB,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3I,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3H,CAAC;AAED,SAAS,UAAU,CAAC,KAAY,EAAE,QAAwB,EAAE,MAAc;IACxE,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO;YAAE,MAAM,aAAa,CAAC,mBAAmB,EAAE,gCAAgC,CAAC,CAAC;QACpH,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,kBAAkB,EAAE,CAAC;YACjE,MAAM,aAAa,CAAC,WAAW,EAAE,4BAA4B,kBAAkB,iBAAiB,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACnI,CAAC;QACD,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAY,EAAE,QAAwB;IACvD,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAE,OAAsB,EAAiB,EAAE;QAC1E,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC;IACF,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,UAAU,CAAC,iBAAiB,CAAC,CAAC;YAC9B,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtI,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;KAClI,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAY,EAAE,QAAwB;IACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC;IAC/C,OAAO;QACL,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC;QACpG,aAAa,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC;QAChG,eAAe,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC;QAC3F,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC;QAC/F,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC;QAC1D,IAAI,GAAG;YACL,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjK,CAAC;QACD,IAAI,KAAK;YACP,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACpC,OAAO,WAAW,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;QAC/J,CAAC;QACD,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;QACxC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC3D,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC;QACnC,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC1C,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/ctx/files-calls.d.ts

@@ -0,0 +1,5 @@
+import type { Ctx } from '@kvman/sdk';
+import type { Files } from '../files/files.ts';
+import type { Owner } from '../jobs/registry.ts';
+export declare function filesCalls(owner: Owner, files: Files): Ctx['files'];
+//# sourceMappingURL=files-calls.d.ts.map

package/dist/ctx/files-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-calls.d.ts","sourceRoot":"","sources":["../../src/ctx/files-calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAIjD,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAmBnE"}

package/dist/ctx/files-calls.js

@@ -0,0 +1,26 @@
+import { fileInWorkspace, unlinkAs } from "../files/file-access.js";
+import { requireJob, requireWritable } from "../jobs/current-job.js";
+import { kernelProblem } from "../problems.js";
+// `ctx.files` (plan 02 §2.7, ADR 0009, 24): files of the job's workspace, written with the extension as owner.
+export function filesCalls(owner, files) {
+    const caller = { kind: 'extension', name: owner.name };
+    const own = (call, id) => fileInWorkspace(files, id, requireJob(call).workspace.id);
+    return {
+        write: async (name, data, type) => {
+            const job = requireJob('ctx.files.write');
+            requireWritable(job, 'ctx.files.write');
+            if (typeof data !== 'string' && !(data instanceof Uint8Array))
+                throw kernelProblem('VALIDATION_FAILED', "A file's data is a Uint8Array or a string.");
+            return files.write({ name, data, type, owner: caller, workspaceId: job.workspace.id });
+        },
+        get: async (id) => own('ctx.files.get', id),
+        read: async (id) => files.read(own('ctx.files.read', id).id),
+        path: async (id) => files.path(own('ctx.files.path', id).id),
+        unlink: async (id) => {
+            const job = requireJob('ctx.files.unlink');
+            requireWritable(job, 'ctx.files.unlink');
+            unlinkAs(files, id, job.workspace.id, caller);
+        },
+    };
+}
+//# sourceMappingURL=files-calls.js.map

package/dist/ctx/files-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-calls.js","sourceRoot":"","sources":["../../src/ctx/files-calls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,+GAA+G;AAC/G,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,KAAY;IACnD,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAW,CAAC;IAChE,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpG,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAChC,MAAM,GAAG,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;YAC1C,eAAe,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YACxC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC;gBAAE,MAAM,aAAa,CAAC,mBAAmB,EAAE,4CAA4C,CAAC,CAAC;YACtJ,OAAO,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC;QAC3C,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5D,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;YAC3C,eAAe,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;YACzC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/ctx/job-calls.d.ts

@@ -0,0 +1,12 @@
+import { type Ctx } from '@kvman/sdk';
+import type { Owner } from '../jobs/registry.ts';
+import { type JobEnvironment } from '../jobs/run-job.ts';
+import type { WorkerRequest } from '../workers/protocol.ts';
+import type { IdGenerator } from '../ids.ts';
+export type JobCallServices = {
+    environment: JobEnvironment;
+    ids: IdGenerator;
+    request: (request: WorkerRequest) => Promise<unknown>;
+};
+export declare function jobCalls(owner: Owner, services: JobCallServices): Pick<Ctx, 'exec' | 'execAsync' | 'schedule' | 'cancel'>;
+//# sourceMappingURL=job-calls.d.ts.map

package/dist/ctx/job-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-calls.d.ts","sourceRoot":"","sources":["../../src/ctx/job-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,GAAG,EAAyD,MAAM,YAAY,CAAC;AAErH,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,MAAM,MAAM,eAAe,GAAG;IAAE,WAAW,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAgBvI,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC,CAsDzH"}

package/dist/ctx/job-calls.js

@@ -0,0 +1,73 @@
+import { z } from '@kvman/sdk';
+import { requireJob, requireWritable } from "../jobs/current-job.js";
+import { runJob } from "../jobs/run-job.js";
+import { kernelProblem } from "../problems.js";
+const timingSchema = z.union([
+    z.strictObject({ at: z.date().refine((date) => !Number.isNaN(date.getTime()), 'at must be a valid date'), key: z.string().min(1).optional() }),
+    z.strictObject({ cron: z.string().min(1), key: z.string().min(1).optional() }),
+]);
+function commandFor(services, owner, name) {
+    const registration = services.environment.registry.jobs.get(name);
+    if (registration === undefined)
+        throw kernelProblem('NOT_FOUND', `There is no command ${name}.`, { name });
+    if (registration.kind !== 'command')
+        throw kernelProblem('NOT_A_COMMAND', `${name} is a query; only commands can be queued or scheduled.`, { name });
+    if (!registration.public && registration.owner !== owner.name)
+        throw kernelProblem('NOT_PUBLIC', `${name} is private to ${registration.owner}.`, { name });
+    if (registration.syncOnly)
+        throw kernelProblem('VALIDATION_FAILED', `${name} runs only as a sync call; it can't be queued or scheduled.`, { name });
+    return registration;
+}
+export function jobCalls(owner, services) {
+    const exec = async (name, input) => {
+        const parent = requireJob('ctx.exec');
+        const output = await runJob(services.environment, {
+            id: services.ids(),
+            rootId: parent.rootId,
+            name,
+            input,
+            workspace: parent.workspace,
+            caller: { kind: 'extension', name: owner.name },
+            parent,
+            signal: parent.signal,
+            fromHandler: parent.fromHandler,
+            handlerExtension: undefined,
+        });
+        // The kernel checked the output against the registered schema; the declared type is the callee's promise.
+        return output;
+    };
+    const execAsync = async (name, input) => {
+        const job = requireJob('ctx.execAsync');
+        requireWritable(job, 'ctx.execAsync');
+        const { retries } = commandFor(services, owner, name);
+        const request = { kind: 'queue-job', name, input, workspaceId: job.workspace.id, caller: { kind: 'extension', name: owner.name }, retries, fromHandler: job.fromHandler };
+        return z.string().parse(await services.request(request));
+    };
+    const schedule = async (name, input, timing) => {
+        const job = requireJob('ctx.schedule');
+        requireWritable(job, 'ctx.schedule');
+        const { retries } = commandFor(services, owner, name);
+        const parsed = timingSchema.safeParse(timing);
+        if (!parsed.success)
+            throw kernelProblem('VALIDATION_FAILED', 'A schedule needs { at: Date } or { cron: string }, with an optional key.');
+        const when = 'at' in parsed.data ? { at: parsed.data.at.toISOString() } : { cron: parsed.data.cron };
+        const key = parsed.data.key === undefined ? {} : { key: parsed.data.key };
+        const request = { kind: 'schedule', name, input, timing: when, ...key, workspaceId: job.workspace.id, owner: owner.name, retries, fromHandler: job.fromHandler };
+        return z.string().parse(await services.request(request));
+    };
+    const cancelSchedule = async (id) => {
+        requireWritable(requireJob('ctx.schedule.cancel'), 'ctx.schedule.cancel');
+        await services.request({ kind: 'cancel-schedule', id, owner: owner.name });
+    };
+    const scheduleCall = Object.assign(schedule, { cancel: cancelSchedule });
+    return {
+        exec,
+        execAsync,
+        schedule: scheduleCall,
+        cancel: async (jobId) => {
+            requireJob('ctx.cancel');
+            await services.request({ kind: 'cancel-job', jobId });
+        },
+    };
+}
+//# sourceMappingURL=job-calls.js.map

package/dist/ctx/job-calls.js.map

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

package/dist/ctx/processes-calls.d.ts

@@ -0,0 +1,11 @@
+import { type Ctx } from '@kvman/sdk';
+import type { Owner } from '../jobs/registry.ts';
+import type { Connection } from '../storage/database.ts';
+import type { WorkerRequest } from '../workers/protocol.ts';
+export type ProcessCallServices = {
+    connection: Connection;
+    home: string;
+    request: (request: WorkerRequest) => Promise<unknown>;
+};
+export declare function processesCalls(owner: Owner, services: ProcessCallServices): Ctx['processes'];
+//# sourceMappingURL=processes-calls.d.ts.map

package/dist/ctx/processes-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes-calls.d.ts","sourceRoot":"","sources":["../../src/ctx/processes-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAIjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAK5D,MAAM,MAAM,mBAAmB,GAAG;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAmBlI,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,GAAG,GAAG,CAAC,WAAW,CAAC,CA2B5F"}

package/dist/ctx/processes-calls.js

@@ -0,0 +1,50 @@
+import { z } from '@kvman/sdk';
+import { requireJob, requireWritable } from "../jobs/current-job.js";
+import { defaultTailLines, processLogPath, tailOf } from "../processes/process-log.js";
+import { listOwnProcesses } from "../processes/process-rows.js";
+import { kernelProblem } from "../problems.js";
+import { validationFailed } from "../store/json-values.js";
+const namePattern = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const startSchema = z.strictObject({
+    command: z.string().min(1),
+    args: z.array(z.string()).optional(),
+    cwd: z.string().min(1).optional(),
+    env: z.record(z.string(), z.string()).optional(),
+});
+const startedSchema = z.object({ name: z.string(), pid: z.number().int(), startedAt: z.string() });
+function checkName(name) {
+    if (typeof name !== 'string' || !namePattern.test(name)) {
+        throw kernelProblem('VALIDATION_FAILED', 'A process name is lowercase kebab case, such as "preview".', { name: String(name) });
+    }
+}
+export function processesCalls(owner, services) {
+    return {
+        start: async (name, options) => {
+            const job = requireJob('ctx.processes.start');
+            requireWritable(job, 'ctx.processes.start');
+            checkName(name);
+            const parsed = startSchema.safeParse(options);
+            if (!parsed.success)
+                throw validationFailed(`The options of the process ${name}`, parsed.error);
+            const start = { command: parsed.data.command, args: parsed.data.args ?? [], env: parsed.data.env ?? {}, ...(parsed.data.cwd === undefined ? {} : { cwd: parsed.data.cwd }) };
+            const request = { kind: 'start-process', extension: owner.name, workspace: job.workspace, name, options: start };
+            return startedSchema.parse(await services.request(request));
+        },
+        stop: async (name) => {
+            const job = requireJob('ctx.processes.stop');
+            requireWritable(job, 'ctx.processes.stop');
+            checkName(name);
+            await services.request({ kind: 'stop-process', extension: owner.name, workspaceId: job.workspace.id, name });
+        },
+        list: async () => listOwnProcesses(services.connection, owner.name, requireJob('ctx.processes.list').workspace.id),
+        log: async (name, options) => {
+            const job = requireJob('ctx.processes.log');
+            checkName(name);
+            const tail = z.number().int().positive().default(defaultTailLines).safeParse(options?.tail);
+            if (!tail.success)
+                throw validationFailed('The tail of a process log', tail.error);
+            return tailOf(processLogPath(services.home, owner.name, job.workspace.id, name), name, tail.data);
+        },
+    };
+}
+//# sourceMappingURL=processes-calls.js.map

package/dist/ctx/processes-calls.js.map

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

package/dist/ctx/settings-calls.d.ts

@@ -0,0 +1,5 @@
+import { type Ctx } from '@kvman/sdk';
+import type { Owner, Registry } from '../jobs/registry.ts';
+import type { Settings } from '../settings/settings.ts';
+export declare function settingsCalls(owner: Owner, registry: Registry, settings: Settings): Ctx['settings'];
+//# sourceMappingURL=settings-calls.d.ts.map

package/dist/ctx/settings-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-calls.d.ts","sourceRoot":"","sources":["../../src/ctx/settings-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAuB,MAAM,YAAY,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAQxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAiBnG"}

package/dist/ctx/settings-calls.js

@@ -0,0 +1,30 @@
+import { jsonSchema, z } from '@kvman/sdk';
+import { requireJob, requireWritable } from "../jobs/current-job.js";
+import { kernelProblem } from "../problems.js";
+import { validationFailed } from "../store/json-values.js";
+// `ctx.settings` (plan 02 §2.8, ADR 0009, 24): any key is read in the job's workspace; only the extension's own keys are
+// written, in a scope the key allows.
+const scopeSchema = z.enum(['global', 'workspace']);
+export function settingsCalls(owner, registry, settings) {
+    return {
+        // The kernel checked the value against the key's schema; the declared type is the key owner's promise.
+        get: async (key) => settings.resolve(key, requireJob('ctx.settings.get').workspace.id).value,
+        set: async (key, value, options) => {
+            const job = requireJob('ctx.settings.set');
+            requireWritable(job, 'ctx.settings.set');
+            const definition = registry.settings.get(key);
+            if (definition === undefined)
+                throw kernelProblem('NOT_FOUND', `There is no setting "${key}".`, { key });
+            if (definition.extension !== owner.name)
+                throw kernelProblem('NOT_PUBLIC', `The setting "${key}" belongs to ${definition.extension}.`, { key });
+            const json = jsonSchema.safeParse(value);
+            if (!json.success)
+                throw validationFailed(`The value of "${key}"`, json.error);
+            const scope = scopeSchema.safeParse(options.scope);
+            if (!scope.success)
+                throw validationFailed(`The scope of "${key}"`, scope.error);
+            settings.set(key, json.data, scope.data, job.workspace.id);
+        },
+    };
+}
+//# sourceMappingURL=settings-calls.js.map

package/dist/ctx/settings-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-calls.js","sourceRoot":"","sources":["../../src/ctx/settings-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,CAAC,EAAiC,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,yHAAyH;AACzH,sCAAsC;AAEtC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAEpD,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,QAAkB,EAAE,QAAkB;IAChF,OAAO;QACL,uGAAuG;QACvG,GAAG,EAAE,KAAK,EAAsB,GAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,KAA4B;QAC5I,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACjC,MAAM,GAAG,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;YAC3C,eAAe,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;YACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,aAAa,CAAC,WAAW,EAAE,wBAAwB,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACzG,IAAI,UAAU,CAAC,SAAS,KAAK,KAAK,CAAC,IAAI;gBAAE,MAAM,aAAa,CAAC,YAAY,EAAE,gBAAgB,GAAG,gBAAgB,UAAU,CAAC,SAAS,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAChJ,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,MAAM,gBAAgB,CAAC,iBAAiB,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/E,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,MAAM,gBAAgB,CAAC,iBAAiB,GAAG,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACjF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/extensions/load-order.d.ts

@@ -0,0 +1,13 @@
+import type { ReadExtension } from './manifests.ts';
+export type RangeWarning = {
+    extension: string;
+    dependency: string;
+    range: string;
+};
+export declare function checkReload(extensions: readonly ReadExtension[], reloaded: ReadonlySet<string>, sdkVersion: string): {
+    ordered: ReadExtension[];
+    warnings: RangeWarning[];
+};
+export declare function dependentsOf(extensions: readonly ReadExtension[], names: ReadonlySet<string>): Set<string>;
+export declare function checkAndOrder(extensions: readonly ReadExtension[], sdkVersion: string): ReadExtension[];
+//# sourceMappingURL=load-order.d.ts.map

package/dist/extensions/load-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-order.d.ts","sourceRoot":"","sources":["../../src/extensions/load-order.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAkEpD,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIpF,wBAAgB,WAAW,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAkB3K;AAGD,wBAAgB,YAAY,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAc1G;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAQvG"}

package/dist/extensions/load-order.js

@@ -0,0 +1,111 @@
+import semver from 'semver';
+import { kernelProblem } from "../problems.js";
+import { kernelExtension } from "../settings/kernel-settings.js";
+// The start-time checks between extensions (plan 02 §2.9): namespaces (`kernel` is the kernel's own, ADR 0009, 32),
+// the sdk peer range, dependencies and their ranges, and cycles. Extensions load in dependency order; independent ones
+// keep the preset's order.
+function checkNamespaces(extensions) {
+    const owners = new Map([['kernel', kernelExtension]]);
+    for (const extension of extensions) {
+        const namespace = extension.manifest.kvman.namespace;
+        const owner = owners.get(namespace);
+        if (owner !== undefined) {
+            throw kernelProblem('EXTENSION_INVALID', `${owner} and ${extension.name} both claim the namespace "${namespace}".`, { extension: extension.name, namespace });
+        }
+        owners.set(namespace, extension.name);
+    }
+}
+function checkSdkRange(extension, sdkVersion) {
+    const range = extension.manifest.peerDependencies['@kvman/sdk'];
+    if (!semver.satisfies(sdkVersion, range, { includePrerelease: true })) {
+        throw kernelProblem('EXTENSION_INVALID', `${extension.name} needs @kvman/sdk ${range}, but this kvman has ${sdkVersion}.`, { extension: extension.name, range });
+    }
+}
+function checkDependencies(extension, byName) {
+    for (const [name, range] of Object.entries(extension.manifest.kvman.dependencies ?? {})) {
+        const dependency = byName.get(name);
+        if (dependency === undefined) {
+            throw kernelProblem('EXTENSION_INVALID', `${extension.name} depends on ${name}, which is not in this run.`, { extension: extension.name, dependency: name });
+        }
+        if (!semver.satisfies(dependency.manifest.version, range, { includePrerelease: true })) {
+            throw kernelProblem('EXTENSION_INVALID', `${extension.name} needs ${name} ${range}, but the run has ${dependency.manifest.version}.`, {
+                extension: extension.name,
+                dependency: name,
+                range,
+            });
+        }
+    }
+}
+function dependencyNames(extension) {
+    return Object.keys(extension.manifest.kvman.dependencies ?? {});
+}
+function orderByDependencies(extensions, byName) {
+    const ordered = [];
+    const done = new Set();
+    const visit = (extension, chain) => {
+        if (done.has(extension.name))
+            return;
+        if (chain.includes(extension.name)) {
+            const cycle = [...chain.slice(chain.indexOf(extension.name)), extension.name].join(' → ');
+            throw kernelProblem('EXTENSION_INVALID', `Extension dependencies form a cycle: ${cycle}.`, { cycle });
+        }
+        for (const name of dependencyNames(extension)) {
+            const dependency = byName.get(name);
+            if (dependency !== undefined)
+                visit(dependency, [...chain, extension.name]);
+        }
+        done.add(extension.name);
+        ordered.push(extension);
+    };
+    for (const extension of extensions)
+        visit(extension, []);
+    return ordered;
+}
+// The checks of a hot reload (plan 02 §2.9, ADR 0009, 26): the reloaded extensions must pass every start rule
+// themselves, but a dependent whose range they no longer satisfy only warns.
+export function checkReload(extensions, reloaded, sdkVersion) {
+    checkNamespaces(extensions);
+    const byName = new Map(extensions.map((extension) => [extension.name, extension]));
+    const warnings = [];
+    for (const extension of extensions) {
+        if (reloaded.has(extension.name)) {
+            checkSdkRange(extension, sdkVersion);
+            checkDependencies(extension, byName);
+            continue;
+        }
+        for (const [name, range] of Object.entries(extension.manifest.kvman.dependencies ?? {})) {
+            const dependency = byName.get(name);
+            if (reloaded.has(name) && dependency !== undefined && !semver.satisfies(dependency.manifest.version, range, { includePrerelease: true })) {
+                warnings.push({ extension: extension.name, dependency: name, range });
+            }
+        }
+    }
+    return { ordered: orderByDependencies(extensions, byName), warnings };
+}
+// The extensions that depend on any of `names`, directly or not.
+export function dependentsOf(extensions, names) {
+    const found = new Set();
+    let grew = true;
+    while (grew) {
+        grew = false;
+        for (const extension of extensions) {
+            if (found.has(extension.name) || names.has(extension.name))
+                continue;
+            if (dependencyNames(extension).some((name) => names.has(name) || found.has(name))) {
+                found.add(extension.name);
+                grew = true;
+            }
+        }
+    }
+    return found;
+}
+export function checkAndOrder(extensions, sdkVersion) {
+    checkNamespaces(extensions);
+    const byName = new Map(extensions.map((extension) => [extension.name, extension]));
+    for (const extension of extensions) {
+        checkSdkRange(extension, sdkVersion);
+        checkDependencies(extension, byName);
+    }
+    return orderByDependencies(extensions, byName);
+}
+//# sourceMappingURL=load-order.js.map

package/dist/extensions/load-order.js.map

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

package/dist/extensions/manifests.d.ts

@@ -0,0 +1,16 @@
+import { type ExtensionManifest, type ExtensionSource, type Preset } from '@kvman/sdk';
+export type ExtensionFolders = {
+    home: string;
+    presetFolder: string;
+    bundled: ReadonlyMap<string, string>;
+};
+export type ReadExtension = {
+    name: string;
+    source: ExtensionSource;
+    folder: string;
+    manifest: ExtensionManifest;
+    entryPath: string;
+};
+export declare function readExtension(name: string, source: ExtensionSource, folders: ExtensionFolders): ReadExtension;
+export declare function readExtensions(preset: Preset, folders: ExtensionFolders): ReadExtension[];
+//# sourceMappingURL=manifests.d.ts.map

package/dist/extensions/manifests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifests.d.ts","sourceRoot":"","sources":["../../src/extensions/manifests.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAKhH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAuCF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAI7G;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAEzF"}