formative-memory 0.2.1 → 0.3.0

package/README.md

@@ -158,8 +158,8 @@ Configuration goes in `openclaw.json` under the plugin entry:
 | `autoRecall` | `true` | Inject relevant memories into context before every response |
 | `autoCapture` | `true` | Automatically capture conversations for consolidation |
 | `requireEmbedding` | `true` | Require a working embedding provider. Set `false` to allow BM25-only fallback |
-| `embedding.provider` | `"auto"` | Embedding provider: `auto`, `openai`, `gemini`, `voyage`, `mistral`, `ollama`, `local` |
-| `embedding.model` | — | Override the provider's default embedding model |
+| `embedding.provider` | `"auto"` | Embedding provider: `auto`, `openai`, `gemini`. Additional providers (`voyage`, `mistral`, `ollama`, `local`) are also accepted when memory-core embedding adapters are installed as a fallback registry |
+| `embedding.model` | — | Override the provider's default embedding model. Only takes effect with an explicit `embedding.provider` — ignored in `"auto"` mode to avoid passing a provider-specific model name to the wrong provider |
 | `dbPath` | `~/.openclaw/memory/associative` | SQLite database location |
 | `verbose` | `false` | Enable debug logging |
 | `logQueries` | `false` | Include raw query text in debug logs (disabled by default for privacy) |
@@ -169,6 +169,40 @@ your configured API keys. When `requireEmbedding` is `true` (the
 default), the plugin will not start without a working embedding provider.
 Set it to `false` to allow graceful degradation to keyword-only search.
 
+### API Keys
+
+API keys are read from OpenClaw's `auth-profiles.json`. Environment
+variables are **not** used. Configure a profile under the standard
+OpenClaw setup:
+
+```json
+{
+  "version": 1,
+  "profiles": {
+    "openai:default": { "type": "api_key", "key": "sk-..." },
+    "google:default": { "type": "api_key", "key": "AIza..." }
+  }
+}
+```
+
+The `openai:default` and `google:default` profile names are picked up
+automatically. If you have multiple profiles for the same provider
+(e.g. `openai:work` and `openai:personal`), the plugin warns and picks
+the first one — add a `:default` profile to select explicitly.
+
+### Provider pinning
+
+The plugin pins the selected provider and model to the database on
+first successful resolution. On subsequent runs, the same provider and
+model are used regardless of `embedding.provider` in config — this
+prevents silent drift that would corrupt the vector store when a
+different provider (producing different-dimension vectors) takes over.
+
+If you intentionally want to switch providers or models for an
+existing database, you must re-embed all memories via migration.
+Attempting to change the configured provider mid-life produces a
+clear error at startup rather than silent corruption.
+
 ## Architecture
 
 ```
@@ -190,8 +224,10 @@ OpenClaw Runtime
 **Storage:** SQLite with FTS5 for full-text search. Single file, no
 external services.
 
-**Embedding:** Auto-detected from configured API keys. Supports OpenAI,
-Gemini, Voyage, Mistral, Ollama. Circuit breaker with graceful fallback
+**Embedding:** Standalone fetch-based clients for OpenAI and Gemini
+read keys from `auth-profiles.json`. Additional providers (Voyage,
+Mistral, Ollama, local) resolve through memory-core's embedding
+adapter registry when installed. Circuit breaker with graceful fallback
 to keyword-only search when `requireEmbedding` is `false`.
 
 **Consolidation LLM:** Uses Anthropic (Claude) or OpenAI for memory

package/dist/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import { n as MemorySourceGuard, r as TemporalStateGuard, t as MemoryDatabase } from "./db-D1Sc76VE.js";
+import { n as MemorySourceGuard, r as TemporalStateGuard, t as MemoryDatabase } from "./db-Cqpy00Ox.js";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+
 //#region src/cli.ts
 /**
 * Associative Memory CLI
@@ -516,5 +517,6 @@ List filters:
   --limit <n>          Max results (default: 50)
 `.trim());
 }
+
 //#endregion
-export {};
+export {  };

package/dist/{db-D1Sc76VE.js → db-Cqpy00Ox.js}

@@ -1,4 +1,5 @@
 import { DatabaseSync } from "node:sqlite";
+
 //#region src/types.ts
 const TEMPORAL_STATES = [
 	"future",
@@ -50,6 +51,7 @@ function assertIsoUtcTimestamp(v, label) {
 	if (typeof v !== "string" || !ISO_UTC_RE.test(v)) throw new Error(`Invalid ${label}: expected ISO-8601 UTC timestamp, got ${String(v)}`);
 	if (!Number.isFinite(Date.parse(v))) throw new Error(`Invalid ${label}: unparseable calendar date ${v}`);
 }
+
 //#endregion
 //#region src/db.ts
 /**
@@ -625,5 +627,6 @@ var MemoryDatabase = class {
 		this.db.close();
 	}
 };
+
 //#endregion
-export { MemorySourceGuard as n, TemporalStateGuard as r, MemoryDatabase as t };
+export { MemorySourceGuard as n, TemporalStateGuard as r, MemoryDatabase as t };