@wenathlan/saddle 1.8.14 → 1.8.16

package/dist/memory/planner.d.ts

@@ -0,0 +1,66 @@
+/**
+ * working-set planning keeps host memory operations declarative and caller-executed.
+ */
+/** Validates a serializable working-set capacity budget. */
+export declare function workingbudget(input?: {}): Readonly<{
+    maxbytes: number;
+    maxentries: number;
+    maxage: number;
+}>;
+/** Selects bounded working-set candidates without materializing data or probing a host. */
+export declare function workingadmission(items: any, options?: {}): Readonly<{
+    version: 1;
+    policy: any;
+    budget: Readonly<{
+        maxbytes: number;
+        maxentries: number;
+        maxage: number;
+    }>;
+    usedbytes: number;
+    admitted: readonly any[];
+    deferred: readonly any[];
+}>;
+/** Produces a host bridge plan that an explicit privileged adapter may execute. */
+export declare function bridgeplan(input?: {}): Readonly<{
+    version: 1;
+    operation: string;
+    sizebytes: number;
+    state: "caller-executes" | "unsupported";
+    preconditions: readonly string[];
+    cleanup: Readonly<{
+        required: boolean;
+        owner: "caller";
+    }>;
+}>;
+/** Validates a materialized object record without reading storage or the local filesystem. */
+export declare function materializationrecord(input?: {}): Readonly<{
+    version: 1;
+    id: string;
+    sha256: string;
+    sizebytes: number;
+    tier: any;
+    state: any;
+    createdat: number;
+}>;
+/** Tracks materialization transitions and emits caller-owned cleanup plans without deleting resources. */
+export declare function materializationledger(input?: {}): Readonly<{
+    add: (record: any) => Readonly<{
+        version: 1;
+        id: string;
+        sha256: string;
+        sizebytes: number;
+        tier: any;
+        state: any;
+        createdat: number;
+    }>;
+    transition: (id: any, state: any) => any;
+    cleanupplan: (id: any) => Readonly<{
+        version: 1;
+        id: any;
+        sha256: any;
+        state: "caller-cleans";
+        reason: "already-cleaned" | "release-working-set";
+    }>;
+    list: () => readonly any[];
+}>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/memory/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../memory/planner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,KAAK;;;;GAEvC;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,KAAK,KAAA,EAAE,OAAO,KAAK;;;;;;;;;;;GAkBnD;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,KAAK,KAAK;;;;;;;;;;GAOpC;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,KAAK;;;;;;;;GAM/C;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,KAAK,KAAK;;;;;;;;;;;;;;;;;;;GAO/C"}

package/dist/memory/planner.js

@@ -0,0 +1,108 @@
+/**
+ * working-set planning keeps host memory operations declarative and caller-executed.
+ */
+/** Validates a serializable working-set capacity budget. */
+export function workingbudget(input = {}) {
+    return Object.freeze({ maxbytes: limit(input.maxbytes, "working-set maxbytes"), maxentries: limit(input.maxentries, "working-set maxentries"), maxage: optionalnonnegative(input.maxage, "working-set maxage") });
+}
+/** Selects bounded working-set candidates without materializing data or probing a host. */
+export function workingadmission(items, options = {}) {
+    if (!Array.isArray(items))
+        throw new TypeError("working-set items must be an array");
+    const budget = workingbudget(options.budget);
+    const now = Number(options.now ?? Date.now());
+    if (!Number.isFinite(now) || now < 0)
+        throw new TypeError("working-set now is invalid");
+    const policy = validpolicy(options.policy ?? "lru");
+    const normalized = normalizeitems(items);
+    const admitted = [];
+    const deferred = [];
+    let usedbytes = 0;
+    for (const item of rank(normalized, policy)) {
+        const expired = item.expiresat !== null && item.expiresat <= now;
+        const overbytes = usedbytes + item.sizebytes > budget.maxbytes;
+        const overentries = admitted.length >= budget.maxentries;
+        if (expired || overbytes || overentries)
+            deferred.push(Object.freeze({ ...item, reason: expired ? "expired" : overbytes ? "bytebudget" : "entrybudget" }));
+        else {
+            admitted.push(item);
+            usedbytes += item.sizebytes;
+        }
+    }
+    return Object.freeze({ version: 1, policy, budget, usedbytes, admitted: Object.freeze(admitted), deferred: Object.freeze(deferred) });
+}
+/** Produces a host bridge plan that an explicit privileged adapter may execute. */
+export function bridgeplan(input = {}) {
+    const operation = String(input.operation ?? "");
+    if (!bridgeoperations.includes(operation))
+        throw new TypeError("working-set bridge operation is invalid");
+    const sizebytes = positive(input.sizebytes, "working-set bridge sizebytes");
+    const capabilities = new Set(Array.isArray(input.capabilities) ? input.capabilities.map((value) => String(value)) : []);
+    const supported = capabilities.has(operation);
+    return Object.freeze({ version: 1, operation, sizebytes, state: supported ? "caller-executes" : "unsupported", preconditions: Object.freeze(supported ? ["explicit-consent", "host-adapter", "rollback-plan", "capacity-check"] : []), cleanup: Object.freeze({ required: supported, owner: "caller" }) });
+}
+/** Validates a materialized object record without reading storage or the local filesystem. */
+export function materializationrecord(input = {}) {
+    const id = String(input.id ?? "");
+    const sha256 = String(input.sha256 ?? "").toLowerCase();
+    if (!id)
+        throw new TypeError("working-set materialization id is required");
+    if (!/^[a-f0-9]{64}$/.test(sha256))
+        throw new TypeError("working-set materialization sha256 is invalid");
+    return Object.freeze({ version: 1, id, sha256, sizebytes: positive(input.sizebytes, "working-set materialization sizebytes"), tier: validtier(input.tier ?? "l3"), state: validstate(input.state ?? "planned"), createdat: nonnegative(input.createdat ?? Date.now(), "working-set materialization createdat") });
+}
+/** Tracks materialization transitions and emits caller-owned cleanup plans without deleting resources. */
+export function materializationledger(input = {}) {
+    const records = new Map();
+    const clock = typeof input.clock === "function" ? input.clock : () => Date.now();
+    function add(record) { const normalized = materializationrecord(record); if (records.has(normalized.id))
+        throw new TypeError(`working-set materialization id is duplicated: ${normalized.id}`); records.set(normalized.id, normalized); return normalized; }
+    function transition(id, state) { const current = records.get(String(id)); if (!current)
+        throw new TypeError("working-set materialization is unknown"); const next = validstate(state); if (!allowedtransition(current.state, next))
+        throw new TypeError(`working-set materialization transition is invalid: ${current.state} to ${next}`); const output = Object.freeze({ ...current, state: next, updatedat: nonnegative(clock(), "working-set materialization updatedat") }); records.set(output.id, output); return output; }
+    function cleanupplan(id) { const current = records.get(String(id)); if (!current)
+        throw new TypeError("working-set materialization is unknown"); return Object.freeze({ version: 1, id: current.id, sha256: current.sha256, state: "caller-cleans", reason: current.state === "cleaned" ? "already-cleaned" : "release-working-set" }); }
+    return Object.freeze({ add, transition, cleanupplan, list: () => Object.freeze([...records.values()]) });
+}
+const bridgeoperations = Object.freeze(["temporaryfile", "mmap", "tmpfs", "zram", "swap"]);
+const policies = new Set(["lru", "sizeaware", "ttlfirst"]);
+const tiers = new Set(["l1", "l2", "l3", "l4"]);
+const states = new Set(["planned", "prepared", "verified", "released", "cleaned", "failed"]);
+function normalizeitems(input) {
+    const ids = new Set();
+    return input.map((value, index) => {
+        const id = String(value?.id ?? "");
+        if (!id || ids.has(id))
+            throw new TypeError("working-set item id must be unique");
+        ids.add(id);
+        return Object.freeze({ id, sizebytes: positive(value.sizebytes, "working-set item sizebytes"), priority: Number(value.priority ?? 0), lastusedat: nonnegative(value.lastusedat ?? 0, "working-set item lastusedat"), expiresat: value.expiresat === undefined ? null : nonnegative(value.expiresat, "working-set item expiresat"), index });
+    });
+}
+function rank(items, policy) {
+    return [...items].sort((left, right) => {
+        if (right.priority !== left.priority)
+            return right.priority - left.priority;
+        if (policy === "lru" && right.lastusedat !== left.lastusedat)
+            return right.lastusedat - left.lastusedat;
+        if (policy === "sizeaware" && left.sizebytes !== right.sizebytes)
+            return left.sizebytes - right.sizebytes;
+        if (policy === "ttlfirst" && (left.expiresat ?? Infinity) !== (right.expiresat ?? Infinity))
+            return (left.expiresat ?? Infinity) - (right.expiresat ?? Infinity);
+        return left.index - right.index;
+    });
+}
+function limit(value, name) { return value === undefined ? Infinity : nonnegative(value, name); }
+function positive(value, name) { const numeric = nonnegative(value, name); if (numeric < 1)
+    throw new TypeError(`${name} must be positive`); return numeric; }
+function nonnegative(value, name) { const numeric = Number(value); if (!Number.isSafeInteger(numeric) || numeric < 0)
+    throw new TypeError(`${name} must be a non-negative safe integer`); return numeric; }
+function optionalnonnegative(value, name) { return value === undefined ? null : nonnegative(value, name); }
+function validpolicy(value) { if (!policies.has(value))
+    throw new TypeError("working-set policy is invalid"); return value; }
+function validtier(value) { if (!tiers.has(value))
+    throw new TypeError("working-set tier is invalid"); return value; }
+function validstate(value) { if (!states.has(value))
+    throw new TypeError("working-set materialization state is invalid"); return value; }
+function allowedtransition(current, next) { if (next === "failed")
+    return current !== "cleaned"; return new Set(["planned:prepared", "prepared:verified", "verified:released", "released:cleaned"]).has(`${current}:${next}`); }
+//# sourceMappingURL=planner.js.map

package/dist/memory/planner.js.map

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

package/dist/release/evidence.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Release evidence evaluates caller-supplied metadata without fetching, signing,
+ * scanning, publishing or claiming an artifact has more assurance than proven.
+ */
+/** Normalizes an immutable, caller-supplied artifact evidence record. */
+export declare function releaseevidence(input?: Record<string, unknown>): {
+    version: number;
+    kind: string;
+    status: string;
+    subjectdigest: string;
+    producer: string;
+    workflow: string;
+    verificationmethod: string;
+    verifiedat: number;
+    metadata: {
+        [x: string]: unknown;
+    };
+};
+/** Evaluates evidence against a caller-owned policy and returns reason codes, never a trust claim. */
+export declare function evaluateevidence(input?: Record<string, unknown>): {
+    version: number;
+    decision: string;
+    reasons: string[];
+    subjectdigest: string;
+    requiredkinds: string[];
+    evidence: {
+        version: number;
+        kind: string;
+        status: string;
+        subjectdigest: string;
+        producer: string;
+        workflow: string;
+        verificationmethod: string;
+        verifiedat: number;
+        metadata: {
+            [x: string]: unknown;
+        };
+    }[];
+};
+/** Builds a data-only readiness receipt for a release that a caller may later execute. */
+export declare function releasereadiness(input?: Record<string, unknown>): {
+    version: number;
+    sourcetag: string;
+    manifestversions: Record<string, string>;
+    requiredgates: Record<string, string>;
+    artifactplandigest: string;
+    targets: string[];
+    signingstatus: string;
+    evaluation: {
+        version: number;
+        decision: string;
+        reasons: string[];
+        subjectdigest: string;
+        requiredkinds: string[];
+        evidence: {
+            version: number;
+            kind: string;
+            status: string;
+            subjectdigest: string;
+            producer: string;
+            workflow: string;
+            verificationmethod: string;
+            verifiedat: number;
+            metadata: {
+                [x: string]: unknown;
+            };
+        }[];
+    };
+    decision: string;
+    ready: boolean;
+    reasons: string[];
+};
+/** Maps an already-completed local checksum verification result to evidence records. */
+export declare function evidencefromverification(input?: Record<string, unknown>): {
+    version: number;
+    releaseversion: string;
+    signingstatus: string;
+    evidence: {
+        version: number;
+        kind: string;
+        status: string;
+        subjectdigest: string;
+        producer: string;
+        workflow: string;
+        verificationmethod: string;
+        verifiedat: number;
+        metadata: {
+            [x: string]: unknown;
+        };
+    }[];
+};
+//# sourceMappingURL=evidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../release/evidence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;;;;;;;EAalE;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;;;;;;;;;;;;;;EAqBnE;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBnE;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;;;;;;;;;;;;EAoB3E"}

package/dist/release/evidence.js

@@ -0,0 +1,148 @@
+/**
+ * Release evidence evaluates caller-supplied metadata without fetching, signing,
+ * scanning, publishing or claiming an artifact has more assurance than proven.
+ */
+const evidencestatuses = new Set(["notProvided", "declared", "parsed", "checked", "verified", "rejected", "unknown"]);
+const verifiedstatuses = new Set(["checked", "verified"]);
+/** Normalizes an immutable, caller-supplied artifact evidence record. */
+export function releaseevidence(input = {}) {
+    const status = normalizestatus(input.status ?? "notProvided");
+    const kind = requiredtext(input.kind, "evidence kind");
+    const subjectdigest = optionaldigest(input.subjectdigest, "subject digest");
+    const producer = optionaltext(input.producer);
+    const workflow = optionaltext(input.workflow);
+    const method = optionaltext(input.verificationmethod);
+    const verifiedat = optionaltime(input.verifiedat, "verification time");
+    if (verifiedstatuses.has(status) && !subjectdigest)
+        throw new TypeError("checked evidence requires a subject digest");
+    if (verifiedstatuses.has(status) && !method)
+        throw new TypeError("checked evidence requires a verification method");
+    if (status === "verified" && !producer)
+        throw new TypeError("verified evidence requires a producer");
+    if (status === "verified" && !verifiedat)
+        throw new TypeError("verified evidence requires a verification time");
+    return { version: 1, kind, status, subjectdigest, producer, workflow, verificationmethod: method, verifiedat, metadata: objectcopy(input.metadata) };
+}
+/** Evaluates evidence against a caller-owned policy and returns reason codes, never a trust claim. */
+export function evaluateevidence(input = {}) {
+    const evidence = Array.isArray(input.evidence) ? input.evidence.map((entry) => releaseevidence(objectvalue(entry, "evidence entry"))) : [];
+    const policy = objectcopy(input.policy);
+    const requiredkinds = stringlist(policy.requiredkinds, "required kinds");
+    const allowedstatuses = new Set(stringlist(policy.allowedstatuses ?? ["verified"], "allowed statuses"));
+    const expectedproducer = textmap(policy.expectedproducer, "expected producer");
+    const expectedworkflow = textmap(policy.expectedworkflow, "expected workflow");
+    const subjectdigest = optionaldigest(input.subjectdigest, "subject digest");
+    const reasons = new Set();
+    for (const kind of requiredkinds) {
+        const matches = evidence.filter((entry) => entry.kind === kind);
+        if (matches.length === 0) {
+            reasons.add(`required-evidence-missing:${kind}`);
+            continue;
+        }
+        const accepted = matches.some((entry) => evidenceaccepted(entry, { allowedstatuses, expectedproducer, expectedworkflow, subjectdigest }, reasons));
+        if (!accepted)
+            reasons.add(`required-evidence-unsatisfied:${kind}`);
+    }
+    const evaluated = requiredkinds.length === 0 ? evidence : evidence.filter((entry) => requiredkinds.includes(entry.kind));
+    for (const entry of evaluated)
+        evidenceaccepted(entry, { allowedstatuses, expectedproducer, expectedworkflow, subjectdigest }, reasons);
+    const ordered = [...reasons].sort();
+    const rejected = ordered.some((reason) => reason.startsWith("evidence-rejected:") || reason.startsWith("producer-mismatch:") || reason.startsWith("workflow-mismatch:") || reason.startsWith("subject-mismatch:"));
+    const decision = rejected ? "rejected" : ordered.length > 0 ? "insufficient" : "accepted";
+    return { version: 1, decision, reasons: ordered, subjectdigest, requiredkinds, evidence };
+}
+/** Builds a data-only readiness receipt for a release that a caller may later execute. */
+export function releasereadiness(input = {}) {
+    const sourcetag = requiredtext(input.sourcetag, "source tag");
+    const manifestversions = textmap(input.manifestversions, "manifest versions");
+    const requiredgates = textmap(input.requiredgates, "required gates");
+    const artifactplandigest = optionaldigest(input.artifactplandigest, "artifact plan digest");
+    const targets = stringlist(input.targets, "publication targets");
+    const signingstatus = optionaltext(input.signingstatus) ?? "unknown";
+    const evaluation = evaluateevidence(objectvalue(input.evaluation, "evidence evaluation"));
+    const reasons = new Set(evaluation.reasons);
+    if (Object.values(manifestversions).some((value) => value !== sourcetag.replace(/^v/, "")))
+        reasons.add("manifest-version-mismatch");
+    for (const [gate, status] of Object.entries(requiredgates))
+        if (status !== "passed")
+            reasons.add(`required-gate-not-passed:${gate}`);
+    if (!artifactplandigest)
+        reasons.add("artifact-plan-digest-missing");
+    if (targets.length === 0)
+        reasons.add("publication-targets-missing");
+    if (signingstatus === "unknown")
+        reasons.add("signing-status-unknown");
+    const ordered = [...reasons].sort();
+    const decision = evaluation.decision === "rejected" ? "rejected" : ordered.length > 0 ? "insufficient" : "accepted";
+    return { version: 1, sourcetag, manifestversions, requiredgates, artifactplandigest, targets, signingstatus, evaluation, decision, ready: decision === "accepted", reasons: ordered };
+}
+/** Maps an already-completed local checksum verification result to evidence records. */
+export function evidencefromverification(input = {}) {
+    const verification = objectvalue(input.verification, "verification result");
+    if (verification.valid !== true)
+        throw new TypeError("verification result must be valid");
+    const releaseversion = requiredtext(verification.version, "release version");
+    const signingstatus = requiredtext(verification.signing, "signing status");
+    const files = requiredarray(verification.files, "verification files");
+    if (files.length === 0)
+        throw new TypeError("verification files must not be empty");
+    const names = new Set();
+    const producer = optionaltext(input.producer);
+    const workflow = optionaltext(input.workflow);
+    const verificationmethod = optionaltext(input.verificationmethod) ?? "checksum-manifest";
+    const verifiedat = optionaltime(input.verifiedat, "verification time");
+    const evidence = files.map((file) => {
+        const entry = objectvalue(file, "verification file");
+        const name = requiredtext(entry.name, "artifact name");
+        if (names.has(name))
+            throw new TypeError(`duplicate verification artifact: ${name}`);
+        names.add(name);
+        return releaseevidence({ kind: "checksum", status: "checked", subjectdigest: entry.digest, producer, workflow, verificationmethod, verifiedat, metadata: { artifact: name, releaseversion, signingstatus } });
+    });
+    return { version: 1, releaseversion, signingstatus, evidence };
+}
+function evidenceaccepted(entry, policy, reasons) {
+    let accepted = true;
+    if (entry.status === "rejected") {
+        reasons.add(`evidence-rejected:${entry.kind}`);
+        accepted = false;
+    }
+    if (!policy.allowedstatuses.has(entry.status)) {
+        reasons.add(`evidence-status-not-allowed:${entry.kind}:${entry.status}`);
+        accepted = false;
+    }
+    if (policy.subjectdigest && entry.subjectdigest !== policy.subjectdigest) {
+        reasons.add(`subject-mismatch:${entry.kind}`);
+        accepted = false;
+    }
+    if (policy.expectedproducer[entry.kind] && entry.producer !== policy.expectedproducer[entry.kind]) {
+        reasons.add(`producer-mismatch:${entry.kind}`);
+        accepted = false;
+    }
+    if (policy.expectedworkflow[entry.kind] && entry.workflow !== policy.expectedworkflow[entry.kind]) {
+        reasons.add(`workflow-mismatch:${entry.kind}`);
+        accepted = false;
+    }
+    return accepted;
+}
+function normalizestatus(value) { const status = requiredtext(value, "evidence status"); if (!evidencestatuses.has(status))
+    throw new TypeError(`unknown evidence status: ${status}`); return status; }
+function requiredtext(value, label) { const text = optionaltext(value); if (!text)
+    throw new TypeError(`${label} is required`); return text; }
+function optionaltext(value) { const text = value === undefined || value === null ? undefined : String(value).trim(); return text || undefined; }
+function optionaldigest(value, label) { const digest = optionaltext(value)?.toLowerCase(); if (digest && !/^[a-f0-9]{64}$/.test(digest))
+    throw new TypeError(`${label} must be a sha256 hex digest`); return digest; }
+function optionaltime(value, label) { if (value === undefined || value === null)
+    return undefined; const time = Number(value); if (!Number.isFinite(time) || time < 0)
+    throw new TypeError(`${label} must be a non-negative finite number`); return time; }
+function requiredarray(value, label) { if (!Array.isArray(value))
+    throw new TypeError(`${label} must be an array`); return value; }
+function stringlist(value, label) { if (value === undefined || value === null)
+    return []; if (!Array.isArray(value))
+    throw new TypeError(`${label} must be an array`); return [...new Set(value.map((item) => requiredtext(item, label)))].sort(); }
+function textmap(value, label) { if (value === undefined || value === null)
+    return {}; const source = objectvalue(value, label); return Object.fromEntries(Object.entries(source).map(([key, item]) => [requiredtext(key, label), requiredtext(item, label)])); }
+function objectcopy(value) { return value && typeof value === "object" && !Array.isArray(value) ? { ...value } : {}; }
+function objectvalue(value, label) { if (!value || typeof value !== "object" || Array.isArray(value))
+    throw new TypeError(`${label} must be an object`); return value; }
+//# sourceMappingURL=evidence.js.map

package/dist/release/evidence.js.map

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

package/dist/runners/chain.d.ts

@@ -0,0 +1,125 @@
+/**
+ * provider chains rank caller-authorized execution candidates without dispatching remote work.
+ */
+/** Creates a stable provider chain over declarative capability reports. */
+export declare function providerchain(input?: {}): Readonly<{
+    select(request?: {}): Readonly<{
+        version: 1;
+        selected: Readonly<{
+            id: any;
+            priority: any;
+            capabilities: readonly any[];
+            architecture: any;
+            operatingSystem: any;
+            networkpolicy: any;
+            storagepolicy: any;
+            cpu: any;
+            memorybytes: any;
+            maxmilliseconds: any;
+        }>;
+        rejected: readonly any[];
+        request: Readonly<{
+            capabilities: readonly string[];
+            preferredids: readonly string[];
+            architecture: string;
+            operatingSystem: string;
+            networkpolicy: string;
+            storagepolicy: string;
+            mincpu: number;
+            minmemorybytes: number;
+            minmilliseconds: number;
+        }>;
+    }>;
+    dispatchplan(request?: {}): Readonly<{
+        version: 1;
+        state: "caller-dispatches";
+        provider: Readonly<{
+            id: any;
+            priority: any;
+            capabilities: readonly any[];
+            architecture: any;
+            operatingSystem: any;
+            networkpolicy: any;
+            storagepolicy: any;
+            cpu: any;
+            memorybytes: any;
+            maxmilliseconds: any;
+        }>;
+        request: Readonly<{
+            capabilities: readonly string[];
+            preferredids: readonly string[];
+            architecture: string;
+            operatingSystem: string;
+            networkpolicy: string;
+            storagepolicy: string;
+            mincpu: number;
+            minmemorybytes: number;
+            minmilliseconds: number;
+        }>;
+        rejected: readonly any[];
+    }>;
+    providers: () => {
+        capabilities: string[];
+        id: string;
+        priority: number;
+        status: string;
+        architecture: string;
+        operatingSystem: string;
+        networkpolicy: string;
+        storagepolicy: string;
+        cpu: number;
+        memorybytes: number;
+        maxmilliseconds: number;
+    }[];
+}>;
+/** Selects the first eligible provider under stable priority and returns every exclusion reason. */
+export declare function selectprovider(providers: any, request?: {}): Readonly<{
+    version: 1;
+    selected: Readonly<{
+        id: any;
+        priority: any;
+        capabilities: readonly any[];
+        architecture: any;
+        operatingSystem: any;
+        networkpolicy: any;
+        storagepolicy: any;
+        cpu: any;
+        memorybytes: any;
+        maxmilliseconds: any;
+    }>;
+    rejected: readonly any[];
+    request: Readonly<{
+        capabilities: readonly string[];
+        preferredids: readonly string[];
+        architecture: string;
+        operatingSystem: string;
+        networkpolicy: string;
+        storagepolicy: string;
+        mincpu: number;
+        minmemorybytes: number;
+        minmilliseconds: number;
+    }>;
+}>;
+/** Produces a verified runner-to-storage handoff record without writing an artifact. */
+export declare function artifacthandoff(input?: {}): Readonly<{
+    version: 1;
+    key: string;
+    sha256: string;
+    sizebytes: number;
+    providerid: string;
+    retention: string;
+    state: "caller-transfers";
+}>;
+/** Creates a cancellation intent without claiming that a remote runner has stopped or cleaned up. */
+export declare function cancellationplan(input?: {}): Readonly<{
+    version: 1;
+    runid: string;
+    providerid: string;
+    reason: string;
+    state: "caller-cancels";
+    remotestate: "unknown";
+    compensation: "caller-evaluates" | "not-requested";
+}>;
+/** Renders a caller-dispatches plan through an injected forge adapter without sending it. */
+export declare function renderdispatch(plan: any, adapter: any): Promise<any>;
+//# sourceMappingURL=chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../runners/chain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAGvC;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,SAAS,KAAA,EAAE,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;GAcrD;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,KAAK;;;;;;;;GAMzC;AAED,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,KAAK,KAAK;;;;;;;;GAK1C;AAED,6FAA6F;AAC7F,wBAAsB,cAAc,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA,gBAIjD"}