@overkill-dev/resources 0.0.10 → 0.0.12

package/attachments/attachment-context.d.ts

@@ -0,0 +1,12 @@
+import type { AttachmentProducer, AttachmentLimits, FailureArtifactCondition, RuntimeAttachments } from '../engine/runtime-attachment.ts';
+export type AttachmentContext = {
+    readonly limits: AttachmentLimits;
+    readonly prepareForProducer: (producer: AttachmentProducer, condition: FailureArtifactCondition, source: 'boundary-captured' | 'instrumented' | 'native', subtype: 'attachment' | 'witness') => RuntimeAttachments;
+    readonly forProducer: (producer: AttachmentProducer) => RuntimeAttachments;
+};
+export declare function attachmentsForProducer(producer: AttachmentProducer): RuntimeAttachments;
+export declare function resourceAttachments(name: string): RuntimeAttachments;
+export declare function runWithAttachmentContext<Value>(context: AttachmentContext, run: () => Promise<Value>): Promise<Value>;
+export declare function preparedResourceAttachments(name: string, condition: FailureArtifactCondition, source: 'boundary-captured' | 'instrumented' | 'native', subtype: 'attachment' | 'witness'): RuntimeAttachments | null;
+export declare function currentAttachmentLimits(): AttachmentLimits | null;
+//# sourceMappingURL=attachment-context.d.ts.map

package/attachments/attachment-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-context.d.ts","sourceRoot":"","sources":["../../../../source/attachments/attachment-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACrB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,CACzB,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,wBAAwB,EACnC,MAAM,EAAE,mBAAmB,GAAG,cAAc,GAAG,QAAQ,EACvD,OAAO,EAAE,YAAY,GAAG,SAAS,KAChC,kBAAkB,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;CAC9E,CAAC;AA2BF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAEpE;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAChD,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAC1B,OAAO,CAAC,KAAK,CAAC,CAEhB;AAED,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,wBAAwB,EACnC,MAAM,EAAE,mBAAmB,GAAG,cAAc,GAAG,QAAQ,EACvD,OAAO,EAAE,YAAY,GAAG,SAAS,GAClC,kBAAkB,GAAG,IAAI,CAG3B;AAED,wBAAgB,uBAAuB,IAAI,gBAAgB,GAAG,IAAI,CAEjE"}

package/attachments/attachment-context.js

@@ -0,0 +1,41 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const attachmentContextKey = Symbol.for('@overkill-dev/runtime-attachment-context/v1');
+function isAttachmentContextStorage(value) {
+    return value instanceof AsyncLocalStorage;
+}
+function sharedAttachmentContext() {
+    const existing = Reflect.get(globalThis, attachmentContextKey);
+    if (isAttachmentContextStorage(existing)) {
+        return existing;
+    }
+    const created = new AsyncLocalStorage();
+    Object.defineProperty(globalThis, attachmentContextKey, { value: created });
+    return created;
+}
+const attachmentContext = sharedAttachmentContext();
+function unavailableAttachments() {
+    const unavailable = async function rejectUnmanagedAttachment() {
+        throw new TypeError('Runtime attachments require runner-managed integration execution.');
+    };
+    return Object.freeze({ open: unavailable, json: unavailable, file: unavailable });
+}
+export function attachmentsForProducer(producer) {
+    return attachmentContext.getStore()?.forProducer(producer) ?? unavailableAttachments();
+}
+export function resourceAttachments(name) {
+    return attachmentsForProducer({ kind: 'resource', name });
+}
+export async function runWithAttachmentContext(context, run) {
+    return await attachmentContext.run(context, run);
+}
+export function preparedResourceAttachments(name, condition, source, subtype) {
+    return attachmentContext.getStore()?.prepareForProducer({ kind: 'resource', name }, condition, source, subtype) ??
+        null;
+}
+export function currentAttachmentLimits() {
+    return attachmentContext.getStore()?.limits ?? null;
+}
+export function currentAttachmentContext() {
+    return attachmentContext.getStore() ?? null;
+}
+//# sourceMappingURL=attachment-context.js.map

package/attachments/attachment-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-context.js","sourceRoot":"","sources":["../../../../source/attachments/attachment-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAoBrD,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;AAEvF,SAAS,0BAA0B,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC9C,CAAC;AACD,SAAS,uBAAuB;IAC5B,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;IACxE,IAAI,0BAA0B,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAqB,CAAC;IAC3D,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC;AACnB,CAAC;AACD,MAAM,iBAAiB,GAAG,uBAAuB,EAAE,CAAC;AAEpD,SAAS,sBAAsB;IAC3B,MAAM,WAAW,GAAG,KAAK,UAAU,yBAAyB;QACxD,MAAM,IAAI,SAAS,CAAC,mEAAmE,CAAC,CAAC;IAC7F,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA4B;IAC/D,OAAO,iBAAiB,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,IAAI,sBAAsB,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC5C,OAAO,sBAAsB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,OAA0B,EAC1B,GAAyB;IAEzB,OAAO,MAAM,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,2BAA2B,CACvC,IAAY,EACZ,SAAmC,EACnC,MAAuD,EACvD,OAAiC;IAEjC,OAAO,iBAAiB,CAAC,QAAQ,EAAE,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;QAC3G,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB;IACnC,OAAO,iBAAiB,CAAC,QAAQ,EAAE,EAAE,MAAM,IAAI,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB;IACpC,OAAO,iBAAiB,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;AAChD,CAAC"}

package/attachments/failure-artifact-stream.js

@@ -0,0 +1,147 @@
+import { createStoredValue } from "../stored-value.js";
+import { defaultAttachmentLimits } from "../engine/runtime-attachment.js";
+import { workIdentityKey } from "../engine/identity.js";
+import { currentAttachmentContext } from "./attachment-context.js";
+import { resourceFailureAttachments } from "./resource-failure-context.js";
+const registryKey = Symbol.for('@overkill-dev/failure-artifact-streams/v2');
+function isFailureRunRegistry(value) {
+    return value instanceof WeakMap;
+}
+function sharedFailureRuns() {
+    const existing = Reflect.get(globalThis, registryKey);
+    if (isFailureRunRegistry(existing)) {
+        return existing;
+    }
+    const created = new WeakMap();
+    Object.defineProperty(globalThis, registryKey, { value: created });
+    return created;
+}
+const runs = sharedFailureRuns();
+function currentFailureStreams() {
+    const context = currentAttachmentContext();
+    if (context === null) {
+        return null;
+    }
+    const streams = runs.get(context) ?? new Map();
+    runs.set(context, streams);
+    return streams;
+}
+function attemptKey(work, attempt) {
+    return `${workIdentityKey(work)}:${attempt.index}`;
+}
+
+async function drainCapture(state) {
+    const writer = state.writer.read() ?? await state.attachments.open(state.metadata);
+    state.writer.write(writer);
+    while (state.chunks.read().length > 0) {
+        const batch = state.chunks.read();
+        state.chunks.write([]);
+        for (const chunk of batch) {
+            await writer.write(chunk);
+            state.queuedBytes.write(state.queuedBytes.read() - Buffer.byteLength(chunk));
+        }
+    }
+}
+async function capturePending(state) {
+    try {
+        await drainCapture(state);
+    }
+    catch (error) {
+        state.failure.write(error instanceof Error
+            ? error
+            : new Error('Failure artifact stream could not capture output.', { cause: error }));
+        state.chunks.write([]);
+        state.queuedBytes.write(0);
+    }
+    finally {
+        state.pending.write(null);
+    }
+}
+async function observeLateCapture(state, chunk) {
+    const writer = state.writer.read();
+    const writing = writer === null ? state.attachments.json(state.metadata, null) : writer.write(chunk);
+    try {
+        await writing;
+    }
+    catch (error) {
+        state.failure.write(error instanceof Error ? error : new Error('Late failure capture failed.', { cause: error }));
+    }
+}
+function captureAcceptsWrite(state, chunk) {
+    if (state.closed.read() && !state.lateReported.read()) {
+        state.lateReported.write(true);
+        state.pending.write(observeLateCapture(state, chunk));
+    }
+    return !state.closed.read() && !state.truncated.read() && state.failure.read() === null;
+}
+function queueCapture(state, chunk) {
+    const available = defaultAttachmentLimits.maxInlineBytes - state.queuedBytes.read();
+    const limited = Buffer.byteLength(chunk) > available;
+    const decoder = new TextDecoder();
+    const prefix = limited
+        ? decoder.decode(Buffer.from(chunk).subarray(0, available), { stream: true })
+        : chunk;
+    state.truncated.write(limited);
+    state.chunks.write([...state.chunks.read(), prefix]);
+    state.queuedBytes.write(state.queuedBytes.read() + Buffer.byteLength(prefix));
+}
+function writeCapture(state, chunk) {
+    if (!captureAcceptsWrite(state, chunk)) {
+        return;
+    }
+    queueCapture(state, chunk);
+    if (state.pending.read() === null) {
+        state.pending.write(capturePending(state));
+    }
+}
+async function closeCapture(state) {
+    if (state.closed.read()) {
+        return;
+    }
+    state.closed.write(true);
+    await state.pending.read();
+    const writer = state.writer.read();
+    if (writer !== null) {
+        await (state.truncated.read() ? writer.close('capture-limit') : writer.close());
+    }
+    const failure = state.failure.read();
+    if (failure !== null) {
+        throw failure;
+    }
+}
+function createCaptureState(attachments, name, mediaType) {
+    return {
+        attachments,
+        metadata: { kind: 'text', name, mediaType },
+        chunks: createStoredValue([]),
+        queuedBytes: createStoredValue(0),
+        truncated: createStoredValue(false),
+        failure: createStoredValue(null),
+        closed: createStoredValue(false),
+        lateReported: createStoredValue(false),
+        writer: createStoredValue(null),
+        pending: createStoredValue(null)
+    };
+}
+function registerAttemptStream(context, stream) {
+    const streams = currentFailureStreams();
+    if (context.condition.kind === 'attempt' && streams !== null) {
+        const key = attemptKey(context.condition.work, context.condition.attempt);
+        const owned = streams.get(key) ?? new Set();
+        streams.set(key, new Set([...owned, stream]));
+    }
+}
+export function createFailureArtifactStream(context, source, name, mediaType) {
+    const attachments = resourceFailureAttachments(context, source);
+    if (attachments === null) {
+        return null;
+    }
+    const state = createCaptureState(attachments, name, mediaType);
+    const stream = {
+        write: writeCapture.bind(null, state),
+        close: closeCapture.bind(null, state)
+    };
+    registerAttemptStream(context, stream);
+    return stream;
+}
+//# sourceMappingURL=failure-artifact-stream.js.map

package/attachments/failure-artifact-stream.js.map

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

package/attachments/resource-failure-context.js

@@ -0,0 +1,45 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { preparedResourceAttachments } from "./attachment-context.js";
+const contextKey = Symbol.for('@overkill-dev/resource-failure-context/v1');
+function isResourceFailureStorage(value) {
+    return value instanceof AsyncLocalStorage;
+}
+function sharedResourceFailureContext() {
+    const existing = Reflect.get(globalThis, contextKey);
+    if (isResourceFailureStorage(existing)) {
+        return existing;
+    }
+    const created = new AsyncLocalStorage();
+    Object.defineProperty(globalThis, contextKey, { value: created });
+    return created;
+}
+const resourceFailureContext = sharedResourceFailureContext();
+export function currentResourceFailureContext() {
+    return resourceFailureContext.getStore() ?? null;
+}
+export function resourceFailureAttachments(context, source) {
+    return preparedResourceAttachments(context.name, context.condition, source, 'attachment');
+}
+export function attemptFailureContext(name, work, attempt) {
+    return { name, condition: { kind: 'attempt', work, attempt } };
+}
+
+const scopeRegistryKey = Symbol.for('@overkill-dev/transcript-attempt-scopes/v1');
+function isAttemptScopeRegistry(value) {
+    return value instanceof WeakMap;
+}
+function sharedAttemptScopes() {
+    const existing = Reflect.get(globalThis, scopeRegistryKey);
+    if (isAttemptScopeRegistry(existing)) {
+        return existing;
+    }
+    const created = new WeakMap();
+    Object.defineProperty(globalThis, scopeRegistryKey, { value: created });
+    return created;
+}
+const attemptScopes = sharedAttemptScopes();
+
+export function transcriptAttempt(scope) {
+    return scope === null ? null : attemptScopes.get(scope) ?? null;
+}
+//# sourceMappingURL=resource-failure-context.js.map

package/attachments/resource-failure-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-failure-context.js","sourceRoot":"","sources":["../../../../source/attachments/resource-failure-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,6BAAkD,MAAM,yBAAyB,CAAC;AAM3F,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AAE3E,SAAS,wBAAwB,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC9C,CAAC;AACD,SAAS,4BAA4B;IACjC,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC9D,IAAI,wBAAwB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAA0B,CAAC;IAChE,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAClE,OAAO,OAAO,CAAC;AACnB,CAAC;AACD,MAAM,sBAAsB,GAAG,4BAA4B,EAAE,CAAC;AAE9D,MAAM,UAAU,6BAA6B;IACzC,OAAO,sBAAsB,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,0BAA0B,CACtC,OAA+B,EAC/B,MAA4C;IAE5C,OAAO,2BAA2B,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,IAAY,EAAE,OAAkB;IAChF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AACnE,CAAC;;MAWK,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;AAClF,SAAS,sBAAsB,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,OAAO,CAAC;AACpC,CAAC;AACD,SAAS,mBAAmB;IACxB,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACpE,IAAI,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,MAAM,OAAO,GAAyB,IAAI,OAAO,EAAE,CAAC;IACpD,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC;AACnB,CAAC;AACD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;;MAQtC,UAAU,iBAAiB,CAC7B,KAA0B;IAE1B,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC"}

package/engine/identity.d.ts

@@ -0,0 +1,29 @@
+export type TestId = {
+    readonly file: string | null;
+    readonly suite: readonly string[];
+    readonly title: string;
+};
+export type CaseId = TestId & {
+    readonly params: string | null;
+};
+export type RuntimeDimensions = Readonly<Record<string, string>>;
+export type RuntimeScenarioBindings = Readonly<Record<string, string>>;
+export type RuntimeId = {
+    readonly dimensions: RuntimeDimensions;
+    readonly name: string;
+    readonly scenarios: RuntimeScenarioBindings;
+    readonly variantId: string | null;
+};
+export type WorkloadId = {
+    readonly name: string;
+    readonly params: Readonly<Record<string, string>>;
+};
+export type WorkId = {
+    readonly case: CaseId;
+    readonly runtimes: readonly RuntimeId[];
+    readonly workload: WorkloadId | null;
+};
+export type AttemptId = {
+    readonly index: number;
+};
+//# sourceMappingURL=identity.d.ts.map

package/engine/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../source/engine/identity.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACjE,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,SAII,GAkFQ,SAAS,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/engine/identity.js

@@ -0,0 +1,41 @@
+export function caseIdentityKey(caseId) {
+    return JSON.stringify([caseId.file, caseId.suite, caseId.title, caseId.params]);
+}
+function orderedRecordEntries(record) {
+    return Object.entries(record).toSorted(function compareKeys([left], [right]) {
+        return left.localeCompare(right);
+    });
+}
+function runtimeIdentityShape(runtime) {
+    return [
+        runtime.name,
+        runtime.variantId,
+        orderedRecordEntries(runtime.dimensions),
+        orderedRecordEntries(runtime.scenarios)
+    ];
+}
+function runtimeIdentitiesShape(runtimes) {
+    return runtimes.map(runtimeIdentityShape);
+}
+function workloadIdentityShape(workload) {
+    if (workload === null) {
+        return null;
+    }
+    return [
+        workload.name,
+        orderedRecordEntries(workload.params)
+    ];
+}
+
+export function workIdentityKey(work) {
+    if (work.runtimes.length === 0 && work.workload === null) {
+        return caseIdentityKey(work.case);
+    }
+    return JSON.stringify([
+        caseIdentityKey(work.case),
+        runtimeIdentitiesShape(work.runtimes),
+        workloadIdentityShape(work.workload)
+    ]);
+}
+
+//# sourceMappingURL=identity.js.map

package/engine/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../source/engine/identity.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,eAce,CAAC,MAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAE,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAwC;IAClE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,WAAW,CAAC,CAAE,IAAI,CAAE,EAAE,CAAE,KAAK,CAAE;QAC3E,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAkB;IAC5C,OAAO;QACH,OAAO,CAAC,IAAI;QACZ,OAAO,CAAC,SAAS;QACjB,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC;QACxC,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC;KAC1C,CAAC;AACN,CAAC;AAED,SAAS,sBAAsB,CAAC,QAA8B;IAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,qBAAqB,CAAC,QAA2B;IACtD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO;QACH,QAAQ,CAAC,IAAI;QACb,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC;KACxC,CAAC;AACN,CAAC;;MAMK,UAIU,eAAe,CAAC,IAAY;IACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC;QAClB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1B,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC;KACvC,CAAC,CAAC;AACP,CAAC"}

package/engine/run-artifact.d.ts

@@ -0,0 +1,30 @@
+import type { AttemptId, CaseId, RuntimeId, WorkloadId } from './identity.ts';
+export type RunArtifactScope = {
+    readonly activeCases: readonly CaseId[];
+    readonly case: CaseId;
+    readonly confidence: 'active-case' | 'concurrent-active';
+    readonly kind: 'case';
+} | {
+    readonly kind: 'run';
+};
+type RunArtifactBaseId = {
+    readonly runtimes: readonly RuntimeId[];
+    readonly sequence: number;
+    readonly subtype: 'attachment' | 'coverage' | 'hedged-conflict' | 'log-capture' | 'witness';
+    readonly workload: WorkloadId | null;
+};
+type CaseArtifactId = RunArtifactBaseId & {
+    readonly attempt: AttemptId;
+    readonly scope: Extract<RunArtifactScope, {
+        readonly kind: 'case';
+    }>;
+};
+type RunScopedArtifactId = RunArtifactBaseId & {
+    readonly attempt: null;
+    readonly scope: {
+        readonly kind: 'run';
+    };
+};
+export type RunArtifactId = CaseArtifactId | RunScopedArtifactId;
+export {};
+//# sourceMappingURL=run-artifact.d.ts.map

package/engine/run-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-artifact.d.ts","sourceRoot":"","sources":["../../../../source/engine/run-artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,aAAa,GAAG,mBAAmB,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,GAAG;IACA,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACxB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,iBAAiB,GAAG,aAAa,GAAG,SAAS,CAAC;IAC5F,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,KAAK,cAAc,GAAG,iBAAiB,GAAG;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC,CAAC;CACzE,CAAC;AAEF,KAAK,mBAAmB,GAAG,iBAAiB,GAAG;IAC3C,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;KAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAEjE,MAAM,CAAsC,EAO3C,CAAC"}

package/engine/runtime-attachment.d.ts

@@ -0,0 +1,98 @@
+import type { JsonValue, ReadonlyDeep } from 'type-fest';
+import type { AttemptId, WorkId } from './identity.ts';
+import type { RunArtifactId } from './run-artifact.ts';
+export type AttachmentMetadata = {
+    readonly name: string;
+    readonly mediaType: string;
+};
+export type AttachmentCompletion = {
+    readonly kind: 'complete';
+} | {
+    readonly kind: 'incomplete';
+    readonly reason: 'byte-limit' | 'capture-limit' | 'interrupted' | 'unclosed' | 'write-error';
+} | {
+    readonly kind: 'truncated';
+    readonly reason: 'byte-limit';
+};
+export type AttachmentContent = {
+    readonly kind: 'file';
+    readonly path: string;
+    readonly byteLength: number;
+    readonly completion: Exclude<AttachmentCompletion, {
+        readonly kind: 'truncated';
+    }>;
+} | {
+    readonly kind: 'json';
+    readonly value: ReadonlyDeep<JsonValue>;
+    readonly byteLength: number;
+} | {
+    readonly kind: 'omitted';
+    readonly reason: 'byte-limit' | 'count-limit';
+    readonly limit: number;
+} | {
+    readonly kind: 'text';
+    readonly text: string;
+    readonly byteLength: number;
+    readonly completion: AttachmentCompletion;
+};
+export type AttachmentProducer = {
+    readonly kind: 'case';
+} | {
+    readonly kind: 'resource';
+    readonly name: string;
+};
+export type FailureArtifactCondition = {
+    readonly kind: 'attempt';
+    readonly work: WorkId;
+    readonly attempt: AttemptId;
+} | {
+    readonly kind: 'resource';
+    readonly resource: string;
+    readonly boundary: string;
+};
+type ExplicitAttachmentCapture = {
+    readonly capture: 'opt-in';
+};
+type AutomaticAttachmentCapture = {
+    readonly capture: 'automatic';
+    readonly retention: {
+        readonly condition: FailureArtifactCondition;
+        readonly state: 'prepared' | 'retained';
+    };
+};
+export type RuntimeAttachmentArtifact = {
+    readonly id: RunArtifactId & {
+        readonly subtype: 'attachment' | 'witness';
+    };
+    readonly source: 'boundary-captured' | 'instrumented' | 'native';
+    readonly payload: AttachmentMetadata & {
+        readonly kind: 'runtime-attachment';
+        readonly capturedAtMicroseconds: number;
+        readonly producer: AttachmentProducer;
+        readonly content: AttachmentContent;
+    } & (AutomaticAttachmentCapture | ExplicitAttachmentCapture);
+};
+export type AttachmentWriter<Chunk> = {
+    readonly write: (chunk: Chunk) => Promise<void>;
+    readonly close: (...reason: readonly ['capture-limit'] | readonly []) => Promise<RuntimeAttachmentArtifact>;
+};
+export type RuntimeAttachments = {
+    readonly open: {
+        (metadata: AttachmentMetadata & {
+            readonly kind: 'text';
+        }): Promise<AttachmentWriter<Uint8Array | string>>;
+        (metadata: AttachmentMetadata & {
+            readonly kind: 'binary';
+        }): Promise<AttachmentWriter<Uint8Array>>;
+    };
+    readonly json: (metadata: AttachmentMetadata, value: unknown) => Promise<RuntimeAttachmentArtifact>;
+    readonly file: (metadata: AttachmentMetadata, path: string) => Promise<RuntimeAttachmentArtifact>;
+};
+export type AttachmentLimits = {
+    readonly maxInlineBytes: number;
+    readonly maxArtifactBytes: number;
+    readonly maxScopeBytes: number;
+    readonly maxScopeAttachments: number;
+};
+export {};
+//# sourceMappingURL=runtime-attachment.d.ts.map

package/engine/runtime-attachment.d.ts.map

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

package/engine/runtime-attachment.js

@@ -0,0 +1,7 @@
+export const defaultAttachmentLimits = Object.freeze({
+    maxInlineBytes: 1_048_576,
+    maxArtifactBytes: 10_485_760,
+    maxScopeBytes: 10_485_760,
+    maxScopeAttachments: 100
+});
+//# sourceMappingURL=runtime-attachment.js.map

package/engine/runtime-attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-attachment.js","sourceRoot":"","sources":["../../../../source/engine/runtime-attachment.ts"],"names":[],"mappings":"AA0FA,MAAM,CAAC,MAAM,uBAAuB,GAAqB,MAAM,CAAC,MAAM,CAAC;IACnE,cAAc,EAAE,SAAS;IACzB,gBAAgB,EAAE,UAAU;IAC5B,aAAa,EAAE,UAAU;IACzB,mBAAmB,EAAE,GAAG;CAC3B,CAAC,CAAC"}

package/package-version.js

@@ -0,0 +1,31 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+const packageVersionSchema = z.object({ name: z.string(), version: z.string() });
+async function parsePackageVersion(manifestPath) {
+    const contents = await readFile(manifestPath, 'utf8');
+    const parsed = packageVersionSchema.safeParse(JSON.parse(contents));
+    return parsed.success ? parsed.data : null;
+}
+async function readPackageVersion(directory) {
+    const manifestPath = path.join(directory, 'package.json');
+    try {
+        return await parsePackageVersion(manifestPath);
+    }
+    catch (error) {
+        if (error instanceof Error && Reflect.get(error, 'code') === 'ENOENT' && path.dirname(directory) !== directory) {
+            return await readPackageVersion(path.dirname(directory));
+        }
+        return null;
+    }
+}
+export async function packageVersion(moduleUrl) {
+    try {
+        return await readPackageVersion(path.dirname(fileURLToPath(moduleUrl)));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=package-version.js.map

package/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../../../source/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAGjF,KAAK,UAAU,mBAAmB,CAAC,YAAoB;IACnD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC1D,IAAI,CAAC;QACD,OAAO,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,IACI,KAAK,YAAY,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS,EAC5G,CAAC;YACC,OAAO,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB;IAClD,IAAI,CAAC;QACD,OAAO,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

package/package.json

@@ -4,7 +4,8 @@
         "url": "https://github.com/enormora/overkill/issues"
     },
     "dependencies": {
-        "type-fest": "5.10.0"
+        "type-fest": "5.10.0",
+        "zod": "4.6.5"
     },
     "description": "Typed Overkill resource and runtime descriptors.",
     "engines": {
@@ -14,6 +15,10 @@
         ".": {
             "import": "./packages/resources/resources.entry-point.js",
             "types": "./packages/resources/resources.entry-point.d.ts"
+        },
+        "./attachment-context": {
+            "import": "./packages/resources/attachment-context.entry-point.js",
+            "types": "./packages/resources/attachment-context.entry-point.d.ts"
         }
     },
     "homepage": "https://github.com/enormora/overkill#readme",
@@ -25,16 +30,23 @@
     "license": "MIT",
     "name": "@overkill-dev/resources",
     "peerDependencies": {
-        "@overkill-dev/simulation": "0.0.4"
+        "@overkill-dev/simulation": "0.0.5"
     },
     "repository": {
         "type": "git",
         "url": "git+https://github.com/enormora/overkill.git"
     },
     "sideEffects": [
+        "./attachments/attachment-context.js",
+        "./attachments/failure-artifact-stream.js",
+        "./attachments/resource-failure-context.js",
+        "./engine/runtime-attachment.js",
+        "./package-version.js",
         "./packages/resources/resources.entry-point.js",
+        "./resources/failure-artifacts.js",
         "./resources/local-http-transcript-observer.js",
         "./resources/local-service-resource.js",
+        "./resources/resource-definition-brand.js",
         "./resources/resource-definition.js",
         "./resources/resource-lifecycle-error.js",
         "./resources/resource-scenario-binding.js",
@@ -43,5 +55,5 @@
         "./resources/runtime-matrix-definition.js"
     ],
     "type": "module",
-    "version": "0.0.10"
+    "version": "0.0.12"
 }

package/packages/resources/attachment-context.entry-point.d.ts

@@ -0,0 +1,3 @@
+export { attachmentsForProducer, currentAttachmentLimits, resourceAttachments, preparedResourceAttachments, runWithAttachmentContext } from '../../attachments/attachment-context.ts';
+export type { AttachmentContext } from '../../attachments/attachment-context.ts';
+//# sourceMappingURL=attachment-context.entry-point.d.ts.map

package/packages/resources/attachment-context.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-context.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/resources/attachment-context.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EAC3B,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC"}

package/packages/resources/attachment-context.entry-point.js

@@ -0,0 +1,2 @@
+export { attachmentsForProducer, currentAttachmentLimits, resourceAttachments, preparedResourceAttachments, runWithAttachmentContext } from "../../attachments/attachment-context.js";
+//# sourceMappingURL=attachment-context.entry-point.js.map

package/packages/resources/attachment-context.entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-context.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/resources/attachment-context.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EAC3B,MAAM,yCAAyC,CAAC"}

package/packages/resources/resources.entry-point.d.ts

@@ -1,4 +1,5 @@
 import { type ResourcesModule } from '../../resources/resources.ts';
+export type { AttachmentMetadata, AttachmentWriter, AttachmentLimits, RuntimeAttachments, RuntimeAttachmentArtifact } from '../../engine/runtime-attachment.ts';
 export { defineLocalServiceResource } from '../../resources/local-service-resource.ts';
 export { createLocalHttpServiceResource } from '../../resources/local-http-service-resource.ts';
 export { createLocalProcessServiceResource } from '../../resources/local-process-service-resource.ts';
@@ -26,4 +27,6 @@ export type { RuntimeDefinition as Runtime, RuntimeResourceMap as ResourceMap }
 export type { ResourceLifecycleFailure, ResourceLifecyclePhase } from '../../resources/resource-lifecycle-error.ts';
 export type { ResourceSession, ResourceSessionDisposalContext, StartResourcesRequest } from '../../resources/resource-session.ts';
 export type { RuntimeSession, RuntimeSessionDisposalContext, StartRuntimeRequest } from '../../resources/runtime-lifecycle.ts';
+export { withFailureArtifacts } from '../../resources/failure-artifacts.ts';
+export type { FailureArtifactAttachments, ResourceFailureCapture, SimulationWitnessArtifact, SimulationWitnessInput } from '../../resources/failure-artifacts.ts';
 //# sourceMappingURL=resources.entry-point.d.ts.map