agentfootprint 10.3.1 → 10.4.0

package/dist/esm/memory/store/InMemoryStore.js

@@ -1,5 +1,6 @@
 import { identityNamespace } from '../identity/index.js';
 import { cosineSimilarity } from '../embedding/cosine.js';
+import { NO_SERVER_EXTRACTION, refuseUnhonouredWriteOptions, } from './writeOptions.js';
 const DEFAULT_LIST_LIMIT = 100;
 const MAX_LIST_LIMIT = 1000;
 export class InMemoryStore {
@@ -53,7 +54,12 @@ export class InMemoryStore {
         slot.entries.set(id, bumped);
         return bumped;
     }
-    async put(identity, entry) {
+    /**
+     * Write options: none honoured — a `Map` derives nothing from what it holds,
+     * so `extraction` and `namespaceScope` are refused by name, never ignored.
+     */
+    async put(identity, entry, options) {
+        refuseUnhonouredWriteOptions('InMemoryStore', undefined, options, NO_SERVER_EXTRACTION);
         const slot = this.slot(identity);
         slot.entries.set(entry.id, entry);
     }
@@ -62,15 +68,18 @@ export class InMemoryStore {
      * same Map. Saves N-1 slot lookups vs. calling `put()` in a loop, and
      * gives network-backed adapters a place to pipeline round-trips.
      */
-    async putMany(identity, entries) {
+    async putMany(identity, entries, options) {
+        // The port's empty-batch law first: an empty batch is a no-op, never a rejection.
         if (entries.length === 0)
             return;
+        refuseUnhonouredWriteOptions('InMemoryStore', undefined, options, NO_SERVER_EXTRACTION);
         const slot = this.slot(identity);
         for (const entry of entries) {
             slot.entries.set(entry.id, entry);
         }
     }
-    async putIfVersion(identity, entry, expectedVersion) {
+    async putIfVersion(identity, entry, expectedVersion, options) {
+        refuseUnhonouredWriteOptions('InMemoryStore', undefined, options, NO_SERVER_EXTRACTION);
         const slot = this.slot(identity);
         const existing = slot.entries.get(entry.id);
         // First-write path: expectedVersion === 0 means "I expect no prior entry".

package/dist/esm/memory/store/InMemoryStore.js.map

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

package/dist/esm/memory/store/index.d.ts

@@ -1,4 +1,5 @@
 export type { MemoryStore, ListOptions, ListResult, MemoryCursor, PutIfVersionResult, SearchOptions, ScoredEntry, } from './types.js';
 export { InMemoryStore } from './InMemoryStore.js';
 export { assertServesVectors, resolveRankingMode } from './capability.js';
+export { MEMORY_WRITE_OPTION_NAMES, NO_SERVER_EXTRACTION, UnsupportedMemoryWriteOptionError, refuseUnhonouredWriteOptions, requestedWriteOptions, type MemoryWriteOptionName, type MemoryNamespaceScope, type MemoryWriteOptions, type MemoryWriteOptionsConfig, } from './writeOptions.js';
 export { staticVectorStore, assertCorpusBundle, bundleEntryToMemoryEntry, CORPUS_BUNDLE_FORMAT, type CorpusBundle, type CorpusBundleEntry, type EmbedderFingerprint, } from './staticVectorStore.js';

package/dist/esm/memory/store/index.js

@@ -3,5 +3,10 @@ export { InMemoryStore } from './InMemoryStore.js';
 // an adapter author can check their own two declarations agree without waiting
 // for a corpus builder to tell them.
 export { assertServesVectors, resolveRankingMode } from './capability.js';
+// Write options — what a write asks a managed service to do after storing it,
+// in names no vendor owns. A store DECLARES what it honours and refuses the rest
+// by name; `refuseUnhonouredWriteOptions` is exported so a third-party store
+// refuses in the same words.
+export { MEMORY_WRITE_OPTION_NAMES, NO_SERVER_EXTRACTION, UnsupportedMemoryWriteOptionError, refuseUnhonouredWriteOptions, requestedWriteOptions, } from './writeOptions.js';
 export { staticVectorStore, assertCorpusBundle, bundleEntryToMemoryEntry, CORPUS_BUNDLE_FORMAT, } from './staticVectorStore.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/memory/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/store/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,+EAA+E;AAC/E,+EAA+E;AAC/E,qCAAqC;AACrC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,GAIrB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/store/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,+EAA+E;AAC/E,+EAA+E;AAC/E,qCAAqC;AACrC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,8EAA8E;AAC9E,iFAAiF;AACjF,6EAA6E;AAC7E,6BAA6B;AAC7B,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,iCAAiC,EACjC,4BAA4B,EAC5B,qBAAqB,GAKtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,GAIrB,MAAM,wBAAwB,CAAC"}

package/dist/esm/memory/store/types.d.ts

@@ -35,6 +35,7 @@
  */
 import type { MemoryIdentity } from '../identity/index.js';
 import type { MemoryEntry } from '../entry/index.js';
+import type { MemoryWriteOptionName, MemoryWriteOptions } from './writeOptions.js';
 /** Pagination cursor — opaque string, adapter-specific encoding. */
 export type MemoryCursor = string;
 /** Options for listing entries in a namespace. */
@@ -100,6 +101,19 @@ export interface SearchOptions {
      * whenever you have both, and any store can serve the query.
      */
     readonly text?: string;
+    /**
+     * The namespace scope this memory's WRITES are filed under
+     * (`MemoryWriteOptions.namespaceScope`), so the read stays inside it.
+     *
+     * A write option must never let a later read see another tenant's records,
+     * so reads follow the same rule as writes: `defineMemory({ writeOptions })`
+     * resolves this from the run's identity with the SAME resolver as its
+     * writes, and passes it only to a store that declares `'namespaceScope'` in
+     * `writeOptions`. A store that receives it reads only within it, or refuses
+     * by name. Stores that file nothing by a namespace never receive it — the
+     * identity is their boundary.
+     */
+    readonly namespaceScope?: Readonly<Record<string, string>>;
 }
 /**
  * A `MemoryEntry` annotated with its similarity score. Returned by
@@ -184,6 +198,19 @@ export interface MemoryStore {
      * `retrieval` are refused under.
      */
     readonly ranksBy?: 'vector' | 'server-text';
+    /**
+     * Which {@link MemoryWriteOptions} this store HONOURS — vendor-neutral
+     * requests about what a managed service does with a write after storing it
+     * (`'extraction'`: keep it out of long-term extraction; `'namespaceScope'`:
+     * the namespace its derived records are filed under).
+     *
+     * **Absent means none**, and every write option a store does not list is
+     * refused BY NAME at the call (`refuseUnhonouredWriteOptions`), never
+     * ignored: a dropped `namespaceScope` files one tenant's derived records
+     * where another's are read, and it looks exactly like working. `defineMemory`
+     * reads this before any turn runs.
+     */
+    readonly writeOptions?: readonly MemoryWriteOptionName[];
     /**
      * Fetch one entry by id within the given identity's namespace.
      * Returns `null` when the entry doesn't exist OR has expired (TTL).
@@ -196,8 +223,12 @@ export interface MemoryStore {
     /**
      * Unconditional write — overwrites any existing entry with the same id.
      * Prefer `putIfVersion` in multi-writer scenarios.
+     *
+     * `options` asks a managed service what to do with the entry after storing
+     * it; an option the store does not declare in {@link writeOptions} is
+     * refused by name, before anything is written.
      */
-    put<T = unknown>(identity: MemoryIdentity, entry: MemoryEntry<T>): Promise<void>;
+    put<T = unknown>(identity: MemoryIdentity, entry: MemoryEntry<T>, options?: MemoryWriteOptions): Promise<void>;
     /**
      * Batched unconditional write. Semantically equivalent to N sequential
      * `put()` calls but gives adapters a chance to batch the round-trip.
@@ -223,17 +254,20 @@ export interface MemoryStore {
      * Default implementation for adapters that don't override: sequentially
      * calls `put()` for each entry. Adapters SHOULD override for
      * performance-critical paths.
+     *
+     * `options` applies to every entry of the batch, under the same rule as
+     * `put` — refused by name, before anything is written, when not declared.
      */
-    putMany<T = unknown>(identity: MemoryIdentity, entries: readonly MemoryEntry<T>[]): Promise<void>;
+    putMany<T = unknown>(identity: MemoryIdentity, entries: readonly MemoryEntry<T>[], options?: MemoryWriteOptions): Promise<void>;
     /**
      * Optimistic-concurrency write. Writes only if the stored version equals
      * `expectedVersion`, OR if no entry exists at all AND `expectedVersion`
      * is `0` (first-write sentinel).
      *
      * Returns `{ applied: true }` on success, `{ applied: false, currentVersion }`
-     * when the caller's assumed version is stale.
+     * when the caller's assumed version is stale. `options` as for `put`.
      */
-    putIfVersion<T = unknown>(identity: MemoryIdentity, entry: MemoryEntry<T>, expectedVersion: number): Promise<PutIfVersionResult>;
+    putIfVersion<T = unknown>(identity: MemoryIdentity, entry: MemoryEntry<T>, expectedVersion: number, options?: MemoryWriteOptions): Promise<PutIfVersionResult>;
     /**
      * Page through entries in the identity's namespace. Ordered by adapter's
      * choice (usually most-recently-updated first) — consumers that care

package/dist/esm/memory/store/writeOptions.d.ts

@@ -0,0 +1,118 @@
+import type { MemoryIdentity } from '../identity/index.js';
+import type { MemoryStore } from './types.js';
+/** What one write asks of the store, beyond keeping the entry. */
+export interface MemoryWriteOptions {
+    /**
+     * `'skip'` — store the entry, but keep it out of long-term extraction: the
+     * service must derive nothing (no fact, summary or preference) from it. It
+     * stays readable where it was written (`get`, `list`).
+     */
+    readonly extraction?: 'skip';
+    /**
+     * The values a store substitutes into the namespaces its DERIVED long-term
+     * records are filed under — one tenant's scope, typically
+     * `{ tenantid: 'acme' }`. Which keys exist is the store's configuration.
+     *
+     * Keep the mapping from your tenant to these values ONE-TO-ONE: a mapping
+     * that lowercases, trims or truncates a tenant id files two tenants' derived
+     * records under one namespace. An empty object asks for nothing.
+     */
+    readonly namespaceScope?: Readonly<Record<string, string>>;
+}
+/** The name of one write option — what a store declares it honours. */
+export type MemoryWriteOptionName = keyof MemoryWriteOptions;
+/** Every write option, in the order refusals name them. */
+export declare const MEMORY_WRITE_OPTION_NAMES: readonly MemoryWriteOptionName[];
+/**
+ * The reason a store with NO server-side extraction gives — the shared
+ * sentence, so every such store refuses in the same words, remedy included.
+ */
+export declare const NO_SERVER_EXTRACTION: string;
+/**
+ * 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.
+ */
+export declare class UnsupportedMemoryWriteOptionError extends Error {
+    readonly code: "ERR_UNSUPPORTED_MEMORY_WRITE_OPTION";
+    /** The store that refused, e.g. `'InMemoryStore'`. */
+    readonly store: string;
+    /** The option it cannot honour. */
+    readonly option: MemoryWriteOptionName;
+    constructor(store: string, option: MemoryWriteOptionName, why: string);
+}
+/**
+ * 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.
+ */
+export declare function requestedWriteOptions(options?: MemoryWriteOptions): MemoryWriteOptionName[];
+/**
+ * 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
+ */
+export declare function refuseUnhonouredWriteOptions(store: string, honoured: readonly MemoryWriteOptionName[] | undefined, options: MemoryWriteOptions | undefined, why: string): void;
+/** Write options for every write a memory makes (`defineMemory({ writeOptions })`). */
+export interface MemoryWriteOptionsConfig {
+    /** `'skip'` keeps every write of this memory out of long-term extraction. */
+    readonly extraction?: 'skip';
+}
+/**
+ * A memory's namespace scope (`defineMemory({ namespaceScope })`): the scope
+ * its writes are filed under AND its reads are confined to.
+ *
+ * One computed from the run's identity — `(identity) => ({ tenantid: … })`,
+ * the multi-tenant shape — or a fixed object, which is right only for a
+ * deployment that serves ONE tenant. Keep the function one-to-one (see
+ * {@link MemoryWriteOptions.namespaceScope}); a store may ship an encoder into
+ * its own alphabet (`agentCoreNamespaceValue` for AgentCore). A scope that
+ * comes back empty or malformed refuses the write or the search, never runs it
+ * without one.
+ */
+export type MemoryNamespaceScope = Readonly<Record<string, string>> | ((identity: MemoryIdentity) => Readonly<Record<string, string>>);
+/** What `defineMemory` binds to its store: the write options and the scope. */
+export interface BoundMemoryOptions extends MemoryWriteOptionsConfig {
+    readonly namespaceScope?: MemoryNamespaceScope;
+}
+/**
+ * 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
+ */
+export declare function assertStoreHonours(store: MemoryStore, config: BoundMemoryOptions, caller: string): void;
+/**
+ * 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.
+ */
+export declare function bindWriteOptions(store: MemoryStore, config: BoundMemoryOptions): MemoryStore;

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

@@ -0,0 +1,242 @@
+/** Every write option, in the order refusals name them. */
+export const 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.
+ */
+export const 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.
+ */
+export 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;
+    }
+}
+/**
+ * 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.
+ */
+export 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;
+}
+/**
+ * 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
+ */
+export function refuseUnhonouredWriteOptions(store, honoured, options, why) {
+    for (const option of requestedWriteOptions(options)) {
+        if (!(honoured ?? []).includes(option)) {
+            throw new UnsupportedMemoryWriteOptionError(store, option, why);
+        }
+    }
+}
+/**
+ * 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
+ */
+export 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');
+        }
+    }
+}
+/**
+ * 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.
+ */
+export 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;
+}
+// ── 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/esm/memory/store/writeOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeOptions.js","sourceRoot":"","sources":["../../../../src/memory/store/writeOptions.ts"],"names":[],"mappings":"AAgEA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,yBAAyB,GAAqC;IACzE,YAAY;IACZ,gBAAgB;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,iFAAiF;IACjF,+EAA+E;IAC/E,kFAAkF;IAClF,gDAAgD,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IACjD,IAAI,GAAG,qCAA8C,CAAC;IAC/D,sDAAsD;IAC7C,KAAK,CAAS;IACvB,mCAAmC;IAC1B,MAAM,CAAwB;IAEvC,YAAY,KAAa,EAAE,MAA6B,EAAE,GAAW;QACnE,KAAK,CACH,YAAY,KAAK,qCAAqC,MAAM,OAAO,GAAG,UAAU;YAC9E,oFAAoF;YACpF,mBAAmB,CACtB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACzD,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACzC,gBAAgB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAa,EACb,QAAsD,EACtD,OAAuC,EACvC,GAAW;IAEX,KAAK,MAAM,MAAM,IAAI,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,iCAAiC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC;AA+BD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAkB,EAClB,MAA0B,EAC1B,MAAc;IAEd,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YAChD,gBAAgB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YACxC,mBAAmB,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,iCAAiC,CACzC,SAAS,CAAC,KAAK,CAAC,EAChB,MAAM,EACN,yBAAyB,MAAM,sCAAsC,MAAM,WAAW;gBACpF,qFAAqF,CACxF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAkB,EAAE,MAA0B;IAC7E,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC;IACzD,MAAM,cAAc,GAAG,CAAC,GAAiD,EAAQ,EAAE;QACjF,IAAI,YAAY,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,SAAS,CACjB,qFAAqF;gBACnF,yCAAyC;gBACzC,qFAAqF;gBACrF,eAAe,CAClB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,QAAwB,EAAE,GAAwB,EAAsB,EAAE;QACzF,cAAc,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,EAAE,cAAc,CAAC;QACrC,OAAO;YACL,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;YACzE,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;YACrD,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;YACpE,4EAA4E;YAC5E,GAAG,CAAC,QAAQ,KAAK,SAAS;gBACxB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC,CAAC;IACF,0EAA0E;IAC1E,kDAAkD;IAClD,MAAM,YAAY,GAAG,YAAY,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC3F,MAAM,WAAW,GAAG,CAClB,QAAwB,EACxB,OAAuB,EACI,EAAE;QAC7B,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,YAAY;YAAE,OAAO,OAAO,CAAC;QAClC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC/E,CAAC,CAAC;IACF,MAAM,KAAK,GAAgB;QACzB,GAAG,CAAC,KAAK,CAAC,oBAAoB,KAAK,SAAS,IAAI;YAC9C,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;SACjD,CAAC;QACF,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9D,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;QAC7E,GAAG,EAAE,CAAI,QAAwB,EAAE,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAI,QAAQ,EAAE,EAAE,CAAC;QAC5E,4EAA4E;QAC5E,6DAA6D;QAC7D,GAAG,EAAE,KAAK,EAAK,QAAwB,EAAE,KAAqB,EAAE,GAAwB,EAAE,EAAE,CAC1F,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACpD,OAAO,EAAE,KAAK,EACZ,QAAwB,EACxB,OAAkC,EAClC,GAAwB,EACxB,EAAE;QACF,yEAAyE;QACzE,OAAO,CAAC,MAAM,KAAK,CAAC;YAClB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;YAClC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC9D,YAAY,EAAE,KAAK,EACjB,QAAwB,EACxB,KAAqB,EACrB,eAAuB,EACvB,GAAwB,EACxB,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjF,IAAI,EAAE,CAAI,QAAwB,EAAE,OAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAI,QAAQ,EAAE,OAAO,CAAC;QAC9F,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpD,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC9D,eAAe,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC;QACpF,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC;QAChF,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC9D,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5C,0EAA0E;QAC1E,mEAAmE;QACnE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI;YAChC,MAAM,EAAE,KAAK,EACX,QAAwB,EACxB,KAAwB,EACxB,OAAuB,EACa,EAAE,CACrC,KAA+C,CAAC,MAAM,CACrD,QAAQ,EACR,KAAK,EACL,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAC/B;SACJ,CAAC;KACH,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0EAA0E;AAE1E,sFAAsF;AACtF,SAAS,UAAU,CACjB,MAA0B,EAC1B,QAAwB,EACxB,IAAI,GAAG,YAAY;IAEnB,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,KAAK,GACT,OAAO,MAAM,CAAC,cAAc,KAAK,UAAU;QACzC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAC5B,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxB,2EAA2E;IAC3E,4EAA4E;IAC5E,8EAA8E;IAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACzC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACvB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CACjB,uEAAuE;YACrE,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CACjB,qFAAqF;YACnF,iFAAiF,CACpF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAuC,EAAE,KAAa;IACjF,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,SAAS,CACjB,gEAAgE,KAAK,kBAAkB;YACrF,uFAAuF;YACvF,wFAAwF;YACxF,4DAA4D,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,SAAS,SAAS,CAAC,KAAkB;IACnC,MAAM,IAAI,GAAI,KAA6C,CAAC,WAAW,EAAE,IAAI,CAAC;IAC9E,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC;AAChG,CAAC;AAED,sFAAsF;AACtF,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAY,CAAC;IACtD,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/D,0EAA0E;IAC1E,iBAAiB;IACjB,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACjE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CACnD,CAAC;AACJ,CAAC"}

package/dist/esm/memory-providers.d.ts

@@ -21,7 +21,7 @@
  * symbols, one door. Import from the door.
  */
 export { RedisStore, type RedisStoreOptions, type RedisLikeClient, type RedisLikePipeline, } from './adapters/memory/redis.js';
-export { AgentCoreStore, UnreadableMemoryEntryError, type AgentCoreStoreOptions, type AgentCoreLikeClient, type AgentCoreEvent, type AgentCoreMemoryRecord, } from './adapters/memory/agentcore.js';
+export { AgentCoreStore, UnreadableMemoryEntryError, agentCoreNamespaceValue, type AgentCoreStoreOptions, type AgentCoreLikeClient, type AgentCoreEvent, type AgentCoreMemoryRecord, } from './adapters/memory/agentcore.js';
 export { memoryBankStore, MemoryBankStore, MAX_PAGE_SIZE, MAX_CARRIED_JSON, scoreFromDistance, type MemoryBankStoreOptions, type MemoryScope, } from './adapters/memory/memoryBank.js';
 export { sqliteVectorStore, UnreadableIndexFileError, type SqliteVectorStore, type SqliteVectorStoreOptions, type SqliteVectorDatabaseLike, type SqliteVectorStatementLike, type SqliteVectorModuleLike, } from './adapters/memory/sqliteVector.js';
 export { SqliteUnavailableError } from './lib/sqliteUnavailable.js';

package/dist/esm/memory-providers.js

@@ -24,7 +24,10 @@
 // `require()` to constructor time; importing this barrel doesn't load
 // `ioredis` or `@aws-sdk/client-bedrock-agent-runtime`.
 export { RedisStore, } from './adapters/memory/redis.js';
-export { AgentCoreStore, UnreadableMemoryEntryError, } from './adapters/memory/agentcore.js';
+export { AgentCoreStore, UnreadableMemoryEntryError, 
+// A tenant id in the alphabet AgentCore admits for a namespace variable,
+// one-to-one — what `defineMemory({ namespaceScope })` and `searchNamespace` map with.
+agentCoreNamespaceValue, } from './adapters/memory/agentcore.js';
 // 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/esm/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,OAAO,EACL,UAAU,GAIX,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,0BAA0B,GAK3B,MAAM,gCAAgC,CAAC;AAExC,0EAA0E;AAC1E,gFAAgF;AAChF,0EAA0E;AAC1E,yEAAyE;AACzE,gFAAgF;AAChF,wEAAwE;AACxE,+EAA+E;AAC/E,4DAA4D;AAC5D,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAGlB,MAAM,iCAAiC,CAAC;AAEzC,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,mDAAmD;AACnD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GAMzB,MAAM,mCAAmC,CAAC;AAE3C,6EAA6E;AAC7E,8EAA8E;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,sDAAsD;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,gFAAgF;AAChF,+EAA+E;AAC/E,+DAA+D;AAC/D,OAAO,EACL,aAAa,EACb,mBAAmB,GAOpB,MAAM,+BAA+B,CAAC;AAEvC,gFAAgF;AAChF,gEAAgE;AAChE,iDAAiD;AACjD,OAAO,EACL,cAAc,GAKf,MAAM,gCAAgC,CAAC;AAExC,8EAA8E;AAC9E,yEAAyE;AACzE,OAAO,EACL,kBAAkB,GAInB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../../src/memory-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,OAAO,EACL,UAAU,GAIX,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,0BAA0B;AAC1B,yEAAyE;AACzE,uFAAuF;AACvF,uBAAuB,GAKxB,MAAM,gCAAgC,CAAC;AAExC,0EAA0E;AAC1E,gFAAgF;AAChF,0EAA0E;AAC1E,yEAAyE;AACzE,gFAAgF;AAChF,wEAAwE;AACxE,+EAA+E;AAC/E,4DAA4D;AAC5D,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAGlB,MAAM,iCAAiC,CAAC;AAEzC,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,mDAAmD;AACnD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GAMzB,MAAM,mCAAmC,CAAC;AAE3C,6EAA6E;AAC7E,8EAA8E;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,sDAAsD;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,gFAAgF;AAChF,+EAA+E;AAC/E,+DAA+D;AAC/D,OAAO,EACL,aAAa,EACb,mBAAmB,GAOpB,MAAM,+BAA+B,CAAC;AAEvC,gFAAgF;AAChF,gEAAgE;AAChE,iDAAiD;AACjD,OAAO,EACL,cAAc,GAKf,MAAM,gCAAgC,CAAC;AAExC,8EAA8E;AAC9E,yEAAyE;AACzE,OAAO,EACL,kBAAkB,GAInB,MAAM,yCAAyC,CAAC"}

package/dist/esm/patterns/MapReduce.js

@@ -23,6 +23,7 @@ import { RunnerBase } from '../core/RunnerBase.js';
 import { Parallel } from '../core-flow/Parallel.js';
 import { Sequence } from '../core-flow/Sequence.js';
 import { adoptMemberRedaction, redactionDeclaredBy } from '../redaction/declared.js';
+import { adoptParentRun, parentRunIn, readsParentRun, withParentRun } from '../core/memberRun.js';
 const SHARD_DELIMITER = '\u001F'; // ASCII Unit Separator — unlikely in real text.
 /**
  * Build a MapReduce Runner. At run time:
@@ -130,21 +131,26 @@ class ShardBranchRunner extends 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`).
         adoptMemberRedaction(this, [inner]);
+        // It hands the run it serves on to the wrapped runner (`core/memberRun.ts`).
+        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 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`).
+            adoptParentRun(scope, args, 'mapReduce shard');
         }, 'unpack')
             .addSubFlowChartNext('inner', innerChart, 'InnerCall', {
-            inputMapper: (parent) => ({ message: parent.shard ?? '' }),
+            inputMapper: (parent) => withParentRun({ message: parent.shard ?? '' }, parentRunIn(parent), inner),
             outputMapper: (sfOutput) => ({
                 result: typeof sfOutput === 'string' ? sfOutput : '',
             }),