@molroo-io/sdk 0.6.2 → 0.7.1

package/dist/esm/events/console.js

@@ -1,37 +0,0 @@
-/**
- * Console-based EventAdapter for development/debugging.
- * Logs events to console (or a custom logger function).
- */
-export class ConsoleEventAdapter {
-    constructor(options) {
-        this.prefix = options?.prefix ?? '[molroo]';
-        this.filter = new Set(options?.filter ?? []);
-        this.format = options?.format ?? 'human';
-        this.logger = options?.logger ?? console.log;
-    }
-    async emit(event) {
-        if (this.filter.size > 0 && !this.filter.has(event.type)) {
-            return;
-        }
-        if (this.format === 'json') {
-            this.logger(`${this.prefix} ${JSON.stringify(event)}`);
-        }
-        else {
-            const time = new Date(event.timestamp).toISOString();
-            this.logger(`${this.prefix} ${time} ${event.type}: ${summarize(event.payload)}`);
-        }
-    }
-    async emitBatch(events) {
-        for (const event of events) {
-            await this.emit(event);
-        }
-    }
-}
-function summarize(payload) {
-    const keys = Object.keys(payload);
-    if (keys.length === 0)
-        return '{}';
-    if (keys.length <= 3)
-        return JSON.stringify(payload);
-    return `{${keys.slice(0, 3).join(', ')} + ${keys.length - 3} more}`;
-}

package/dist/esm/events/webhook.d.ts

@@ -1,30 +0,0 @@
-import type { EventAdapter, SDKEvent } from './types';
-export interface WebhookEventAdapterOptions {
-    /** Webhook endpoint URL. */
-    url: string;
-    /** HMAC secret for signing payloads. Optional. */
-    secret?: string;
-    /** Max retry attempts on server errors. Default: 2. */
-    maxRetries?: number;
-    /** Request timeout in ms. Default: 5000. */
-    timeoutMs?: number;
-    /** Additional HTTP headers. */
-    headers?: Record<string, string>;
-}
-/**
- * Webhook-based EventAdapter for production event delivery.
- * Sends events as POST requests with optional HMAC signing and retry.
- */
-export declare class WebhookEventAdapter implements EventAdapter {
-    private url;
-    private secret?;
-    private maxRetries;
-    private timeoutMs;
-    private headers;
-    constructor(options: WebhookEventAdapterOptions);
-    emit(event: SDKEvent): Promise<void>;
-    emitBatch(events: SDKEvent[]): Promise<void>;
-    private post;
-    private sign;
-}
-//# sourceMappingURL=webhook.d.ts.map

package/dist/esm/events/webhook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/events/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGtD,MAAM,WAAW,0BAA0B;IACzC,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,0BAA0B;IAQzC,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAIpC,IAAI;IAwDlB,OAAO,CAAC,IAAI;CAIb"}

package/dist/esm/events/webhook.js

@@ -1,75 +0,0 @@
-import { createHmac } from 'node:crypto';
-/**
- * Webhook-based EventAdapter for production event delivery.
- * Sends events as POST requests with optional HMAC signing and retry.
- */
-export class WebhookEventAdapter {
-    constructor(options) {
-        this.url = options.url;
-        this.secret = options.secret;
-        this.maxRetries = options.maxRetries ?? 2;
-        this.timeoutMs = options.timeoutMs ?? 5000;
-        this.headers = options.headers ?? {};
-    }
-    async emit(event) {
-        await this.post(event);
-    }
-    async emitBatch(events) {
-        await this.post(events);
-    }
-    async post(body) {
-        const jsonBody = JSON.stringify(body);
-        const timestamp = Math.floor(Date.now() / 1000);
-        const headers = {
-            'Content-Type': 'application/json',
-            ...this.headers,
-        };
-        if (this.secret) {
-            const signature = this.sign(timestamp, jsonBody);
-            headers['X-Molroo-Signature'] = `t=${timestamp},v1=${signature}`;
-        }
-        let lastError;
-        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-            if (attempt > 0) {
-                await sleep(200 * Math.pow(2, attempt - 1));
-            }
-            const controller = new AbortController();
-            const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-            try {
-                const response = await fetch(this.url, {
-                    method: 'POST',
-                    headers,
-                    body: jsonBody,
-                    signal: controller.signal,
-                });
-                clearTimeout(timer);
-                if (response.ok)
-                    return;
-                if (response.status >= 400 && response.status < 500) {
-                    throw new Error(`Webhook rejected: ${response.status} ${response.statusText}`);
-                }
-                lastError = new Error(`Webhook failed: ${response.status} ${response.statusText}`);
-            }
-            catch (err) {
-                clearTimeout(timer);
-                if (err.name === 'AbortError') {
-                    lastError = new Error(`Webhook timeout after ${this.timeoutMs}ms`);
-                }
-                else if (err.message?.startsWith('Webhook rejected')) {
-                    throw err;
-                }
-                else {
-                    lastError = err;
-                }
-            }
-        }
-        throw lastError ?? new Error('Webhook delivery failed');
-    }
-    sign(timestamp, body) {
-        const payload = `${timestamp}.${body}`;
-        return createHmac('sha256', this.secret).update(payload).digest('hex');
-    }
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}

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

@@ -1,3 +0,0 @@
-export { CloudflareVectorizeMemory } from './vectorize';
-export type { CloudflareVectorizeMemoryOptions, VectorizeIndex } from './vectorize';
-//# sourceMappingURL=index.d.ts.map

package/dist/esm/memory/cloudflare/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/cloudflare/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

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

@@ -1 +0,0 @@
-export { CloudflareVectorizeMemory } from './vectorize';

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

@@ -1,62 +0,0 @@
-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/esm/memory/cloudflare/vectorize.d.ts.map

@@ -1 +0,0 @@
-{"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/esm/memory/cloudflare/vectorize.js

@@ -1,51 +0,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');
- * ```
- */
-export 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);
-        }
-    }
-}

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

@@ -1,16 +0,0 @@
-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/esm/memory/in-memory-semantic.d.ts.map

@@ -1 +0,0 @@
-{"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/esm/memory/in-memory-semantic.js

@@ -1,53 +0,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.
- */
-export 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);
-        }
-    }
-}

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

@@ -1,7 +0,0 @@
-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/esm/memory/pinecone/index.d.ts.map

@@ -1 +0,0 @@
-{"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/esm/memory/pinecone/index.js

@@ -1,3 +0,0 @@
-export { PineconeSemanticMemory } from './semantic';
-/** @deprecated Use PineconeSemanticMemory */
-export { PineconeMemoryAdapter } from './memory-adapter';

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

@@ -1,62 +0,0 @@
-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/esm/memory/pinecone/memory-adapter.d.ts.map

@@ -1 +0,0 @@
-{"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"}

package/dist/esm/memory/pinecone/memory-adapter.js

@@ -1,216 +0,0 @@
-import { Pinecone } from '@pinecone-database/pinecone';
-/**
- * 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 class PineconeMemoryAdapter {
-    constructor(options) {
-        this.initialized = false;
-        this.episodes = [];
-        this.reflections = [];
-        this.client = new Pinecone({ apiKey: options.apiKey });
-        this.indexName = options.indexName;
-        this.namespace = options.namespace ?? 'default';
-        this.embedding = options.embedding;
-    }
-    /**
-     * Initialize the adapter. Must be called before use.
-     * Validates embedding dimension against Pinecone index.
-     */
-    async init() {
-        this.pcIndex = this.client.index(this.indexName);
-        const stats = await this.pcIndex.describeIndexStats();
-        if (stats.dimension && stats.dimension !== this.embedding.dimension) {
-            throw new Error(`Dimension mismatch: Pinecone index expects ${stats.dimension}d, ` +
-                `but embedding provider has ${this.embedding.dimension}d`);
-        }
-        this.initialized = true;
-    }
-    ensureInitialized() {
-        if (!this.initialized) {
-            throw new Error('PineconeMemoryAdapter not initialized. Call init() first.');
-        }
-    }
-    ns() {
-        return this.pcIndex.namespace(this.namespace);
-    }
-    // ── Required methods (in-memory, identical to InMemoryAdapter) ──
-    async saveEpisode(episode) {
-        this.ensureInitialized();
-        this.episodes.push(episode);
-        // Auto-upsert embedding to Pinecone (best-effort)
-        const text = episode.context ?? episode.sourceEntity ?? '';
-        if (text) {
-            try {
-                const embedding = await this.embedding.embed(text);
-                await this.ns().upsert([{
-                        id: episode.id,
-                        values: embedding,
-                        metadata: {
-                            type: 'episode',
-                            sourceEntity: episode.sourceEntity ?? '',
-                            timestamp: episode.timestamp,
-                            importance: episode.importance,
-                        },
-                    }]);
-            }
-            catch {
-                // Best-effort: vector indexing failure doesn't block episode save.
-            }
-        }
-    }
-    async recall(query) {
-        this.ensureInitialized();
-        let results = this.episodes;
-        if (query.sourceEntity) {
-            results = results.filter((e) => e.sourceEntity === query.sourceEntity);
-        }
-        if (query.context) {
-            const ctx = query.context.toLowerCase();
-            results = results.filter((e) => e.context && e.context.toLowerCase().includes(ctx));
-        }
-        if (query.valenceRange) {
-            const [min, max] = query.valenceRange;
-            results = results.filter((e) => e.emotionSnapshot.V >= min && e.emotionSnapshot.V <= max);
-        }
-        if (query.minImportance !== undefined) {
-            results = results.filter((e) => e.importance >= query.minImportance);
-        }
-        if (query.timeRange) {
-            const [start, end] = query.timeRange;
-            results = results.filter((e) => e.timestamp >= start && e.timestamp <= end);
-        }
-        // Return most recent first
-        results = results.slice().sort((a, b) => b.timestamp - a.timestamp);
-        if (query.limit && query.limit > 0) {
-            results = results.slice(0, query.limit);
-        }
-        return results;
-    }
-    async saveReflection(reflection) {
-        this.ensureInitialized();
-        this.reflections.push(reflection);
-    }
-    async getReflections(sourceEntity) {
-        this.ensureInitialized();
-        if (sourceEntity) {
-            return this.reflections.filter((r) => r.sourceEntity === sourceEntity);
-        }
-        return [...this.reflections];
-    }
-    // ── Optional methods ──
-    async semanticRecall(query, options) {
-        this.ensureInitialized();
-        const embedding = await this.embedding.embed(query);
-        const topK = options?.topK ?? 5;
-        // Build Pinecone filter
-        const filter = {};
-        if (options?.filter?.sourceEntity) {
-            filter.sourceEntity = { $eq: options.filter.sourceEntity };
-        }
-        if (options?.filter?.minImportance !== undefined) {
-            filter.importance = { $gte: options.filter.minImportance };
-        }
-        // Over-fetch to account for in-memory-only episodes that may not be in Pinecone
-        const hasFilter = Object.keys(filter).length > 0;
-        const fetchK = hasFilter ? topK * 4 : topK;
-        const results = await this.ns().query({
-            vector: embedding,
-            topK: fetchK,
-            filter: hasFilter ? filter : undefined,
-            includeMetadata: true,
-        });
-        // Map Pinecone results to episodes via in-memory lookup
-        const matches = results.matches ?? [];
-        const idSet = new Set(matches.map((m) => m.id));
-        const matched = this.episodes.filter((e) => idSet.has(e.id));
-        // Sort by Pinecone score order (highest first), limit to topK
-        const scoreMap = new Map(matches.map((m) => [m.id, m.score ?? 0]));
-        return matched
-            .sort((a, b) => (scoreMap.get(b.id) ?? 0) - (scoreMap.get(a.id) ?? 0))
-            .slice(0, topK);
-    }
-    async getByIds(ids) {
-        this.ensureInitialized();
-        const idSet = new Set(ids);
-        return this.episodes.filter((e) => idSet.has(e.id));
-    }
-    async countEpisodes(query) {
-        this.ensureInitialized();
-        let results = this.episodes;
-        if (query.sourceEntity) {
-            results = results.filter((e) => e.sourceEntity === query.sourceEntity);
-        }
-        if (query.context) {
-            const ctx = query.context.toLowerCase();
-            results = results.filter((e) => e.context && e.context.toLowerCase().includes(ctx));
-        }
-        if (query.timeRange) {
-            const [start, end] = query.timeRange;
-            results = results.filter((e) => e.timestamp >= start && e.timestamp <= end);
-        }
-        return results.length;
-    }
-    async updateEpisode(id, patch) {
-        this.ensureInitialized();
-        const episode = this.episodes.find((e) => e.id === id);
-        if (!episode)
-            return;
-        if (patch.importance !== undefined)
-            episode.importance = patch.importance;
-        if (patch.intensity !== undefined)
-            episode.intensity = patch.intensity;
-        if (patch.emotionSnapshot !== undefined)
-            episode.emotionSnapshot = patch.emotionSnapshot;
-    }
-    async deleteEpisode(id) {
-        this.ensureInitialized();
-        this.episodes = this.episodes.filter((e) => e.id !== id);
-        // Best-effort Pinecone cleanup
-        try {
-            await this.ns().deleteOne(id);
-        }
-        catch {
-            // Non-fatal: Pinecone cleanup failure doesn't affect in-memory state.
-        }
-    }
-    async expireEpisodes(before, minImportance) {
-        this.ensureInitialized();
-        const threshold = minImportance ?? 0;
-        const original = this.episodes.length;
-        // Collect IDs of episodes to expire for Pinecone cleanup
-        const expiredIds = this.episodes
-            .filter((e) => e.timestamp < before && e.importance < threshold)
-            .map((e) => e.id);
-        this.episodes = this.episodes.filter((e) => e.timestamp >= before || e.importance >= threshold);
-        const count = original - this.episodes.length;
-        // Best-effort Pinecone cleanup
-        if (expiredIds.length > 0) {
-            try {
-                await this.ns().deleteMany({ ids: expiredIds });
-            }
-            catch {
-                // Non-fatal: Pinecone cleanup failure doesn't affect in-memory state.
-            }
-        }
-        return count;
-    }
-}