agentfootprint 10.3.1 → 10.4.0

package/dist/memory/store/writeOptions.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindWriteOptions = exports.assertStoreHonours = exports.refuseUnhonouredWriteOptions = exports.requestedWriteOptions = exports.UnsupportedMemoryWriteOptionError = exports.NO_SERVER_EXTRACTION = exports.MEMORY_WRITE_OPTION_NAMES = void 0;
+/** Every write option, in the order refusals name them. */
+exports.MEMORY_WRITE_OPTION_NAMES = [
+    'extraction',
+    'namespaceScope',
+];
+/**
+ * The reason a store with NO server-side extraction gives — the shared
+ * sentence, so every such store refuses in the same words, remedy included.
+ */
+exports.NO_SERVER_EXTRACTION = 'it keeps exactly the entries it is given and derives no long-term records from ' +
+    'them — there is no extraction to skip and no derived namespace to scope (its ' +
+    'tenant boundary is the identity tuple). Leave the option off for this store, or ' +
+    'use a store that declares it in `writeOptions`';
+/**
+ * Thrown when a write asks for an option the store does not honour.
+ *
+ * Carries the store and the option by name; never a value — a namespace scope
+ * names a tenant, and an error message is the one place a tenant id must not
+ * travel. The remedy is in the store's own reason.
+ */
+class UnsupportedMemoryWriteOptionError extends Error {
+    code = 'ERR_UNSUPPORTED_MEMORY_WRITE_OPTION';
+    /** The store that refused, e.g. `'InMemoryStore'`. */
+    store;
+    /** The option it cannot honour. */
+    option;
+    constructor(store, option, why) {
+        super(`[memory] ${store} cannot honour the write option \`${option}\`: ${why}. It is ` +
+            'refused rather than ignored — a write that dropped it would look exactly like one ' +
+            'that honoured it.');
+        this.name = 'UnsupportedMemoryWriteOptionError';
+        this.store = store;
+        this.option = option;
+    }
+}
+exports.UnsupportedMemoryWriteOptionError = UnsupportedMemoryWriteOptionError;
+/**
+ * The options this write actually asks for, its values checked.
+ *
+ * A field that is `undefined` is not asked for; an empty `namespaceScope` asks
+ * for nothing either. A value of the wrong shape is a programming error, so it
+ * throws a `TypeError` naming the option — and never echoes the value.
+ */
+function requestedWriteOptions(options) {
+    if (options === undefined || options === null)
+        return [];
+    const asked = [];
+    if (options.extraction !== undefined) {
+        assertExtraction(options.extraction);
+        asked.push('extraction');
+    }
+    if (options.namespaceScope !== undefined) {
+        assertScopeShape(options.namespaceScope);
+        if (Object.keys(options.namespaceScope).length > 0)
+            asked.push('namespaceScope');
+    }
+    return asked;
+}
+exports.requestedWriteOptions = requestedWriteOptions;
+/**
+ * Refuse, by name, every write option `options` asks for that `honoured` does
+ * not contain. Call it first thing in `put`, `putMany` and `putIfVersion` —
+ * before anything is written.
+ *
+ * @param store    the store's name, as the refusal should say it
+ * @param honoured the store's own declaration (`MemoryStore.writeOptions`)
+ * @param options  what this write asked for
+ * @param why      why this store cannot honour what it does not declare, and
+ *                 what to do instead
+ * @throws {UnsupportedMemoryWriteOptionError} for the first option not honoured
+ */
+function refuseUnhonouredWriteOptions(store, honoured, options, why) {
+    for (const option of requestedWriteOptions(options)) {
+        if (!(honoured ?? []).includes(option)) {
+            throw new UnsupportedMemoryWriteOptionError(store, option, why);
+        }
+    }
+}
+exports.refuseUnhonouredWriteOptions = refuseUnhonouredWriteOptions;
+/**
+ * Refuse a memory's write options or scope at DEFINITION time when its store
+ * does not declare them, or when a fixed one is malformed — the first turn
+ * should not be where a configuration that can never work is discovered.
+ *
+ * @throws {UnsupportedMemoryWriteOptionError} naming the store and the option
+ * @throws {TypeError} for a malformed option
+ */
+function assertStoreHonours(store, config, caller) {
+    const asked = [];
+    if (config.extraction !== undefined) {
+        assertExtraction(config.extraction);
+        asked.push('extraction');
+    }
+    if (config.namespaceScope !== undefined) {
+        if (typeof config.namespaceScope !== 'function') {
+            assertScopeShape(config.namespaceScope);
+            assertNonEmptyScope(config.namespaceScope, caller);
+        }
+        asked.push('namespaceScope');
+    }
+    for (const option of asked) {
+        if (!(store.writeOptions ?? []).includes(option)) {
+            throw new UnsupportedMemoryWriteOptionError(storeName(store), option, `it does not declare \`${option}\` in \`writeOptions\` (checked by ${caller}, before ` +
+                'any turn ran). A store that declares it can take it; otherwise leave the option off');
+        }
+    }
+}
+exports.assertStoreHonours = assertStoreHonours;
+/**
+ * The store with the memory's write options applied to every write it makes —
+ * and its namespace scope applied to every read.
+ *
+ * Writes (`put`, `putMany`, `putIfVersion`) carry the options. A call's own
+ * `extraction` overrides the bound one only where it asks for something (an
+ * `undefined` field never erases it). A bound `namespaceScope` is NEVER
+ * replaced per call: it comes from the run's identity through the configured
+ * resolver and nowhere else, so a call that brings its own is refused.
+ *
+ * Reads follow the same rule as writes: `search` hands a store that declares
+ * `'namespaceScope'` the scope resolved for that identity
+ * (`SearchOptions.namespaceScope`), so a store that files derived records by it
+ * reads within it. Every other member passes straight through.
+ *
+ * @throws (as a rejected promise, at a write or a search) a `TypeError` when
+ *   the scope function returns an empty or malformed scope — refused rather
+ *   than sent outside every tenant's namespace — or when a call brings its
+ *   own `namespaceScope` to a memory that binds one.
+ */
+function bindWriteOptions(store, config) {
+    const scopeIsBound = config.namespaceScope !== undefined;
+    const refuseOwnScope = (own) => {
+        if (scopeIsBound && own !== undefined && Object.keys(own).length > 0) {
+            throw new TypeError('defineMemory: this memory binds `namespaceScope` to the run’s identity, and a call ' +
+                'cannot replace it — a scope chosen per ' +
+                'call could file or read one tenant’s records under another’s. Change the resolver, ' +
+                'not the call.');
+        }
+    };
+    const resolve = (identity, own) => {
+        refuseOwnScope(own?.namespaceScope);
+        const scope = boundScope(config, identity);
+        const ownScope = own?.namespaceScope;
+        return {
+            ...(config.extraction !== undefined && { extraction: config.extraction }),
+            ...(scope !== undefined && { namespaceScope: scope }),
+            ...(own?.extraction !== undefined && { extraction: own.extraction }),
+            // Only reachable when nothing is bound: the store checks it like any write.
+            ...(ownScope !== undefined &&
+                Object.keys(ownScope).length > 0 && { namespaceScope: ownScope }),
+        };
+    };
+    // Reads carry the scope only to a store that files by it — the same store
+    // `assertStoreHonours` let the scope be bound to.
+    const readsByScope = scopeIsBound && (store.writeOptions ?? []).includes('namespaceScope');
+    const readOptions = (identity, options) => {
+        refuseOwnScope(options?.namespaceScope);
+        if (!readsByScope)
+            return options;
+        const scope = boundScope(config, identity, 'this search');
+        return scope === undefined ? options : { ...options, namespaceScope: scope };
+    };
+    const bound = {
+        ...(store.supportsVectorSearch !== undefined && {
+            supportsVectorSearch: store.supportsVectorSearch,
+        }),
+        ...(store.ranksBy !== undefined && { ranksBy: store.ranksBy }),
+        ...(store.writeOptions !== undefined && { writeOptions: store.writeOptions }),
+        get: (identity, id) => store.get(identity, id),
+        // `async`, so a refused scope is a rejected promise, as the port promises —
+        // never a synchronous throw from a method the caller awaits.
+        put: async (identity, entry, own) => store.put(identity, entry, resolve(identity, own)),
+        putMany: async (identity, entries, own) => 
+        // The port's empty-batch law: no write, so nothing to resolve or refuse.
+        entries.length === 0
+            ? store.putMany(identity, entries)
+            : store.putMany(identity, entries, resolve(identity, own)),
+        putIfVersion: async (identity, entry, expectedVersion, own) => store.putIfVersion(identity, entry, expectedVersion, resolve(identity, own)),
+        list: (identity, options) => store.list(identity, options),
+        delete: (identity, id) => store.delete(identity, id),
+        seen: (identity, signature) => store.seen(identity, signature),
+        recordSignature: (identity, signature) => store.recordSignature(identity, signature),
+        feedback: (identity, id, usefulness) => store.feedback(identity, id, usefulness),
+        getFeedback: (identity, id) => store.getFeedback(identity, id),
+        forget: (identity) => store.forget(identity),
+        // Present exactly when the store's is: `if (store.search)` is how callers
+        // feature-detect it, so the bound store must not grow or lose one.
+        ...(store.search !== undefined && {
+            search: async (identity, query, options) => store.search(identity, query, readOptions(identity, options)),
+        }),
+    };
+    return bound;
+}
+exports.bindWriteOptions = bindWriteOptions;
+// ── Checks ─────────────────────────────────────────────────────────────
+/** The configured scope for this identity — present, plain, non-empty, or refused. */
+function boundScope(config, identity, what = 'this write') {
+    if (config.namespaceScope === undefined)
+        return undefined;
+    const scope = typeof config.namespaceScope === 'function'
+        ? config.namespaceScope(identity)
+        : config.namespaceScope;
+    assertScopeShape(scope);
+    // Copy FIRST, then check the copy: the values checked are the values every
+    // store sees — whatever the resolver's object does afterwards, or does on a
+    // second read (a getter, a Proxy that reports one value and returns another).
+    const copy = Object.freeze({ ...scope });
+    assertScopeShape(copy);
+    assertNonEmptyScope(copy, what);
+    return copy;
+}
+function assertExtraction(value) {
+    if (value !== 'skip') {
+        throw new TypeError("[memory] the write option `extraction` takes one value, 'skip' — got " +
+            `${typeof value === 'string' ? JSON.stringify(value) : typeof value}.`);
+    }
+}
+function assertScopeShape(value) {
+    if (!isStringRecord(value)) {
+        throw new TypeError('[memory] the write option `namespaceScope` must be a plain object of string values ' +
+            '(variable name → value). The value given is not quoted here: it names a tenant.');
+    }
+}
+function assertNonEmptyScope(scope, where) {
+    if (Object.keys(scope).length === 0) {
+        throw new TypeError(`[memory] the memory's \`namespaceScope\` came back EMPTY for ${where}. It is refused ` +
+            'rather than run without one: a write with no scope files its derived records outside ' +
+            'every tenant’s namespace, and a search with none is confined to no tenant. Return the ' +
+            'scope for every identity, or refuse the identity yourself.');
+    }
+}
+/** The store's own name for a refusal — its class, or what the caller holds. */
+function storeName(store) {
+    const ctor = store.constructor?.name;
+    return ctor !== undefined && ctor !== 'Object' && ctor !== '' ? ctor : 'the store you passed';
+}
+/** A PLAIN object (no class, no Map, no Promise) whose own values are all strings. */
+function isStringRecord(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null)
+        return false;
+    // Data properties only: a getter could answer the check one value and the
+    // store another.
+    return Object.values(Object.getOwnPropertyDescriptors(value)).every((d) => 'value' in d && typeof d.value === 'string');
+}
+//# sourceMappingURL=writeOptions.js.map

package/dist/memory/store/writeOptions.js.map

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

package/dist/memory-providers.js

@@ -22,7 +22,7 @@
  * symbols, one door. Import from the door.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BedrockAgentMemory = exports.s3VectorsStore = exports.PgVectorSchemaError = exports.pgVectorStore = exports.EmbedderMismatchError = exports.SqliteUnavailableError = exports.UnreadableIndexFileError = exports.sqliteVectorStore = exports.scoreFromDistance = exports.MAX_CARRIED_JSON = exports.MAX_PAGE_SIZE = exports.MemoryBankStore = exports.memoryBankStore = exports.UnreadableMemoryEntryError = exports.AgentCoreStore = exports.RedisStore = void 0;
+exports.BedrockAgentMemory = exports.s3VectorsStore = exports.PgVectorSchemaError = exports.pgVectorStore = exports.EmbedderMismatchError = exports.SqliteUnavailableError = exports.UnreadableIndexFileError = exports.sqliteVectorStore = exports.scoreFromDistance = exports.MAX_CARRIED_JSON = exports.MAX_PAGE_SIZE = exports.MemoryBankStore = exports.memoryBankStore = exports.agentCoreNamespaceValue = exports.UnreadableMemoryEntryError = exports.AgentCoreStore = exports.RedisStore = void 0;
 // Lazy-required peer-dep stores. Both adapters defer their vendor SDK
 // `require()` to constructor time; importing this barrel doesn't load
 // `ioredis` or `@aws-sdk/client-bedrock-agent-runtime`.
@@ -31,6 +31,9 @@ Object.defineProperty(exports, "RedisStore", { enumerable: true, get: function (
 var agentcore_js_1 = require("./adapters/memory/agentcore.js");
 Object.defineProperty(exports, "AgentCoreStore", { enumerable: true, get: function () { return agentcore_js_1.AgentCoreStore; } });
 Object.defineProperty(exports, "UnreadableMemoryEntryError", { enumerable: true, get: function () { return agentcore_js_1.UnreadableMemoryEntryError; } });
+// A tenant id in the alphabet AgentCore admits for a namespace variable,
+// one-to-one — what `defineMemory({ namespaceScope })` and `searchNamespace` map with.
+Object.defineProperty(exports, "agentCoreNamespaceValue", { enumerable: true, get: function () { return agentcore_js_1.agentCoreNamespaceValue; } });
 // Vertex AI Memory Bank — a NATURAL-LANGUAGE memory service, not a vector
 // store: it declares `supportsVectorSearch: false` and `ranksBy: 'server-text'`
 // so the corpus builders refuse it by name, and it converts the service's

package/dist/memory-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../src/memory-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,uDAKoC;AAJlC,sGAAA,UAAU,OAAA;AAMZ,+DAOwC;AANtC,8GAAA,cAAc,OAAA;AACd,0HAAA,0BAA0B,OAAA;AAO5B,0EAA0E;AAC1E,gFAAgF;AAChF,0EAA0E;AAC1E,yEAAyE;AACzE,gFAAgF;AAChF,wEAAwE;AACxE,+EAA+E;AAC/E,4DAA4D;AAC5D,iEAQyC;AAPvC,gHAAA,eAAe,OAAA;AACf,gHAAA,eAAe,OAAA;AACf,8GAAA,aAAa,OAAA;AACb,iHAAA,gBAAgB,OAAA;AAChB,kHAAA,iBAAiB,OAAA;AAKnB,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,mDAAmD;AACnD,qEAQ2C;AAPzC,oHAAA,iBAAiB,OAAA;AACjB,2HAAA,wBAAwB,OAAA;AAQ1B,6EAA6E;AAC7E,8EAA8E;AAC9E,mEAAoE;AAA3D,8HAAA,sBAAsB,OAAA;AAE/B,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,sDAAsD;AACtD,iEAAkE;AAAzD,4HAAA,qBAAqB,OAAA;AAE9B,gFAAgF;AAChF,+EAA+E;AAC/E,+DAA+D;AAC/D,6DASuC;AARrC,4GAAA,aAAa,OAAA;AACb,kHAAA,mBAAmB,OAAA;AASrB,gFAAgF;AAChF,gEAAgE;AAChE,iDAAiD;AACjD,+DAMwC;AALtC,8GAAA,cAAc,OAAA;AAOhB,8EAA8E;AAC9E,yEAAyE;AACzE,iFAKiD;AAJ/C,2HAAA,kBAAkB,OAAA"}
+{"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../src/memory-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,uDAKoC;AAJlC,sGAAA,UAAU,OAAA;AAMZ,+DAUwC;AATtC,8GAAA,cAAc,OAAA;AACd,0HAAA,0BAA0B,OAAA;AAC1B,yEAAyE;AACzE,uFAAuF;AACvF,uHAAA,uBAAuB,OAAA;AAOzB,0EAA0E;AAC1E,gFAAgF;AAChF,0EAA0E;AAC1E,yEAAyE;AACzE,gFAAgF;AAChF,wEAAwE;AACxE,+EAA+E;AAC/E,4DAA4D;AAC5D,iEAQyC;AAPvC,gHAAA,eAAe,OAAA;AACf,gHAAA,eAAe,OAAA;AACf,8GAAA,aAAa,OAAA;AACb,iHAAA,gBAAgB,OAAA;AAChB,kHAAA,iBAAiB,OAAA;AAKnB,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,mDAAmD;AACnD,qEAQ2C;AAPzC,oHAAA,iBAAiB,OAAA;AACjB,2HAAA,wBAAwB,OAAA;AAQ1B,6EAA6E;AAC7E,8EAA8E;AAC9E,mEAAoE;AAA3D,8HAAA,sBAAsB,OAAA;AAE/B,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,sDAAsD;AACtD,iEAAkE;AAAzD,4HAAA,qBAAqB,OAAA;AAE9B,gFAAgF;AAChF,+EAA+E;AAC/E,+DAA+D;AAC/D,6DASuC;AARrC,4GAAA,aAAa,OAAA;AACb,kHAAA,mBAAmB,OAAA;AASrB,gFAAgF;AAChF,gEAAgE;AAChE,iDAAiD;AACjD,+DAMwC;AALtC,8GAAA,cAAc,OAAA;AAOhB,8EAA8E;AAC9E,yEAAyE;AACzE,iFAKiD;AAJ/C,2HAAA,kBAAkB,OAAA"}

package/dist/patterns/MapReduce.js

@@ -26,6 +26,7 @@ const RunnerBase_js_1 = require("../core/RunnerBase.js");
 const Parallel_js_1 = require("../core-flow/Parallel.js");
 const Sequence_js_1 = require("../core-flow/Sequence.js");
 const declared_js_1 = require("../redaction/declared.js");
+const memberRun_js_1 = require("../core/memberRun.js");
 const SHARD_DELIMITER = '\u001F'; // ASCII Unit Separator — unlikely in real text.
 /**
  * Build a MapReduce Runner. At run time:
@@ -134,21 +135,26 @@ class ShardBranchRunner extends RunnerBase_js_1.RunnerBase {
         // The wrapped runner's redaction policy travels with the shard, so the
         // `Parallel` that fans the shards out covers it (`src/redaction/declared.ts`).
         (0, declared_js_1.adoptMemberRedaction)(this, [inner]);
+        // It hands the run it serves on to the wrapped runner (`core/memberRun.ts`).
+        (0, memberRun_js_1.readsParentRun)(this);
     }
     getSpec() {
         // Build a wrapper chart that unpacks the shard and invokes the
         // inner chart. The inner LLMCall's chart runs as a subflow whose
         // input is the extracted shard.
         const shardIndex = this.shardIndex;
-        const innerChart = this.inner.getSpec();
+        const inner = this.inner;
+        const innerChart = inner.getSpec();
         return (0, footprintjs_1.flowChart)('Unpack', (scope) => {
             const args = scope.$getArgs();
             const parts = (args.message ?? '').split(SHARD_DELIMITER);
             scope.shard = parts[shardIndex] ?? '';
             scope.result = '';
+            // The run the shard serves, handed on to the wrapped runner (`core/memberRun.ts`).
+            (0, memberRun_js_1.adoptParentRun)(scope, args, 'mapReduce shard');
         }, 'unpack')
             .addSubFlowChartNext('inner', innerChart, 'InnerCall', {
-            inputMapper: (parent) => ({ message: parent.shard ?? '' }),
+            inputMapper: (parent) => (0, memberRun_js_1.withParentRun)({ message: parent.shard ?? '' }, (0, memberRun_js_1.parentRunIn)(parent), inner),
             outputMapper: (sfOutput) => ({
                 result: typeof sfOutput === 'string' ? sfOutput : '',
             }),

package/dist/patterns/MapReduce.js.map

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

package/dist/tool-providers/index.js

@@ -49,7 +49,7 @@
  * symbols, one door. Import from the door.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENTCORE_SIGV4_SERVICE = exports.AGENTCORE_POLICY_SESSION_HEADER = exports.AGENTCORE_GATEWAY_SEARCH_TOOL = exports.hasGatewaySearch = exports.gatewaySearchTool = exports.agentCoreGatewayUrl = exports.agentCoreGatewayTransport = exports.retryingFetch = exports.MCP_TOOL_EXTRAS_KEY = exports.GatewayAuthorizationRequiredError = exports.gatewayTransport = exports.mockMcpClient = exports.mcpServe = exports.mcpClient = exports.SKILL_SCOPED_TOOLS_ID_PREFIX = exports.skillScopedToolsTarget = exports.skillScopedTools = exports.gatedTools = exports.staticTools = void 0;
+exports.AGENTCORE_RUNTIME_SESSION_HEADER = exports.agentCoreRuntimeUrl = exports.agentCoreRuntimeMcpTransport = exports.AGENTCORE_SIGV4_SERVICE = exports.AGENTCORE_POLICY_SESSION_HEADER = exports.AGENTCORE_GATEWAY_SEARCH_TOOL = exports.hasGatewaySearch = exports.gatewaySearchTool = exports.agentCoreGatewayUrl = exports.agentCoreGatewayTransport = exports.retryingFetch = exports.MCP_TOOL_EXTRAS_KEY = exports.GatewayAuthorizationRequiredError = exports.gatewayTransport = exports.mockMcpClient = exports.mcpServe = exports.mcpClient = exports.SKILL_SCOPED_TOOLS_ID_PREFIX = exports.skillScopedToolsTarget = exports.skillScopedTools = exports.gatedTools = exports.staticTools = void 0;
 var staticTools_js_1 = require("./staticTools.js");
 Object.defineProperty(exports, "staticTools", { enumerable: true, get: function () { return staticTools_js_1.staticTools; } });
 var gatedTools_js_1 = require("./gatedTools.js");
@@ -90,4 +90,13 @@ Object.defineProperty(exports, "hasGatewaySearch", { enumerable: true, get: func
 Object.defineProperty(exports, "AGENTCORE_GATEWAY_SEARCH_TOOL", { enumerable: true, get: function () { return agentcore_js_1.AGENTCORE_GATEWAY_SEARCH_TOOL; } });
 Object.defineProperty(exports, "AGENTCORE_POLICY_SESSION_HEADER", { enumerable: true, get: function () { return agentcore_js_1.AGENTCORE_POLICY_SESSION_HEADER; } });
 Object.defineProperty(exports, "AGENTCORE_SIGV4_SERVICE", { enumerable: true, get: function () { return agentcore_js_1.AGENTCORE_SIGV4_SERVICE; } });
+// An MCP server HOSTED ON AgentCore Runtime — an `http` transport whose fetch
+// carries the runtime's session, its session-busy retry and its auth (SigV4
+// through InvokeAgentRuntime, or a bearer token over HTTPS). `mcpClient` sees an
+// ordinary Streamable HTTP server.
+var transport_js_1 = require("../adapters/mcp/agentcoreRuntime/transport.js");
+Object.defineProperty(exports, "agentCoreRuntimeMcpTransport", { enumerable: true, get: function () { return transport_js_1.agentCoreRuntimeMcpTransport; } });
+Object.defineProperty(exports, "agentCoreRuntimeUrl", { enumerable: true, get: function () { return transport_js_1.agentCoreRuntimeUrl; } });
+var session_js_1 = require("../adapters/mcp/agentcoreRuntime/session.js");
+Object.defineProperty(exports, "AGENTCORE_RUNTIME_SESSION_HEADER", { enumerable: true, get: function () { return session_js_1.AGENTCORE_RUNTIME_SESSION_HEADER; } });
 //# sourceMappingURL=index.js.map

package/dist/tool-providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-providers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;;;AAEH,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,oEAMsC;AALpC,uHAAA,gBAAgB,OAAA;AAChB,kFAAkF;AAClF,kFAAkF;AAClF,6HAAA,sBAAsB,OAAA;AACtB,mIAAA,4BAA4B,OAAA;AAQ9B,uEAAuE;AACvE,wEAAwE;AACxE,0CAA0C;AAC1C,4CAeyB;AAdvB,qGAAA,SAAS,OAAA;AACT,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,4GAAA,gBAAgB,OAAA;AAChB,6HAAA,iCAAiC,OAAA;AACjC,2EAA2E;AAC3E,yEAAyE;AACzE,wDAAwD;AACxD,+GAAA,mBAAmB,OAAA;AACnB,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,iCAAiC;AACjC,yGAAA,aAAa,OAAA;AAEf,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAC9E,yCAAyC;AACzC,6DAQsC;AAPpC,yHAAA,yBAAyB,OAAA;AACzB,mHAAA,mBAAmB,OAAA;AACnB,iHAAA,iBAAiB,OAAA;AACjB,gHAAA,gBAAgB,OAAA;AAChB,6HAAA,6BAA6B,OAAA;AAC7B,+HAAA,+BAA+B,OAAA;AAC/B,uHAAA,uBAAuB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-providers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;;;AAEH,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,oEAMsC;AALpC,uHAAA,gBAAgB,OAAA;AAChB,kFAAkF;AAClF,kFAAkF;AAClF,6HAAA,sBAAsB,OAAA;AACtB,mIAAA,4BAA4B,OAAA;AAQ9B,uEAAuE;AACvE,wEAAwE;AACxE,0CAA0C;AAC1C,4CAeyB;AAdvB,qGAAA,SAAS,OAAA;AACT,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,4GAAA,gBAAgB,OAAA;AAChB,6HAAA,iCAAiC,OAAA;AACjC,2EAA2E;AAC3E,yEAAyE;AACzE,wDAAwD;AACxD,+GAAA,mBAAmB,OAAA;AACnB,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,iCAAiC;AACjC,yGAAA,aAAa,OAAA;AAEf,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAC9E,yCAAyC;AACzC,6DAQsC;AAPpC,yHAAA,yBAAyB,OAAA;AACzB,mHAAA,mBAAmB,OAAA;AACnB,iHAAA,iBAAiB,OAAA;AACjB,gHAAA,gBAAgB,OAAA;AAChB,6HAAA,6BAA6B,OAAA;AAC7B,+HAAA,+BAA+B,OAAA;AAC/B,uHAAA,uBAAuB,OAAA;AAMzB,8EAA8E;AAC9E,4EAA4E;AAC5E,iFAAiF;AACjF,mCAAmC;AACnC,8EAGuD;AAFrD,4HAAA,4BAA4B,OAAA;AAC5B,mHAAA,mBAAmB,OAAA;AAErB,0EAA+F;AAAtF,8HAAA,gCAAgC,OAAA"}

package/dist/trace-toolpack/selfExplain.js

@@ -195,6 +195,17 @@ class SelfExplainBinding {
             ...(innerRuns !== undefined && { innerRuns }),
         };
     }
+    /**
+     * Does the binding serve the run a tool call is in? Only the agent's OWN run
+     * — the one its instance is serving — reads its evidence. A call from the
+     * agent mounted as a composition member carries that composition's run id
+     * (`ctx.runId`), which is never the instance's: the instance's evidence is
+     * another caller's, so it is not served there.
+     */
+    servesRun(runId) {
+        const serving = this.serving();
+        return serving === undefined || (runId !== undefined && serving.runId === runId);
+    }
     /** The conversation (and run) in flight, or served last. */
     serving() {
         return this.source?.getServing?.();
@@ -304,7 +315,7 @@ function buildExplainRunTool(binding, delegate, toolpack) {
             additionalProperties: false,
         },
         execute: async ({ question }, ctx) => {
-            const artifacts = binding.artifacts;
+            const artifacts = binding.servesRun(ctx.runId) ? binding.artifacts : undefined;
             if (!artifacts)
                 return traceToolNames_js_1.NO_COMPLETED_RUN_MESSAGE;
             // Dynamic import: keeps Agent out of this module's static graph
@@ -380,6 +391,18 @@ function buildSelfExplainToolProvider(binding, options, existing) {
     };
 }
 exports.buildSelfExplainToolProvider = buildSelfExplainToolProvider;
+/**
+ * The trace tools, answering only inside the run the binding serves: a call
+ * from the agent mounted as a composition member (`ctx.runId` is the
+ * composition's run) is told there is no completed run, never handed the
+ * instance's evidence — another caller's conversation.
+ */
+function ownRunOnly(tools, binding) {
+    return tools.map((tool) => ({
+        ...tool,
+        execute: (args, ctx) => binding.servesRun(ctx?.runId) ? tool.execute(args, ctx) : traceToolNames_js_1.NO_COMPLETED_RUN_MESSAGE,
+    }));
+}
 /**
  * The inline-mode provider: `skillScopedTools` semantics, with the tool list
  * behind an `import()` that runs once, on the first ACTIVE iteration.
@@ -396,7 +419,7 @@ function lazilyMountedTraceTools(skillId, binding, toolpack) {
     const inactive = (0, skillScopedTools_js_1.skillScopedTools)(skillId, []);
     let mounted;
     const mount = () => {
-        mounted ??= Promise.resolve().then(() => __importStar(require('./lazyToolpack.js'))).then(({ lazyTraceToolpack }) => (0, skillScopedTools_js_1.skillScopedTools)(skillId, lazyTraceToolpack(() => binding.artifacts, toolpack)), (err) => {
+        mounted ??= Promise.resolve().then(() => __importStar(require('./lazyToolpack.js'))).then(({ lazyTraceToolpack }) => (0, skillScopedTools_js_1.skillScopedTools)(skillId, ownRunOnly(lazyTraceToolpack(() => binding.artifacts, toolpack), binding)), (err) => {
             mounted = undefined;
             throw err;
         });

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

@@ -1 +1 @@
-{"version":3,"file":"selfExplain.js","sourceRoot":"","sources":["../../src/trace-toolpack/selfExplain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"selfExplain.js","sourceRoot":"","sources":["../../src/trace-toolpack/selfExplain.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,6CAAuF;AACvF,6CAAuD;AAEvD,iFAA2E;AAE3E,gDAA0D;AAG1D,yDAAmE;AAEnE,sEAAgE;AAEhE,qDAAwE;AACxE,mEAA0F;AAC1F,gEAAoE;AA0DpE,+DAA+D;AAClD,QAAA,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,0BAA0B,GAAG,CAAC,CAAC;AASrC,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC;AACvD,CAAC;AAED,sEAAsE;AACtE,SAAS,KAAK,CAAC,IAAsC,EAAE,GAAW;IAChE,OAAO,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,yBAAyB,GAAG,EAAE,CAAC;AA6DrC;;;;;;GAMG;AACH,MAAa,kBAAkB;IAeV;IACA;IAfX,MAAM,CAAgC;IACtC,IAAI,GAAiB,IAAA,0BAAkB,GAAE,CAAC;IAC1C,IAAI,CAAwB;IACpC;;;;;;qCAMiC;IAChB,OAAO,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACnC,OAAO,GAAG,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAE7D,YACmB,UAA8B,EAAE,EAChC,YAAoB,+BAAuB;QAD3C,YAAO,GAAP,OAAO,CAAyB;QAChC,cAAS,GAAT,SAAS,CAAkC;IAC3D,CAAC;IAEJ,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC;IAC1C,CAAC;IAED,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAA+D;QACpE,IAAI,CAAC,MAAM,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9E,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAS,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAI,SAAS;QACX,4DAA4D;QAC5D,sEAAsE;QACtE,iBAAiB;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC;QACnD,MAAM,SAAS,GACb,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,KAAK,SAAS;gBACvC,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,IAAA,4CAAuB,EACrB,YAAY,EACZ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CACzD,CAAC;QACR,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACjC,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;YAClE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YACzD,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,KAAyB;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACnF,CAAC;IAED,4DAA4D;IACpD,OAAO;QACb,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,2CAA2C;IACnC,OAAO,CAAC,OAAuC;QACrD,OAAO,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACjE,CAAC;IAED,qFAAqF;IAC7E,SAAS,CAAC,OAA2B;QAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC3F,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,qFAAqF;IAC7E,IAAI,CAAC,OAAuC,EAAE,IAAkB;QACtE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACvC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;QAC1C,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,yEAAyE;IACzE,QAAQ;QACN,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;YAC5C,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,iEAAiE;YACjE,iEAAiE;YACjE,2DAA2D;YAC3D,MAAM,SAAS,GACb,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,MAAM,EAAE,YAAY;gBAC9C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;gBACvD,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC;YAC5C,sEAAsE;YACtE,kDAAkD;YAClD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE;gBACxB,QAAQ;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC7C,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;aACxC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,OAAO;YACL,EAAE,EAAE,sBAAsB;YAC1B,kEAAkE;YAClE,0DAA0D;YAC1D,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,GAAG,EAAE;gBACf,+DAA+D;gBAC/D,8DAA8D;gBAC9D,0DAA0D;gBAC1D,+DAA+D;gBAC/D,mEAAmE;gBACnE,eAAe;gBACf,IAAI,CAAC,IAAI,GAAG,IAAA,0BAAkB,GAAE,CAAC;gBACjC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;oBAAE,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAS,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC/E,mEAAmE;gBACnE,kEAAkE;gBAClE,wDAAwD;gBACxD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,OAAO,KAAK,SAAS;oBAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrD,CAAC;YACD,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,OAAO;YACpB,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAC1C,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAC1C,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;YACpD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACb,4DAA4D;gBAC5D,2DAA2D;gBAC3D,IAAI,IAAA,yBAAW,EAAC,CAAC,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAA2C,CAAC,CAAC;YACrF,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAzKD,gDAyKC;AAED;;;;;;GAMG;AACH,SAAS,OAAO,CACd,MAAyB,EACzB,YAAgC;IAEhC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,8EAA8E;AAC9E,SAAS,mBAAmB,CAC1B,OAA2B,EAC3B,QAAqD,EACrD,QAA+B;IAE/B,OAAO,IAAA,qBAAU,EAA+B;QAC9C,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,uFAAuF;YACvF,yFAAyF;YACzF,iDAAiD;QACnD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;aAC9E;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;YACtB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE;YACnC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/E,IAAI,CAAC,SAAS;gBAAE,OAAO,4CAAwB,CAAC;YAChD,gEAAgE;YAChE,gEAAgE;YAChE,MAAM,EAAE,eAAe,EAAE,GAAG,wDAAa,sBAAsB,GAAC,CAAC;YACjE,MAAM,aAAa,GAAG,eAAe,CAAC;gBACpC,SAAS;gBACT,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,QAAQ;aACT,CAAC,CAAC;YACH,oEAAoE;YACpE,sEAAsE;YACtE,sEAAsE;YACtE,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,GAAG,CACjC,EAAE,OAAO,EAAE,QAAQ,EAAE,EACrB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAC9D,CAAC;YACF,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS,IAAI,GAAG;gBAChE,CAAC,CAAC,MAAM,CAAE,GAA4B,CAAC,OAAO,CAAC;gBAC/C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AACjE,QAAA,qBAAqB,GAAG,cAAc,CAAC;AAEpD;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,OAA2B;IAC/D,OAAO,IAAA,4BAAW,EAAC;QACjB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,6BAAqB;QACvC,WAAW,EAAE,kCAAiB;QAC9B,IAAI,EAAE,kCAAiB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpF,CAAC,CAAC;AACL,CAAC;AAND,sDAMC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,4BAA4B,CAC1C,OAA2B,EAC3B,OAA2B,EAC3B,QAAuB;IAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,6BAAqB,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ;QAC7B,CAAC,CAAC,IAAA,sCAAgB,EAAC,OAAO,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/F,CAAC,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC7B,OAAO;QACL,EAAE,EAAE,GAAG,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,EAAE;QACjC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;KAClF,CAAC;AACJ,CAAC;AAdD,oEAcC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,KAAsB,EAAE,OAA2B;IACrE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,GAAG,IAAI;QACP,OAAO,EAAE,CAAC,IAAW,EAAE,GAAmC,EAAE,EAAE,CAC5D,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,4CAAwB;KACrF,CAAC,CAAoB,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,uBAAuB,CAC9B,OAAe,EACf,OAA2B,EAC3B,QAA0C;IAE1C,MAAM,QAAQ,GAAG,IAAA,sCAAgB,EAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,OAA0C,CAAC;IAC/C,MAAM,KAAK,GAAG,GAA0B,EAAE;QACxC,OAAO,KAAK,kDAAO,mBAAmB,IAAE,IAAI,CAC1C,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,CACxB,IAAA,sCAAgB,EACd,OAAO,EACP,UAAU,CACR,iBAAiB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,EACpD,OAAO,CACR,CACF,EACH,CAAC,GAAY,EAAE,EAAE;YACf,OAAO,GAAG,SAAS,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC,CACF,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IACF,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,CAAC,GAAG;YACN,IAAI,GAAG,CAAC,aAAa,KAAK,OAAO;gBAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types/adapters/mcp/agentcoreRuntime/errorType.d.ts

@@ -0,0 +1,13 @@
+/**
+ * errorType — the error type an AWS REST answer names in its
+ * `x-amzn-errortype` header, trimmed to the bare name.
+ *
+ * The header may carry a `:` suffix (a URL) or a `namespace#` prefix; both are
+ * removed, so `aws.protocols#AccessDeniedException:http://…` reads
+ * `AccessDeniedException` — the name the SDK gives the same exception.
+ *
+ * Pattern: pure helper. Role: outer ring, vendor fact.
+ */
+/** The bare error type, or `undefined` when the answer names none. */
+export declare function awsErrorType(headers: Headers): string | undefined;
+//# sourceMappingURL=errorType.d.ts.map

package/dist/types/adapters/mcp/agentcoreRuntime/errorType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorType.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mcp/agentcoreRuntime/errorType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMjE"}

package/dist/types/adapters/mcp/agentcoreRuntime/invoke.d.ts

@@ -0,0 +1,117 @@
+/**
+ * invoke — the SigV4 auth strategy: Streamable HTTP, carried by the AWS SDK's
+ * `InvokeAgentRuntime`.
+ *
+ * The MCP client speaks HTTP — a POST, a few headers, a JSON body — and the SDK
+ * operation carries exactly that, field for field. This file is the mapping and
+ * nothing else. Every name in it is the SDK's own (`InvokeAgentRuntimeRequest`
+ * / `InvokeAgentRuntimeResponse` in `@aws-sdk/client-bedrock-agentcore`), read
+ * off an installed package rather than recalled:
+ *
+ *   request                                       InvokeAgentRuntimeRequest
+ *   ─────────────────────────────────────────────  ────────────────────────
+ *   body                                          payload (bytes)
+ *   content-type                                  contentType
+ *   accept                                        accept
+ *   mcp-session-id                                mcpSessionId
+ *   mcp-protocol-version                          mcpProtocolVersion
+ *   x-amzn-bedrock-agentcore-runtime-session-id   runtimeSessionId
+ *   (the runtime, from options)                   agentRuntimeArn, qualifier, accountId
+ *
+ *   InvokeAgentRuntimeResponse                    response
+ *   ─────────────────────────────────────────────  ────────────────────────
+ *   statusCode                                    status
+ *   contentType                                   content-type
+ *   mcpSessionId                                  mcp-session-id
+ *   mcpProtocolVersion                            mcp-protocol-version
+ *   runtimeSessionId                              x-amzn-bedrock-agentcore-runtime-session-id
+ *   response (a stream)                           body
+ *
+ * The signature is the SDK's: `send` signs every attempt with the client's own
+ * credentials, so no credential passes through this file.
+ *
+ * ── The SDK's own retry is OFF ───────────────────────────────────────────────
+ * The client built here has `maxAttempts: 1`. The SDK's standard policy would
+ * re-send a `tools/call` after a 5xx or a dropped connection — a call that may
+ * already have run, in the same pinned session — which is the one thing a retry
+ * here must never do. Every retry goes through the transport's single loop
+ * instead, which repeats only refusals the service made before running
+ * anything. A `client` you pass keeps ITS policy: build it with
+ * `maxAttempts: 1` for the same guarantee.
+ *
+ * ── A service exception is an ANSWER ─────────────────────────────────────────
+ * When the service answers with a non-2xx status, the SDK throws instead of
+ * returning — `RetryableConflictException` (409), `ThrottlingException` (429),
+ * or a hosted server's own 404 as `Unknown`. Each is handed on as the `Response`
+ * an HTTPS caller would have read: its status, its error type in
+ * `x-amzn-errortype`, `retry-after` when the service sent one, and as the body
+ * the server's own JSON-RPC error when it sent one (the SDK spreads a body it
+ * cannot model onto the exception) — never the exception's message, which can
+ * quote the signed request. What the MCP client may read of it is decided
+ * once, by `safeAnswer.ts`. So the transport's retry decision sees the 409,
+ * `mcpClient`'s 429 retry sees the 429, and the MCP client reports the
+ * status. A failure with no status — the
+ * network, an abort — never reached the service as an answer, and is thrown as
+ * it is.
+ *
+ * ── What the operation cannot carry ──────────────────────────────────────────
+ * Any method but POST. A GET (the optional server-message stream) and a DELETE
+ * (ending a session) are answered HERE with 405, which the MCP Streamable HTTP
+ * spec defines as "not offered" for both, so the MCP client carries on. And any
+ * header the operation does not model — it has no field to put one in.
+ *
+ * Pattern: Adapter (fetch ↔ command). Role: outer ring, lazy AWS peer dep.
+ */
+import type { ThrottleFetch } from '../../../mcp/throttleRetry.js';
+/** A command-based SDK client — `send` is the only member this strategy uses. */
+export interface AgentCoreRuntimeSdkClient {
+    send(command: unknown, options?: {
+        abortSignal?: AbortSignal;
+    }): Promise<unknown>;
+}
+/** The slice of `@aws-sdk/client-bedrock-agentcore` this strategy touches. */
+export interface BedrockAgentCoreRuntimeSdkModule {
+    readonly BedrockAgentCoreClient?: new (config: {
+        region?: string;
+        maxAttempts?: number;
+    }) => AgentCoreRuntimeSdkClient;
+    readonly InvokeAgentRuntimeCommand?: new (input: unknown) => unknown;
+}
+/** Which runtime every request goes to, as the operation names it. */
+export interface InvokeTarget {
+    readonly agentRuntimeArn: string;
+    readonly qualifier?: string;
+    readonly accountId?: string;
+}
+/** What the strategy is built from: a region, and optionally what was injected. */
+export interface InvokeSdkOptions {
+    readonly region: string;
+    /**
+     * A client the caller built — its credentials, region and retry settings win,
+     * so build it with `maxAttempts: 1` (see the module note).
+     */
+    readonly client?: AgentCoreRuntimeSdkClient;
+    /** The SDK module itself, for tests; otherwise the peer dep is loaded. */
+    readonly sdk?: BedrockAgentCoreRuntimeSdkModule;
+}
+/**
+ * The client and the command constructor this strategy sends with.
+ *
+ * Loaded when the transport is BUILT, not at the first call, so a missing peer
+ * dependency is refused where the transport is declared rather than mid-run.
+ *
+ * @throws when the SDK cannot be loaded, or when it lacks what is needed.
+ */
+export declare function invokeSdk(options: InvokeSdkOptions): {
+    readonly client: AgentCoreRuntimeSdkClient;
+    readonly InvokeAgentRuntimeCommand: new (input: unknown) => unknown;
+};
+/**
+ * A `fetch` that sends each request as one `InvokeAgentRuntimeCommand`.
+ *
+ * The URL the MCP client passes is ignored on purpose: it names the endpoint for
+ * reports and errors, while the invocation goes to `target` — the SDK resolves
+ * the endpoint itself, from the client's region.
+ */
+export declare function invokeFetch(target: InvokeTarget, client: AgentCoreRuntimeSdkClient, InvokeAgentRuntimeCommand: new (input: unknown) => unknown): ThrottleFetch;
+//# sourceMappingURL=invoke.d.ts.map