@wenathlan/saddle 1.8.7 → 1.8.9

package/dist/queue/idempotency.js

@@ -0,0 +1,13 @@
+/**
+ * idempotency keys prevent duplicate delivery from at least once transports.
+ */
+export function idempotency() {
+    const results = new Map();
+    return {
+        has(key) { return results.has(key); },
+        get(key) { return results.get(key); },
+        set(key, value) { results.set(key, value); return value; },
+        delete(key) { results.delete(key); }
+    };
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/queue/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../queue/idempotency.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC1B,OAAO;QACL,GAAG,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrC,GAAG,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/queue/persistent.d.ts

@@ -0,0 +1,13 @@
+/** Creates a crash recoverable queue with idempotent item identifiers. */
+export declare function persistentqueue(options?: {}): {
+    restore: () => Promise<{
+        version: number;
+        items: any[];
+    }>;
+    enqueue: (payload: any, metadata?: {}) => Promise<any>;
+    claim: () => Promise<any>;
+    complete: (id: any, result: any) => Promise<any>;
+    fail: (id: any, error: any) => Promise<any>;
+    list: (filter: any) => Promise<any[]>;
+};
+//# sourceMappingURL=persistent.d.ts.map

package/dist/queue/persistent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent.d.ts","sourceRoot":"","sources":["../../queue/persistent.ts"],"names":[],"mappings":"AAMA,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,OAAO,KAAK;;;;;;;;;;EAoC3C"}

package/dist/queue/persistent.js

@@ -0,0 +1,49 @@
+/**
+ * persistent queue stores job state in a caller selected file.
+ * running items return to queued when a process restores after a crash.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+/** Creates a crash recoverable queue with idempotent item identifiers. */
+export function persistentqueue(options = {}) {
+    if (!options.path)
+        throw new TypeError("persistent queue requires path");
+    const maxattempts = options.maxattempts ?? 3;
+    let state = { version: 1, items: [] };
+    let loaded = false;
+    /** Reads the queue once and returns running jobs to the waiting state. */
+    async function restore() {
+        if (loaded)
+            return state;
+        try {
+            state = JSON.parse(await readFile(options.path, "utf8"));
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        for (const item of state.items ?? [])
+            if (item.status === "running")
+                item.status = "queued";
+        state.items ??= [];
+        loaded = true;
+        await persist();
+        return state;
+    }
+    /** Appends a queued job and persists the new state. */
+    async function enqueue(payload, metadata = {}) { await restore(); const id = metadata.id ?? `persistentjob${Date.now()}${state.items.length}`; if (state.items.some((item) => item.id === id))
+        return state.items.find((item) => item.id === id); const item = { id, payload, status: "queued", attempts: 0, createdat: Date.now(), updatedat: Date.now(), metadata }; state.items.push(item); await persist(); return { ...item }; }
+    /** Claims the first queued job with stable ordering. */
+    async function claim() { await restore(); const item = state.items.find((entry) => entry.status === "queued"); if (!item)
+        return null; item.status = "running"; item.attempts += 1; item.updatedat = Date.now(); await persist(); return { ...item }; }
+    /** Commits a successful result. */
+    async function complete(id, result) { await restore(); const item = find(id); item.status = "completed"; item.result = result; item.updatedat = Date.now(); await persist(); return { ...item }; }
+    /** Records an error and either retries or closes the item as failed. */
+    async function fail(id, error) { await restore(); const item = find(id); item.error = { message: error?.message ?? String(error), code: error?.code }; item.status = item.attempts < maxattempts && error?.retryable !== false ? "queued" : "failed"; item.updatedat = Date.now(); await persist(); return { ...item }; }
+    /** Lists queue items for status and diagnostics. */
+    async function list(filter) { await restore(); return state.items.filter((item) => !filter || item.status === filter).map((item) => ({ ...item })); }
+    return { restore, enqueue, claim, complete, fail, list };
+    function find(id) { const item = state.items.find((entry) => entry.id === id); if (!item)
+        throw new Error(`persistent queue item not found: ${id}`); return item; }
+    async function persist() { await writeFile(options.path, `${JSON.stringify(state, null, 2)}\n`, "utf8"); }
+}
+//# sourceMappingURL=persistent.js.map

package/dist/queue/persistent.js.map

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

package/dist/queue/queue.d.ts

@@ -0,0 +1,7 @@
+export declare function jobqueue(options?: {}): {
+    add(payload: any, handler: any, options?: {}): Promise<unknown>;
+    size(): number;
+    active(): number;
+    idle(): Promise<void>;
+};
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../queue/queue.ts"],"names":[],"mappings":"AAKA,wBAAgB,QAAQ,CAAC,OAAO,KAAK;;;;;EA0CpC"}

package/dist/queue/queue.js

@@ -0,0 +1,55 @@
+/**
+ * job queue groups concurrency retry timeout and idempotency at one boundary.
+ */
+import { idempotency } from "./idempotency.js";
+export function jobqueue(options = {}) {
+    const limit = options.concurrency ?? 1;
+    const attempts = options.maxattempts ?? 3;
+    const retryall = options.retryall ?? false;
+    const keys = options.idempotency ?? idempotency();
+    const pending = [];
+    let active = 0;
+    let sequence = 0;
+    async function drain() {
+        while (active < limit && pending.length) {
+            const item = pending.shift();
+            active += 1;
+            execute(item).then(item.resolve, item.reject).finally(() => { active -= 1; void drain(); });
+        }
+    }
+    async function execute(item) {
+        if (item.key && keys.has(item.key))
+            return keys.get(item.key);
+        let last;
+        for (let attempt = 1; attempt <= attempts; attempt += 1) {
+            try {
+                const result = await item.handler({ id: item.id, payload: item.payload, attempt });
+                if (item.key)
+                    keys.set(item.key, result);
+                return result;
+            }
+            catch (error) {
+                last = error;
+                const retryable = retryall || error?.retryable === true || error?.code === "RUNNER_UNAVAILABLE";
+                if (!retryable || attempt === attempts)
+                    throw error;
+                await delay((options.backoff ?? 250) * 2 ** (attempt - 1));
+            }
+        }
+        throw last;
+    }
+    return {
+        add(payload, handler, options = {}) {
+            if (typeof handler !== "function")
+                return Promise.reject(new TypeError("queue handler is required"));
+            const id = options.id ?? `queuejob${sequence++}`;
+            return new Promise((resolve, reject) => { pending.push({ id, payload, handler, key: options.key, resolve, reject }); void drain(); });
+        },
+        size() { return pending.length; },
+        active() { return active; },
+        async idle() { while (pending.length || active)
+            await delay(10); }
+    };
+}
+function delay(milliseconds) { return new Promise((resolve) => setTimeout(resolve, milliseconds)); }
+//# sourceMappingURL=queue.js.map

package/dist/queue/queue.js.map

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

package/dist/queue/saga.d.ts

@@ -0,0 +1,5 @@
+/**
+ * saga executes compensations in reverse order when a multi step operation fails.
+ */
+export declare function saga(steps: any, context?: {}): Promise<any[]>;
+//# sourceMappingURL=saga.d.ts.map

package/dist/queue/saga.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saga.d.ts","sourceRoot":"","sources":["../../queue/saga.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,IAAI,CAAC,KAAK,KAAA,EAAE,OAAO,KAAK,kBAS7C"}

package/dist/queue/saga.js

@@ -0,0 +1,20 @@
+/**
+ * saga executes compensations in reverse order when a multi step operation fails.
+ */
+export async function saga(steps, context = {}) {
+    const completed = [];
+    try {
+        for (const step of steps) {
+            const value = await step.run(context);
+            completed.push({ step, value });
+        }
+        return completed.map((item) => item.value);
+    }
+    catch (error) {
+        for (const item of completed.reverse())
+            if (typeof item.step.compensate === "function")
+                await item.step.compensate(context, item.value);
+        throw error;
+    }
+}
+//# sourceMappingURL=saga.js.map

package/dist/queue/saga.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saga.js","sourceRoot":"","sources":["../../queue/saga.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE;IAC5C,MAAM,SAAS,GAAG,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAAC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,CAAC;QACrG,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,OAAO,EAAE;YAAE,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,UAAU;gBAAE,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxI,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/release/assets.d.ts

@@ -0,0 +1,118 @@
+/**
+ * release assets create deterministic checksums, SBOM data and provenance statements.
+ * The adapter reads caller-selected artifacts and never publishes or handles credentials.
+ */
+/** Builds deterministic release metadata files for caller-selected artifacts. */
+export declare function createassets(options?: {}): Promise<{
+    output: string;
+    files: {
+        checksums: string;
+        sbom: string;
+        provenance: string;
+    };
+    subjects: {
+        name: string;
+        digest: string;
+    }[];
+    sbom: {
+        bomFormat: string;
+        specVersion: string;
+        serialNumber: string;
+        version: number;
+        metadata: {
+            component: {
+                type: string;
+                name: string;
+                version: string;
+            };
+        };
+        components: {
+            "bom-ref": string;
+            name: string;
+            version: string;
+            purl: string;
+            scope: string;
+            type: string;
+        }[];
+    };
+    provenance: {
+        _type: string;
+        subject: {
+            name: string;
+            digest: {
+                sha256: string;
+            };
+        }[];
+        predicateType: string;
+        predicate: {
+            buildDefinition: {
+                buildType: string;
+                externalParameters: {
+                    package: string;
+                    version: string;
+                };
+                internalParameters: {};
+            };
+            runDetails: {
+                builder: {
+                    id: string;
+                };
+                metadata: {
+                    invocationId: string;
+                };
+            };
+        };
+    };
+}>;
+/** Creates a compact CycloneDX component list from the root lockfile dependencies. */
+export declare function createsbom(packagejson: any, lockjson?: {}): {
+    bomFormat: string;
+    specVersion: string;
+    serialNumber: string;
+    version: number;
+    metadata: {
+        component: {
+            type: string;
+            name: string;
+            version: string;
+        };
+    };
+    components: {
+        "bom-ref": string;
+        name: string;
+        version: string;
+        purl: string;
+        scope: string;
+        type: string;
+    }[];
+};
+/** Creates an in-toto statement whose subjects are the caller-selected release artifacts. */
+export declare function createprovenance(packagejson: any, subjects?: any[], options?: {}): {
+    _type: string;
+    subject: {
+        name: string;
+        digest: {
+            sha256: string;
+        };
+    }[];
+    predicateType: string;
+    predicate: {
+        buildDefinition: {
+            buildType: string;
+            externalParameters: {
+                package: string;
+                version: string;
+            };
+            internalParameters: {};
+        };
+        runDetails: {
+            builder: {
+                id: string;
+            };
+            metadata: {
+                invocationId: string;
+            };
+        };
+    };
+};
+//# sourceMappingURL=assets.d.ts.map

package/dist/release/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../release/assets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,iFAAiF;AACjF,wBAAsB,YAAY,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;YA6BsH,SAAS;gBAAI,IAAI;gBAAiB,IAAI;gBAA4B,OAAO;;;;;;;;;;;;;;;;;gBAKtJ,MAAM;;;;;YAC0C,eAAe;gBAAI,SAAS;gBAAiD,kBAAkB;oBAAI,OAAO;oBAA4B,OAAO;;gBAAoD,kBAAkB;;YAAQ,UAAU;gBAAI,OAAO;oBAAI,EAAE;;gBAAiD,QAAQ;oBAAI,YAAY;;;;;GAjBtc;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,WAAW,KAAA,EAAE,QAAQ,KAAK;;;;;;QAQgH,SAAS;YAAI,IAAI;YAAiB,IAAI;YAA4B,OAAO;;;;;;;;;;;EAC7O;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,WAAW,KAAA,EAAE,QAAQ,QAAK,EAAE,OAAO,KAAK;IAE9D,KAAK;IAAqC,OAAO;;;YAD4B,MAAM;;;IACpB,aAAa;IAAoC,SAAS;QAAI,eAAe;YAAI,SAAS;YAAiD,kBAAkB;gBAAI,OAAO;gBAA4B,OAAO;;YAAoD,kBAAkB;;QAAQ,UAAU;YAAI,OAAO;gBAAI,EAAE;;YAAiD,QAAQ;gBAAI,YAAY;;;;EACtc"}

package/dist/release/assets.js

@@ -0,0 +1,69 @@
+/**
+ * release assets create deterministic checksums, SBOM data and provenance statements.
+ * The adapter reads caller-selected artifacts and never publishes or handles credentials.
+ */
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const rootpath = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+/** Builds deterministic release metadata files for caller-selected artifacts. */
+export async function createassets(options = {}) {
+    const packagefile = resolve(options.packagefile ?? join(rootpath, "package.json"));
+    const lockfile = resolve(options.lockfile ?? join(rootpath, "package-lock.json"));
+    const output = resolve(options.output ?? join(rootpath, "build", "release"));
+    const artifactroot = resolve(options.artifactroot ?? rootpath);
+    const packagejson = JSON.parse(await readFile(packagefile, "utf8"));
+    const lockjson = JSON.parse(await readFile(lockfile, "utf8"));
+    const artifacts = [...new Set((options.artifacts ?? []).map((artifact) => resolve(String(artifact))))].sort();
+    const subjects = await Promise.all(artifacts.map(async (artifact) => ({ name: relative(artifactroot, artifact).replaceAll("\\", "/"), digest: await sha256(artifact) })));
+    await mkdir(output, { recursive: true });
+    const checksums = `${subjects.map((subject) => `${subject.digest}  ${subject.name}`).join("\n")}${subjects.length ? "\n" : ""}`;
+    const sbom = createsbom(packagejson, lockjson);
+    const provenance = createprovenance(packagejson, subjects, options);
+    const files = { checksums: join(output, "SHA256SUMS"), sbom: join(output, "sbom.cdx.json"), provenance: join(output, "provenance.intoto.jsonl") };
+    await writeFile(files.checksums, checksums);
+    await writeFile(files.sbom, `${JSON.stringify(sbom, null, 2)}\n`);
+    await writeFile(files.provenance, `${JSON.stringify(provenance)}\n`);
+    return { output, files, subjects, sbom, provenance };
+}
+/** Creates a compact CycloneDX component list from the root lockfile dependencies. */
+export function createsbom(packagejson, lockjson = {}) {
+    const root = lockjson.packages?.[""] ?? {};
+    const dependencies = { ...(root.dependencies ?? {}), ...(root.devDependencies ?? {}) };
+    const components = Object.keys(dependencies).map((name) => {
+        const entry = lockjson.packages?.[`node_modules/${name}`] ?? {};
+        const version = String(entry.version ?? dependencies[name]).replace(/^[^0-9]*/, "");
+        return { "bom-ref": `pkg:npm/${name}@${version}`, name, version, purl: `pkg:npm/${name}@${version}`, scope: root.devDependencies?.[name] ? "optional" : "required", type: "library" };
+    }).sort((left, right) => left.name.localeCompare(right.name));
+    return { bomFormat: "CycloneDX", specVersion: "1.5", serialNumber: `urn:uuid:${stableuuid(`${packagejson.name}@${packagejson.version}`)}`, version: 1, metadata: { component: { type: "application", name: String(packagejson.name), version: String(packagejson.version) } }, components };
+}
+/** Creates an in-toto statement whose subjects are the caller-selected release artifacts. */
+export function createprovenance(packagejson, subjects = [], options = {}) {
+    const normalized = subjects.map((subject) => ({ name: String(subject.name), digest: { sha256: String(subject.digest) } })).sort((left, right) => left.name.localeCompare(right.name));
+    return { _type: "https://in-toto.io/Statement/v1", subject: normalized, predicateType: "https://slsa.dev/provenance/v1", predicate: { buildDefinition: { buildType: String(options.buildtype ?? "caller-defined"), externalParameters: { package: String(packagejson.name), version: String(options.version ?? packagejson.version) }, internalParameters: {} }, runDetails: { builder: { id: String(options.builder ?? "caller-defined") }, metadata: { invocationId: stableuuid(`${packagejson.name}@${options.version ?? packagejson.version}:${normalized.map((subject) => subject.name).join(",")}`) } } } };
+}
+async function sha256(path) { const hash = createHash("sha256"); hash.update(await readFile(path)); return hash.digest("hex"); }
+function stableuuid(value) { const hex = createHash("sha256").update(String(value)).digest("hex").slice(0, 32); return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(13, 16)}-${(8 + (Number.parseInt(hex.slice(16, 17), 16) % 4).toString(16))}${hex.slice(17, 20)}-${hex.slice(20)}`; }
+function parsearguments(argumentslist) {
+    const options = { artifacts: [] };
+    for (let index = 0; index < argumentslist.length; index += 1) {
+        const argument = argumentslist[index];
+        if (argument === "--output")
+            options.output = argumentslist[++index];
+        else if (argument === "--version")
+            options.version = argumentslist[++index];
+        else if (argument === "--artifact")
+            options.artifacts.push(argumentslist[++index]);
+        else if (argument === "--build-type")
+            options.buildtype = argumentslist[++index];
+        else if (argument === "--builder")
+            options.builder = argumentslist[++index];
+        else
+            throw new TypeError(`unsupported release asset argument: ${argument}`);
+    }
+    return options;
+}
+if (process.argv[1] === fileURLToPath(import.meta.url))
+    createassets(parsearguments(process.argv.slice(2))).then(({ output }) => { console.log(`release assets: ${output}`); }).catch((error) => { console.error(error.message); process.exitCode = 1; });
+//# sourceMappingURL=assets.js.map

package/dist/release/assets.js.map

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

package/dist/runners/health.d.ts

@@ -0,0 +1,36 @@
+/**
+ * runner health checks describe provider capacity without selecting infrastructure.
+ */
+/** Checks provider readiness and returns a serializable health report. */
+export declare function runnerhealth(provider: any, job?: {}): Promise<{
+    id: string;
+    status: any;
+    healthy: boolean;
+    checkedat: number;
+    capacity: {
+        maxconcurrent: any;
+        capabilities: any[];
+    };
+    error?: undefined;
+} | {
+    id: string;
+    status: string;
+    healthy: boolean;
+    checkedat: number;
+    capacity: {
+        maxconcurrent: any;
+        capabilities: any[];
+    };
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/** Checks a provider list in stable order and summarizes available capacity. */
+export declare function runnerhealthall(providers?: any[], job?: {}): Promise<{
+    checkedat: number;
+    reports: any[];
+    available: number;
+    total: number;
+}>;
+//# sourceMappingURL=health.d.ts.map

package/dist/runners/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../runners/health.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0EAA0E;AAC1E,wBAAsB,YAAY,CAAC,QAAQ,KAAA,EAAE,GAAG,KAAK;;;;;;QAKkH,aAAa;QAA4B,YAAY;;;;;;;;;QAE9G,aAAa;QAA4B,YAAY;;;QAAmD,IAAI;QAAgD,OAAO;;GAEhR;AAED,gFAAgF;AAChF,wBAAsB,eAAe,CAAC,SAAS,QAAK,EAAE,GAAG,KAAK;;;;;GAK7D"}

package/dist/runners/health.js

@@ -0,0 +1,26 @@
+/**
+ * runner health checks describe provider capacity without selecting infrastructure.
+ */
+/** Checks provider readiness and returns a serializable health report. */
+export async function runnerhealth(provider, job = {}) {
+    if (typeof provider?.descriptor !== "function" || typeof provider?.canrun !== "function")
+        throw new TypeError("runner health requires a provider");
+    const descriptor = provider.descriptor();
+    try {
+        const available = await provider.canrun(job);
+        return { id: String(descriptor.id), status: available ? descriptor.status ?? "available" : "busy", healthy: Boolean(available), checkedat: Date.now(), capacity: { maxconcurrent: descriptor.maxconcurrent, capabilities: [...(descriptor.capabilities ?? [])] } };
+    }
+    catch (error) {
+        return { id: String(descriptor.id), status: "offline", healthy: false, checkedat: Date.now(), capacity: { maxconcurrent: descriptor.maxconcurrent, capabilities: [...(descriptor.capabilities ?? [])] }, error: { code: String(error.code ?? "RUNNER_HEALTH_FAILED"), message: String(error.message ?? error) } };
+    }
+}
+/** Checks a provider list in stable order and summarizes available capacity. */
+export async function runnerhealthall(providers = [], job = {}) {
+    if (!Array.isArray(providers))
+        throw new TypeError("runner health providers must be an array");
+    const reports = [];
+    for (const provider of providers)
+        reports.push(await runnerhealth(provider, job));
+    return { checkedat: Date.now(), reports, available: reports.filter((report) => report.healthy).length, total: reports.length };
+}
+//# sourceMappingURL=health.js.map

package/dist/runners/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../runners/health.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,EAAE;IACnD,IAAI,OAAO,QAAQ,EAAE,UAAU,KAAK,UAAU,IAAI,OAAO,QAAQ,EAAE,MAAM,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACnJ,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,aAAa,EAAE,UAAU,CAAC,aAAa,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACrQ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,aAAa,EAAE,UAAU,CAAC,aAAa,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,sBAAsB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IACpT,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAS,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAClF,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACjI,CAAC"}

package/dist/runners/heartbeat.d.ts

@@ -0,0 +1,23 @@
+/**
+ * heartbeat manages cooperative liveness signals for long-running local or remote jobs.
+ */
+/** Creates a heartbeat controller with manual ticks and optional interval execution. */
+export declare function heartbeat(options?: {}): {
+    tick: (input?: {}) => Promise<{
+        id: string;
+        sequence: number;
+        at: number;
+        status: string;
+        metadata: any;
+    }>;
+    on: (listener: any) => () => boolean;
+    start: (input?: {}) => boolean;
+    stop: () => boolean;
+    status: () => {
+        running: boolean;
+        interval: number;
+        sequence: number;
+        last: any;
+    };
+};
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/runners/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../runners/heartbeat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;EAoBrC"}

package/dist/runners/heartbeat.js

@@ -0,0 +1,29 @@
+/**
+ * heartbeat manages cooperative liveness signals for long-running local or remote jobs.
+ */
+/** Creates a heartbeat controller with manual ticks and optional interval execution. */
+export function heartbeat(options = {}) {
+    const interval = Number(options.interval ?? 30000);
+    if (!Number.isFinite(interval) || interval < 1)
+        throw new TypeError("heartbeat interval must be positive");
+    let timer;
+    let sequence = 0;
+    let last;
+    const listeners = new Set();
+    async function tick(input = {}) {
+        const signal = { id: String(input.id ?? options.id ?? "job"), sequence: ++sequence, at: Date.now(), status: String(input.status ?? "running"), metadata: { ...(input.metadata ?? {}) } };
+        last = signal;
+        for (const listener of listeners)
+            await listener({ ...signal, metadata: { ...signal.metadata } });
+        return signal;
+    }
+    function on(listener) { if (typeof listener !== "function")
+        throw new TypeError("heartbeat listener must be a function"); listeners.add(listener); return () => listeners.delete(listener); }
+    function start(input = {}) { if (timer)
+        return false; const run = () => tick(input).catch(() => undefined); timer = setInterval(run, interval); return true; }
+    function stop() { if (!timer)
+        return false; clearInterval(timer); timer = undefined; return true; }
+    function status() { return { running: Boolean(timer), interval, sequence, last: last ? { ...last, metadata: { ...last.metadata } } : undefined }; }
+    return { tick, on, start, stop, status };
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/runners/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../runners/heartbeat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,OAAO,GAAG,EAAE;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC3G,IAAI,KAAK,CAAC;IACV,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,CAAC;IACT,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAE5B,KAAK,UAAU,IAAI,CAAC,KAAK,GAAG,EAAE;QAC5B,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACzL,IAAI,GAAG,MAAM,CAAC;QACd,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,MAAM,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClG,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,EAAE,CAAC,QAAQ,IAAI,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7L,SAAS,KAAK,CAAC,KAAK,GAAG,EAAE,IAAI,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC9J,SAAS,IAAI,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACnG,SAAS,MAAM,KAAK,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACnJ,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC"}

package/dist/runners/inprocess.d.ts

@@ -0,0 +1,17 @@
+/**
+ * the in process runner is the deterministic baseline for local execution.
+ */
+export declare function inprocess(options?: {}): {
+    descriptor(): {
+        id: any;
+        name: any;
+        priority: any;
+        maxconcurrent: any;
+        capabilities: any;
+        status: string;
+    };
+    setavailable(value: any): void;
+    canrun(): Promise<boolean>;
+    execute(context: any, handler: any): Promise<any>;
+};
+//# sourceMappingURL=inprocess.d.ts.map

package/dist/runners/inprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inprocess.d.ts","sourceRoot":"","sources":["../../runners/inprocess.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,KAAK;;;;;;;;;;;;EAerC"}

package/dist/runners/inprocess.js

@@ -0,0 +1,20 @@
+/**
+ * the in process runner is the deterministic baseline for local execution.
+ */
+export function inprocess(options = {}) {
+    let available = options.status !== "offline";
+    const runner = {
+        id: options.id ?? "runnerlocal",
+        name: options.name ?? "local in process runner",
+        priority: options.priority ?? 0,
+        maxconcurrent: options.maxconcurrent ?? 1,
+        capabilities: options.capabilities ?? ["node", "local"]
+    };
+    return {
+        descriptor() { return { ...runner, status: available ? "available" : "offline" }; },
+        setavailable(value) { available = Boolean(value); },
+        async canrun() { return available; },
+        async execute(context, handler) { return handler(context); }
+    };
+}
+//# sourceMappingURL=inprocess.js.map

package/dist/runners/inprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inprocess.js","sourceRoot":"","sources":["../../runners/inprocess.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAO,GAAG,EAAE;IACpC,IAAI,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;IAC7C,MAAM,MAAM,GAAG;QACb,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,aAAa;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,yBAAyB;QAC/C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;QAC/B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC;QACzC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;KACxD,CAAC;IACF,OAAO;QACL,UAAU,KAAK,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACnF,YAAY,CAAC,KAAK,IAAI,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnD,KAAK,CAAC,MAAM,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/runners/scheduler.d.ts

@@ -0,0 +1,5 @@
+export declare function scheduler(providers: any): {
+    select(job: any): Promise<any>;
+    list(): any[];
+};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/runners/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../runners/scheduler.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,CAAC,SAAS,KAAA;;;EAUlC"}

package/dist/runners/scheduler.js

@@ -0,0 +1,19 @@
+/**
+ * scheduling uses stable priority order and selects the first available runner.
+ */
+import { runnerunavailable } from "../core/errors.js";
+export function scheduler(providers) {
+    if (!Array.isArray(providers) || providers.length === 0)
+        throw new TypeError("scheduler requires providers");
+    const ordered = [...providers].sort((left, right) => left.descriptor().priority - right.descriptor().priority);
+    return {
+        async select(job) {
+            for (const provider of ordered)
+                if (provider.descriptor().status === "available" && await provider.canrun(job))
+                    return provider;
+            throw runnerunavailable(job.id);
+        },
+        list() { return [...ordered]; }
+    };
+}
+//# sourceMappingURL=scheduler.js.map