@molroo-io/sdk 0.5.2

package/dist/cjs/memory/cloudflare/vectorize.d.ts

@@ -0,0 +1,62 @@
+import type { EmbeddingAdapter } from '../types';
+import type { SemanticMemory, SearchOptions, SearchResult } from '../semantic';
+/**
+ * Minimal Cloudflare Vectorize binding types.
+ * Avoids requiring @cloudflare/workers-types at compile time.
+ */
+export interface VectorizeIndex {
+    upsert(vectors: VectorizeVector[]): Promise<{
+        count: number;
+    }>;
+    query(vector: number[], options: {
+        topK: number;
+        returnMetadata?: 'all' | 'indexed' | 'none';
+        filter?: Record<string, unknown>;
+    }): Promise<{
+        matches: VectorizeMatch[];
+    }>;
+    deleteByIds(ids: string[]): Promise<{
+        count: number;
+    }>;
+}
+export interface VectorizeVector {
+    id: string;
+    values: number[];
+    metadata?: Record<string, unknown>;
+}
+export interface VectorizeMatch {
+    id: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+}
+export interface CloudflareVectorizeMemoryOptions {
+    /** Cloudflare Vectorize index binding. */
+    index: VectorizeIndex;
+    /** Embedding provider (embed function + dimension). */
+    embedding: EmbeddingAdapter;
+}
+/**
+ * Cloudflare Vectorize-backed SemanticMemory.
+ *
+ * Stores original text in Vectorize metadata (10KB limit per vector,
+ * more than enough for chat messages).
+ *
+ * @example
+ * ```typescript
+ * const memory = new CloudflareVectorizeMemory({
+ *   index: env.VECTORIZE_INDEX,
+ *   embedding: cloudflareAIEmbedding({ ai: env.AI }),
+ * });
+ * await memory.store('The user likes coffee', { userId: '123' });
+ * const results = await memory.search('beverage preferences');
+ * ```
+ */
+export declare class CloudflareVectorizeMemory implements SemanticMemory {
+    private index;
+    private embedding;
+    constructor(options: CloudflareVectorizeMemoryOptions);
+    store(text: string, metadata?: Record<string, unknown>): Promise<string>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    delete(ids: string[]): Promise<void>;
+}
+//# sourceMappingURL=vectorize.d.ts.map

package/dist/cjs/memory/cloudflare/vectorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorize.d.ts","sourceRoot":"","sources":["../../../../src/memory/cloudflare/vectorize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,KAAK,CACH,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,GACA,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gCAAgC;IAC/C,0CAA0C;IAC1C,KAAK,EAAE,cAAc,CAAC;IACtB,uDAAuD;IACvD,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAmB;gBAExB,OAAO,EAAE,gCAAgC;IAK/C,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC;IAOZ,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAqBpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3C"}

package/dist/cjs/memory/cloudflare/vectorize.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudflareVectorizeMemory = void 0;
+/**
+ * Cloudflare Vectorize-backed SemanticMemory.
+ *
+ * Stores original text in Vectorize metadata (10KB limit per vector,
+ * more than enough for chat messages).
+ *
+ * @example
+ * ```typescript
+ * const memory = new CloudflareVectorizeMemory({
+ *   index: env.VECTORIZE_INDEX,
+ *   embedding: cloudflareAIEmbedding({ ai: env.AI }),
+ * });
+ * await memory.store('The user likes coffee', { userId: '123' });
+ * const results = await memory.search('beverage preferences');
+ * ```
+ */
+class CloudflareVectorizeMemory {
+    constructor(options) {
+        this.index = options.index;
+        this.embedding = options.embedding;
+    }
+    async store(text, metadata = {}) {
+        const id = crypto.randomUUID();
+        const values = await this.embedding.embed(text);
+        await this.index.upsert([{ id, values, metadata: { text, ...metadata } }]);
+        return id;
+    }
+    async search(query, options = {}) {
+        const topK = options.topK ?? 5;
+        const threshold = options.scoreThreshold ?? 0;
+        const vector = await this.embedding.embed(query);
+        const { matches } = await this.index.query(vector, {
+            topK,
+            returnMetadata: 'all',
+            filter: options.filter,
+        });
+        return matches
+            .filter((m) => m.score >= threshold)
+            .map((m) => ({
+            id: m.id,
+            text: m.metadata?.text ?? '',
+            score: m.score,
+            metadata: m.metadata ?? {},
+        }));
+    }
+    async delete(ids) {
+        if (ids.length > 0) {
+            await this.index.deleteByIds(ids);
+        }
+    }
+}
+exports.CloudflareVectorizeMemory = CloudflareVectorizeMemory;

package/dist/cjs/memory/in-memory-semantic.d.ts

@@ -0,0 +1,16 @@
+import type { EmbeddingAdapter } from './types';
+import type { SemanticMemory, SearchOptions, SearchResult } from './semantic';
+/**
+ * In-memory SemanticMemory for local development and testing.
+ * Stores embeddings in a Map and performs brute-force cosine similarity search.
+ */
+export declare class InMemorySemanticMemory implements SemanticMemory {
+    private embedding;
+    private entries;
+    private counter;
+    constructor(embedding: EmbeddingAdapter);
+    store(text: string, metadata?: Record<string, unknown>): Promise<string>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    delete(ids: string[]): Promise<void>;
+}
+//# sourceMappingURL=in-memory-semantic.d.ts.map

package/dist/cjs/memory/in-memory-semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-semantic.d.ts","sourceRoot":"","sources":["../../../src/memory/in-memory-semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsB9E;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAI/C,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAK;gBAEA,SAAS,EAAE,gBAAgB;IAEzC,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC;IAOZ,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAsBpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3C"}

package/dist/cjs/memory/in-memory-semantic.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemorySemanticMemory = void 0;
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+/**
+ * In-memory SemanticMemory for local development and testing.
+ * Stores embeddings in a Map and performs brute-force cosine similarity search.
+ */
+class InMemorySemanticMemory {
+    constructor(embedding) {
+        this.embedding = embedding;
+        this.entries = new Map();
+        this.counter = 0;
+    }
+    async store(text, metadata = {}) {
+        const id = `mem_${++this.counter}`;
+        const vector = await this.embedding.embed(text);
+        this.entries.set(id, { id, text, embedding: vector, metadata });
+        return id;
+    }
+    async search(query, options = {}) {
+        const topK = options.topK ?? 5;
+        const threshold = options.scoreThreshold ?? 0;
+        const queryVec = await this.embedding.embed(query);
+        const scored = [];
+        for (const entry of this.entries.values()) {
+            const score = cosineSimilarity(queryVec, entry.embedding);
+            if (score >= threshold) {
+                scored.push({
+                    id: entry.id,
+                    text: entry.text,
+                    score,
+                    metadata: entry.metadata,
+                });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    async delete(ids) {
+        for (const id of ids) {
+            this.entries.delete(id);
+        }
+    }
+}
+exports.InMemorySemanticMemory = InMemorySemanticMemory;

package/dist/cjs/memory/in-memory.d.ts

@@ -0,0 +1,46 @@
+import type { Episode } from '../types';
+import type { EpisodeAdapter, EpisodeQuery, MemoryAdapter, RecallQuery, Reflection } from './types';
+/**
+ * In-memory implementation of both EpisodeAdapter and MemoryAdapter.
+ *
+ * Useful for demos, testing, and prototyping. Data is lost on process exit
+ * unless explicitly serialized via `toJSON()` / `fromJSON()`.
+ *
+ * Can be used as:
+ * - `memory: { episodes: new InMemoryEpisodeAdapter() }` (split config)
+ * - `memory: new InMemoryEpisodeAdapter()` (single adapter)
+ */
+export declare class InMemoryEpisodeAdapter implements EpisodeAdapter, MemoryAdapter {
+    private episodes;
+    private reflections;
+    saveEpisode(episode: Episode): Promise<void>;
+    /**
+     * Recall episodes by query.
+     * Accepts both `EpisodeQuery` (with `contextContains`) and `RecallQuery` (with `context`).
+     */
+    recall(query: EpisodeQuery | RecallQuery): Promise<Episode[]>;
+    getByIds(ids: string[]): Promise<Episode[]>;
+    saveReflection(reflection: Reflection): Promise<void>;
+    getReflections(sourceEntity?: string, limit?: number): Promise<Reflection[]>;
+    /** Export all data for persistence (save slots, etc.). */
+    toJSON(): {
+        episodes: Episode[];
+        reflections: Reflection[];
+    };
+    /** Restore data from a previous export. */
+    fromJSON(data: {
+        episodes?: Episode[];
+        reflections?: Reflection[];
+    }): void;
+    /** Number of stored episodes. */
+    get episodeCount(): number;
+    /** Number of stored reflections. */
+    get reflectionCount(): number;
+    /** Clear all data. */
+    clear(): void;
+}
+/** @deprecated Use InMemoryEpisodeAdapter */
+export declare const InMemoryEpisodeStore: typeof InMemoryEpisodeAdapter;
+/** @deprecated Use InMemoryEpisodeAdapter */
+export type InMemoryEpisodeStore = InMemoryEpisodeAdapter;
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/cjs/memory/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpG;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,YAAW,cAAc,EAAE,aAAa;IAC1E,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAoB;IAEjC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA0C7D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAK3C,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAelF,0DAA0D;IAC1D,MAAM,IAAI;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,WAAW,EAAE,UAAU,EAAE,CAAA;KAAE;IAO5D,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;KAAE,GAAG,IAAI;IAK1E,iCAAiC;IACjC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oCAAoC;IACpC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,sBAAsB;IACtB,KAAK,IAAI,IAAI;CAId;AAED,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,+BAAyB,CAAC;AAC3D,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC"}

package/dist/cjs/memory/in-memory.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryEpisodeStore = exports.InMemoryEpisodeAdapter = void 0;
+/**
+ * In-memory implementation of both EpisodeAdapter and MemoryAdapter.
+ *
+ * Useful for demos, testing, and prototyping. Data is lost on process exit
+ * unless explicitly serialized via `toJSON()` / `fromJSON()`.
+ *
+ * Can be used as:
+ * - `memory: { episodes: new InMemoryEpisodeAdapter() }` (split config)
+ * - `memory: new InMemoryEpisodeAdapter()` (single adapter)
+ */
+class InMemoryEpisodeAdapter {
+    constructor() {
+        this.episodes = [];
+        this.reflections = [];
+    }
+    async saveEpisode(episode) {
+        const idx = this.episodes.findIndex(e => e.id === episode.id);
+        if (idx >= 0) {
+            this.episodes[idx] = episode;
+        }
+        else {
+            this.episodes.push(episode);
+        }
+    }
+    /**
+     * Recall episodes by query.
+     * Accepts both `EpisodeQuery` (with `contextContains`) and `RecallQuery` (with `context`).
+     */
+    async recall(query) {
+        let results = [...this.episodes];
+        if (query.sourceEntity) {
+            results = results.filter(e => e.sourceEntity === query.sourceEntity);
+        }
+        // Support both EpisodeQuery.contextContains and RecallQuery.context
+        const contextSearch = ('contextContains' in query ? query.contextContains : undefined)
+            ?? ('context' in query ? query.context : undefined);
+        if (contextSearch) {
+            const lower = contextSearch.toLowerCase();
+            results = results.filter(e => e.context?.toLowerCase().includes(lower));
+        }
+        if (query.type !== undefined) {
+            const types = Array.isArray(query.type) ? query.type : [query.type];
+            results = results.filter(e => e.type !== undefined && types.includes(e.type));
+        }
+        if (query.minImportance !== undefined) {
+            results = results.filter(e => e.importance >= query.minImportance);
+        }
+        if (query.timeRange) {
+            const [from, to] = query.timeRange;
+            results = results.filter(e => e.timestamp >= from && e.timestamp <= to);
+        }
+        if ('valenceRange' in query && query.valenceRange) {
+            const [min, max] = query.valenceRange;
+            results = results.filter(e => e.emotionSnapshot.V >= min && e.emotionSnapshot.V <= max);
+        }
+        // Sort by timestamp descending (most recent first)
+        results.sort((a, b) => b.timestamp - a.timestamp);
+        const limit = query.limit ?? 10;
+        return results.slice(0, limit);
+    }
+    async getByIds(ids) {
+        const idSet = new Set(ids);
+        return this.episodes.filter(e => idSet.has(e.id));
+    }
+    async saveReflection(reflection) {
+        const idx = this.reflections.findIndex(r => r.id === reflection.id);
+        if (idx >= 0) {
+            this.reflections[idx] = reflection;
+        }
+        else {
+            this.reflections.push(reflection);
+        }
+    }
+    async getReflections(sourceEntity, limit) {
+        let results = [...this.reflections];
+        if (sourceEntity) {
+            results = results.filter(r => r.sourceEntity === sourceEntity);
+        }
+        // Sort by timestamp descending
+        results.sort((a, b) => b.timestamp - a.timestamp);
+        return results.slice(0, limit ?? 10);
+    }
+    // ── Serialization helpers ──
+    /** Export all data for persistence (save slots, etc.). */
+    toJSON() {
+        return {
+            episodes: [...this.episodes],
+            reflections: [...this.reflections],
+        };
+    }
+    /** Restore data from a previous export. */
+    fromJSON(data) {
+        this.episodes = data.episodes ? [...data.episodes] : [];
+        this.reflections = data.reflections ? [...data.reflections] : [];
+    }
+    /** Number of stored episodes. */
+    get episodeCount() {
+        return this.episodes.length;
+    }
+    /** Number of stored reflections. */
+    get reflectionCount() {
+        return this.reflections.length;
+    }
+    /** Clear all data. */
+    clear() {
+        this.episodes = [];
+        this.reflections = [];
+    }
+}
+exports.InMemoryEpisodeAdapter = InMemoryEpisodeAdapter;
+/** @deprecated Use InMemoryEpisodeAdapter */
+exports.InMemoryEpisodeStore = InMemoryEpisodeAdapter;

package/dist/cjs/memory/pinecone/index.d.ts

@@ -0,0 +1,7 @@
+export { PineconeSemanticMemory } from './semantic';
+export type { PineconeSemanticMemoryOptions } from './semantic';
+/** @deprecated Use PineconeSemanticMemory */
+export { PineconeMemoryAdapter } from './memory-adapter';
+/** @deprecated Use PineconeSemanticMemoryOptions */
+export type { PineconeMemoryAdapterOptions } from './memory-adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/memory/pinecone/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/pinecone/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEhE,6CAA6C;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,oDAAoD;AACpD,YAAY,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cjs/memory/pinecone/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PineconeMemoryAdapter = exports.PineconeSemanticMemory = void 0;
+var semantic_1 = require("./semantic");
+Object.defineProperty(exports, "PineconeSemanticMemory", { enumerable: true, get: function () { return semantic_1.PineconeSemanticMemory; } });
+/** @deprecated Use PineconeSemanticMemory */
+var memory_adapter_1 = require("./memory-adapter");
+Object.defineProperty(exports, "PineconeMemoryAdapter", { enumerable: true, get: function () { return memory_adapter_1.PineconeMemoryAdapter; } });

package/dist/cjs/memory/pinecone/memory-adapter.d.ts

@@ -0,0 +1,62 @@
+import type { MemoryAdapter, Episode, Reflection, RecallQuery, SemanticRecallOptions, EpisodePatch, CountQuery, EmbeddingAdapter } from '../types';
+export interface PineconeMemoryAdapterOptions {
+    /** Pinecone API key. */
+    apiKey: string;
+    /** Pinecone index name. */
+    indexName: string;
+    /** Pinecone namespace. Default: 'default'. */
+    namespace?: string;
+    /** Embedding provider (embed function + dimension). */
+    embedding: EmbeddingAdapter;
+}
+/**
+ * Pinecone-backed MemoryAdapter combining in-memory arrays (RDB) with
+ * Pinecone vector search (semanticRecall).
+ *
+ * RDB operations (saveEpisode, recall, saveReflection, getReflections,
+ * getByIds, countEpisodes, updateEpisode, deleteEpisode, expireEpisodes)
+ * all operate on in-memory arrays, identical to InMemoryAdapter.
+ *
+ * Vector search (semanticRecall) delegates to Pinecone after embedding
+ * the query text via the provided EmbeddingAdapter.
+ *
+ * @example
+ * ```typescript
+ * const memory = new PineconeMemoryAdapter({
+ *   apiKey: process.env.PINECONE_API_KEY!,
+ *   indexName: 'molroo-memory',
+ *   namespace: 'world-123',
+ *   embedding: openaiEmbedding({ apiKey: '...' }),
+ * });
+ * await memory.init();
+ * ```
+ */
+export declare class PineconeMemoryAdapter implements MemoryAdapter {
+    private client;
+    private pcIndex;
+    private namespace;
+    private indexName;
+    private embedding;
+    private initialized;
+    private episodes;
+    private reflections;
+    constructor(options: PineconeMemoryAdapterOptions);
+    /**
+     * Initialize the adapter. Must be called before use.
+     * Validates embedding dimension against Pinecone index.
+     */
+    init(): Promise<void>;
+    private ensureInitialized;
+    private ns;
+    saveEpisode(episode: Episode): Promise<void>;
+    recall(query: RecallQuery): Promise<Episode[]>;
+    saveReflection(reflection: Reflection): Promise<void>;
+    getReflections(sourceEntity?: string): Promise<Reflection[]>;
+    semanticRecall(query: string, options?: SemanticRecallOptions): Promise<Episode[]>;
+    getByIds(ids: string[]): Promise<Episode[]>;
+    countEpisodes(query: CountQuery): Promise<number>;
+    updateEpisode(id: string, patch: EpisodePatch): Promise<void>;
+    deleteEpisode(id: string): Promise<void>;
+    expireEpisodes(before: number, minImportance?: number): Promise<number>;
+}
+//# sourceMappingURL=memory-adapter.d.ts.map

package/dist/cjs/memory/pinecone/memory-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-adapter.d.ts","sourceRoot":"","sources":["../../../../src/memory/pinecone/memory-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,OAAO,EACP,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,4BAA4B;IAC3C,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AASD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAoB;gBAE3B,OAAO,EAAE,4BAA4B;IAOjD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,EAAE;IAMJ,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB5C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAuC9C,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAU5D,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC;IAqCf,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAM3C,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBjD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;CA2BnB"}