@neo4j-labs/agent-memory 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -9,6 +9,35 @@ appear in minor versions with a callout in this file.
 
 ## [Unreleased]
 
+## 0.4.0 — NAMS alignment
+
+Adds workspace addressing, a first-class ontology surface
+(`client.ontology`), a `conversationId` alias on the short-term methods,
+and an explicit `longTerm.waitForExtraction(...)` await for the
+asynchronous NAMS extraction pipeline. First release cut from the
+polyglot `neo4j-labs/agent-memory` repository, published under
+namespaced `typescript-v*` tags.
+
+### Added
+
+- **Workspace addressing.** `MemoryClientOptions.workspaceId` (and the
+  `MEMORY_WORKSPACE_ID` environment variable) is transmitted automatically as
+  the `X-Workspace-Id` header on every request — required by header-scoped
+  deployments (e.g. the development/staging service). An explicit
+  `X-Workspace-Id` entry in `headers` wins; unset is harmless on production.
+- **Ontology surface (`client.ontology`).** `list()`, `get()`, `getActive()`,
+  `clone()`, `create()`, `update()`, `activate()`, `delete()` over the NAMS
+  domain-ontology engine, with typed models (`OntologySummary`,
+  `OntologyVersion`, `OntologyDocument`, …) and `permissive`/`strict`
+  validation modes. `getActive()` surfaces the active version's
+  `validationMode`.
+- **`conversationId` alias** on short-term methods (`addMessage`,
+  `getConversation`, `searchMessages`, `clearSession`) as an alias for
+  `sessionId` (`sessionId` wins).
+- **`longTerm.waitForExtraction(...)`** — await the asynchronous NAMS
+  extraction pipeline explicitly (polls entity search for `expectedNames` /
+  a `predicate`; returns a boolean).
+
 ### Changed
 
 - Repository moved from

package/README.md

@@ -4,11 +4,11 @@
 ![Status: Beta](https://img.shields.io/badge/Status-Beta-6366F1)
 ![Community Supported](https://img.shields.io/badge/Support-Community-6B7280)
 
-> **New home:** this package moved from
-> [`neo4j-labs/agent-memory-tck`](https://github.com/neo4j-labs/agent-memory-tck)
-> to [`neo4j-labs/agent-memory`](https://github.com/neo4j-labs/agent-memory),
-> alongside the Python SDK. Install path, package name, and exports are
-> unchanged — `npm install @neo4j-labs/agent-memory`.
+> **Now on npm.** Install with `npm install @neo4j-labs/agent-memory`
+> ([package page](https://www.npmjs.com/package/@neo4j-labs/agent-memory)).
+> Source lives alongside the Python SDK at
+> [`neo4j-labs/agent-memory`](https://github.com/neo4j-labs/agent-memory)
+> (relocated from `neo4j-labs/agent-memory-tck`).
 
 > TypeScript client for the Neo4j Agent Memory Service — short-term,
 > long-term, and reasoning memory for AI agents, backed by Neo4j.

package/dist/{chunk-TGBKROHO.js → chunk-E752ALCR.js}

@@ -1,7 +1,7 @@
 import { ConnectionError, AuthenticationError, TransportError } from './chunk-ASQMU7YC.js';
 
 // src/version.ts
-var VERSION = "0.3.0";
+var VERSION = "0.4.0";
 
 // src/observability.ts
 function defaultUserAgent() {
@@ -222,5 +222,5 @@ var BridgeTransport = class {
 };
 
 export { BridgeTransport, VERSION, defaultUserAgent, extractRequestId, supportsUserAgentHeader };
-//# sourceMappingURL=chunk-TGBKROHO.js.map
-//# sourceMappingURL=chunk-TGBKROHO.js.map
+//# sourceMappingURL=chunk-E752ALCR.js.map
+//# sourceMappingURL=chunk-E752ALCR.js.map

package/dist/{chunk-TGBKROHO.js.map → chunk-E752ALCR.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts","../src/observability.ts","../src/transport/bridge.ts"],"names":["durationMs"],"mappings":"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","file":"chunk-TGBKROHO.js","sourcesContent":["/**\n * Package version constant. Kept in sync with package.json via a\n * dedicated version-check script run in CI. Imported by the transports to build\n * the default User-Agent header.\n */\nexport const VERSION = \"0.3.0\";\n","/**\n * Observability primitives — User-Agent header building and the typed\n * logger event stream emitted by both transports.\n */\n\nimport { VERSION } from \"./version.js\";\n\n/**\n * Build the default User-Agent string. Mirrors the convention used by other\n * Anthropic / OpenAI SDKs: `<package>/<version> (<runtime>; <platform>)`.\n *\n * Detection is best-effort and silently degrades on edge runtimes where\n * `process` is unavailable.\n */\nexport function defaultUserAgent(): string {\n  const runtime = detectRuntime();\n  return runtime\n    ? `@neo4j-labs/agent-memory/${VERSION} (${runtime})`\n    : `@neo4j-labs/agent-memory/${VERSION}`;\n}\n\nexport function supportsUserAgentHeader(): boolean {\n  return detectRuntime() !== null;\n}\n\nfunction detectRuntime(): string | null {\n  // Deno\n  const denoObj = (globalThis as { Deno?: { version?: { deno?: string } } }).Deno;\n  if (denoObj?.version?.deno) {\n    return `deno/${denoObj.version.deno}`;\n  }\n  // Bun\n  const bunObj = (globalThis as { Bun?: { version?: string } }).Bun;\n  if (bunObj?.version) {\n    return `bun/${bunObj.version}`;\n  }\n  // Node\n  if (typeof process !== \"undefined\" && process.versions?.node) {\n    const platform = process.platform ?? \"unknown\";\n    return `node/${process.versions.node}; ${platform}`;\n  }\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Logger\n// ---------------------------------------------------------------------------\n\n/** Single event emitted to the user-supplied logger. */\nexport type LogEvent =\n  | {\n      kind: \"request\";\n      method: string;\n      url: string;\n      httpMethod?: string;\n    }\n  | {\n      kind: \"response\";\n      method: string;\n      url: string;\n      status: number;\n      requestId?: string;\n      durationMs: number;\n    }\n  | {\n      kind: \"error\";\n      method: string;\n      url: string;\n      status?: number;\n      requestId?: string;\n      durationMs: number;\n      message: string;\n    };\n\nexport type Logger = (event: LogEvent) => void;\n\n/**\n * Extract a request-id from a Response. The hosted service emits one of\n * `x-request-id`, `request-id`, or `x-amzn-RequestId` depending on the edge\n * the request lands on. Caller-side correlation works as long as one is\n * present.\n */\nexport function extractRequestId(headers: Headers): string | undefined {\n  return (\n    headers.get(\"x-request-id\") ??\n    headers.get(\"request-id\") ??\n    headers.get(\"x-amzn-requestid\") ??\n    undefined\n  );\n}\n","/**\n * BridgeTransport — TCK bridge protocol transport.\n *\n * Speaks the bridge wire format (POST {endpoint}/{snake_case_method}) used by\n * conformance servers and the local reference adapter. Compatible with every\n * fetch-capable runtime (Node 20+, Bun, Deno, Workers, Edge).\n */\n\nimport { AuthenticationError, ConnectionError, TransportError } from \"../errors.js\";\nimport {\n  defaultUserAgent,\n  extractRequestId,\n  supportsUserAgentHeader,\n  type Logger,\n} from \"../observability.js\";\nimport type { Transport } from \"./index.js\";\n\n/** Strip trailing `/` from a URL without using a polynomial regex. */\nfunction trimTrailingSlashes(s: string): string {\n  let end = s.length;\n  while (end > 0 && s.charCodeAt(end - 1) === 47) end--;\n  return s.slice(0, end);\n}\n\nfunction nowMs(): number {\n  if (typeof performance !== \"undefined\" && typeof performance.now === \"function\") {\n    return performance.now();\n  }\n  return Date.now();\n}\n\nexport interface BridgeTransportOptions {\n  /** Base URL of the bridge endpoint (no trailing /v1). */\n  endpoint: string;\n\n  /** API key for Bearer auth. Optional for local bridge servers. */\n  apiKey?: string;\n\n  /** Request timeout in milliseconds. Default: 30000. */\n  timeout?: number;\n\n  /** Additional headers to include in every request. */\n  headers?: Record<string, string>;\n\n  /** Per-request logger. */\n  logger?: Logger;\n}\n\nexport class BridgeTransport implements Transport {\n  private readonly endpoint: string;\n  private readonly apiKey?: string;\n  private readonly timeout: number;\n  private readonly headers: Record<string, string>;\n  private readonly logger?: Logger;\n\n  constructor(options: BridgeTransportOptions) {\n    this.endpoint = trimTrailingSlashes(options.endpoint);\n    this.apiKey = options.apiKey;\n    this.timeout = options.timeout ?? 30_000;\n    this.headers = options.headers ?? {};\n    this.logger = options.logger;\n  }\n\n  async connect(): Promise<void> {\n    const url = `${this.endpoint}/setup`;\n    const start = nowMs();\n    this.emit({ kind: \"request\", method: \"connect\", url, httpMethod: \"POST\" });\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: this.buildHeaders(),\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (error) {\n      const durationMs = nowMs() - start;\n      if (error instanceof TypeError) {\n        const err = new ConnectionError(\n          `Failed to connect to ${this.endpoint}: ${(error as Error).message}`,\n          { cause: error },\n        );\n        this.emit({ kind: \"error\", method: \"connect\", url, durationMs, message: err.message });\n        throw err;\n      }\n      if (error instanceof DOMException && error.name === \"TimeoutError\") {\n        const err = new ConnectionError(\n          `Connection to ${this.endpoint} timed out after ${this.timeout}ms`,\n          { cause: error },\n        );\n        this.emit({ kind: \"error\", method: \"connect\", url, durationMs, message: err.message });\n        throw err;\n      }\n      throw error;\n    }\n    const durationMs = nowMs() - start;\n    const requestId = extractRequestId(response.headers);\n    if (response.status === 401 || response.status === 403) {\n      const err = new AuthenticationError(\n        `Authentication failed: ${response.status} ${response.statusText}`,\n        { requestId },\n      );\n      this.emit({\n        kind: \"error\",\n        method: \"connect\",\n        url,\n        status: response.status,\n        requestId,\n        durationMs,\n        message: err.message,\n      });\n      throw err;\n    }\n    this.emit({\n      kind: \"response\",\n      method: \"connect\",\n      url,\n      status: response.status,\n      requestId,\n      durationMs,\n    });\n  }\n\n  async close(): Promise<void> {}\n\n  async request<T>(method: string, params: Record<string, unknown>): Promise<T> {\n    const url = `${this.endpoint}/${method}`;\n\n    const body: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(params)) {\n      if (value !== undefined && value !== null) {\n        body[key] = value;\n      }\n    }\n\n    const start = nowMs();\n    this.emit({ kind: \"request\", method, url, httpMethod: \"POST\" });\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: this.buildHeaders(),\n        body: JSON.stringify(body),\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (error) {\n      const durationMs = nowMs() - start;\n      if (error instanceof TypeError) {\n        const err = new ConnectionError(\n          `Request to ${url} failed: ${(error as Error).message}`,\n          { cause: error },\n        );\n        this.emit({ kind: \"error\", method, url, durationMs, message: err.message });\n        throw err;\n      }\n      throw error;\n    }\n\n    const requestId = extractRequestId(response.headers);\n    const durationMs = nowMs() - start;\n\n    if (response.status === 401 || response.status === 403) {\n      const err = new AuthenticationError(\n        `Authentication failed: ${response.status} ${response.statusText}`,\n        { requestId },\n      );\n      this.emit({\n        kind: \"error\",\n        method,\n        url,\n        status: response.status,\n        requestId,\n        durationMs,\n        message: err.message,\n      });\n      throw err;\n    }\n\n    if (response.status === 204) {\n      this.emit({ kind: \"response\", method, url, status: 204, requestId, durationMs });\n      return undefined as T;\n    }\n\n    const text = await response.text();\n\n    if (!response.ok) {\n      let errorBody: unknown;\n      try {\n        errorBody = JSON.parse(text);\n      } catch {\n        errorBody = text;\n      }\n      const errorMessage =\n        typeof errorBody === \"object\" && errorBody !== null && \"error\" in errorBody\n          ? String((errorBody as Record<string, unknown>)[\"error\"])\n          : `HTTP ${response.status}`;\n      const err = new TransportError(\n        `${method} failed: ${errorMessage}`,\n        response.status,\n        errorBody,\n        { requestId },\n      );\n      this.emit({\n        kind: \"error\",\n        method,\n        url,\n        status: response.status,\n        requestId,\n        durationMs,\n        message: err.message,\n      });\n      throw err;\n    }\n\n    this.emit({ kind: \"response\", method, url, status: response.status, requestId, durationMs });\n\n    if (!text) return undefined as T;\n    return JSON.parse(text) as T;\n  }\n\n  private emit(event: Parameters<Logger>[0]): void {\n    if (!this.logger) return;\n    try {\n      this.logger(event);\n    } catch {\n      // Logger errors must never propagate.\n    }\n  }\n\n  private buildHeaders(): Record<string, string> {\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    const canSendUserAgent = supportsUserAgentHeader();\n    for (const [key, value] of Object.entries(this.headers)) {\n      if (key.toLowerCase() === \"user-agent\" && !canSendUserAgent) continue;\n      headers[key] = value;\n    }\n    if (canSendUserAgent && !Object.keys(headers).some((key) => key.toLowerCase() === \"user-agent\")) {\n      headers[\"User-Agent\"] = defaultUserAgent();\n    }\n    if (this.apiKey) {\n      headers[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    }\n    return headers;\n  }\n}\n"]}
+{"version":3,"sources":["../src/version.ts","../src/observability.ts","../src/transport/bridge.ts"],"names":["durationMs"],"mappings":"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","file":"chunk-E752ALCR.js","sourcesContent":["/**\n * Package version constant. Kept in sync with package.json via a\n * dedicated version-check script run in CI. Imported by the transports to build\n * the default User-Agent header.\n */\nexport const VERSION = \"0.4.0\";\n","/**\n * Observability primitives — User-Agent header building and the typed\n * logger event stream emitted by both transports.\n */\n\nimport { VERSION } from \"./version.js\";\n\n/**\n * Build the default User-Agent string. Mirrors the convention used by other\n * Anthropic / OpenAI SDKs: `<package>/<version> (<runtime>; <platform>)`.\n *\n * Detection is best-effort and silently degrades on edge runtimes where\n * `process` is unavailable.\n */\nexport function defaultUserAgent(): string {\n  const runtime = detectRuntime();\n  return runtime\n    ? `@neo4j-labs/agent-memory/${VERSION} (${runtime})`\n    : `@neo4j-labs/agent-memory/${VERSION}`;\n}\n\nexport function supportsUserAgentHeader(): boolean {\n  return detectRuntime() !== null;\n}\n\nfunction detectRuntime(): string | null {\n  // Deno\n  const denoObj = (globalThis as { Deno?: { version?: { deno?: string } } }).Deno;\n  if (denoObj?.version?.deno) {\n    return `deno/${denoObj.version.deno}`;\n  }\n  // Bun\n  const bunObj = (globalThis as { Bun?: { version?: string } }).Bun;\n  if (bunObj?.version) {\n    return `bun/${bunObj.version}`;\n  }\n  // Node\n  if (typeof process !== \"undefined\" && process.versions?.node) {\n    const platform = process.platform ?? \"unknown\";\n    return `node/${process.versions.node}; ${platform}`;\n  }\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Logger\n// ---------------------------------------------------------------------------\n\n/** Single event emitted to the user-supplied logger. */\nexport type LogEvent =\n  | {\n      kind: \"request\";\n      method: string;\n      url: string;\n      httpMethod?: string;\n    }\n  | {\n      kind: \"response\";\n      method: string;\n      url: string;\n      status: number;\n      requestId?: string;\n      durationMs: number;\n    }\n  | {\n      kind: \"error\";\n      method: string;\n      url: string;\n      status?: number;\n      requestId?: string;\n      durationMs: number;\n      message: string;\n    };\n\nexport type Logger = (event: LogEvent) => void;\n\n/**\n * Extract a request-id from a Response. The hosted service emits one of\n * `x-request-id`, `request-id`, or `x-amzn-RequestId` depending on the edge\n * the request lands on. Caller-side correlation works as long as one is\n * present.\n */\nexport function extractRequestId(headers: Headers): string | undefined {\n  return (\n    headers.get(\"x-request-id\") ??\n    headers.get(\"request-id\") ??\n    headers.get(\"x-amzn-requestid\") ??\n    undefined\n  );\n}\n","/**\n * BridgeTransport — TCK bridge protocol transport.\n *\n * Speaks the bridge wire format (POST {endpoint}/{snake_case_method}) used by\n * conformance servers and the local reference adapter. Compatible with every\n * fetch-capable runtime (Node 20+, Bun, Deno, Workers, Edge).\n */\n\nimport { AuthenticationError, ConnectionError, TransportError } from \"../errors.js\";\nimport {\n  defaultUserAgent,\n  extractRequestId,\n  supportsUserAgentHeader,\n  type Logger,\n} from \"../observability.js\";\nimport type { Transport } from \"./index.js\";\n\n/** Strip trailing `/` from a URL without using a polynomial regex. */\nfunction trimTrailingSlashes(s: string): string {\n  let end = s.length;\n  while (end > 0 && s.charCodeAt(end - 1) === 47) end--;\n  return s.slice(0, end);\n}\n\nfunction nowMs(): number {\n  if (typeof performance !== \"undefined\" && typeof performance.now === \"function\") {\n    return performance.now();\n  }\n  return Date.now();\n}\n\nexport interface BridgeTransportOptions {\n  /** Base URL of the bridge endpoint (no trailing /v1). */\n  endpoint: string;\n\n  /** API key for Bearer auth. Optional for local bridge servers. */\n  apiKey?: string;\n\n  /** Request timeout in milliseconds. Default: 30000. */\n  timeout?: number;\n\n  /** Additional headers to include in every request. */\n  headers?: Record<string, string>;\n\n  /** Per-request logger. */\n  logger?: Logger;\n}\n\nexport class BridgeTransport implements Transport {\n  private readonly endpoint: string;\n  private readonly apiKey?: string;\n  private readonly timeout: number;\n  private readonly headers: Record<string, string>;\n  private readonly logger?: Logger;\n\n  constructor(options: BridgeTransportOptions) {\n    this.endpoint = trimTrailingSlashes(options.endpoint);\n    this.apiKey = options.apiKey;\n    this.timeout = options.timeout ?? 30_000;\n    this.headers = options.headers ?? {};\n    this.logger = options.logger;\n  }\n\n  async connect(): Promise<void> {\n    const url = `${this.endpoint}/setup`;\n    const start = nowMs();\n    this.emit({ kind: \"request\", method: \"connect\", url, httpMethod: \"POST\" });\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: this.buildHeaders(),\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (error) {\n      const durationMs = nowMs() - start;\n      if (error instanceof TypeError) {\n        const err = new ConnectionError(\n          `Failed to connect to ${this.endpoint}: ${(error as Error).message}`,\n          { cause: error },\n        );\n        this.emit({ kind: \"error\", method: \"connect\", url, durationMs, message: err.message });\n        throw err;\n      }\n      if (error instanceof DOMException && error.name === \"TimeoutError\") {\n        const err = new ConnectionError(\n          `Connection to ${this.endpoint} timed out after ${this.timeout}ms`,\n          { cause: error },\n        );\n        this.emit({ kind: \"error\", method: \"connect\", url, durationMs, message: err.message });\n        throw err;\n      }\n      throw error;\n    }\n    const durationMs = nowMs() - start;\n    const requestId = extractRequestId(response.headers);\n    if (response.status === 401 || response.status === 403) {\n      const err = new AuthenticationError(\n        `Authentication failed: ${response.status} ${response.statusText}`,\n        { requestId },\n      );\n      this.emit({\n        kind: \"error\",\n        method: \"connect\",\n        url,\n        status: response.status,\n        requestId,\n        durationMs,\n        message: err.message,\n      });\n      throw err;\n    }\n    this.emit({\n      kind: \"response\",\n      method: \"connect\",\n      url,\n      status: response.status,\n      requestId,\n      durationMs,\n    });\n  }\n\n  async close(): Promise<void> {}\n\n  async request<T>(method: string, params: Record<string, unknown>): Promise<T> {\n    const url = `${this.endpoint}/${method}`;\n\n    const body: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(params)) {\n      if (value !== undefined && value !== null) {\n        body[key] = value;\n      }\n    }\n\n    const start = nowMs();\n    this.emit({ kind: \"request\", method, url, httpMethod: \"POST\" });\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: this.buildHeaders(),\n        body: JSON.stringify(body),\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (error) {\n      const durationMs = nowMs() - start;\n      if (error instanceof TypeError) {\n        const err = new ConnectionError(\n          `Request to ${url} failed: ${(error as Error).message}`,\n          { cause: error },\n        );\n        this.emit({ kind: \"error\", method, url, durationMs, message: err.message });\n        throw err;\n      }\n      throw error;\n    }\n\n    const requestId = extractRequestId(response.headers);\n    const durationMs = nowMs() - start;\n\n    if (response.status === 401 || response.status === 403) {\n      const err = new AuthenticationError(\n        `Authentication failed: ${response.status} ${response.statusText}`,\n        { requestId },\n      );\n      this.emit({\n        kind: \"error\",\n        method,\n        url,\n        status: response.status,\n        requestId,\n        durationMs,\n        message: err.message,\n      });\n      throw err;\n    }\n\n    if (response.status === 204) {\n      this.emit({ kind: \"response\", method, url, status: 204, requestId, durationMs });\n      return undefined as T;\n    }\n\n    const text = await response.text();\n\n    if (!response.ok) {\n      let errorBody: unknown;\n      try {\n        errorBody = JSON.parse(text);\n      } catch {\n        errorBody = text;\n      }\n      const errorMessage =\n        typeof errorBody === \"object\" && errorBody !== null && \"error\" in errorBody\n          ? String((errorBody as Record<string, unknown>)[\"error\"])\n          : `HTTP ${response.status}`;\n      const err = new TransportError(\n        `${method} failed: ${errorMessage}`,\n        response.status,\n        errorBody,\n        { requestId },\n      );\n      this.emit({\n        kind: \"error\",\n        method,\n        url,\n        status: response.status,\n        requestId,\n        durationMs,\n        message: err.message,\n      });\n      throw err;\n    }\n\n    this.emit({ kind: \"response\", method, url, status: response.status, requestId, durationMs });\n\n    if (!text) return undefined as T;\n    return JSON.parse(text) as T;\n  }\n\n  private emit(event: Parameters<Logger>[0]): void {\n    if (!this.logger) return;\n    try {\n      this.logger(event);\n    } catch {\n      // Logger errors must never propagate.\n    }\n  }\n\n  private buildHeaders(): Record<string, string> {\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    const canSendUserAgent = supportsUserAgentHeader();\n    for (const [key, value] of Object.entries(this.headers)) {\n      if (key.toLowerCase() === \"user-agent\" && !canSendUserAgent) continue;\n      headers[key] = value;\n    }\n    if (canSendUserAgent && !Object.keys(headers).some((key) => key.toLowerCase() === \"user-agent\")) {\n      headers[\"User-Agent\"] = defaultUserAgent();\n    }\n    if (this.apiKey) {\n      headers[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    }\n    return headers;\n  }\n}\n"]}

package/dist/{client-DSqbWQoa.d.ts → client-DV-lnohj.d.ts}

@@ -236,6 +236,14 @@ interface MemoryClientOptions {
     endpoint?: string;
     /** API key for authentication. */
     apiKey?: string;
+    /**
+     * NAMS workspace id. When set, transmitted as the `X-Workspace-Id` header on
+     * every request — required by deployments that scope by header (e.g. the
+     * development/staging service) rather than encoding the workspace in the API
+     * key (production). Optional and harmless when unset. Falls back to the
+     * `MEMORY_WORKSPACE_ID` environment variable.
+     */
+    workspaceId?: string;
     /** Override transport selection. Default: "auto" (REST if endpoint contains /v1). */
     transport?: TransportMode;
     /** OAuth refresh-token-aware token provider. Overrides apiKey when supplied. */
@@ -255,15 +263,25 @@ interface MemoryClientOptions {
 }
 interface AddMessageOptions {
     metadata?: Record<string, unknown>;
+    /** Alias for the positional `sessionId` (NAMS is conversation-scoped). */
+    conversationId?: string;
 }
 interface GetConversationOptions {
     limit?: number;
+    /** Alias for the positional `sessionId`. */
+    conversationId?: string;
 }
 interface SearchMessagesOptions {
     sessionId?: string;
+    /** Alias for `sessionId` (NAMS is conversation-scoped). `sessionId` wins. */
+    conversationId?: string;
     limit?: number;
     threshold?: number;
 }
+interface ClearSessionOptions {
+    /** Alias for the positional `sessionId`. */
+    conversationId?: string;
+}
 interface ListSessionsOptions {
     limit?: number;
 }
@@ -271,6 +289,22 @@ interface SearchEntitiesOptions {
     limit?: number;
     type?: string;
 }
+interface WaitForExtractionOptions {
+    /** Search string to poll. Defaults to the first of `expectedNames`. */
+    query?: string;
+    /** Succeed once every name appears in results (case-insensitive). */
+    expectedNames?: string[];
+    /** Succeed once at least this many entities match. Default 1. */
+    minResults?: number;
+    /** Custom predicate over the current results. */
+    predicate?: (entities: Entity[]) => boolean;
+    /** Max entities to fetch per poll. */
+    limit?: number;
+    /** Overall timeout in milliseconds. Default 30000. */
+    timeoutMs?: number;
+    /** Poll interval in milliseconds. Default 1000. */
+    intervalMs?: number;
+}
 interface SearchPreferencesOptions {
     category?: string;
     limit?: number;
@@ -377,6 +411,26 @@ declare class LongTermMemory {
     }): Promise<Preference>;
     addFact(subject: string, predicate: string, obj: string): Promise<Fact>;
     searchEntities(query: string, options?: SearchEntitiesOptions): Promise<Entity[]>;
+    /**
+     * Poll entity search until async extraction has caught up, or time out.
+     *
+     * NAMS extracts entities in a background pipeline, so writes return before
+     * the entities are searchable. This helper lets application and test code
+     * await consistency explicitly instead of racing a fixed delay.
+     *
+     * Provide one of:
+     * - `predicate` — called with the current results; return true when satisfied.
+     * - `expectedNames` — succeed once every name appears (case-insensitive).
+     *   **Recommended**: NAMS entity search is vector/nearest-neighbor, so a
+     *   `minResults` threshold is satisfied almost immediately on a non-empty
+     *   workspace; prefer `expectedNames`/`predicate` to confirm a *specific*
+     *   extraction landed.
+     * - otherwise — succeed once at least `minResults` entities match.
+     *
+     * Returns `true` if satisfied within `timeoutMs`, `false` otherwise (it does
+     * not throw, so callers can branch or skip gracefully).
+     */
+    waitForExtraction(options: WaitForExtractionOptions): Promise<boolean>;
     searchPreferences(query: string, options?: SearchPreferencesOptions): Promise<Preference[]>;
     getEntityByName(name: string): Promise<Entity | null>;
     getRelatedEntities(entityId: string, options?: GetRelatedEntitiesOptions): Promise<Entity[]>;
@@ -409,6 +463,120 @@ declare class LongTermMemory {
     getEntityGraph(): Promise<EntityGraph>;
 }
 
+/**
+ * NAMS ontology surface — typed, versioned, validated domain schemas
+ * extending POLE+O. Mirrors the Python `client.ontology` accessor.
+ *
+ * The ontology endpoints are a snake_case sub-API verified empirically against
+ * staging (absent from the OpenAPI spec). The `RestTransport` routes for these
+ * (`*_ontology`) send bodies verbatim via the `snakeBody` flag.
+ *
+ *   GET    /ontologies                        → list (summaries)
+ *   GET    /ontologies/{id}                    → { record, versions[] }
+ *   GET    /ontologies/active                  → { ontology, version }
+ *   POST   /ontologies/{name}/clone            → version
+ *   POST   /ontologies        { ontology, validation_mode? }       → version
+ *   PUT    /ontologies/{id}    { ontology, validation_mode? }       → new revision
+ *   POST   /ontologies/active { version_id }                       → version
+ *   DELETE /ontologies/{id}                    → 204
+ */
+
+interface PropertyDef {
+    name: string;
+    type: string;
+    required?: boolean;
+    unique?: boolean;
+    enum?: string[];
+}
+interface EntityTypeDef {
+    label: string;
+    poleType: string;
+    subtype?: string;
+    color?: string;
+    icon?: string;
+    properties: PropertyDef[];
+}
+interface RelationshipDef {
+    type: string;
+    source: string;
+    target: string;
+}
+interface DomainInfo {
+    id: string;
+    name: string;
+    description?: string;
+    tagline?: string;
+    emoji?: string;
+}
+interface OntologyDocument {
+    domain: DomainInfo;
+    entityTypes: EntityTypeDef[];
+    relationships: RelationshipDef[];
+}
+interface OntologySummary {
+    id: string;
+    name: string;
+    displayName?: string;
+    description?: string;
+    emoji?: string;
+    tagline?: string;
+    isSystem: boolean;
+    currentRevision?: number;
+    isActive: boolean;
+}
+interface OntologyVersion {
+    id: string;
+    ontologyId: string;
+    revision: number;
+    validationMode: string;
+    document?: OntologyDocument;
+    schemaHash?: string;
+    createdAt?: string;
+    message?: string;
+}
+interface OntologyRecord {
+    id: string;
+    name: string;
+    description?: string;
+    workspaceId?: string;
+    isSystem: boolean;
+    createdAt?: string;
+}
+interface Ontology {
+    record: OntologyRecord;
+    versions: OntologyVersion[];
+}
+interface ActiveOntology {
+    document: OntologyDocument;
+    validationMode?: string;
+    revision?: number;
+    ontologyId?: string;
+    versionId?: string;
+}
+interface CreateOntologyOptions {
+    /** Identity comes from `schema.domain`; `name` is accepted for symmetry. */
+    name: string;
+    schema: OntologyDocument;
+    validationMode?: string;
+}
+interface UpdateOntologyOptions {
+    id: string;
+    schema: OntologyDocument;
+    validationMode?: string;
+}
+declare class OntologyClient {
+    private readonly transport;
+    constructor(transport: Transport);
+    list(): Promise<OntologySummary[]>;
+    get(id: string): Promise<Ontology>;
+    getActive(): Promise<ActiveOntology>;
+    clone(templateName: string): Promise<OntologyVersion>;
+    create(options: CreateOntologyOptions): Promise<OntologyVersion>;
+    update(options: UpdateOntologyOptions): Promise<OntologyVersion>;
+    activate(versionId: string): Promise<OntologyVersion>;
+    delete(id: string): Promise<void>;
+}
+
 /**
  * Cypher query console — read-only access to the underlying graph.
  *
@@ -482,12 +650,12 @@ declare class ReasoningMemory {
 declare class ShortTermMemory {
     private readonly transport;
     constructor(transport: Transport);
-    addMessage(sessionId: string, role: MessageRole, content: string, options?: AddMessageOptions): Promise<Message>;
-    getConversation(sessionId: string, options?: GetConversationOptions): Promise<Conversation>;
+    addMessage(sessionId: string | undefined, role: MessageRole, content: string, options?: AddMessageOptions): Promise<Message>;
+    getConversation(sessionId: string | undefined, options?: GetConversationOptions): Promise<Conversation>;
     searchMessages(query: string, options?: SearchMessagesOptions): Promise<Message[]>;
     listSessions(options?: ListSessionsOptions): Promise<SessionInfo[]>;
     deleteMessage(messageId: string): Promise<boolean>;
-    clearSession(sessionId: string): Promise<void>;
+    clearSession(sessionId: string | undefined, options?: ClearSessionOptions): Promise<void>;
     /** Create a new conversation (hosted service). */
     createConversation(options: CreateConversationOptions): Promise<Conversation>;
     /** List conversations the API key has access to. */
@@ -541,6 +709,8 @@ declare class MemoryClient {
     readonly query: QueryConsole;
     /** API-key & OAuth management (hosted service only). */
     readonly auth: AuthClient;
+    /** Ontology lifecycle — typed domain schemas (hosted service only). */
+    readonly ontology: OntologyClient;
     private readonly transport;
     constructor(options?: MemoryClientOptions);
     constructor(transport: Transport);
@@ -548,4 +718,4 @@ declare class MemoryClient {
     close(): Promise<void>;
 }
 
-export { type SessionInfo as $, type AccessTokenPair as A, type BulkMessageInput as B, type CompleteTraceOptions as C, type ListTracesOptions as D, type Entity as E, type Fact as F, type GetConversationOptions as G, type HostedEntityType as H, LongTermMemory as I, type MemoryClientOptions as J, type Message as K, type ListConversationsOptions as L, MemoryClient as M, type MessageRole as N, type Observation as O, type Preference as P, QueryConsole as Q, ReasoningMemory as R, type ReasoningStep as S, type ReasoningTrace as T, type RecordStepInput as U, type RecordToolCallOptions as V, type Reflection as W, type Relationship as X, type SearchEntitiesOptions as Y, type SearchMessagesOptions as Z, type SearchPreferencesOptions as _, type AddMessageOptions as a, type SetEntityFeedbackOptions as a0, ShortTermMemory as a1, type ToolCall as a2, type ToolCallStatus as a3, type ToolStats as a4, type TransportMode as a5, type UpdateEntityOptions as a6, type AddRelationshipOptions as b, type AgentStep as c, type AgentStepExplanation as d, type ApiKey as e, AuthClient as f, type Conversation as g, type ConversationContext as h, type ConversationTrace as i, type CreateApiKeyInput as j, type CreateConversationOptions as k, type CypherResult as l, type EntityFeedbackResult as m, type EntityGraph as n, type EntityGraphEdge as o, type EntityGraphNode as p, type EntityHistory as q, type EntityMention as r, type EntityMergeResult as s, type EntityProvenance as t, type EntityRelationshipRef as u, type EntityType as v, type GetRelatedEntitiesOptions as w, type GetSimilarTracesOptions as x, type ListEntitiesOptions as y, type ListSessionsOptions as z };
+export { QueryConsole as $, type AccessTokenPair as A, type BulkMessageInput as B, type CompleteTraceOptions as C, type DomainInfo as D, type Entity as E, type Fact as F, type GetConversationOptions as G, type GetSimilarTracesOptions as H, type HostedEntityType as I, type ListEntitiesOptions as J, type ListSessionsOptions as K, type ListConversationsOptions as L, type ListTracesOptions as M, LongTermMemory as N, MemoryClient as O, type MemoryClientOptions as P, type Message as Q, type MessageRole as R, type Observation as S, type Ontology as T, OntologyClient as U, type OntologyDocument as V, type OntologyRecord as W, type OntologySummary as X, type OntologyVersion as Y, type Preference as Z, type PropertyDef as _, type ActiveOntology as a, ReasoningMemory as a0, type ReasoningStep as a1, type ReasoningTrace as a2, type RecordStepInput as a3, type RecordToolCallOptions as a4, type Reflection as a5, type Relationship as a6, type RelationshipDef as a7, type SearchEntitiesOptions as a8, type SearchMessagesOptions as a9, type SearchPreferencesOptions as aa, type SessionInfo as ab, type SetEntityFeedbackOptions as ac, ShortTermMemory as ad, type ToolCall as ae, type ToolCallStatus as af, type ToolStats as ag, type TransportMode as ah, type UpdateEntityOptions as ai, type UpdateOntologyOptions as aj, type AddMessageOptions as b, type AddRelationshipOptions as c, type AgentStep as d, type AgentStepExplanation as e, type ApiKey as f, AuthClient as g, type Conversation as h, type ConversationContext as i, type ConversationTrace as j, type CreateApiKeyInput as k, type CreateConversationOptions as l, type CreateOntologyOptions as m, type CypherResult as n, type EntityFeedbackResult as o, type EntityGraph as p, type EntityGraphEdge as q, type EntityGraphNode as r, type EntityHistory as s, type EntityMention as t, type EntityMergeResult as u, type EntityProvenance as v, type EntityRelationshipRef as w, type EntityType as x, type EntityTypeDef as y, type GetRelatedEntitiesOptions as z };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AccessTokenPair, a as AddMessageOptions, b as AddRelationshipOptions, c as AgentStep, d as AgentStepExplanation, e as ApiKey, f as AuthClient, B as BulkMessageInput, C as CompleteTraceOptions, g as Conversation, h as ConversationContext, i as ConversationTrace, j as CreateApiKeyInput, k as CreateConversationOptions, l as CypherResult, E as Entity, m as EntityFeedbackResult, n as EntityGraph, o as EntityGraphEdge, p as EntityGraphNode, q as EntityHistory, r as EntityMention, s as EntityMergeResult, t as EntityProvenance, u as EntityRelationshipRef, v as EntityType, F as Fact, G as GetConversationOptions, w as GetRelatedEntitiesOptions, x as GetSimilarTracesOptions, H as HostedEntityType, L as ListConversationsOptions, y as ListEntitiesOptions, z as ListSessionsOptions, D as ListTracesOptions, I as LongTermMemory, M as MemoryClient, J as MemoryClientOptions, K as Message, N as MessageRole, O as Observation, P as Preference, Q as QueryConsole, R as ReasoningMemory, S as ReasoningStep, T as ReasoningTrace, U as RecordStepInput, V as RecordToolCallOptions, W as Reflection, X as Relationship, Y as SearchEntitiesOptions, Z as SearchMessagesOptions, _ as SearchPreferencesOptions, $ as SessionInfo, a0 as SetEntityFeedbackOptions, a1 as ShortTermMemory, a2 as ToolCall, a3 as ToolCallStatus, a4 as ToolStats, a5 as TransportMode, a6 as UpdateEntityOptions } from './client-DSqbWQoa.js';
+export { A as AccessTokenPair, a as ActiveOntology, b as AddMessageOptions, c as AddRelationshipOptions, d as AgentStep, e as AgentStepExplanation, f as ApiKey, g as AuthClient, B as BulkMessageInput, C as CompleteTraceOptions, h as Conversation, i as ConversationContext, j as ConversationTrace, k as CreateApiKeyInput, l as CreateConversationOptions, m as CreateOntologyOptions, n as CypherResult, D as DomainInfo, E as Entity, o as EntityFeedbackResult, p as EntityGraph, q as EntityGraphEdge, r as EntityGraphNode, s as EntityHistory, t as EntityMention, u as EntityMergeResult, v as EntityProvenance, w as EntityRelationshipRef, x as EntityType, y as EntityTypeDef, F as Fact, G as GetConversationOptions, z as GetRelatedEntitiesOptions, H as GetSimilarTracesOptions, I as HostedEntityType, L as ListConversationsOptions, J as ListEntitiesOptions, K as ListSessionsOptions, M as ListTracesOptions, N as LongTermMemory, O as MemoryClient, P as MemoryClientOptions, Q as Message, R as MessageRole, S as Observation, T as Ontology, U as OntologyClient, V as OntologyDocument, W as OntologyRecord, X as OntologySummary, Y as OntologyVersion, Z as Preference, _ as PropertyDef, $ as QueryConsole, a0 as ReasoningMemory, a1 as ReasoningStep, a2 as ReasoningTrace, a3 as RecordStepInput, a4 as RecordToolCallOptions, a5 as Reflection, a6 as Relationship, a7 as RelationshipDef, a8 as SearchEntitiesOptions, a9 as SearchMessagesOptions, aa as SearchPreferencesOptions, ab as SessionInfo, ac as SetEntityFeedbackOptions, ad as ShortTermMemory, ae as ToolCall, af as ToolCallStatus, ag as ToolStats, ah as TransportMode, ai as UpdateEntityOptions, aj as UpdateOntologyOptions } from './client-DV-lnohj.js';
 import { T as Transport, L as Logger } from './index-qfRrdQNP.js';
 export { a as LogEvent } from './index-qfRrdQNP.js';
 
@@ -88,6 +88,6 @@ declare class NotSupportedError extends MemoryError {
  * dedicated version-check script run in CI. Imported by the transports to build
  * the default User-Agent header.
  */
-declare const VERSION = "0.3.0";
+declare const VERSION = "0.4.0";
 
 export { AuthenticationError, ConnectionError, Logger, MemoryError, NotFoundError, NotSupportedError, RestTransport, type RestTransportOptions, type TokenProvider, Transport, TransportError, VERSION, ValidationError };