@theokit/memory-mem0 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+## 2.0.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @theokit/sdk@1.3.0
+
+## 1.0.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @theokit/sdk@1.2.0
+
+## 0.1.0
+
+### Added
+
+- Initial release. Implements `MemoryAdapter` (ADR D141) over `mem0ai` `MemoryClient` cloud (D148 — OSS local mode NOT supported).
+- `mem0Memory(options)` factory.
+- Unique `history(id)` capability — version tracking per memory.
+- Circuit breaker (EC-K): 5 consecutive 5xx trip; 429 does NOT count.
+- EC-B: `MemoryId` prefix validation in `delete` + `history`.
+- CVSS 8.1 (CVE-2026-XXXX) OSS-backend security disclosure in README.

package/README.md

@@ -0,0 +1,101 @@
+# @theokit/memory-mem0
+
+Mem0 **cloud** memory adapter for [`@theokit/sdk`](../sdk).
+
+Wraps [`mem0ai`](https://www.npmjs.com/package/mem0ai) `MemoryClient` with the
+`MemoryAdapter` contract from ADR D141. Cloud-only path per ADR D148 (the
+OSS local mode duplicates work already shipped in `@theokit/sdk` Memory).
+
+**Unique among `@theokit/memory-*` adapters:** Mem0 supports
+`history(id)` — version tracking per memory as facts evolve.
+
+## Install
+
+```bash
+pnpm add @theokit/memory-mem0 mem0ai
+```
+
+## Usage
+
+```ts
+import { Agent } from "@theokit/sdk";
+import { mem0Memory } from "@theokit/memory-mem0";
+
+const agent = await Agent.create({
+  apiKey: process.env.OPENROUTER_API_KEY,
+  model: { id: "openai/gpt-4o-mini" },
+  local: {},
+  plugins: [mem0Memory({ apiKey: process.env.MEM0_API_KEY! })],
+  memoryContext: { userId: "alice" },
+});
+
+// Persist + recall (server-side fact extraction)
+const id = await agent.memory.write("User likes Brazilian jazz");
+const facts = await agent.memory.recall("music?");
+
+// Version history — Mem0-unique capability
+const revisions = await agent.memory.adapter()?.history(id);
+```
+
+## Security Disclosure (CVE-2026-XXXX / CVSS 8.1)
+
+On **2026-04-17**, a high-severity injection vulnerability (CVSS 8.1) was
+disclosed in Mem0 OSS backends — **PGVector, MySQL, and Neptune** —
+allowing SQL or Cypher injection via crafted memory text/metadata. The
+**Mem0 managed cloud** (the only path this adapter uses) is reported
+unaffected by the disclosure.
+
+**Recommendations:**
+
+- If you use this adapter's default configuration (cloud), you are NOT
+  exposed to CVE-2026-XXXX.
+- If you self-host Mem0 OSS, upgrade to `mem0ai >= 3.0.5` and avoid the
+  PGVector / MySQL / Neptune backends until patched.
+- Sanitize untrusted user input before passing it to `agent.memory.write`
+  regardless — defense in depth.
+
+This adapter (D148) explicitly does NOT support the OSS local mode to
+avoid this surface entirely. For local persistence, use `@theokit/sdk`'s
+built-in Memory + Active Memory subsystems.
+
+## Options
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | — | Mem0 API key. Required. |
+| `host` | `string` | Mem0 cloud | Override host. |
+| `organizationId` | `string` | — | Multi-tenant org scope. |
+| `projectId` | `string` | — | Project scope. |
+| `breaker.threshold` | `number` | 5 | Consecutive 5xx failures to trip. |
+| `breaker.cooldownMs` | `number` | 120_000 | Cooldown duration. |
+
+## Circuit breaker (EC-K)
+
+A per-instance circuit breaker trips after 5 consecutive 5xx failures
+and pauses calls for 2 minutes. **429 (rate limit) does NOT count**
+toward the trip threshold — rate limits are caller-pace signals, not
+provider-down signals.
+
+Per-adapter-instance (EC-R): two `Agent.create({...})` calls with
+distinct `mem0Memory({...})` instances have independent breakers. For
+shared protection across many agents, pass the SAME plugin instance:
+
+```ts
+const sharedPlugin = mem0Memory({ apiKey });
+const a = await Agent.create({ plugins: [sharedPlugin] });
+const b = await Agent.create({ plugins: [sharedPlugin] });
+```
+
+## Failure modes
+
+| HTTP status | Maps to | Trips breaker? |
+|---|---|---|
+| 401 / 403 | `auth_failed` | no |
+| 429 | `rate_limited` | **no** (EC-K) |
+| 404 | `not_found` | no |
+| 5xx | `network` | yes |
+| Network/timeout | `network` | yes |
+
+## License
+
+Apache-2.0. See [LICENSE](./LICENSE).

package/dist/index.cjs

@@ -0,0 +1,315 @@
+'use strict';
+
+var sdk = require('@theokit/sdk');
+var MemoryClient = require('mem0ai');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var MemoryClient__default = /*#__PURE__*/_interopDefault(MemoryClient);
+
+// src/index.ts
+var ADAPTER_ID = "mem0";
+var CircuitBreaker = class {
+  threshold;
+  cooldownMs;
+  #failures = 0;
+  #openUntil = 0;
+  constructor(opts = {}) {
+    this.threshold = opts.threshold ?? 5;
+    this.cooldownMs = opts.cooldownMs ?? 2 * 60 * 1e3;
+  }
+  /** Throws `MemoryAdapterError(code: "rate_limited")` if breaker is open. */
+  ensureClosed(op) {
+    if (Date.now() < this.#openUntil) {
+      const secondsLeft = Math.ceil((this.#openUntil - Date.now()) / 1e3);
+      throw new sdk.MemoryAdapterError(
+        `Mem0 circuit breaker open (${op}): ${secondsLeft}s cooldown remaining.`,
+        { adapterId: ADAPTER_ID, code: "rate_limited" }
+      );
+    }
+  }
+  /** Increment failure counter. Trips when threshold reached. Only call for 5xx-class errors. */
+  recordFailure() {
+    this.#failures += 1;
+    if (this.#failures >= this.threshold) {
+      this.#openUntil = Date.now() + this.cooldownMs;
+    }
+  }
+  /** Reset on first success — closes the breaker (EC-K). */
+  recordSuccess() {
+    this.#failures = 0;
+    this.#openUntil = 0;
+  }
+  /** Test-only inspector. @internal */
+  state() {
+    return {
+      failures: this.#failures,
+      isOpen: Date.now() < this.#openUntil,
+      openUntil: this.#openUntil
+    };
+  }
+};
+
+// src/translate.ts
+function toMem0Options(ctx) {
+  const out = { user_id: ctx.userId };
+  if (ctx.agentId !== void 0) out.agent_id = ctx.agentId;
+  if (ctx.sessionId !== void 0) out.run_id = ctx.sessionId;
+  if (ctx.tenantId !== void 0) out.app_id = ctx.tenantId;
+  if (ctx.tags !== void 0) out.categories = ctx.tags;
+  if (ctx.metadata !== void 0) out.metadata = ctx.metadata;
+  return out;
+}
+
+// src/adapter.ts
+var ADAPTER_ID2 = "mem0";
+var CAPS = {
+  history: true,
+  // ← unique to Mem0
+  sessions: true,
+  tenancy: true,
+  reasoning: false,
+  toolSchemas: true,
+  prefetch: false
+};
+var Mem0Adapter = class {
+  id = ADAPTER_ID2;
+  capabilities = CAPS;
+  #opts;
+  #breaker;
+  #client;
+  constructor(opts) {
+    this.#opts = opts;
+    this.#breaker = new CircuitBreaker(opts.breaker);
+  }
+  isAvailable() {
+    return typeof this.#opts.apiKey === "string" && this.#opts.apiKey.length > 0;
+  }
+  async initialize() {
+  }
+  async write(content, ctx) {
+    this.#breaker.ensureClosed("write");
+    const messages = this.#toMessages(content);
+    if (messages.length === 0) {
+      throw new sdk.MemoryAdapterError("write: empty messages", {
+        adapterId: ADAPTER_ID2,
+        code: "invalid_input"
+      });
+    }
+    try {
+      const opts = toMem0Options(ctx);
+      const resp = await this.#sdk().add(messages, opts);
+      this.#breaker.recordSuccess();
+      const first = resp[0];
+      const rawId = first?.id ?? `mem0-${Date.now()}`;
+      return sdk.mkMemoryId(ADAPTER_ID2, rawId);
+    } catch (err) {
+      throw this.#translateError(err, "write");
+    }
+  }
+  async recall(query, ctx, k = 10) {
+    if (k <= 0) return [];
+    this.#breaker.ensureClosed("recall");
+    try {
+      const opts = toMem0Options(ctx);
+      const resp = await this.#sdk().search(query, {
+        // Read filter: cross-session recall keyed by user_id (Hermes pattern).
+        ...opts.user_id !== void 0 ? { filters: { user_id: opts.user_id } } : {},
+        topK: k,
+        rerank: true
+      });
+      this.#breaker.recordSuccess();
+      const list = Array.isArray(resp) ? resp : resp.results ?? [];
+      return list.map((r) => ({
+        id: sdk.mkMemoryId(ADAPTER_ID2, String(r.id ?? "")),
+        content: String(r.memory ?? r.content ?? ""),
+        ...typeof r.score === "number" ? { score: r.score } : {},
+        ...r.createdAt !== void 0 ? { createdAt: String(r.createdAt) } : {},
+        ...r.metadata !== void 0 ? { metadata: r.metadata } : {}
+      }));
+    } catch (err) {
+      throw this.#translateError(err, "recall");
+    }
+  }
+  async delete(id) {
+    this.#breaker.ensureClosed("delete");
+    const rawId = sdk.extractRawId(id, ADAPTER_ID2);
+    try {
+      await this.#sdk().delete(rawId);
+      this.#breaker.recordSuccess();
+    } catch (err) {
+      throw this.#translateError(err, "delete");
+    }
+  }
+  async history(id) {
+    this.#breaker.ensureClosed("history");
+    const rawId = sdk.extractRawId(id, ADAPTER_ID2);
+    try {
+      const rows = await this.#sdk().history(rawId);
+      this.#breaker.recordSuccess();
+      return rows.map((r, i) => {
+        const u = r.updatedAt;
+        const changedAt = u instanceof Date ? u.toISOString() : typeof u === "string" ? u : (/* @__PURE__ */ new Date()).toISOString();
+        return {
+          id: sdk.mkMemoryId(ADAPTER_ID2, r.memoryId ?? rawId),
+          content: String(r.newMemory ?? r.oldMemory ?? ""),
+          version: i + 1,
+          changedAt
+        };
+      });
+    } catch (err) {
+      throw this.#translateError(err, "history");
+    }
+  }
+  getToolSchemas() {
+    return [
+      {
+        name: "memory_write",
+        description: "Persist a turn to Mem0 long-term memory. Server-side extraction populates facts.",
+        parameters: {
+          type: "object",
+          properties: {
+            content: { type: "string", description: "Turn text to persist." }
+          },
+          required: ["content"]
+        }
+      },
+      {
+        name: "memory_recall",
+        description: "Retrieve up to k semantically relevant facts from Mem0 (server-side rerank).",
+        parameters: {
+          type: "object",
+          properties: {
+            query: { type: "string" },
+            k: { type: "integer", minimum: 1, maximum: 50 }
+          },
+          required: ["query"]
+        }
+      },
+      {
+        name: "memory_history",
+        description: "Retrieve the version history of a specific memory by id. Mem0-unique capability \u2014 shows how a fact has evolved over time (e.g., user changed preferences).",
+        parameters: {
+          type: "object",
+          properties: { memoryId: { type: "string" } },
+          required: ["memoryId"]
+        }
+      }
+    ];
+  }
+  async handleToolCall(name, args, ctx) {
+    if (name === "memory_write") {
+      const id = await this.write(String(args.content ?? ""), ctx);
+      return JSON.stringify({ ok: true, id });
+    }
+    if (name === "memory_recall") {
+      const k = typeof args.k === "number" ? args.k : 10;
+      const facts = await this.recall(String(args.query ?? ""), ctx, k);
+      return JSON.stringify({ ok: true, facts });
+    }
+    if (name === "memory_history") {
+      const rawId = String(args.memoryId ?? "");
+      const wrapped = rawId.startsWith(`${ADAPTER_ID2}:`) ? rawId : sdk.mkMemoryId(ADAPTER_ID2, rawId);
+      const revisions = await this.history(wrapped);
+      return JSON.stringify({ ok: true, revisions });
+    }
+    throw new sdk.MemoryAdapterError(`Unknown tool name: ${name}`, {
+      adapterId: ADAPTER_ID2,
+      code: "invalid_input"
+    });
+  }
+  async shutdown() {
+    this.#client = void 0;
+  }
+  /** Test-only: inspect breaker state. @internal */
+  _breakerState() {
+    return this.#breaker.state();
+  }
+  // ── helpers ────────────────────────────────────────────────────────
+  #toMessages(content) {
+    if (typeof content === "string") {
+      return content.trim().length === 0 ? [] : [{ role: "user", content }];
+    }
+    return content.filter((m) => m.content.trim().length > 0).map(
+      (m) => m.role === "system" ? { role: "user", content: `[system] ${m.content}` } : { role: m.role, content: m.content }
+    );
+  }
+  #sdk() {
+    if (this.#client === void 0) {
+      this.#client = new MemoryClient__default.default({
+        apiKey: this.#opts.apiKey,
+        ...this.#opts.host !== void 0 ? { host: this.#opts.host } : {},
+        ...this.#opts.organizationId !== void 0 ? { organizationId: this.#opts.organizationId } : {},
+        ...this.#opts.projectId !== void 0 ? { projectId: this.#opts.projectId } : {}
+      });
+    }
+    return this.#client;
+  }
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: error-translation ladder maps provider error classes to typed codes + breaker policy (EC-K: 429 does NOT trip); inlining keeps the policy decisions in one place.
+  #translateError(err, op) {
+    if (err instanceof sdk.MemoryAdapterError) {
+      if (err.code === "rate_limited") ; else if (err.code === "auth_failed" || err.code === "not_found" || err.code === "invalid_input") ; else {
+        this.#breaker.recordFailure();
+      }
+      return err;
+    }
+    const status = err?.status ?? err?.statusCode ?? err?.response?.status;
+    const message = err?.message ?? String(err);
+    if (status === 401 || status === 403) {
+      return new sdk.MemoryAdapterError(`Mem0 auth failed (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "auth_failed",
+        cause: err
+      });
+    }
+    if (status === 429) {
+      return new sdk.MemoryAdapterError(`Mem0 rate limited (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "rate_limited",
+        cause: err
+      });
+    }
+    if (status === 404) {
+      return new sdk.MemoryAdapterError(`Mem0 not found (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "not_found",
+        cause: err
+      });
+    }
+    if (typeof status === "number" && status >= 500) {
+      this.#breaker.recordFailure();
+      return new sdk.MemoryAdapterError(`Mem0 server error (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "network",
+        cause: err
+      });
+    }
+    if (status === void 0 && message.toLowerCase().includes("network")) {
+      this.#breaker.recordFailure();
+      return new sdk.MemoryAdapterError(`Mem0 network error (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "network",
+        cause: err
+      });
+    }
+    return new sdk.MemoryAdapterError(`Mem0 error (${op}): ${message}`, {
+      adapterId: ADAPTER_ID2,
+      code: "unknown",
+      cause: err
+    });
+  }
+};
+
+// src/index.ts
+function mem0Memory(options) {
+  return sdk.definePlugin({
+    name: "@theokit/memory-mem0",
+    version: "0.1.0",
+    kind: "memory",
+    createProvider: () => new Mem0Adapter(options)
+  });
+}
+
+exports.mem0Memory = mem0Memory;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/circuit-breaker.ts","../src/translate.ts","../src/adapter.ts","../src/index.ts"],"names":["MemoryAdapterError","ADAPTER_ID","mkMemoryId","extractRawId","MemoryClient","definePlugin"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * In-memory circuit breaker for Mem0Adapter (T5.1, EC-K).\n *\n * Trips after `threshold` consecutive 5xx-class failures. 429 / 401 /\n * 404 / invalid_input do NOT count toward the threshold — rate limits\n * are a caller-pace signal, not a provider-down signal (EC-K).\n *\n * @internal\n */\n\nimport { MemoryAdapterError } from \"@theokit/sdk\";\n\nconst ADAPTER_ID = \"mem0\";\n\nexport interface CircuitBreakerOptions {\n  threshold?: number;\n  cooldownMs?: number;\n}\n\nexport class CircuitBreaker {\n  readonly threshold: number;\n  readonly cooldownMs: number;\n  #failures = 0;\n  #openUntil = 0;\n\n  constructor(opts: CircuitBreakerOptions = {}) {\n    this.threshold = opts.threshold ?? 5;\n    this.cooldownMs = opts.cooldownMs ?? 2 * 60 * 1000;\n  }\n\n  /** Throws `MemoryAdapterError(code: \"rate_limited\")` if breaker is open. */\n  ensureClosed(op: string): void {\n    if (Date.now() < this.#openUntil) {\n      const secondsLeft = Math.ceil((this.#openUntil - Date.now()) / 1000);\n      throw new MemoryAdapterError(\n        `Mem0 circuit breaker open (${op}): ${secondsLeft}s cooldown remaining.`,\n        { adapterId: ADAPTER_ID, code: \"rate_limited\" },\n      );\n    }\n  }\n\n  /** Increment failure counter. Trips when threshold reached. Only call for 5xx-class errors. */\n  recordFailure(): void {\n    this.#failures += 1;\n    if (this.#failures >= this.threshold) {\n      this.#openUntil = Date.now() + this.cooldownMs;\n    }\n  }\n\n  /** Reset on first success — closes the breaker (EC-K). */\n  recordSuccess(): void {\n    this.#failures = 0;\n    this.#openUntil = 0;\n  }\n\n  /** Test-only inspector. @internal */\n  state(): { failures: number; isOpen: boolean; openUntil: number } {\n    return {\n      failures: this.#failures,\n      isOpen: Date.now() < this.#openUntil,\n      openUntil: this.#openUntil,\n    };\n  }\n}\n","/**\n * `MemoryContext` → Mem0 add/search options translation (T5.1).\n *\n * Mem0 keeps `user_id`, `agent_id`, `app_id`, `run_id` orthogonal —\n * we map each `MemoryContext` field onto its native primitive.\n *\n * @internal\n */\n\nimport type { MemoryContext } from \"@theokit/sdk\";\n\ninterface Mem0Options {\n  user_id?: string;\n  agent_id?: string;\n  run_id?: string;\n  app_id?: string;\n  categories?: string[];\n  metadata?: Record<string, unknown>;\n}\n\nexport function toMem0Options(ctx: MemoryContext): Mem0Options {\n  const out: Mem0Options = { user_id: ctx.userId };\n  if (ctx.agentId !== undefined) out.agent_id = ctx.agentId;\n  if (ctx.sessionId !== undefined) out.run_id = ctx.sessionId;\n  if (ctx.tenantId !== undefined) out.app_id = ctx.tenantId;\n  if (ctx.tags !== undefined) out.categories = ctx.tags;\n  if (ctx.metadata !== undefined) out.metadata = ctx.metadata;\n  return out;\n}\n","/**\n * Mem0Adapter — `@theokit/memory-mem0` core (T5.1, ADR D141 / D148).\n *\n * Wraps `mem0ai` `MemoryClient` (cloud-only per D148). Implements\n * `MemoryAdapter` with the unique `history(id)` capability — the only\n * adapter today that exposes per-memory versioning.\n *\n * Includes a circuit breaker (EC-K: 5xx counts; 429 does NOT trip).\n *\n * @public\n */\n\nimport {\n  extractRawId,\n  type MemoryAdapter,\n  type MemoryAdapterCapabilities,\n  MemoryAdapterError,\n  type MemoryContext,\n  type MemoryFact,\n  type MemoryId,\n  type MemoryRevision,\n  type MemoryToolSchema,\n  type MemoryTurnMessage,\n  mkMemoryId,\n} from \"@theokit/sdk\";\nimport MemoryClient from \"mem0ai\";\n\nimport { CircuitBreaker, type CircuitBreakerOptions } from \"./circuit-breaker.js\";\nimport { toMem0Options } from \"./translate.js\";\n\n/** Configuration accepted by the `mem0Memory(...)` factory. @public */\nexport interface Mem0AdapterOptions {\n  /** Mem0 API key. Required. */\n  apiKey: string;\n  /** Override host (default mem0 cloud). */\n  host?: string;\n  organizationId?: string;\n  projectId?: string;\n  /** Circuit breaker tuning (EC-K). */\n  breaker?: CircuitBreakerOptions;\n}\n\nconst ADAPTER_ID = \"mem0\";\n\nconst CAPS: MemoryAdapterCapabilities = {\n  history: true, // ← unique to Mem0\n  sessions: true,\n  tenancy: true,\n  reasoning: false,\n  toolSchemas: true,\n  prefetch: false,\n};\n\n/** @internal */\nexport class Mem0Adapter implements MemoryAdapter {\n  readonly id = ADAPTER_ID;\n  readonly capabilities = CAPS;\n  readonly #opts: Mem0AdapterOptions;\n  readonly #breaker: CircuitBreaker;\n  #client?: MemoryClient;\n\n  constructor(opts: Mem0AdapterOptions) {\n    this.#opts = opts;\n    this.#breaker = new CircuitBreaker(opts.breaker);\n  }\n\n  isAvailable(): boolean {\n    return typeof this.#opts.apiKey === \"string\" && this.#opts.apiKey.length > 0;\n  }\n\n  async initialize(): Promise<void> {\n    // Lazy: client constructed on first call.\n  }\n\n  async write(content: string | MemoryTurnMessage[], ctx: MemoryContext): Promise<MemoryId> {\n    this.#breaker.ensureClosed(\"write\");\n    const messages = this.#toMessages(content);\n    if (messages.length === 0) {\n      throw new MemoryAdapterError(\"write: empty messages\", {\n        adapterId: ADAPTER_ID,\n        code: \"invalid_input\",\n      });\n    }\n    try {\n      const opts = toMem0Options(ctx);\n      const resp = await this.#sdk().add(messages, opts);\n      this.#breaker.recordSuccess();\n      const first = resp[0];\n      const rawId = first?.id ?? `mem0-${Date.now()}`;\n      return mkMemoryId(ADAPTER_ID, rawId);\n    } catch (err) {\n      throw this.#translateError(err, \"write\");\n    }\n  }\n\n  async recall(query: string, ctx: MemoryContext, k = 10): Promise<MemoryFact[]> {\n    if (k <= 0) return [];\n    this.#breaker.ensureClosed(\"recall\");\n    try {\n      const opts = toMem0Options(ctx);\n      const resp = await this.#sdk().search(query, {\n        // Read filter: cross-session recall keyed by user_id (Hermes pattern).\n        ...(opts.user_id !== undefined ? { filters: { user_id: opts.user_id } } : {}),\n        topK: k,\n        rerank: true,\n      });\n      this.#breaker.recordSuccess();\n      const list = Array.isArray(resp) ? resp : ((resp as { results?: unknown[] }).results ?? []);\n      return (list as Array<Record<string, unknown>>).map((r) => ({\n        id: mkMemoryId(ADAPTER_ID, String(r.id ?? \"\")),\n        content: String(r.memory ?? r.content ?? \"\"),\n        ...(typeof r.score === \"number\" ? { score: r.score as number } : {}),\n        ...(r.createdAt !== undefined ? { createdAt: String(r.createdAt) } : {}),\n        ...(r.metadata !== undefined ? { metadata: r.metadata as Record<string, unknown> } : {}),\n      }));\n    } catch (err) {\n      throw this.#translateError(err, \"recall\");\n    }\n  }\n\n  async delete(id: MemoryId): Promise<void> {\n    this.#breaker.ensureClosed(\"delete\");\n    const rawId = extractRawId(id, ADAPTER_ID);\n    try {\n      await this.#sdk().delete(rawId);\n      this.#breaker.recordSuccess();\n    } catch (err) {\n      throw this.#translateError(err, \"delete\");\n    }\n  }\n\n  async history(id: MemoryId): Promise<MemoryRevision[]> {\n    this.#breaker.ensureClosed(\"history\");\n    const rawId = extractRawId(id, ADAPTER_ID);\n    try {\n      const rows = await this.#sdk().history(rawId);\n      this.#breaker.recordSuccess();\n      return rows.map((r, i) => {\n        const u = (r as unknown as { updatedAt?: unknown }).updatedAt;\n        const changedAt =\n          u instanceof Date\n            ? u.toISOString()\n            : typeof u === \"string\"\n              ? u\n              : new Date().toISOString();\n        return {\n          id: mkMemoryId(ADAPTER_ID, r.memoryId ?? rawId),\n          content: String(r.newMemory ?? r.oldMemory ?? \"\"),\n          version: i + 1,\n          changedAt,\n        };\n      });\n    } catch (err) {\n      throw this.#translateError(err, \"history\");\n    }\n  }\n\n  getToolSchemas(): MemoryToolSchema[] {\n    return [\n      {\n        name: \"memory_write\",\n        description:\n          \"Persist a turn to Mem0 long-term memory. Server-side extraction populates facts.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            content: { type: \"string\", description: \"Turn text to persist.\" },\n          },\n          required: [\"content\"],\n        },\n      },\n      {\n        name: \"memory_recall\",\n        description: \"Retrieve up to k semantically relevant facts from Mem0 (server-side rerank).\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            query: { type: \"string\" },\n            k: { type: \"integer\", minimum: 1, maximum: 50 },\n          },\n          required: [\"query\"],\n        },\n      },\n      {\n        name: \"memory_history\",\n        description:\n          \"Retrieve the version history of a specific memory by id. Mem0-unique capability — \" +\n          \"shows how a fact has evolved over time (e.g., user changed preferences).\",\n        parameters: {\n          type: \"object\",\n          properties: { memoryId: { type: \"string\" } },\n          required: [\"memoryId\"],\n        },\n      },\n    ];\n  }\n\n  async handleToolCall(\n    name: string,\n    args: Record<string, unknown>,\n    ctx: MemoryContext,\n  ): Promise<string> {\n    if (name === \"memory_write\") {\n      const id = await this.write(String(args.content ?? \"\"), ctx);\n      return JSON.stringify({ ok: true, id });\n    }\n    if (name === \"memory_recall\") {\n      const k = typeof args.k === \"number\" ? args.k : 10;\n      const facts = await this.recall(String(args.query ?? \"\"), ctx, k);\n      return JSON.stringify({ ok: true, facts });\n    }\n    if (name === \"memory_history\") {\n      const rawId = String(args.memoryId ?? \"\");\n      const wrapped = rawId.startsWith(`${ADAPTER_ID}:`)\n        ? (rawId as MemoryId)\n        : mkMemoryId(ADAPTER_ID, rawId);\n      const revisions = await this.history(wrapped);\n      return JSON.stringify({ ok: true, revisions });\n    }\n    throw new MemoryAdapterError(`Unknown tool name: ${name}`, {\n      adapterId: ADAPTER_ID,\n      code: \"invalid_input\",\n    });\n  }\n\n  async shutdown(): Promise<void> {\n    this.#client = undefined;\n  }\n\n  /** Test-only: inspect breaker state. @internal */\n  _breakerState(): { failures: number; isOpen: boolean; openUntil: number } {\n    return this.#breaker.state();\n  }\n\n  // ── helpers ────────────────────────────────────────────────────────\n\n  #toMessages(\n    content: string | MemoryTurnMessage[],\n  ): Array<{ role: \"user\" | \"assistant\"; content: string }> {\n    if (typeof content === \"string\") {\n      return content.trim().length === 0 ? [] : [{ role: \"user\", content }];\n    }\n    // Mem0 SDK accepts only user/assistant roles. System turns are merged\n    // into user content with a \"[system] \" prefix.\n    return content\n      .filter((m) => m.content.trim().length > 0)\n      .map((m) =>\n        m.role === \"system\"\n          ? { role: \"user\" as const, content: `[system] ${m.content}` }\n          : { role: m.role, content: m.content },\n      );\n  }\n\n  #sdk(): MemoryClient {\n    if (this.#client === undefined) {\n      this.#client = new MemoryClient({\n        apiKey: this.#opts.apiKey,\n        ...(this.#opts.host !== undefined ? { host: this.#opts.host } : {}),\n        ...(this.#opts.organizationId !== undefined\n          ? { organizationId: this.#opts.organizationId }\n          : {}),\n        ...(this.#opts.projectId !== undefined ? { projectId: this.#opts.projectId } : {}),\n      });\n    }\n    return this.#client;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: error-translation ladder maps provider error classes to typed codes + breaker policy (EC-K: 429 does NOT trip); inlining keeps the policy decisions in one place.\n  #translateError(err: unknown, op: string): MemoryAdapterError {\n    if (err instanceof MemoryAdapterError) {\n      if (err.code === \"rate_limited\") {\n        // EC-K: do NOT trip breaker on rate limit.\n      } else if (\n        err.code === \"auth_failed\" ||\n        err.code === \"not_found\" ||\n        err.code === \"invalid_input\"\n      ) {\n        // No trip — these are caller-side or stateful conditions.\n      } else {\n        this.#breaker.recordFailure();\n      }\n      return err;\n    }\n    const status =\n      (err as { status?: number; statusCode?: number; response?: { status?: number } })?.status ??\n      (err as { statusCode?: number })?.statusCode ??\n      (err as { response?: { status?: number } })?.response?.status;\n    const message = (err as Error)?.message ?? String(err);\n    if (status === 401 || status === 403) {\n      return new MemoryAdapterError(`Mem0 auth failed (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"auth_failed\",\n        cause: err,\n      });\n    }\n    if (status === 429) {\n      // EC-K: rate-limited; do NOT increment breaker.\n      return new MemoryAdapterError(`Mem0 rate limited (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"rate_limited\",\n        cause: err,\n      });\n    }\n    if (status === 404) {\n      return new MemoryAdapterError(`Mem0 not found (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"not_found\",\n        cause: err,\n      });\n    }\n    if (typeof status === \"number\" && status >= 500) {\n      this.#breaker.recordFailure();\n      return new MemoryAdapterError(`Mem0 server error (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"network\",\n        cause: err,\n      });\n    }\n    if (status === undefined && message.toLowerCase().includes(\"network\")) {\n      this.#breaker.recordFailure();\n      return new MemoryAdapterError(`Mem0 network error (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"network\",\n        cause: err,\n      });\n    }\n    return new MemoryAdapterError(`Mem0 error (${op}): ${message}`, {\n      adapterId: ADAPTER_ID,\n      code: \"unknown\",\n      cause: err,\n    });\n  }\n}\n","/**\n * `@theokit/memory-mem0` — Mem0 cloud memory adapter for @theokit/sdk.\n *\n * Cloud-only per ADR D148. Wraps `mem0ai` `MemoryClient`. Unique\n * capability among `@theokit/memory-*` adapters: `history(id)`.\n *\n * @public\n */\n\nimport type { Plugin } from \"@theokit/sdk\";\nimport { definePlugin } from \"@theokit/sdk\";\n\nimport { Mem0Adapter, type Mem0AdapterOptions } from \"./adapter.js\";\n\nexport type { Mem0AdapterOptions } from \"./adapter.js\";\n\n/** Build a `Plugin { kind: \"memory\" }`. @public */\nexport function mem0Memory(options: Mem0AdapterOptions): Plugin {\n  return definePlugin({\n    name: \"@theokit/memory-mem0\",\n    version: \"0.1.0\",\n    kind: \"memory\",\n    createProvider: () => new Mem0Adapter(options),\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,53 @@
+import { Plugin } from '@theokit/sdk';
+
+/**
+ * In-memory circuit breaker for Mem0Adapter (T5.1, EC-K).
+ *
+ * Trips after `threshold` consecutive 5xx-class failures. 429 / 401 /
+ * 404 / invalid_input do NOT count toward the threshold — rate limits
+ * are a caller-pace signal, not a provider-down signal (EC-K).
+ *
+ * @internal
+ */
+interface CircuitBreakerOptions {
+    threshold?: number;
+    cooldownMs?: number;
+}
+
+/**
+ * Mem0Adapter — `@theokit/memory-mem0` core (T5.1, ADR D141 / D148).
+ *
+ * Wraps `mem0ai` `MemoryClient` (cloud-only per D148). Implements
+ * `MemoryAdapter` with the unique `history(id)` capability — the only
+ * adapter today that exposes per-memory versioning.
+ *
+ * Includes a circuit breaker (EC-K: 5xx counts; 429 does NOT trip).
+ *
+ * @public
+ */
+
+/** Configuration accepted by the `mem0Memory(...)` factory. @public */
+interface Mem0AdapterOptions {
+    /** Mem0 API key. Required. */
+    apiKey: string;
+    /** Override host (default mem0 cloud). */
+    host?: string;
+    organizationId?: string;
+    projectId?: string;
+    /** Circuit breaker tuning (EC-K). */
+    breaker?: CircuitBreakerOptions;
+}
+
+/**
+ * `@theokit/memory-mem0` — Mem0 cloud memory adapter for @theokit/sdk.
+ *
+ * Cloud-only per ADR D148. Wraps `mem0ai` `MemoryClient`. Unique
+ * capability among `@theokit/memory-*` adapters: `history(id)`.
+ *
+ * @public
+ */
+
+/** Build a `Plugin { kind: "memory" }`. @public */
+declare function mem0Memory(options: Mem0AdapterOptions): Plugin;
+
+export { type Mem0AdapterOptions, mem0Memory };

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { Plugin } from '@theokit/sdk';
+
+/**
+ * In-memory circuit breaker for Mem0Adapter (T5.1, EC-K).
+ *
+ * Trips after `threshold` consecutive 5xx-class failures. 429 / 401 /
+ * 404 / invalid_input do NOT count toward the threshold — rate limits
+ * are a caller-pace signal, not a provider-down signal (EC-K).
+ *
+ * @internal
+ */
+interface CircuitBreakerOptions {
+    threshold?: number;
+    cooldownMs?: number;
+}
+
+/**
+ * Mem0Adapter — `@theokit/memory-mem0` core (T5.1, ADR D141 / D148).
+ *
+ * Wraps `mem0ai` `MemoryClient` (cloud-only per D148). Implements
+ * `MemoryAdapter` with the unique `history(id)` capability — the only
+ * adapter today that exposes per-memory versioning.
+ *
+ * Includes a circuit breaker (EC-K: 5xx counts; 429 does NOT trip).
+ *
+ * @public
+ */
+
+/** Configuration accepted by the `mem0Memory(...)` factory. @public */
+interface Mem0AdapterOptions {
+    /** Mem0 API key. Required. */
+    apiKey: string;
+    /** Override host (default mem0 cloud). */
+    host?: string;
+    organizationId?: string;
+    projectId?: string;
+    /** Circuit breaker tuning (EC-K). */
+    breaker?: CircuitBreakerOptions;
+}
+
+/**
+ * `@theokit/memory-mem0` — Mem0 cloud memory adapter for @theokit/sdk.
+ *
+ * Cloud-only per ADR D148. Wraps `mem0ai` `MemoryClient`. Unique
+ * capability among `@theokit/memory-*` adapters: `history(id)`.
+ *
+ * @public
+ */
+
+/** Build a `Plugin { kind: "memory" }`. @public */
+declare function mem0Memory(options: Mem0AdapterOptions): Plugin;
+
+export { type Mem0AdapterOptions, mem0Memory };

package/dist/index.js

@@ -0,0 +1,309 @@
+import { definePlugin, MemoryAdapterError, mkMemoryId, extractRawId } from '@theokit/sdk';
+import MemoryClient from 'mem0ai';
+
+// src/index.ts
+var ADAPTER_ID = "mem0";
+var CircuitBreaker = class {
+  threshold;
+  cooldownMs;
+  #failures = 0;
+  #openUntil = 0;
+  constructor(opts = {}) {
+    this.threshold = opts.threshold ?? 5;
+    this.cooldownMs = opts.cooldownMs ?? 2 * 60 * 1e3;
+  }
+  /** Throws `MemoryAdapterError(code: "rate_limited")` if breaker is open. */
+  ensureClosed(op) {
+    if (Date.now() < this.#openUntil) {
+      const secondsLeft = Math.ceil((this.#openUntil - Date.now()) / 1e3);
+      throw new MemoryAdapterError(
+        `Mem0 circuit breaker open (${op}): ${secondsLeft}s cooldown remaining.`,
+        { adapterId: ADAPTER_ID, code: "rate_limited" }
+      );
+    }
+  }
+  /** Increment failure counter. Trips when threshold reached. Only call for 5xx-class errors. */
+  recordFailure() {
+    this.#failures += 1;
+    if (this.#failures >= this.threshold) {
+      this.#openUntil = Date.now() + this.cooldownMs;
+    }
+  }
+  /** Reset on first success — closes the breaker (EC-K). */
+  recordSuccess() {
+    this.#failures = 0;
+    this.#openUntil = 0;
+  }
+  /** Test-only inspector. @internal */
+  state() {
+    return {
+      failures: this.#failures,
+      isOpen: Date.now() < this.#openUntil,
+      openUntil: this.#openUntil
+    };
+  }
+};
+
+// src/translate.ts
+function toMem0Options(ctx) {
+  const out = { user_id: ctx.userId };
+  if (ctx.agentId !== void 0) out.agent_id = ctx.agentId;
+  if (ctx.sessionId !== void 0) out.run_id = ctx.sessionId;
+  if (ctx.tenantId !== void 0) out.app_id = ctx.tenantId;
+  if (ctx.tags !== void 0) out.categories = ctx.tags;
+  if (ctx.metadata !== void 0) out.metadata = ctx.metadata;
+  return out;
+}
+
+// src/adapter.ts
+var ADAPTER_ID2 = "mem0";
+var CAPS = {
+  history: true,
+  // ← unique to Mem0
+  sessions: true,
+  tenancy: true,
+  reasoning: false,
+  toolSchemas: true,
+  prefetch: false
+};
+var Mem0Adapter = class {
+  id = ADAPTER_ID2;
+  capabilities = CAPS;
+  #opts;
+  #breaker;
+  #client;
+  constructor(opts) {
+    this.#opts = opts;
+    this.#breaker = new CircuitBreaker(opts.breaker);
+  }
+  isAvailable() {
+    return typeof this.#opts.apiKey === "string" && this.#opts.apiKey.length > 0;
+  }
+  async initialize() {
+  }
+  async write(content, ctx) {
+    this.#breaker.ensureClosed("write");
+    const messages = this.#toMessages(content);
+    if (messages.length === 0) {
+      throw new MemoryAdapterError("write: empty messages", {
+        adapterId: ADAPTER_ID2,
+        code: "invalid_input"
+      });
+    }
+    try {
+      const opts = toMem0Options(ctx);
+      const resp = await this.#sdk().add(messages, opts);
+      this.#breaker.recordSuccess();
+      const first = resp[0];
+      const rawId = first?.id ?? `mem0-${Date.now()}`;
+      return mkMemoryId(ADAPTER_ID2, rawId);
+    } catch (err) {
+      throw this.#translateError(err, "write");
+    }
+  }
+  async recall(query, ctx, k = 10) {
+    if (k <= 0) return [];
+    this.#breaker.ensureClosed("recall");
+    try {
+      const opts = toMem0Options(ctx);
+      const resp = await this.#sdk().search(query, {
+        // Read filter: cross-session recall keyed by user_id (Hermes pattern).
+        ...opts.user_id !== void 0 ? { filters: { user_id: opts.user_id } } : {},
+        topK: k,
+        rerank: true
+      });
+      this.#breaker.recordSuccess();
+      const list = Array.isArray(resp) ? resp : resp.results ?? [];
+      return list.map((r) => ({
+        id: mkMemoryId(ADAPTER_ID2, String(r.id ?? "")),
+        content: String(r.memory ?? r.content ?? ""),
+        ...typeof r.score === "number" ? { score: r.score } : {},
+        ...r.createdAt !== void 0 ? { createdAt: String(r.createdAt) } : {},
+        ...r.metadata !== void 0 ? { metadata: r.metadata } : {}
+      }));
+    } catch (err) {
+      throw this.#translateError(err, "recall");
+    }
+  }
+  async delete(id) {
+    this.#breaker.ensureClosed("delete");
+    const rawId = extractRawId(id, ADAPTER_ID2);
+    try {
+      await this.#sdk().delete(rawId);
+      this.#breaker.recordSuccess();
+    } catch (err) {
+      throw this.#translateError(err, "delete");
+    }
+  }
+  async history(id) {
+    this.#breaker.ensureClosed("history");
+    const rawId = extractRawId(id, ADAPTER_ID2);
+    try {
+      const rows = await this.#sdk().history(rawId);
+      this.#breaker.recordSuccess();
+      return rows.map((r, i) => {
+        const u = r.updatedAt;
+        const changedAt = u instanceof Date ? u.toISOString() : typeof u === "string" ? u : (/* @__PURE__ */ new Date()).toISOString();
+        return {
+          id: mkMemoryId(ADAPTER_ID2, r.memoryId ?? rawId),
+          content: String(r.newMemory ?? r.oldMemory ?? ""),
+          version: i + 1,
+          changedAt
+        };
+      });
+    } catch (err) {
+      throw this.#translateError(err, "history");
+    }
+  }
+  getToolSchemas() {
+    return [
+      {
+        name: "memory_write",
+        description: "Persist a turn to Mem0 long-term memory. Server-side extraction populates facts.",
+        parameters: {
+          type: "object",
+          properties: {
+            content: { type: "string", description: "Turn text to persist." }
+          },
+          required: ["content"]
+        }
+      },
+      {
+        name: "memory_recall",
+        description: "Retrieve up to k semantically relevant facts from Mem0 (server-side rerank).",
+        parameters: {
+          type: "object",
+          properties: {
+            query: { type: "string" },
+            k: { type: "integer", minimum: 1, maximum: 50 }
+          },
+          required: ["query"]
+        }
+      },
+      {
+        name: "memory_history",
+        description: "Retrieve the version history of a specific memory by id. Mem0-unique capability \u2014 shows how a fact has evolved over time (e.g., user changed preferences).",
+        parameters: {
+          type: "object",
+          properties: { memoryId: { type: "string" } },
+          required: ["memoryId"]
+        }
+      }
+    ];
+  }
+  async handleToolCall(name, args, ctx) {
+    if (name === "memory_write") {
+      const id = await this.write(String(args.content ?? ""), ctx);
+      return JSON.stringify({ ok: true, id });
+    }
+    if (name === "memory_recall") {
+      const k = typeof args.k === "number" ? args.k : 10;
+      const facts = await this.recall(String(args.query ?? ""), ctx, k);
+      return JSON.stringify({ ok: true, facts });
+    }
+    if (name === "memory_history") {
+      const rawId = String(args.memoryId ?? "");
+      const wrapped = rawId.startsWith(`${ADAPTER_ID2}:`) ? rawId : mkMemoryId(ADAPTER_ID2, rawId);
+      const revisions = await this.history(wrapped);
+      return JSON.stringify({ ok: true, revisions });
+    }
+    throw new MemoryAdapterError(`Unknown tool name: ${name}`, {
+      adapterId: ADAPTER_ID2,
+      code: "invalid_input"
+    });
+  }
+  async shutdown() {
+    this.#client = void 0;
+  }
+  /** Test-only: inspect breaker state. @internal */
+  _breakerState() {
+    return this.#breaker.state();
+  }
+  // ── helpers ────────────────────────────────────────────────────────
+  #toMessages(content) {
+    if (typeof content === "string") {
+      return content.trim().length === 0 ? [] : [{ role: "user", content }];
+    }
+    return content.filter((m) => m.content.trim().length > 0).map(
+      (m) => m.role === "system" ? { role: "user", content: `[system] ${m.content}` } : { role: m.role, content: m.content }
+    );
+  }
+  #sdk() {
+    if (this.#client === void 0) {
+      this.#client = new MemoryClient({
+        apiKey: this.#opts.apiKey,
+        ...this.#opts.host !== void 0 ? { host: this.#opts.host } : {},
+        ...this.#opts.organizationId !== void 0 ? { organizationId: this.#opts.organizationId } : {},
+        ...this.#opts.projectId !== void 0 ? { projectId: this.#opts.projectId } : {}
+      });
+    }
+    return this.#client;
+  }
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: error-translation ladder maps provider error classes to typed codes + breaker policy (EC-K: 429 does NOT trip); inlining keeps the policy decisions in one place.
+  #translateError(err, op) {
+    if (err instanceof MemoryAdapterError) {
+      if (err.code === "rate_limited") ; else if (err.code === "auth_failed" || err.code === "not_found" || err.code === "invalid_input") ; else {
+        this.#breaker.recordFailure();
+      }
+      return err;
+    }
+    const status = err?.status ?? err?.statusCode ?? err?.response?.status;
+    const message = err?.message ?? String(err);
+    if (status === 401 || status === 403) {
+      return new MemoryAdapterError(`Mem0 auth failed (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "auth_failed",
+        cause: err
+      });
+    }
+    if (status === 429) {
+      return new MemoryAdapterError(`Mem0 rate limited (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "rate_limited",
+        cause: err
+      });
+    }
+    if (status === 404) {
+      return new MemoryAdapterError(`Mem0 not found (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "not_found",
+        cause: err
+      });
+    }
+    if (typeof status === "number" && status >= 500) {
+      this.#breaker.recordFailure();
+      return new MemoryAdapterError(`Mem0 server error (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "network",
+        cause: err
+      });
+    }
+    if (status === void 0 && message.toLowerCase().includes("network")) {
+      this.#breaker.recordFailure();
+      return new MemoryAdapterError(`Mem0 network error (${op}): ${message}`, {
+        adapterId: ADAPTER_ID2,
+        code: "network",
+        cause: err
+      });
+    }
+    return new MemoryAdapterError(`Mem0 error (${op}): ${message}`, {
+      adapterId: ADAPTER_ID2,
+      code: "unknown",
+      cause: err
+    });
+  }
+};
+
+// src/index.ts
+function mem0Memory(options) {
+  return definePlugin({
+    name: "@theokit/memory-mem0",
+    version: "0.1.0",
+    kind: "memory",
+    createProvider: () => new Mem0Adapter(options)
+  });
+}
+
+export { mem0Memory };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/circuit-breaker.ts","../src/translate.ts","../src/adapter.ts","../src/index.ts"],"names":["ADAPTER_ID","MemoryAdapterError"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * In-memory circuit breaker for Mem0Adapter (T5.1, EC-K).\n *\n * Trips after `threshold` consecutive 5xx-class failures. 429 / 401 /\n * 404 / invalid_input do NOT count toward the threshold — rate limits\n * are a caller-pace signal, not a provider-down signal (EC-K).\n *\n * @internal\n */\n\nimport { MemoryAdapterError } from \"@theokit/sdk\";\n\nconst ADAPTER_ID = \"mem0\";\n\nexport interface CircuitBreakerOptions {\n  threshold?: number;\n  cooldownMs?: number;\n}\n\nexport class CircuitBreaker {\n  readonly threshold: number;\n  readonly cooldownMs: number;\n  #failures = 0;\n  #openUntil = 0;\n\n  constructor(opts: CircuitBreakerOptions = {}) {\n    this.threshold = opts.threshold ?? 5;\n    this.cooldownMs = opts.cooldownMs ?? 2 * 60 * 1000;\n  }\n\n  /** Throws `MemoryAdapterError(code: \"rate_limited\")` if breaker is open. */\n  ensureClosed(op: string): void {\n    if (Date.now() < this.#openUntil) {\n      const secondsLeft = Math.ceil((this.#openUntil - Date.now()) / 1000);\n      throw new MemoryAdapterError(\n        `Mem0 circuit breaker open (${op}): ${secondsLeft}s cooldown remaining.`,\n        { adapterId: ADAPTER_ID, code: \"rate_limited\" },\n      );\n    }\n  }\n\n  /** Increment failure counter. Trips when threshold reached. Only call for 5xx-class errors. */\n  recordFailure(): void {\n    this.#failures += 1;\n    if (this.#failures >= this.threshold) {\n      this.#openUntil = Date.now() + this.cooldownMs;\n    }\n  }\n\n  /** Reset on first success — closes the breaker (EC-K). */\n  recordSuccess(): void {\n    this.#failures = 0;\n    this.#openUntil = 0;\n  }\n\n  /** Test-only inspector. @internal */\n  state(): { failures: number; isOpen: boolean; openUntil: number } {\n    return {\n      failures: this.#failures,\n      isOpen: Date.now() < this.#openUntil,\n      openUntil: this.#openUntil,\n    };\n  }\n}\n","/**\n * `MemoryContext` → Mem0 add/search options translation (T5.1).\n *\n * Mem0 keeps `user_id`, `agent_id`, `app_id`, `run_id` orthogonal —\n * we map each `MemoryContext` field onto its native primitive.\n *\n * @internal\n */\n\nimport type { MemoryContext } from \"@theokit/sdk\";\n\ninterface Mem0Options {\n  user_id?: string;\n  agent_id?: string;\n  run_id?: string;\n  app_id?: string;\n  categories?: string[];\n  metadata?: Record<string, unknown>;\n}\n\nexport function toMem0Options(ctx: MemoryContext): Mem0Options {\n  const out: Mem0Options = { user_id: ctx.userId };\n  if (ctx.agentId !== undefined) out.agent_id = ctx.agentId;\n  if (ctx.sessionId !== undefined) out.run_id = ctx.sessionId;\n  if (ctx.tenantId !== undefined) out.app_id = ctx.tenantId;\n  if (ctx.tags !== undefined) out.categories = ctx.tags;\n  if (ctx.metadata !== undefined) out.metadata = ctx.metadata;\n  return out;\n}\n","/**\n * Mem0Adapter — `@theokit/memory-mem0` core (T5.1, ADR D141 / D148).\n *\n * Wraps `mem0ai` `MemoryClient` (cloud-only per D148). Implements\n * `MemoryAdapter` with the unique `history(id)` capability — the only\n * adapter today that exposes per-memory versioning.\n *\n * Includes a circuit breaker (EC-K: 5xx counts; 429 does NOT trip).\n *\n * @public\n */\n\nimport {\n  extractRawId,\n  type MemoryAdapter,\n  type MemoryAdapterCapabilities,\n  MemoryAdapterError,\n  type MemoryContext,\n  type MemoryFact,\n  type MemoryId,\n  type MemoryRevision,\n  type MemoryToolSchema,\n  type MemoryTurnMessage,\n  mkMemoryId,\n} from \"@theokit/sdk\";\nimport MemoryClient from \"mem0ai\";\n\nimport { CircuitBreaker, type CircuitBreakerOptions } from \"./circuit-breaker.js\";\nimport { toMem0Options } from \"./translate.js\";\n\n/** Configuration accepted by the `mem0Memory(...)` factory. @public */\nexport interface Mem0AdapterOptions {\n  /** Mem0 API key. Required. */\n  apiKey: string;\n  /** Override host (default mem0 cloud). */\n  host?: string;\n  organizationId?: string;\n  projectId?: string;\n  /** Circuit breaker tuning (EC-K). */\n  breaker?: CircuitBreakerOptions;\n}\n\nconst ADAPTER_ID = \"mem0\";\n\nconst CAPS: MemoryAdapterCapabilities = {\n  history: true, // ← unique to Mem0\n  sessions: true,\n  tenancy: true,\n  reasoning: false,\n  toolSchemas: true,\n  prefetch: false,\n};\n\n/** @internal */\nexport class Mem0Adapter implements MemoryAdapter {\n  readonly id = ADAPTER_ID;\n  readonly capabilities = CAPS;\n  readonly #opts: Mem0AdapterOptions;\n  readonly #breaker: CircuitBreaker;\n  #client?: MemoryClient;\n\n  constructor(opts: Mem0AdapterOptions) {\n    this.#opts = opts;\n    this.#breaker = new CircuitBreaker(opts.breaker);\n  }\n\n  isAvailable(): boolean {\n    return typeof this.#opts.apiKey === \"string\" && this.#opts.apiKey.length > 0;\n  }\n\n  async initialize(): Promise<void> {\n    // Lazy: client constructed on first call.\n  }\n\n  async write(content: string | MemoryTurnMessage[], ctx: MemoryContext): Promise<MemoryId> {\n    this.#breaker.ensureClosed(\"write\");\n    const messages = this.#toMessages(content);\n    if (messages.length === 0) {\n      throw new MemoryAdapterError(\"write: empty messages\", {\n        adapterId: ADAPTER_ID,\n        code: \"invalid_input\",\n      });\n    }\n    try {\n      const opts = toMem0Options(ctx);\n      const resp = await this.#sdk().add(messages, opts);\n      this.#breaker.recordSuccess();\n      const first = resp[0];\n      const rawId = first?.id ?? `mem0-${Date.now()}`;\n      return mkMemoryId(ADAPTER_ID, rawId);\n    } catch (err) {\n      throw this.#translateError(err, \"write\");\n    }\n  }\n\n  async recall(query: string, ctx: MemoryContext, k = 10): Promise<MemoryFact[]> {\n    if (k <= 0) return [];\n    this.#breaker.ensureClosed(\"recall\");\n    try {\n      const opts = toMem0Options(ctx);\n      const resp = await this.#sdk().search(query, {\n        // Read filter: cross-session recall keyed by user_id (Hermes pattern).\n        ...(opts.user_id !== undefined ? { filters: { user_id: opts.user_id } } : {}),\n        topK: k,\n        rerank: true,\n      });\n      this.#breaker.recordSuccess();\n      const list = Array.isArray(resp) ? resp : ((resp as { results?: unknown[] }).results ?? []);\n      return (list as Array<Record<string, unknown>>).map((r) => ({\n        id: mkMemoryId(ADAPTER_ID, String(r.id ?? \"\")),\n        content: String(r.memory ?? r.content ?? \"\"),\n        ...(typeof r.score === \"number\" ? { score: r.score as number } : {}),\n        ...(r.createdAt !== undefined ? { createdAt: String(r.createdAt) } : {}),\n        ...(r.metadata !== undefined ? { metadata: r.metadata as Record<string, unknown> } : {}),\n      }));\n    } catch (err) {\n      throw this.#translateError(err, \"recall\");\n    }\n  }\n\n  async delete(id: MemoryId): Promise<void> {\n    this.#breaker.ensureClosed(\"delete\");\n    const rawId = extractRawId(id, ADAPTER_ID);\n    try {\n      await this.#sdk().delete(rawId);\n      this.#breaker.recordSuccess();\n    } catch (err) {\n      throw this.#translateError(err, \"delete\");\n    }\n  }\n\n  async history(id: MemoryId): Promise<MemoryRevision[]> {\n    this.#breaker.ensureClosed(\"history\");\n    const rawId = extractRawId(id, ADAPTER_ID);\n    try {\n      const rows = await this.#sdk().history(rawId);\n      this.#breaker.recordSuccess();\n      return rows.map((r, i) => {\n        const u = (r as unknown as { updatedAt?: unknown }).updatedAt;\n        const changedAt =\n          u instanceof Date\n            ? u.toISOString()\n            : typeof u === \"string\"\n              ? u\n              : new Date().toISOString();\n        return {\n          id: mkMemoryId(ADAPTER_ID, r.memoryId ?? rawId),\n          content: String(r.newMemory ?? r.oldMemory ?? \"\"),\n          version: i + 1,\n          changedAt,\n        };\n      });\n    } catch (err) {\n      throw this.#translateError(err, \"history\");\n    }\n  }\n\n  getToolSchemas(): MemoryToolSchema[] {\n    return [\n      {\n        name: \"memory_write\",\n        description:\n          \"Persist a turn to Mem0 long-term memory. Server-side extraction populates facts.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            content: { type: \"string\", description: \"Turn text to persist.\" },\n          },\n          required: [\"content\"],\n        },\n      },\n      {\n        name: \"memory_recall\",\n        description: \"Retrieve up to k semantically relevant facts from Mem0 (server-side rerank).\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            query: { type: \"string\" },\n            k: { type: \"integer\", minimum: 1, maximum: 50 },\n          },\n          required: [\"query\"],\n        },\n      },\n      {\n        name: \"memory_history\",\n        description:\n          \"Retrieve the version history of a specific memory by id. Mem0-unique capability — \" +\n          \"shows how a fact has evolved over time (e.g., user changed preferences).\",\n        parameters: {\n          type: \"object\",\n          properties: { memoryId: { type: \"string\" } },\n          required: [\"memoryId\"],\n        },\n      },\n    ];\n  }\n\n  async handleToolCall(\n    name: string,\n    args: Record<string, unknown>,\n    ctx: MemoryContext,\n  ): Promise<string> {\n    if (name === \"memory_write\") {\n      const id = await this.write(String(args.content ?? \"\"), ctx);\n      return JSON.stringify({ ok: true, id });\n    }\n    if (name === \"memory_recall\") {\n      const k = typeof args.k === \"number\" ? args.k : 10;\n      const facts = await this.recall(String(args.query ?? \"\"), ctx, k);\n      return JSON.stringify({ ok: true, facts });\n    }\n    if (name === \"memory_history\") {\n      const rawId = String(args.memoryId ?? \"\");\n      const wrapped = rawId.startsWith(`${ADAPTER_ID}:`)\n        ? (rawId as MemoryId)\n        : mkMemoryId(ADAPTER_ID, rawId);\n      const revisions = await this.history(wrapped);\n      return JSON.stringify({ ok: true, revisions });\n    }\n    throw new MemoryAdapterError(`Unknown tool name: ${name}`, {\n      adapterId: ADAPTER_ID,\n      code: \"invalid_input\",\n    });\n  }\n\n  async shutdown(): Promise<void> {\n    this.#client = undefined;\n  }\n\n  /** Test-only: inspect breaker state. @internal */\n  _breakerState(): { failures: number; isOpen: boolean; openUntil: number } {\n    return this.#breaker.state();\n  }\n\n  // ── helpers ────────────────────────────────────────────────────────\n\n  #toMessages(\n    content: string | MemoryTurnMessage[],\n  ): Array<{ role: \"user\" | \"assistant\"; content: string }> {\n    if (typeof content === \"string\") {\n      return content.trim().length === 0 ? [] : [{ role: \"user\", content }];\n    }\n    // Mem0 SDK accepts only user/assistant roles. System turns are merged\n    // into user content with a \"[system] \" prefix.\n    return content\n      .filter((m) => m.content.trim().length > 0)\n      .map((m) =>\n        m.role === \"system\"\n          ? { role: \"user\" as const, content: `[system] ${m.content}` }\n          : { role: m.role, content: m.content },\n      );\n  }\n\n  #sdk(): MemoryClient {\n    if (this.#client === undefined) {\n      this.#client = new MemoryClient({\n        apiKey: this.#opts.apiKey,\n        ...(this.#opts.host !== undefined ? { host: this.#opts.host } : {}),\n        ...(this.#opts.organizationId !== undefined\n          ? { organizationId: this.#opts.organizationId }\n          : {}),\n        ...(this.#opts.projectId !== undefined ? { projectId: this.#opts.projectId } : {}),\n      });\n    }\n    return this.#client;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: error-translation ladder maps provider error classes to typed codes + breaker policy (EC-K: 429 does NOT trip); inlining keeps the policy decisions in one place.\n  #translateError(err: unknown, op: string): MemoryAdapterError {\n    if (err instanceof MemoryAdapterError) {\n      if (err.code === \"rate_limited\") {\n        // EC-K: do NOT trip breaker on rate limit.\n      } else if (\n        err.code === \"auth_failed\" ||\n        err.code === \"not_found\" ||\n        err.code === \"invalid_input\"\n      ) {\n        // No trip — these are caller-side or stateful conditions.\n      } else {\n        this.#breaker.recordFailure();\n      }\n      return err;\n    }\n    const status =\n      (err as { status?: number; statusCode?: number; response?: { status?: number } })?.status ??\n      (err as { statusCode?: number })?.statusCode ??\n      (err as { response?: { status?: number } })?.response?.status;\n    const message = (err as Error)?.message ?? String(err);\n    if (status === 401 || status === 403) {\n      return new MemoryAdapterError(`Mem0 auth failed (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"auth_failed\",\n        cause: err,\n      });\n    }\n    if (status === 429) {\n      // EC-K: rate-limited; do NOT increment breaker.\n      return new MemoryAdapterError(`Mem0 rate limited (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"rate_limited\",\n        cause: err,\n      });\n    }\n    if (status === 404) {\n      return new MemoryAdapterError(`Mem0 not found (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"not_found\",\n        cause: err,\n      });\n    }\n    if (typeof status === \"number\" && status >= 500) {\n      this.#breaker.recordFailure();\n      return new MemoryAdapterError(`Mem0 server error (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"network\",\n        cause: err,\n      });\n    }\n    if (status === undefined && message.toLowerCase().includes(\"network\")) {\n      this.#breaker.recordFailure();\n      return new MemoryAdapterError(`Mem0 network error (${op}): ${message}`, {\n        adapterId: ADAPTER_ID,\n        code: \"network\",\n        cause: err,\n      });\n    }\n    return new MemoryAdapterError(`Mem0 error (${op}): ${message}`, {\n      adapterId: ADAPTER_ID,\n      code: \"unknown\",\n      cause: err,\n    });\n  }\n}\n","/**\n * `@theokit/memory-mem0` — Mem0 cloud memory adapter for @theokit/sdk.\n *\n * Cloud-only per ADR D148. Wraps `mem0ai` `MemoryClient`. Unique\n * capability among `@theokit/memory-*` adapters: `history(id)`.\n *\n * @public\n */\n\nimport type { Plugin } from \"@theokit/sdk\";\nimport { definePlugin } from \"@theokit/sdk\";\n\nimport { Mem0Adapter, type Mem0AdapterOptions } from \"./adapter.js\";\n\nexport type { Mem0AdapterOptions } from \"./adapter.js\";\n\n/** Build a `Plugin { kind: \"memory\" }`. @public */\nexport function mem0Memory(options: Mem0AdapterOptions): Plugin {\n  return definePlugin({\n    name: \"@theokit/memory-mem0\",\n    version: \"0.1.0\",\n    kind: \"memory\",\n    createProvider: () => new Mem0Adapter(options),\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@theokit/memory-mem0",
+  "version": "0.1.0",
+  "description": "Mem0 cloud memory adapter for @theokit/sdk — wraps mem0ai MemoryClient with the MemoryAdapter contract (ADR D141).",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "@theokit/sdk": "workspace:^",
+    "mem0ai": "^3.0.0"
+  },
+  "devDependencies": {
+    "@theokit/sdk": "workspace:*",
+    "mem0ai": "^3.0.3",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  }
+}