@overkill-dev/run 0.0.64 → 0.0.66

package/run/attachment-run.js

@@ -0,0 +1,36 @@
+import { createAttachmentStorageSession } from "./attachment-storage-session.js";
+import { createAttachmentRecord } from "./attachment-record.js";
+import { createAttachmentRunCoordinator } from "./attachment-coordinator.js";
+import { runWithAttachmentExecution } from "./resource-lifecycle-state.js";
+import { runWithAttachmentCoordinator } from "./attachment-coordinator-context.js";
+import { runHasAttachmentScopes } from "./attachment-eligibility.js";
+async function executeAttachmentSession(record, coordinator, run) {
+    try {
+        const result = await runWithAttachmentCoordinator(coordinator, async function () {
+            return runWithAttachmentExecution(coordinator.execution, run);
+        });
+        return await record.session.complete(await coordinator.finalize(result));
+    }
+    catch (error) {
+        await coordinator.close();
+        try {
+            await record.checkpoint(coordinator.artifacts());
+        }
+        finally {
+            await record.session.interrupt(error);
+        }
+        throw error;
+    }
+    finally {
+        await coordinator.close();
+    }
+}
+export async function executeWithAttachments(resolved, dependencies, run) {
+    if (!runHasAttachmentScopes(resolved)) {
+        return await run();
+    }
+    const record = await createAttachmentRecord(resolved, dependencies);
+    const coordinator = createAttachmentRunCoordinator(await createAttachmentStorageSession(resolved, record));
+    return await executeAttachmentSession(record, coordinator, run);
+}
+//# sourceMappingURL=attachment-run.js.map

package/run/attachment-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-run.js","sourceRoot":"","sources":["../../../../source/run/attachment-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,8BAA8B,EAAiC,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,KAAK,UAAU,wBAAwB,CACnC,MAAwB,EACxB,WAAqC,EACrC,GAA6B;IAE7B,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAC7C,WAAW,EACX,KAAK;YACD,OAAO,0BAA0B,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC,CACJ,CAAC;QACF,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;gBAAS,CAAC;YACP,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,QAAqB,EACrB,YAAyC,EACzC,GAA6B;IAE7B,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,MAAM,GAAG,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,8BAA8B,CAAC,MAAM,8BAA8B,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3G,OAAO,MAAM,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC"}

package/run/attachment-server.js

@@ -0,0 +1,136 @@
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:net';
+import { createInterface } from 'node:readline';
+import { createStoredRunValue } from "./supervised-run-state.js";
+import { attachmentMaxFrameBytes, attachmentMaxPendingRequests } from "./attachment-protocol.js";
+import { attachmentRequestSchema } from "./attachment-wire-schema.js";
+import { boundedAttachmentFrames } from "./attachment-frames.js";
+async function attachmentServerChannelsReply(state, line, socket, channel) {
+    const { store } = state;
+    const value = JSON.parse(line);
+    const request = attachmentRequestSchema.parse(value);
+    if (request.token !== state.token) {
+        throw new Error('Invalid attachment execution token.');
+    }
+    const result = await store.exchange(channel, request.operation);
+    await new Promise(function acknowledgeAttachment(resolve, reject) {
+        socket.write(`${JSON.stringify({ request: request.request, result })}\n`, function attachmentSent(error) {
+            if (error === undefined || error === null) {
+                resolve();
+            }
+            else {
+                reject(error);
+            }
+        });
+    });
+}
+async function attachmentServerChannelsRequest(state, request) {
+    const { line, socket, channel, previous } = request;
+    await previous;
+    try {
+        await attachmentServerChannelsReply(state, line, socket, channel);
+    }
+    catch {
+        socket.destroy();
+    }
+    finally {
+        request.queued.write(request.queued.read() - 1);
+    }
+}
+async function attachmentServerChannelsInterrupt(state, channel, previous) {
+    const { abandoned, store } = state;
+    await previous;
+    abandoned.push(...await store.finish(channel));
+}
+function observeAttachmentChannelFailures(socket, frames, lines) {
+    frames.on('error', function () {
+        socket.destroy();
+    });
+    lines.on('error', function () {
+        socket.destroy();
+    });
+    socket.on('error', function () {
+        socket.destroy();
+    });
+}
+function attachmentServerChannelsAccept(state, socket) {
+    const { sockets } = state;
+    sockets.add(socket);
+    const channel = randomUUID();
+    const frames = boundedAttachmentFrames(attachmentMaxFrameBytes);
+    const lines = createInterface({ input: socket.pipe(frames), crlfDelay: Number.POSITIVE_INFINITY });
+    let queue = Promise.resolve();
+    const queued = createStoredRunValue(0);
+    observeAttachmentChannelFailures(socket, frames, lines);
+    lines.on('line', function receiveAttachmentLine(line) {
+        if (queued.read() >= attachmentMaxPendingRequests) {
+            socket.destroy();
+            return;
+        }
+        queued.write(queued.read() + 1);
+        state.operations.delete(queue);
+        queue = attachmentServerChannelsRequest(state, { line, socket, channel, previous: queue, queued });
+        state.operations.add(queue);
+    });
+    socket.on('close', function attachmentChannelClosed() {
+        sockets.delete(socket);
+        lines.close();
+        state.operations.delete(queue);
+        const interrupted = attachmentServerChannelsInterrupt(state, channel, queue);
+        state.operations.add(interrupted);
+    });
+}
+async function attachmentServerChannelsFinish(state, server) {
+    const { store } = state;
+    await Promise.all(state.operations.values());
+    const owners = [...state.abandoned.values(), ...await store.finish(null)];
+    for (const socket of state.sockets.values()) {
+        socket.destroy();
+    }
+    await new Promise(function closeAttachmentServer(resolve, reject) {
+        server.close(function attachmentServerClosed(error) {
+            if (error === undefined) {
+                resolve();
+            }
+            else {
+                reject(error);
+            }
+        });
+    });
+    await Promise.all(state.operations.values());
+    return owners;
+}
+function createAttachmentServerChannels(store, token) {
+    const sockets = new Set();
+    const operations = new Set();
+    const abandoned = [];
+    const state = { store, token, sockets, operations, abandoned };
+    return {
+        accept: attachmentServerChannelsAccept.bind(null, state),
+        finish: attachmentServerChannelsFinish.bind(null, state)
+    };
+}
+export async function createAttachmentServer(store, limits) {
+    const token = randomUUID();
+    const channels = createAttachmentServerChannels(store, token);
+    const server = createServer(function (socket) {
+        channels.accept(socket);
+    });
+    await new Promise(function listenForAttachments(resolve, reject) {
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', resolve);
+    });
+    const address = server.address();
+    if (address === null || typeof address === 'string') {
+        throw new Error('Attachment server did not obtain an execution address.');
+    }
+    let finishing = null;
+    return {
+        endpoint: { branch: null, limits, port: address.port, token },
+        async finish() {
+            finishing = finishing ?? channels.finish(server);
+            return await finishing;
+        }
+    };
+}
+//# sourceMappingURL=attachment-server.js.map

package/run/attachment-server.js.map

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

package/run/attachment-storage-session.js

@@ -0,0 +1,22 @@
+import path from 'node:path';
+import { createAttachmentStore } from "./attachment-store.js";
+import { createAttachmentServer } from "./attachment-server.js";
+export async function createAttachmentStorageSession(resolved, record) {
+    const limits = resolved.facts.execution.attachments;
+    if (limits === null) {
+        throw new TypeError('Runtime attachments require integration limits.');
+    }
+    const store = createAttachmentStore({
+        witnessDirectory: path.resolve(resolved.facts.environment.projectRoot, resolved.config.runtimeStateDir, 'witnesses', record.session.id),
+        captureTime: record.captureTime,
+        checkpoint: record.checkpoint,
+        directory: path.resolve(resolved.facts.environment.projectRoot, resolved.config.runtimeStateDir, 'runs', record.session.id, 'artifacts'),
+        limits,
+        projectRoot: resolved.facts.environment.projectRoot,
+        work: resolved.facts.cases.map(function workIdentity(entry) {
+            return entry.workId;
+        })
+    });
+    return { resolved, server: await createAttachmentServer(store, limits), store };
+}
+//# sourceMappingURL=attachment-storage-session.js.map

package/run/attachment-storage-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-storage-session.js","sourceRoot":"","sources":["../../../../source/run/attachment-storage-session.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAwB,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,wBAAwB,CAAC;AASvF,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAChD,QAAqB,EACrB,MAAwB;IAExB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;IACpD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,KAAK,GAAG,qBAAqB,CAAC;QAChC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAC1B,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EACtC,QAAQ,CAAC,MAAM,CAAC,eAAe,EAC/B,WAAW,EACX,MAAM,CAAC,OAAO,CAAC,EAAE,CACpB;QACD,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,IAAI,CAAC,OAAO,CACnB,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EACtC,QAAQ,CAAC,MAAM,CAAC,eAAe,EAC/B,MAAM,EACN,MAAM,CAAC,OAAO,CAAC,EAAE,EACjB,WAAW,CACd;QACD,MAAM;QACN,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW;QACnD,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,YAAY,CAAC,KAAK;YACtD,OAAO,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC;KACL,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;AACpF,CAAC"}

package/run/attachment-storage-writer.js

@@ -0,0 +1,128 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { attachmentScopeKey } from "./attachment-protocol.js";
+import { createStoredRunValue } from "./supervised-run-state.js";
+export function createAttachmentScopeBudget() {
+    const bytes = createStoredRunValue(0);
+    const count = createStoredRunValue(0);
+    function reserve(limits) {
+        if (count.read() >= limits.maxScopeAttachments) {
+            throw new Error('Attachment count limit exceeded.');
+        }
+        count.write(count.read() + 1);
+    }
+    function available(limits) {
+        return limits.maxScopeBytes - bytes.read();
+    }
+    function retained(retainedBytes) {
+        bytes.write(bytes.read() + retainedBytes);
+    }
+    return {
+        reserve,
+        available,
+        retained,
+        release(releasedBytes) {
+            bytes.write(Math.max(0, bytes.read() - releasedBytes));
+            count.write(Math.max(0, count.read() - 1));
+        }
+    };
+}
+function storedAttachmentArtifact(state) {
+    const { initial, retention } = state;
+    return { ...state.initial, payload: { ...initial.payload, content: retention.content() } };
+}
+async function storedAttachmentClose(state, reason) {
+    const { closed, retention } = state;
+    if (closed.read()) {
+        return;
+    }
+    closed.write(true);
+    await retention.finish(reason === 'complete' ? { kind: 'complete' } : { kind: 'incomplete', reason });
+}
+async function storedAttachmentInterrupt(state, reason) {
+    const { closed, retention, failed } = state;
+    if (closed.read()) {
+        return null;
+    }
+    closed.write(true);
+    await retention.finish({ kind: 'incomplete', reason });
+    return failed.read() ? null : state.owner;
+}
+function storedAttachmentAssertOpen(state) {
+    const { closed, failed } = state;
+    if (closed.read() || failed.read()) {
+        throw new Error('Attachment writer is closed.');
+    }
+}
+function storedAttachmentOmit(state) {
+    const { retention } = state;
+    storedAttachmentAssertOpen(state);
+    retention.omit();
+}
+async function storedAttachmentRetain(state, bytes, limits) {
+    const { retention, budget, failed } = state;
+    try {
+        return await retention.retain(bytes, budget.available(limits));
+    }
+    catch (error) {
+        failed.write(true);
+        await storedAttachmentClose(state, 'write-error');
+        throw error;
+    }
+}
+function retainChargedBytes(state, retained) {
+    state.budget.retained(retained);
+    state.charged.write(state.charged.read() + retained);
+}
+async function storedAttachmentWrite(state, data, limits) {
+    const { initial, failed, retention } = state;
+    storedAttachmentAssertOpen(state);
+    const bytes = Buffer.from(data, 'base64');
+    const retained = await storedAttachmentRetain(state, bytes, limits);
+    retainChargedBytes(state, retained);
+    if (retained < bytes.length && initial.payload.content.kind === 'file') {
+        failed.write(true);
+        await retention.finish({ kind: 'incomplete', reason: 'byte-limit' });
+        return { kind: 'error', message: 'Binary attachment byte limit exceeded.', reason: 'byte-limit' };
+    }
+    return { kind: 'written' };
+}
+export function createStoredAttachment(channel, operation, content) {
+    const { initial, retention, budget } = content;
+    const branch = operation.branch;
+    const owner = operation.owner;
+    const closed = createStoredRunValue(false);
+    const failed = createStoredRunValue(false);
+    const state = {
+        channel,
+        operation,
+        initial,
+        retention,
+        budget,
+        branch,
+        owner,
+        closed,
+        failed,
+        charged: createStoredRunValue(0)
+    };
+    return {
+        release() {
+            budget.release(state.charged.read());
+        },
+        channel: state.channel,
+        branch: state.branch,
+        owner: state.owner,
+        artifact: storedAttachmentArtifact.bind(null, state),
+        close: storedAttachmentClose.bind(null, state),
+        interrupt: storedAttachmentInterrupt.bind(null, state),
+        omit: storedAttachmentOmit.bind(null, state),
+        write: storedAttachmentWrite.bind(null, state)
+    };
+}
+export function retainedAttachmentPath(options, operation, writer) {
+    const folder = createHash('sha256').update(attachmentScopeKey(operation.owner)).digest('hex');
+    return operation.kind === 'prepare' && operation.subtype === 'witness'
+        ? path.join(options.witnessDirectory, folder, operation.owner.kind === 'case' ? `attempt-${operation.owner.attempt.index}` : 'run', `${writer}.witness.json`)
+        : path.join(options.directory, folder, `${writer}.attachment.bin`);
+}
+//# sourceMappingURL=attachment-storage-writer.js.map

package/run/attachment-storage-writer.js.map

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

package/run/attachment-store.js

@@ -0,0 +1,287 @@
+import { rm } from 'node:fs/promises';
+import path from 'node:path';
+import { workIdentityKey } from "../engine/identity.js";
+import { createFailureArtifactRetention } from "./failure-artifact-retention.js";
+import { retainedAttachmentPath, createAttachmentScopeBudget, createStoredAttachment } from "./attachment-storage-writer.js";
+import { createStoredRunValue } from "./supervised-run-state.js";
+import { attachmentScopeKey, attachmentMetadataBytes } from "./attachment-protocol.js";
+import { createAttachmentRetention } from "./attachment-retention.js";
+function attachmentId(owner, sequence) {
+    if (owner.kind === 'run') {
+        return { attempt: null, runtimes: [], scope: { kind: 'run' }, sequence, subtype: 'attachment', workload: null };
+    }
+    return {
+        attempt: owner.attempt,
+        runtimes: owner.work.runtimes,
+        scope: { activeCases: [owner.work.case], case: owner.work.case, confidence: 'active-case', kind: 'case' },
+        sequence,
+        subtype: 'attachment',
+        workload: owner.work.workload
+    };
+}
+const firstPrintableCodePoint = 32;
+const deleteCodePoint = 127;
+function isControlCharacter(character) {
+    const code = character.codePointAt(0) ?? 0;
+    return code < firstPrintableCodePoint || code === deleteCodePoint;
+}
+function validateMetadata(operation) {
+    for (const value of [operation.metadata.name, operation.metadata.mediaType]) {
+        if (value.length === 0 || Buffer.byteLength(value) > attachmentMetadataBytes ||
+            Array.from(value).some(isControlCharacter)) {
+            throw new TypeError('Attachment names and media types require 1 to 256 bytes without control characters.');
+        }
+    }
+}
+function runAttachmentStoreArtifacts(state) {
+    const { writers } = state;
+    return Array.from(writers.values(), function currentArtifact(writer) {
+        return writer.artifact();
+    });
+}
+function runAttachmentStoreRegisterBranch(state, branch, retain) {
+    const { branches } = state;
+    branches.set(branch, retain);
+}
+function retainedArtifact(writer) {
+    const artifact = writer.artifact();
+    return artifact.payload.capture === 'opt-in' ? artifact : {
+        ...artifact,
+        payload: { ...artifact.payload, retention: { ...artifact.payload.retention, state: 'retained' } }
+    };
+}
+function runAttachmentStoreBranchArtifacts(state, branch) {
+    const { writers } = state;
+    return Array
+        .from(writers.values())
+        .filter(function inBranch(writer) {
+        return writer.branch === branch && state.failureRetention.retains(writer);
+    })
+        .map(retainedArtifact);
+}
+function runAttachmentStoreRetainsBranch(state, branch) {
+    return branch === null || state.branches.get(branch)?.() === true;
+}
+function runAttachmentStoreRetains(state, writer) {
+    const artifact = writer.artifact();
+    return runAttachmentStoreRetainsBranch(state, writer.branch) &&
+        (artifact.payload.capture === 'opt-in' || state.failureRetention.retains(writer));
+}
+function runAttachmentStoreSelectedArtifacts(state) {
+    const { writers } = state;
+    return Array
+        .from(writers.values())
+        .filter(function (writer) {
+        return runAttachmentStoreRetains(state, writer);
+    })
+        .map(retainedArtifact);
+}
+function runAttachmentStoreValidateOwner(state, operation) {
+    const { branches, planned } = state;
+    validateMetadata(operation);
+    if (operation.branch !== null && !branches.has(operation.branch)) {
+        throw new TypeError('Unknown attachment execution branch.');
+    }
+    if (operation.owner.kind === 'case' && !planned.has(workIdentityKey(operation.owner.work))) {
+        throw new TypeError('Attachment owner is outside the selected work.');
+    }
+}
+function runAttachmentStoreScopeBudget(state, channel, operation) {
+    const { budgets, options } = state;
+    const key = operation.owner.kind === 'run'
+        ? 'run'
+        : `${operation.branch ?? channel}:${attachmentScopeKey(operation.owner)}`;
+    const budget = budgets.get(key) ?? createAttachmentScopeBudget();
+    budgets.set(key, budget);
+    budget.reserve(options.limits);
+    return budget;
+}
+function runAttachmentStoreInitialArtifact(state, operation, writer, retention) {
+    return {
+        id: {
+            ...attachmentId(operation.owner, writer),
+            subtype: operation.kind === 'prepare' ? operation.subtype : 'attachment'
+        },
+        source: operation.kind === 'prepare' ? operation.source : 'instrumented',
+        payload: {
+            ...operation.metadata,
+            ...operation.kind === 'prepare'
+                ? {
+                    capture: 'automatic',
+                    retention: { condition: operation.condition, state: 'prepared' }
+                }
+                : { capture: 'opt-in' },
+            capturedAtMicroseconds: state.options.captureTime(),
+            content: retention.content(),
+            kind: 'runtime-attachment',
+            producer: operation.producer
+        }
+    };
+}
+async function createRetainedAttachment(state, creation) {
+    const { channel, operation, writer, filePath, limit, budget } = creation;
+    const retention = await createAttachmentRetention(operation.contentKind, state.options.projectRoot, filePath, limit);
+    try {
+        return createStoredAttachment(channel, operation, {
+            initial: runAttachmentStoreInitialArtifact(state, operation, writer, retention),
+            retention,
+            budget
+        });
+    }
+    catch (error) {
+        await retention.finish({ kind: 'incomplete', reason: 'write-error' });
+        await rm(filePath, { force: true });
+        throw error;
+    }
+}
+async function runAttachmentStoreCreateWriter(state, channel, operation) {
+    const { sequence, options, writers } = state;
+    const budget = runAttachmentStoreScopeBudget(state, channel, operation);
+    const writer = sequence.read();
+    sequence.write(sequence.read() + 1);
+    const filePath = retainedAttachmentPath(options, operation, writer);
+    const limit = operation.contentKind === 'binary' || operation.kind === 'prepare' && operation.subtype === 'witness'
+        ? options.limits.maxArtifactBytes
+        : options.limits.maxInlineBytes;
+    writers.set(writer, await createRetainedAttachment(state, { channel, operation, writer, filePath, limit, budget }));
+    return writer;
+}
+async function runAttachmentStoreStart(state, channel, operation) {
+    const { options } = state;
+    runAttachmentStoreValidateOwner(state, operation);
+    const writer = await runAttachmentStoreCreateWriter(state, channel, operation);
+    if (operation.contentKind === 'binary') {
+        await options.checkpoint(runAttachmentStoreArtifacts(state));
+    }
+    return { kind: 'opened', writer };
+}
+async function checkpointCapturedWrite(state, writer, data) {
+    const response = await writer.write(data, state.options.limits);
+    if (writer.artifact().payload.capture === 'automatic') {
+        await state.options.checkpoint(runAttachmentStoreArtifacts(state));
+    }
+    return response;
+}
+async function processAttachmentWriterOperation(state, writer, operation) {
+    if (operation.kind === 'close') {
+        await writer.close(operation.reason);
+        await state.options.checkpoint(runAttachmentStoreArtifacts(state));
+        return { kind: 'closed', artifact: writer.artifact() };
+    }
+    if (operation.kind === 'omit') {
+        writer.omit();
+        return { kind: 'written' };
+    }
+    return await checkpointCapturedWrite(state, writer, operation.data);
+}
+function registerResourceEvidence(state, channel, operation) {
+    if (operation.kind === 'resource-consumer') {
+        if (!state.planned.has(workIdentityKey(operation.work))) {
+            throw new TypeError('Resource consumer is outside selected work.');
+        }
+        state.failureRetention.consume(channel, operation.boundary, operation.work);
+    }
+    else {
+        state.failureRetention.markResourceFailure(channel, operation.boundary);
+    }
+    return { kind: 'written' };
+}
+function isOpenOperation(operation) {
+    return operation.kind === 'open' || operation.kind === 'prepare';
+}
+async function runAttachmentStoreProcessOperation(state, channel, operation) {
+    if (operation.kind === 'resource-consumer' || operation.kind === 'resource-failure') {
+        return registerResourceEvidence(state, channel, operation);
+    }
+    if (isOpenOperation(operation)) {
+        return await runAttachmentStoreStart(state, channel, operation);
+    }
+    const writer = state.writers.get(operation.writer);
+    if (writer?.channel !== channel) {
+        throw new TypeError('Unknown attachment writer.');
+    }
+    return await processAttachmentWriterOperation(state, writer, operation);
+}
+async function runAttachmentStoreExchange(state, channel, operation) {
+    try {
+        return await runAttachmentStoreProcessOperation(state, channel, operation);
+    }
+    catch (error) {
+        return {
+            kind: 'error',
+            message: error instanceof Error ? error.message : 'Attachment operation failed.',
+            reason: 'operation-error'
+        };
+    }
+}
+async function finishStoredAttachment(state, channel, writer) {
+    const owner = await writer.interrupt(channel === null && !state.failureRetention.interrupted() ? 'unclosed' : 'interrupted');
+    return writer.artifact().payload.capture === 'opt-in' && runAttachmentStoreRetains(state, writer) ? owner : null;
+}
+async function runAttachmentStoreFinish(state, channel) {
+    const { writers } = state;
+    const owners = [];
+    const selected = Array.from(writers.values()).filter(function inChannel(writer) {
+        return channel === null || writer.channel === channel;
+    });
+    for (const writer of selected) {
+        const owner = await finishStoredAttachment(state, channel, writer);
+        if (owner !== null) {
+            owners.push(owner);
+        }
+    }
+    return owners;
+}
+async function runAttachmentStorePrune(state, retainedArtifacts) {
+    const { options, writers } = state;
+    const retained = new Set(retainedArtifacts.map(function artifactSequence(artifact) {
+        return artifact.id.sequence;
+    }));
+    const discarded = runAttachmentStoreArtifacts(state).filter(function discardedArtifact(artifact) {
+        return !retained.has(artifact.id.sequence);
+    });
+    for (const artifact of discarded) {
+        if (artifact.payload.content.kind === 'file') {
+            await rm(path.resolve(options.projectRoot, artifact.payload.content.path), { force: true });
+        }
+        writers.get(artifact.id.sequence)?.release();
+        writers.delete(artifact.id.sequence);
+    }
+}
+export function createAttachmentStore(options) {
+    const writers = new Map();
+    const branches = new Map();
+    const budgets = new Map();
+    const planned = new Set(options.work.map(workIdentityKey));
+    const sequence = createStoredRunValue(0);
+    const state = {
+        options,
+        writers,
+        branches,
+        budgets,
+        planned,
+        sequence,
+        failureRetention: createFailureArtifactRetention()
+    };
+    return {
+        settleAttempt: state.failureRetention.settleAttempt,
+        settleResult: state.failureRetention.settleResult,
+        artifacts: runAttachmentStoreArtifacts.bind(null, state),
+        retainsBranch: runAttachmentStoreRetainsBranch.bind(null, state),
+        registerBranch: runAttachmentStoreRegisterBranch.bind(null, state),
+        conflictArtifacts(branch) {
+            return Array
+                .from(writers.values())
+                .filter(function conflictBranch(writer) {
+                return writer.branch === branch;
+            })
+                .map(retainedArtifact);
+        },
+        branchArtifacts: runAttachmentStoreBranchArtifacts.bind(null, state),
+        selectedArtifacts: runAttachmentStoreSelectedArtifacts.bind(null, state),
+        exchange: runAttachmentStoreExchange.bind(null, state),
+        finish: runAttachmentStoreFinish.bind(null, state),
+        prune: runAttachmentStorePrune.bind(null, state)
+    };
+}
+//# sourceMappingURL=attachment-store.js.map