getmnemo 0.1.3 → 0.2.0

package/README.md

@@ -6,7 +6,9 @@ Official TypeScript / JavaScript SDK for [Mnemo Memory](https://mnemohq.com) —
 npm install getmnemo
 ```
 
-Zero runtime dependencies. Works in Node 18+, Bun, Deno, Cloudflare Workers, and any other modern server or edge JS runtime with `fetch`. The `apiKey` is a full-access credential — keep it server-side; for browser or client UIs, proxy through a server route.
+Zero runtime dependencies. Works in Node 18+, Bun, Deno, Cloudflare Workers, and any other modern server or edge JS runtime with `fetch`.
+
+A default `apiKey` is **full-access** — keep it server-side. Scoped keys **do** exist: the key-mint dialog lets you grant `read` / `write` / `delete` / `billing` scopes individually. For browser or client-exposed contexts, mint a **scoped read-only key** (or proxy through a server route) rather than shipping a full-access key.
 
 ## Quickstart
 
@@ -18,25 +20,59 @@ const memory = new Mnemo({
   workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,
 })
 
-// Store an atomic fact
-await memory.add({ content: 'User prefers Japanese short-grain rice for onigiri.' })
+// Store an atomic fact, scoped to a container (e.g. a user)
+await memory.add({
+  content: 'User prefers Japanese short-grain rice for onigiri.',
+  containerTag: 'user:jane',
+})
 
-// Retrieve relevant facts
-const { hits } = await memory.search({ query: 'what kind of rice does the user like?' })
-for (const hit of hits) {
+// Retrieve relevant facts from the same container
+const { results } = await memory.search({
+  q: 'what kind of rice does the user like?',
+  containerTag: 'user:jane',
+})
+for (const hit of results) {
   console.log(hit.score.toFixed(2), hit.content)
 }
 ```
 
+## Containers
+
+Memories live in **containers**. Identify a container two ways:
+
+- `containerTag` — a string like `"user:jane"` (the simplest, recommended form)
+- `scope` — the structured equivalent `{ type: 'user', id: 'jane' }`
+
+`add` and `search` require a container. Set one per call, or set `defaultContainerTag`
+on the client once so every call falls back to it:
+
+```ts
+const memory = new Mnemo({
+  apiKey: process.env.GETMNEMO_API_KEY!,
+  workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,
+  defaultContainerTag: 'user:jane',
+})
+
+await memory.add({ content: 'Likes onigiri.' }) // uses user:jane
+await memory.search({ q: 'food preferences?' })  // uses user:jane
+```
+
+If neither a per-call container nor a default is set, `add`/`search` throw before
+hitting the network.
+
 ## API surface
 
 | Method | Purpose |
 |---|---|
-| `search({ query, limit?, actorId? })` | Hybrid 7-strategy retrieval. Returns `SearchResponse`. |
-| `add({ content, metadata?, actorId? })` | Store an atomic fact. Returns `Memory`. |
-| `update(id, { content?, metadata? })` | Patch existing memory. |
-| `delete(id)` | Remove a memory. |
-| `list({ limit?, cursor?, actorId? })` | Cursor-paginated list. |
+| `search({ q, containerTag?, scope?, limit?, searchMode? })` | Hybrid retrieval. Returns `SearchResponse`. |
+| `add({ content, containerTag?, scope?, metadata? })` | Store an atomic fact. Returns `AddResponse`. |
+| `update(memoryId, { content?, memoryType?, metadata?, source? })` | Patch an existing memory. |
+| `get(memoryId)` | Fetch a single memory. |
+| `delete(memoryId)` | Remove a memory. |
+| `list({ containerTag?, limit?, cursor?, scopeType?, scopeId? })` | Cursor-paginated list. |
+
+> Response types (`SearchResponse`, `AddResponse`, `Memory`, …) are **provisional** —
+> reconstructed from observed live payloads pending a fully-annotated API spec.
 
 ## Errors
 
@@ -46,7 +82,7 @@ All HTTP failures throw `MnemoHTTPError` with `.status` and `.body`. Aborted req
 import { Mnemo, MnemoHTTPError } from 'getmnemo'
 
 try {
-  await memory.search({ query: 'rice' })
+  await memory.search({ q: 'rice', containerTag: 'user:jane' })
 } catch (err) {
   if (err instanceof MnemoHTTPError && err.status === 401) {
     console.error('API key rejected:', err.body)
@@ -61,8 +97,8 @@ try {
 | Option | Default | Notes |
 |---|---|---|
 | `apiKey` | (required) | from <https://app.mnemohq.com/settings/api-keys> |
-| `workspaceId` | (required) | from the dashboard URL |
-| `actorId` | none | optional default actor scope |
+| `workspaceId` | (required) | sent as the `x-workspace-id` header |
+| `defaultContainerTag` | none | fallback container for `add`/`search` |
 | `baseUrl` | `https://api.mnemohq.com` | override for self-hosted |
 | `timeoutMs` | `30000` | per-request abort timeout |
 | `fetch` | global `fetch` | inject for testing or proxying |
@@ -75,6 +111,30 @@ npm test
 npm run build
 ```
 
+## CI smoke gate
+
+The publish workflow (`.github/workflows/publish.yml`) will **not** publish to
+npm unless a real production round-trip passes first. A `smoke` job runs on the
+same `v*` tag trigger and the `publish` job depends on it via `needs: smoke`, so
+a failed smoke blocks the release.
+
+`npm run smoke` (`scripts/prod-smoke.mjs`) writes a memory to container **A** and
+another to container **B** against prod, confirms the add/search round-trip via
+`response.results`, then asserts **tenant isolation**: a search scoped to B must
+not return A's memory, and vice versa. A leak exits non-zero with a loud
+`TENANT ISOLATION FAILURE` — treat that as a production security finding, not a
+flaky test. Created memories are deleted on cleanup (cleanup failure only warns).
+
+It needs three secrets, which **must be ORG-level (no repo-level twin)** — a
+repo-level twin shadows the org secret, which is exactly the failure mode that
+broke an earlier publish:
+
+| Secret | Purpose |
+|---|---|
+| `MNEMO_API_KEY` | Scoped test key. **Needs `delete` scope** so the smoke can clean up the memories it creates (plus `write` + `search`). |
+| `MNEMO_WORKSPACE_ID` | Throwaway test workspace id. |
+| `MNEMO_TEST_CONTAINER` | Base `containerTag` (e.g. `ci-smoke`); the script derives unique per-run A/B containers from it. |
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -30,7 +30,8 @@ var MnemoTimeoutError = class extends MnemoError {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.mnemohq.com";
 var DEFAULT_TIMEOUT_MS = 3e4;
-var SDK_VERSION = "0.1.0";
+var SDK_VERSION = "0.2.0";
+var DEFAULT_SEARCH_LIMIT = 8;
 var USER_AGENT = `getmnemo/${SDK_VERSION}`;
 var DEFAULT_MAX_RETRIES = 3;
 var RETRY_BASE_DELAY_MS = 200;
@@ -73,7 +74,7 @@ var Mnemo = class {
   #fetch;
   #timeoutMs;
   #maxRetries;
-  #defaultActorId;
+  #defaultContainerTag;
   constructor(cfg) {
     if (!cfg.apiKey) throw new Error("Mnemo: apiKey is required");
     if (!cfg.workspaceId) throw new Error("Mnemo: workspaceId is required");
@@ -88,49 +89,104 @@ var Mnemo = class {
     } else {
       this.#headers["user-agent"] = USER_AGENT;
     }
-    if (cfg.actorId) this.#headers["x-actor-id"] = cfg.actorId;
-    this.#defaultActorId = cfg.actorId;
+    this.#defaultContainerTag = cfg.defaultContainerTag;
     this.#fetch = cfg.fetch ?? fetch;
     this.#timeoutMs = cfg.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.#maxRetries = Math.max(0, cfg.maxRetries ?? DEFAULT_MAX_RETRIES);
   }
+  /**
+   * Resolve the container for a call into the request fields the API expects.
+   * A structured `scope` wins over a `containerTag` string; both fall back to
+   * the constructor's `defaultContainerTag`. Throws if none is available.
+   */
+  #resolveContainer(method, input) {
+    if (input.scope) return { scope: input.scope };
+    const tag = input.containerTag ?? this.#defaultContainerTag;
+    if (tag) return { containerTag: tag };
+    throw new Error(
+      `Mnemo.${method}: a container is required \u2014 pass containerTag (e.g. "user:jane") or scope ({ type, id }) per call, or set defaultContainerTag on the client.`
+    );
+  }
+  /**
+   * Hybrid retrieval. Requires a container — pass `containerTag` (e.g.
+   * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+   *
+   * Sends `POST /v1/search` with body `{ q, limit, containerTag|scope }`.
+   */
   async search(input) {
+    const container = this.#resolveContainer("search", input);
     return this.#request("POST", "/v1/search", {
-      query: input.query,
-      limit: input.limit ?? 8,
-      ...input.actorId !== void 0 ? { actorId: input.actorId } : {}
+      q: input.q,
+      limit: input.limit ?? DEFAULT_SEARCH_LIMIT,
+      ...input.searchMode !== void 0 ? { searchMode: input.searchMode } : {},
+      ...container
     });
   }
+  /**
+   * Store an atomic fact. Requires a container — pass `containerTag` (e.g.
+   * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+   *
+   * Sends `POST /v1/memories` with body
+   * `{ items: [{ content, metadata? }], containerTag|scope }`.
+   */
   async add(input) {
+    const container = this.#resolveContainer("add", input);
     return this.#request("POST", "/v1/memories", {
-      content: input.content,
-      ...input.metadata !== void 0 ? { metadata: input.metadata } : {},
-      ...input.actorId !== void 0 ? { actorId: input.actorId } : {}
+      items: [
+        {
+          content: input.content,
+          ...input.metadata !== void 0 ? { metadata: input.metadata } : {}
+        }
+      ],
+      ...container
     });
   }
-  async update(id, input) {
-    if (input.content === void 0 && input.metadata === void 0) {
-      throw new Error("Mnemo.update: at least one of content/metadata must be provided");
+  /**
+   * Patch an existing memory by id.
+   * Sends `PATCH /v1/memories/{memoryId}` with body `UpdateMemoryDto`
+   * `{ content?, memoryType?, metadata?, source? }` (none required).
+   */
+  async update(memoryId, input) {
+    if (input.content === void 0 && input.memoryType === void 0 && input.metadata === void 0 && input.source === void 0) {
+      throw new Error(
+        "Mnemo.update: at least one of content/memoryType/metadata/source must be provided"
+      );
     }
-    return this.#request("PATCH", `/v1/memories/${encodeURIComponent(id)}`, input);
+    return this.#request(
+      "PATCH",
+      `/v1/memories/${encodeURIComponent(memoryId)}`,
+      input
+    );
   }
-  async get(id) {
-    return this.#request("GET", `/v1/memories/${encodeURIComponent(id)}`);
+  /** Fetch a single memory by id. Sends `GET /v1/memories/{memoryId}`. */
+  async get(memoryId) {
+    return this.#request("GET", `/v1/memories/${encodeURIComponent(memoryId)}`);
   }
-  async delete(id) {
-    await this.#request("DELETE", `/v1/memories/${encodeURIComponent(id)}`);
+  /** Remove a memory by id. Sends `DELETE /v1/memories/{memoryId}`. */
+  async delete(memoryId) {
+    await this.#request(
+      "DELETE",
+      `/v1/memories/${encodeURIComponent(memoryId)}`
+    );
   }
+  /**
+   * Cursor-paginated list of memories, optionally filtered by container.
+   * Sends `GET /v1/memories` with query
+   * `limit?, cursor?, scopeType?, scopeId?, containerTag?`.
+   */
   async list(input) {
     const params = new URLSearchParams();
     if (input?.limit !== void 0) params.set("limit", String(input.limit));
     if (input?.cursor !== void 0) params.set("cursor", input.cursor);
-    if (input?.actorId !== void 0) params.set("actorId", input.actorId);
+    if (input?.scopeType !== void 0) params.set("scopeType", input.scopeType);
+    if (input?.scopeId !== void 0) params.set("scopeId", input.scopeId);
+    if (input?.containerTag !== void 0) params.set("containerTag", input.containerTag);
     const qs = params.toString();
     return this.#request("GET", `/v1/memories${qs ? `?${qs}` : ""}`);
   }
   /** Echoed back for debugging — never sent to the wire. */
-  get defaultActorId() {
-    return this.#defaultActorId;
+  get defaultContainerTag() {
+    return this.#defaultContainerTag;
   }
   async #request(method, path, body) {
     const serializedBody = body === void 0 ? void 0 : JSON.stringify(body);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export class MnemoError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'MnemoError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoHTTPError extends MnemoError {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly body?: unknown,\n  ) {\n    super(`[${status}] ${message}`)\n    this.name = 'MnemoHTTPError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoTimeoutError extends MnemoError {\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`)\n    this.name = 'MnemoTimeoutError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","/**\n * Mnemo Memory client.\n *\n * Zero runtime dependencies — uses the global `fetch` (Node 18+, Bun, browsers,\n * Cloudflare Workers, Deno, etc).\n *\n * @example\n * ```ts\n * import { Mnemo } from 'getmnemo'\n *\n * const memory = new Mnemo({\n *   apiKey: process.env.GETMNEMO_API_KEY!,\n *   workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,\n * })\n *\n * await memory.add({ content: 'User prefers Japanese rice.' })\n * const { hits } = await memory.search({ query: 'what rice does the user like?' })\n * ```\n */\n\nimport { MnemoHTTPError, MnemoTimeoutError } from './errors.js'\nimport type {\n  ClientConfig,\n  Memory,\n  PaginatedMemories,\n  SearchResponse,\n} from './types.js'\n\nconst DEFAULT_BASE_URL = 'https://api.mnemohq.com'\nconst DEFAULT_TIMEOUT_MS = 30_000\nconst SDK_VERSION = '0.1.0'\nconst USER_AGENT = `getmnemo/${SDK_VERSION}`\nconst DEFAULT_MAX_RETRIES = 3\nconst RETRY_BASE_DELAY_MS = 200\nconst RETRY_MAX_DELAY_MS = 5_000\n\n// Browsers reject `user-agent` as a forbidden header — setting it via fetch\n// throws or warns. Detect a browser-like environment so we can skip it there.\nconst IS_BROWSER_LIKE =\n  typeof globalThis !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).window !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).document !== 'undefined'\n\nfunction retryDelayMs(attempt: number): number {\n  const capped = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS)\n  // Full jitter.\n  return Math.floor(Math.random() * capped)\n}\n\nfunction isRetryableStatus(status: number): boolean {\n  // 501 Not Implemented is a permanent failure — retrying just wastes round-trips.\n  if (status === 501) return false\n  return status === 429 || (status >= 500 && status < 600)\n}\n\nfunction parseRetryAfterMs(headerValue: string | null): number | null {\n  if (!headerValue) return null\n  const trimmed = headerValue.trim()\n  // Delta-seconds form.\n  const seconds = Number(trimmed)\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(seconds * 1000, RETRY_MAX_DELAY_MS)\n  }\n  // HTTP-date form.\n  const epoch = Date.parse(trimmed)\n  if (!Number.isNaN(epoch)) {\n    const delta = epoch - Date.now()\n    return Math.max(0, Math.min(delta, RETRY_MAX_DELAY_MS))\n  }\n  return null\n}\n\nfunction delayForResponse(res: Response, attempt: number): number {\n  const hint = parseRetryAfterMs(res.headers.get('retry-after'))\n  return hint !== null ? hint : retryDelayMs(attempt)\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nexport class Mnemo {\n  readonly #baseUrl: string\n  readonly #headers: Record<string, string>\n  readonly #fetch: typeof fetch\n  readonly #timeoutMs: number\n  readonly #maxRetries: number\n  readonly #defaultActorId: string | undefined\n\n  constructor(cfg: ClientConfig) {\n    if (!cfg.apiKey) throw new Error('Mnemo: apiKey is required')\n    if (!cfg.workspaceId) throw new Error('Mnemo: workspaceId is required')\n    this.#baseUrl = (cfg.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n    this.#headers = {\n      authorization: `Bearer ${cfg.apiKey}`,\n      'x-workspace-id': cfg.workspaceId,\n      'content-type': 'application/json',\n    }\n    // `user-agent` is on the forbidden header list in browsers — setting it\n    // via fetch is silently dropped or throws. Send `x-getmnemo-client` as\n    // an SDK identifier in browsers, and the standard User-Agent on Node.\n    if (IS_BROWSER_LIKE) {\n      this.#headers['x-getmnemo-client'] = USER_AGENT\n    } else {\n      this.#headers['user-agent'] = USER_AGENT\n    }\n    if (cfg.actorId) this.#headers['x-actor-id'] = cfg.actorId\n    this.#defaultActorId = cfg.actorId\n    this.#fetch = cfg.fetch ?? fetch\n    this.#timeoutMs = cfg.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.#maxRetries = Math.max(0, cfg.maxRetries ?? DEFAULT_MAX_RETRIES)\n  }\n\n  async search(input: {\n    query: string\n    limit?: number\n    actorId?: string\n  }): Promise<SearchResponse> {\n    return this.#request<SearchResponse>('POST', '/v1/search', {\n      query: input.query,\n      limit: input.limit ?? 8,\n      ...(input.actorId !== undefined ? { actorId: input.actorId } : {}),\n    })\n  }\n\n  async add(input: {\n    content: string\n    metadata?: Record<string, unknown>\n    actorId?: string\n  }): Promise<Memory> {\n    return this.#request<Memory>('POST', '/v1/memories', {\n      content: input.content,\n      ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),\n      ...(input.actorId !== undefined ? { actorId: input.actorId } : {}),\n    })\n  }\n\n  async update(\n    id: string,\n    input: { content?: string; metadata?: Record<string, unknown> },\n  ): Promise<Memory> {\n    if (input.content === undefined && input.metadata === undefined) {\n      throw new Error('Mnemo.update: at least one of content/metadata must be provided')\n    }\n    return this.#request<Memory>('PATCH', `/v1/memories/${encodeURIComponent(id)}`, input)\n  }\n\n  async get(id: string): Promise<Memory> {\n    return this.#request<Memory>('GET', `/v1/memories/${encodeURIComponent(id)}`)\n  }\n\n  async delete(id: string): Promise<void> {\n    await this.#request<unknown>('DELETE', `/v1/memories/${encodeURIComponent(id)}`)\n  }\n\n  async list(input?: {\n    limit?: number\n    cursor?: string\n    actorId?: string\n  }): Promise<PaginatedMemories> {\n    const params = new URLSearchParams()\n    if (input?.limit !== undefined) params.set('limit', String(input.limit))\n    if (input?.cursor !== undefined) params.set('cursor', input.cursor)\n    if (input?.actorId !== undefined) params.set('actorId', input.actorId)\n    const qs = params.toString()\n    return this.#request<PaginatedMemories>('GET', `/v1/memories${qs ? `?${qs}` : ''}`)\n  }\n\n  /** Echoed back for debugging — never sent to the wire. */\n  get defaultActorId(): string | undefined {\n    return this.#defaultActorId\n  }\n\n  async #request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const serializedBody = body === undefined ? undefined : JSON.stringify(body)\n    let lastErr: unknown\n    for (let attempt = 0; attempt <= this.#maxRetries; attempt++) {\n      const ctrl = new AbortController()\n      const timer = setTimeout(() => ctrl.abort(), this.#timeoutMs)\n      try {\n        const res = await this.#fetch(`${this.#baseUrl}${path}`, {\n          method,\n          headers: { ...this.#headers },\n          body: serializedBody,\n          signal: ctrl.signal,\n        })\n        if (isRetryableStatus(res.status) && attempt < this.#maxRetries) {\n          // Capture Retry-After before draining; some runtimes invalidate\n          // headers once the body is consumed.\n          const wait = delayForResponse(res, attempt)\n          // Drain body so the underlying connection can be reused.\n          await res.text().catch(() => undefined)\n          await sleep(wait)\n          continue\n        }\n        const text = await res.text()\n        const parsed: unknown = text ? safeJson(text) : undefined\n        if (!res.ok) {\n          const message =\n            (parsed && typeof parsed === 'object' && 'message' in parsed\n              ? String((parsed as { message: unknown }).message)\n              : null) ?? `HTTP ${res.status} ${res.statusText}`\n          throw new MnemoHTTPError(message, res.status, parsed)\n        }\n        return parsed as T\n      } catch (err) {\n        if (err instanceof Error && err.name === 'AbortError') {\n          throw new MnemoTimeoutError(this.#timeoutMs)\n        }\n        if (err instanceof MnemoHTTPError) throw err\n        lastErr = err\n        if (attempt < this.#maxRetries) {\n          await sleep(retryDelayMs(attempt))\n          continue\n        }\n        throw err\n      } finally {\n        clearTimeout(timer)\n      }\n    }\n    throw lastErr ?? new Error('Mnemo: request failed')\n  }\n}\n\nfunction safeJson(s: string): unknown {\n  try {\n    return JSON.parse(s)\n  } catch {\n    return s\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export class MnemoError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'MnemoError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoHTTPError extends MnemoError {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly body?: unknown,\n  ) {\n    super(`[${status}] ${message}`)\n    this.name = 'MnemoHTTPError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoTimeoutError extends MnemoError {\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`)\n    this.name = 'MnemoTimeoutError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","/**\n * Mnemo Memory client.\n *\n * Zero runtime dependencies — uses the global `fetch` (Node 18+, Bun, browsers,\n * Cloudflare Workers, Deno, etc).\n *\n * @example\n * ```ts\n * import { Mnemo } from 'getmnemo'\n *\n * const memory = new Mnemo({\n *   apiKey: process.env.GETMNEMO_API_KEY!,\n *   workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,\n * })\n *\n * await memory.add({ content: 'User prefers Japanese rice.', containerTag: 'user:jane' })\n * const { results } = await memory.search({ q: 'what rice does the user like?', containerTag: 'user:jane' })\n * ```\n */\n\nimport { MnemoHTTPError, MnemoTimeoutError } from './errors.js'\nimport type {\n  AddResponse,\n  ClientConfig,\n  Memory,\n  PaginatedMemories,\n  Scope,\n  SearchResponse,\n} from './types.js'\n\nconst DEFAULT_BASE_URL = 'https://api.mnemohq.com'\nconst DEFAULT_TIMEOUT_MS = 30_000\nconst SDK_VERSION = '0.2.0'\nconst DEFAULT_SEARCH_LIMIT = 8\nconst USER_AGENT = `getmnemo/${SDK_VERSION}`\nconst DEFAULT_MAX_RETRIES = 3\nconst RETRY_BASE_DELAY_MS = 200\nconst RETRY_MAX_DELAY_MS = 5_000\n\n// Browsers reject `user-agent` as a forbidden header — setting it via fetch\n// throws or warns. Detect a browser-like environment so we can skip it there.\nconst IS_BROWSER_LIKE =\n  typeof globalThis !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).window !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).document !== 'undefined'\n\nfunction retryDelayMs(attempt: number): number {\n  const capped = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS)\n  // Full jitter.\n  return Math.floor(Math.random() * capped)\n}\n\nfunction isRetryableStatus(status: number): boolean {\n  // 501 Not Implemented is a permanent failure — retrying just wastes round-trips.\n  if (status === 501) return false\n  return status === 429 || (status >= 500 && status < 600)\n}\n\nfunction parseRetryAfterMs(headerValue: string | null): number | null {\n  if (!headerValue) return null\n  const trimmed = headerValue.trim()\n  // Delta-seconds form.\n  const seconds = Number(trimmed)\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(seconds * 1000, RETRY_MAX_DELAY_MS)\n  }\n  // HTTP-date form.\n  const epoch = Date.parse(trimmed)\n  if (!Number.isNaN(epoch)) {\n    const delta = epoch - Date.now()\n    return Math.max(0, Math.min(delta, RETRY_MAX_DELAY_MS))\n  }\n  return null\n}\n\nfunction delayForResponse(res: Response, attempt: number): number {\n  const hint = parseRetryAfterMs(res.headers.get('retry-after'))\n  return hint !== null ? hint : retryDelayMs(attempt)\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nexport class Mnemo {\n  readonly #baseUrl: string\n  readonly #headers: Record<string, string>\n  readonly #fetch: typeof fetch\n  readonly #timeoutMs: number\n  readonly #maxRetries: number\n  readonly #defaultContainerTag: string | undefined\n\n  constructor(cfg: ClientConfig) {\n    if (!cfg.apiKey) throw new Error('Mnemo: apiKey is required')\n    if (!cfg.workspaceId) throw new Error('Mnemo: workspaceId is required')\n    this.#baseUrl = (cfg.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n    this.#headers = {\n      authorization: `Bearer ${cfg.apiKey}`,\n      'x-workspace-id': cfg.workspaceId,\n      'content-type': 'application/json',\n    }\n    // `user-agent` is on the forbidden header list in browsers — setting it\n    // via fetch is silently dropped or throws. Send `x-getmnemo-client` as\n    // an SDK identifier in browsers, and the standard User-Agent on Node.\n    if (IS_BROWSER_LIKE) {\n      this.#headers['x-getmnemo-client'] = USER_AGENT\n    } else {\n      this.#headers['user-agent'] = USER_AGENT\n    }\n    this.#defaultContainerTag = cfg.defaultContainerTag\n    this.#fetch = cfg.fetch ?? fetch\n    this.#timeoutMs = cfg.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.#maxRetries = Math.max(0, cfg.maxRetries ?? DEFAULT_MAX_RETRIES)\n  }\n\n  /**\n   * Resolve the container for a call into the request fields the API expects.\n   * A structured `scope` wins over a `containerTag` string; both fall back to\n   * the constructor's `defaultContainerTag`. Throws if none is available.\n   */\n  #resolveContainer(\n    method: 'add' | 'search',\n    input: { containerTag?: string; scope?: Scope },\n  ): { containerTag: string } | { scope: Scope } {\n    if (input.scope) return { scope: input.scope }\n    const tag = input.containerTag ?? this.#defaultContainerTag\n    if (tag) return { containerTag: tag }\n    throw new Error(\n      `Mnemo.${method}: a container is required — pass containerTag (e.g. \"user:jane\") ` +\n        'or scope ({ type, id }) per call, or set defaultContainerTag on the client.',\n    )\n  }\n\n  /**\n   * Hybrid retrieval. Requires a container — pass `containerTag` (e.g.\n   * `\"user:jane\"`) or `scope`, or set `defaultContainerTag` on the client.\n   *\n   * Sends `POST /v1/search` with body `{ q, limit, containerTag|scope }`.\n   */\n  async search(input: {\n    q: string\n    containerTag?: string\n    scope?: Scope\n    limit?: number\n    searchMode?: string\n  }): Promise<SearchResponse> {\n    const container = this.#resolveContainer('search', input)\n    return this.#request<SearchResponse>('POST', '/v1/search', {\n      q: input.q,\n      limit: input.limit ?? DEFAULT_SEARCH_LIMIT,\n      ...(input.searchMode !== undefined ? { searchMode: input.searchMode } : {}),\n      ...container,\n    })\n  }\n\n  /**\n   * Store an atomic fact. Requires a container — pass `containerTag` (e.g.\n   * `\"user:jane\"`) or `scope`, or set `defaultContainerTag` on the client.\n   *\n   * Sends `POST /v1/memories` with body\n   * `{ items: [{ content, metadata? }], containerTag|scope }`.\n   */\n  async add(input: {\n    content: string\n    containerTag?: string\n    scope?: Scope\n    metadata?: Record<string, unknown>\n  }): Promise<AddResponse> {\n    const container = this.#resolveContainer('add', input)\n    return this.#request<AddResponse>('POST', '/v1/memories', {\n      items: [\n        {\n          content: input.content,\n          ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),\n        },\n      ],\n      ...container,\n    })\n  }\n\n  /**\n   * Patch an existing memory by id.\n   * Sends `PATCH /v1/memories/{memoryId}` with body `UpdateMemoryDto`\n   * `{ content?, memoryType?, metadata?, source? }` (none required).\n   */\n  async update(\n    memoryId: string,\n    input: {\n      content?: string\n      memoryType?: string\n      metadata?: Record<string, unknown>\n      source?: string\n    },\n  ): Promise<Memory> {\n    if (\n      input.content === undefined &&\n      input.memoryType === undefined &&\n      input.metadata === undefined &&\n      input.source === undefined\n    ) {\n      throw new Error(\n        'Mnemo.update: at least one of content/memoryType/metadata/source must be provided',\n      )\n    }\n    return this.#request<Memory>(\n      'PATCH',\n      `/v1/memories/${encodeURIComponent(memoryId)}`,\n      input,\n    )\n  }\n\n  /** Fetch a single memory by id. Sends `GET /v1/memories/{memoryId}`. */\n  async get(memoryId: string): Promise<Memory> {\n    return this.#request<Memory>('GET', `/v1/memories/${encodeURIComponent(memoryId)}`)\n  }\n\n  /** Remove a memory by id. Sends `DELETE /v1/memories/{memoryId}`. */\n  async delete(memoryId: string): Promise<void> {\n    await this.#request<unknown>(\n      'DELETE',\n      `/v1/memories/${encodeURIComponent(memoryId)}`,\n    )\n  }\n\n  /**\n   * Cursor-paginated list of memories, optionally filtered by container.\n   * Sends `GET /v1/memories` with query\n   * `limit?, cursor?, scopeType?, scopeId?, containerTag?`.\n   */\n  async list(input?: {\n    containerTag?: string\n    limit?: number\n    cursor?: string\n    scopeType?: string\n    scopeId?: string\n  }): Promise<PaginatedMemories> {\n    const params = new URLSearchParams()\n    if (input?.limit !== undefined) params.set('limit', String(input.limit))\n    if (input?.cursor !== undefined) params.set('cursor', input.cursor)\n    if (input?.scopeType !== undefined) params.set('scopeType', input.scopeType)\n    if (input?.scopeId !== undefined) params.set('scopeId', input.scopeId)\n    if (input?.containerTag !== undefined) params.set('containerTag', input.containerTag)\n    const qs = params.toString()\n    return this.#request<PaginatedMemories>('GET', `/v1/memories${qs ? `?${qs}` : ''}`)\n  }\n\n  /** Echoed back for debugging — never sent to the wire. */\n  get defaultContainerTag(): string | undefined {\n    return this.#defaultContainerTag\n  }\n\n  async #request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const serializedBody = body === undefined ? undefined : JSON.stringify(body)\n    let lastErr: unknown\n    for (let attempt = 0; attempt <= this.#maxRetries; attempt++) {\n      const ctrl = new AbortController()\n      const timer = setTimeout(() => ctrl.abort(), this.#timeoutMs)\n      try {\n        const res = await this.#fetch(`${this.#baseUrl}${path}`, {\n          method,\n          headers: { ...this.#headers },\n          body: serializedBody,\n          signal: ctrl.signal,\n        })\n        if (isRetryableStatus(res.status) && attempt < this.#maxRetries) {\n          // Capture Retry-After before draining; some runtimes invalidate\n          // headers once the body is consumed.\n          const wait = delayForResponse(res, attempt)\n          // Drain body so the underlying connection can be reused.\n          await res.text().catch(() => undefined)\n          await sleep(wait)\n          continue\n        }\n        const text = await res.text()\n        const parsed: unknown = text ? safeJson(text) : undefined\n        if (!res.ok) {\n          const message =\n            (parsed && typeof parsed === 'object' && 'message' in parsed\n              ? String((parsed as { message: unknown }).message)\n              : null) ?? `HTTP ${res.status} ${res.statusText}`\n          throw new MnemoHTTPError(message, res.status, parsed)\n        }\n        return parsed as T\n      } catch (err) {\n        if (err instanceof Error && err.name === 'AbortError') {\n          throw new MnemoTimeoutError(this.#timeoutMs)\n        }\n        if (err instanceof MnemoHTTPError) throw err\n        lastErr = err\n        if (attempt < this.#maxRetries) {\n          await sleep(retryDelayMs(attempt))\n          continue\n        }\n        throw err\n      } finally {\n        clearTimeout(timer)\n      }\n    }\n    throw lastErr ?? new Error('Mnemo: request failed')\n  }\n}\n\nfunction safeJson(s: string): unknown {\n  try {\n    return JSON.parse(s)\n  } catch {\n    return s\n  }\n}\n"]}

package/dist/index.d.cts

@@ -1,46 +1,116 @@
 /**
  * Public types for the Mnemo SDK.
  *
- * These mirror the REST API response shapes one-to-one. We deliberately keep
- * them as plain interfaces (no zod runtime cost) — runtime validation is the
- * caller's responsibility if they need it.
+ * Request types are derived from the OpenAPI spec at
+ * `https://api.mnemohq.com/openapi.json` ("Mnemo API" v0.2.0).
+ *
+ * Response types are confirmed against real prod payloads captured 2026-06-16
+ * (the spec does NOT annotate response schemas — every memories/search op
+ * returns `{}` — so these shapes were finalized from live responses).
+ */
+/**
+ * Structured container scope. The alternative to the `containerTag` string —
+ * e.g. `{ type: 'user', id: 'jane' }` is equivalent to `containerTag: 'user:jane'`.
+ */
+type Scope = {
+    type: string;
+    id: string;
+};
+/** The container a memory belongs to. */
+type Container = {
+    id: string;
+    tag: string;
+    containerType: string;
+    displayName: string;
+};
+/**
+ * A single memory as returned by `get`/`update`, and the per-item shape inside
+ * `list` and `add` responses.
  */
 type Memory = {
     id: string;
+    scope: Scope;
+    scopeKey: string;
+    container: Container;
     content: string;
-    metadata?: Record<string, unknown>;
-    workspaceId: string;
-    actorId?: string | null;
+    contentHash: string;
+    idempotencyKey: string | null;
+    memoryType: string;
+    metadata: Record<string, unknown> | null;
+    source: unknown | null;
+    sourceDocumentId: string | null;
+    eventId: string | null;
+    deletedAt: string | null;
     createdAt: string;
     updatedAt: string;
 };
-type SearchSource = {
-    documentId?: string;
-    chunkId?: string;
+/**
+ * One stored item in an `add` response. Same fields as a `Memory`.
+ */
+type AddedItem = Memory;
+/** Response shape of `add()`. */
+type AddResponse = {
+    scopeKey: string;
+    scope: Scope;
+    items: AddedItem[];
 };
+/** One retrieval hit in a `search` response. */
 type SearchHit = {
+    resultType: string;
     memoryId: string;
+    scopeKey: string;
     content: string;
+    metadata: Record<string, unknown> | null;
+    memoryType: string;
+    polarity: string;
     score: number;
-    metadata?: Record<string, unknown>;
-    source?: SearchSource | null;
+    createdAt: string;
+    updatedAt: string;
 };
+/** Per-stage timing breakdown returned by `search`. */
+type SearchLatency = {
+    parallelMs: number;
+    strategyMs: number;
+    fusionMs: number;
+    rerankerMs: number;
+    totalMs: number;
+};
+/**
+ * Response shape of `search()`. The primary results live in `results`; the
+ * `positivePreferences` and `hardConstraints` arrays carry the same `SearchHit`
+ * shape, alongside retrieval metadata.
+ */
 type SearchResponse = {
-    hits: SearchHit[];
-    query: string;
-    latencyMs: number;
+    results: SearchHit[];
+    positivePreferences: SearchHit[];
+    hardConstraints: SearchHit[];
+    searchMode: string;
+    queryIntent: string;
+    queryIntentConfidence: number;
+    abstained: boolean;
+    reranked: boolean;
+    rawBestVectorSim: number;
+    latency: SearchLatency;
 };
+/** Cursor-paginated list of memories. */
 type PaginatedMemories = {
     items: Memory[];
     nextCursor: string | null;
 };
 type ClientConfig = {
-    /** Required. Get one at https://app.mnemohq.com/settings/api-keys. */
+    /**
+     * Required. Full-access by default — keep server-side. For client-exposed
+     * contexts, mint a scoped read-only key. Get one at
+     * https://app.mnemohq.com/settings/api-keys.
+     */
     apiKey: string;
-    /** Required. Workspace ID from the dashboard URL. */
+    /** Required. Workspace ID — sent as the `x-workspace-id` header on every call. */
     workspaceId: string;
-    /** Optional default actor scope for all calls (overridable per-method). */
-    actorId?: string;
+    /**
+     * Optional default container tag (e.g. `"user:jane"`). When set, `add` and
+     * `search` fall back to it if no per-call `containerTag`/`scope` is given.
+     */
+    defaultContainerTag?: string;
     /** Defaults to https://api.mnemohq.com. */
     baseUrl?: string;
     /** Per-request timeout in ms (default 30s). */
@@ -66,37 +136,69 @@ type ClientConfig = {
  *   workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,
  * })
  *
- * await memory.add({ content: 'User prefers Japanese rice.' })
- * const { hits } = await memory.search({ query: 'what rice does the user like?' })
+ * await memory.add({ content: 'User prefers Japanese rice.', containerTag: 'user:jane' })
+ * const { results } = await memory.search({ q: 'what rice does the user like?', containerTag: 'user:jane' })
  * ```
  */
 
 declare class Mnemo {
     #private;
     constructor(cfg: ClientConfig);
+    /**
+     * Hybrid retrieval. Requires a container — pass `containerTag` (e.g.
+     * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+     *
+     * Sends `POST /v1/search` with body `{ q, limit, containerTag|scope }`.
+     */
     search(input: {
-        query: string;
+        q: string;
+        containerTag?: string;
+        scope?: Scope;
         limit?: number;
-        actorId?: string;
+        searchMode?: string;
     }): Promise<SearchResponse>;
+    /**
+     * Store an atomic fact. Requires a container — pass `containerTag` (e.g.
+     * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+     *
+     * Sends `POST /v1/memories` with body
+     * `{ items: [{ content, metadata? }], containerTag|scope }`.
+     */
     add(input: {
         content: string;
+        containerTag?: string;
+        scope?: Scope;
         metadata?: Record<string, unknown>;
-        actorId?: string;
-    }): Promise<Memory>;
-    update(id: string, input: {
+    }): Promise<AddResponse>;
+    /**
+     * Patch an existing memory by id.
+     * Sends `PATCH /v1/memories/{memoryId}` with body `UpdateMemoryDto`
+     * `{ content?, memoryType?, metadata?, source? }` (none required).
+     */
+    update(memoryId: string, input: {
         content?: string;
+        memoryType?: string;
         metadata?: Record<string, unknown>;
+        source?: string;
     }): Promise<Memory>;
-    get(id: string): Promise<Memory>;
-    delete(id: string): Promise<void>;
+    /** Fetch a single memory by id. Sends `GET /v1/memories/{memoryId}`. */
+    get(memoryId: string): Promise<Memory>;
+    /** Remove a memory by id. Sends `DELETE /v1/memories/{memoryId}`. */
+    delete(memoryId: string): Promise<void>;
+    /**
+     * Cursor-paginated list of memories, optionally filtered by container.
+     * Sends `GET /v1/memories` with query
+     * `limit?, cursor?, scopeType?, scopeId?, containerTag?`.
+     */
     list(input?: {
+        containerTag?: string;
         limit?: number;
         cursor?: string;
-        actorId?: string;
+        scopeType?: string;
+        scopeId?: string;
     }): Promise<PaginatedMemories>;
     /** Echoed back for debugging — never sent to the wire. */
-    get defaultActorId(): string | undefined;
+    get defaultContainerTag(): string | undefined;
 }
 
 declare class MnemoError extends Error {
@@ -111,4 +213,4 @@ declare class MnemoTimeoutError extends MnemoError {
     constructor(timeoutMs: number);
 }
 
-export { type ClientConfig, type Memory, Mnemo, MnemoError, MnemoHTTPError, MnemoTimeoutError, type PaginatedMemories, type SearchHit, type SearchResponse, type SearchSource };
+export { type AddResponse, type AddedItem, type ClientConfig, type Container, type Memory, Mnemo, MnemoError, MnemoHTTPError, MnemoTimeoutError, type PaginatedMemories, type Scope, type SearchHit, type SearchResponse };

package/dist/index.d.ts

@@ -1,46 +1,116 @@
 /**
  * Public types for the Mnemo SDK.
  *
- * These mirror the REST API response shapes one-to-one. We deliberately keep
- * them as plain interfaces (no zod runtime cost) — runtime validation is the
- * caller's responsibility if they need it.
+ * Request types are derived from the OpenAPI spec at
+ * `https://api.mnemohq.com/openapi.json` ("Mnemo API" v0.2.0).
+ *
+ * Response types are confirmed against real prod payloads captured 2026-06-16
+ * (the spec does NOT annotate response schemas — every memories/search op
+ * returns `{}` — so these shapes were finalized from live responses).
+ */
+/**
+ * Structured container scope. The alternative to the `containerTag` string —
+ * e.g. `{ type: 'user', id: 'jane' }` is equivalent to `containerTag: 'user:jane'`.
+ */
+type Scope = {
+    type: string;
+    id: string;
+};
+/** The container a memory belongs to. */
+type Container = {
+    id: string;
+    tag: string;
+    containerType: string;
+    displayName: string;
+};
+/**
+ * A single memory as returned by `get`/`update`, and the per-item shape inside
+ * `list` and `add` responses.
  */
 type Memory = {
     id: string;
+    scope: Scope;
+    scopeKey: string;
+    container: Container;
     content: string;
-    metadata?: Record<string, unknown>;
-    workspaceId: string;
-    actorId?: string | null;
+    contentHash: string;
+    idempotencyKey: string | null;
+    memoryType: string;
+    metadata: Record<string, unknown> | null;
+    source: unknown | null;
+    sourceDocumentId: string | null;
+    eventId: string | null;
+    deletedAt: string | null;
     createdAt: string;
     updatedAt: string;
 };
-type SearchSource = {
-    documentId?: string;
-    chunkId?: string;
+/**
+ * One stored item in an `add` response. Same fields as a `Memory`.
+ */
+type AddedItem = Memory;
+/** Response shape of `add()`. */
+type AddResponse = {
+    scopeKey: string;
+    scope: Scope;
+    items: AddedItem[];
 };
+/** One retrieval hit in a `search` response. */
 type SearchHit = {
+    resultType: string;
     memoryId: string;
+    scopeKey: string;
     content: string;
+    metadata: Record<string, unknown> | null;
+    memoryType: string;
+    polarity: string;
     score: number;
-    metadata?: Record<string, unknown>;
-    source?: SearchSource | null;
+    createdAt: string;
+    updatedAt: string;
 };
+/** Per-stage timing breakdown returned by `search`. */
+type SearchLatency = {
+    parallelMs: number;
+    strategyMs: number;
+    fusionMs: number;
+    rerankerMs: number;
+    totalMs: number;
+};
+/**
+ * Response shape of `search()`. The primary results live in `results`; the
+ * `positivePreferences` and `hardConstraints` arrays carry the same `SearchHit`
+ * shape, alongside retrieval metadata.
+ */
 type SearchResponse = {
-    hits: SearchHit[];
-    query: string;
-    latencyMs: number;
+    results: SearchHit[];
+    positivePreferences: SearchHit[];
+    hardConstraints: SearchHit[];
+    searchMode: string;
+    queryIntent: string;
+    queryIntentConfidence: number;
+    abstained: boolean;
+    reranked: boolean;
+    rawBestVectorSim: number;
+    latency: SearchLatency;
 };
+/** Cursor-paginated list of memories. */
 type PaginatedMemories = {
     items: Memory[];
     nextCursor: string | null;
 };
 type ClientConfig = {
-    /** Required. Get one at https://app.mnemohq.com/settings/api-keys. */
+    /**
+     * Required. Full-access by default — keep server-side. For client-exposed
+     * contexts, mint a scoped read-only key. Get one at
+     * https://app.mnemohq.com/settings/api-keys.
+     */
     apiKey: string;
-    /** Required. Workspace ID from the dashboard URL. */
+    /** Required. Workspace ID — sent as the `x-workspace-id` header on every call. */
     workspaceId: string;
-    /** Optional default actor scope for all calls (overridable per-method). */
-    actorId?: string;
+    /**
+     * Optional default container tag (e.g. `"user:jane"`). When set, `add` and
+     * `search` fall back to it if no per-call `containerTag`/`scope` is given.
+     */
+    defaultContainerTag?: string;
     /** Defaults to https://api.mnemohq.com. */
     baseUrl?: string;
     /** Per-request timeout in ms (default 30s). */
@@ -66,37 +136,69 @@ type ClientConfig = {
  *   workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,
  * })
  *
- * await memory.add({ content: 'User prefers Japanese rice.' })
- * const { hits } = await memory.search({ query: 'what rice does the user like?' })
+ * await memory.add({ content: 'User prefers Japanese rice.', containerTag: 'user:jane' })
+ * const { results } = await memory.search({ q: 'what rice does the user like?', containerTag: 'user:jane' })
  * ```
  */
 
 declare class Mnemo {
     #private;
     constructor(cfg: ClientConfig);
+    /**
+     * Hybrid retrieval. Requires a container — pass `containerTag` (e.g.
+     * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+     *
+     * Sends `POST /v1/search` with body `{ q, limit, containerTag|scope }`.
+     */
     search(input: {
-        query: string;
+        q: string;
+        containerTag?: string;
+        scope?: Scope;
         limit?: number;
-        actorId?: string;
+        searchMode?: string;
     }): Promise<SearchResponse>;
+    /**
+     * Store an atomic fact. Requires a container — pass `containerTag` (e.g.
+     * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+     *
+     * Sends `POST /v1/memories` with body
+     * `{ items: [{ content, metadata? }], containerTag|scope }`.
+     */
     add(input: {
         content: string;
+        containerTag?: string;
+        scope?: Scope;
         metadata?: Record<string, unknown>;
-        actorId?: string;
-    }): Promise<Memory>;
-    update(id: string, input: {
+    }): Promise<AddResponse>;
+    /**
+     * Patch an existing memory by id.
+     * Sends `PATCH /v1/memories/{memoryId}` with body `UpdateMemoryDto`
+     * `{ content?, memoryType?, metadata?, source? }` (none required).
+     */
+    update(memoryId: string, input: {
         content?: string;
+        memoryType?: string;
         metadata?: Record<string, unknown>;
+        source?: string;
     }): Promise<Memory>;
-    get(id: string): Promise<Memory>;
-    delete(id: string): Promise<void>;
+    /** Fetch a single memory by id. Sends `GET /v1/memories/{memoryId}`. */
+    get(memoryId: string): Promise<Memory>;
+    /** Remove a memory by id. Sends `DELETE /v1/memories/{memoryId}`. */
+    delete(memoryId: string): Promise<void>;
+    /**
+     * Cursor-paginated list of memories, optionally filtered by container.
+     * Sends `GET /v1/memories` with query
+     * `limit?, cursor?, scopeType?, scopeId?, containerTag?`.
+     */
     list(input?: {
+        containerTag?: string;
         limit?: number;
         cursor?: string;
-        actorId?: string;
+        scopeType?: string;
+        scopeId?: string;
     }): Promise<PaginatedMemories>;
     /** Echoed back for debugging — never sent to the wire. */
-    get defaultActorId(): string | undefined;
+    get defaultContainerTag(): string | undefined;
 }
 
 declare class MnemoError extends Error {
@@ -111,4 +213,4 @@ declare class MnemoTimeoutError extends MnemoError {
     constructor(timeoutMs: number);
 }
 
-export { type ClientConfig, type Memory, Mnemo, MnemoError, MnemoHTTPError, MnemoTimeoutError, type PaginatedMemories, type SearchHit, type SearchResponse, type SearchSource };
+export { type AddResponse, type AddedItem, type ClientConfig, type Container, type Memory, Mnemo, MnemoError, MnemoHTTPError, MnemoTimeoutError, type PaginatedMemories, type Scope, type SearchHit, type SearchResponse };

package/dist/index.js

@@ -28,7 +28,8 @@ var MnemoTimeoutError = class extends MnemoError {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.mnemohq.com";
 var DEFAULT_TIMEOUT_MS = 3e4;
-var SDK_VERSION = "0.1.0";
+var SDK_VERSION = "0.2.0";
+var DEFAULT_SEARCH_LIMIT = 8;
 var USER_AGENT = `getmnemo/${SDK_VERSION}`;
 var DEFAULT_MAX_RETRIES = 3;
 var RETRY_BASE_DELAY_MS = 200;
@@ -71,7 +72,7 @@ var Mnemo = class {
   #fetch;
   #timeoutMs;
   #maxRetries;
-  #defaultActorId;
+  #defaultContainerTag;
   constructor(cfg) {
     if (!cfg.apiKey) throw new Error("Mnemo: apiKey is required");
     if (!cfg.workspaceId) throw new Error("Mnemo: workspaceId is required");
@@ -86,49 +87,104 @@ var Mnemo = class {
     } else {
       this.#headers["user-agent"] = USER_AGENT;
     }
-    if (cfg.actorId) this.#headers["x-actor-id"] = cfg.actorId;
-    this.#defaultActorId = cfg.actorId;
+    this.#defaultContainerTag = cfg.defaultContainerTag;
     this.#fetch = cfg.fetch ?? fetch;
     this.#timeoutMs = cfg.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.#maxRetries = Math.max(0, cfg.maxRetries ?? DEFAULT_MAX_RETRIES);
   }
+  /**
+   * Resolve the container for a call into the request fields the API expects.
+   * A structured `scope` wins over a `containerTag` string; both fall back to
+   * the constructor's `defaultContainerTag`. Throws if none is available.
+   */
+  #resolveContainer(method, input) {
+    if (input.scope) return { scope: input.scope };
+    const tag = input.containerTag ?? this.#defaultContainerTag;
+    if (tag) return { containerTag: tag };
+    throw new Error(
+      `Mnemo.${method}: a container is required \u2014 pass containerTag (e.g. "user:jane") or scope ({ type, id }) per call, or set defaultContainerTag on the client.`
+    );
+  }
+  /**
+   * Hybrid retrieval. Requires a container — pass `containerTag` (e.g.
+   * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+   *
+   * Sends `POST /v1/search` with body `{ q, limit, containerTag|scope }`.
+   */
   async search(input) {
+    const container = this.#resolveContainer("search", input);
     return this.#request("POST", "/v1/search", {
-      query: input.query,
-      limit: input.limit ?? 8,
-      ...input.actorId !== void 0 ? { actorId: input.actorId } : {}
+      q: input.q,
+      limit: input.limit ?? DEFAULT_SEARCH_LIMIT,
+      ...input.searchMode !== void 0 ? { searchMode: input.searchMode } : {},
+      ...container
     });
   }
+  /**
+   * Store an atomic fact. Requires a container — pass `containerTag` (e.g.
+   * `"user:jane"`) or `scope`, or set `defaultContainerTag` on the client.
+   *
+   * Sends `POST /v1/memories` with body
+   * `{ items: [{ content, metadata? }], containerTag|scope }`.
+   */
   async add(input) {
+    const container = this.#resolveContainer("add", input);
     return this.#request("POST", "/v1/memories", {
-      content: input.content,
-      ...input.metadata !== void 0 ? { metadata: input.metadata } : {},
-      ...input.actorId !== void 0 ? { actorId: input.actorId } : {}
+      items: [
+        {
+          content: input.content,
+          ...input.metadata !== void 0 ? { metadata: input.metadata } : {}
+        }
+      ],
+      ...container
     });
   }
-  async update(id, input) {
-    if (input.content === void 0 && input.metadata === void 0) {
-      throw new Error("Mnemo.update: at least one of content/metadata must be provided");
+  /**
+   * Patch an existing memory by id.
+   * Sends `PATCH /v1/memories/{memoryId}` with body `UpdateMemoryDto`
+   * `{ content?, memoryType?, metadata?, source? }` (none required).
+   */
+  async update(memoryId, input) {
+    if (input.content === void 0 && input.memoryType === void 0 && input.metadata === void 0 && input.source === void 0) {
+      throw new Error(
+        "Mnemo.update: at least one of content/memoryType/metadata/source must be provided"
+      );
     }
-    return this.#request("PATCH", `/v1/memories/${encodeURIComponent(id)}`, input);
+    return this.#request(
+      "PATCH",
+      `/v1/memories/${encodeURIComponent(memoryId)}`,
+      input
+    );
   }
-  async get(id) {
-    return this.#request("GET", `/v1/memories/${encodeURIComponent(id)}`);
+  /** Fetch a single memory by id. Sends `GET /v1/memories/{memoryId}`. */
+  async get(memoryId) {
+    return this.#request("GET", `/v1/memories/${encodeURIComponent(memoryId)}`);
   }
-  async delete(id) {
-    await this.#request("DELETE", `/v1/memories/${encodeURIComponent(id)}`);
+  /** Remove a memory by id. Sends `DELETE /v1/memories/{memoryId}`. */
+  async delete(memoryId) {
+    await this.#request(
+      "DELETE",
+      `/v1/memories/${encodeURIComponent(memoryId)}`
+    );
   }
+  /**
+   * Cursor-paginated list of memories, optionally filtered by container.
+   * Sends `GET /v1/memories` with query
+   * `limit?, cursor?, scopeType?, scopeId?, containerTag?`.
+   */
   async list(input) {
     const params = new URLSearchParams();
     if (input?.limit !== void 0) params.set("limit", String(input.limit));
     if (input?.cursor !== void 0) params.set("cursor", input.cursor);
-    if (input?.actorId !== void 0) params.set("actorId", input.actorId);
+    if (input?.scopeType !== void 0) params.set("scopeType", input.scopeType);
+    if (input?.scopeId !== void 0) params.set("scopeId", input.scopeId);
+    if (input?.containerTag !== void 0) params.set("containerTag", input.containerTag);
     const qs = params.toString();
     return this.#request("GET", `/v1/memories${qs ? `?${qs}` : ""}`);
   }
   /** Echoed back for debugging — never sent to the wire. */
-  get defaultActorId() {
-    return this.#defaultActorId;
+  get defaultContainerTag() {
+    return this.#defaultContainerTag;
   }
   async #request(method, path, body) {
     const serializedBody = body === void 0 ? void 0 : JSON.stringify(body);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export class MnemoError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'MnemoError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoHTTPError extends MnemoError {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly body?: unknown,\n  ) {\n    super(`[${status}] ${message}`)\n    this.name = 'MnemoHTTPError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoTimeoutError extends MnemoError {\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`)\n    this.name = 'MnemoTimeoutError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","/**\n * Mnemo Memory client.\n *\n * Zero runtime dependencies — uses the global `fetch` (Node 18+, Bun, browsers,\n * Cloudflare Workers, Deno, etc).\n *\n * @example\n * ```ts\n * import { Mnemo } from 'getmnemo'\n *\n * const memory = new Mnemo({\n *   apiKey: process.env.GETMNEMO_API_KEY!,\n *   workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,\n * })\n *\n * await memory.add({ content: 'User prefers Japanese rice.' })\n * const { hits } = await memory.search({ query: 'what rice does the user like?' })\n * ```\n */\n\nimport { MnemoHTTPError, MnemoTimeoutError } from './errors.js'\nimport type {\n  ClientConfig,\n  Memory,\n  PaginatedMemories,\n  SearchResponse,\n} from './types.js'\n\nconst DEFAULT_BASE_URL = 'https://api.mnemohq.com'\nconst DEFAULT_TIMEOUT_MS = 30_000\nconst SDK_VERSION = '0.1.0'\nconst USER_AGENT = `getmnemo/${SDK_VERSION}`\nconst DEFAULT_MAX_RETRIES = 3\nconst RETRY_BASE_DELAY_MS = 200\nconst RETRY_MAX_DELAY_MS = 5_000\n\n// Browsers reject `user-agent` as a forbidden header — setting it via fetch\n// throws or warns. Detect a browser-like environment so we can skip it there.\nconst IS_BROWSER_LIKE =\n  typeof globalThis !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).window !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).document !== 'undefined'\n\nfunction retryDelayMs(attempt: number): number {\n  const capped = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS)\n  // Full jitter.\n  return Math.floor(Math.random() * capped)\n}\n\nfunction isRetryableStatus(status: number): boolean {\n  // 501 Not Implemented is a permanent failure — retrying just wastes round-trips.\n  if (status === 501) return false\n  return status === 429 || (status >= 500 && status < 600)\n}\n\nfunction parseRetryAfterMs(headerValue: string | null): number | null {\n  if (!headerValue) return null\n  const trimmed = headerValue.trim()\n  // Delta-seconds form.\n  const seconds = Number(trimmed)\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(seconds * 1000, RETRY_MAX_DELAY_MS)\n  }\n  // HTTP-date form.\n  const epoch = Date.parse(trimmed)\n  if (!Number.isNaN(epoch)) {\n    const delta = epoch - Date.now()\n    return Math.max(0, Math.min(delta, RETRY_MAX_DELAY_MS))\n  }\n  return null\n}\n\nfunction delayForResponse(res: Response, attempt: number): number {\n  const hint = parseRetryAfterMs(res.headers.get('retry-after'))\n  return hint !== null ? hint : retryDelayMs(attempt)\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nexport class Mnemo {\n  readonly #baseUrl: string\n  readonly #headers: Record<string, string>\n  readonly #fetch: typeof fetch\n  readonly #timeoutMs: number\n  readonly #maxRetries: number\n  readonly #defaultActorId: string | undefined\n\n  constructor(cfg: ClientConfig) {\n    if (!cfg.apiKey) throw new Error('Mnemo: apiKey is required')\n    if (!cfg.workspaceId) throw new Error('Mnemo: workspaceId is required')\n    this.#baseUrl = (cfg.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n    this.#headers = {\n      authorization: `Bearer ${cfg.apiKey}`,\n      'x-workspace-id': cfg.workspaceId,\n      'content-type': 'application/json',\n    }\n    // `user-agent` is on the forbidden header list in browsers — setting it\n    // via fetch is silently dropped or throws. Send `x-getmnemo-client` as\n    // an SDK identifier in browsers, and the standard User-Agent on Node.\n    if (IS_BROWSER_LIKE) {\n      this.#headers['x-getmnemo-client'] = USER_AGENT\n    } else {\n      this.#headers['user-agent'] = USER_AGENT\n    }\n    if (cfg.actorId) this.#headers['x-actor-id'] = cfg.actorId\n    this.#defaultActorId = cfg.actorId\n    this.#fetch = cfg.fetch ?? fetch\n    this.#timeoutMs = cfg.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.#maxRetries = Math.max(0, cfg.maxRetries ?? DEFAULT_MAX_RETRIES)\n  }\n\n  async search(input: {\n    query: string\n    limit?: number\n    actorId?: string\n  }): Promise<SearchResponse> {\n    return this.#request<SearchResponse>('POST', '/v1/search', {\n      query: input.query,\n      limit: input.limit ?? 8,\n      ...(input.actorId !== undefined ? { actorId: input.actorId } : {}),\n    })\n  }\n\n  async add(input: {\n    content: string\n    metadata?: Record<string, unknown>\n    actorId?: string\n  }): Promise<Memory> {\n    return this.#request<Memory>('POST', '/v1/memories', {\n      content: input.content,\n      ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),\n      ...(input.actorId !== undefined ? { actorId: input.actorId } : {}),\n    })\n  }\n\n  async update(\n    id: string,\n    input: { content?: string; metadata?: Record<string, unknown> },\n  ): Promise<Memory> {\n    if (input.content === undefined && input.metadata === undefined) {\n      throw new Error('Mnemo.update: at least one of content/metadata must be provided')\n    }\n    return this.#request<Memory>('PATCH', `/v1/memories/${encodeURIComponent(id)}`, input)\n  }\n\n  async get(id: string): Promise<Memory> {\n    return this.#request<Memory>('GET', `/v1/memories/${encodeURIComponent(id)}`)\n  }\n\n  async delete(id: string): Promise<void> {\n    await this.#request<unknown>('DELETE', `/v1/memories/${encodeURIComponent(id)}`)\n  }\n\n  async list(input?: {\n    limit?: number\n    cursor?: string\n    actorId?: string\n  }): Promise<PaginatedMemories> {\n    const params = new URLSearchParams()\n    if (input?.limit !== undefined) params.set('limit', String(input.limit))\n    if (input?.cursor !== undefined) params.set('cursor', input.cursor)\n    if (input?.actorId !== undefined) params.set('actorId', input.actorId)\n    const qs = params.toString()\n    return this.#request<PaginatedMemories>('GET', `/v1/memories${qs ? `?${qs}` : ''}`)\n  }\n\n  /** Echoed back for debugging — never sent to the wire. */\n  get defaultActorId(): string | undefined {\n    return this.#defaultActorId\n  }\n\n  async #request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const serializedBody = body === undefined ? undefined : JSON.stringify(body)\n    let lastErr: unknown\n    for (let attempt = 0; attempt <= this.#maxRetries; attempt++) {\n      const ctrl = new AbortController()\n      const timer = setTimeout(() => ctrl.abort(), this.#timeoutMs)\n      try {\n        const res = await this.#fetch(`${this.#baseUrl}${path}`, {\n          method,\n          headers: { ...this.#headers },\n          body: serializedBody,\n          signal: ctrl.signal,\n        })\n        if (isRetryableStatus(res.status) && attempt < this.#maxRetries) {\n          // Capture Retry-After before draining; some runtimes invalidate\n          // headers once the body is consumed.\n          const wait = delayForResponse(res, attempt)\n          // Drain body so the underlying connection can be reused.\n          await res.text().catch(() => undefined)\n          await sleep(wait)\n          continue\n        }\n        const text = await res.text()\n        const parsed: unknown = text ? safeJson(text) : undefined\n        if (!res.ok) {\n          const message =\n            (parsed && typeof parsed === 'object' && 'message' in parsed\n              ? String((parsed as { message: unknown }).message)\n              : null) ?? `HTTP ${res.status} ${res.statusText}`\n          throw new MnemoHTTPError(message, res.status, parsed)\n        }\n        return parsed as T\n      } catch (err) {\n        if (err instanceof Error && err.name === 'AbortError') {\n          throw new MnemoTimeoutError(this.#timeoutMs)\n        }\n        if (err instanceof MnemoHTTPError) throw err\n        lastErr = err\n        if (attempt < this.#maxRetries) {\n          await sleep(retryDelayMs(attempt))\n          continue\n        }\n        throw err\n      } finally {\n        clearTimeout(timer)\n      }\n    }\n    throw lastErr ?? new Error('Mnemo: request failed')\n  }\n}\n\nfunction safeJson(s: string): unknown {\n  try {\n    return JSON.parse(s)\n  } catch {\n    return s\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":";AAAO,IAAM,UAAA,GAAN,cAAyB,KAAA,CAAM;AAAA,EACpC,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AACF;AAEO,IAAM,cAAA,GAAN,cAA6B,UAAA,CAAW;AAAA,EAC7C,WAAA,CACE,OAAA,EACS,MAAA,EACA,IAAA,EACT;AACA,IAAA,KAAA,CAAM,CAAA,CAAA,EAAI,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,CAAE,CAAA;AAHrB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AACA,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAGT,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AAAA,EANW,MAAA;AAAA,EACA,IAAA;AAMb;AAEO,IAAM,iBAAA,GAAN,cAAgC,UAAA,CAAW;AAAA,EAChD,YAAY,SAAA,EAAmB;AAC7B,IAAA,KAAA,CAAM,CAAA,wBAAA,EAA2B,SAAS,CAAA,EAAA,CAAI,CAAA;AAC9C,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AACF;;;ACIA,IAAM,gBAAA,GAAmB,yBAAA;AACzB,IAAM,kBAAA,GAAqB,GAAA;AAC3B,IAAM,WAAA,GAAc,OAAA;AACpB,IAAM,oBAAA,GAAuB,CAAA;AAC7B,IAAM,UAAA,GAAa,YAAY,WAAW,CAAA,CAAA;AAC1C,IAAM,mBAAA,GAAsB,CAAA;AAC5B,IAAM,mBAAA,GAAsB,GAAA;AAC5B,IAAM,kBAAA,GAAqB,GAAA;AAI3B,IAAM,eAAA,GACJ,OAAO,UAAA,KAAe,WAAA;AAEtB,OAAQ,WAAmB,MAAA,KAAW,WAAA;AAEtC,OAAQ,WAAmB,QAAA,KAAa,WAAA;AAE1C,SAAS,aAAa,OAAA,EAAyB;AAC7C,EAAA,MAAM,SAAS,IAAA,CAAK,GAAA,CAAI,mBAAA,GAAsB,CAAA,IAAK,SAAS,kBAAkB,CAAA;AAE9E,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,MAAM,CAAA;AAC1C;AAEA,SAAS,kBAAkB,MAAA,EAAyB;AAElD,EAAA,IAAI,MAAA,KAAW,KAAK,OAAO,KAAA;AAC3B,EAAA,OAAO,MAAA,KAAW,GAAA,IAAQ,MAAA,IAAU,GAAA,IAAO,MAAA,GAAS,GAAA;AACtD;AAEA,SAAS,kBAAkB,WAAA,EAA2C;AACpE,EAAA,IAAI,CAAC,aAAa,OAAO,IAAA;AACzB,EAAA,MAAM,OAAA,GAAU,YAAY,IAAA,EAAK;AAEjC,EAAA,MAAM,OAAA,GAAU,OAAO,OAAO,CAAA;AAC9B,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,WAAW,CAAA,EAAG;AAC5C,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,OAAA,GAAU,GAAA,EAAM,kBAAkB,CAAA;AAAA,EACpD;AAEA,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,OAAO,CAAA;AAChC,EAAA,IAAI,CAAC,MAAA,CAAO,KAAA,CAAM,KAAK,CAAA,EAAG;AACxB,IAAA,MAAM,KAAA,GAAQ,KAAA,GAAQ,IAAA,CAAK,GAAA,EAAI;AAC/B,IAAA,OAAO,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,GAAA,CAAI,KAAA,EAAO,kBAAkB,CAAC,CAAA;AAAA,EACxD;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,gBAAA,CAAiB,KAAe,OAAA,EAAyB;AAChE,EAAA,MAAM,OAAO,iBAAA,CAAkB,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAC7D,EAAA,OAAO,IAAA,KAAS,IAAA,GAAO,IAAA,GAAO,YAAA,CAAa,OAAO,CAAA;AACpD;AAEA,SAAS,MAAM,EAAA,EAA2B;AACxC,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD;AAEO,IAAM,QAAN,MAAY;AAAA,EACR,QAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA;AAAA,EACA,WAAA;AAAA,EACA,oBAAA;AAAA,EAET,YAAY,GAAA,EAAmB;AAC7B,IAAA,IAAI,CAAC,GAAA,CAAI,MAAA,EAAQ,MAAM,IAAI,MAAM,2BAA2B,CAAA;AAC5D,IAAA,IAAI,CAAC,GAAA,CAAI,WAAA,EAAa,MAAM,IAAI,MAAM,gCAAgC,CAAA;AACtE,IAAA,IAAA,CAAK,YAAY,GAAA,CAAI,OAAA,IAAW,gBAAA,EAAkB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACnE,IAAA,IAAA,CAAK,QAAA,GAAW;AAAA,MACd,aAAA,EAAe,CAAA,OAAA,EAAU,GAAA,CAAI,MAAM,CAAA,CAAA;AAAA,MACnC,kBAAkB,GAAA,CAAI,WAAA;AAAA,MACtB,cAAA,EAAgB;AAAA,KAClB;AAIA,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,IAAA,CAAK,QAAA,CAAS,mBAAmB,CAAA,GAAI,UAAA;AAAA,IACvC,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,QAAA,CAAS,YAAY,CAAA,GAAI,UAAA;AAAA,IAChC;AACA,IAAA,IAAA,CAAK,uBAAuB,GAAA,CAAI,mBAAA;AAChC,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,KAAA,IAAS,KAAA;AAC3B,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,SAAA,IAAa,kBAAA;AACnC,IAAA,IAAA,CAAK,cAAc,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,GAAA,CAAI,cAAc,mBAAmB,CAAA;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBAAA,CACE,QACA,KAAA,EAC6C;AAC7C,IAAA,IAAI,MAAM,KAAA,EAAO,OAAO,EAAE,KAAA,EAAO,MAAM,KAAA,EAAM;AAC7C,IAAA,MAAM,GAAA,GAAM,KAAA,CAAM,YAAA,IAAgB,IAAA,CAAK,oBAAA;AACvC,IAAA,IAAI,GAAA,EAAK,OAAO,EAAE,YAAA,EAAc,GAAA,EAAI;AACpC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,SAAS,MAAM,CAAA,iJAAA;AAAA,KAEjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,KAAA,EAMe;AAC1B,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,iBAAA,CAAkB,QAAA,EAAU,KAAK,CAAA;AACxD,IAAA,OAAO,IAAA,CAAK,QAAA,CAAyB,MAAA,EAAQ,YAAA,EAAc;AAAA,MACzD,GAAG,KAAA,CAAM,CAAA;AAAA,MACT,KAAA,EAAO,MAAM,KAAA,IAAS,oBAAA;AAAA,MACtB,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI,EAAC;AAAA,MACzE,GAAG;AAAA,KACJ,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,IAAI,KAAA,EAKe;AACvB,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,iBAAA,CAAkB,KAAA,EAAO,KAAK,CAAA;AACrD,IAAA,OAAO,IAAA,CAAK,QAAA,CAAsB,MAAA,EAAQ,cAAA,EAAgB;AAAA,MACxD,KAAA,EAAO;AAAA,QACL;AAAA,UACE,SAAS,KAAA,CAAM,OAAA;AAAA,UACf,GAAI,MAAM,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,KAAA,CAAM,QAAA,EAAS,GAAI;AAAC;AACrE,OACF;AAAA,MACA,GAAG;AAAA,KACJ,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MAAA,CACJ,QAAA,EACA,KAAA,EAMiB;AACjB,IAAA,IACE,KAAA,CAAM,OAAA,KAAY,MAAA,IAClB,KAAA,CAAM,UAAA,KAAe,MAAA,IACrB,KAAA,CAAM,QAAA,KAAa,MAAA,IACnB,KAAA,CAAM,MAAA,KAAW,MAAA,EACjB;AACA,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,MACV,OAAA;AAAA,MACA,CAAA,aAAA,EAAgB,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAA;AAAA,MAC5C;AAAA,KACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,IAAI,QAAA,EAAmC;AAC3C,IAAA,OAAO,KAAK,QAAA,CAAiB,KAAA,EAAO,gBAAgB,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAE,CAAA;AAAA,EACpF;AAAA;AAAA,EAGA,MAAM,OAAO,QAAA,EAAiC;AAC5C,IAAA,MAAM,IAAA,CAAK,QAAA;AAAA,MACT,QAAA;AAAA,MACA,CAAA,aAAA,EAAgB,kBAAA,CAAmB,QAAQ,CAAC,CAAA;AAAA,KAC9C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAK,KAAA,EAMoB;AAC7B,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,KAAA,EAAO,UAAU,MAAA,EAAW,MAAA,CAAO,IAAI,OAAA,EAAS,MAAA,CAAO,KAAA,CAAM,KAAK,CAAC,CAAA;AACvE,IAAA,IAAI,OAAO,MAAA,KAAW,MAAA,SAAkB,GAAA,CAAI,QAAA,EAAU,MAAM,MAAM,CAAA;AAClE,IAAA,IAAI,OAAO,SAAA,KAAc,MAAA,SAAkB,GAAA,CAAI,WAAA,EAAa,MAAM,SAAS,CAAA;AAC3E,IAAA,IAAI,OAAO,OAAA,KAAY,MAAA,SAAkB,GAAA,CAAI,SAAA,EAAW,MAAM,OAAO,CAAA;AACrE,IAAA,IAAI,OAAO,YAAA,KAAiB,MAAA,SAAkB,GAAA,CAAI,cAAA,EAAgB,MAAM,YAAY,CAAA;AACpF,IAAA,MAAM,EAAA,GAAK,OAAO,QAAA,EAAS;AAC3B,IAAA,OAAO,IAAA,CAAK,SAA4B,KAAA,EAAO,CAAA,YAAA,EAAe,KAAK,CAAA,CAAA,EAAI,EAAE,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AAAA,EACpF;AAAA;AAAA,EAGA,IAAI,mBAAA,GAA0C;AAC5C,IAAA,OAAO,IAAA,CAAK,oBAAA;AAAA,EACd;AAAA,EAEA,MAAM,QAAA,CAAY,MAAA,EAAgB,IAAA,EAAc,IAAA,EAA4B;AAC1E,IAAA,MAAM,iBAAiB,IAAA,KAAS,MAAA,GAAY,MAAA,GAAY,IAAA,CAAK,UAAU,IAAI,CAAA;AAC3E,IAAA,IAAI,OAAA;AACJ,IAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,IAAW,IAAA,CAAK,aAAa,OAAA,EAAA,EAAW;AAC5D,MAAA,MAAM,IAAA,GAAO,IAAI,eAAA,EAAgB;AACjC,MAAA,MAAM,QAAQ,UAAA,CAAW,MAAM,KAAK,KAAA,EAAM,EAAG,KAAK,UAAU,CAAA;AAC5D,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,GAAG,IAAA,CAAK,QAAQ,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,UACvD,MAAA;AAAA,UACA,OAAA,EAAS,EAAE,GAAG,IAAA,CAAK,QAAA,EAAS;AAAA,UAC5B,IAAA,EAAM,cAAA;AAAA,UACN,QAAQ,IAAA,CAAK;AAAA,SACd,CAAA;AACD,QAAA,IAAI,kBAAkB,GAAA,CAAI,MAAM,CAAA,IAAK,OAAA,GAAU,KAAK,WAAA,EAAa;AAG/D,UAAA,MAAM,IAAA,GAAO,gBAAA,CAAiB,GAAA,EAAK,OAAO,CAAA;AAE1C,UAAA,MAAM,GAAA,CAAI,IAAA,EAAK,CAAE,KAAA,CAAM,MAAM,KAAA,CAAS,CAAA;AACtC,UAAA,MAAM,MAAM,IAAI,CAAA;AAChB,UAAA;AAAA,QACF;AACA,QAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,QAAA,MAAM,MAAA,GAAkB,IAAA,GAAO,QAAA,CAAS,IAAI,CAAA,GAAI,KAAA,CAAA;AAChD,QAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,UAAA,MAAM,WACH,MAAA,IAAU,OAAO,MAAA,KAAW,QAAA,IAAY,aAAa,MAAA,GAClD,MAAA,CAAQ,MAAA,CAAgC,OAAO,IAC/C,IAAA,KAAS,CAAA,KAAA,EAAQ,IAAI,MAAM,CAAA,CAAA,EAAI,IAAI,UAAU,CAAA,CAAA;AACnD,UAAA,MAAM,IAAI,cAAA,CAAe,OAAA,EAAS,GAAA,CAAI,QAAQ,MAAM,CAAA;AAAA,QACtD;AACA,QAAA,OAAO,MAAA;AAAA,MACT,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,GAAA,YAAe,KAAA,IAAS,GAAA,CAAI,IAAA,KAAS,YAAA,EAAc;AACrD,UAAA,MAAM,IAAI,iBAAA,CAAkB,IAAA,CAAK,UAAU,CAAA;AAAA,QAC7C;AACA,QAAA,IAAI,GAAA,YAAe,gBAAgB,MAAM,GAAA;AACzC,QAAA,OAAA,GAAU,GAAA;AACV,QAAA,IAAI,OAAA,GAAU,KAAK,WAAA,EAAa;AAC9B,UAAA,MAAM,KAAA,CAAM,YAAA,CAAa,OAAO,CAAC,CAAA;AACjC,UAAA;AAAA,QACF;AACA,QAAA,MAAM,GAAA;AAAA,MACR,CAAA,SAAE;AACA,QAAA,YAAA,CAAa,KAAK,CAAA;AAAA,MACpB;AAAA,IACF;AACA,IAAA,MAAM,OAAA,IAAW,IAAI,KAAA,CAAM,uBAAuB,CAAA;AAAA,EACpD;AACF;AAEA,SAAS,SAAS,CAAA,EAAoB;AACpC,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,EACrB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,CAAA;AAAA,EACT;AACF","file":"index.js","sourcesContent":["export class MnemoError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'MnemoError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoHTTPError extends MnemoError {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly body?: unknown,\n  ) {\n    super(`[${status}] ${message}`)\n    this.name = 'MnemoHTTPError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class MnemoTimeoutError extends MnemoError {\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`)\n    this.name = 'MnemoTimeoutError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","/**\n * Mnemo Memory client.\n *\n * Zero runtime dependencies — uses the global `fetch` (Node 18+, Bun, browsers,\n * Cloudflare Workers, Deno, etc).\n *\n * @example\n * ```ts\n * import { Mnemo } from 'getmnemo'\n *\n * const memory = new Mnemo({\n *   apiKey: process.env.GETMNEMO_API_KEY!,\n *   workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,\n * })\n *\n * await memory.add({ content: 'User prefers Japanese rice.', containerTag: 'user:jane' })\n * const { results } = await memory.search({ q: 'what rice does the user like?', containerTag: 'user:jane' })\n * ```\n */\n\nimport { MnemoHTTPError, MnemoTimeoutError } from './errors.js'\nimport type {\n  AddResponse,\n  ClientConfig,\n  Memory,\n  PaginatedMemories,\n  Scope,\n  SearchResponse,\n} from './types.js'\n\nconst DEFAULT_BASE_URL = 'https://api.mnemohq.com'\nconst DEFAULT_TIMEOUT_MS = 30_000\nconst SDK_VERSION = '0.2.0'\nconst DEFAULT_SEARCH_LIMIT = 8\nconst USER_AGENT = `getmnemo/${SDK_VERSION}`\nconst DEFAULT_MAX_RETRIES = 3\nconst RETRY_BASE_DELAY_MS = 200\nconst RETRY_MAX_DELAY_MS = 5_000\n\n// Browsers reject `user-agent` as a forbidden header — setting it via fetch\n// throws or warns. Detect a browser-like environment so we can skip it there.\nconst IS_BROWSER_LIKE =\n  typeof globalThis !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).window !== 'undefined' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  typeof (globalThis as any).document !== 'undefined'\n\nfunction retryDelayMs(attempt: number): number {\n  const capped = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS)\n  // Full jitter.\n  return Math.floor(Math.random() * capped)\n}\n\nfunction isRetryableStatus(status: number): boolean {\n  // 501 Not Implemented is a permanent failure — retrying just wastes round-trips.\n  if (status === 501) return false\n  return status === 429 || (status >= 500 && status < 600)\n}\n\nfunction parseRetryAfterMs(headerValue: string | null): number | null {\n  if (!headerValue) return null\n  const trimmed = headerValue.trim()\n  // Delta-seconds form.\n  const seconds = Number(trimmed)\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(seconds * 1000, RETRY_MAX_DELAY_MS)\n  }\n  // HTTP-date form.\n  const epoch = Date.parse(trimmed)\n  if (!Number.isNaN(epoch)) {\n    const delta = epoch - Date.now()\n    return Math.max(0, Math.min(delta, RETRY_MAX_DELAY_MS))\n  }\n  return null\n}\n\nfunction delayForResponse(res: Response, attempt: number): number {\n  const hint = parseRetryAfterMs(res.headers.get('retry-after'))\n  return hint !== null ? hint : retryDelayMs(attempt)\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nexport class Mnemo {\n  readonly #baseUrl: string\n  readonly #headers: Record<string, string>\n  readonly #fetch: typeof fetch\n  readonly #timeoutMs: number\n  readonly #maxRetries: number\n  readonly #defaultContainerTag: string | undefined\n\n  constructor(cfg: ClientConfig) {\n    if (!cfg.apiKey) throw new Error('Mnemo: apiKey is required')\n    if (!cfg.workspaceId) throw new Error('Mnemo: workspaceId is required')\n    this.#baseUrl = (cfg.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n    this.#headers = {\n      authorization: `Bearer ${cfg.apiKey}`,\n      'x-workspace-id': cfg.workspaceId,\n      'content-type': 'application/json',\n    }\n    // `user-agent` is on the forbidden header list in browsers — setting it\n    // via fetch is silently dropped or throws. Send `x-getmnemo-client` as\n    // an SDK identifier in browsers, and the standard User-Agent on Node.\n    if (IS_BROWSER_LIKE) {\n      this.#headers['x-getmnemo-client'] = USER_AGENT\n    } else {\n      this.#headers['user-agent'] = USER_AGENT\n    }\n    this.#defaultContainerTag = cfg.defaultContainerTag\n    this.#fetch = cfg.fetch ?? fetch\n    this.#timeoutMs = cfg.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.#maxRetries = Math.max(0, cfg.maxRetries ?? DEFAULT_MAX_RETRIES)\n  }\n\n  /**\n   * Resolve the container for a call into the request fields the API expects.\n   * A structured `scope` wins over a `containerTag` string; both fall back to\n   * the constructor's `defaultContainerTag`. Throws if none is available.\n   */\n  #resolveContainer(\n    method: 'add' | 'search',\n    input: { containerTag?: string; scope?: Scope },\n  ): { containerTag: string } | { scope: Scope } {\n    if (input.scope) return { scope: input.scope }\n    const tag = input.containerTag ?? this.#defaultContainerTag\n    if (tag) return { containerTag: tag }\n    throw new Error(\n      `Mnemo.${method}: a container is required — pass containerTag (e.g. \"user:jane\") ` +\n        'or scope ({ type, id }) per call, or set defaultContainerTag on the client.',\n    )\n  }\n\n  /**\n   * Hybrid retrieval. Requires a container — pass `containerTag` (e.g.\n   * `\"user:jane\"`) or `scope`, or set `defaultContainerTag` on the client.\n   *\n   * Sends `POST /v1/search` with body `{ q, limit, containerTag|scope }`.\n   */\n  async search(input: {\n    q: string\n    containerTag?: string\n    scope?: Scope\n    limit?: number\n    searchMode?: string\n  }): Promise<SearchResponse> {\n    const container = this.#resolveContainer('search', input)\n    return this.#request<SearchResponse>('POST', '/v1/search', {\n      q: input.q,\n      limit: input.limit ?? DEFAULT_SEARCH_LIMIT,\n      ...(input.searchMode !== undefined ? { searchMode: input.searchMode } : {}),\n      ...container,\n    })\n  }\n\n  /**\n   * Store an atomic fact. Requires a container — pass `containerTag` (e.g.\n   * `\"user:jane\"`) or `scope`, or set `defaultContainerTag` on the client.\n   *\n   * Sends `POST /v1/memories` with body\n   * `{ items: [{ content, metadata? }], containerTag|scope }`.\n   */\n  async add(input: {\n    content: string\n    containerTag?: string\n    scope?: Scope\n    metadata?: Record<string, unknown>\n  }): Promise<AddResponse> {\n    const container = this.#resolveContainer('add', input)\n    return this.#request<AddResponse>('POST', '/v1/memories', {\n      items: [\n        {\n          content: input.content,\n          ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),\n        },\n      ],\n      ...container,\n    })\n  }\n\n  /**\n   * Patch an existing memory by id.\n   * Sends `PATCH /v1/memories/{memoryId}` with body `UpdateMemoryDto`\n   * `{ content?, memoryType?, metadata?, source? }` (none required).\n   */\n  async update(\n    memoryId: string,\n    input: {\n      content?: string\n      memoryType?: string\n      metadata?: Record<string, unknown>\n      source?: string\n    },\n  ): Promise<Memory> {\n    if (\n      input.content === undefined &&\n      input.memoryType === undefined &&\n      input.metadata === undefined &&\n      input.source === undefined\n    ) {\n      throw new Error(\n        'Mnemo.update: at least one of content/memoryType/metadata/source must be provided',\n      )\n    }\n    return this.#request<Memory>(\n      'PATCH',\n      `/v1/memories/${encodeURIComponent(memoryId)}`,\n      input,\n    )\n  }\n\n  /** Fetch a single memory by id. Sends `GET /v1/memories/{memoryId}`. */\n  async get(memoryId: string): Promise<Memory> {\n    return this.#request<Memory>('GET', `/v1/memories/${encodeURIComponent(memoryId)}`)\n  }\n\n  /** Remove a memory by id. Sends `DELETE /v1/memories/{memoryId}`. */\n  async delete(memoryId: string): Promise<void> {\n    await this.#request<unknown>(\n      'DELETE',\n      `/v1/memories/${encodeURIComponent(memoryId)}`,\n    )\n  }\n\n  /**\n   * Cursor-paginated list of memories, optionally filtered by container.\n   * Sends `GET /v1/memories` with query\n   * `limit?, cursor?, scopeType?, scopeId?, containerTag?`.\n   */\n  async list(input?: {\n    containerTag?: string\n    limit?: number\n    cursor?: string\n    scopeType?: string\n    scopeId?: string\n  }): Promise<PaginatedMemories> {\n    const params = new URLSearchParams()\n    if (input?.limit !== undefined) params.set('limit', String(input.limit))\n    if (input?.cursor !== undefined) params.set('cursor', input.cursor)\n    if (input?.scopeType !== undefined) params.set('scopeType', input.scopeType)\n    if (input?.scopeId !== undefined) params.set('scopeId', input.scopeId)\n    if (input?.containerTag !== undefined) params.set('containerTag', input.containerTag)\n    const qs = params.toString()\n    return this.#request<PaginatedMemories>('GET', `/v1/memories${qs ? `?${qs}` : ''}`)\n  }\n\n  /** Echoed back for debugging — never sent to the wire. */\n  get defaultContainerTag(): string | undefined {\n    return this.#defaultContainerTag\n  }\n\n  async #request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const serializedBody = body === undefined ? undefined : JSON.stringify(body)\n    let lastErr: unknown\n    for (let attempt = 0; attempt <= this.#maxRetries; attempt++) {\n      const ctrl = new AbortController()\n      const timer = setTimeout(() => ctrl.abort(), this.#timeoutMs)\n      try {\n        const res = await this.#fetch(`${this.#baseUrl}${path}`, {\n          method,\n          headers: { ...this.#headers },\n          body: serializedBody,\n          signal: ctrl.signal,\n        })\n        if (isRetryableStatus(res.status) && attempt < this.#maxRetries) {\n          // Capture Retry-After before draining; some runtimes invalidate\n          // headers once the body is consumed.\n          const wait = delayForResponse(res, attempt)\n          // Drain body so the underlying connection can be reused.\n          await res.text().catch(() => undefined)\n          await sleep(wait)\n          continue\n        }\n        const text = await res.text()\n        const parsed: unknown = text ? safeJson(text) : undefined\n        if (!res.ok) {\n          const message =\n            (parsed && typeof parsed === 'object' && 'message' in parsed\n              ? String((parsed as { message: unknown }).message)\n              : null) ?? `HTTP ${res.status} ${res.statusText}`\n          throw new MnemoHTTPError(message, res.status, parsed)\n        }\n        return parsed as T\n      } catch (err) {\n        if (err instanceof Error && err.name === 'AbortError') {\n          throw new MnemoTimeoutError(this.#timeoutMs)\n        }\n        if (err instanceof MnemoHTTPError) throw err\n        lastErr = err\n        if (attempt < this.#maxRetries) {\n          await sleep(retryDelayMs(attempt))\n          continue\n        }\n        throw err\n      } finally {\n        clearTimeout(timer)\n      }\n    }\n    throw lastErr ?? new Error('Mnemo: request failed')\n  }\n}\n\nfunction safeJson(s: string): unknown {\n  try {\n    return JSON.parse(s)\n  } catch {\n    return s\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getmnemo",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Official TypeScript / JavaScript SDK for Mnemo Memory — long-term memory infrastructure for AI agents.",
   "type": "module",
   "license": "MIT",
@@ -28,7 +28,8 @@
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "smoke": "node scripts/prod-smoke.mjs"
   },
   "keywords": [
     "mnemo",