agentfootprint 9.96.1 → 9.98.0

package/CHANGELOG.md

@@ -5,6 +5,83 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [9.98.0] - 2026-09-15
+
+### Added
+
+- `withDatasetArtifacts(tool, adapter)` and `stageDatasetArtifacts` publish
+  producer-declared datasets through the existing scoped artifact store. Local,
+  HTTP-backed and structured MCP tools share source lineage, unavailable receipts
+  and retention checks. Storage is configured by the host; a frontend is optional.
+  Includes a chatbot-only example that calculates from the same ref on a later
+  turn. This handles materialized results, not streaming or remote dataset handles.
+- MCP clients can opt into `resultMode: 'structured'` or `'structured-or-json'`
+  before dataset adaptation. Structured data survives without text conversion;
+  the fallback accepts only one declared JSON-object text block. Default text
+  decoding is unchanged, and tool errors remain failures.
+- `receipt.requestMeasurement` records JSON character and UTF-8 byte sizes for
+  the initial prepared canonical request and its separately serialized slots,
+  including complete tool schemas. Unsupported or cyclic values report an
+  unavailable measurement without failing the call. Internal work limits report
+  `measurement-limit` at more than 100,000 visited values, 64 nested containers,
+  or 4,000,000 string/key UTF-16 code units while copying or serialized JSON
+  characters; they never truncate or reject provider input. Older receipts may
+  lack the field. Existing advisory counters are unchanged; these sizes do not
+  represent tokens, later retries or provider HTTP payloads. The measurement
+  records no request content; `RequestMeasurement` and `RequestJsonSize` are public types.
+
+### Changed
+
+- Reuse ContextFootprint's pure assertion comparison and Claim-face helpers.
+  Existing assertion keys, witness identity, diagnostic checks and answer-delivery
+  policies remain unchanged. Use the published exact `contextfootprint: "0.1.1"`
+  runtime dependency; remove the temporary vendored archive and bundle used before
+  that registry release. Clean online installs and cached offline installs are
+  checked through source and packed consumers.
+
+### Fixed
+
+- Dataset projections preserve original absence, coverage, clarification and
+  semantic declarations, including recognized tool-effect status/effects.
+  `withDatasetArtifacts` refuses removed, changed or unreadable declarations;
+  optional paired `checkSemantics` fixtures apply the same check at build time.
+  This checks declaration preservation, not factual truth, never infers absence
+  from empty data, and leaves `requestInput` pauses unchanged.
+- `read_skill` describes each visible skill once when the turn-start menu and
+  the catalog or reachability lists overlap. Later memberships retain the skill
+  id; candidate ordering, supplied relevance, cursor, visibility and admission
+  remain unchanged. The default menu hint and tool wording no longer claim an
+  offline scorer necessarily ranked the menu. No routing option is required.
+- Upgrade the shared comparison to ContextFootprint 0.1.1. Distinct JSON data
+  with an own `__proto__` property now produces the expected conflict, including
+  nested objects and known Claim payloads. Legacy recording keys and original
+  witnesses remain unchanged. Pre-call and post-call integration tests exercise
+  the shared implementation. Both release paths now require the packed dependency
+  check before publishing.
+
+## [9.97.0] - 2026-09-13
+
+### Added
+
+- `requestInput()` pauses a collection tool with typed missing fields and a
+  runtime-stamped `awaiting_input` state. Partial replies retain accepted values
+  without model calls; complete replies resume the same tool boundary and skill
+  position through normal result validation, redaction and placement.
+- Hosted typed replies and explicit cancellation preserve session ownership and
+  conversation history. `session-pending` reloads the pending question without
+  exposing the execution checkpoint. Application defaults remain app-owned.
+
+### Fixed
+
+- Hosted cancellation releases the paused session's run resources without
+  executing remaining tools. Run terminals preserve other paused sessions, and
+  teardown events retain the actual registration's run and session identity.
+- Keep documentation within existing browser and export budgets: load only the
+  syntax grammars used by interactive code blocks and prepare SkillGraph demo
+  data on the server while retaining its interactive browser view.
+
 ## [9.96.1] - 2026-09-13
 
 ### Fixed

package/dist/artifacts/datasetResult.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stageDatasetArtifacts = exports.withDatasetArtifacts = void 0;
+const projection_js_1 = require("../lib/semantics/projection.js");
+/**
+ * Adapt any local, HTTP-backed or MCP Tool using the SAME already-bound execution capability.
+ * Claim-check: the host configures storage; the model carries tickets between tools. No UI required.
+ * No store: pass through without calling the adapter; the host's normal result policy still applies.
+ * Writes are independent, not a transaction. A failed source does not hide otherwise readable data;
+ * its unavailable receipt must remain explicit in the producer's projection. Recheck tickets after
+ * the batch because a later put can evict an earlier one. Expiry after publication remains possible.
+ * This stages materialized payloads; it does not add remote handles, streaming or query pushdown.
+ */
+function withDatasetArtifacts(tool, adapter) {
+    return {
+        ...tool,
+        async execute(args, ctx) {
+            const result = await tool.execute(args, ctx);
+            if (!ctx.hasArtifacts)
+                return result;
+            const semantics = (0, projection_js_1.snapshotProjectionSemantics)(result);
+            const plan = await adapter.describe(result, args);
+            if (plan === undefined) {
+                const issues = (0, projection_js_1.projectionSemanticsIssues)(semantics, result);
+                if (issues.length)
+                    throw new Error(issues[0].message);
+                return result;
+            }
+            if (!plan || typeof plan.project !== 'function') {
+                throw new TypeError('A dataset result plan requires a project function.');
+            }
+            const projected = await plan.project(await stageDatasetArtifacts(plan.datasets, ctx.artifacts));
+            const issues = (0, projection_js_1.projectionSemanticsIssues)(semantics, projected);
+            if (issues.length)
+                throw new Error(issues[0].message);
+            return projected;
+        },
+    };
+}
+exports.withDatasetArtifacts = withDatasetArtifacts;
+/** The same staging step for an existing tool pipeline that already owns execution and projection. */
+async function stageDatasetArtifacts(datasets, artifacts) {
+    assertInputs(datasets);
+    const publications = [];
+    for (const entry of datasets) {
+        const source = entry.source ? await put(artifacts, entry.source) : undefined;
+        const parentRefs = source?.status === 'stored'
+            ? [...(entry.artifact.parentRefs ?? []), source.meta.ref]
+            : entry.artifact.parentRefs;
+        const artifact = await put(artifacts, { ...entry.artifact, ...(parentRefs && { parentRefs }) });
+        publications.push({ key: entry.key, artifact, ...(source && { source }) });
+    }
+    const held = [];
+    for (const publication of publications) {
+        const artifact = await current(artifacts, publication.artifact);
+        const source = publication.source ? await current(artifacts, publication.source) : undefined;
+        held.push({ key: publication.key, artifact, ...(source && { source }) });
+    }
+    return held;
+}
+exports.stageDatasetArtifacts = stageDatasetArtifacts;
+async function put(artifacts, input) {
+    try {
+        return { status: 'stored', meta: await artifacts.put(input) };
+    }
+    catch {
+        // Store exceptions may contain connection strings. The existing artifact event records the refusal.
+        return { status: 'unavailable', reason: 'store-unavailable' };
+    }
+}
+async function current(artifacts, receipt) {
+    if (receipt.status !== 'stored')
+        return receipt;
+    try {
+        const meta = await artifacts.head(receipt.meta.ref);
+        return meta
+            ? { status: 'stored', meta }
+            : { status: 'unavailable', reason: 'missing-or-expired' };
+    }
+    catch {
+        return { status: 'unavailable', reason: 'store-unavailable' };
+    }
+}
+/** Validate declaration shape before any writes. Payload serialization and parent proofs belong to the store. */
+function assertInputs(datasets) {
+    if (!Array.isArray(datasets)) {
+        throw new TypeError('Dataset declarations must be an array.');
+    }
+    const keys = new Set();
+    for (const entry of datasets) {
+        if (!entry || typeof entry.key !== 'string' || entry.key.trim() === '' || keys.has(entry.key)) {
+            throw new TypeError('Dataset keys must be nonempty and unique within one result.');
+        }
+        keys.add(entry.key);
+        for (const input of [entry.artifact, ...(entry.source === undefined ? [] : [entry.source])]) {
+            if (!input ||
+                typeof input !== 'object' ||
+                Array.isArray(input) ||
+                typeof input.kind !== 'string' ||
+                !input.kind.trim() ||
+                typeof input.mediaType !== 'string' ||
+                !input.mediaType.trim() ||
+                !Object.prototype.hasOwnProperty.call(input, 'data')) {
+                throw new TypeError('Each dataset/source artifact requires kind, mediaType and data.');
+            }
+            if (input.parentRefs !== undefined) {
+                if (!Array.isArray(input.parentRefs)) {
+                    throw new TypeError('Dataset/source parentRefs must be an array of strings.');
+                }
+                for (const ref of input.parentRefs) {
+                    if (typeof ref !== 'string') {
+                        throw new TypeError('Dataset/source parentRefs must be an array of strings.');
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=datasetResult.js.map

package/dist/artifacts/datasetResult.js.map

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

package/dist/artifacts/index.js

@@ -11,7 +11,7 @@
  * this folder for the one-job map and the import direction.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.placedToolResult = exports.placedResultKind = exports.isPlacedToolResult = exports.assertArtifactPlacement = exports.runArtifactStoreConformance = exports.runArtifactStoreCase = exports.formatArtifactStoreReport = exports.artifactStoreConformance = exports.UnserializableRecordingError = exports.chartWalkPutInput = exports.CHART_WALK_ARTIFACT_KIND = exports.RECORDING_MEDIA_TYPE = exports.RECORDING_ARTIFACT_KIND = exports.recordingPutInput = exports.presentArtifact = exports.PRESENT_TOOL_NAME = exports.wantsNeedsStoreRefusal = exports.resolveToolWants = exports.assertToolWants = exports.unconfiguredArtifacts = exports.bindArtifacts = exports.collectStream = exports.canStreamArtifacts = exports.canPutArtifactStream = exports.canGetArtifactStream = exports.bytesAsStream = exports.assertStreamBytes = exports.gcsArtifacts = exports.s3Artifacts = exports.UnreadableArtifactStoreError = exports.sqliteArtifacts = exports.UnreadableArtifactFileError = exports.fileArtifacts = exports.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION = exports.inMemoryArtifacts = exports.mintArtifactRef = exports.isArtifactRef = exports.ARTIFACT_REF_PREFIX = exports.UnknownParentRefError = exports.InvalidArtifactError = exports.ArtifactIntegrityError = void 0;
+exports.stageDatasetArtifacts = exports.withDatasetArtifacts = exports.placedToolResult = exports.placedResultKind = exports.isPlacedToolResult = exports.assertArtifactPlacement = exports.runArtifactStoreConformance = exports.runArtifactStoreCase = exports.formatArtifactStoreReport = exports.artifactStoreConformance = exports.UnserializableRecordingError = exports.chartWalkPutInput = exports.CHART_WALK_ARTIFACT_KIND = exports.RECORDING_MEDIA_TYPE = exports.RECORDING_ARTIFACT_KIND = exports.recordingPutInput = exports.presentArtifact = exports.PRESENT_TOOL_NAME = exports.wantsNeedsStoreRefusal = exports.resolveToolWants = exports.assertToolWants = exports.unconfiguredArtifacts = exports.bindArtifacts = exports.collectStream = exports.canStreamArtifacts = exports.canPutArtifactStream = exports.canGetArtifactStream = exports.bytesAsStream = exports.assertStreamBytes = exports.gcsArtifacts = exports.s3Artifacts = exports.UnreadableArtifactStoreError = exports.sqliteArtifacts = exports.UnreadableArtifactFileError = exports.fileArtifacts = exports.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION = exports.inMemoryArtifacts = exports.mintArtifactRef = exports.isArtifactRef = exports.ARTIFACT_REF_PREFIX = exports.UnknownParentRefError = exports.InvalidArtifactError = exports.ArtifactIntegrityError = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "ArtifactIntegrityError", { enumerable: true, get: function () { return types_js_1.ArtifactIntegrityError; } });
 Object.defineProperty(exports, "InvalidArtifactError", { enumerable: true, get: function () { return types_js_1.InvalidArtifactError; } });
@@ -71,4 +71,7 @@ Object.defineProperty(exports, "assertArtifactPlacement", { enumerable: true, ge
 Object.defineProperty(exports, "isPlacedToolResult", { enumerable: true, get: function () { return placement_js_1.isPlacedToolResult; } });
 Object.defineProperty(exports, "placedResultKind", { enumerable: true, get: function () { return placement_js_1.placedResultKind; } });
 Object.defineProperty(exports, "placedToolResult", { enumerable: true, get: function () { return placement_js_1.placedToolResult; } });
+var datasetResult_js_1 = require("./datasetResult.js");
+Object.defineProperty(exports, "withDatasetArtifacts", { enumerable: true, get: function () { return datasetResult_js_1.withDatasetArtifacts; } });
+Object.defineProperty(exports, "stageDatasetArtifacts", { enumerable: true, get: function () { return datasetResult_js_1.stageDatasetArtifacts; } });
 //# sourceMappingURL=index.js.map

package/dist/artifacts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,uCAkBoB;AAjBlB,kHAAA,sBAAsB,OAAA;AACtB,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AAgBvB,yCAAkF;AAAzE,gHAAA,mBAAmB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAE5D,+DAKgC;AAJ9B,yHAAA,iBAAiB,OAAA;AACjB,4IAAA,oCAAoC,OAAA;AAItC,uDAI4B;AAH1B,iHAAA,aAAa,OAAA;AACb,+HAAA,2BAA2B,OAAA;AAG7B,2DAK8B;AAJ5B,qHAAA,eAAe,OAAA;AACf,kIAAA,4BAA4B,OAAA;AAI9B,mDAAwE;AAA/D,6GAAA,WAAW,OAAA;AACpB,qDAA2E;AAAlE,+GAAA,YAAY,OAAA;AACrB,+CAUwB;AATtB,iHAAA,iBAAiB,OAAA;AACjB,6GAAA,aAAa,OAAA;AACb,oHAAA,oBAAoB,OAAA;AACpB,oHAAA,oBAAoB,OAAA;AACpB,kHAAA,kBAAkB,OAAA;AAClB,6GAAA,aAAa,OAAA;AAKf,iDAUyB;AATvB,8GAAA,aAAa,OAAA;AACb,sHAAA,qBAAqB,OAAA;AASvB,uCAOoB;AANlB,2GAAA,eAAe,OAAA;AACf,4GAAA,gBAAgB,OAAA;AAChB,kHAAA,sBAAsB,OAAA;AAKxB,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,6GAAA,eAAe,OAAA;AAKjB,+DASgC;AAR9B,yHAAA,iBAAiB,OAAA;AACjB,+HAAA,uBAAuB,OAAA;AACvB,4HAAA,oBAAoB,OAAA;AACpB,gIAAA,wBAAwB,OAAA;AACxB,yHAAA,iBAAiB,OAAA;AACjB,oIAAA,4BAA4B,OAAA;AAI9B,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,mCAAmC;AACnC,mDAagC;AAZ9B,oHAAA,wBAAwB,OAAA;AACxB,qHAAA,yBAAyB,OAAA;AACzB,gHAAA,oBAAoB,OAAA;AACpB,uHAAA,2BAA2B,OAAA;AAU7B,+CAOwB;AANtB,uHAAA,uBAAuB,OAAA;AACvB,kHAAA,kBAAkB,OAAA;AAClB,gHAAA,gBAAgB,OAAA;AAChB,gHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,uCAkBoB;AAjBlB,kHAAA,sBAAsB,OAAA;AACtB,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AAgBvB,yCAAkF;AAAzE,gHAAA,mBAAmB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAE5D,+DAKgC;AAJ9B,yHAAA,iBAAiB,OAAA;AACjB,4IAAA,oCAAoC,OAAA;AAItC,uDAI4B;AAH1B,iHAAA,aAAa,OAAA;AACb,+HAAA,2BAA2B,OAAA;AAG7B,2DAK8B;AAJ5B,qHAAA,eAAe,OAAA;AACf,kIAAA,4BAA4B,OAAA;AAI9B,mDAAwE;AAA/D,6GAAA,WAAW,OAAA;AACpB,qDAA2E;AAAlE,+GAAA,YAAY,OAAA;AACrB,+CAUwB;AATtB,iHAAA,iBAAiB,OAAA;AACjB,6GAAA,aAAa,OAAA;AACb,oHAAA,oBAAoB,OAAA;AACpB,oHAAA,oBAAoB,OAAA;AACpB,kHAAA,kBAAkB,OAAA;AAClB,6GAAA,aAAa,OAAA;AAKf,iDAUyB;AATvB,8GAAA,aAAa,OAAA;AACb,sHAAA,qBAAqB,OAAA;AASvB,uCAOoB;AANlB,2GAAA,eAAe,OAAA;AACf,4GAAA,gBAAgB,OAAA;AAChB,kHAAA,sBAAsB,OAAA;AAKxB,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,6GAAA,eAAe,OAAA;AAKjB,+DASgC;AAR9B,yHAAA,iBAAiB,OAAA;AACjB,+HAAA,uBAAuB,OAAA;AACvB,4HAAA,oBAAoB,OAAA;AACpB,gIAAA,wBAAwB,OAAA;AACxB,yHAAA,iBAAiB,OAAA;AACjB,oIAAA,4BAA4B,OAAA;AAI9B,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,mCAAmC;AACnC,mDAagC;AAZ9B,oHAAA,wBAAwB,OAAA;AACxB,qHAAA,yBAAyB,OAAA;AACzB,gHAAA,oBAAoB,OAAA;AACpB,uHAAA,2BAA2B,OAAA;AAU7B,+CAOwB;AANtB,uHAAA,uBAAuB,OAAA;AACvB,kHAAA,kBAAkB,OAAA;AAClB,gHAAA,gBAAgB,OAAA;AAChB,gHAAA,gBAAgB,OAAA;AAIlB,uDAQ4B;AAP1B,wHAAA,oBAAoB,OAAA;AACpB,yHAAA,qBAAqB,OAAA"}

package/dist/core/Agent.js

@@ -118,6 +118,7 @@ const routeTurn_js_1 = require("./agent/stages/routeTurn.js");
 const outputFallback_js_1 = require("./outputFallback.js");
 const runCheckpoint_js_1 = require("./runCheckpoint.js");
 const conversation_js_1 = require("./conversation.js");
+const inputRequest_js_1 = require("./inputRequest.js");
 const outputSchema_js_1 = require("./outputSchema.js");
 const runInput_js_1 = require("./runInput.js");
 const outputRetry_js_1 = require("./agent/stages/outputRetry.js");
@@ -1604,6 +1605,38 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         const gate = (0, pause_js_1.pauseDemandsDecision)(checkpoint.pauseData);
         if (gate && !(0, checkin_js_1.isCheckInDecision)(input))
             throw new pause_js_1.DecisionRequiredError(gate, input);
+        // Typed data collection is not consent. Validate before changing any run state.
+        const awaitingInput = gate === undefined ? (0, inputRequest_js_1.readAwaitingInput)(checkpoint.pauseData) : undefined;
+        if (awaitingInput !== undefined) {
+            this.assertNotRunning('Agent.resume');
+            const answered = (0, inputRequest_js_1.applyInputResponse)(awaitingInput, input);
+            if ('cancel' in answered) {
+                throw new TypeError('[input request] Cancel a hosted request through its host, or abandonPause() before starting another run.');
+            }
+            if (answered.missing.length > 0) {
+                const copy = structuredClone(checkpoint);
+                const pauseData = {
+                    ...copy.pauseData,
+                    awaitingInput: answered,
+                };
+                const outcome = {
+                    paused: true,
+                    checkpoint: { ...copy, pauseData },
+                    pauseData,
+                    awaitingInput: answered,
+                };
+                this.recordPendingQuestion(outcome);
+                return outcome;
+            }
+            input = {
+                status: 'input_received',
+                requestId: answered.requestId,
+                values: answered.supplied,
+                origins: answered.origins,
+                origin: answered.origin,
+                ...(answered.context !== undefined && { context: answered.context }),
+            };
+        }
         // And the answer must be about the thing that was asked. Checked HERE, at
         // the same door and before any state moves, because a resume that has begun
         // is a resume that has already used the value.
@@ -1678,7 +1711,7 @@ class Agent extends RunnerBase_js_1.RunnerBase {
      * Fired for the TURN, not for `currentRunContext.runId` — `resume()` mints a
      * fresh run id, so a pause and its resume are one turn across two runs, and
      * filtering on the id would leave everything a paused turn opened alive
-     * forever. See `ToolSessionTier.fireRun`.
+     * forever. Hosted turns are scoped to their session, preserving other pauses. See `ToolSessionTier.fireRun`.
      *
      * @param outcome what `run()`/`resume()` is about to return, or about to throw.
      */
@@ -1689,7 +1722,10 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             return;
         if (outcome instanceof Error && outcome.name === 'PauseSignal')
             return;
-        await this.toolSessionTier.fireRun();
+        if (this.currentRunContext.sessionId !== undefined)
+            await this.toolSessionTier.fireSessionRuns(this.currentRunContext.sessionId);
+        else
+            await this.toolSessionTier.fireRun();
     }
     /**
      * The conversation this agent's LAST completed run leaves behind, packed as
@@ -1981,6 +2017,7 @@ class Agent extends RunnerBase_js_1.RunnerBase {
      */
     toolRunFacts() {
         return {
+            runContext: { ...this.currentRunContext },
             runId: this.currentRunContext.runId,
             ...(this.currentRunContext.sessionId !== undefined && {
                 sessionId: this.currentRunContext.sessionId,
@@ -1998,7 +2035,7 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         if (!this.toolSessionTier) {
             this.toolSessionTier = new toolSessions_js_1.ToolSessionTier({
                 timeoutMs: this.toolTeardownTimeoutMs,
-                report: (report) => this.emitToolSessionReport(report),
+                report: (report, origin) => this.emitToolSessionReport(report, origin),
             });
         }
         return this.toolSessionTier;
@@ -2017,10 +2054,10 @@ class Agent extends RunnerBase_js_1.RunnerBase {
      * hardcodes `runId: 'consumer-scope'`, and a teardown event stamped that way
      * cannot be joined to the run that OPENED the session — the exact
      * unjoinability 9.4.0 spent a release fixing for credential events. So the
-     * meta comes from `currentRunContext`, with a STATED pseudo-stage, the same
+     * meta comes from the registration-time run context, with a STATED pseudo-stage, the same
      * move as the `'<stageId>#paused'` stamp at the pause boundary.
      */
-    emitToolSessionReport(report) {
+    emitToolSessionReport(report, origin) {
         const type = report.kind === 'closed'
             ? 'agentfootprint.tools.session_closed'
             : 'agentfootprint.tools.session_close_failed';
@@ -2031,7 +2068,7 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         dispatcher.dispatch({
             type,
             payload,
-            meta: (0, eventMeta_js_1.buildEventMeta)({ runtimeStageId: TOOL_TEARDOWN_STAGE_ID }, this.currentRunContext),
+            meta: (0, eventMeta_js_1.buildEventMeta)({ runtimeStageId: TOOL_TEARDOWN_STAGE_ID }, origin.runContext ?? this.currentRunContext),
         });
     }
     openSkillIds() {