@openmixer/plugin-qualify 0.10.1 → 0.12.0

package/dist/probe-judge.js

@@ -0,0 +1,217 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * Judging from a probe output. The probe output holds facts (`probe-output.ts`); this module turns
+ * them into the facts the one judge already reads and lets that judge speak. There is no second
+ * judge: a CLAP plugin's verdict is {@link rtSafetyDocument}'s fold of the same reasons it folds
+ * for a prober line, an LV2 plugin's is {@link rtSafetyReasons}, and cost is read by
+ * {@link hostingCostReasons} at the host's rate and quantum.
+ *
+ * What a probe output does not carry, this module does not invent:
+ *
+ * - `noteInputs` is the descriptor's fact. Without one the run's note sweep stands in: a plugin
+ *   whose sweep was applicable has at least one note input; one whose sweep was not applicable is
+ *   read as having none, so an instrument that could not be played reads as an effect. The caller
+ *   that holds the descriptor passes the real count.
+ * - The note sweep's block count is the parameter sweep's: both run in one prober process at one
+ *   block count, and the schema holds the note sweep's counts but not its blocks.
+ */
+import { DEFAULT_HOSTING_POLICY } from "./qualify-declarations.js";
+import { rtSafetyDocument, } from "./clap-qualify.js";
+import { gridCostReadings } from "./cost-fields.js";
+import { hostingCostReasons, noteSweepReasons, rtSafetyReasons, contributedHostingRating, } from "./hosting-suitability.js";
+import { PROBE_NOT_ATTEMPTED, PROBE_OK } from "./probe-output.js";
+import { RATING_SEVERITY, worstRating } from "./rating.js";
+/** A sum of one count over the points, or `undefined` when a point lacks it: a missing count is not zero. */
+function total(points, count) {
+    let sum = 0;
+    for (const p of points) {
+        const n = count(p);
+        if (n === undefined)
+            return undefined;
+        sum += n;
+    }
+    return sum;
+}
+/** The points whose run ended well: a point that crashed measured nothing. */
+function okPoints(output) {
+    return output.grid.filter((p) => p.outcome === PROBE_OK);
+}
+/**
+ * The interposer's counts over every grid point that carries them. The interposer must have been
+ * loaded at every such point; the sweep counts as done when every point swept, and as applicable
+ * when any did. A count a point lacks leaves the total absent, and the judge reads that as
+ * unmeasured.
+ */
+export function rtSafetyOfProbeOutput(output) {
+    const points = okPoints(output).filter((p) => p.rtSafety !== undefined);
+    if (points.length === 0 || points.some((p) => p.rtSafety?.interposer !== true))
+        return { interposer: false };
+    const reading = (p) => p.rtSafety;
+    const allocations = total(points, (p) => reading(p)?.allocations);
+    const locks = total(points, (p) => reading(p)?.locks);
+    const syscalls = total(points, (p) => reading(p)?.syscalls);
+    return {
+        interposer: true,
+        swept: points.every((p) => reading(p)?.swept === true),
+        sweepApplicable: points.some((p) => reading(p)?.sweepApplicable === true),
+        blocks: total(points, (p) => reading(p)?.blocks ?? 0) ?? 0,
+        blockFrames: points[0]?.quantum ?? 0,
+        ...(allocations === undefined ? {} : { allocationsInRun: allocations }),
+        ...(locks === undefined ? {} : { locksInRun: locks }),
+        ...(syscalls === undefined ? {} : { syscallsInRun: syscalls }),
+        events: points.flatMap((p) => reading(p)?.events ?? []),
+    };
+}
+function noteSweepOfProbeOutput(output, rt) {
+    const played = okPoints(output).find((p) => p.noteSweep?.applicable === true)?.noteSweep;
+    if (played === undefined)
+        return { applicable: false };
+    const dialect = {};
+    if (played.dialect === "clap" || played.dialect === "midi")
+        dialect.dialect = played.dialect;
+    const base = { applicable: true, ...dialect, blocks: rt.blocks ?? 0, blockFrames: rt.blockFrames ?? 0, noteEvents: 0, processErrors: 0, nonFinite: false };
+    if (!rt.interposer)
+        return { ...base, interposer: false };
+    return {
+        ...base,
+        interposer: true,
+        ...(played.allocations === undefined ? {} : { allocationsInRun: played.allocations }),
+        ...(played.locks === undefined ? {} : { locksInRun: played.locks }),
+        ...(played.syscalls === undefined ? {} : { syscallsInRun: played.syscalls }),
+    };
+}
+function integrityOfProbeOutput(output) {
+    const { files, layout, unpinnable } = output.binary;
+    if (layout === undefined || files.length === 0) {
+        return { unmeasuredReason: unpinnable === undefined ? "probe-error" : "unpinnable", unmeasuredDetail: unpinnable ?? "the probe output holds no layout pin" };
+    }
+    return {
+        ...(output.plugin.version === undefined ? {} : { version: output.plugin.version }),
+        files: files.slice().sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0)),
+        layout,
+    };
+}
+/**
+ * A CLAP probe output as the prober's line it stands for, so that {@link rtSafetyDocument} judges it.
+ * The facts the line holds and a probe output does not (the port layout, the features) are not read
+ * by the rtSafety fold and are left empty here.
+ */
+export function clapLineFromProbeOutput(output, facts = {}) {
+    const rtSafety = rtSafetyOfProbeOutput(output);
+    const noteSweep = noteSweepOfProbeOutput(output, rtSafety);
+    const points = okPoints(output);
+    const latency = {};
+    for (const p of points) {
+        if (p.latency !== undefined && latency[String(p.rate)] === undefined)
+            latency[String(p.rate)] = p.latency;
+    }
+    const withRt = points.filter((p) => p.rtSafety !== undefined);
+    return {
+        uri: `urn:clap:${output.plugin.id}`,
+        id: output.plugin.id,
+        binary: { path: output.binary.path, sha256: output.binary.sha256 },
+        hostExtensions: output.offer.clapExtensions ?? [],
+        clap: {
+            mainInputChannels: 0,
+            mainOutputChannels: 0,
+            sidechainInputs: 0,
+            features: [],
+            headlessOk: output.steps.some((s) => s.step === "instantiate" && s.outcome === PROBE_OK),
+            noteInputs: facts.noteInputs ?? (noteSweep.applicable ? 1 : 0),
+            latency,
+            threadViolations: total(withRt, (p) => p.rtSafety?.threadViolations ?? 0) ?? 0,
+            processErrors: total(withRt, (p) => p.rtSafety?.processErrors ?? 0) ?? 0,
+            // the sweep ran as many blocks as the points that counted say; a run with none measured nothing
+            processCalls: rtSafety.interposer ? (rtSafety.blocks ?? 0) : points.length,
+            nonFinite: output.steps.some((s) => s.outcome === "probe.non-finite-output"),
+        },
+        rtSafety,
+        noteSweep,
+        integrity: integrityOfProbeOutput(output),
+    };
+}
+const asRecordReason = (r) => ({ dimension: r.dimension, rating: contributedHostingRating(r), code: r.code, params: r.params });
+function decidingOf(reasons, rating) {
+    if (rating === "suitable")
+        return undefined;
+    return [...reasons].sort((a, b) => RATING_SEVERITY[b.rating] - RATING_SEVERITY[a.rating]).find((r) => r.rating === rating);
+}
+function costOf(output, profile) {
+    const { rate, quantum } = profile.cost;
+    const reasons = hostingCostReasons({ cpuCost: { perRateQuantum: gridCostReadings(output.grid, PROBE_OK) } }, { rate, quantum, profile }, DEFAULT_HOSTING_POLICY);
+    const voices = output.grid.find((p) => p.outcome === PROBE_OK && p.rate === rate && p.quantum === quantum)?.cost?.voices;
+    return { rate, quantum, ...(voices === undefined ? {} : { voices }), reasons: reasons.map(asRecordReason) };
+}
+/**
+ * The outcome that ended the run badly, or `undefined` when it ended well. The run's own outcome is the
+ * first word; a grid point that failed under a run that says `probe.ok` is a document that contradicts
+ * itself, and is read as the failure it records rather than as a pass that skipped the point.
+ */
+function failedOutcome(output) {
+    if (output.run.outcome !== PROBE_OK)
+        return output.run.outcome;
+    return output.grid.find((p) => p.outcome !== PROBE_OK && p.outcome !== PROBE_NOT_ATTEMPTED)?.outcome;
+}
+/**
+ * Every profile's judgment of one probe output.
+ *
+ * A run that did not end `probe.ok` is `unknown` under every profile, with the run's outcome code as
+ * the reason: the measurement did not finish, so there is nothing to rate, and it is not a plugin
+ * `unsuitable` on evidence the run never gathered. A step that was not attempted is part of a run that
+ * ended well (a plugin with no note input has no note sweep).
+ */
+export function judgeProbeOutput(output, profiles, facts = {}) {
+    const uri = output.plugin.format === "clap" ? `urn:clap:${output.plugin.id}` : output.plugin.id;
+    const failure = failedOutcome(output);
+    if (failure !== undefined) {
+        const reason = { dimension: "rtSafety", rating: "unknown", code: failure, params: {} };
+        return {
+            output,
+            documents: [],
+            hosts: profiles.map((profile) => ({
+                verdict: { uri, host: profile.id, measured: false, rating: "unknown", qualified: false, deciding: failure },
+                hosting: "isolated",
+                reasons: [reason],
+                cost: costOf(output, profile),
+            })),
+        };
+    }
+    const line = output.plugin.format === "clap" ? clapLineFromProbeOutput(output, facts) : undefined;
+    const documents = [];
+    const hosts = profiles.map((profile) => {
+        let reasons;
+        if (line !== undefined) {
+            const doc = rtSafetyDocument(line, profile);
+            documents.push(doc);
+            reasons = doc.verdict.reasons.map(asRecordReason);
+        }
+        else {
+            // an LV2 plugin: the control sweep's counts, and the note sweep's when it was played through a MIDI input
+            const rt = rtSafetyOfProbeOutput(output);
+            const notes = noteSweepOfProbeOutput(output, rt);
+            reasons = [...rtSafetyReasons(rt), ...noteSweepReasons(notes, facts.noteInputs ?? (notes.applicable ? 1 : 0))].map(asRecordReason);
+        }
+        const rating = worstRating(reasons.map((r) => r.rating));
+        const deciding = decidingOf(reasons, rating);
+        return {
+            verdict: {
+                uri,
+                host: profile.id,
+                measured: true,
+                rating,
+                qualified: rating === "suitable",
+                ...(deciding === undefined ? {} : { deciding: deciding.code }),
+            },
+            hosting: rating === "suitable" && profile.isolation === "in-process" ? "in-process" : "isolated",
+            reasons,
+            cost: costOf(output, profile),
+        };
+    });
+    return { output, hosts, documents };
+}
+/** The verdict rows of a judgment, as the CLI prints them. */
+export function judgmentVerdicts(judgment) {
+    return judgment.hosts.map((h) => h.verdict);
+}
+//# sourceMappingURL=probe-judge.js.map

package/dist/probe-judge.js.map

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

package/dist/probe-output-fixtures.d.ts

@@ -0,0 +1,25 @@
+import type { ClapQualifyLine } from "./clap-qualify.js";
+import { type ProbeOutput } from "./probe-output.js";
+export declare function fixtureText(name: string): string;
+/** A fixture as a mutable JSON value, for the tests that break one field of it. */
+export declare function fixtureJson(name: string): Record<string, any>;
+/** A fixture through the reader; throws when the reader refuses it. */
+export declare function readFixture(name: string): ProbeOutput;
+/**
+ * The probe output that carries what a prober line carries, for the proofs that a verdict read from a
+ * probe output equals the verdict read from today's document. Built on the success fixture, so its machine,
+ * limits and run are a real document's.
+ *
+ * What the line holds and a probe output cannot is not encoded: the port layout and the features (no
+ * verdict reads them), the note sweep's process errors and non-finite flag, and a block count apart
+ * from the sweep's (the probe output has one, the blocks the sweep processed, which is `processCalls`).
+ */
+export declare function probeOutputOfLine(line: ClapQualifyLine): Record<string, any>;
+/** A prober line for a clean stereo effect, with `patch` merged over it. */
+export declare function clapLineFixture(patch?: {
+    rtSafety?: object;
+    clap?: object;
+    hostExtensions?: string[];
+    noteSweep?: object;
+    integrity?: object;
+}): ClapQualifyLine;

package/dist/probe-output-fixtures.js

@@ -0,0 +1,134 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The probe-output documents the tests build on, read from `fixtures/probe-output/`: plugin-hostd's
+ * three example documents (a success on the reference rig, a crash, a refusal for memory). Kept
+ * out of the test files so every test reads the same documents; a `.test.ts` imported for a helper
+ * runs its whole suite in each importer.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { OMX_CLAP_HOST_EXTENSIONS } from "./host-profiles.js";
+import { readProbeOutput } from "./probe-output.js";
+const FIXTURES = join(dirname(fileURLToPath(import.meta.url)), "..", "fixtures", "probe-output");
+export function fixtureText(name) {
+    return readFileSync(join(FIXTURES, `${name}.json`), "utf8");
+}
+/** A fixture as a mutable JSON value, for the tests that break one field of it. */
+export function fixtureJson(name) {
+    return JSON.parse(fixtureText(name));
+}
+/** A fixture through the reader; throws when the reader refuses it. */
+export function readFixture(name) {
+    const r = readProbeOutput(fixtureText(name));
+    if (!r.ok)
+        throw new Error(`${name}: ${r.code}: ${r.problem}`);
+    return r.output;
+}
+/**
+ * The probe output that carries what a prober line carries, for the proofs that a verdict read from a
+ * probe output equals the verdict read from today's document. Built on the success fixture, so its machine,
+ * limits and run are a real document's.
+ *
+ * What the line holds and a probe output cannot is not encoded: the port layout and the features (no
+ * verdict reads them), the note sweep's process errors and non-finite flag, and a block count apart
+ * from the sweep's (the probe output has one, the blocks the sweep processed, which is `processCalls`).
+ */
+export function probeOutputOfLine(line) {
+    const doc = fixtureJson("success-msi");
+    const rt = line.rtSafety;
+    const note = line.noteSweep;
+    const pin = line.integrity;
+    const rates = Object.keys(line.clap.latency);
+    const quantum = rt.blockFrames ?? 512;
+    doc["plugin"] = { format: "clap", id: line.id, ...(pin.version === undefined ? {} : { version: pin.version }) };
+    doc["binary"] = {
+        path: line.binary.path,
+        sha256: line.binary.sha256,
+        files: pin.files ?? [],
+        ...(pin.layout === undefined ? {} : { layout: pin.layout }),
+        ...(pin.unmeasuredReason === undefined ? {} : { unpinnable: pin.unmeasuredDetail ?? pin.unmeasuredReason }),
+    };
+    delete doc["descriptor"];
+    doc["offer"] = { id: "default", clapExtensions: [...line.hostExtensions], realtime: "none" };
+    doc["steps"] = [{ step: "hash", outcome: "probe.ok", elapsedMs: 1 }, { step: "instantiate", outcome: "probe.ok", elapsedMs: 1 }];
+    const first = {};
+    if (rt.interposer) {
+        Object.assign(first, {
+            rtSafety: {
+                interposer: true,
+                swept: rt.swept,
+                sweepApplicable: rt.sweepApplicable,
+                blocks: line.clap.processCalls,
+                allocations: rt.allocationsInRun,
+                locks: rt.locksInRun,
+                syscalls: rt.syscallsInRun,
+                threadViolations: line.clap.threadViolations,
+                processErrors: line.clap.processErrors,
+                events: rt.events ?? [],
+            },
+        });
+    }
+    else
+        first["rtSafety"] = { interposer: false };
+    if (note.applicable) {
+        first["noteSweep"] = {
+            applicable: true,
+            ...(note.dialect === undefined ? {} : { dialect: note.dialect }),
+            ...(note.interposer === true ? { allocations: note.allocationsInRun, locks: note.locksInRun, syscalls: note.syscallsInRun } : {}),
+        };
+    }
+    const at = rates.length > 0 ? rates : ["48000"];
+    doc["grid"] = at.map((rate, i) => ({
+        rate: Number(rate),
+        quantum,
+        outcome: "probe.ok",
+        ...(line.clap.latency[rate] === undefined ? {} : { latency: { ...line.clap.latency[rate], method: "impulse-onset" } }),
+        ...(i === 0 ? first : {}),
+    }));
+    return doc;
+}
+const PIN = {
+    version: "1",
+    files: [{ path: "rt-safe.clap", sha256: "a".repeat(64) }],
+    layout: { scheme: "omx-layout/1", sha256: "b".repeat(64) },
+};
+/** A prober line for a clean stereo effect, with `patch` merged over it. */
+export function clapLineFixture(patch = {}) {
+    return {
+        uri: "urn:clap:org.example.fx",
+        id: "org.example.fx",
+        binary: { path: "/x/rt-safe.clap", sha256: "a".repeat(64) },
+        hostExtensions: patch.hostExtensions ?? [...OMX_CLAP_HOST_EXTENSIONS],
+        clap: {
+            mainInputChannels: 2,
+            mainOutputChannels: 2,
+            sidechainInputs: 0,
+            features: ["audio-effect"],
+            headlessOk: true,
+            noteInputs: 0,
+            latency: { "48000": { declaredFrames: 0, measuredFrames: 0 }, "96000": { declaredFrames: 4, measuredFrames: 4 } },
+            threadViolations: 0,
+            processErrors: 0,
+            processCalls: 512,
+            nonFinite: false,
+            ...patch.clap,
+        },
+        rtSafety: {
+            interposer: true,
+            swept: true,
+            sweepApplicable: true,
+            blocks: 512,
+            blockFrames: 512,
+            allocationsInRun: 0,
+            locksInRun: 0,
+            syscallsInRun: 0,
+            events: [],
+            ...patch.rtSafety,
+        },
+        noteSweep: { applicable: false, ...patch.noteSweep },
+        integrity: { ...PIN, ...patch.integrity },
+    };
+}
+//# sourceMappingURL=probe-output-fixtures.js.map

package/dist/probe-output-fixtures.js.map

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

package/dist/probe-output.d.ts

@@ -0,0 +1,153 @@
+import { type VoicesHeld } from "./measurement/format.js";
+export declare const PROBE_OUTPUT_FORMAT = "plugin-hostd.probe-output";
+/** The one major this reader knows. A minor of it only adds fields. */
+export declare const PROBE_OUTPUT_MAJOR = 1;
+export declare const PROBE_FORMAT_CODE: {
+    readonly majorUnknown: "probe.format.major-unknown";
+    readonly derivedMismatch: "probe.format.derived-mismatch";
+    readonly invalid: "probe.format.invalid";
+};
+export type ProbeFormatCode = (typeof PROBE_FORMAT_CODE)[keyof typeof PROBE_FORMAT_CODE];
+/** The outcome that means a step ran to its end. */
+export declare const PROBE_OK = "probe.ok";
+export declare const PROBE_NOT_ATTEMPTED = "probe.not-attempted";
+/**
+ * An exit-latency above this many microseconds makes an idle state deep. The runner writes the
+ * document by this rule, so the reader recomputes by it; the protocol document will state it
+ * (plugin-hostd#78) and this number follows that document.
+ */
+export declare const DEEP_IDLE_LATENCY_US = 20;
+export interface ProbeFile {
+    readonly path: string;
+    readonly sha256: string;
+}
+export interface ProbeCost {
+    readonly median: number;
+    /** The percentile the figure is taken at, and its value, in nanoseconds per sample. */
+    readonly percentile: {
+        readonly p: number;
+        readonly value: number;
+    };
+    readonly blocks: number;
+    readonly warmupBlocks: number;
+    /** For an instrument: the notes it held while it was timed, how many and why that many. */
+    readonly voices?: VoicesHeld;
+}
+export interface ProbeRtSafety {
+    readonly interposer: boolean;
+    readonly swept?: boolean;
+    readonly sweepApplicable?: boolean;
+    readonly blocks?: number;
+    readonly allocations?: number;
+    readonly locks?: number;
+    readonly syscalls?: number;
+    readonly threadViolations?: number;
+    readonly processErrors?: number;
+    readonly events?: readonly string[];
+}
+export interface ProbeNoteSweep {
+    readonly applicable: boolean;
+    readonly dialect?: string;
+    readonly allocations?: number;
+    readonly locks?: number;
+    readonly syscalls?: number;
+}
+/** One point of the protocol's grid: the figures at one rate and one quantum. */
+export interface ProbeGridPoint {
+    readonly rate: number;
+    readonly quantum: number;
+    readonly outcome: string;
+    readonly latency?: {
+        readonly declaredFrames: number;
+        readonly measuredFrames: number;
+    };
+    readonly cost?: ProbeCost;
+    readonly rtSafety?: ProbeRtSafety;
+    readonly noteSweep?: ProbeNoteSweep;
+}
+export interface ProbeStep {
+    readonly step: string;
+    readonly outcome: string;
+    readonly rate?: number;
+    readonly quantum?: number;
+    readonly detail?: string;
+}
+export interface ProbeIdleState {
+    readonly cpu: number;
+    readonly state: string;
+    readonly latencyUs: number;
+    readonly disabled: boolean;
+    readonly usageDelta: number;
+}
+export interface ProbeOutput {
+    readonly formatVersion: string;
+    readonly run: {
+        readonly id: string;
+        readonly startedAt: string;
+        readonly elapsedMs: number;
+        readonly complete: boolean;
+        readonly outcome: string;
+        readonly reason?: string;
+        readonly protocol: {
+            readonly name: string;
+            readonly version: number;
+        };
+        readonly tools: Readonly<Record<string, string>>;
+        readonly via: string;
+    };
+    readonly plugin: {
+        readonly format: "clap" | "lv2";
+        readonly id: string;
+        readonly name?: string;
+        readonly version?: string;
+    };
+    readonly binary: {
+        readonly path: string;
+        readonly sha256: string;
+        readonly files: readonly ProbeFile[];
+        readonly layout?: {
+            readonly scheme: string;
+            readonly sha256: string;
+        };
+        /** Why the files cannot be pinned, when they cannot. */
+        readonly unpinnable?: string;
+    };
+    readonly machine: {
+        readonly class: Readonly<Record<string, string | boolean>>;
+        readonly profile: {
+            readonly governor: string | null;
+            readonly cpuidle: readonly ProbeIdleState[];
+            readonly meetsProtocol: boolean;
+            readonly unmet: readonly string[];
+        };
+        readonly pinnedCpus: string;
+    };
+    readonly offer: {
+        readonly id: string;
+        readonly clapExtensions?: readonly string[];
+    };
+    readonly steps: readonly ProbeStep[];
+    readonly grid: readonly ProbeGridPoint[];
+    /** What the document says about how the plugin behaves, as it was written. */
+    readonly behaviour?: Readonly<Record<string, unknown>>;
+}
+export type ReadProbeOutputResult = {
+    readonly ok: true;
+    readonly output: ProbeOutput;
+} | {
+    readonly ok: false;
+    readonly code: ProbeFormatCode;
+    readonly problem: string;
+};
+/** Whether any idle state deeper than {@link DEEP_IDLE_LATENCY_US} is enabled: then the machine does not limit its C-states. */
+export declare function deepIdleEnabled(cpuidle: readonly ProbeIdleState[]): boolean;
+/** Whether a deep idle state was entered while the run measured. */
+export declare function deepIdleEntered(cpuidle: readonly ProbeIdleState[]): boolean;
+/**
+ * A probe output from its text, or the code that refuses it. The order of the checks is the order of
+ * what can be trusted: that it is JSON and the format, then the major (before any content is read),
+ * then that it holds no judgment, then the content, then the derived fields against it.
+ */
+export declare function readProbeOutput(text: string): ReadProbeOutputResult;
+/** The SHA-256 of some bytes, as the record names a probe output's copy. */
+export declare function sha256Hex(bytes: Uint8Array): string;