@theokit/sdk-memory 0.2.2 → 0.3.0

package/dist/internal/active-memory/active-memory-cache.d.ts

@@ -2,7 +2,7 @@ import type { ActiveMemoryResult } from "./active-memory-types.js";
 /**
  * TTL-bounded cache for `runActiveMemory` results. Keyed by
  * `sha256(userText + queryMode)` so two identical sends within `cacheTtlMs`
- * (default 15s, matching OpenClaw's `DEFAULT_CACHE_TTL_MS`) share a single
+ * (default 15s, matching peer-project's `DEFAULT_CACHE_TTL_MS`) share a single
  * search.
  *
  * Bounded size; oldest entries evicted first when capacity is exceeded.

package/dist/internal/active-memory/active-memory.d.ts

@@ -1,12 +1,12 @@
 /**
- * Active Memory blocking recall (ADR D6 of memory-system-openclaw-parity).
+ * Active Memory blocking recall (ADR D6 of memory-system-peer-project-parity).
  *
  * Runs BEFORE `agent.send()` assembles the system prompt. Issues a direct
  * call to `IndexManager.search` with the user message (and optional recent
  * turns per `queryMode`).
  *
  * Returns a `summary` string capped at `maxSummaryChars` (default 220 to
- * match OpenClaw's `DEFAULT_MAX_SUMMARY_CHARS`) which the system-prompt
+ * match peer-project's `DEFAULT_MAX_SUMMARY_CHARS`) which the system-prompt
  * pipeline prepends as a `<active-memory>` block (priority 5).
  *
  * Iter 75 (Stage 3 source-move #38, FINAL move): hybrid copy from

package/dist/internal/active-memory/composite-scorer.d.ts

@@ -1,7 +1,7 @@
 /**
  * Composite scoring — blends semantic, text, recency, and importance signals.
  *
- * Inspired by CrewAI's `unified_memory.py` composite scoring (lines 345-381).
+ * Inspired by a peer project's `unified_memory.py` composite scoring (lines 345-381).
  * Default weights: semantic 0.5, text 0.2, recency 0.2, importance 0.1.
  * Backward-compatible: old behavior reproduced with {recencyWeight:0, importanceWeight:0}.
  *

package/dist/internal/active-memory/query-analyzer.d.ts

@@ -1,7 +1,7 @@
 /**
  * Query analyzer — LLM-driven sub-query distillation for complex queries.
  *
- * Inspired by CrewAI's `recall_flow.py`. Opt-in: short queries (≤250 chars)
+ * Inspired by a peer project's `recall_flow.py`. Opt-in: short queries (≤250 chars)
  * pass through unchanged. Per ADR D3.
  *
  * @internal

package/dist/internal/adapter-catalog.d.ts

@@ -16,67 +16,36 @@
  * `adapter-catalog.ts` in sdk-memory to disambiguate from the broader
  * "catalog" notion at the package barrel level.
  *
- * **CLOSES the embedding-adapter cluster in sdk-memory.** All 7
- * provider adapters + the shared OpenAI-compatible runtime + the
- * inlined HTTP error mapper are now canonical:
+ * **This catalog must serve every provider sdk-core ADVERTISES** (theokit#128). When the peer is
+ * installed it REPLACES core's catalog in the routing path (`sdk/src/memory.ts`), while the public
+ * `Theokit.inspect.embeddingAdapters()` keeps listing core's — so any id core has and this one
+ * lacks is a provider the SDK promises and then rejects. That is what happened to `azure-openai`,
+ * `cohere`, `jina` and `gemini` for the two months between core's T4.10 and the parity fix.
+ * The invariant is enforced by `@theokit/sdk-peer-integration-tests` (`peer-parity.test.ts`).
+ *
+ * **CLOSES the embedding-adapter cluster in sdk-memory.** The provider adapters + the shared
+ * OpenAI-compatible runtime + the inlined HTTP error mapper are canonical here:
  * - iter 45: embedding-adapter (types)
- * - iter 46: embedding-cache (LRU)
+ * - iter 46: embedding-cache (LRU) — REMOVED by theokit#160: the shared runtime owns caching now
  * - iter 73: openai-compatible (shared factory) + adapter-http-error
  *   (inlined mapper)
  * - iter 74: openai-embedding + mistral-embedding + deepinfra-embedding
  *   + voyage-embedding + openrouter-embedding + ollama-embedding +
  *   adapter-catalog (THIS)
+ * - theokit#128: azure-openai + cohere + jina + gemini (parity with core's T4.10)
  *
  * @internal
  */
 export declare const MEMORY_EMBEDDING_ADAPTERS: {
-    openai: {
-        id: string;
-        defaultModel: string;
-        transport: "remote";
-        authProviderId: string;
-        autoSelectPriority: number;
-        create: (options: Parameters<typeof import("./embedding/openai-compatible.js").createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding/embedding-adapter.js").EmbeddingRuntime>;
-    };
-    mistral: {
-        id: string;
-        defaultModel: string;
-        transport: "remote";
-        authProviderId: string;
-        autoSelectPriority: number;
-        create: (options: Parameters<typeof import("./embedding/openai-compatible.js").createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding/embedding-adapter.js").EmbeddingRuntime>;
-    };
-    openrouter: {
-        id: string;
-        defaultModel: string;
-        transport: "remote";
-        authProviderId: string;
-        autoSelectPriority: number;
-        create: (options: Parameters<typeof import("./embedding/openai-compatible.js").createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding/embedding-adapter.js").EmbeddingRuntime>;
-    };
-    voyage: {
-        id: string;
-        defaultModel: string;
-        transport: "remote";
-        authProviderId: string;
-        autoSelectPriority: number;
-        create: (options: Parameters<typeof import("./embedding/openai-compatible.js").createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding/embedding-adapter.js").EmbeddingRuntime>;
-    };
-    deepinfra: {
-        id: string;
-        defaultModel: string;
-        transport: "remote";
-        authProviderId: string;
-        autoSelectPriority: number;
-        create: (options: Parameters<typeof import("./embedding/openai-compatible.js").createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding/embedding-adapter.js").EmbeddingRuntime>;
-    };
-    ollama: {
-        id: string;
-        defaultModel: string;
-        transport: "local";
-        authProviderId: string;
-        autoSelectPriority: number;
-        create: (options: Parameters<typeof import("./embedding/openai-compatible.js").createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding/embedding-adapter.js").EmbeddingRuntime>;
-    };
+    openai: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    mistral: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    openrouter: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    voyage: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    deepinfra: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    ollama: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    "azure-openai": import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    cohere: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    jina: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
+    gemini: import("./embedding/embedding-adapter.js").MemoryEmbeddingProviderAdapter;
 };
 //# sourceMappingURL=adapter-catalog.d.ts.map

package/dist/internal/adapter-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-catalog.d.ts","sourceRoot":"","sources":["../../src/internal/adapter-catalog.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOrC,CAAC"}
+{"version":3,"file":"adapter-catalog.d.ts","sourceRoot":"","sources":["../../src/internal/adapter-catalog.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;CAYrC,CAAC"}

package/dist/internal/circuit-breaker.d.ts

@@ -1,7 +1,7 @@
 /**
  * Consecutive-timeout circuit breaker for Active Memory recall.
  *
- * Mirrors OpenClaw's `circuitBreakerMaxTimeouts` + `circuitBreakerCooldownMs`
+ * Mirrors peer-project's `circuitBreakerMaxTimeouts` + `circuitBreakerCooldownMs`
  * config: after N consecutive timeouts the breaker trips and `shouldSkip`
  * returns `true` until `cooldownMs` has elapsed. A successful recall resets
  * the counter immediately.

package/dist/internal/dreaming/dreaming-run.d.ts

@@ -1,6 +1,6 @@
 import type { EmbeddingRuntime } from "../embedding/embedding-adapter.js";
 /**
- * Dreaming sweep orchestrator (ADR D7 of memory-system-openclaw-parity).
+ * Dreaming sweep orchestrator (ADR D7 of memory-system-peer-project-parity).
  *
  * Phases:
  *   1. **light** — drop near-duplicate facts via cosine similarity.

package/dist/internal/embedding/azure-openai-embedding.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
+/**
+ * Azure OpenAI embedding adapter.
+ *
+ * Azure addresses the DEPLOYMENT in the path rather than the model in the body:
+ * `https://{resource}.openai.azure.com/openai/deployments/{deployment}/embeddings?api-version=...`.
+ * `{model}` in `embeddingsPath` is substituted by `createOpenAiCompatibleRuntime`, so `model` here
+ * names the Azure deployment.
+ *
+ * `AZURE_OPENAI_ENDPOINT` supplies the resource URL (without the `/openai/...` suffix);
+ * `AZURE_OPENAI_API_KEY` the credential.
+ *
+ * theokit#128 (catalog parity): sdk-core gained this adapter in T4.10 and the peer never mirrored
+ * it, so a `sdk-memory` user asking for `azure-openai` was rejected by a provider the SDK's own
+ * `Theokit.inspect.embeddingAdapters()` advertised.
+ *
+ * @internal
+ */
+export declare const DEFAULT_AZURE_OPENAI_EMBEDDING_MODEL = "text-embedding-3-small";
+export declare const azureOpenAiMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
+//# sourceMappingURL=azure-openai-embedding.d.ts.map

package/dist/internal/embedding/azure-openai-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-openai-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/azure-openai-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,oCAAoC,2BAA2B,CAAC;AAQ7E,eAAO,MAAM,yCAAyC,EAAE,8BA2BvD,CAAC"}

package/dist/internal/embedding/batch-encoder.d.ts

@@ -1,7 +1,7 @@
 /**
  * Batch encoding pipeline — embeds N texts in 1 API call with intra-batch dedup.
  *
- * Inspired by CrewAI's `encoding_flow.py` Stage 1-2: batch embed + cosine dedup.
+ * Inspired by a peer project's `encoding_flow.py` Stage 1-2: batch embed + cosine dedup.
  * Per ADR D1: new module alongside sync(), not a replacement.
  *
  * @internal

package/dist/internal/embedding/cohere-embedding.d.ts

@@ -0,0 +1,14 @@
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
+/**
+ * Cohere embedding adapter — `POST /v2/embed` at `https://api.cohere.com`, which carries the
+ * OpenAI-compatible `{ model, input }` request shape.
+ *
+ * Honors `COHERE_API_KEY`.
+ *
+ * theokit#128 (catalog parity): mirrors sdk-core's T4.10 adapter, which the peer never picked up.
+ *
+ * @internal
+ */
+export declare const DEFAULT_COHERE_EMBEDDING_MODEL = "embed-english-v3.0";
+export declare const cohereMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
+//# sourceMappingURL=cohere-embedding.d.ts.map

package/dist/internal/embedding/cohere-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cohere-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/cohere-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;;GASG;AAEH,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AASnE,eAAO,MAAM,oCAAoC,EAAE,8BAgClD,CAAC"}

package/dist/internal/embedding/deepinfra-embedding.d.ts

@@ -1,4 +1,4 @@
-import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
 /**
  * DeepInfra embedding adapter — hosts open-source embedding models
  * (BGE, E5, Jina, etc.) at pay-per-token. OpenAI-compatible REST at
@@ -14,12 +14,5 @@ import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
  * @internal
  */
 export declare const DEFAULT_DEEPINFRA_EMBEDDING_MODEL = "BAAI/bge-large-en-v1.5";
-export declare const deepinfraMemoryEmbeddingProviderAdapter: {
-    id: string;
-    defaultModel: string;
-    transport: "remote";
-    authProviderId: string;
-    autoSelectPriority: number;
-    create: (options: Parameters<typeof createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding-adapter.js").EmbeddingRuntime>;
-};
+export declare const deepinfraMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
 //# sourceMappingURL=deepinfra-embedding.d.ts.map

package/dist/internal/embedding/deepinfra-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepinfra-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/deepinfra-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAIvE;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAe1E,eAAO,MAAM,uCAAuC;;;;;;sBAMhC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC;CAatE,CAAC"}
+{"version":3,"file":"deepinfra-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/deepinfra-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAe1E,eAAO,MAAM,uCAAuC,EAAE,8BAmBrD,CAAC"}

package/dist/internal/embedding/embedding-adapter.d.ts

@@ -1,20 +1,20 @@
 /**
- * Memory embedding provider adapter contract (ADR D3 of memory-system-openclaw-parity).
+ * Memory embedding provider adapter contract (ADR D3 of memory-system-peer-project-parity).
  *
- * Mirrors OpenClaw's `MemoryEmbeddingProviderAdapter` from
- * `referencia/openclaw/extensions/openai/memory-embedding-adapter.ts` so
+ * Mirrors peer-project's `MemoryEmbeddingProviderAdapter` from
+ * `referencia/peer-project/extensions/openai/memory-embedding-adapter.ts` so
  * adding a new provider becomes one new file under `adapters/`.
  *
  * @internal
  */
 export interface MemoryEmbeddingProviderAdapter {
-    /** Stable provider id (matches OpenClaw's id catalog: "openai", "mistral", …). */
+    /** Stable provider id (matches peer-project's id catalog: "openai", "mistral", …). */
     readonly id: string;
     /** Default model the adapter uses unless the caller overrides via `options.model`. */
     readonly defaultModel: string;
     /** Transport kind. Remote = network HTTP; local = in-process / on-device. */
     readonly transport: "local" | "remote";
-    /** Auth provider id used to resolve API keys (mirrors OpenClaw). */
+    /** Auth provider id used to resolve API keys (mirrors peer-project). */
     readonly authProviderId?: string;
     /** Higher priority = auto-select this provider first when multiple are available. */
     readonly autoSelectPriority?: number;

package/dist/internal/embedding/embedding-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-adapter.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/embedding-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,8BAA8B;IAC7C,kFAAkF;IAClF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC;IACvC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,qFAAqF;IACrF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,iDAAiD;IACjD,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzD,oDAAoD;IACpD,KAAK,IAAI,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxC,oCAAoC;IACpC,IAAI,IAAI,MAAM,CAAC;CAChB"}
+{"version":3,"file":"embedding-adapter.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/embedding-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,8BAA8B;IAC7C,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,qFAAqF;IACrF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,iDAAiD;IACjD,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzD,oDAAoD;IACpD,KAAK,IAAI,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxC,oCAAoC;IACpC,IAAI,IAAI,MAAM,CAAC;CAChB"}

package/dist/internal/embedding/gemini-embedding.d.ts

@@ -0,0 +1,18 @@
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
+/**
+ * Google Gemini embedding adapter — the OpenAI-compatible surface at
+ * `https://generativelanguage.googleapis.com/v1/embeddings`.
+ *
+ * Gemini's NATIVE embedding endpoint has a different shape
+ * (`POST /v1beta/models/{model}:embedContent`); this adapter deliberately targets the
+ * OpenAI-compatible one so it composes with the shared runtime.
+ *
+ * Honors `GEMINI_API_KEY`.
+ *
+ * theokit#128 (catalog parity): mirrors sdk-core's T4.10 adapter, which the peer never picked up.
+ *
+ * @internal
+ */
+export declare const DEFAULT_GEMINI_EMBEDDING_MODEL = "text-embedding-004";
+export declare const geminiMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
+//# sourceMappingURL=gemini-embedding.d.ts.map

package/dist/internal/embedding/gemini-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/gemini-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAOnE,eAAO,MAAM,oCAAoC,EAAE,8BAoBlD,CAAC"}

package/dist/internal/embedding/jina-embedding.d.ts

@@ -0,0 +1,13 @@
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
+/**
+ * Jina AI embedding adapter — OpenAI-compatible at `https://api.jina.ai/v1/embeddings`.
+ *
+ * Honors `JINA_API_KEY`.
+ *
+ * theokit#128 (catalog parity): mirrors sdk-core's T4.10 adapter, which the peer never picked up.
+ *
+ * @internal
+ */
+export declare const DEFAULT_JINA_EMBEDDING_MODEL = "jina-embeddings-v3";
+export declare const jinaMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
+//# sourceMappingURL=jina-embedding.d.ts.map

package/dist/internal/embedding/jina-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jina-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/jina-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;GAQG;AAEH,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAQjE,eAAO,MAAM,kCAAkC,EAAE,8BAiBhD,CAAC"}

package/dist/internal/embedding/mistral-embedding.d.ts

@@ -1,10 +1,10 @@
-import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
 /**
  * Mistral embedding adapter — OpenAI-compatible REST surface
  * (`POST /v1/embeddings` against `https://api.mistral.ai`). Default model
  * `mistral-embed` (1024 dims).
  *
- * Mirrors `referencia/openclaw/extensions/mistral/memory-embedding-adapter.ts`.
+ * Mirrors `referencia/peer-project/extensions/mistral/memory-embedding-adapter.ts`.
  *
  * Iter 74 (Stage 3 source-move #32): hybrid copy from sdk-core's
  * `internal/memory/adapters/mistral-embedding.ts`.
@@ -12,12 +12,5 @@ import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
  * @internal
  */
 export declare const DEFAULT_MISTRAL_EMBEDDING_MODEL = "mistral-embed";
-export declare const mistralMemoryEmbeddingProviderAdapter: {
-    id: string;
-    defaultModel: string;
-    transport: "remote";
-    authProviderId: string;
-    autoSelectPriority: number;
-    create: (options: Parameters<typeof createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding-adapter.js").EmbeddingRuntime>;
-};
+export declare const mistralMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
 //# sourceMappingURL=mistral-embedding.d.ts.map

package/dist/internal/embedding/mistral-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mistral-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/mistral-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAIvE;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAM/D,eAAO,MAAM,qCAAqC;;;;;;sBAM9B,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC;CAYtE,CAAC"}
+{"version":3,"file":"mistral-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/mistral-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAM/D,eAAO,MAAM,qCAAqC,EAAE,8BAkBnD,CAAC"}

package/dist/internal/embedding/ollama-embedding.d.ts

@@ -7,7 +7,7 @@
  *
  *  - `authType: "none"` — Ollama local ignores `Authorization`. Sentinel
  *    `"ollama-local"` is passed as apiKey to satisfy the factory contract
- *    (mirrors OpenClaw `OLLAMA_DEFAULT_API_KEY = "ollama-local"`).
+ *    (mirrors peer-project `OLLAMA_DEFAULT_API_KEY = "ollama-local"`).
  *  - `OLLAMA_HOST` overrides the default `http://localhost:11434`.
  *  - `OLLAMA_API_KEY` (optional) overrides the sentinel for Ollama Cloud
  *    or reverse-proxy auth setups.
@@ -35,14 +35,7 @@
  *
  * @internal
  */
-import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
 export declare const DEFAULT_OLLAMA_EMBEDDING_MODEL = "nomic-embed-text";
-export declare const ollamaMemoryEmbeddingProviderAdapter: {
-    id: string;
-    defaultModel: string;
-    transport: "local";
-    authProviderId: string;
-    autoSelectPriority: number;
-    create: (options: Parameters<typeof createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding-adapter.js").EmbeddingRuntime>;
-};
+export declare const ollamaMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
 //# sourceMappingURL=ollama-embedding.d.ts.map

package/dist/internal/embedding/ollama-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ollama-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/ollama-embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAIvE,eAAO,MAAM,8BAA8B,qBAAqB,CAAC;AAsBjE,eAAO,MAAM,oCAAoC;;;;;;sBAQ7B,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC;CAiBtE,CAAC"}
+{"version":3,"file":"ollama-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/ollama-embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E,eAAO,MAAM,8BAA8B,qBAAqB,CAAC;AAsBjE,eAAO,MAAM,oCAAoC,EAAE,8BAyBlD,CAAC"}

package/dist/internal/embedding/openai-compatible.d.ts

@@ -1,24 +1,25 @@
-import type { CreateAdapterOptions, EmbeddingRuntime } from "./embedding-adapter.js";
-export interface OpenAiCompatibleConfig {
-    id: string;
-    defaultBaseUrl: string;
-    apiKeyEnv: string;
-    baseUrlEnv?: string;
-    defaultModel: string;
-    /**
-     * Dimension hint by model id. The chosen model MUST be in this table —
-     * unknown models throw `ConfigurationError(code: "embedding_unknown_model")`
-     * (EC-4 fix). This prevents vec0 virtual-table dimension mismatches that
-     * surface as cryptic errors downstream.
-     */
-    dimensionByModel: Record<string, number>;
-    /**
-     * Path component appended to `baseUrl` for the embeddings endpoint.
-     * Default `"/v1/embeddings"` (OpenAI canonical). REPLACES the default —
-     * does NOT concatenate. Used by DeepInfra (`"/v1/openai/embeddings"`),
-     * etc. (EC-2 fix).
-     */
-    embeddingsPath?: string;
-}
-export declare function createOpenAiCompatibleRuntime(cfg: OpenAiCompatibleConfig, options: CreateAdapterOptions): Promise<EmbeddingRuntime>;
+/**
+ * theokit#160 — the shared OpenAI-compatible embedding runtime, re-exported.
+ *
+ * This file used to be a full COPY of `@theokit/sdk`'s runtime (iter 73, "hybrid copy"). The two
+ * copies drifted, and the drift was not cosmetic: core gained bounded-parallel batching (T4.3) and a
+ * process-wide cache (T4.4) that the peer never received, while the peer's catalog REPLACES core's
+ * at runtime when installed — so consumers WITH the satellite silently ran the slower path.
+ *
+ * The duplication also produced theokit#128 (four adapters in one copy, missing from the other, for
+ * two months), and every fix since had to be applied twice by hand: the `{model}` path substitution,
+ * then all three provider dialects.
+ *
+ * Now there is one implementation, imported from `@theokit/sdk/internal/memory-adapters` — a
+ * semver-exempt sub-path in the same family as `internal/persistence` and `internal/security`, which
+ * exist for exactly this reason. The peer already depends on `@theokit/sdk/errors`, so no new
+ * dependency direction is introduced.
+ *
+ * Behaviour change for consumers of `@theokit/sdk-memory`: embedding batches now run with bounded
+ * parallelism instead of serially, and the cache is process-wide instead of per-adapter. Both are
+ * what core already did.
+ *
+ * @internal
+ */
+export { createOpenAiCompatibleRuntime, type EmbeddingDialect, type OpenAiCompatibleConfig, } from "@theokit/sdk/internal/memory-adapters";
 //# sourceMappingURL=openai-compatible.d.ts.map

package/dist/internal/embedding/openai-compatible.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/openai-compatible.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAmChC,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAgD3B"}
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/openai-compatible.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,6BAA6B,EAC7B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,uCAAuC,CAAC"}

package/dist/internal/embedding/openai-embedding.d.ts

@@ -1,4 +1,4 @@
-import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
 /**
  * **Iter 74 rollup-plugin-dts workaround:** importing
  * `MemoryEmbeddingProviderAdapter` from sibling `./embedding-adapter.js`
@@ -23,12 +23,5 @@ import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
  * @internal
  */
 export declare const DEFAULT_OPENAI_EMBEDDING_MODEL = "text-embedding-3-small";
-export declare const openAiMemoryEmbeddingProviderAdapter: {
-    id: string;
-    defaultModel: string;
-    transport: "remote";
-    authProviderId: string;
-    autoSelectPriority: number;
-    create: (options: Parameters<typeof createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding-adapter.js").EmbeddingRuntime>;
-};
+export declare const openAiMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
 //# sourceMappingURL=openai-embedding.d.ts.map

package/dist/internal/embedding/openai-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/openai-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AAQvE,eAAO,MAAM,oCAAoC;;;;;;sBAM7B,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC;CAYtE,CAAC"}
+{"version":3,"file":"openai-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/openai-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAG7E;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AAQvE,eAAO,MAAM,oCAAoC,EAAE,8BAkBlD,CAAC"}

package/dist/internal/embedding/openrouter-embedding.d.ts

@@ -1,4 +1,4 @@
-import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
 /**
  * OpenRouter embedding adapter — routes through OpenRouter's
  * `POST /api/v1/embeddings` endpoint (OpenAI-compatible request/response
@@ -14,12 +14,5 @@ import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
  * @internal
  */
 export declare const DEFAULT_OPENROUTER_EMBEDDING_MODEL = "openai/text-embedding-3-small";
-export declare const openRouterMemoryEmbeddingProviderAdapter: {
-    id: string;
-    defaultModel: string;
-    transport: "remote";
-    authProviderId: string;
-    autoSelectPriority: number;
-    create: (options: Parameters<typeof createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding-adapter.js").EmbeddingRuntime>;
-};
+export declare const openRouterMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
 //# sourceMappingURL=openrouter-embedding.d.ts.map

package/dist/internal/embedding/openrouter-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/openrouter-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAIvE;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,kCAAkC,kCAAkC,CAAC;AASlF,eAAO,MAAM,wCAAwC;;;;;;sBAMjC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC;CAYtE,CAAC"}
+{"version":3,"file":"openrouter-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/openrouter-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,kCAAkC,kCAAkC,CAAC;AASlF,eAAO,MAAM,wCAAwC,EAAE,8BAkBtD,CAAC"}

package/dist/internal/embedding/voyage-embedding.d.ts

@@ -1,4 +1,4 @@
-import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
+import type { MemoryEmbeddingProviderAdapter } from "./embedding-adapter.js";
 /**
  * Voyage AI embedding adapter — `POST /v1/embeddings` at
  * `https://api.voyageai.com` with the OpenAI-compatible `{ model, input }`
@@ -12,12 +12,5 @@ import { createOpenAiCompatibleRuntime } from "./openai-compatible.js";
  * @internal
  */
 export declare const DEFAULT_VOYAGE_EMBEDDING_MODEL = "voyage-3-lite";
-export declare const voyageMemoryEmbeddingProviderAdapter: {
-    id: string;
-    defaultModel: string;
-    transport: "remote";
-    authProviderId: string;
-    autoSelectPriority: number;
-    create: (options: Parameters<typeof createOpenAiCompatibleRuntime>[1]) => Promise<import("./embedding-adapter.js").EmbeddingRuntime>;
-};
+export declare const voyageMemoryEmbeddingProviderAdapter: MemoryEmbeddingProviderAdapter;
 //# sourceMappingURL=voyage-embedding.d.ts.map

package/dist/internal/embedding/voyage-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voyage-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/voyage-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAIvE;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAU9D,eAAO,MAAM,oCAAoC;;;;;;sBAM7B,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC;CAYtE,CAAC"}
+{"version":3,"file":"voyage-embedding.d.ts","sourceRoot":"","sources":["../../../src/internal/embedding/voyage-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAK7E;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAU9D,eAAO,MAAM,oCAAoC,EAAE,8BAkBlD,CAAC"}

package/dist/internal/index/index-schema.d.ts

@@ -26,10 +26,5 @@ export declare const SCHEMA_STATEMENTS: ReadonlyArray<string>;
  * `applyWalWithFallback` (T4.2, ADR D63) so NFS/SMB users get a graceful
  * DELETE fallback instead of crashing.
  */
-/**
- * v2 migration: adds created_at, importance, scope columns to chunks.
- * All nullable for backward-compat with existing data (EC-2).
- */
-export declare const MIGRATION_V2_STATEMENTS: ReadonlyArray<string>;
 export declare const PRAGMA_STATEMENTS: ReadonlyArray<string>;
 //# sourceMappingURL=index-schema.d.ts.map

package/dist/internal/index/index-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-schema.d.ts","sourceRoot":"","sources":["../../../src/internal/index/index-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAkCnD,CAAC;AAEF;;;;GAIG;AACH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,MAAM,CAIzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAGnD,CAAC"}
+{"version":3,"file":"index-schema.d.ts","sourceRoot":"","sources":["../../../src/internal/index/index-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAkCnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAGnD,CAAC"}

package/dist/internal/index/vec-index.d.ts

@@ -33,7 +33,7 @@ interface MemoryDb {
     loadExtension(path: string): void;
 }
 /**
- * Vector index helpers (ADR D2 + D4 of memory-system-openclaw-parity).
+ * Vector index helpers (ADR D2 + D4 of memory-system-peer-project-parity).
  *
  * Embeddings live in `embeddings(chunk_id, vec)` — a `vec0` virtual table
  * provided by the sqlite-vec extension. Embedding identity (providerId +

package/dist/internal/memory-scope.d.ts

@@ -1,7 +1,7 @@
 /**
  * Hierarchical memory scopes — path-based isolation for multi-agent setups.
  *
- * Inspired by CrewAI's `MemoryScope` with path hierarchy.
+ * Inspired by a peer project's `MemoryScope` with path hierarchy.
  * Per ADR D4: scope stored as TEXT column, prefix-matched via LIKE.
  *
  * @internal

package/dist/internal/memory-types.d.ts

@@ -40,8 +40,8 @@ export declare function legacyMemoryJsonPath(cwd: string, config: MemoryConfig):
  * `chunkMarkdown`. Each chunk carries stable line numbers + a content hash
  * used downstream by the embedding cache.
  *
- * Mirrors OpenClaw's `MemoryChunk` shape
- * (`referencia/openclaw/packages/memory-host-sdk/src/host/engine-storage.ts`).
+ * Mirrors peer-project's `MemoryChunk` shape
+ * (`referencia/peer-project/packages/memory-host-sdk/src/host/engine-storage.ts`).
  *
  * @internal
  */
@@ -61,7 +61,7 @@ export interface MemoryChunk {
  * Result of `reader.readFile`. Contains the bounded slice plus truncation
  * + provenance info.
  *
- * Mirrors OpenClaw's `MemoryReadResult` shape.
+ * Mirrors peer-project's `MemoryReadResult` shape.
  *
  * @internal
  */
@@ -83,7 +83,7 @@ export interface MemoryReadResult {
 /**
  * Lightweight reference to a markdown file in the memory corpus.
  *
- * Mirrors OpenClaw's `MemoryFileEntry`.
+ * Mirrors peer-project's `MemoryFileEntry`.
  *
  * @internal
  */

package/dist/internal/store/chunk-markdown.d.ts

@@ -33,7 +33,7 @@ interface MemoryChunk {
 }
 /**
  * Split a markdown document into semantically meaningful chunks (ADR D1 of
- * memory-system-openclaw-parity).
+ * memory-system-peer-project-parity).
  *
  * Algorithm:
  *   1. Walk lines tracking the current heading (latest `^#+ ` line).
@@ -43,7 +43,7 @@ interface MemoryChunk {
  *      whitespace ≤ maxChars (word-aligned per edge-case review EC-6) —
  *      never mid-word.
  *
- * Mirrors OpenClaw's `chunkMarkdown` from
+ * Mirrors peer-project's `chunkMarkdown` from
  * `packages/memory-host-sdk/src/host/chunk-markdown.ts`.
  *
  * Iter 53 (Stage 3 source-move #10): hybrid copy from sdk-core's