@kvman/kernel 0.1.0

package/dist/preset-edit/preset-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-source.js","sourceRoot":"","sources":["../../src/preset-edit/preset-source.ts"],"names":[],"mappings":""}

package/dist/preset-edit/preset-store.d.ts

@@ -0,0 +1,22 @@
+import type { InstallSource, Preset, PresetState } from '@kvman/sdk';
+import type { PresetSource } from './preset-source.ts';
+export type PresetStoreOptions = {
+    home: string;
+    preset: Preset;
+    source: PresetSource;
+    bundled: ReadonlyMap<string, string>;
+    dependencies: ReadonlyMap<string, readonly string[]>;
+};
+export type PresetStore = {
+    get(): Promise<PresetState>;
+    install(source: InstallSource): Promise<{
+        file: string;
+        restartRequired: true;
+    }>;
+    uninstall(name: string): Promise<{
+        file: string;
+        restartRequired: true;
+    }>;
+};
+export declare function createPresetStore(options: PresetStoreOptions): PresetStore;
+//# sourceMappingURL=preset-store.d.ts.map

package/dist/preset-edit/preset-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-store.d.ts","sourceRoot":"","sources":["../../src/preset-edit/preset-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5B,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IACjF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAC3E,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAoE1E"}

package/dist/preset-edit/preset-store.js

@@ -0,0 +1,70 @@
+import path from 'node:path';
+import { kernelProblem } from "../problems.js";
+import { resolveInstallSource } from "./install-source.js";
+import { keepPresetBackup } from "./preset-backup.js";
+import { readStoredPreset, targetFileFor, writePresetFile } from "./preset-files.js";
+export function createPresetStore(options) {
+    let stored = options.preset;
+    let origin = options.source.origin;
+    let file = options.source.origin === 'bundled' ? undefined : options.source.file;
+    let pending = Promise.resolve();
+    const serial = (work) => {
+        const next = pending.then(work);
+        pending = next.then(() => undefined, () => undefined);
+        return next;
+    };
+    // The first edit of a bundled preset copies the run's preset to `<home>/presets/<name>.json`; from then on the
+    // stored preset is that file. Later runs start from the file itself, so no copy is needed.
+    const currentAndTarget = async () => {
+        if (origin === 'bundled')
+            return { current: stored, target: targetFileFor(options.home, stored.name) };
+        const target = file ?? targetFileFor(options.home, stored.name);
+        return { current: await readStoredPreset(target), target };
+    };
+    const remember = (edited, target) => {
+        stored = edited;
+        if (origin === 'bundled')
+            origin = 'home';
+        file = target;
+        return { file: target, restartRequired: true };
+    };
+    return {
+        get: () => serial(async () => {
+            if (origin === 'bundled')
+                return { ...stored, origin };
+            const target = file ?? targetFileFor(options.home, stored.name);
+            stored = await readStoredPreset(target);
+            return { ...stored, origin, file: target };
+        }),
+        install: (source) => serial(async () => {
+            const { current, target } = await currentAndTarget();
+            const { name, storedSource } = await resolveInstallSource(source, path.dirname(target));
+            if (current.extensions[name] !== undefined) {
+                throw kernelProblem('VALIDATION_FAILED', `${name} is already in the preset.`, { name });
+            }
+            if (storedSource === 'bundled' && !options.bundled.has(name)) {
+                throw kernelProblem('VALIDATION_FAILED', `${name} is not a bundled extension.`, { name });
+            }
+            const edited = { ...current, extensions: { ...current.extensions, [name]: storedSource } };
+            await keepPresetBackup(target, current);
+            await writePresetFile(target, edited);
+            return remember(edited, target);
+        }),
+        uninstall: (name) => serial(async () => {
+            const { current, target } = await currentAndTarget();
+            if (current.extensions[name] === undefined) {
+                throw kernelProblem('NOT_FOUND', `${name} is not in the preset.`, { name });
+            }
+            // Only the run's loaded extensions can be checked; an entry that wasn't loaded this run is skipped.
+            const dependents = Object.keys(current.extensions).filter((other) => other !== name && (options.dependencies.get(other) ?? []).includes(name));
+            if (dependents.length > 0) {
+                throw kernelProblem('VALIDATION_FAILED', `${name} is still needed by ${dependents.join(', ')}.`, { name, dependents });
+            }
+            const edited = { ...current, extensions: Object.fromEntries(Object.entries(current.extensions).filter(([other]) => other !== name)) };
+            await keepPresetBackup(target, current);
+            await writePresetFile(target, edited);
+            return remember(edited, target);
+        }),
+    };
+}
+//# sourceMappingURL=preset-store.js.map

package/dist/preset-edit/preset-store.js.map

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

package/dist/problems.d.ts

@@ -0,0 +1,3 @@
+import { ProblemError, type Json, type KernelProblemCode } from '@kvman/sdk';
+export declare function kernelProblem(code: KernelProblemCode, message: string, params?: Readonly<Record<string, Json>>): ProblemError;
+//# sourceMappingURL=problems.d.ts.map

package/dist/problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.d.ts","sourceRoot":"","sources":["../src/problems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG7E,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,YAAY,CAE7H"}

package/dist/problems.js

@@ -0,0 +1,6 @@
+import { ProblemError } from '@kvman/sdk';
+// Makes the error that carries one of the kernel's Problems (plan 05).
+export function kernelProblem(code, message, params) {
+    return new ProblemError(params === undefined ? { code, message } : { code, message, params: { ...params } });
+}
+//# sourceMappingURL=problems.js.map

package/dist/problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.js","sourceRoot":"","sources":["../src/problems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqC,MAAM,YAAY,CAAC;AAE7E,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,IAAuB,EAAE,OAAe,EAAE,MAAuC;IAC7G,OAAO,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/G,CAAC"}

package/dist/processes/process-kill.d.ts

@@ -0,0 +1,16 @@
+import { type SpawnOptions } from 'node:child_process';
+export type StopSignal = 'SIGTERM' | 'SIGKILL';
+export type KillPlan = {
+    kind: 'group';
+    pid: number;
+    signal: StopSignal;
+} | {
+    kind: 'command';
+    command: string;
+    args: string[];
+};
+export declare function killPlan(platform: NodeJS.Platform, pid: number, signal: StopSignal): KillPlan;
+export declare function spawnOptionsFor(platform: NodeJS.Platform): Pick<SpawnOptions, 'detached' | 'windowsHide'>;
+export declare function carryOut(plan: KillPlan): void;
+export declare function isAlive(pid: number): boolean;
+//# sourceMappingURL=process-kill.d.ts.map

package/dist/processes/process-kill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-kill.d.ts","sourceRoot":"","sources":["../../src/processes/process-kill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/C,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEjI,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,CAG7F;AAGD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,aAAa,CAAC,CAEzG;AAWD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAU7C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAU5C"}

package/dist/processes/process-kill.js

@@ -0,0 +1,45 @@
+import { spawnSync } from 'node:child_process';
+export function killPlan(platform, pid, signal) {
+    if (platform === 'win32')
+        return { kind: 'command', command: 'taskkill', args: ['/PID', String(pid), '/T', '/F'] };
+    return { kind: 'group', pid, signal };
+}
+// On Linux and macOS a process starts detached, so it leads a new process group; on Windows it keeps no window.
+export function spawnOptionsFor(platform) {
+    return platform === 'win32' ? { detached: false, windowsHide: true } : { detached: true, windowsHide: true };
+}
+function hasCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+function isGone(error) {
+    return hasCode(error, 'ESRCH');
+}
+// Carries out the plan; a group that has already ended is what the kill wants, so it is done.
+export function carryOut(plan) {
+    if (plan.kind === 'command') {
+        spawnSync(plan.command, plan.args, { windowsHide: true });
+        return;
+    }
+    try {
+        process.kill(-plan.pid, plan.signal);
+    }
+    catch (error) {
+        if (!isGone(error))
+            throw error;
+    }
+}
+export function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (isGone(error))
+            return false;
+        // EPERM: the process exists but belongs to another user.
+        if (hasCode(error, 'EPERM'))
+            return true;
+        throw error;
+    }
+}
+//# sourceMappingURL=process-kill.js.map

package/dist/processes/process-kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-kill.js","sourceRoot":"","sources":["../../src/processes/process-kill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AASlE,MAAM,UAAU,QAAQ,CAAC,QAAyB,EAAE,GAAW,EAAE,MAAkB;IACjF,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;IACnH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,eAAe,CAAC,QAAyB;IACvD,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/G,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY;IAC3C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC1E,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,yDAAyD;QACzD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/processes/process-log.d.ts

@@ -0,0 +1,10 @@
+export declare const processLogLimitBytes: number;
+export declare const defaultTailLines = 100;
+export declare function processLogPath(home: string, extension: string, workspaceId: string, name: string): string;
+export type ProcessLog = {
+    write(chunk: Buffer): void;
+    close(): void;
+};
+export declare function openProcessLog(file: string): ProcessLog;
+export declare function tailOf(file: string, name: string, lines: number): string;
+//# sourceMappingURL=process-log.d.ts.map

package/dist/processes/process-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-log.d.ts","sourceRoot":"","sources":["../../src/processes/process-log.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzG;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAEvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAmBvD;AAGD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxE"}

package/dist/processes/process-log.js

@@ -0,0 +1,41 @@
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, writeFileSync, writeSync } from 'node:fs';
+import path from 'node:path';
+import { kernelProblem } from "../problems.js";
+// A long-lived process's output (plan 02 §2.16, ADR 0009, 27 and 30): `logs/processes/<extension>/<workspaceId>/<name>.log`,
+// truncated at each start and capped at 10 MB, where going over drops the oldest half.
+export const processLogLimitBytes = 10 * 1024 * 1024;
+export const defaultTailLines = 100;
+export function processLogPath(home, extension, workspaceId, name) {
+    return path.join(home, 'logs', 'processes', extension, workspaceId, `${name}.log`);
+}
+export function openProcessLog(file) {
+    mkdirSync(path.dirname(file), { recursive: true });
+    let descriptor = openSync(file, 'w');
+    let size = 0;
+    const dropOldestHalf = () => {
+        closeSync(descriptor);
+        const kept = readFileSync(file).subarray(size - Math.floor(processLogLimitBytes / 2));
+        writeFileSync(file, kept);
+        size = kept.byteLength;
+        descriptor = openSync(file, 'a');
+    };
+    return {
+        write(chunk) {
+            writeSync(descriptor, chunk);
+            size += chunk.byteLength;
+            if (size > processLogLimitBytes)
+                dropOldestHalf();
+        },
+        close: () => closeSync(descriptor),
+    };
+}
+// The last lines of a process's log; a process that never ran has none (NOT_FOUND).
+export function tailOf(file, name, lines) {
+    if (!existsSync(file))
+        throw kernelProblem('NOT_FOUND', `There is no process ${name}.`, { name });
+    const all = readFileSync(file, 'utf8').split('\n');
+    if (all.at(-1) === '')
+        all.pop();
+    return all.slice(-lines).join('\n');
+}
+//# sourceMappingURL=process-log.js.map

package/dist/processes/process-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-log.js","sourceRoot":"","sources":["../../src/processes/process-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7G,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,6HAA6H;AAC7H,uFAAuF;AAEvF,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,SAAiB,EAAE,WAAmB,EAAE,IAAY;IAC/F,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;AACrF,CAAC;AAID,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,IAAI,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,cAAc,GAAG,GAAS,EAAE;QAChC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC;QACtF,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;QACvB,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,KAAK;YACT,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC7B,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC;YACzB,IAAI,IAAI,GAAG,oBAAoB;gBAAE,cAAc,EAAE,CAAC;QACpD,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAY,EAAE,KAAa;IAC9D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,aAAa,CAAC,WAAW,EAAE,uBAAuB,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACjC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/processes/process-rows.d.ts

@@ -0,0 +1,11 @@
+import type { ProcessInfo } from '@kvman/sdk';
+import type { Connection } from '../storage/database.ts';
+export type ProcessRow = ProcessInfo & {
+    extension: string;
+    workspaceId: string;
+};
+export declare function listProcesses(connection: Connection): ProcessRow[];
+export declare function listOwnProcesses(connection: Connection, extension: string, workspaceId: string): ProcessInfo[];
+export declare function insertProcess(connection: Connection, row: ProcessRow): void;
+export declare function deleteProcess(connection: Connection, row: Pick<ProcessRow, 'extension' | 'workspaceId' | 'name'>): void;
+//# sourceMappingURL=process-rows.d.ts.map

package/dist/processes/process-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-rows.d.ts","sourceRoot":"","sources":["../../src/processes/process-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAQlF,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,CAElE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAK9G;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAI3E;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC,GAAG,IAAI,CAEvH"}

package/dist/processes/process-rows.js

@@ -0,0 +1,21 @@
+function processOfRow(row) {
+    return { extension: row.extension, workspaceId: row.workspace_id, name: row.name, pid: row.pid, startedAt: row.started_at };
+}
+export function listProcesses(connection) {
+    return connection.prepare('SELECT * FROM processes ORDER BY started_at, extension, workspace_id, name').all().map(processOfRow);
+}
+export function listOwnProcesses(connection, extension, workspaceId) {
+    return connection
+        .prepare('SELECT * FROM processes WHERE extension = ? AND workspace_id = ? ORDER BY started_at, name')
+        .all(extension, workspaceId)
+        .map((row) => ({ name: row.name, pid: row.pid, startedAt: row.started_at }));
+}
+export function insertProcess(connection, row) {
+    connection
+        .prepare('INSERT INTO processes (extension, workspace_id, name, pid, started_at) VALUES (?, ?, ?, ?, ?)')
+        .run(row.extension, row.workspaceId, row.name, row.pid, row.startedAt);
+}
+export function deleteProcess(connection, row) {
+    connection.prepare('DELETE FROM processes WHERE extension = ? AND workspace_id = ? AND name = ?').run(row.extension, row.workspaceId, row.name);
+}
+//# sourceMappingURL=process-rows.js.map

package/dist/processes/process-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-rows.js","sourceRoot":"","sources":["../../src/processes/process-rows.ts"],"names":[],"mappings":"AAUA,SAAS,YAAY,CAAC,GAAQ;IAC5B,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;AAC9H,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAsB;IAClD,OAAO,UAAU,CAAC,OAAO,CAAU,4EAA4E,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC3I,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAsB,EAAE,SAAiB,EAAE,WAAmB;IAC7F,OAAO,UAAU;SACd,OAAO,CAAwB,4FAA4F,CAAC;SAC5H,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC;SAC3B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAsB,EAAE,GAAe;IACnE,UAAU;SACP,OAAO,CAAC,+FAA+F,CAAC;SACxG,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAsB,EAAE,GAA2D;IAC/G,UAAU,CAAC,OAAO,CAAC,6EAA6E,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;AAClJ,CAAC"}

package/dist/processes/process-service.d.ts

@@ -0,0 +1,30 @@
+import type { ProcessInfo, Workspace } from '@kvman/sdk';
+import { type Clock } from '../clock.ts';
+import type { Deliver } from '../jobs/dispatcher.ts';
+import type { KernelLogger } from '../logging/logger.ts';
+import type { Connection } from '../storage/database.ts';
+export declare const stopGraceMs = 5000;
+export type ProcessStartOptions = {
+    command: string;
+    args: readonly string[];
+    cwd: string | undefined;
+    env: Readonly<Record<string, string>>;
+};
+export type ProcessServiceOptions = {
+    connection: Connection;
+    home: string;
+    clock: Clock;
+    logger: KernelLogger;
+    platform: NodeJS.Platform;
+    deliverAlong: (work: (deliverIn: Deliver) => void) => void;
+};
+export type ProcessService = ReturnType<typeof createProcessService>;
+export declare function createProcessService(options: ProcessServiceOptions): {
+    start(extension: string, workspace: Workspace, name: string, start: ProcessStartOptions): Promise<ProcessInfo>;
+    stop(extension: string, workspaceId: string, name: string): Promise<void>;
+    terminateAll(): void;
+    killAll(): Promise<void>;
+    exited: () => Promise<void>;
+    killLeftovers(): void;
+};
+//# sourceMappingURL=process-service.d.ts.map

package/dist/processes/process-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../../src/processes/process-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQzD,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAE/I,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;CAC5D,CAAC;AAaF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;qBAyCxC,MAAM,aAAa,SAAS,QAAQ,MAAM,SAAS,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;oBAc9F,MAAM,eAAe,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;oBAU/D,IAAI;eAMH,OAAO,CAAC,IAAI,CAAC;kBAIZ,OAAO,CAAC,IAAI,CAAC;qBAId,IAAI;EAOxB"}

package/dist/processes/process-service.js

@@ -0,0 +1,110 @@
+import { spawn } from 'node:child_process';
+import { rmSync } from 'node:fs';
+import path from 'node:path';
+import { isoTime } from "../clock.js";
+import { kernelProblem } from "../problems.js";
+import { carryOut, isAlive, killPlan, spawnOptionsFor } from "./process-kill.js";
+import { openProcessLog, processLogPath } from "./process-log.js";
+import { deleteProcess, insertProcess, listProcesses } from "./process-rows.js";
+// The main thread's long-lived processes (plan 02 §2.16). They outlive jobs and hot reloads, so they belong to the
+// main thread, not to a worker. One that exits by itself triggers `kernel.process.exited`.
+export const stopGraceMs = 5000;
+const keyOf = (extension, workspaceId, name) => JSON.stringify([extension, workspaceId, name]);
+function started(child) {
+    return new Promise((resolve, reject) => {
+        child.once('spawn', () => (child.pid === undefined ? reject(new Error('the process has no pid')) : resolve(child.pid)));
+        child.once('error', reject);
+    });
+}
+export function createProcessService(options) {
+    const { connection, platform } = options;
+    const running = new Map();
+    const starting = new Set();
+    const signal = (entry, stopSignal) => carryOut(killPlan(platform, entry.row.pid, stopSignal));
+    const launch = async (workspace, row, start) => {
+        const cwd = start.cwd === undefined ? workspace.path : path.resolve(workspace.path, start.cwd);
+        const logFile = processLogPath(options.home, row.extension, row.workspaceId, row.name);
+        const log = openProcessLog(logFile);
+        const child = spawn(start.command, start.args, { cwd, env: { ...process.env, ...start.env }, stdio: ['ignore', 'pipe', 'pipe'], ...spawnOptionsFor(platform) });
+        child.stdout?.on('data', (chunk) => log.write(chunk));
+        child.stderr?.on('data', (chunk) => log.write(chunk));
+        let pid;
+        try {
+            pid = await started(child);
+        }
+        catch (error) {
+            log.close();
+            rmSync(logFile, { force: true });
+            const reason = error instanceof Error ? error.message : String(error);
+            throw kernelProblem('VALIDATION_FAILED', `The process ${row.name} can't start (${reason}).`, { name: row.name });
+        }
+        child.on('error', (error) => options.logger.error('A long-lived process failed.', { extension: row.extension, name: row.name, error: error.message }));
+        const entry = { row: { ...row, pid, startedAt: isoTime(options.clock) }, child, stopping: false, closed: Promise.resolve() };
+        entry.closed = new Promise((resolve) => {
+            child.once('close', (exitCode, exitSignal) => {
+                log.close();
+                running.delete(keyOf(row.extension, row.workspaceId, row.name));
+                options.deliverAlong((deliverIn) => {
+                    deleteProcess(connection, row);
+                    const exited = { extension: row.extension, workspaceId: row.workspaceId, name: row.name, exitCode, signal: exitSignal };
+                    if (!entry.stopping)
+                        deliverIn('kernel.process.exited', exited, row.workspaceId);
+                });
+                resolve();
+            });
+        });
+        return entry;
+    };
+    return {
+        async start(extension, workspace, name, start) {
+            const key = keyOf(extension, workspace.id, name);
+            if (running.has(key) || starting.has(key))
+                throw kernelProblem('PROCESS_RUNNING', `The process ${name} is already running.`, { name });
+            starting.add(key);
+            try {
+                const entry = await launch(workspace, { extension, workspaceId: workspace.id, name }, start);
+                running.set(key, entry);
+                insertProcess(connection, entry.row);
+                return { name, pid: entry.row.pid, startedAt: entry.row.startedAt };
+            }
+            finally {
+                starting.delete(key);
+            }
+        },
+        // Linux and macOS: SIGTERM to the group, then SIGKILL after 5 s (real time); Windows: taskkill at once.
+        async stop(extension, workspaceId, name) {
+            const entry = running.get(keyOf(extension, workspaceId, name));
+            if (entry === undefined)
+                throw kernelProblem('NOT_FOUND', `There is no running process ${name}.`, { name });
+            entry.stopping = true;
+            signal(entry, 'SIGTERM');
+            const escalation = setTimeout(() => signal(entry, 'SIGKILL'), stopGraceMs);
+            await entry.closed;
+            clearTimeout(escalation);
+        },
+        // kvman's stop: every process gets SIGTERM (or taskkill); `killAll` ends the rest at the budget's end.
+        terminateAll() {
+            for (const entry of running.values()) {
+                entry.stopping = true;
+                signal(entry, 'SIGTERM');
+            }
+        },
+        async killAll() {
+            for (const entry of running.values())
+                signal(entry, 'SIGKILL');
+            await Promise.all([...running.values()].map((entry) => entry.closed));
+        },
+        exited: async () => {
+            await Promise.all([...running.values()].map((entry) => entry.closed));
+        },
+        // Processes a crashed kvman left behind (plan 02 §2.16): each still alive is killed, and every row is cleared.
+        killLeftovers() {
+            for (const row of listProcesses(connection)) {
+                if (isAlive(row.pid))
+                    carryOut(killPlan(platform, row.pid, 'SIGKILL'));
+                deleteProcess(connection, row);
+            }
+        },
+    };
+}
+//# sourceMappingURL=process-service.js.map

package/dist/processes/process-service.js.map

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

package/dist/reload/reload-extensions.d.ts

@@ -0,0 +1,5 @@
+import type { Dispatcher } from '../jobs/dispatcher.ts';
+import type { KernelLogger } from '../logging/logger.ts';
+import type { ExtensionRun } from '../run/extension-run.ts';
+export declare function reloadExtensions(run: ExtensionRun, dispatcher: Dispatcher, logger: KernelLogger, changed: ReadonlySet<string>, stopWaiting: AbortSignal): Promise<void>;
+//# sourceMappingURL=reload-extensions.d.ts.map

package/dist/reload/reload-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-extensions.d.ts","sourceRoot":"","sources":["../../src/reload/reload-extensions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAU,MAAM,yBAAyB,CAAC;AAKpE,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7K"}

package/dist/reload/reload-extensions.js

@@ -0,0 +1,25 @@
+import { ProblemError } from '@kvman/sdk';
+import { runStartedHandlers } from "../kernel-lifecycle.js";
+// One hot reload (plan 02 §2.9, ADR 0009, 26): the new pool takes the jobs, each reloaded extension is logged with its
+// revision, and the `kernel.started` handlers of the reloaded extensions and their dependents run again. A reload that
+// fails is logged, and the previous code keeps serving.
+export async function reloadExtensions(run, dispatcher, logger, changed, stopWaiting) {
+    let reload;
+    try {
+        reload = await run.reload(changed);
+    }
+    catch (error) {
+        const code = error instanceof ProblemError ? error.problem.code : 'EXTENSION_INVALID';
+        const reason = error instanceof Error ? error.message : String(error);
+        for (const extension of changed)
+            logger.error('extension reload failed', { extension, code, reason });
+        return;
+    }
+    const pool = run.pool();
+    dispatcher.attach(pool, pool.summary.handlers);
+    for (const extension of reload.reloaded)
+        logger.info('extension reloaded', { extension: extension.name, revision: extension.revision });
+    const started = pool.summary.handlers.filter((handler) => handler.point === 'kernel.started').map((handler) => handler.extension);
+    void runStartedHandlers(dispatcher, logger, reload.startedAgain, started, stopWaiting);
+}
+//# sourceMappingURL=reload-extensions.js.map

package/dist/reload/reload-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-extensions.js","sourceRoot":"","sources":["../../src/reload/reload-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAI5D,uHAAuH;AACvH,uHAAuH;AACvH,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAiB,EAAE,UAAsB,EAAE,MAAoB,EAAE,OAA4B,EAAE,WAAwB;IAC5J,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,KAAK,YAAY,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACtF,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,KAAK,MAAM,SAAS,IAAI,OAAO;YAAE,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtG,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxI,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClI,KAAK,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AACzF,CAAC"}

package/dist/reload/watcher.d.ts

@@ -0,0 +1,7 @@
+import type { KernelLogger } from '../logging/logger.ts';
+export declare const reloadQuietMs = 200;
+export type ExtensionWatcher = {
+    close(): Promise<void>;
+};
+export declare function watchExtensions(folders: ReadonlyMap<string, string>, logger: KernelLogger, reload: (changed: ReadonlySet<string>) => Promise<void>): ExtensionWatcher;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/reload/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/reload/watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAM1D,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CA6BrK"}

package/dist/reload/watcher.js

@@ -0,0 +1,40 @@
+import { watch } from 'node:fs';
+// Watches the folders of `path:` extensions (plan 02 §2.9, ADR 0009, 26): events are batched until 200 ms pass without
+// one (real time: they are the file system's), `node_modules` is ignored, and one reload runs at a time.
+export const reloadQuietMs = 200;
+function insideNodeModules(filename) {
+    return filename !== null && filename.split(/[\\/]/).includes('node_modules');
+}
+export function watchExtensions(folders, logger, reload) {
+    const pending = new Set();
+    let timer;
+    let reloading = Promise.resolve();
+    let closed = false;
+    const flush = () => {
+        timer = undefined;
+        const changed = new Set(pending);
+        pending.clear();
+        reloading = reloading.then(() => (closed ? undefined : reload(changed)));
+    };
+    const watchers = [...folders].map(([name, folder]) => {
+        const watcher = watch(folder, { recursive: true }, (_event, filename) => {
+            if (closed || insideNodeModules(filename))
+                return;
+            pending.add(name);
+            clearTimeout(timer);
+            timer = setTimeout(flush, reloadQuietMs);
+        });
+        watcher.on('error', (error) => logger.warn('An extension folder can no longer be watched.', { extension: name, reason: error.message }));
+        return watcher;
+    });
+    return {
+        close: async () => {
+            closed = true;
+            clearTimeout(timer);
+            for (const watcher of watchers)
+                watcher.close();
+            await reloading;
+        },
+    };
+}
+//# sourceMappingURL=watcher.js.map

package/dist/reload/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/reload/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,uHAAuH;AACvH,yGAAyG;AAEzG,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAIjC,SAAS,iBAAiB,CAAC,QAAuB;IAChD,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAoC,EAAE,MAAoB,EAAE,MAAuD;IACjJ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,KAAiC,CAAC;IACtC,IAAI,SAAS,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACjD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,KAAK,GAAG,SAAS,CAAC;QAClB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;QACnD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YACtE,IAAI,MAAM,IAAI,iBAAiB,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAClD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzI,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,OAAO;QACL,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,GAAG,IAAI,CAAC;YACd,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAChD,MAAM,SAAS,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+import type { Preset } from '@kvman/sdk';
+import { type ExtensionFolders, type ReadExtension } from '../extensions/manifests.ts';
+import { type Catalogs, type OwnerCatalogs } from '../localization/catalogs.ts';
+import type { KernelLogger } from '../logging/logger.ts';
+import { type PoolOptions, type WorkerPool } from '../workers/pool.ts';
+import type { AbortReason } from '../workers/protocol.ts';
+export type RunExtension = ReadExtension & {
+    revision: number;
+    catalogs: OwnerCatalogs;
+};
+export type ExtensionRunOptions = {
+    preset: Preset;
+    folders: ExtensionFolders;
+    sdkVersion: string;
+    kernelCatalogs: OwnerCatalogs;
+    pool: Omit<PoolOptions, 'setup'> & {
+        setup: Omit<PoolOptions['setup'], 'extensions' | 'languages'>;
+    };
+    logger: KernelLogger;
+};
+export type Reload = {
+    reloaded: RunExtension[];
+    startedAgain: string[];
+};
+export type ExtensionRun = Awaited<ReturnType<typeof startExtensionRun>>;
+export declare function startExtensionRun(options: ExtensionRunOptions): Promise<{
+    pool: () => WorkerPool;
+    extensions: () => readonly RunExtension[];
+    catalogs: () => Catalogs;
+    folders: () => ReadonlyMap<string, string>;
+    reload(changed: ReadonlySet<string>): Promise<Reload>;
+    abortAll: (reason: AbortReason) => void;
+    idle: () => Promise<void>;
+    close: () => Promise<void>;
+}>;
+//# sourceMappingURL=extension-run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-run.d.ts","sourceRoot":"","sources":["../../src/run/extension-run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAiC,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtH,OAAO,EAAoC,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1D,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,aAAa,CAAC;IAC9B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC,CAAA;KAAE,CAAC;IACrG,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAIF,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAU1E,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAEzE,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB;gBAiCtD,UAAU;sBACJ,SAAS,YAAY,EAAE;oBACzB,QAAQ;mBACT,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;oBAElB,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;uBAqBxC,WAAW,KAAG,IAAI;gBAGrB,OAAO,CAAC,IAAI,CAAC;iBAGZ,OAAO,CAAC,IAAI,CAAC;GAIjC"}