agentfootprint 11.0.0 → 11.1.0

package/dist/trace-toolpack/causeProjection.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectCauseBasis = void 0;
+const cause_1 = require("foottrace/cause");
+const causeCapture_js_1 = require("./causeCapture.js");
+const causeControl_js_1 = require("./causeControl.js");
+/** A snapshot projection, not another dependence walker. The public reader owns all graph reasoning. */
+function projectCauseBasis(snapshot, nodes, controlDeps, extras) {
+    // A snapshot-local namespace is not a storage address or a service-correlation claim.
+    const recordedAddress = (0, causeCapture_js_1.captureOwn)(snapshot, 'logAddress');
+    const runId = (0, causeCapture_js_1.captureOwn)(snapshot, 'runId');
+    const address = recordedAddress ??
+        (typeof runId === 'string' ? { logRunId: `snapshot:${runId}`, drillPath: [] } : undefined);
+    if (address === undefined)
+        return undefined;
+    const log = (0, causeCapture_js_1.captureOwn)(snapshot, 'commitLog');
+    if (!Array.isArray(log))
+        return undefined;
+    if (log.length > 4096)
+        return 'truncated';
+    let capture = extras?.sources
+        ? (0, causeCapture_js_1.assessSourceCapture)(snapshot, log.length, extras.sources.status)
+        : (0, causeCapture_js_1.assessCapture)(snapshot, log.length);
+    const nativeControl = capture.status === 'admitted' ? (0, causeControl_js_1.capturedControl)(snapshot) : undefined;
+    if (capture.status === 'admitted' && nativeControl === undefined)
+        capture = (0, causeCapture_js_1.captureAssessment)('control-not-retained', capture.readSources);
+    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 = (0, causeCapture_js_1.captureOwn)(stage, 'stageReads');
+        if (capturedReads !== null && typeof capturedReads === 'object')
+            reads[id] = Object.keys(capturedReads);
+        else if (capture.status === 'admitted')
+            reads[id] = [];
+        const omitted = extras?.readKeys?.get(id);
+        if (omitted)
+            reads[id] = [...new Set([...(reads[id] ?? []), ...omitted])];
+        const attention = (0, causeCapture_js_1.captureOwn)(stage, 'attention');
+        if (attention !== undefined)
+            marks[id] = attention;
+        const parent = nativeControl === undefined ? controlDeps?.()?.(id) : nativeControl[id];
+        if (parent !== undefined)
+            control[id] = { deciderId: parent.deciderId };
+    }
+    if (capture.status === 'admitted' &&
+        log.some((bundle) => !nodes.has((0, causeCapture_js_1.captureOwn)(bundle, 'runtimeStageId'))))
+        capture = (0, causeCapture_js_1.captureAssessment)('projection-incomplete', capture.readSources);
+    const complete = capture.status === 'admitted';
+    const scopeAddress = (complete && (0, causeCapture_js_1.captureAddress)((0, causeCapture_js_1.captureOwn)(snapshot, 'logAddress'))) || address;
+    const scope = {
+        address: scopeAddress,
+        commitLog: log,
+        reads,
+        ...(complete || Object.keys(marks).length
+            ? { attention: marks }
+            : {}),
+        ...(nativeControl === undefined && controlDeps?.() === undefined
+            ? {}
+            : { controlDeps: control }),
+        complete,
+        ...(extras?.initialState === undefined ? {} : { initialState: extras.initialState }),
+        ...(extras?.sources === undefined ? {} : { readSources: extras.sources.scope }),
+    };
+    const graph = (0, cause_1.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,
+    };
+}
+exports.projectCauseBasis = projectCauseBasis;
+//# sourceMappingURL=causeProjection.js.map

package/dist/trace-toolpack/causeProjection.js.map

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

package/dist/trace-toolpack/causeReader.js

@@ -4,25 +4,33 @@ exports.readCause = void 0;
 const cause_1 = require("foottrace/cause");
 const causeSnapshot_js_1 = require("./causeSnapshot.js");
 const causeResponse_js_1 = require("./causeResponse.js");
+const causeContext_js_1 = require("./causeContext.js");
 /** One public query, one cache/deadline/total ceiling. No model, rerun, storage URL or second walker. */
-async function readCause(operation, artifacts, nodes, question, limits, deadline, signal) {
-    const snapshotOnly = artifacts.cause === undefined ? true : undefined;
+async function readCause(operation, context, question, limits, deadline, signal) {
+    const assessed = (0, causeContext_js_1.causeContextAssessment)(context);
+    if (assessed.kind === 'invalid')
+        return (0, causeResponse_js_1.causeGap)(operation, 'invalid-data');
+    const snapshotOnly = context.kind === 'snapshot' && context.artifacts.cause === undefined ? true : undefined;
+    const storedCapture = assessed.kind === 'stored' ? assessed.capture : undefined;
+    const storage = assessed.kind === 'stored' ? assessed.admission.storage : undefined;
     if (signal?.aborted)
-        return (0, causeResponse_js_1.causeGap)(operation, 'cancelled', snapshotOnly);
+        return (0, causeResponse_js_1.causeGap)(operation, 'cancelled', storedCapture ?? snapshotOnly, storage, limits.maxChars);
     if (performance.now() >= deadline)
-        return (0, causeResponse_js_1.causeGap)(operation, 'timeout', snapshotOnly);
-    const projection = artifacts.cause === undefined ? (0, causeSnapshot_js_1.snapshotCauseArtifacts)(artifacts, nodes) : undefined;
-    const source = artifacts.cause ?? projection;
+        return (0, causeResponse_js_1.causeGap)(operation, 'timeout', storedCapture ?? snapshotOnly, storage, limits.maxChars);
+    const projection = context.kind === 'snapshot' && context.artifacts.cause === undefined
+        ? (0, causeSnapshot_js_1.snapshotCauseArtifacts)(context.artifacts, context.nodes)
+        : undefined;
+    const source = context.kind === 'graph' ? context.cause : context.artifacts.cause ?? projection;
     if (source === 'truncated')
         return (0, causeResponse_js_1.causeGap)(operation, 'truncated', snapshotOnly);
     if (source === undefined)
         return (0, causeResponse_js_1.causeGap)(operation, 'not-collected', snapshotOnly);
-    const capture = projection && projection !== 'truncated' ? projection.capture : undefined;
+    const capture = storedCapture ?? (projection && projection !== 'truncated' ? projection.capture : undefined);
     const remaining = Math.floor(deadline - performance.now());
     if (signal?.aborted)
-        return (0, causeResponse_js_1.causeGap)(operation, 'cancelled', capture);
+        return (0, causeResponse_js_1.causeGap)(operation, 'cancelled', capture, storage, limits.maxChars);
     if (remaining < 1)
-        return (0, causeResponse_js_1.causeGap)(operation, 'timeout', capture);
+        return (0, causeResponse_js_1.causeGap)(operation, 'timeout', capture, storage, limits.maxChars);
     const { maxChars, backward, impact, maxNodes, maxDepth, maxEdges, maxCalls } = limits;
     const options = { maxNodes, maxDepth, maxEdges, maxCalls, timeoutMs: remaining, signal };
     if (operation === 'attention_list') {
@@ -40,22 +48,22 @@ async function readCause(operation, artifacts, nodes, question, limits, deadline
             : result;
         return (0, causeResponse_js_1.causeResponse)(operation, finding, finding.confidence === 'incomplete'
             ? 'Not sure, because coverage is incomplete. An absent mark is not proof of a healthy or reached step.'
-            : 'Recorded attention within this query only. Cite the returned node and evidence IDs.', maxChars, capture);
+            : 'Recorded attention within this query only. Cite the returned node and evidence IDs.', maxChars, capture, storage);
     }
     // Each invocation projects one bounded query. Separate root/impact calls do not share a result yet.
     if (question.nodeId === undefined)
-        return (0, causeResponse_js_1.causeGap)(operation, 'invalid-data', capture);
+        return (0, causeResponse_js_1.causeGap)(operation, 'invalid-data', capture, storage, limits.maxChars);
     const finding = await (0, cause_1.explain)(source.graph, question.nodeId, { ...options, backward, impact });
     if (operation === 'impact') {
         return (0, causeResponse_js_1.causeResponse)(operation, finding.impact, finding.impact.confidence === 'incomplete'
             ? 'Not sure of the full impact, because the returned gaps limit the recorded forward slice.'
-            : 'Recorded reachable impact only; this does not prove effects in unrecorded services or unreached branches.', maxChars, capture);
+            : 'Recorded reachable impact only; this does not prove effects in unrecorded services or unreached branches.', maxChars, capture, storage);
     }
     return (0, causeResponse_js_1.causeResponse)(operation, finding, finding.rootCause !== undefined
         ? 'A unique recorded dependency root is supported. Cite its node ID and path; this is not proof of a provider-internal physical cause.'
         : finding.confidence === 'incomplete'
             ? 'Not sure, because the returned gaps prevent a unique supported root. Alternatives are not confirmed causes.'
-            : 'No unique marked root in the checked graph. Cite alternatives without selecting one as fact.', maxChars, capture);
+            : 'No unique marked root in the checked graph. Cite alternatives without selecting one as fact.', maxChars, capture, storage);
 }
 exports.readCause = readCause;
 //# sourceMappingURL=causeReader.js.map

package/dist/trace-toolpack/causeReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"causeReader.js","sourceRoot":"","sources":["../../src/trace-toolpack/causeReader.ts"],"names":[],"mappings":";;;AAAA,2CAAyD;AAKzD,yDAA4D;AAC5D,yDAA6D;AAE7D,yGAAyG;AAClG,KAAK,UAAU,SAAS,CAC7B,SAA8B,EAC9B,SAAiC,EACjC,KAAyC,EACzC,QAA4B,EAC5B,MAAmB,EACnB,QAAgB,EAChB,MAAoB;IAEpB,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,IAAA,2BAAQ,EAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC3E,IAAI,WAAW,CAAC,GAAG,EAAE,IAAI,QAAQ;QAAE,OAAO,IAAA,2BAAQ,EAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACvF,MAAM,UAAU,GACd,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,yCAAsB,EAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,IAAI,UAAU,CAAC;IAC7C,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,IAAA,2BAAQ,EAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAClF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAA,2BAAQ,EAAC,SAAS,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,UAAU,IAAI,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,IAAA,2BAAQ,EAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,IAAA,2BAAQ,EAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACtF,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACzF,IAAI,SAAS,KAAK,gBAAgB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAa,EAAC,MAAM,CAAC,KAAK,EAAE;YAC/C,GAAG,OAAO;YACV,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO;SAC5C,CAAC,CAAC;QACH,0FAA0F;QAC1F,MAAM,OAAO,GACX,OAAO,EAAE,MAAM,KAAK,YAAY,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC;YAC1F,CAAC,CAAC;gBACE,GAAG,MAAM;gBACT,UAAU,EAAE,YAAqB;gBACjC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,eAAwB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;aACzE;YACH,CAAC,CAAC,MAAM,CAAC;QACb,OAAO,IAAA,gCAAa,EAClB,SAAS,EACT,OAAO,EACP,OAAO,CAAC,UAAU,KAAK,YAAY;YACjC,CAAC,CAAC,qGAAqG;YACvG,CAAC,CAAC,qFAAqF,EACzF,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC;IACD,oGAAoG;IACpG,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAA,2BAAQ,EAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,MAAM,IAAA,eAAO,EAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/F,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,IAAA,gCAAa,EAClB,SAAS,EACT,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,MAAM,CAAC,UAAU,KAAK,YAAY;YACxC,CAAC,CAAC,0FAA0F;YAC5F,CAAC,CAAC,2GAA2G,EAC/G,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,gCAAa,EAClB,SAAS,EACT,OAAO,EACP,OAAO,CAAC,SAAS,KAAK,SAAS;QAC7B,CAAC,CAAC,qIAAqI;QACvI,CAAC,CAAC,OAAO,CAAC,UAAU,KAAK,YAAY;YACrC,CAAC,CAAC,6GAA6G;YAC/G,CAAC,CAAC,8FAA8F,EAClG,QAAQ,EACR,OAAO,CACR,CAAC;AACJ,CAAC;AAxED,8BAwEC"}
+{"version":3,"file":"causeReader.js","sourceRoot":"","sources":["../../src/trace-toolpack/causeReader.ts"],"names":[],"mappings":"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"}

package/dist/trace-toolpack/causeResponse.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.causeResponse = exports.causeGap = void 0;
+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.',
@@ -16,35 +17,51 @@ 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. */
-function causeGap(tool, code, capture) {
-    return JSON.stringify({
+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;
 }
 exports.causeGap = causeGap;
 /** A clipped proof must never leave behind a seemingly supported root or apparently complete empty list. */
-function causeResponse(tool, finding, interpretation, maxChars, capture) {
+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);
 }
 exports.causeResponse = causeResponse;
 //# sourceMappingURL=causeResponse.js.map

package/dist/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,SAAgB,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;AAhBD,4BAgBC;AAED,4GAA4G;AAC5G,SAAgB,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;AAfD,sCAeC"}
+{"version":3,"file":"causeResponse.js","sourceRoot":"","sources":["../../src/trace-toolpack/causeResponse.ts"],"names":[],"mappings":"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"}

package/dist/trace-toolpack/causeSnapshot.js

@@ -1,70 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.snapshotCauseArtifacts = void 0;
-const cause_1 = require("foottrace/cause");
-const causeCapture_js_1 = require("./causeCapture.js");
-const causeControl_js_1 = require("./causeControl.js");
-/** A snapshot projection, not another dependence walker. The public reader owns all graph reasoning. */
+const causeProjection_js_1 = require("./causeProjection.js");
+/** Preserve the existing in-memory projection through the shared narrow basis. */
 function snapshotCauseArtifacts(artifacts, nodes) {
-    const snapshot = artifacts.snapshot;
-    // A snapshot-local namespace is not a storage address or a service-correlation claim.
-    const recordedAddress = (0, causeCapture_js_1.captureOwn)(snapshot, 'logAddress');
-    const runId = (0, causeCapture_js_1.captureOwn)(snapshot, 'runId');
-    const address = recordedAddress ??
-        (typeof runId === 'string' ? { logRunId: `snapshot:${runId}`, drillPath: [] } : undefined);
-    if (address === undefined)
-        return undefined;
-    const log = (0, causeCapture_js_1.captureOwn)(snapshot, 'commitLog');
-    if (!Array.isArray(log))
-        return undefined;
-    if (log.length > 4096)
-        return 'truncated';
-    let capture = (0, causeCapture_js_1.assessCapture)(snapshot, log.length);
-    const nativeControl = capture.status === 'admitted' ? (0, causeControl_js_1.capturedControl)(snapshot) : undefined;
-    if (capture.status === 'admitted' && nativeControl === undefined)
-        capture = (0, causeCapture_js_1.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 = (0, causeCapture_js_1.captureOwn)(stage, 'stageReads');
-        if (capturedReads !== null && typeof capturedReads === 'object')
-            reads[id] = Object.keys(capturedReads);
-        else if (capture.status === 'admitted')
-            reads[id] = [];
-        const attention = (0, causeCapture_js_1.captureOwn)(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((0, causeCapture_js_1.captureOwn)(bundle, 'runtimeStageId'))))
-        capture = (0, causeCapture_js_1.captureAssessment)('projection-incomplete');
-    const complete = capture.status === 'admitted';
-    const scopeAddress = (complete && (0, causeCapture_js_1.captureAddress)((0, causeCapture_js_1.captureOwn)(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 = (0, cause_1.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 (0, causeProjection_js_1.projectCauseBasis)(artifacts.snapshot, nodes, () => artifacts.controlDeps);
 }
 exports.snapshotCauseArtifacts = snapshotCauseArtifacts;
 //# sourceMappingURL=causeSnapshot.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"causeSnapshot.js","sourceRoot":"","sources":["../../src/trace-toolpack/causeSnapshot.ts"],"names":[],"mappings":";;;AAAA,2CAAsE;AAItE,uDAM2B;AAC3B,uDAAoD;AAMpD,wGAAwG;AACxG,SAAgB,sBAAsB,CACpC,SAAiC,EACjC,KAAyC;IAEzC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;IACpC,sFAAsF;IACtF,MAAM,eAAe,GAAG,IAAA,4BAAG,EAAC,QAAQ,EAAE,YAAY,CAAuC,CAAC;IAC1F,MAAM,KAAK,GAAG,IAAA,4BAAG,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GACX,eAAe;QACf,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7F,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAA,4BAAG,EAAC,QAAQ,EAAE,WAAW,CAA6B,CAAC;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,WAAW,CAAC;IAC1C,IAAI,OAAO,GAAG,IAAA,+BAAa,EAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAA,iCAAe,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,aAAa,KAAK,SAAS;QAC9D,OAAO,GAAG,IAAA,mCAAiB,EAAC,sBAAsB,CAAC,CAAC;IACtD,MAAM,KAAK,GAAsC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,KAAK,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,OAAO,GAA0C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3E,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QAChC,IAAI,OAAO,EAAE,IAAI,IAAI;YAAE,OAAO,WAAW,CAAC;QAC1C,MAAM,aAAa,GAAG,IAAA,4BAAG,EAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ;YAC7D,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;aACpC,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU;YAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,IAAA,4BAAG,EAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,SAAS,KAAK,SAAS;YAAE,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;QACnD,MAAM,MAAM,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1E,CAAC;IACD,IACE,OAAO,CAAC,MAAM,KAAK,UAAU;QAC7B,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAA,4BAAG,EAAC,MAAM,EAAE,gBAAgB,CAAW,CAAC,CAAC;QAEzE,OAAO,GAAG,IAAA,mCAAiB,EAAC,uBAAuB,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;IAC/C,MAAM,YAAY,GAAG,CAAC,QAAQ,IAAI,IAAA,gCAAc,EAAC,IAAA,4BAAG,EAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAC1F,MAAM,KAAK,GAAgB;QACzB,OAAO,EAAE,YAAY;QACrB,SAAS,EAAE,GAAG;QACd,KAAK;QACL,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;YACvC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAiC,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS;YACpE,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;QAC7B,QAAQ;KACT,CAAC;IACF,MAAM,KAAK,GAAG,IAAA,yBAAiB,EAAC,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,qFAAqF;IACrF,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE;QAC/E,OAAO;KACR,CAAC;AACJ,CAAC;AA3DD,wDA2DC"}
+{"version":3,"file":"causeSnapshot.js","sourceRoot":"","sources":["../../src/trace-toolpack/causeSnapshot.ts"],"names":[],"mappings":";;;AAEA,6DAAyD;AAEzD,kFAAkF;AAClF,SAAgB,sBAAsB,CACpC,SAAiC,EACjC,KAAyC;IAEzC,OAAO,IAAA,sCAAiB,EAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACnF,CAAC;AALD,wDAKC"}

package/dist/trace-toolpack/causeTools.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildCauseTools = void 0;
+exports.traceCauseTools = exports.buildCauseTools = void 0;
 const tools_js_1 = require("../tools/tools.js");
 const causeLimits_js_1 = require("./causeLimits.js");
 const causeResponse_js_1 = require("./causeResponse.js");
 const causeLoad_js_1 = require("./causeLoad.js");
+const causeContext_js_1 = require("./causeContext.js");
 const nodeId = {
     type: 'string',
     minLength: 1,
@@ -37,37 +38,60 @@ const CAUSE_OPERATIONS = {
 };
 /** Model questions select IDs only. The host owns all resource controls. */
 function buildCauseTools(artifacts, nodes, options) {
+    return toolsForContext({ kind: 'snapshot', artifacts, nodes }, options);
+}
+exports.buildCauseTools = buildCauseTools;
+/**
+ * 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.
+ */
+function traceCauseTools(cause, options) {
+    return toolsForContext({ kind: 'graph', cause }, options);
+}
+exports.traceCauseTools = traceCauseTools;
+function toolsForContext(context, options) {
     return Object.keys(CAUSE_OPERATIONS).map((operation) => (0, tools_js_1.defineTool)({
         name: operation,
         ...CAUSE_OPERATIONS[operation],
-        execute: async (question, context) => {
-            const snapshotOnly = artifacts.cause === undefined ? true : undefined;
-            if (context.signal?.aborted)
-                return (0, causeResponse_js_1.causeGap)(operation, 'cancelled', snapshotOnly);
+        execute: async (question, execution) => {
+            const assessed = (0, causeContext_js_1.causeContextAssessment)(context);
+            if (assessed.kind === 'invalid')
+                return (0, causeResponse_js_1.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 (0, causeResponse_js_1.causeGap)(operation, 'cancelled', capture);
             let limits;
             try {
                 limits = (0, causeLimits_js_1.causeLimits)(options);
             }
             catch {
-                return (0, causeResponse_js_1.causeGap)(operation, 'invalid-data', snapshotOnly);
+                return (0, causeResponse_js_1.causeGap)(operation, 'invalid-data', capture, storage, 512);
             }
+            if (execution.signal?.aborted)
+                return (0, causeResponse_js_1.causeGap)(operation, 'cancelled', capture, storage, limits.maxChars);
             const deadline = performance.now() + limits.timeoutMs;
             try {
-                const loaded = await (0, causeLoad_js_1.loadCauseReader)(deadline, context.signal);
+                const loaded = await (0, causeLoad_js_1.loadCauseReader)(deadline, execution.signal);
                 if ('gap' in loaded)
-                    return (0, causeResponse_js_1.causeGap)(operation, loaded.gap, snapshotOnly);
-                return await loaded.reader.readCause(operation, artifacts, nodes, question, limits, deadline, context.signal);
+                    return (0, causeResponse_js_1.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 (0, causeResponse_js_1.causeGap)(operation, context.signal?.aborted
+                return (0, causeResponse_js_1.causeGap)(operation, execution.signal?.aborted
                     ? 'cancelled'
                     : performance.now() >= deadline
                         ? 'timeout'
-                        : 'unavailable', snapshotOnly);
+                        : 'unavailable', capture, storage, limits.maxChars);
             }
         },
     }));
 }
-exports.buildCauseTools = buildCauseTools;
 //# sourceMappingURL=causeTools.js.map

package/dist/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/trace-toolpack/index.js

@@ -19,7 +19,7 @@
  * as navigable as this one.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOOLPACK_HARD_CAPS = exports.SELF_EXPLAIN_MAX_EVENTS = exports.SelfExplainBinding = exports.buildSelfExplainToolProvider = exports.buildSelfExplainSkill = exports.traceDebugAgent = exports.mergeInnerRuns = exports.innerRunsOf = exports.innerRunStore = exports.INNER_RUN_RECORDS = exports.DEFAULT_INNER_RUN_LIMIT = exports.openRecording = exports.NO_COMPLETED_RUN_MESSAGE = exports.lazyTraceToolpack = exports.TRACE_TOOL_NAMES = exports.traceToolpack = exports.callTraceTool = void 0;
+exports.TOOLPACK_HARD_CAPS = exports.SELF_EXPLAIN_MAX_EVENTS = exports.SelfExplainBinding = exports.buildSelfExplainToolProvider = exports.buildSelfExplainSkill = exports.traceDebugAgent = exports.mergeInnerRuns = exports.innerRunsOf = exports.innerRunStore = exports.INNER_RUN_RECORDS = exports.DEFAULT_INNER_RUN_LIMIT = exports.readStoredCauseArtifacts = exports.traceCauseTools = exports.openRecording = exports.NO_COMPLETED_RUN_MESSAGE = exports.lazyTraceToolpack = exports.TRACE_TOOL_NAMES = exports.traceToolpack = exports.callTraceTool = void 0;
 var traceToolpack_js_1 = require("./traceToolpack.js");
 Object.defineProperty(exports, "callTraceTool", { enumerable: true, get: function () { return traceToolpack_js_1.callTraceTool; } });
 Object.defineProperty(exports, "traceToolpack", { enumerable: true, get: function () { return traceToolpack_js_1.traceToolpack; } });
@@ -32,6 +32,10 @@ Object.defineProperty(exports, "lazyTraceToolpack", { enumerable: true, get: fun
 Object.defineProperty(exports, "NO_COMPLETED_RUN_MESSAGE", { enumerable: true, get: function () { return lazyToolpack_js_1.NO_COMPLETED_RUN_MESSAGE; } });
 var openRecording_js_1 = require("./openRecording.js");
 Object.defineProperty(exports, "openRecording", { enumerable: true, get: function () { return openRecording_js_1.openRecording; } });
+var causeTools_js_1 = require("./causeTools.js");
+Object.defineProperty(exports, "traceCauseTools", { enumerable: true, get: function () { return causeTools_js_1.traceCauseTools; } });
+var storedCause_js_1 = require("./storedCause.js");
+Object.defineProperty(exports, "readStoredCauseArtifacts", { enumerable: true, get: function () { return storedCause_js_1.readStoredCauseArtifacts; } });
 // 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/trace-toolpack/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trace-toolpack/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,uDAAoF;AAA3E,iHAAA,aAAa,OAAA;AAAE,iHAAA,aAAa,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AACvD,2EAA2E;AAC3E,6EAA6E;AAC7E,yCAAyC;AACzC,qDAAgF;AAAvE,oHAAA,iBAAiB,OAAA;AAAE,2HAAA,wBAAwB,OAAA;AACpD,uDAA2E;AAAlE,iHAAA,aAAa,OAAA;AAEtB,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,iEAYoC;AAXlC,6HAAA,uBAAuB,OAAA;AACvB,uHAAA,iBAAiB,OAAA;AACjB,mHAAA,aAAa,OAAA;AACb,iHAAA,WAAW,OAAA;AACX,oHAAA,cAAc,OAAA;AAQhB,2DAAoF;AAA3E,qHAAA,eAAe,OAAA;AACxB,mDAS0B;AARxB,uHAAA,qBAAqB,OAAA;AACrB,8HAAA,4BAA4B,OAAA;AAC5B,oHAAA,kBAAkB,OAAA;AAClB,yHAAA,uBAAuB,OAAA;AAMzB,uCAIoB;AAHlB,8GAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trace-toolpack/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,uDAAoF;AAA3E,iHAAA,aAAa,OAAA;AAAE,iHAAA,aAAa,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AACvD,2EAA2E;AAC3E,6EAA6E;AAC7E,yCAAyC;AACzC,qDAAgF;AAAvE,oHAAA,iBAAiB,OAAA;AAAE,2HAAA,wBAAwB,OAAA;AACpD,uDAA2E;AAAlE,iHAAA,aAAa,OAAA;AAEtB,iDAAkD;AAAzC,gHAAA,eAAe,OAAA;AACxB,mDAA4D;AAAnD,0HAAA,wBAAwB,OAAA;AAQjC,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,iEAYoC;AAXlC,6HAAA,uBAAuB,OAAA;AACvB,uHAAA,iBAAiB,OAAA;AACjB,mHAAA,aAAa,OAAA;AACb,iHAAA,WAAW,OAAA;AACX,oHAAA,cAAc,OAAA;AAQhB,2DAAoF;AAA3E,qHAAA,eAAe,OAAA;AACxB,mDAS0B;AARxB,uHAAA,qBAAqB,OAAA;AACrB,8HAAA,4BAA4B,OAAA;AAC5B,oHAAA,kBAAkB,OAAA;AAClB,yHAAA,uBAAuB,OAAA;AAMzB,uCAIoB;AAHlB,8GAAA,kBAAkB,OAAA"}

package/dist/trace-toolpack/storedCause.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readStoredCauseArtifacts = void 0;
+const causeCapture_js_1 = require("./causeCapture.js");
+const storedCauseOptions_js_1 = require("./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.
+ */
+async function readStoredCauseArtifacts(entries, options) {
+    let configured;
+    try {
+        configured = (0, storedCauseOptions_js_1.storedCauseOptions)(options);
+        if ((0, storedCauseOptions_js_1.storedCauseCancelled)(configured.signal))
+            return unknown('cancelled');
+    }
+    catch {
+        return unknown('invalid-data');
+    }
+    if (!globalThis.crypto?.subtle)
+        return unknown('unavailable');
+    let reader;
+    try {
+        ({ readStoredCapture: reader } = await Promise.resolve().then(() => __importStar(require('./storedCauseReader.js'))));
+    }
+    catch {
+        return unknown('unsupported');
+    }
+    if ((0, storedCauseOptions_js_1.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 ((0, storedCauseOptions_js_1.storedCauseCancelled)(configured.signal))
+            return unknown('cancelled');
+        if ((0, causeCapture_js_1.captureOwn)(result, 'status') !== 'acknowledged') {
+            const reason = (0, causeCapture_js_1.captureOwn)(result, 'reason');
+            return unknown(reason === 'reader-limit' || reason === 'history-too-large'
+                ? 'reader-limit'
+                : 'stored-admission');
+        }
+        const history = (0, causeCapture_js_1.captureOwn)(result, 'history');
+        const { projectStoredCause } = await Promise.resolve().then(() => __importStar(require('./storedCauseProjection.js')));
+        if ((0, storedCauseOptions_js_1.storedCauseCancelled)(configured.signal))
+            return unknown('cancelled');
+        const projected = projectStoredCause(history, configured.runId, configured.maxBytes);
+        return (0, storedCauseOptions_js_1.storedCauseCancelled)(configured.signal) ? unknown('cancelled') : projected;
+    }
+    catch {
+        return unknown((0, storedCauseOptions_js_1.storedCauseCancelled)(configured.signal) ? 'cancelled' : 'unavailable');
+    }
+}
+exports.readStoredCauseArtifacts = readStoredCauseArtifacts;
+//# sourceMappingURL=storedCause.js.map

package/dist/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/trace-toolpack/storedCauseBinding.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storedCauseAssessment = exports.bindStoredCause = void 0;
+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. */
+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;
+}
+exports.bindStoredCause = bindStoredCause;
+/** Read identity, never the value of a caller's assessment property or an attached getter. */
+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' };
+    }
+}
+exports.storedCauseAssessment = storedCauseAssessment;
+//# sourceMappingURL=storedCauseBinding.js.map