@theokit/sdk-memory 0.2.1 → 0.3.0

package/dist/index.js

@@ -1,9 +1,11 @@
 import { mkdir, readFile, readdir, stat, access, unlink } from 'fs/promises';
 import { join, resolve, relative } from 'path';
 import { Security } from '@theokit/sdk';
-import { replaceFileAtomic, withCwdMutex, atomicWriteJson, openSqliteResilient, sanitizeFts5Query } from '@theokit/sdk/internal/persistence';
+import { replaceFileAtomic, withCwdMutex, atomicWriteJson, openSqliteResilient, sanitizeFts5Query } from '@theokit/sdk/persistence';
 import { sanitizeIdentifier, safePathJoin } from '@theokit/sdk/path-safety';
 import { createHash } from 'crypto';
+import { createOpenAiCompatibleRuntime } from '@theokit/sdk/internal/memory-adapters';
+export { createOpenAiCompatibleRuntime } from '@theokit/sdk/internal/memory-adapters';
 import { AuthenticationError, RateLimitError, ConfigurationError, NetworkError, UnknownAgentError } from '@theokit/sdk/errors';
 import { mkdirSync, existsSync, rmSync, renameSync } from 'fs';
 import { createRequire } from 'module';
@@ -623,296 +625,85 @@ function cacheKey(userText, queryMode, ctx) {
   const parts = [queryMode, ctx?.namespace ?? "", ctx?.userId ?? "", ctx?.scope ?? "", userText];
   return createHash("sha256").update(parts.join("\0")).digest("hex");
 }
-var RAW_MAX_BYTES = 2048;
-function parseRetryAfter(headers) {
-  if (headers === void 0) return void 0;
-  const raw = headers.get("retry-after");
-  if (raw === null) return void 0;
-  const n = Number(raw);
-  if (Number.isFinite(n) && n >= 0) return Math.ceil(n);
-  return void 0;
-}
-function truncateRaw(body) {
-  if (body === null || body === void 0) return void 0;
-  const s = typeof body === "string" ? body : JSON.stringify(body);
-  const truncated = s.length <= RAW_MAX_BYTES ? s : `${s.slice(0, RAW_MAX_BYTES)}\u2026`;
-  return redactSecrets(truncated);
-}
-function buildErrorMetadata(args) {
-  const retryAfter = parseRetryAfter(args.headers);
-  const raw = truncateRaw(args.body);
-  return {
-    provider: args.provider,
-    endpoint: args.endpoint,
-    code: args.code,
-    statusCode: args.status,
-    ...retryAfter !== void 0 ? { retryAfter } : {},
-    ...raw !== void 0 ? { raw } : {}
-  };
-}
-function mapOpenAICompatibleError(args) {
-  const { providerId, status, body, headers, endpoint } = args;
-  const code = mapOpenAiStatusToCode(status, body);
-  const message = formatMessage(providerId, status, code);
-  const metadata = buildErrorMetadata({
-    provider: providerId,
-    endpoint,
-    code,
-    status,
-    headers,
-    body
-  });
-  if (status === 401 || status === 403) {
-    return new AuthenticationError(message, { code: `${providerId}_auth_failed`, metadata });
-  }
-  if (status === 429) {
-    return new RateLimitError(message, { code: `${providerId}_rate_limit`, metadata });
-  }
-  if (status === 400) {
-    return new ConfigurationError(message, { code: `${providerId}_${code}`, metadata });
-  }
-  if (status === 408) {
-    return new NetworkError(message, { code: `${providerId}_timeout`, metadata });
-  }
-  if (status >= 500 && status < 600) {
-    return new NetworkError(message, { code: `${providerId}_server_error`, metadata });
-  }
-  return new UnknownAgentError(message, { code: `${providerId}_unknown`, metadata });
-}
-function extractOpenAiErrorCode(body) {
-  if (body === null || typeof body !== "object") return void 0;
-  const err = body.error;
-  if (err === void 0 || err === null) return void 0;
-  if (typeof err.code === "string") return err.code;
-  if (typeof err.type === "string") return err.type;
-  return void 0;
-}
-function mapOpenAiStatusToCode(status, body) {
-  const rawCode = extractOpenAiErrorCode(body)?.toLowerCase() ?? "";
-  if (rawCode.includes("context_length") || rawCode.includes("context_window") || rawCode.includes("too_many_tokens") || rawCode.includes("max_tokens")) {
-    return "context_too_long";
-  }
-  if (rawCode.includes("content_filter") || rawCode.includes("content_policy") || rawCode.includes("safety")) {
-    return "content_filtered";
-  }
-  if (rawCode.includes("model_not_found") || rawCode.includes("model_unavailable") || rawCode.includes("invalid_model")) {
-    return "model_unavailable";
-  }
-  if (status === 402 || rawCode.includes("insufficient_quota") || rawCode.includes("quota_exceeded")) {
-    return "quota_exceeded";
-  }
-  if (status === 401 || status === 403) return "auth_failed";
-  if (status === 429) return "rate_limit";
-  if (status === 408) return "timeout";
-  if (status === 400) return "invalid_request";
-  if (status >= 500 && status < 600) return "server_error";
-  return "unknown";
-}
-function formatMessage(providerId, status, code) {
-  return `${providerId} API error: ${code} (HTTP ${status})`;
-}
 
-// src/internal/embedding/embedding-cache.ts
-var LruEmbeddingCache = class {
-  constructor(capacity = 5e3) {
-    this.capacity = capacity;
-  }
-  capacity;
-  map = /* @__PURE__ */ new Map();
-  get(key) {
-    const value = this.map.get(key);
-    if (value === void 0) return void 0;
-    this.map.delete(key);
-    this.map.set(key, value);
-    return value;
-  }
-  set(key, value) {
-    if (this.map.has(key)) this.map.delete(key);
-    else if (this.map.size >= this.capacity) {
-      const oldest = this.map.keys().next().value;
-      if (oldest !== void 0) this.map.delete(oldest);
-    }
-    this.map.set(key, value);
-  }
-  size() {
-    return this.map.size;
-  }
+// src/internal/embedding/azure-openai-embedding.ts
+var DEFAULT_AZURE_OPENAI_EMBEDDING_MODEL = "text-embedding-3-small";
+var DIMENSION_BY_MODEL = {
+  "text-embedding-3-small": 1536,
+  "text-embedding-3-large": 3072,
+  "text-embedding-ada-002": 1536
 };
-
-// src/internal/embedding/openai-compatible.ts
-var MAX_BATCH = 100;
-var MAX_RETRIES = 2;
-async function createOpenAiCompatibleRuntime(cfg, options) {
-  const model = options.model ?? cfg.defaultModel;
-  const apiKey = options.apiKey ?? process.env[cfg.apiKeyEnv];
-  if (apiKey === void 0 || apiKey.length === 0) {
-    throw new AuthenticationError(`${cfg.apiKeyEnv} missing`, {
-      code: "embedding_missing_api_key"
-    });
-  }
-  const envBaseUrl = cfg.baseUrlEnv !== void 0 ? process.env[cfg.baseUrlEnv] : void 0;
-  const baseUrl = options.baseUrl ?? envBaseUrl ?? cfg.defaultBaseUrl;
-  const fetchImpl = options.fetch ?? fetch;
-  const cache = options.cache ?? new LruEmbeddingCache();
-  const dimension = cfg.dimensionByModel[model];
-  if (dimension === void 0) {
-    throw new ConfigurationError(
-      `${cfg.id} adapter: model "${model}" is not in the dimension table. Use one of: ${Object.keys(cfg.dimensionByModel).join(", ")}. To add it, update dimensionByModel in the adapter source.`,
-      { code: "embedding_unknown_model" }
-    );
-  }
-  const embeddingsPath = cfg.embeddingsPath ?? "/v1/embeddings";
-  const stats = {
-    cacheHits: 0,
-    cacheMisses: 0,
-    httpCalls: 0,
-    retries: 0
-  };
-  return {
-    id: cfg.id,
-    model,
-    dimension,
-    stats: () => ({ ...stats }),
-    embed: (texts) => embedTexts({
-      texts,
-      cache,
-      stats,
-      model,
-      dimension,
-      apiKey,
-      baseUrl,
-      embeddingsPath,
-      fetchImpl,
-      providerId: cfg.id
-    })
-  };
-}
-async function embedTexts(input) {
-  const { texts, cache, stats, model, dimension } = input;
-  const results = new Array(texts.length);
-  const pending = [];
-  for (let i = 0; i < texts.length; i++) {
-    classifyEntry({
-      index: i,
-      text: texts[i] ?? "",
-      model,
-      dimension,
-      cache,
-      stats,
-      results,
-      pending
-    });
-  }
-  await runBatches(input, pending, results);
-  return results.map((v) => v ?? new Array(dimension).fill(0));
-}
-function classifyEntry(args) {
-  if (args.text.trim().length === 0) {
-    args.results[args.index] = new Array(args.dimension).fill(0);
-    return;
-  }
-  const key = hashKey(args.model, args.text);
-  const cached = args.cache.get(key);
-  if (cached !== void 0) {
-    args.stats.cacheHits += 1;
-    args.results[args.index] = cached;
-    return;
-  }
-  args.stats.cacheMisses += 1;
-  args.pending.push({ index: args.index, text: args.text, key });
-}
-async function runBatches(input, pending, results) {
-  for (let offset = 0; offset < pending.length; offset += MAX_BATCH) {
-    const batch = pending.slice(offset, offset + MAX_BATCH);
-    const vectors = await embedBatch({
-      apiKey: input.apiKey,
-      baseUrl: input.baseUrl,
-      embeddingsPath: input.embeddingsPath,
-      model: input.model,
-      inputs: batch.map((b) => b.text),
-      fetchImpl: input.fetchImpl,
-      stats: input.stats,
-      providerId: input.providerId
-    });
-    for (let j = 0; j < batch.length; j++) {
-      const slot = batch[j];
-      const vector = vectors[j];
-      if (slot === void 0 || vector === void 0) continue;
-      results[slot.index] = vector;
-      input.cache.set(slot.key, vector);
-    }
-  }
-}
-async function embedBatch(opts) {
-  const url = `${opts.baseUrl.replace(/\/$/, "")}${opts.embeddingsPath}`;
-  let attempt = 0;
-  while (true) {
-    opts.stats.httpCalls += 1;
-    const response = await postEmbedRequest(opts, url);
-    if (response.ok)
-      return await parseEmbedResponse(response, opts.providerId, opts.embeddingsPath);
-    if (isRetryable(response.status) && attempt < MAX_RETRIES) {
-      attempt += 1;
-      opts.stats.retries += 1;
-      await sleep(linearBackoffMs(attempt));
-      continue;
-    }
-    const text = await response.text().catch(() => "");
-    let body = text;
-    try {
-      body = JSON.parse(text);
-    } catch {
-    }
-    throw mapOpenAICompatibleError({
-      providerId: opts.providerId,
-      status: response.status,
-      body,
-      headers: response.headers,
-      endpoint: opts.embeddingsPath
-    });
-  }
-}
-async function postEmbedRequest(opts, url) {
-  return opts.fetchImpl(url, {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-      authorization: `Bearer ${opts.apiKey}`
+var azureOpenAiMemoryEmbeddingProviderAdapter = {
+  id: "azure-openai",
+  defaultModel: DEFAULT_AZURE_OPENAI_EMBEDDING_MODEL,
+  transport: "remote",
+  authProviderId: "azure-openai",
+  autoSelectPriority: 25,
+  create: (options) => createOpenAiCompatibleRuntime(
+    {
+      id: "azure-openai",
+      defaultBaseUrl: "https://your-resource.openai.azure.com",
+      apiKeyEnv: "AZURE_OPENAI_API_KEY",
+      baseUrlEnv: "AZURE_OPENAI_ENDPOINT",
+      defaultModel: DEFAULT_AZURE_OPENAI_EMBEDDING_MODEL,
+      embeddingsPath: "/openai/deployments/{model}/embeddings?api-version=2024-02-01",
+      dimensionByModel: DIMENSION_BY_MODEL,
+      // theokit#159 — Azure is NOT OpenAI on the wire, despite the name. It authenticates an API
+      // key with the `api-key` header (`Authorization: Bearer` is for Entra ID tokens, not for
+      // AZURE_OPENAI_API_KEY), and the deployment already rides in the path, so `model` has no
+      // place in the body. Sending the OpenAI shape meant every request was rejected.
+      dialect: {
+        authHeaders: (apiKey) => ({ "api-key": apiKey }),
+        body: (_model, inputs) => ({ input: inputs })
+      }
     },
-    body: JSON.stringify({ model: opts.model, input: opts.inputs })
-  });
-}
-async function parseEmbedResponse(response, providerId, endpoint) {
-  const json = await response.json();
-  if (!Array.isArray(json.data)) {
-    throw new NetworkError(`${providerId} ${endpoint} returned no data`, {
-      code: "embedding_invalid_response",
-      metadata: {
-        provider: providerId,
-        endpoint,
-        code: "invalid_request",
-        raw: json
+    options
+  )
+};
+
+// src/internal/embedding/cohere-embedding.ts
+var DEFAULT_COHERE_EMBEDDING_MODEL = "embed-english-v3.0";
+var DIMENSION_BY_MODEL2 = {
+  "embed-english-v3.0": 1024,
+  "embed-multilingual-v3.0": 1024,
+  "embed-english-light-v3.0": 384,
+  "embed-multilingual-light-v3.0": 384
+};
+var cohereMemoryEmbeddingProviderAdapter = {
+  id: "cohere",
+  defaultModel: DEFAULT_COHERE_EMBEDDING_MODEL,
+  transport: "remote",
+  authProviderId: "cohere",
+  autoSelectPriority: 30,
+  create: (options) => createOpenAiCompatibleRuntime(
+    {
+      id: "cohere",
+      defaultBaseUrl: "https://api.cohere.com",
+      apiKeyEnv: "COHERE_API_KEY",
+      defaultModel: DEFAULT_COHERE_EMBEDDING_MODEL,
+      embeddingsPath: "/v2/embed",
+      dimensionByModel: DIMENSION_BY_MODEL2,
+      // theokit#159 — `/v2/embed` diverges in BOTH directions: it names the payload `texts`, requires
+      // `input_type`, and answers `{embeddings:{float:[[...]]}}` rather than `{data:[{embedding}]}`.
+      // `search_document` is the right default here because this runtime embeds material for
+      // storage; a query-side embedder would use `search_query`.
+      dialect: {
+        body: (model, inputs) => ({
+          model,
+          texts: [...inputs],
+          input_type: "search_document",
+          embedding_types: ["float"]
+        }),
+        vectors: (json) => json.embeddings?.float
       }
-    });
-  }
-  return json.data.map((d) => d.embedding);
-}
-function isRetryable(status) {
-  return status === 429 || status >= 500 && status < 600;
-}
-function hashKey(model, text) {
-  return createHash("sha256").update(`${model} ${text}`).digest("hex");
-}
-function linearBackoffMs(attempt) {
-  return 50 * attempt;
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
+    },
+    options
+  )
+};
 
 // src/internal/embedding/deepinfra-embedding.ts
 var DEFAULT_DEEPINFRA_EMBEDDING_MODEL = "BAAI/bge-large-en-v1.5";
-var DIMENSION_BY_MODEL = {
+var DIMENSION_BY_MODEL3 = {
   "BAAI/bge-large-en-v1.5": 1024,
   "BAAI/bge-base-en-v1.5": 768,
   "BAAI/bge-small-en-v1.5": 384,
@@ -937,16 +728,68 @@ var deepinfraMemoryEmbeddingProviderAdapter = {
       apiKeyEnv: "DEEPINFRA_API_KEY",
       baseUrlEnv: "DEEPINFRA_API_BASE_URL",
       defaultModel: DEFAULT_DEEPINFRA_EMBEDDING_MODEL,
-      dimensionByModel: DIMENSION_BY_MODEL,
+      dimensionByModel: DIMENSION_BY_MODEL3,
       embeddingsPath: "/v1/openai/embeddings"
     },
     options
   )
 };
 
+// src/internal/embedding/gemini-embedding.ts
+var DEFAULT_GEMINI_EMBEDDING_MODEL = "text-embedding-004";
+var DIMENSION_BY_MODEL4 = {
+  "text-embedding-004": 768,
+  "embedding-001": 768
+};
+var geminiMemoryEmbeddingProviderAdapter = {
+  id: "gemini",
+  defaultModel: DEFAULT_GEMINI_EMBEDDING_MODEL,
+  transport: "remote",
+  authProviderId: "gemini",
+  autoSelectPriority: 30,
+  create: (options) => createOpenAiCompatibleRuntime(
+    {
+      id: "gemini",
+      defaultBaseUrl: "https://generativelanguage.googleapis.com",
+      apiKeyEnv: "GEMINI_API_KEY",
+      defaultModel: DEFAULT_GEMINI_EMBEDDING_MODEL,
+      // theokit#159 — the compat surface is under `/v1beta/openai/`, not the default
+      // `/v1/embeddings`; the previous path 404'd on every call.
+      embeddingsPath: "/v1beta/openai/embeddings",
+      dimensionByModel: DIMENSION_BY_MODEL4
+    },
+    options
+  )
+};
+
+// src/internal/embedding/jina-embedding.ts
+var DEFAULT_JINA_EMBEDDING_MODEL = "jina-embeddings-v3";
+var DIMENSION_BY_MODEL5 = {
+  "jina-embeddings-v3": 1024,
+  "jina-embeddings-v2-base-en": 768,
+  "jina-embeddings-v2-small-en": 512
+};
+var jinaMemoryEmbeddingProviderAdapter = {
+  id: "jina",
+  defaultModel: DEFAULT_JINA_EMBEDDING_MODEL,
+  transport: "remote",
+  authProviderId: "jina",
+  autoSelectPriority: 35,
+  create: (options) => createOpenAiCompatibleRuntime(
+    {
+      id: "jina",
+      defaultBaseUrl: "https://api.jina.ai",
+      apiKeyEnv: "JINA_API_KEY",
+      defaultModel: DEFAULT_JINA_EMBEDDING_MODEL,
+      dimensionByModel: DIMENSION_BY_MODEL5
+    },
+    options
+  )
+};
+
 // src/internal/embedding/mistral-embedding.ts
 var DEFAULT_MISTRAL_EMBEDDING_MODEL = "mistral-embed";
-var DIMENSION_BY_MODEL2 = {
+var DIMENSION_BY_MODEL6 = {
   "mistral-embed": 1024
 };
 var mistralMemoryEmbeddingProviderAdapter = {
@@ -962,7 +805,7 @@ var mistralMemoryEmbeddingProviderAdapter = {
       apiKeyEnv: "MISTRAL_API_KEY",
       baseUrlEnv: "MISTRAL_API_BASE_URL",
       defaultModel: DEFAULT_MISTRAL_EMBEDDING_MODEL,
-      dimensionByModel: DIMENSION_BY_MODEL2
+      dimensionByModel: DIMENSION_BY_MODEL6
     },
     options
   )
@@ -971,7 +814,7 @@ var mistralMemoryEmbeddingProviderAdapter = {
 // src/internal/embedding/ollama-embedding.ts
 var DEFAULT_OLLAMA_EMBEDDING_MODEL = "nomic-embed-text";
 var OLLAMA_LOCAL_SENTINEL_KEY = "ollama-local";
-var DIMENSION_BY_MODEL3 = {
+var DIMENSION_BY_MODEL7 = {
   // Nomic — local default, recommended quality/size balance.
   "nomic-embed-text": 768,
   "nomic-embed-text:latest": 768,
@@ -1004,7 +847,7 @@ var ollamaMemoryEmbeddingProviderAdapter = {
         apiKeyEnv: "OLLAMA_API_KEY",
         baseUrlEnv: "OLLAMA_HOST",
         defaultModel: DEFAULT_OLLAMA_EMBEDDING_MODEL,
-        dimensionByModel: DIMENSION_BY_MODEL3
+        dimensionByModel: DIMENSION_BY_MODEL7
       },
       { ...options, apiKey }
     );
@@ -1013,7 +856,7 @@ var ollamaMemoryEmbeddingProviderAdapter = {
 
 // src/internal/embedding/openai-embedding.ts
 var DEFAULT_OPENAI_EMBEDDING_MODEL = "text-embedding-3-small";
-var DIMENSION_BY_MODEL4 = {
+var DIMENSION_BY_MODEL8 = {
   "text-embedding-3-small": 1536,
   "text-embedding-3-large": 3072,
   "text-embedding-ada-002": 1536
@@ -1031,7 +874,7 @@ var openAiMemoryEmbeddingProviderAdapter = {
       apiKeyEnv: "OPENAI_API_KEY",
       baseUrlEnv: "OPENAI_API_BASE_URL",
       defaultModel: DEFAULT_OPENAI_EMBEDDING_MODEL,
-      dimensionByModel: DIMENSION_BY_MODEL4
+      dimensionByModel: DIMENSION_BY_MODEL8
     },
     options
   )
@@ -1039,7 +882,7 @@ var openAiMemoryEmbeddingProviderAdapter = {
 
 // src/internal/embedding/openrouter-embedding.ts
 var DEFAULT_OPENROUTER_EMBEDDING_MODEL = "openai/text-embedding-3-small";
-var DIMENSION_BY_MODEL5 = {
+var DIMENSION_BY_MODEL9 = {
   "openai/text-embedding-3-small": 1536,
   "openai/text-embedding-3-large": 3072,
   "openai/text-embedding-ada-002": 1536,
@@ -1058,7 +901,7 @@ var openRouterMemoryEmbeddingProviderAdapter = {
       apiKeyEnv: "OPENROUTER_API_KEY",
       baseUrlEnv: "OPENROUTER_API_BASE_URL",
       defaultModel: DEFAULT_OPENROUTER_EMBEDDING_MODEL,
-      dimensionByModel: DIMENSION_BY_MODEL5
+      dimensionByModel: DIMENSION_BY_MODEL9
     },
     options
   )
@@ -1066,7 +909,7 @@ var openRouterMemoryEmbeddingProviderAdapter = {
 
 // src/internal/embedding/voyage-embedding.ts
 var DEFAULT_VOYAGE_EMBEDDING_MODEL = "voyage-3-lite";
-var DIMENSION_BY_MODEL6 = {
+var DIMENSION_BY_MODEL10 = {
   "voyage-3-lite": 512,
   "voyage-3": 1024,
   "voyage-3-large": 1024,
@@ -1086,7 +929,7 @@ var voyageMemoryEmbeddingProviderAdapter = {
       apiKeyEnv: "VOYAGE_API_KEY",
       baseUrlEnv: "VOYAGE_API_BASE_URL",
       defaultModel: DEFAULT_VOYAGE_EMBEDDING_MODEL,
-      dimensionByModel: DIMENSION_BY_MODEL6
+      dimensionByModel: DIMENSION_BY_MODEL10
     },
     options
   )
@@ -1099,8 +942,101 @@ var MEMORY_EMBEDDING_ADAPTERS = {
   openrouter: openRouterMemoryEmbeddingProviderAdapter,
   voyage: voyageMemoryEmbeddingProviderAdapter,
   deepinfra: deepinfraMemoryEmbeddingProviderAdapter,
-  ollama: ollamaMemoryEmbeddingProviderAdapter
+  ollama: ollamaMemoryEmbeddingProviderAdapter,
+  // theokit#128 — mirrors sdk-core's T4.10 additions, which the peer had drifted behind.
+  "azure-openai": azureOpenAiMemoryEmbeddingProviderAdapter,
+  cohere: cohereMemoryEmbeddingProviderAdapter,
+  jina: jinaMemoryEmbeddingProviderAdapter,
+  gemini: geminiMemoryEmbeddingProviderAdapter
 };
+var RAW_MAX_BYTES = 2048;
+function parseRetryAfter(headers) {
+  if (headers === void 0) return void 0;
+  const raw = headers.get("retry-after");
+  if (raw === null) return void 0;
+  const n = Number(raw);
+  if (Number.isFinite(n) && n >= 0) return Math.ceil(n);
+  return void 0;
+}
+function truncateRaw(body) {
+  if (body === null || body === void 0) return void 0;
+  const s = typeof body === "string" ? body : JSON.stringify(body);
+  const truncated = s.length <= RAW_MAX_BYTES ? s : `${s.slice(0, RAW_MAX_BYTES)}\u2026`;
+  return redactSecrets(truncated);
+}
+function buildErrorMetadata(args) {
+  const retryAfter = parseRetryAfter(args.headers);
+  const raw = truncateRaw(args.body);
+  return {
+    provider: args.provider,
+    endpoint: args.endpoint,
+    code: args.code,
+    statusCode: args.status,
+    ...retryAfter !== void 0 ? { retryAfter } : {},
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function mapOpenAICompatibleError(args) {
+  const { providerId, status, body, headers, endpoint } = args;
+  const code = mapOpenAiStatusToCode(status, body);
+  const message = formatMessage(providerId, status, code);
+  const metadata = buildErrorMetadata({
+    provider: providerId,
+    endpoint,
+    code,
+    status,
+    headers,
+    body
+  });
+  if (status === 401 || status === 403) {
+    return new AuthenticationError(message, { code: `${providerId}_auth_failed`, metadata });
+  }
+  if (status === 429) {
+    return new RateLimitError(message, { code: `${providerId}_rate_limit`, metadata });
+  }
+  if (status === 400) {
+    return new ConfigurationError(message, { code: `${providerId}_${code}`, metadata });
+  }
+  if (status === 408) {
+    return new NetworkError(message, { code: `${providerId}_timeout`, metadata });
+  }
+  if (status >= 500 && status < 600) {
+    return new NetworkError(message, { code: `${providerId}_server_error`, metadata });
+  }
+  return new UnknownAgentError(message, { code: `${providerId}_unknown`, metadata });
+}
+function extractOpenAiErrorCode(body) {
+  if (body === null || typeof body !== "object") return void 0;
+  const err = body.error;
+  if (err === void 0 || err === null) return void 0;
+  if (typeof err.code === "string") return err.code;
+  if (typeof err.type === "string") return err.type;
+  return void 0;
+}
+function mapOpenAiStatusToCode(status, body) {
+  const rawCode = extractOpenAiErrorCode(body)?.toLowerCase() ?? "";
+  if (rawCode.includes("context_length") || rawCode.includes("context_window") || rawCode.includes("too_many_tokens") || rawCode.includes("max_tokens")) {
+    return "context_too_long";
+  }
+  if (rawCode.includes("content_filter") || rawCode.includes("content_policy") || rawCode.includes("safety")) {
+    return "content_filtered";
+  }
+  if (rawCode.includes("model_not_found") || rawCode.includes("model_unavailable") || rawCode.includes("invalid_model")) {
+    return "model_unavailable";
+  }
+  if (status === 402 || rawCode.includes("insufficient_quota") || rawCode.includes("quota_exceeded")) {
+    return "quota_exceeded";
+  }
+  if (status === 401 || status === 403) return "auth_failed";
+  if (status === 429) return "rate_limit";
+  if (status === 408) return "timeout";
+  if (status === 400) return "invalid_request";
+  if (status >= 500 && status < 600) return "server_error";
+  return "unknown";
+}
+function formatMessage(providerId, status, code) {
+  return `${providerId} API error: ${code} (HTTP ${status})`;
+}
 var FACTS_HEADING2 = "## Facts";
 function createCategorizedMemory(options) {
   const { root, categories } = options;
@@ -1463,11 +1399,6 @@ var SCHEMA_STATEMENTS = [
    )`,
   `CREATE INDEX IF NOT EXISTS idx_chunks_file_id ON chunks(file_id)`
 ];
-var MIGRATION_V2_STATEMENTS = [
-  "ALTER TABLE chunks ADD COLUMN created_at INTEGER",
-  "ALTER TABLE chunks ADD COLUMN importance REAL DEFAULT 0.5",
-  "ALTER TABLE chunks ADD COLUMN scope TEXT DEFAULT '/'"
-];
 var PRAGMA_STATEMENTS = [
   "PRAGMA synchronous=NORMAL",
   "PRAGMA foreign_keys=ON"
@@ -2594,6 +2525,6 @@ function isPathInside(root, candidate) {
   return candidate === root || candidate.startsWith(normalizedRoot);
 }
 
-export { ActiveMemoryCache, CircuitBreaker, DEFAULT_DEEPINFRA_EMBEDDING_MODEL, DEFAULT_MEMORY_READ_LINES, DEFAULT_MISTRAL_EMBEDDING_MODEL, DEFAULT_OLLAMA_EMBEDDING_MODEL, DEFAULT_OPENAI_EMBEDDING_MODEL, DEFAULT_OPENROUTER_EMBEDDING_MODEL, DEFAULT_VOYAGE_EMBEDDING_MODEL, IndexManager, LanceIndex, LanceMemoryAdapter, MEMORY_EMBEDDING_ADAPTERS, META_KEY_DIMENSION, META_KEY_MODEL, META_KEY_PROVIDER_ID, MIGRATION_V2_STATEMENTS, PRAGMA_STATEMENTS, SCHEMA_STATEMENTS, VALID_BACKENDS, appendDiaryEntry, appendFact, appendFactToMarkdown, assertValidBackend, buildErrorMetadata, chunkMarkdown, createCategorizedMemory, createInMemoryMarkdownProvider, createMemoryGetTool, createMemorySearchTool, createOpenAiCompatibleRuntime, createVectorIndex, deepPhase, deepinfraMemoryEmbeddingProviderAdapter, defaultIndexPath, diaryPath, discoverSessionFiles, discoverWikiFiles, dropVectorIndex, embedMissingChunks, entryHash, identityMatches, isLanceAvailable, isSqliteVecLoaded, lanceStoragePath, legacyMemoryJsonPath, lightPhase, listNotes, loadSqliteVecExtension, mapOpenAICompatibleError, memoryDir, memoryMdPath, migrateLegacyJson, migrateSqliteToLance, mistralMemoryEmbeddingProviderAdapter, notesDir, ollamaMemoryEmbeddingProviderAdapter, openAiMemoryEmbeddingProviderAdapter, openLanceIndex, openMemoryDb, openRouterMemoryEmbeddingProviderAdapter, packVector, parseRetryAfter, parseSearchOptions, persistActiveMemoryTranscript, readEmbeddingIdentity, readFacts, readFactsFromMarkdown, readMemoryFileBounded, redactSecrets, remPhase, renderDiaryEntry, resetMigrationStateForTests, runActiveMemory, runDreamingSweep, sessionSummaryPath, sessionsDir, truncateRaw, upsertEmbedding, vectorSearch, voyageMemoryEmbeddingProviderAdapter, wikiDir, writeEmbeddingIdentity, writeSessionSummary };
+export { ActiveMemoryCache, CircuitBreaker, DEFAULT_AZURE_OPENAI_EMBEDDING_MODEL, DEFAULT_COHERE_EMBEDDING_MODEL, DEFAULT_DEEPINFRA_EMBEDDING_MODEL, DEFAULT_GEMINI_EMBEDDING_MODEL, DEFAULT_JINA_EMBEDDING_MODEL, DEFAULT_MEMORY_READ_LINES, DEFAULT_MISTRAL_EMBEDDING_MODEL, DEFAULT_OLLAMA_EMBEDDING_MODEL, DEFAULT_OPENAI_EMBEDDING_MODEL, DEFAULT_OPENROUTER_EMBEDDING_MODEL, DEFAULT_VOYAGE_EMBEDDING_MODEL, IndexManager, LanceIndex, LanceMemoryAdapter, MEMORY_EMBEDDING_ADAPTERS, META_KEY_DIMENSION, META_KEY_MODEL, META_KEY_PROVIDER_ID, PRAGMA_STATEMENTS, SCHEMA_STATEMENTS, VALID_BACKENDS, appendDiaryEntry, appendFact, appendFactToMarkdown, assertValidBackend, azureOpenAiMemoryEmbeddingProviderAdapter, buildErrorMetadata, chunkMarkdown, cohereMemoryEmbeddingProviderAdapter, createCategorizedMemory, createInMemoryMarkdownProvider, createMemoryGetTool, createMemorySearchTool, createVectorIndex, deepPhase, deepinfraMemoryEmbeddingProviderAdapter, defaultIndexPath, diaryPath, discoverSessionFiles, discoverWikiFiles, dropVectorIndex, embedMissingChunks, entryHash, geminiMemoryEmbeddingProviderAdapter, identityMatches, isLanceAvailable, isSqliteVecLoaded, jinaMemoryEmbeddingProviderAdapter, lanceStoragePath, legacyMemoryJsonPath, lightPhase, listNotes, loadSqliteVecExtension, mapOpenAICompatibleError, memoryDir, memoryMdPath, migrateLegacyJson, migrateSqliteToLance, mistralMemoryEmbeddingProviderAdapter, notesDir, ollamaMemoryEmbeddingProviderAdapter, openAiMemoryEmbeddingProviderAdapter, openLanceIndex, openMemoryDb, openRouterMemoryEmbeddingProviderAdapter, packVector, parseRetryAfter, parseSearchOptions, persistActiveMemoryTranscript, readEmbeddingIdentity, readFacts, readFactsFromMarkdown, readMemoryFileBounded, redactSecrets, remPhase, renderDiaryEntry, resetMigrationStateForTests, runActiveMemory, runDreamingSweep, sessionSummaryPath, sessionsDir, truncateRaw, upsertEmbedding, vectorSearch, voyageMemoryEmbeddingProviderAdapter, wikiDir, writeEmbeddingIdentity, writeSessionSummary };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map