@zaalipro/dsh-workflows 0.1.0-rc.3

package/lib/types/supervisor/storage/bounded-file.js

@@ -0,0 +1,186 @@
+import { constants } from 'node:fs';
+import { randomBytes } from 'node:crypto';
+import { link, lstat, mkdir, open, rename, stat, unlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+export class BoundedFileError extends Error {
+    code;
+    constructor(message, code = 'WORKFLOW_STORAGE_UNSAFE', options) {
+        super(message, options);
+        this.name = 'BoundedFileError';
+        this.code = code;
+    }
+}
+const COMPONENT = /^[A-Za-z0-9][A-Za-z0-9._-]*$/u;
+const encoder = new TextEncoder();
+function noFollowFlag() {
+    const flag = constants.O_NOFOLLOW;
+    if (process.platform === 'win32' || typeof flag !== 'number' || flag === 0) {
+        throw new BoundedFileError(`safe workflow storage is unavailable on ${process.platform}`, 'WORKFLOW_STORAGE_UNSUPPORTED');
+    }
+    return flag;
+}
+function unsafe(path, detail, cause) {
+    return new BoundedFileError(`workflow storage path "${path}" is unsafe: ${detail}`, 'WORKFLOW_STORAGE_UNSAFE', cause === undefined ? undefined : { cause });
+}
+/** Validate a value before it is used as a descriptor-relative component. */
+export function assertSafeComponent(value, label = 'path component') {
+    if (!COMPONENT.test(value)
+        || value === '.'
+        || value === '..'
+        || value.includes('/')
+        || value.includes('\\')
+        || Buffer.byteLength(value, 'utf8') > 255) {
+        throw new BoundedFileError(`${label} is unsafe: ${value}`);
+    }
+    return value;
+}
+/** Read through a retained private-directory authority with a fixed byte cap. */
+export async function readOwnedRegularFile(directory, name, options) {
+    assertSafeComponent(name, 'file name');
+    if (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 0) {
+        throw new RangeError('maxBytes must be a non-negative safe integer');
+    }
+    options.signal?.throwIfAborted();
+    await directory.assertIdentity(options.signal);
+    const bytes = await directory.readBytes(name, options.signal, options.maxBytes);
+    if (bytes.byteLength > options.maxBytes) {
+        throw new BoundedFileError(`private file "${name}" exceeds ${options.maxBytes} bytes`, 'WORKFLOW_STORAGE_LIMIT');
+    }
+    await directory.assertIdentity(options.signal);
+    return new Uint8Array(bytes);
+}
+/** Publish through the compatible Host's guarded private-directory operation. */
+export async function writeOwnedFileAtomic(directory, name, bytes, options) {
+    assertSafeComponent(name, 'file name');
+    if (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 0) {
+        throw new RangeError('maxBytes must be a non-negative safe integer');
+    }
+    if (bytes.byteLength > options.maxBytes) {
+        throw new BoundedFileError(`private file "${name}" exceeds ${options.maxBytes} bytes`, 'WORKFLOW_STORAGE_LIMIT');
+    }
+    options.signal?.throwIfAborted();
+    await directory.assertIdentity(options.signal);
+    let content;
+    try {
+        content = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    catch (error) {
+        throw new BoundedFileError(`private file "${name}" is not valid UTF-8`, 'WORKFLOW_STORAGE_CORRUPT', { cause: error });
+    }
+    const outcome = await directory.writeText(name, content, options.expected, options.signal);
+    await directory.assertIdentity(options.signal);
+    return outcome;
+}
+/** Legacy path-shaped bounded read, retained for compatibility with early consumers. */
+export async function readBoundedUtf8(path, maxBytes) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 0)
+        throw new RangeError('maxBytes must be a non-negative safe integer');
+    const handle = await open(path, constants.O_RDONLY | noFollowFlag());
+    try {
+        const info = await handle.stat();
+        if (!info.isFile() || info.nlink !== 1 || (info.mode & 0o777) !== 0o600) {
+            throw unsafe(path, 'file is not a private regular single-link file');
+        }
+        if (typeof process.getuid === 'function' && info.uid !== process.getuid())
+            throw unsafe(path, 'file has the wrong owner');
+        if (info.size > maxBytes)
+            throw new BoundedFileError(`${path} exceeds ${maxBytes} bytes`, 'WORKFLOW_STORAGE_LIMIT');
+        const chunks = [];
+        let total = 0;
+        while (total <= maxBytes) {
+            const chunk = Buffer.allocUnsafe(Math.min(64 * 1024, maxBytes - total + 1));
+            const { bytesRead } = await handle.read(chunk, 0, chunk.length, null);
+            if (bytesRead === 0)
+                break;
+            total += bytesRead;
+            if (total > maxBytes)
+                throw new BoundedFileError(`${path} exceeds ${maxBytes} bytes`, 'WORKFLOW_STORAGE_LIMIT');
+            chunks.push(chunk.subarray(0, bytesRead));
+        }
+        try {
+            return new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks, total));
+        }
+        catch (error) {
+            throw new BoundedFileError(`${path} is not valid UTF-8`, 'WORKFLOW_STORAGE_CORRUPT', { cause: error });
+        }
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Legacy path-shaped atomic publication with fsync and final-component checks. */
+export async function writeBoundedAtomic(path, content, options) {
+    const bytes = encoder.encode(content);
+    if (bytes.byteLength > options.maxBytes) {
+        throw new BoundedFileError(`${path} exceeds ${options.maxBytes} bytes`, 'WORKFLOW_STORAGE_LIMIT');
+    }
+    const mode = options.mode ?? 0o600;
+    if (mode !== 0o600)
+        throw unsafe(path, 'workflow storage files must use mode 0600');
+    const parent = dirname(path);
+    await mkdir(parent, { recursive: true, mode: 0o700 });
+    const temp = join(parent, `.${randomBytes(16).toString('hex')}.tmp`);
+    const handle = await open(temp, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | noFollowFlag(), mode);
+    try {
+        let offset = 0;
+        while (offset < bytes.byteLength) {
+            const { bytesWritten } = await handle.write(bytes, offset, bytes.byteLength - offset, offset);
+            if (bytesWritten <= 0)
+                throw unsafe(temp, 'short write');
+            offset += bytesWritten;
+        }
+        await handle.sync();
+        if (options.createOnly) {
+            try {
+                await lstat(path);
+                throw unsafe(path, 'destination already exists');
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+        else {
+            try {
+                const current = await lstat(path);
+                if (!current.isFile() || current.isSymbolicLink() || current.nlink !== 1) {
+                    throw unsafe(path, 'destination is not a regular single-link file');
+                }
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+        if (options.createOnly) {
+            try {
+                await link(temp, path);
+            }
+            catch (error) {
+                if (error.code === 'EEXIST')
+                    throw unsafe(path, 'destination already exists', error);
+                throw error;
+            }
+            await unlink(temp);
+        }
+        else {
+            await rename(temp, path);
+        }
+        const published = await stat(path);
+        if (!published.isFile() || published.nlink !== 1 || (published.mode & 0o777) !== 0o600) {
+            throw unsafe(path, 'published file identity is invalid');
+        }
+        const parentHandle = await open(parent, constants.O_RDONLY | (constants.O_DIRECTORY ?? 0));
+        try {
+            await parentHandle.sync();
+        }
+        finally {
+            await parentHandle.close();
+        }
+    }
+    finally {
+        await handle.close().catch(() => undefined);
+        await unlink(temp).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=bounded-file.js.map

package/lib/types/supervisor/storage/bounded-file.js.map

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

package/lib/types/supervisor/storage/details-codec.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowRunDetailPayloadV2, WorkflowRunDetailSnapshotV2 } from './manifest-types.js';
+export interface WorkflowRunDetailLimits {
+    readonly memberOutcomeMaxBytes: number;
+    readonly maxTerminalResultBytes: number;
+    readonly maxLogLineBytes: number;
+    readonly maxRunDetailsBytes: number;
+}
+/** Deterministically compact a detail payload to its fixed quotas. */
+export declare function compactWorkflowRunDetails(value: WorkflowRunDetailPayloadV2, limits: WorkflowRunDetailLimits): WorkflowRunDetailPayloadV2;
+/** Encode one immutable version-2 detail sidecar. */
+export declare function encodeWorkflowRunDetails(value: WorkflowRunDetailSnapshotV2, limits: WorkflowRunDetailLimits): Uint8Array;
+/** Decode one immutable version-2 detail sidecar. */
+export declare function decodeWorkflowRunDetails(input: Uint8Array | string, file: string, limits: WorkflowRunDetailLimits): WorkflowRunDetailSnapshotV2;
+//# sourceMappingURL=details-codec.d.ts.map

package/lib/types/supervisor/storage/details-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details-codec.d.ts","sourceRoot":"","sources":["../../../../src/supervisor/storage/details-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,qBAAqB,CAAA;AAI5B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACpC;AAkRD,sEAAsE;AACtE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,0BAA0B,EAAE,MAAM,EAAE,uBAAuB,GAAG,0BAA0B,CAGxI;AAED,qDAAqD;AACrD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,uBAAuB,GAAG,UAAU,CAUxH;AAED,qDAAqD;AACrD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,2BAA2B,CAY/I"}

package/lib/types/supervisor/storage/details-codec.js

@@ -0,0 +1,359 @@
+import { BoundedFileError } from './bounded-file.js';
+import { snapshotWorkflowJsonValue } from '../value-view.js';
+const COMPONENT = /^[a-f0-9]{32}$/u;
+const SAFE_ARTIFACT = /^[A-Za-z0-9][A-Za-z0-9._-]*$/u;
+const OUTCOMES = new Set(['pending', 'available', 'not-produced', 'evicted']);
+const MEMBER_STATUSES = new Set(['running', 'completed', 'failed', 'cancelled']);
+const encoder = new TextEncoder();
+function corrupt(message) {
+    throw new BoundedFileError(message, 'WORKFLOW_STORAGE_CORRUPT');
+}
+function overLimit(message) {
+    throw new BoundedFileError(message, 'WORKFLOW_STORAGE_LIMIT');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function own(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+function exactKeys(value, allowed, required, path) {
+    const accepted = new Set(allowed);
+    for (const key of Object.keys(value))
+        if (!accepted.has(key))
+            corrupt(`${path}.${key} is not allowed`);
+    for (const key of required)
+        if (!own(value, key))
+            corrupt(`${path}.${key} is required`);
+}
+function safeNonNegative(value, path) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0)
+        corrupt(`${path} must be a non-negative safe integer`);
+    return value;
+}
+function nonEmptyText(value, path) {
+    if (typeof value !== 'string' || value.length === 0)
+        corrupt(`${path} must be a non-empty string`);
+    return value;
+}
+function assertLimits(limits) {
+    for (const [name, value] of Object.entries(limits)) {
+        if (!Number.isSafeInteger(value) || value <= 0)
+            overLimit(`${name} must be a positive safe integer`);
+    }
+    if (limits.memberOutcomeMaxBytes > limits.maxRunDetailsBytes
+        || limits.maxTerminalResultBytes > limits.maxRunDetailsBytes
+        || limits.maxLogLineBytes > limits.maxRunDetailsBytes) {
+        overLimit('workflow detail field limits must not exceed maxRunDetailsBytes');
+    }
+}
+function sortObject(value) {
+    if (Array.isArray(value))
+        return value.map(sortObject);
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.keys(value).sort().map(key => [key, sortObject(value[key])]));
+}
+function canonicalBytes(value) {
+    return encoder.encode(`${JSON.stringify(sortObject(value), null, 2)}\n`);
+}
+function compactBytes(value) {
+    return encoder.encode(JSON.stringify(value)).byteLength;
+}
+function prettyValueText(value) {
+    return JSON.stringify(value, null, 2);
+}
+function prettyValueBytes(value) {
+    return encoder.encode(prettyValueText(value)).byteLength;
+}
+function utf8Prefix(text, maxBytes) {
+    let result = '';
+    let retained = 0;
+    for (const point of text) {
+        const bytes = encoder.encode(point).byteLength;
+        if (retained + bytes > maxBytes)
+            break;
+        result += point;
+        retained += bytes;
+    }
+    return result;
+}
+function jsonSnapshot(value, path) {
+    try {
+        return snapshotWorkflowJsonValue(value);
+    }
+    catch (error) {
+        corrupt(`${path} is not lossless JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function validateMember(value, index, limits, enforceQuotas) {
+    const path = `detail.payload.members[${index}]`;
+    if (!isRecord(value))
+        corrupt(`${path} must be an object`);
+    exactKeys(value, ['memberId', 'seq', 'label', 'phase', 'status', 'outcome', 'value', 'childSessionId', 'startedAt', 'settledAt'], ['memberId', 'seq', 'label', 'status', 'outcome'], path);
+    nonEmptyText(value.memberId, `${path}.memberId`);
+    safeNonNegative(value.seq, `${path}.seq`);
+    nonEmptyText(value.label, `${path}.label`);
+    if (own(value, 'phase') && typeof value.phase !== 'string')
+        corrupt(`${path}.phase must be a string`);
+    if (!MEMBER_STATUSES.has(String(value.status)))
+        corrupt(`${path}.status is invalid`);
+    if (!OUTCOMES.has(String(value.outcome)))
+        corrupt(`${path}.outcome is invalid`);
+    if (own(value, 'childSessionId'))
+        nonEmptyText(value.childSessionId, `${path}.childSessionId`);
+    const startedAt = own(value, 'startedAt') ? safeNonNegative(value.startedAt, `${path}.startedAt`) : undefined;
+    const settledAt = own(value, 'settledAt') ? safeNonNegative(value.settledAt, `${path}.settledAt`) : undefined;
+    if (startedAt !== undefined && settledAt !== undefined && settledAt < startedAt)
+        corrupt(`${path}.settledAt precedes startedAt`);
+    if (value.status === 'running' && settledAt !== undefined)
+        corrupt(`${path} is running but settled`);
+    if (value.outcome === 'available') {
+        if (!own(value, 'value'))
+            corrupt(`${path}.value is required for an available outcome`);
+        const snapshot = jsonSnapshot(value.value, `${path}.value`);
+        if (enforceQuotas && prettyValueBytes(snapshot) > limits.memberOutcomeMaxBytes)
+            overLimit(`${path}.value exceeds the member outcome limit`);
+    }
+    else if (own(value, 'value')) {
+        corrupt(`${path}.value is forbidden for outcome ${String(value.outcome)}`);
+    }
+    return value;
+}
+function validateResult(value, limits, enforceQuotas) {
+    const path = 'detail.payload.result';
+    if (!isRecord(value))
+        corrupt(`${path} must be an object`);
+    exactKeys(value, ['state', 'value', 'preview', 'totalBytes', 'truncated'], ['state'], path);
+    if (!OUTCOMES.has(String(value.state)))
+        corrupt(`${path}.state is invalid`);
+    if (value.state !== 'available') {
+        if (Object.keys(value).some(key => key !== 'state'))
+            corrupt(`${path} non-available state carries a projection`);
+        return;
+    }
+    const hasValue = own(value, 'value');
+    const hasPreview = own(value, 'preview');
+    if (hasValue === hasPreview)
+        corrupt(`${path} must contain exactly one of value or preview`);
+    if (hasValue) {
+        const snapshot = jsonSnapshot(value.value, `${path}.value`);
+        const totalBytes = prettyValueBytes(snapshot);
+        if (enforceQuotas && totalBytes > limits.maxTerminalResultBytes)
+            overLimit(`${path}.value exceeds the terminal result limit`);
+        if (own(value, 'truncated') && value.truncated !== false)
+            corrupt(`${path}.truncated must be false with value`);
+        if (own(value, 'totalBytes') && safeNonNegative(value.totalBytes, `${path}.totalBytes`) !== totalBytes)
+            corrupt(`${path}.totalBytes does not match value`);
+    }
+    else {
+        if (typeof value.preview !== 'string')
+            corrupt(`${path}.preview must be a string`);
+        if (value.truncated !== true)
+            corrupt(`${path}.truncated must be true with preview`);
+        const totalBytes = safeNonNegative(value.totalBytes, `${path}.totalBytes`);
+        const previewBytes = encoder.encode(value.preview).byteLength;
+        if (previewBytes > totalBytes)
+            corrupt(`${path}.preview exceeds totalBytes`);
+        if (enforceQuotas && previewBytes > limits.maxTerminalResultBytes)
+            overLimit(`${path}.preview exceeds the terminal result limit`);
+    }
+}
+function validatePayload(value, limits, enforceQuotas) {
+    if (!isRecord(value))
+        corrupt('detail.payload must be an object');
+    exactKeys(value, ['members', 'logs', 'result', 'phases', 'artifacts'], [], 'detail.payload');
+    if (own(value, 'members')) {
+        if (!Array.isArray(value.members))
+            corrupt('detail.payload.members must be an array');
+        const ids = new Set();
+        const sequences = new Set();
+        for (let index = 0; index < value.members.length; index += 1) {
+            const member = validateMember(value.members[index], index, limits, enforceQuotas);
+            const id = member.memberId;
+            const seq = member.seq;
+            if (ids.has(id))
+                corrupt(`detail.payload.members[${index}].memberId is duplicated`);
+            if (sequences.has(seq))
+                corrupt(`detail.payload.members[${index}].seq is duplicated`);
+            ids.add(id);
+            sequences.add(seq);
+        }
+    }
+    if (own(value, 'logs')) {
+        if (!Array.isArray(value.logs))
+            corrupt('detail.payload.logs must be an array');
+        let previous;
+        for (let index = 0; index < value.logs.length; index += 1) {
+            const path = `detail.payload.logs[${index}]`;
+            const log = value.logs[index];
+            if (!isRecord(log))
+                corrupt(`${path} must be an object`);
+            exactKeys(log, ['index', 'text'], ['index', 'text'], path);
+            const current = safeNonNegative(log.index, `${path}.index`);
+            if (previous !== undefined && current !== previous + 1)
+                corrupt(`${path}.index is not contiguous`);
+            previous = current;
+            if (typeof log.text !== 'string')
+                corrupt(`${path}.text must be a string`);
+            if (enforceQuotas && encoder.encode(log.text).byteLength > limits.maxLogLineBytes)
+                overLimit(`${path}.text exceeds the log line limit`);
+        }
+    }
+    if (own(value, 'result'))
+        validateResult(value.result, limits, enforceQuotas);
+    if (own(value, 'phases')) {
+        if (!Array.isArray(value.phases))
+            corrupt('detail.payload.phases must be an array');
+        for (let index = 0; index < value.phases.length; index += 1) {
+            const path = `detail.payload.phases[${index}]`;
+            const phase = value.phases[index];
+            if (!isRecord(phase))
+                corrupt(`${path} must be an object`);
+            exactKeys(phase, ['title', 'startedAt', 'endedAt'], ['title'], path);
+            nonEmptyText(phase.title, `${path}.title`);
+            const startedAt = own(phase, 'startedAt') ? safeNonNegative(phase.startedAt, `${path}.startedAt`) : undefined;
+            const endedAt = own(phase, 'endedAt') ? safeNonNegative(phase.endedAt, `${path}.endedAt`) : undefined;
+            if (startedAt !== undefined && endedAt !== undefined && endedAt < startedAt)
+                corrupt(`${path}.endedAt precedes startedAt`);
+        }
+    }
+    if (own(value, 'artifacts')) {
+        if (!Array.isArray(value.artifacts))
+            corrupt('detail.payload.artifacts must be an array');
+        const names = new Set();
+        for (let index = 0; index < value.artifacts.length; index += 1) {
+            const path = `detail.payload.artifacts[${index}]`;
+            const artifact = value.artifacts[index];
+            if (!isRecord(artifact))
+                corrupt(`${path} must be an object`);
+            exactKeys(artifact, ['name', 'bytes'], ['name', 'bytes'], path);
+            const name = nonEmptyText(artifact.name, `${path}.name`);
+            if (!SAFE_ARTIFACT.test(name) || name === '.' || name === '..')
+                corrupt(`${path}.name is unsafe`);
+            if (names.has(name))
+                corrupt(`${path}.name is duplicated`);
+            names.add(name);
+            safeNonNegative(artifact.bytes, `${path}.bytes`);
+        }
+    }
+}
+function validateSnapshot(value, limits, enforceQuotas) {
+    if (!isRecord(value))
+        corrupt('detail snapshot must be an object');
+    exactKeys(value, ['version', 'sessionId', 'runId', 'runDirectory', 'detailId', 'snapshotRevision', 'payload'], ['version', 'sessionId', 'runId', 'runDirectory', 'detailId', 'snapshotRevision', 'payload'], 'detail');
+    if (value.version !== 2)
+        corrupt('detail.version must be 2');
+    nonEmptyText(value.sessionId, 'detail.sessionId');
+    nonEmptyText(value.runId, 'detail.runId');
+    if (typeof value.runDirectory !== 'string' || !COMPONENT.test(value.runDirectory))
+        corrupt('detail.runDirectory is unsafe');
+    if (typeof value.detailId !== 'string' || !COMPONENT.test(value.detailId))
+        corrupt('detail.detailId is unsafe');
+    safeNonNegative(value.snapshotRevision, 'detail.snapshotRevision');
+    validatePayload(value.payload, limits, enforceQuotas);
+}
+function normalizePayload(value, limits) {
+    validatePayload(value, limits, false);
+    const output = {};
+    if (value.members !== undefined) {
+        output.members = [...value.members].sort((left, right) => left.seq - right.seq).map(member => {
+            const detached = { ...member };
+            if (member.outcome === 'available' && own(member, 'value')) {
+                const snapshot = jsonSnapshot(member.value, `member ${member.memberId} value`);
+                if (prettyValueBytes(snapshot) > limits.memberOutcomeMaxBytes) {
+                    delete detached.value;
+                    detached.outcome = 'evicted';
+                }
+                else
+                    detached.value = snapshot;
+            }
+            return detached;
+        });
+    }
+    if (value.logs !== undefined) {
+        output.logs = [...value.logs].sort((left, right) => left.index - right.index)
+            .map(log => ({ ...log, text: utf8Prefix(log.text, limits.maxLogLineBytes) }));
+    }
+    if (value.result !== undefined) {
+        if (value.result.state === 'available' && own(value.result, 'value')) {
+            const snapshot = jsonSnapshot(value.result.value, 'terminal result');
+            const text = prettyValueText(snapshot);
+            const totalBytes = encoder.encode(text).byteLength;
+            output.result = totalBytes <= limits.maxTerminalResultBytes
+                ? { state: 'available', value: snapshot, totalBytes, truncated: false }
+                : { state: 'available', preview: utf8Prefix(text, limits.maxTerminalResultBytes), totalBytes, truncated: true };
+        }
+        else
+            output.result = { ...value.result };
+    }
+    if (value.phases !== undefined)
+        output.phases = value.phases.map(phase => ({ ...phase }));
+    if (value.artifacts !== undefined) {
+        output.artifacts = [...value.artifacts].sort((left, right) => left.name.localeCompare(right.name)).map(artifact => ({ ...artifact }));
+    }
+    return output;
+}
+function fitPayload(initial, fits) {
+    let output = initial;
+    let logs = output.logs === undefined ? undefined : [...output.logs];
+    let members = output.members === undefined ? undefined : [...output.members];
+    // Preserve the newest bounded log when member bodies can make the snapshot
+    // fit.  Older log bodies are always evicted before any member body; the
+    // final log is removed only when no outcome eviction is sufficient.
+    while (!fits(output) && logs !== undefined && logs.length > 1) {
+        logs = logs.slice(1);
+        output = { ...output, logs };
+    }
+    while (!fits(output) && members !== undefined) {
+        const index = members.findIndex(member => member.outcome === 'available' && own(member, 'value'));
+        if (index < 0)
+            break;
+        const member = { ...members[index], outcome: 'evicted' };
+        delete member.value;
+        members[index] = member;
+        output = { ...output, members };
+    }
+    while (!fits(output) && logs !== undefined && logs.length > 0) {
+        logs = logs.slice(1);
+        output = { ...output, logs };
+    }
+    if (!fits(output))
+        overLimit('fixed workflow detail metadata exceeds the run limit');
+    return output;
+}
+/** Deterministically compact a detail payload to its fixed quotas. */
+export function compactWorkflowRunDetails(value, limits) {
+    assertLimits(limits);
+    return fitPayload(normalizePayload(value, limits), payload => compactBytes(payload) <= limits.maxRunDetailsBytes);
+}
+/** Encode one immutable version-2 detail sidecar. */
+export function encodeWorkflowRunDetails(value, limits) {
+    assertLimits(limits);
+    validateSnapshot(value, limits, false);
+    const normalized = normalizePayload(value.payload, limits);
+    const payload = fitPayload(normalized, candidate => canonicalBytes({ ...value, payload: candidate }).byteLength <= limits.maxRunDetailsBytes);
+    const compact = { ...value, payload };
+    validateSnapshot(compact, limits, true);
+    const bytes = canonicalBytes(compact);
+    if (bytes.byteLength > limits.maxRunDetailsBytes)
+        overLimit('workflow detail snapshot exceeds the run limit');
+    return bytes;
+}
+/** Decode one immutable version-2 detail sidecar. */
+export function decodeWorkflowRunDetails(input, file, limits) {
+    assertLimits(limits);
+    const bytes = typeof input === 'string' ? encoder.encode(input) : input;
+    if (bytes.byteLength > limits.maxRunDetailsBytes)
+        overLimit(`${file} exceeds the ${limits.maxRunDetailsBytes}-byte run detail limit`);
+    let value;
+    try {
+        value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
+    }
+    catch (error) {
+        throw new BoundedFileError(`${file} is malformed UTF-8 or JSON`, 'WORKFLOW_STORAGE_CORRUPT', { cause: error });
+    }
+    validateSnapshot(value, limits, true);
+    return value;
+}
+//# sourceMappingURL=details-codec.js.map

package/lib/types/supervisor/storage/details-codec.js.map

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

package/lib/types/supervisor/storage/index.d.ts

@@ -0,0 +1,26 @@
+import { type ResolvedWorkflowPackageConfig } from '../../config.js';
+import { type WorkflowStorageAnchor, type WorkflowStorageLease } from './lease.js';
+import { type WorkflowStorageLayout } from './private-root.js';
+import { FileWorkflowRunStore } from './manifest-store.js';
+import type { RecoveredRun } from './manifest-types.js';
+export * from './lease.js';
+export * from './private-root.js';
+export * from './bounded-file.js';
+export * from './manifest-types.js';
+export * from './manifest-codec.js';
+export * from './details-codec.js';
+export * from './manifest-store.js';
+export * from './run-files.js';
+export * from './recovery.js';
+export interface WorkflowStorage {
+    readonly anchor: WorkflowStorageAnchor;
+    readonly lease: WorkflowStorageLease;
+    readonly layout: WorkflowStorageLayout;
+    readonly store: FileWorkflowRunStore;
+    /** Interrupted inspection rows from the first eager recovery pass. */
+    readonly recovered: readonly RecoveredRun[];
+    dispose(): Promise<void>;
+}
+/** Bootstrap the leased storage root and eagerly recover retained state. */
+export declare function openWorkflowStorage(config: ResolvedWorkflowPackageConfig, hostFileSystem?: unknown): Promise<WorkflowStorage>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/supervisor/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/supervisor/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,6BAA6B,EAAE,MAAM,iBAAiB,CAAA;AAClG,OAAO,EAA0D,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAC1I,OAAO,EAA0F,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACtJ,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,cAAc,YAAY,CAAC;AAAC,cAAc,mBAAmB,CAAC;AAAC,cAAc,mBAAmB,CAAC;AAAC,cAAc,qBAAqB,CAAC;AAAC,cAAc,qBAAqB,CAAC;AAAC,cAAc,oBAAoB,CAAC;AAAC,cAAc,qBAAqB,CAAC;AAAC,cAAc,gBAAgB,CAAC;AAAC,cAAc,eAAe,CAAA;AAClT,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAA;IAC3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AACD,4EAA4E;AAC5E,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,6BAA6B,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CA+DnI"}