agentfootprint 6.42.0 → 6.43.0

package/dist/adapters/memory/bedrockAgentMemory.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * BedrockAgentMemory — read the **auto-generated session-summary memory** of a
+ * (legacy) Amazon **Bedrock Agents** agent (peer-dep `@aws-sdk/client-bedrock-agent-runtime`).
+ *
+ *   import { BedrockAgentMemory } from 'agentfootprint/memory-providers';
+ *
+ *   const mem = new BedrockAgentMemory({ agentId, agentAliasId, region: 'us-west-2' });
+ *   const summaries = await mem.readSummaries(userMemoryId);   // string summaries Bedrock wrote
+ *
+ * **This is NOT a `MemoryStore`** — and intentionally so. Bedrock Agents *owns the writes*:
+ * the agent generates `SESSION_SUMMARY` records itself (`GetAgentMemory` reads them,
+ * `DeleteAgentMemory` clears them). There is no "put an arbitrary entry" operation, so wrapping
+ * it as a `defineMemory({ store })` would be a "store that can't store." Instead it's a small
+ * **reader** you use to *surface* Bedrock's built-in memory — e.g. inject the summaries as a
+ * Fact/context block into an agentfootprint agent.
+ *
+ * For a real read/write agent memory store on AWS, use `AgentCoreStore` (the newer
+ * Bedrock **AgentCore** platform) — that's the go-forward path; this targets the prior-gen
+ * Bedrock Agents product and exists for teams migrating off it.
+ *
+ * Role:   Outer ring. Lazy-requires the AWS SDK; zero cost when unused.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BedrockAgentMemory = void 0;
+const lazyRequire_js_1 = require("../../lib/lazyRequire.js");
+/**
+ * Read-only reader for Bedrock Agents' auto session-summary memory.
+ *
+ * @throws when `@aws-sdk/client-bedrock-agent-runtime` is not installed and no
+ *         `_client`/`_sdk` is supplied.
+ */
+class BedrockAgentMemory {
+    client;
+    agentId;
+    agentAliasId;
+    maxItems;
+    constructor(options) {
+        if (!options.agentId || !options.agentAliasId) {
+            throw new Error('BedrockAgentMemory requires `agentId` and `agentAliasId`.');
+        }
+        this.agentId = options.agentId;
+        this.agentAliasId = options.agentAliasId;
+        this.maxItems = options.maxItems ?? 20;
+        this.client =
+            options._client ?? options.client ?? createBedrockAgentClient(options.region, options._sdk);
+    }
+    /** All session summaries Bedrock generated for `memoryId` (paginated). */
+    async readSummaries(memoryId, opts = {}) {
+        const out = [];
+        let nextToken;
+        do {
+            const page = await this.client.getSessionSummaries({
+                agentId: this.agentId,
+                agentAliasId: this.agentAliasId,
+                memoryId,
+                maxItems: opts.maxItems ?? this.maxItems,
+                ...(nextToken !== undefined && { nextToken }),
+            });
+            out.push(...page.summaries);
+            nextToken = page.nextToken;
+        } while (nextToken);
+        return out;
+    }
+    /** The concatenated summary text — handy to inject as a single context/Fact block. */
+    async readText(memoryId) {
+        return (await this.readSummaries(memoryId)).map((s) => s.summaryText).join('\n\n');
+    }
+    /** Clear Bedrock's memory for `memoryId` (optionally a single `sessionId`). */
+    async forget(memoryId, sessionId) {
+        await this.client.deleteMemory({
+            agentId: this.agentId,
+            agentAliasId: this.agentAliasId,
+            memoryId,
+            ...(sessionId !== undefined && { sessionId }),
+        });
+    }
+}
+exports.BedrockAgentMemory = BedrockAgentMemory;
+function toIso(v) {
+    if (v instanceof Date)
+        return v.toISOString();
+    return typeof v === 'string' ? v : undefined;
+}
+function createBedrockAgentClient(region, injected) {
+    let mod;
+    if (injected) {
+        mod = injected;
+    }
+    else {
+        try {
+            mod = (0, lazyRequire_js_1.lazyRequire)('@aws-sdk/client-bedrock-agent-runtime');
+        }
+        catch {
+            throw new Error('BedrockAgentMemory requires the `@aws-sdk/client-bedrock-agent-runtime` peer dependency.\n' +
+                '  Install:  npm install @aws-sdk/client-bedrock-agent-runtime\n' +
+                '  Or pass `client` / `_client`.');
+        }
+    }
+    if (!mod.BedrockAgentRuntimeClient) {
+        throw new Error('BedrockAgentMemory: `@aws-sdk/client-bedrock-agent-runtime` is installed but ' +
+            '`BedrockAgentRuntimeClient` was not found. Update the SDK.');
+    }
+    const sdk = new mod.BedrockAgentRuntimeClient({ ...(region && { region }) });
+    const send = async (Ctor, name, input) => {
+        if (!Ctor) {
+            throw new Error(`BedrockAgentMemory: \`@aws-sdk/client-bedrock-agent-runtime\` is missing ${name}. Upgrade the SDK.`);
+        }
+        return sdk.send(new Ctor(input));
+    };
+    return {
+        async getSessionSummaries({ agentId, agentAliasId, memoryId, maxItems, nextToken }) {
+            const r = (await send(mod.GetAgentMemoryCommand, 'GetAgentMemoryCommand', {
+                agentId,
+                agentAliasId,
+                memoryType: 'SESSION_SUMMARY',
+                memoryId,
+                ...(maxItems !== undefined && { maxItems }),
+                ...(nextToken !== undefined && { nextToken }),
+            }));
+            const summaries = (r?.memoryContents ?? [])
+                .map((m) => m.sessionSummary)
+                .filter((s) => !!s)
+                .map((s) => ({
+                sessionId: s.sessionId ?? '',
+                summaryText: s.summaryText ?? '',
+                ...(toIso(s.sessionStartTime) && { sessionStartTime: toIso(s.sessionStartTime) }),
+                ...(toIso(s.sessionExpiryTime) && { sessionExpiryTime: toIso(s.sessionExpiryTime) }),
+            }));
+            return r?.nextToken ? { summaries, nextToken: r.nextToken } : { summaries };
+        },
+        async deleteMemory({ agentId, agentAliasId, memoryId, sessionId }) {
+            await send(mod.DeleteAgentMemoryCommand, 'DeleteAgentMemoryCommand', {
+                agentId,
+                agentAliasId,
+                memoryId,
+                ...(sessionId !== undefined && { sessionId }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=bedrockAgentMemory.js.map

package/dist/adapters/memory/bedrockAgentMemory.js.map

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

package/dist/esm/adapters/memory/bedrockAgentMemory.js

@@ -0,0 +1,138 @@
+/**
+ * BedrockAgentMemory — read the **auto-generated session-summary memory** of a
+ * (legacy) Amazon **Bedrock Agents** agent (peer-dep `@aws-sdk/client-bedrock-agent-runtime`).
+ *
+ *   import { BedrockAgentMemory } from 'agentfootprint/memory-providers';
+ *
+ *   const mem = new BedrockAgentMemory({ agentId, agentAliasId, region: 'us-west-2' });
+ *   const summaries = await mem.readSummaries(userMemoryId);   // string summaries Bedrock wrote
+ *
+ * **This is NOT a `MemoryStore`** — and intentionally so. Bedrock Agents *owns the writes*:
+ * the agent generates `SESSION_SUMMARY` records itself (`GetAgentMemory` reads them,
+ * `DeleteAgentMemory` clears them). There is no "put an arbitrary entry" operation, so wrapping
+ * it as a `defineMemory({ store })` would be a "store that can't store." Instead it's a small
+ * **reader** you use to *surface* Bedrock's built-in memory — e.g. inject the summaries as a
+ * Fact/context block into an agentfootprint agent.
+ *
+ * For a real read/write agent memory store on AWS, use `AgentCoreStore` (the newer
+ * Bedrock **AgentCore** platform) — that's the go-forward path; this targets the prior-gen
+ * Bedrock Agents product and exists for teams migrating off it.
+ *
+ * Role:   Outer ring. Lazy-requires the AWS SDK; zero cost when unused.
+ */
+import { lazyRequire } from '../../lib/lazyRequire.js';
+/**
+ * Read-only reader for Bedrock Agents' auto session-summary memory.
+ *
+ * @throws when `@aws-sdk/client-bedrock-agent-runtime` is not installed and no
+ *         `_client`/`_sdk` is supplied.
+ */
+export class BedrockAgentMemory {
+    client;
+    agentId;
+    agentAliasId;
+    maxItems;
+    constructor(options) {
+        if (!options.agentId || !options.agentAliasId) {
+            throw new Error('BedrockAgentMemory requires `agentId` and `agentAliasId`.');
+        }
+        this.agentId = options.agentId;
+        this.agentAliasId = options.agentAliasId;
+        this.maxItems = options.maxItems ?? 20;
+        this.client =
+            options._client ?? options.client ?? createBedrockAgentClient(options.region, options._sdk);
+    }
+    /** All session summaries Bedrock generated for `memoryId` (paginated). */
+    async readSummaries(memoryId, opts = {}) {
+        const out = [];
+        let nextToken;
+        do {
+            const page = await this.client.getSessionSummaries({
+                agentId: this.agentId,
+                agentAliasId: this.agentAliasId,
+                memoryId,
+                maxItems: opts.maxItems ?? this.maxItems,
+                ...(nextToken !== undefined && { nextToken }),
+            });
+            out.push(...page.summaries);
+            nextToken = page.nextToken;
+        } while (nextToken);
+        return out;
+    }
+    /** The concatenated summary text — handy to inject as a single context/Fact block. */
+    async readText(memoryId) {
+        return (await this.readSummaries(memoryId)).map((s) => s.summaryText).join('\n\n');
+    }
+    /** Clear Bedrock's memory for `memoryId` (optionally a single `sessionId`). */
+    async forget(memoryId, sessionId) {
+        await this.client.deleteMemory({
+            agentId: this.agentId,
+            agentAliasId: this.agentAliasId,
+            memoryId,
+            ...(sessionId !== undefined && { sessionId }),
+        });
+    }
+}
+function toIso(v) {
+    if (v instanceof Date)
+        return v.toISOString();
+    return typeof v === 'string' ? v : undefined;
+}
+function createBedrockAgentClient(region, injected) {
+    let mod;
+    if (injected) {
+        mod = injected;
+    }
+    else {
+        try {
+            mod = lazyRequire('@aws-sdk/client-bedrock-agent-runtime');
+        }
+        catch {
+            throw new Error('BedrockAgentMemory requires the `@aws-sdk/client-bedrock-agent-runtime` peer dependency.\n' +
+                '  Install:  npm install @aws-sdk/client-bedrock-agent-runtime\n' +
+                '  Or pass `client` / `_client`.');
+        }
+    }
+    if (!mod.BedrockAgentRuntimeClient) {
+        throw new Error('BedrockAgentMemory: `@aws-sdk/client-bedrock-agent-runtime` is installed but ' +
+            '`BedrockAgentRuntimeClient` was not found. Update the SDK.');
+    }
+    const sdk = new mod.BedrockAgentRuntimeClient({ ...(region && { region }) });
+    const send = async (Ctor, name, input) => {
+        if (!Ctor) {
+            throw new Error(`BedrockAgentMemory: \`@aws-sdk/client-bedrock-agent-runtime\` is missing ${name}. Upgrade the SDK.`);
+        }
+        return sdk.send(new Ctor(input));
+    };
+    return {
+        async getSessionSummaries({ agentId, agentAliasId, memoryId, maxItems, nextToken }) {
+            const r = (await send(mod.GetAgentMemoryCommand, 'GetAgentMemoryCommand', {
+                agentId,
+                agentAliasId,
+                memoryType: 'SESSION_SUMMARY',
+                memoryId,
+                ...(maxItems !== undefined && { maxItems }),
+                ...(nextToken !== undefined && { nextToken }),
+            }));
+            const summaries = (r?.memoryContents ?? [])
+                .map((m) => m.sessionSummary)
+                .filter((s) => !!s)
+                .map((s) => ({
+                sessionId: s.sessionId ?? '',
+                summaryText: s.summaryText ?? '',
+                ...(toIso(s.sessionStartTime) && { sessionStartTime: toIso(s.sessionStartTime) }),
+                ...(toIso(s.sessionExpiryTime) && { sessionExpiryTime: toIso(s.sessionExpiryTime) }),
+            }));
+            return r?.nextToken ? { summaries, nextToken: r.nextToken } : { summaries };
+        },
+        async deleteMemory({ agentId, agentAliasId, memoryId, sessionId }) {
+            await send(mod.DeleteAgentMemoryCommand, 'DeleteAgentMemoryCommand', {
+                agentId,
+                agentAliasId,
+                memoryId,
+                ...(sessionId !== undefined && { sessionId }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=bedrockAgentMemory.js.map

package/dist/esm/adapters/memory/bedrockAgentMemory.js.map

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

package/dist/esm/memory-providers.js

@@ -37,4 +37,7 @@
 // `ioredis` or `@aws-sdk/client-bedrock-agent-runtime`.
 export { RedisStore, } from './adapters/memory/redis.js';
 export { AgentCoreStore, } from './adapters/memory/agentcore.js';
+// Read-only reader for the legacy Bedrock Agents auto session-summary memory.
+// NOT a MemoryStore (Bedrock owns the writes) — see the class docstring.
+export { BedrockAgentMemory, } from './adapters/memory/bedrockAgentMemory.js';
 //# sourceMappingURL=memory-providers.js.map

package/dist/esm/memory-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../../src/memory-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,OAAO,EACL,UAAU,GAIX,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,GAGf,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../../src/memory-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,OAAO,EACL,UAAU,GAIX,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,GAGf,MAAM,gCAAgC,CAAC;AAExC,8EAA8E;AAC9E,yEAAyE;AACzE,OAAO,EACL,kBAAkB,GAInB,MAAM,yCAAyC,CAAC"}

package/dist/memory-providers.js

@@ -34,7 +34,7 @@
  *   import { RedisStore, AgentCoreStore } from 'agentfootprint/memory-providers';
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentCoreStore = exports.RedisStore = void 0;
+exports.BedrockAgentMemory = 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`.
@@ -42,4 +42,8 @@ var redis_js_1 = require("./adapters/memory/redis.js");
 Object.defineProperty(exports, "RedisStore", { enumerable: true, get: function () { return redis_js_1.RedisStore; } });
 var agentcore_js_1 = require("./adapters/memory/agentcore.js");
 Object.defineProperty(exports, "AgentCoreStore", { enumerable: true, get: function () { return agentcore_js_1.AgentCoreStore; } });
+// Read-only reader for the legacy Bedrock Agents auto session-summary memory.
+// NOT a MemoryStore (Bedrock owns the writes) — see the class docstring.
+var bedrockAgentMemory_js_1 = require("./adapters/memory/bedrockAgentMemory.js");
+Object.defineProperty(exports, "BedrockAgentMemory", { enumerable: true, get: function () { return bedrockAgentMemory_js_1.BedrockAgentMemory; } });
 //# sourceMappingURL=memory-providers.js.map

package/dist/memory-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../src/memory-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,uDAKoC;AAJlC,sGAAA,UAAU,OAAA;AAMZ,+DAIwC;AAHtC,8GAAA,cAAc,OAAA"}
+{"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../src/memory-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,uDAKoC;AAJlC,sGAAA,UAAU,OAAA;AAMZ,+DAIwC;AAHtC,8GAAA,cAAc,OAAA;AAKhB,8EAA8E;AAC9E,yEAAyE;AACzE,iFAKiD;AAJ/C,2HAAA,kBAAkB,OAAA"}

package/dist/types/adapters/memory/bedrockAgentMemory.d.ts

@@ -0,0 +1,96 @@
+/**
+ * BedrockAgentMemory — read the **auto-generated session-summary memory** of a
+ * (legacy) Amazon **Bedrock Agents** agent (peer-dep `@aws-sdk/client-bedrock-agent-runtime`).
+ *
+ *   import { BedrockAgentMemory } from 'agentfootprint/memory-providers';
+ *
+ *   const mem = new BedrockAgentMemory({ agentId, agentAliasId, region: 'us-west-2' });
+ *   const summaries = await mem.readSummaries(userMemoryId);   // string summaries Bedrock wrote
+ *
+ * **This is NOT a `MemoryStore`** — and intentionally so. Bedrock Agents *owns the writes*:
+ * the agent generates `SESSION_SUMMARY` records itself (`GetAgentMemory` reads them,
+ * `DeleteAgentMemory` clears them). There is no "put an arbitrary entry" operation, so wrapping
+ * it as a `defineMemory({ store })` would be a "store that can't store." Instead it's a small
+ * **reader** you use to *surface* Bedrock's built-in memory — e.g. inject the summaries as a
+ * Fact/context block into an agentfootprint agent.
+ *
+ * For a real read/write agent memory store on AWS, use `AgentCoreStore` (the newer
+ * Bedrock **AgentCore** platform) — that's the go-forward path; this targets the prior-gen
+ * Bedrock Agents product and exists for teams migrating off it.
+ *
+ * Role:   Outer ring. Lazy-requires the AWS SDK; zero cost when unused.
+ */
+/** One auto-generated session summary from Bedrock Agents memory. */
+export interface BedrockAgentSummary {
+    readonly sessionId: string;
+    readonly summaryText: string;
+    /** ISO timestamps (the SDK returns Date; serialized here for portability). */
+    readonly sessionStartTime?: string;
+    readonly sessionExpiryTime?: string;
+}
+/** Minimal surface the reader uses; tests inject a mock via `_client`. */
+export interface BedrockAgentMemoryLikeClient {
+    getSessionSummaries(input: {
+        agentId: string;
+        agentAliasId: string;
+        memoryId: string;
+        maxItems?: number;
+        nextToken?: string;
+    }): Promise<{
+        summaries: readonly BedrockAgentSummary[];
+        nextToken?: string;
+    }>;
+    deleteMemory(input: {
+        agentId: string;
+        agentAliasId: string;
+        memoryId: string;
+        sessionId?: string;
+    }): Promise<void>;
+}
+export interface BedrockAgentMemoryOptions {
+    /** The Bedrock Agent id whose memory to read. Required. */
+    readonly agentId: string;
+    /** The Bedrock Agent alias id. Required. */
+    readonly agentAliasId: string;
+    /** AWS region (when constructing the SDK client internally). */
+    readonly region?: string;
+    /** Pre-built client (shares one SDK config across the host app). */
+    readonly client?: BedrockAgentMemoryLikeClient;
+    /** Default page size for `readSummaries`. Default 20. */
+    readonly maxItems?: number;
+    /** @internal Test injection — skips the SDK require. */
+    readonly _client?: BedrockAgentMemoryLikeClient;
+    /** @internal Test injection — the AWS SDK module. */
+    readonly _sdk?: BedrockAgentRuntimeSdkModule;
+}
+/**
+ * Read-only reader for Bedrock Agents' auto session-summary memory.
+ *
+ * @throws when `@aws-sdk/client-bedrock-agent-runtime` is not installed and no
+ *         `_client`/`_sdk` is supplied.
+ */
+export declare class BedrockAgentMemory {
+    private readonly client;
+    private readonly agentId;
+    private readonly agentAliasId;
+    private readonly maxItems;
+    constructor(options: BedrockAgentMemoryOptions);
+    /** All session summaries Bedrock generated for `memoryId` (paginated). */
+    readSummaries(memoryId: string, opts?: {
+        maxItems?: number;
+    }): Promise<BedrockAgentSummary[]>;
+    /** The concatenated summary text — handy to inject as a single context/Fact block. */
+    readText(memoryId: string): Promise<string>;
+    /** Clear Bedrock's memory for `memoryId` (optionally a single `sessionId`). */
+    forget(memoryId: string, sessionId?: string): Promise<void>;
+}
+export interface BedrockAgentRuntimeSdkModule {
+    readonly BedrockAgentRuntimeClient?: new (config: {
+        region?: string;
+    }) => {
+        send(cmd: unknown): Promise<unknown>;
+    };
+    readonly GetAgentMemoryCommand?: new (input: unknown) => unknown;
+    readonly DeleteAgentMemoryCommand?: new (input: unknown) => unknown;
+}
+//# sourceMappingURL=bedrockAgentMemory.d.ts.map

package/dist/types/adapters/memory/bedrockAgentMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bedrockAgentMemory.d.ts","sourceRoot":"","sources":["../../../../src/adapters/memory/bedrockAgentMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,0EAA0E;AAC1E,MAAM,WAAW,4BAA4B;IAC3C,mBAAmB,CAAC,KAAK,EAAE;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,YAAY,CAAC,KAAK,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC;IAC/C,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,4BAA4B,CAAC;IAChD,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,4BAA4B,CAAC;CAC9C;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,yBAAyB;IAW9C,0EAA0E;IACpE,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAiBjC,sFAAsF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD,+EAA+E;IACzE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQlE;AAID,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,yBAAyB,CAAC,EAAE,KAAK,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QACxE,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,KAAK,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACjE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,KAAK,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACrE"}

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

@@ -34,4 +34,5 @@
  */
 export { RedisStore, type RedisStoreOptions, type RedisLikeClient, type RedisLikePipeline, } from './adapters/memory/redis.js';
 export { AgentCoreStore, type AgentCoreStoreOptions, type AgentCoreLikeClient, } from './adapters/memory/agentcore.js';
+export { BedrockAgentMemory, type BedrockAgentMemoryOptions, type BedrockAgentMemoryLikeClient, type BedrockAgentSummary, } from './adapters/memory/bedrockAgentMemory.js';
 //# sourceMappingURL=memory-providers.d.ts.map

package/dist/types/memory-providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-providers.d.ts","sourceRoot":"","sources":["../../src/memory-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"memory-providers.d.ts","sourceRoot":"","sources":["../../src/memory-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,GACzB,MAAM,yCAAyC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "6.42.0",
+  "version": "6.43.0",
   "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",