ai-memory-layer 2.0.0

package/dist/core/validation.js

@@ -0,0 +1,185 @@
+import { normalizeScope } from '../contracts/identity.js';
+import { COMPACTION_STATES, COMPACTION_TRIGGERS, FACT_CONFIDENCES, FACT_SOURCES, FACT_TYPES, EVIDENCE_SOURCE_TYPES, GROUNDING_STRENGTHS, KNOWLEDGE_AUDIT_DECISIONS, KNOWLEDGE_CLASSES, KNOWLEDGE_STATES, SUPPORT_POLARITIES, TURN_ROLES, WORK_ITEM_KINDS, WORK_ITEM_STATUSES, } from '../contracts/types.js';
+export function nowSeconds() {
+    return Math.floor(Date.now() / 1000);
+}
+export function assertNonEmpty(value, name) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`Memory validation: '${name}' must not be empty`);
+    }
+}
+export function assertEnum(value, allowed, name) {
+    if (!allowed.includes(value)) {
+        throw new Error(`Memory validation: '${name}' must be one of [${allowed.join(', ')}], got '${value}'`);
+    }
+}
+export function assertStringArray(value, name) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string')) {
+        throw new Error(`Memory validation: '${name}' must be an array of strings`);
+    }
+}
+export function assertMaxEntries(value, name, max) {
+    if (value.length > max) {
+        throw new Error(`Memory validation: '${name}' must have at most ${max} entries, got ${value.length}`);
+    }
+}
+export function assertNumberRange(value, name, min, max) {
+    if (!Number.isFinite(value) || value < min || value > max) {
+        throw new Error(`Memory validation: '${name}' must be between ${min} and ${max}, got '${value}'`);
+    }
+}
+export function assertTurnRange(startId, endId) {
+    if (endId < startId) {
+        throw new Error(`Memory validation: 'turn_id_end' (${endId}) must be >= 'turn_id_start' (${startId})`);
+    }
+}
+export function assertScope(scope) {
+    return normalizeScope(scope);
+}
+export function assertTurnRole(role) {
+    assertEnum(role, TURN_ROLES, 'role');
+}
+export function assertCompactionTrigger(trigger, name = 'compaction_trigger') {
+    assertEnum(trigger, COMPACTION_TRIGGERS, name);
+}
+export function assertFactType(factType) {
+    assertEnum(factType, FACT_TYPES, 'fact_type');
+}
+export function assertFactSource(source) {
+    assertEnum(source, FACT_SOURCES, 'source');
+}
+export function assertFactConfidence(confidence) {
+    assertEnum(confidence, FACT_CONFIDENCES, 'confidence');
+}
+export function assertKnowledgeState(state) {
+    assertEnum(state, KNOWLEDGE_STATES, 'knowledge_state');
+}
+export function assertKnowledgeClass(knowledgeClass) {
+    assertEnum(knowledgeClass, KNOWLEDGE_CLASSES, 'knowledge_class');
+}
+export function assertEvidenceSourceType(sourceType) {
+    assertEnum(sourceType, EVIDENCE_SOURCE_TYPES, 'source_type');
+}
+export function assertGroundingStrength(strength) {
+    assertEnum(strength, GROUNDING_STRENGTHS, 'grounding_strength');
+}
+export function assertSupportPolarity(polarity) {
+    assertEnum(polarity, SUPPORT_POLARITIES, 'support_polarity');
+}
+export function assertKnowledgeAuditDecision(decision) {
+    assertEnum(decision, KNOWLEDGE_AUDIT_DECISIONS, 'decision');
+}
+export function assertCompactionState(state) {
+    assertEnum(state, COMPACTION_STATES, 'compaction_state');
+}
+export function assertWorkItemKind(kind) {
+    assertEnum(kind, WORK_ITEM_KINDS, 'kind');
+}
+export function assertWorkItemStatus(status) {
+    assertEnum(status, WORK_ITEM_STATUSES, 'status');
+}
+export function validateNewTurn(input) {
+    const scope = assertScope(input);
+    assertNonEmpty(input.session_id, 'session_id');
+    assertNonEmpty(input.actor, 'actor');
+    assertNonEmpty(input.content, 'content');
+    assertTurnRole(input.role);
+    if (input.priority !== undefined) {
+        assertNumberRange(input.priority, 'priority', 0, 2);
+    }
+    return scope;
+}
+export function validateNewWorkingMemory(input) {
+    const scope = assertScope(input);
+    assertNonEmpty(input.session_id, 'session_id');
+    assertNonEmpty(input.summary, 'summary');
+    assertCompactionTrigger(input.compaction_trigger);
+    assertStringArray(input.key_entities, 'key_entities');
+    assertStringArray(input.topic_tags, 'topic_tags');
+    assertMaxEntries(input.topic_tags, 'topic_tags', 5);
+    assertTurnRange(input.turn_id_start, input.turn_id_end);
+    return scope;
+}
+export function validateNewKnowledgeMemory(input) {
+    const scope = assertScope(input);
+    assertNonEmpty(input.fact, 'fact');
+    assertFactType(input.fact_type);
+    assertFactSource(input.source);
+    assertFactConfidence(input.confidence);
+    if (input.knowledge_state !== undefined) {
+        assertKnowledgeState(input.knowledge_state);
+    }
+    if (input.knowledge_class !== undefined) {
+        assertKnowledgeClass(input.knowledge_class);
+    }
+    if (input.grounding_strength !== undefined) {
+        assertGroundingStrength(input.grounding_strength);
+    }
+    return scope;
+}
+export function validateNewKnowledgeMemoryAudit(input) {
+    const scope = assertScope(input);
+    assertNonEmpty(input.fact, 'fact');
+    assertFactType(input.fact_type);
+    assertFactConfidence(input.confidence);
+    assertKnowledgeAuditDecision(input.decision);
+    return scope;
+}
+export function validateNewKnowledgeCandidate(input) {
+    const scope = assertScope(input);
+    assertNonEmpty(input.fact, 'fact');
+    assertFactType(input.fact_type);
+    assertKnowledgeClass(input.knowledge_class);
+    assertFactConfidence(input.confidence);
+    assertGroundingStrength(input.grounding_strength ?? 'weak');
+    assertKnowledgeState(input.state ?? 'candidate');
+    return scope;
+}
+export function validateNewKnowledgeEvidence(input) {
+    const scope = assertScope(input);
+    assertEvidenceSourceType(input.source_type);
+    assertSupportPolarity(input.support_polarity);
+    assertNonEmpty(input.excerpt, 'excerpt');
+    if (input.speaker_role !== undefined && input.speaker_role !== null) {
+        assertTurnRole(input.speaker_role);
+    }
+    return scope;
+}
+export function validateContextMonitorUpsert(input) {
+    const scope = assertScope(input);
+    assertCompactionState(input.compaction_state);
+    return scope;
+}
+export function validateNewCompactionLog(input) {
+    const scope = assertScope(input);
+    assertNonEmpty(input.session_id, 'session_id');
+    assertCompactionTrigger(input.trigger_type, 'trigger_type');
+    assertTurnRange(input.turn_id_start, input.turn_id_end);
+    return scope;
+}
+export function validateTimeRange(range) {
+    if (range.start_at !== undefined &&
+        range.end_at !== undefined &&
+        range.end_at < range.start_at) {
+        throw new Error("Memory validation: 'end_at' must be >= 'start_at'");
+    }
+}
+export function validateNewWorkItem(input) {
+    const scope = assertScope(input);
+    assertNonEmpty(input.title, 'title');
+    assertWorkItemKind(input.kind);
+    assertWorkItemStatus(input.status ?? 'open');
+    return scope;
+}
+export function assertArchiveInput(id, archivedAt, compactionLogId) {
+    if (!Number.isInteger(id) || id <= 0) {
+        throw new Error(`Memory validation: 'id' must be a positive integer, got '${id}'`);
+    }
+    if (!Number.isInteger(archivedAt) || archivedAt <= 0) {
+        throw new Error(`Memory validation: 'archivedAt' must be a positive integer, got '${archivedAt}'`);
+    }
+    if (!Number.isInteger(compactionLogId) || compactionLogId <= 0) {
+        throw new Error(`Memory validation: 'compactionLogId' must be a positive integer, got '${compactionLogId}'`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/embeddings/local.d.ts

@@ -0,0 +1,5 @@
+import type { EmbeddingGenerator } from '../contracts/embedding.js';
+export declare function createLocalEmbeddingGenerator(options?: {
+    dimensions?: number;
+}): EmbeddingGenerator;
+//# sourceMappingURL=local.d.ts.map

package/dist/embeddings/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,2BAA2B,CAAC;AAsHrF,wBAAgB,6BAA6B,CAAC,OAAO,CAAC,EAAE;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,kBAAkB,CA4BrB"}

package/dist/embeddings/local.js

@@ -0,0 +1,128 @@
+const DEFAULT_DIMENSIONS = 384;
+const HASH_SEEDS = [2166136261, 16777619, 374761393, 668265263];
+const TOKEN_ALIASES = {
+    pg: ['postgres', 'postgresql'],
+    postgres: ['postgresql', 'pg'],
+    postgresql: ['postgres', 'pg'],
+    ts: ['typescript'],
+    typescript: ['ts'],
+    js: ['javascript'],
+    javascript: ['js'],
+    auth: ['authentication'],
+    authentication: ['auth'],
+    repo: ['repository'],
+    repository: ['repo'],
+    deploy: ['deployment', 'release'],
+    deployment: ['deploy', 'release'],
+    bug: ['issue'],
+    issue: ['bug'],
+};
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .filter((token) => token.length > 1);
+}
+function stemToken(token) {
+    return token
+        .replace(/(ments|ment|tions|tion|ings|ing|edly|edly|edly|edly|ed|ly|es|s)$/g, '')
+        .replace(/(.)\1$/g, '$1');
+}
+function expandTokenFeatures(token) {
+    const features = new Set([token]);
+    const stem = stemToken(token);
+    if (stem.length > 2) {
+        features.add(`stem:${stem}`);
+    }
+    for (const alias of TOKEN_ALIASES[token] ?? []) {
+        features.add(`alias:${alias}`);
+        const aliasStem = stemToken(alias);
+        if (aliasStem.length > 2) {
+            features.add(`stem:${aliasStem}`);
+        }
+    }
+    return [...features];
+}
+function charTrigrams(token) {
+    if (token.length <= 3)
+        return [token];
+    const padded = `_${token}_`;
+    const results = [];
+    for (let index = 0; index <= padded.length - 3; index += 1) {
+        results.push(padded.slice(index, index + 3));
+    }
+    return results;
+}
+function collectFeatures(tokens) {
+    const features = new Map();
+    const increment = (feature) => {
+        features.set(feature, (features.get(feature) ?? 0) + 1);
+    };
+    tokens.forEach((token, index) => {
+        const expanded = expandTokenFeatures(token);
+        expanded.forEach((feature) => increment(`tok:${feature}`));
+        for (const feature of expanded) {
+            for (const trigram of charTrigrams(feature.replace(/^(?:stem:|alias:)/, ''))) {
+                increment(`chr:${trigram}`);
+            }
+        }
+        if (index < tokens.length - 1) {
+            increment(`big:${token}_${tokens[index + 1]}`);
+        }
+        if (index < tokens.length - 2) {
+            increment(`skip:${token}_${tokens[index + 2]}`);
+        }
+    });
+    return features;
+}
+function hashFeature(feature, dimensions, seed) {
+    let hash = seed;
+    for (let i = 0; i < feature.length; i += 1) {
+        hash ^= feature.charCodeAt(i);
+        hash = Math.imul(hash, 16777619);
+    }
+    const normalized = hash >>> 0;
+    return {
+        index: normalized % dimensions,
+        sign: normalized % 2 === 0 ? 1 : -1,
+    };
+}
+function normalizeVector(vector) {
+    let magnitude = 0;
+    for (let i = 0; i < vector.length; i += 1) {
+        magnitude += vector[i] * vector[i];
+    }
+    if (magnitude === 0) {
+        return vector;
+    }
+    const scale = Math.sqrt(magnitude);
+    for (let i = 0; i < vector.length; i += 1) {
+        vector[i] /= scale;
+    }
+    return vector;
+}
+export function createLocalEmbeddingGenerator(options) {
+    const dimensions = options?.dimensions ?? DEFAULT_DIMENSIONS;
+    return async (texts) => {
+        const featureSets = texts.map((text) => collectFeatures(tokenize(text)));
+        const documentFrequency = new Map();
+        featureSets.forEach((features) => {
+            features.forEach((_count, feature) => {
+                documentFrequency.set(feature, (documentFrequency.get(feature) ?? 0) + 1);
+            });
+        });
+        return featureSets.map((features) => {
+            const vector = new Float32Array(dimensions);
+            for (const [feature, termFrequency] of features.entries()) {
+                const inverseDocumentFrequency = 1 + Math.log((1 + featureSets.length) / (1 + (documentFrequency.get(feature) ?? 0)));
+                const weight = (1 + Math.log(termFrequency)) * inverseDocumentFrequency;
+                for (const seed of HASH_SEEDS) {
+                    const { index, sign } = hashFeature(feature, dimensions, seed);
+                    vector[index] += weight * sign;
+                }
+            }
+            return normalizeVector(vector);
+        });
+    };
+}
+//# sourceMappingURL=local.js.map

package/dist/embeddings/local.js.map

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

package/dist/embeddings/openai.d.ts

@@ -0,0 +1,26 @@
+import type { EmbeddingGenerator } from '../contracts/embedding.js';
+export interface OpenAIEmbeddingOptions {
+    /** API key. Defaults to OPENAI_API_KEY env var. */
+    apiKey?: string;
+    /** Model to use. Defaults to 'text-embedding-3-small'. */
+    model?: string;
+    /** Optional dimensions override (for models that support it). */
+    dimensions?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    batchSize?: number;
+    cacheSize?: number;
+}
+/**
+ * Creates an EmbeddingGenerator that calls the OpenAI embeddings API.
+ * Requires the `openai` package as an optional peer dependency.
+ *
+ * ```typescript
+ * import { createOpenAIEmbeddingGenerator } from 'memory-layer/embeddings/openai';
+ *
+ * const generator = createOpenAIEmbeddingGenerator();
+ * const vectors = await generator(['hello world']);
+ * ```
+ */
+export declare function createOpenAIEmbeddingGenerator(options?: OpenAIEmbeddingOptions): EmbeddingGenerator;
+//# sourceMappingURL=openai.d.ts.map

package/dist/embeddings/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/embeddings/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,2BAA2B,CAAC;AAOrF,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,CAAC,EAAE,sBAAsB,GAC/B,kBAAkB,CA8DpB"}

package/dist/embeddings/openai.js

@@ -0,0 +1,48 @@
+import { batchedGenerate, createCachedEmbeddingGenerator, withRetry, } from './resilience.js';
+/**
+ * Creates an EmbeddingGenerator that calls the OpenAI embeddings API.
+ * Requires the `openai` package as an optional peer dependency.
+ *
+ * ```typescript
+ * import { createOpenAIEmbeddingGenerator } from 'memory-layer/embeddings/openai';
+ *
+ * const generator = createOpenAIEmbeddingGenerator();
+ * const vectors = await generator(['hello world']);
+ * ```
+ */
+export function createOpenAIEmbeddingGenerator(options) {
+    const model = options?.model ?? 'text-embedding-3-small';
+    const dimensions = options?.dimensions;
+    let clientPromise = null;
+    async function getClient() {
+        if (!clientPromise) {
+            clientPromise = (async () => {
+                try {
+                    const moduleName = 'openai';
+                    const mod = await import(moduleName);
+                    const OpenAI = mod.default ?? mod;
+                    return new OpenAI({ apiKey: options?.apiKey });
+                }
+                catch {
+                    throw new Error('memory-layer: OpenAI embedding generator requires the "openai" package. ' +
+                        'Install it with: npm install openai');
+                }
+            })();
+        }
+        return clientPromise;
+    }
+    const baseGenerator = async (texts) => {
+        if (texts.length === 0)
+            return [];
+        const client = await getClient();
+        const response = await client.embeddings.create({
+            model,
+            input: texts,
+            ...(dimensions ? { dimensions } : {}),
+        });
+        return response.data.map((item) => new Float32Array(item.embedding));
+    };
+    const cachedGenerator = createCachedEmbeddingGenerator(baseGenerator, options?.cacheSize ?? 256);
+    return async (texts) => withRetry(() => batchedGenerate(cachedGenerator, texts, options?.batchSize ?? 32), options?.maxRetries ?? 2, options?.retryDelayMs ?? 250);
+}
+//# sourceMappingURL=openai.js.map

package/dist/embeddings/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/embeddings/openai.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,GACV,MAAM,iBAAiB,CAAC;AAezB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAgC;IAEhC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,wBAAwB,CAAC;IACzD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IAEvC,IAAI,aAAa,GAA4B,IAAI,CAAC;IAElD,KAAK,UAAU,SAAS;QACtB,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC1B,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,QAAQ,CAAC;oBAC5B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;oBACrC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;oBAClC,OAAO,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBACjD,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,KAAK,CACb,0EAA0E;wBACxE,qCAAqC,CACxC,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,aAAa,GAAuB,KAAK,EAAE,KAAe,EAA8B,EAAE;QAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,MAAM,MAAM,GAAG,MAAM,SAAS,EAU7B,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YAC9C,KAAK;YACL,KAAK,EAAE,KAAK;YACZ,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CACtB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAC3C,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,8BAA8B,CACpD,aAAa,EACb,OAAO,EAAE,SAAS,IAAI,GAAG,CAC1B,CAAC;IAEF,OAAO,KAAK,EAAE,KAAe,EAA8B,EAAE,CAC3D,SAAS,CACP,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC,EACvE,OAAO,EAAE,UAAU,IAAI,CAAC,EACxB,OAAO,EAAE,YAAY,IAAI,GAAG,CAC7B,CAAC;AACN,CAAC"}

package/dist/embeddings/resilience.d.ts

@@ -0,0 +1,5 @@
+import type { EmbeddingGenerator, EmbeddingVector } from '../contracts/embedding.js';
+export declare function withRetry<T>(fn: () => Promise<T>, maxRetries?: number, delayMs?: number): Promise<T>;
+export declare function batchedGenerate(generator: EmbeddingGenerator, inputs: string[], batchSize?: number): Promise<EmbeddingVector[]>;
+export declare function createCachedEmbeddingGenerator(generator: EmbeddingGenerator, maxEntries?: number): EmbeddingGenerator;
+//# sourceMappingURL=resilience.d.ts.map

package/dist/embeddings/resilience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../../src/embeddings/resilience.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMrF,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,SAAI,EACd,OAAO,SAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,SAAK,GACb,OAAO,CAAC,eAAe,EAAE,CAAC,CAU5B;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,kBAAkB,EAC7B,UAAU,SAAM,GACf,kBAAkB,CAoBpB"}

package/dist/embeddings/resilience.js

@@ -0,0 +1,53 @@
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function withRetry(fn, maxRetries = 2, delayMs = 250) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxRetries) {
+                throw error;
+            }
+            await sleep(delayMs * 2 ** attempt);
+        }
+    }
+    throw lastError;
+}
+export async function batchedGenerate(generator, inputs, batchSize = 32) {
+    if (inputs.length === 0)
+        return [];
+    if (batchSize <= 0)
+        return generator(inputs);
+    const output = [];
+    for (let index = 0; index < inputs.length; index += batchSize) {
+        const batch = inputs.slice(index, index + batchSize);
+        output.push(...(await generator(batch)));
+    }
+    return output;
+}
+export function createCachedEmbeddingGenerator(generator, maxEntries = 256) {
+    const cache = new Map();
+    return async (texts) => {
+        const missing = texts.filter((text) => !cache.has(text));
+        if (missing.length > 0) {
+            const generated = await generator(missing);
+            missing.forEach((text, index) => {
+                const vector = generated[index];
+                if (!vector)
+                    return;
+                cache.set(text, vector);
+                if (cache.size > maxEntries) {
+                    const firstKey = cache.keys().next().value;
+                    if (firstKey)
+                        cache.delete(firstKey);
+                }
+            });
+        }
+        return texts.map((text) => cache.get(text) ?? new Float32Array());
+    };
+}
+//# sourceMappingURL=resilience.js.map

package/dist/embeddings/resilience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.js","sourceRoot":"","sources":["../../src/embeddings/resilience.ts"],"names":[],"mappings":"AAEA,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAU,GAAG,CAAC,EACd,OAAO,GAAG,GAAG;IAEb,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAA6B,EAC7B,MAAgB,EAChB,SAAS,GAAG,EAAE;IAEd,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,SAA6B,EAC7B,UAAU,GAAG,GAAG;IAEhB,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEjD,OAAO,KAAK,EAAE,KAAe,EAA8B,EAAE;QAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;gBAChC,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACpB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC;oBAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;oBAC3C,IAAI,QAAQ;wBAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC"}

package/dist/embeddings/voyage.d.ts

@@ -0,0 +1,30 @@
+import type { EmbeddingGenerator } from '../contracts/embedding.js';
+export interface VoyageEmbeddingOptions {
+    /** Voyage API key. Defaults to VOYAGE_API_KEY env var. */
+    apiKey?: string;
+    /** Model to use. Defaults to 'voyage-3-lite'. */
+    model?: string;
+    /** API base URL. Defaults to 'https://api.voyageai.com/v1'. */
+    baseUrl?: string;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    batchSize?: number;
+    cacheSize?: number;
+}
+/**
+ * Creates an EmbeddingGenerator that calls the Voyage AI embeddings API.
+ * Voyage is Anthropic's recommended embedding provider.
+ *
+ * This generator uses raw HTTP (no SDK dependency) to minimize installation footprint.
+ *
+ * ```typescript
+ * import { createVoyageEmbeddingGenerator } from 'memory-layer/embeddings/voyage';
+ *
+ * const generator = createVoyageEmbeddingGenerator({
+ *   apiKey: process.env.VOYAGE_API_KEY,
+ * });
+ * const vectors = await generator(['hello world']);
+ * ```
+ */
+export declare function createVoyageEmbeddingGenerator(options?: VoyageEmbeddingOptions): EmbeddingGenerator;
+//# sourceMappingURL=voyage.d.ts.map

package/dist/embeddings/voyage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voyage.d.ts","sourceRoot":"","sources":["../../src/embeddings/voyage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,2BAA2B,CAAC;AAOrF,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,CAAC,EAAE,sBAAsB,GAC/B,kBAAkB,CA0DpB"}

package/dist/embeddings/voyage.js

@@ -0,0 +1,53 @@
+import { batchedGenerate, createCachedEmbeddingGenerator, withRetry, } from './resilience.js';
+/**
+ * Creates an EmbeddingGenerator that calls the Voyage AI embeddings API.
+ * Voyage is Anthropic's recommended embedding provider.
+ *
+ * This generator uses raw HTTP (no SDK dependency) to minimize installation footprint.
+ *
+ * ```typescript
+ * import { createVoyageEmbeddingGenerator } from 'memory-layer/embeddings/voyage';
+ *
+ * const generator = createVoyageEmbeddingGenerator({
+ *   apiKey: process.env.VOYAGE_API_KEY,
+ * });
+ * const vectors = await generator(['hello world']);
+ * ```
+ */
+export function createVoyageEmbeddingGenerator(options) {
+    const model = options?.model ?? 'voyage-3-lite';
+    const baseUrl = options?.baseUrl ?? 'https://api.voyageai.com/v1';
+    function getApiKey() {
+        const key = options?.apiKey ?? process.env.VOYAGE_API_KEY;
+        if (!key) {
+            throw new Error('memory-layer: Voyage embedding generator requires an API key. ' +
+                'Set VOYAGE_API_KEY env var or pass apiKey option.');
+        }
+        return key;
+    }
+    const baseGenerator = async (texts) => {
+        if (texts.length === 0)
+            return [];
+        const apiKey = getApiKey();
+        const response = await fetch(`${baseUrl}/embeddings`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model,
+                input: texts,
+            }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`memory-layer: Voyage API error ${response.status}: ${body}`);
+        }
+        const data = (await response.json());
+        return data.data.map((item) => new Float32Array(item.embedding));
+    };
+    const cachedGenerator = createCachedEmbeddingGenerator(baseGenerator, options?.cacheSize ?? 256);
+    return async (texts) => withRetry(() => batchedGenerate(cachedGenerator, texts, options?.batchSize ?? 32), options?.maxRetries ?? 2, options?.retryDelayMs ?? 250);
+}
+//# sourceMappingURL=voyage.js.map

package/dist/embeddings/voyage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voyage.js","sourceRoot":"","sources":["../../src/embeddings/voyage.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,GACV,MAAM,iBAAiB,CAAC;AAezB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAgC;IAEhC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,eAAe,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,6BAA6B,CAAC;IAElE,SAAS,SAAS;QAChB,MAAM,GAAG,GAAG,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,gEAAgE;gBAC9D,mDAAmD,CACtD,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,aAAa,GAAuB,KAAK,EAAE,KAAe,EAA8B,EAAE;QAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,aAAa,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,EAAE;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK;gBACL,KAAK,EAAE,KAAK;aACb,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAC7D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAC3C,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,8BAA8B,CACpD,aAAa,EACb,OAAO,EAAE,SAAS,IAAI,GAAG,CAC1B,CAAC;IAEF,OAAO,KAAK,EAAE,KAAe,EAA8B,EAAE,CAC3D,SAAS,CACP,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC,EACvE,OAAO,EAAE,UAAU,IAAI,CAAC,EACxB,OAAO,EAAE,YAAY,IAAI,GAAG,CAC7B,CAAC;AACN,CAAC"}