agentfootprint 11.0.0 → 11.1.0

package/dist/esm/trace-toolpack/causeResponse.js

@@ -1,3 +1,4 @@
+const STORED_LIMITATION = 'The storage adapter acknowledged these saved root-history bytes only. The native note remains memory-only; this receipt is not producer authentication or whole-workflow delivery proof.';
 const SNAPSHOT_LIMITATION = 'Snapshot-only records have no engine-written capture/end attestation. This reader cannot prove a root cause from them, even after a normally finished run.';
 const CAPTURE_REASONS = {
     'captured-root-log': 'Capture covers this in-memory root log only; exact read versions, child scopes and durable delivery remain unproven.',
@@ -13,33 +14,49 @@ const CAPTURE_REASONS = {
     'control-not-retained': 'Same-run captured control-dependency data is missing, partial or ambiguous.',
     'projection-incomplete': 'The execution-tree projection is missing a committed step.',
 };
-function interpretationFor(text, capture) {
-    return capture
+function interpretationFor(text, capture, storage) {
+    const native = capture
         ? `${text} ${capture === true
             ? 'The capture/end attestation was not inspected. No completeness claim is made.'
-            : CAPTURE_REASONS[capture.reason]}`
+            : capture.reason === 'captured-root-log' && capture.readSources !== 'not-collected'
+                ? 'Capture covers this saved root log segment only. Read-source observations use independently collected native ownership; unavailable reads retain gaps. Child scopes and whole-workflow durable delivery remain unproven.'
+                : CAPTURE_REASONS[capture.reason]}`
         : text;
+    return storage === undefined ? native : `${native} ${STORED_LIMITATION}`;
 }
 /** Fixed wording: no exception messages, state values or provider payloads cross this boundary. */
-export function causeGap(tool, code, capture) {
-    return JSON.stringify({
+export function causeGap(tool, code, capture, storage, maxChars) {
+    const text = JSON.stringify({
         tool,
         mode: 'recorded-evidence',
         confidence: 'incomplete',
         gaps: [{ code, evidence: [] }],
         ...(capture && capture !== true ? { capture } : {}),
-        interpretation: interpretationFor('Not sure: the requested evidence is incomplete. No root cause is asserted.', capture),
+        ...(storage === undefined ? {} : { storage }),
+        interpretation: interpretationFor('Not sure: the requested evidence is incomplete. No root cause is asserted.', capture, storage),
     });
+    // The native + saved assessments can themselves exceed a small output ceiling.
+    // Withhold them together with the proof; never clip a label into an apparent root.
+    return storage !== undefined && maxChars !== undefined && text.length > maxChars
+        ? JSON.stringify({
+            tool,
+            mode: 'recorded-evidence',
+            confidence: 'incomplete',
+            gaps: [{ code, evidence: [] }],
+            interpretation: 'Recorded evidence response: output limit reached. The response contains a gap, no root or full assessment. The storage adapter acknowledged saved root-history bytes only; native capture is memory-only. Producer identity and whole-workflow delivery remain unproven.',
+        })
+        : text;
 }
 /** A clipped proof must never leave behind a seemingly supported root or apparently complete empty list. */
-export function causeResponse(tool, finding, interpretation, maxChars, capture) {
+export function causeResponse(tool, finding, interpretation, maxChars, capture, storage) {
     const text = JSON.stringify({
         tool,
         mode: 'recorded-evidence',
         finding,
         ...(capture && capture !== true ? { capture } : {}),
-        interpretation: interpretationFor(interpretation, capture),
+        ...(storage === undefined ? {} : { storage }),
+        interpretation: interpretationFor(interpretation, capture, storage),
     });
-    return text.length <= maxChars ? text : causeGap(tool, 'truncated', capture);
+    return text.length <= maxChars ? text : causeGap(tool, 'truncated', capture, storage, maxChars);
 }
 //# sourceMappingURL=causeResponse.js.map

package/dist/esm/trace-toolpack/causeResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"causeResponse.js","sourceRoot":"","sources":["../../../src/trace-toolpack/causeResponse.ts"],"names":[],"mappings":"AAIA,MAAM,mBAAmB,GACvB,4JAA4J,CAAC;AAE/J,MAAM,eAAe,GAAkC;IACrD,mBAAmB,EACjB,sHAAsH;IACxH,qBAAqB,EAAE,mBAAmB;IAC1C,qBAAqB,EAAE,6CAA6C;IACpE,cAAc,EAAE,iEAAiE;IACjF,mBAAmB,EAAE,iDAAiD;IACtE,mBAAmB,EAAE,+DAA+D;IACpF,mBAAmB,EAAE,mDAAmD;IACxE,qBAAqB,EACnB,qFAAqF;IACvF,sBAAsB,EAAE,gEAAgE;IACxF,iBAAiB,EAAE,+DAA+D;IAClF,sBAAsB,EACpB,6EAA6E;IAC/E,uBAAuB,EAAE,4DAA4D;CACtF,CAAC;AAEF,SAAS,iBAAiB,CAAC,IAAY,EAAE,OAAgC;IACvE,OAAO,OAAO;QACZ,CAAC,CAAC,GAAG,IAAI,IACL,OAAO,KAAK,IAAI;YACd,CAAC,CAAC,+EAA+E;YACjF,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CACpC,EAAE;QACJ,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,QAAQ,CACtB,IAAyB,EACzB,IAAa,EACb,OAAgC;IAEhC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,IAAI;QACJ,IAAI,EAAE,mBAAmB;QACzB,UAAU,EAAE,YAAY;QACxB,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC9B,GAAG,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,cAAc,EAAE,iBAAiB,CAC/B,4EAA4E,EAC5E,OAAO,CACR;KACF,CAAC,CAAC;AACL,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,aAAa,CAC3B,IAAyB,EACzB,OAAgB,EAChB,cAAsB,EACtB,QAAgB,EAChB,OAAgC;IAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,IAAI;QACJ,IAAI,EAAE,mBAAmB;QACzB,OAAO;QACP,GAAG,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,cAAc,EAAE,iBAAiB,CAAC,cAAc,EAAE,OAAO,CAAC;KAC3D,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"causeResponse.js","sourceRoot":"","sources":["../../../src/trace-toolpack/causeResponse.ts"],"names":[],"mappings":"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"}

package/dist/esm/trace-toolpack/causeSnapshot.d.ts

@@ -1,10 +1,4 @@
 import type { StageSnapshot } from 'footprintjs/advanced';
 import type { TraceToolpackArtifacts } from './types.js';
-import type { TraceCauseArtifacts } from './causeTypes.js';
-import { type SnapshotCapture } from './causeCapture.js';
-interface SnapshotCauseArtifacts extends TraceCauseArtifacts {
-    readonly capture: SnapshotCapture;
-}
-/** A snapshot projection, not another dependence walker. The public reader owns all graph reasoning. */
-export declare function snapshotCauseArtifacts(artifacts: TraceToolpackArtifacts, nodes: ReadonlyMap<string, StageSnapshot>): SnapshotCauseArtifacts | 'truncated' | undefined;
-export {};
+/** Preserve the existing in-memory projection through the shared narrow basis. */
+export declare function snapshotCauseArtifacts(artifacts: TraceToolpackArtifacts, nodes: ReadonlyMap<string, StageSnapshot>): "truncated" | import("./causeProjection.js").SnapshotCauseArtifacts | undefined;

package/dist/esm/trace-toolpack/causeSnapshot.js

@@ -1,66 +1,6 @@
-import { createRecordGraph } from 'foottrace/cause';
-import { assessCapture, captureAddress, captureAssessment, captureOwn as own, } from './causeCapture.js';
-import { capturedControl } from './causeControl.js';
-/** A snapshot projection, not another dependence walker. The public reader owns all graph reasoning. */
+import { projectCauseBasis } from './causeProjection.js';
+/** Preserve the existing in-memory projection through the shared narrow basis. */
 export function snapshotCauseArtifacts(artifacts, nodes) {
-    const snapshot = artifacts.snapshot;
-    // A snapshot-local namespace is not a storage address or a service-correlation claim.
-    const recordedAddress = own(snapshot, 'logAddress');
-    const runId = own(snapshot, 'runId');
-    const address = recordedAddress ??
-        (typeof runId === 'string' ? { logRunId: `snapshot:${runId}`, drillPath: [] } : undefined);
-    if (address === undefined)
-        return undefined;
-    const log = own(snapshot, 'commitLog');
-    if (!Array.isArray(log))
-        return undefined;
-    if (log.length > 4096)
-        return 'truncated';
-    let capture = assessCapture(snapshot, log.length);
-    const nativeControl = capture.status === 'admitted' ? capturedControl(snapshot) : undefined;
-    if (capture.status === 'admitted' && nativeControl === undefined)
-        capture = captureAssessment('control-not-retained');
-    const reads = Object.create(null);
-    const marks = Object.create(null);
-    const control = Object.create(null);
-    let visited = 0;
-    for (const [id, stage] of nodes) {
-        if (visited++ >= 4096)
-            return 'truncated';
-        const capturedReads = own(stage, 'stageReads');
-        if (capturedReads !== null && typeof capturedReads === 'object')
-            reads[id] = Object.keys(capturedReads);
-        else if (capture.status === 'admitted')
-            reads[id] = [];
-        const attention = own(stage, 'attention');
-        if (attention !== undefined)
-            marks[id] = attention;
-        const parent = nativeControl === undefined ? artifacts.controlDeps?.(id) : nativeControl[id];
-        if (parent !== undefined)
-            control[id] = { deciderId: parent.deciderId };
-    }
-    if (capture.status === 'admitted' &&
-        log.some((bundle) => !nodes.has(own(bundle, 'runtimeStageId'))))
-        capture = captureAssessment('projection-incomplete');
-    const complete = capture.status === 'admitted';
-    const scopeAddress = (complete && captureAddress(own(snapshot, 'logAddress'))) || address;
-    const scope = {
-        address: scopeAddress,
-        commitLog: log,
-        reads,
-        ...(complete || Object.keys(marks).length
-            ? { attention: marks }
-            : {}),
-        ...(nativeControl === undefined && artifacts.controlDeps === undefined
-            ? {}
-            : { controlDeps: control }),
-        complete,
-    };
-    const graph = createRecordGraph([scope], { maxCommits: 4096 });
-    // The public scope reader admits untrusted commits and creates its own official IDs.
-    return {
-        graph: { ...graph, roots: (context) => graph.openScope(scopeAddress, context) },
-        capture,
-    };
+    return projectCauseBasis(artifacts.snapshot, nodes, () => artifacts.controlDeps);
 }
 //# sourceMappingURL=causeSnapshot.js.map

package/dist/esm/trace-toolpack/causeSnapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"causeSnapshot.js","sourceRoot":"","sources":["../../../src/trace-toolpack/causeSnapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"causeSnapshot.js","sourceRoot":"","sources":["../../../src/trace-toolpack/causeSnapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CACpC,SAAiC,EACjC,KAAyC;IAEzC,OAAO,iBAAiB,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACnF,CAAC"}

package/dist/esm/trace-toolpack/causeTools.d.ts

@@ -1,6 +1,13 @@
 import type { StageSnapshot } from 'footprintjs/advanced';
 import { type Tool } from '../tools/tools.js';
 import type { TraceToolpackArtifacts } from './types.js';
-import type { TraceCauseOptions } from './causeTypes.js';
+import type { TraceCauseArtifacts, TraceCauseOptions } from './causeTypes.js';
 /** Model questions select IDs only. The host owns all resource controls. */
 export declare function buildCauseTools(artifacts: TraceToolpackArtifacts, nodes: ReadonlyMap<string, StageSnapshot>, options?: TraceCauseOptions): Tool[];
+/**
+ * Serve the three read-only cause questions over one host-authorized graph.
+ * Saved evidence must be the exact object returned by `readStoredCauseArtifacts`;
+ * copied display assessments do not grant saved-history authority.
+ * No snapshot is indexed, no storage is fetched and no business work is rerun.
+ */
+export declare function traceCauseTools(cause: TraceCauseArtifacts, options?: TraceCauseOptions): Tool[];

package/dist/esm/trace-toolpack/causeTools.js

@@ -2,6 +2,7 @@ import { defineTool } from '../tools/tools.js';
 import { causeLimits } from './causeLimits.js';
 import { causeGap } from './causeResponse.js';
 import { loadCauseReader } from './causeLoad.js';
+import { causeContextAssessment } from './causeContext.js';
 const nodeId = {
     type: 'string',
     minLength: 1,
@@ -34,34 +35,56 @@ const CAUSE_OPERATIONS = {
 };
 /** Model questions select IDs only. The host owns all resource controls. */
 export function buildCauseTools(artifacts, nodes, options) {
+    return toolsForContext({ kind: 'snapshot', artifacts, nodes }, options);
+}
+/**
+ * Serve the three read-only cause questions over one host-authorized graph.
+ * Saved evidence must be the exact object returned by `readStoredCauseArtifacts`;
+ * copied display assessments do not grant saved-history authority.
+ * No snapshot is indexed, no storage is fetched and no business work is rerun.
+ */
+export function traceCauseTools(cause, options) {
+    return toolsForContext({ kind: 'graph', cause }, options);
+}
+function toolsForContext(context, options) {
     return Object.keys(CAUSE_OPERATIONS).map((operation) => defineTool({
         name: operation,
         ...CAUSE_OPERATIONS[operation],
-        execute: async (question, context) => {
-            const snapshotOnly = artifacts.cause === undefined ? true : undefined;
-            if (context.signal?.aborted)
-                return causeGap(operation, 'cancelled', snapshotOnly);
+        execute: async (question, execution) => {
+            const assessed = causeContextAssessment(context);
+            if (assessed.kind === 'invalid')
+                return causeGap(operation, 'invalid-data');
+            const capture = assessed.kind === 'stored'
+                ? assessed.capture
+                : context.kind === 'snapshot' && context.artifacts.cause === undefined
+                    ? true
+                    : undefined;
+            const storage = assessed.kind === 'stored' ? assessed.admission.storage : undefined;
+            if (execution.signal?.aborted && storage === undefined)
+                return causeGap(operation, 'cancelled', capture);
             let limits;
             try {
                 limits = causeLimits(options);
             }
             catch {
-                return causeGap(operation, 'invalid-data', snapshotOnly);
+                return causeGap(operation, 'invalid-data', capture, storage, 512);
             }
+            if (execution.signal?.aborted)
+                return causeGap(operation, 'cancelled', capture, storage, limits.maxChars);
             const deadline = performance.now() + limits.timeoutMs;
             try {
-                const loaded = await loadCauseReader(deadline, context.signal);
+                const loaded = await loadCauseReader(deadline, execution.signal);
                 if ('gap' in loaded)
-                    return causeGap(operation, loaded.gap, snapshotOnly);
-                return await loaded.reader.readCause(operation, artifacts, nodes, question, limits, deadline, context.signal);
+                    return causeGap(operation, loaded.gap, capture, storage, limits.maxChars);
+                return await loaded.reader.readCause(operation, context, question, limits, deadline, execution.signal);
             }
             catch {
                 // Includes bounded loader refusals. Never echo an exception or disclose a private path.
-                return causeGap(operation, context.signal?.aborted
+                return causeGap(operation, execution.signal?.aborted
                     ? 'cancelled'
                     : performance.now() >= deadline
                         ? 'timeout'
-                        : 'unavailable', snapshotOnly);
+                        : 'unavailable', capture, storage, limits.maxChars);
             }
         },
     }));

package/dist/esm/trace-toolpack/causeTools.js.map

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

package/dist/esm/trace-toolpack/index.d.ts

@@ -21,6 +21,9 @@ export { callTraceTool, traceToolpack, TRACE_TOOL_NAMES } from './traceToolpack.
 export { lazyTraceToolpack, NO_COMPLETED_RUN_MESSAGE } from './lazyToolpack.js';
 export { openRecording, type OpenableRecording } from './openRecording.js';
 export type { TraceCauseArtifacts, TraceCauseOptions, TraceCauseOperation } from './causeTypes.js';
+export { traceCauseTools } from './causeTools.js';
+export { readStoredCauseArtifacts } from './storedCause.js';
+export type { ReadStoredCauseOptions, StoredCauseUnknown, StoredCauseAdmission, StoredCauseArtifacts, StoredCauseResult, } from './storedCauseTypes.js';
 export { DEFAULT_INNER_RUN_LIMIT, INNER_RUN_RECORDS, innerRunStore, innerRunsOf, mergeInnerRuns, type InnerRunLookup, type InnerRunOutcome, type InnerRunRecord, type InnerRunStore, type InnerRunSummary, type KeepsInnerRuns, } from '../core/innerRunRecords.js';
 export { traceDebugAgent, type TraceDebugAgentOptions } from './traceDebugAgent.js';
 export { buildSelfExplainSkill, buildSelfExplainToolProvider, SelfExplainBinding, SELF_EXPLAIN_MAX_EVENTS, type SelfExplainInclude, type SelfExplainOptions, type SelfExplainServing, type SelfExplainSource, } from './selfExplain.js';

package/dist/esm/trace-toolpack/index.js

@@ -23,6 +23,8 @@ export { callTraceTool, traceToolpack, TRACE_TOOL_NAMES } from './traceToolpack.
 // consumer has no call to construct one.
 export { lazyTraceToolpack, NO_COMPLETED_RUN_MESSAGE } from './lazyToolpack.js';
 export { openRecording } from './openRecording.js';
+export { traceCauseTools } from './causeTools.js';
+export { readStoredCauseArtifacts } from './storedCause.js';
 // The record a TOOL keeps of its own run — what `inspect_tool_run` opens.
 // `INNER_RUN_RECORDS` / `innerRunsOf` are the join key between a Tool and
 // its store; `innerRunStore` / `mergeInnerRuns` exist for consumers wiring

package/dist/esm/trace-toolpack/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/trace-toolpack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpF,2EAA2E;AAC3E,6EAA6E;AAC7E,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,aAAa,EAA0B,MAAM,oBAAoB,CAAC;AAE3E,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,cAAc,GAOf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAA+B,MAAM,sBAAsB,CAAC;AACpF,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,uBAAuB,GAKxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,GAGnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/trace-toolpack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpF,2EAA2E;AAC3E,6EAA6E;AAC7E,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,aAAa,EAA0B,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAQ5D,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,cAAc,GAOf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAA+B,MAAM,sBAAsB,CAAC;AACpF,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,uBAAuB,GAKxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,GAGnB,MAAM,YAAY,CAAC"}

package/dist/esm/trace-toolpack/storedCause.d.ts

@@ -0,0 +1,8 @@
+import type { ReadStoredCauseOptions, StoredCauseResult } from './storedCauseTypes.js';
+/**
+ * Admit one host-authorized saved root through the producer's public reader, without a runtime snapshot.
+ * Storage acknowledgement is not producer authentication. Missing source ownership remains unknown.
+ * Graph projection is capped at 4,096 nodes/commits and uses the producer's 256-level data depth.
+ * Cannot preempt a blocking host iterator; cancellation is checked before and after asynchronous admission.
+ */
+export declare function readStoredCauseArtifacts(entries: Iterable<unknown>, options: ReadStoredCauseOptions): Promise<StoredCauseResult>;

package/dist/esm/trace-toolpack/storedCause.js

@@ -0,0 +1,58 @@
+import { captureOwn } from './causeCapture.js';
+import { storedCauseCancelled, storedCauseOptions } from './storedCauseOptions.js';
+const unknown = (reason) => ({ status: 'unknown', reason });
+/**
+ * Admit one host-authorized saved root through the producer's public reader, without a runtime snapshot.
+ * Storage acknowledgement is not producer authentication. Missing source ownership remains unknown.
+ * Graph projection is capped at 4,096 nodes/commits and uses the producer's 256-level data depth.
+ * Cannot preempt a blocking host iterator; cancellation is checked before and after asynchronous admission.
+ */
+export async function readStoredCauseArtifacts(entries, options) {
+    let configured;
+    try {
+        configured = storedCauseOptions(options);
+        if (storedCauseCancelled(configured.signal))
+            return unknown('cancelled');
+    }
+    catch {
+        return unknown('invalid-data');
+    }
+    if (!globalThis.crypto?.subtle)
+        return unknown('unavailable');
+    let reader;
+    try {
+        ({ readStoredCapture: reader } = await import('./storedCauseReader.js'));
+    }
+    catch {
+        return unknown('unsupported');
+    }
+    if (storedCauseCancelled(configured.signal))
+        return unknown('cancelled');
+    if (typeof reader !== 'function')
+        return unknown('unsupported');
+    try {
+        const result = await reader(entries, {
+            runId: configured.runId,
+            maxBytes: configured.maxBytes,
+            ...(configured.readerLimits === undefined ? {} : { limits: configured.readerLimits }),
+        });
+        if (storedCauseCancelled(configured.signal))
+            return unknown('cancelled');
+        if (captureOwn(result, 'status') !== 'acknowledged') {
+            const reason = captureOwn(result, 'reason');
+            return unknown(reason === 'reader-limit' || reason === 'history-too-large'
+                ? 'reader-limit'
+                : 'stored-admission');
+        }
+        const history = captureOwn(result, 'history');
+        const { projectStoredCause } = await import('./storedCauseProjection.js');
+        if (storedCauseCancelled(configured.signal))
+            return unknown('cancelled');
+        const projected = projectStoredCause(history, configured.runId, configured.maxBytes);
+        return storedCauseCancelled(configured.signal) ? unknown('cancelled') : projected;
+    }
+    catch {
+        return unknown(storedCauseCancelled(configured.signal) ? 'cancelled' : 'unavailable');
+    }
+}
+//# sourceMappingURL=storedCause.js.map

package/dist/esm/trace-toolpack/storedCause.js.map

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

package/dist/esm/trace-toolpack/storedCauseBinding.d.ts

@@ -0,0 +1,16 @@
+import type { CauseGraph } from 'foottrace/cause';
+import type { SnapshotCapture } from './causeCapture.js';
+import type { StoredCauseAdmission, StoredCauseArtifacts } from './storedCauseTypes.js';
+export type StoredCauseAssessment = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'invalid';
+} | {
+    readonly kind: 'stored';
+    readonly capture: SnapshotCapture;
+    readonly admission: StoredCauseAdmission;
+};
+/** Internal issuer. This identity is intentionally not serializable or shared across module instances. */
+export declare function bindStoredCause(graph: CauseGraph, capture: SnapshotCapture, history: object, version: 1 | 2): StoredCauseArtifacts;
+/** Read identity, never the value of a caller's assessment property or an attached getter. */
+export declare function storedCauseAssessment(cause: unknown): StoredCauseAssessment;

package/dist/esm/trace-toolpack/storedCauseBinding.js

@@ -0,0 +1,50 @@
+const bindings = new WeakMap();
+function admissionFor(capture, version) {
+    return Object.freeze({
+        native: Object.freeze({
+            status: capture.status,
+            reason: capture.reason,
+            version,
+            scope: 'root-log',
+            persistence: 'memory-only',
+        }),
+        storage: Object.freeze({
+            status: 'adapter-acknowledged-history',
+            scope: 'root-log',
+        }),
+        readSources: capture.readSources,
+    });
+}
+/** Internal issuer. This identity is intentionally not serializable or shared across module instances. */
+export function bindStoredCause(graph, capture, history, version) {
+    const frozenGraph = Object.freeze(graph);
+    const frozenCapture = Object.freeze({ ...capture });
+    const admission = admissionFor(frozenCapture, version);
+    // The display copy is separate from the authority retained by this module instance.
+    const cause = Object.freeze({
+        graph: frozenGraph,
+        admission: admissionFor(frozenCapture, version),
+    });
+    bindings.set(cause, { graph: frozenGraph, capture: frozenCapture, admission, history });
+    return cause;
+}
+/** Read identity, never the value of a caller's assessment property or an attached getter. */
+export function storedCauseAssessment(cause) {
+    if (cause === null || typeof cause !== 'object')
+        return { kind: 'none' };
+    try {
+        const binding = bindings.get(cause);
+        if (binding) {
+            const graph = Object.getOwnPropertyDescriptor(cause, 'graph');
+            return graph && 'value' in graph && graph.value === binding.graph
+                ? { kind: 'stored', capture: binding.capture, admission: binding.admission }
+                : { kind: 'invalid' };
+        }
+        // Inherited copies carry the same claim but not the issuing identity. `in` invokes no getter.
+        return 'admission' in cause ? { kind: 'invalid' } : { kind: 'none' };
+    }
+    catch {
+        return { kind: 'invalid' };
+    }
+}
+//# sourceMappingURL=storedCauseBinding.js.map

package/dist/esm/trace-toolpack/storedCauseBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storedCauseBinding.js","sourceRoot":"","sources":["../../../src/trace-toolpack/storedCauseBinding.ts"],"names":[],"mappings":"AAoBA,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAmB,CAAC;AAEhD,SAAS,YAAY,CAAC,OAAwB,EAAE,OAAc;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO;YACP,KAAK,EAAE,UAAmB;YAC1B,WAAW,EAAE,aAAsB;SACpC,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,8BAAuC;YAC/C,KAAK,EAAE,UAAmB;SAC3B,CAAC;QACF,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC,CAAC;AACL,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,eAAe,CAC7B,KAAiB,EACjB,OAAwB,EACxB,OAAe,EACf,OAAc;IAEd,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvD,oFAAoF;IACpF,MAAM,KAAK,GAAyB,MAAM,CAAC,MAAM,CAAC;QAChD,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC;KAChD,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACxF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC9D,OAAO,KAAK,IAAI,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;gBAC/D,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;gBAC5E,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1B,CAAC;QACD,8FAA8F;QAC9F,OAAO,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/esm/trace-toolpack/storedCauseOptions.d.ts

@@ -0,0 +1,5 @@
+import type { ReadStoredCauseOptions } from './storedCauseTypes.js';
+/** Only the declared host settings; no coercion, getters, inherited overrides or mutable options bag. */
+export declare function storedCauseOptions(value: ReadStoredCauseOptions): Required<Pick<ReadStoredCauseOptions, 'runId' | 'maxBytes' | 'readerLimits'>> & Pick<ReadStoredCauseOptions, 'signal'>;
+/** Call the platform getter itself, so a host subclass cannot replace this observation with code. */
+export declare function storedCauseCancelled(signal?: AbortSignal): boolean;

package/dist/esm/trace-toolpack/storedCauseOptions.js

@@ -0,0 +1,53 @@
+import { ownData } from '../lib/boundedJson.js';
+const DEFAULT_READER_LIMITS = Object.freeze({
+    entries: 16_384,
+    missingCommits: 4096,
+    drillDepth: 64,
+    addressLength: 2048,
+});
+const READER_CEILINGS = { ...DEFAULT_READER_LIMITS, entries: 65_536 };
+const LIMIT_KEYS = Object.keys(DEFAULT_READER_LIMITS);
+/** Only the declared host settings; no coercion, getters, inherited overrides or mutable options bag. */
+export function storedCauseOptions(value) {
+    const data = ownData(value, ['runId', 'readerLimits', 'maxBytes', 'signal']);
+    if (typeof data.runId !== 'string' || data.runId.length === 0 || data.runId.length > 128)
+        throw Error('Invalid stored cause options.');
+    const maxBytes = data.maxBytes === undefined ? 1024 * 1024 : data.maxBytes;
+    if (!Number.isSafeInteger(maxBytes) ||
+        maxBytes < 1 ||
+        maxBytes > 8 * 1024 * 1024)
+        throw Error('Invalid stored cause options.');
+    const provided = data.readerLimits === undefined ? {} : ownData(data.readerLimits, LIMIT_KEYS);
+    for (const key of LIMIT_KEYS) {
+        const limit = provided[key];
+        if (limit !== undefined &&
+            (!Number.isSafeInteger(limit) ||
+                limit < 0 ||
+                limit > READER_CEILINGS[key]))
+            throw Error('Invalid stored cause options.');
+    }
+    // Bound the upstream reader before it can allocate gap rows or iterate its very large defaults.
+    const limits = {
+        ...DEFAULT_READER_LIMITS,
+        ...Object.fromEntries(Object.entries(provided).filter(([, limit]) => limit !== undefined)),
+    };
+    const signal = data.signal;
+    if (signal !== undefined && !(signal instanceof AbortSignal))
+        throw Error('Invalid stored cause options.');
+    return {
+        runId: data.runId,
+        maxBytes: maxBytes,
+        readerLimits: limits,
+        ...(signal !== undefined && { signal: signal }),
+    };
+}
+/** Call the platform getter itself, so a host subclass cannot replace this observation with code. */
+export function storedCauseCancelled(signal) {
+    if (!signal)
+        return false;
+    const getter = Object.getOwnPropertyDescriptor(AbortSignal.prototype, 'aborted')?.get;
+    if (!getter)
+        throw Error('Abort signal observation is unavailable.');
+    return getter.call(signal);
+}
+//# sourceMappingURL=storedCauseOptions.js.map

package/dist/esm/trace-toolpack/storedCauseOptions.js.map

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

package/dist/esm/trace-toolpack/storedCauseProjection.d.ts

@@ -0,0 +1,3 @@
+import type { StoredCauseResult } from './storedCauseTypes.js';
+/** A narrow graph projection over admitted producer history, never a synthetic RuntimeSnapshot. */
+export declare function projectStoredCause(value: unknown, runId: string, maxBytes: number): StoredCauseResult;