@remnic/core 1.1.8 → 1.1.10

package/dist/objective-state.js

@@ -1,15 +1,17 @@
 import {
   getObjectiveStateStoreStatus,
+  objectiveStateStoreOverrideForNamespace,
   recordObjectiveStateSnapshot,
   resolveObjectiveStateStoreDir,
   searchObjectiveStateSnapshots,
   validateObjectiveStateSnapshot
-} from "./chunk-LOBRX7VD.js";
+} from "./chunk-5UM2VJ6D.js";
 import "./chunk-DGXUHMOV.js";
 import "./chunk-LPSF4OQH.js";
 import "./chunk-PZ5AY32C.js";
 export {
   getObjectiveStateStoreStatus,
+  objectiveStateStoreOverrideForNamespace,
   recordObjectiveStateSnapshot,
   resolveObjectiveStateStoreDir,
   searchObjectiveStateSnapshots,

package/dist/operator-toolkit.d.ts

@@ -2,11 +2,12 @@ import { StorageManager } from './storage.js';
 import { EvalHarnessStatus, validateEvalBenchmarkPack, EvalBaselineDeltaReport, EvalCiGateReport } from './evals.js';
 import { GraphHealthReport } from './graph.js';
 import { SessionIntegrityReport, SessionRepairPlan, SessionRepairApplyResult } from './session-integrity.js';
-import { P as PluginConfig } from './types-H85grL1f.js';
+import { PluginConfig } from './types.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-lCzmu4JX.js';
+import './memory-projection-store-CY8TU40w.js';
 import 'better-sqlite3';
+import './index-1qIcnbG1.js';
 
 interface QmdRuntimeLike {
     probe(): Promise<boolean>;

package/dist/operator-toolkit.js

@@ -11,37 +11,37 @@ import {
   summarizeMemoryWorthLegacyCounters,
   summarizeObservationThroughput,
   summarizeTierDistribution
-} from "./chunk-SWRJFKYW.js";
+} from "./chunk-I6BQZSML.js";
 import "./chunk-5HRY2WRF.js";
 import "./chunk-ASAITVLA.js";
-import "./chunk-RJSVRPNU.js";
+import "./chunk-57QNCUEZ.js";
 import "./chunk-YRMVARQP.js";
-import "./chunk-WSZIHQBK.js";
+import "./chunk-P77UEOU2.js";
 import "./chunk-U66YHYC7.js";
 import "./chunk-K6WK37A6.js";
 import "./chunk-AJU4PJGY.js";
 import "./chunk-7SEAZFFB.js";
-import "./chunk-QJZ77K7F.js";
+import "./chunk-6Z6UH6TK.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-PVGDJXVK.js";
-import "./chunk-E27HOXMX.js";
-import "./chunk-2LGMW3DJ.js";
+import "./chunk-EYNQTST2.js";
 import "./chunk-OR64ZGRZ.js";
+import "./chunk-2LGMW3DJ.js";
 import "./chunk-RK2Y4XOM.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-WIICJPET.js";
 import "./chunk-TBBDFYXW.js";
-import "./chunk-XGX4TUF6.js";
+import "./chunk-MCC6KDQF.js";
 import "./chunk-YNJHCGDT.js";
-import "./chunk-4KAN3GZ3.js";
-import "./chunk-T65SHTJP.js";
+import "./chunk-NN2DKE4T.js";
+import "./chunk-VQXK37XA.js";
 import "./chunk-PFV5C235.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-67YLUWLG.js";
+import "./chunk-XJKFSSDW.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
-import "./chunk-M62O4P4T.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";

package/dist/opik-exporter.js

@@ -6,13 +6,13 @@ import "./chunk-PZ5AY32C.js";
 
 // src/opik-exporter.ts
 import { createHash, randomBytes } from "crypto";
-import { readFileSync } from "fs";
+import fs from "fs";
 import path from "path";
 var OPIK_EXPORTER_SLOT = "__openclawOpikExporter";
 function readOpikOpenclawConfig(log) {
   try {
     const configPath = readEnvVar("OPENCLAW_ENGRAM_CONFIG_PATH") || readEnvVar("OPENCLAW_CONFIG_PATH") || path.join(resolveHomeDir(), ".openclaw", "openclaw.json");
-    const raw = JSON.parse(readFileSync(configPath, "utf-8"));
+    const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
     const entry = raw?.plugins?.entries?.["opik-openclaw"];
     if (!entry?.enabled || !entry?.config) return {};
     const c = entry.config;

package/dist/opik-exporter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/opik-exporter.ts"],"sourcesContent":["import { createHash, randomBytes } from \"node:crypto\";\n/**\n * opik-exporter.ts — Engram-native Opik trace exporter\n *\n * Subscribes to the globalThis.__openclawEngramTrace slot that Engram already\n * emits on, and forwards recall + LLM events to a self-hosted (or cloud) Opik\n * instance via its REST API. No extra npm dependencies — uses Node's built-in\n * fetch.\n *\n * Auto-detects apiUrl / projectName from the opik-openclaw plugin config so\n * traces land in the same project and are grouped by session thread.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport type { LoggerBackend } from \"./logger.js\";\nimport { readEnvVar, resolveHomeDir } from \"./runtime/env.js\";\n\n// GlobalThis slot that tracks the active OpikExporter instance.\n// Used to make subscribe() idempotent across hot-reload / stop-start cycles.\nconst OPIK_EXPORTER_SLOT = \"__openclawOpikExporter\";\n\n// ---------------------------------------------------------------------------\n// Engram event types (mirrors types.ts without importing from it)\n// ---------------------------------------------------------------------------\n\ntype EngramLlmTraceEvent = {\n  kind: \"llm_start\" | \"llm_end\" | \"llm_error\";\n  traceId: string;\n  model: string;\n  operation: \"extraction\" | \"consolidation\" | \"profile_consolidation\" | \"identity_consolidation\" | \"day_summary\";\n  input?: string;\n  output?: string;\n  durationMs?: number;\n  error?: string;\n  tokenUsage?: { input?: number; output?: number; total?: number };\n};\n\ntype EngramRecallTraceEvent = {\n  kind: \"recall_summary\";\n  traceId: string;\n  operation: \"recall\";\n  sessionKey?: string;\n  promptLength: number;\n  retrievalQueryLength: number;\n  recallMode: string;\n  recallResultLimit: number;\n  qmdEnabled: boolean;\n  qmdAvailable: boolean;\n  recallNamespaces: string[];\n  source: string;\n  recalledMemoryCount: number;\n  injected: boolean;\n  contextChars: number;\n  identityInjectionMode?: string;\n  identityInjectedChars?: number;\n  durationMs: number;\n  timings?: Record<string, string>;\n  recalledContent?: string;\n};\n\ntype EngramTraceEvent = EngramLlmTraceEvent | EngramRecallTraceEvent;\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface OpikExporterConfig {\n  enabled: boolean;\n  /** Base URL of the Opik API, e.g. http://192.168.3.147:5173/api */\n  apiUrl: string;\n  projectName: string;\n  workspaceName: string;\n  /** Optional API key (not required for self-hosted deployments) */\n  apiKey?: string;\n  /** Include recalled memory text in spans (default false) */\n  traceRecallContent: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Auto-detect from opik-openclaw plugin config\n// ---------------------------------------------------------------------------\n\nfunction readOpikOpenclawConfig(log?: LoggerBackend): Partial<OpikExporterConfig> {\n  try {\n    const configPath =\n      readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\") ||\n      readEnvVar(\"OPENCLAW_CONFIG_PATH\") ||\n      path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n    const raw = JSON.parse(readFileSync(configPath, \"utf-8\"));\n    const entry = raw?.plugins?.entries?.[\"opik-openclaw\"];\n    if (!entry?.enabled || !entry?.config) return {};\n    const c = entry.config as Record<string, unknown>;\n    return {\n      apiUrl: typeof c.apiUrl === \"string\" && c.apiUrl.length > 0 ? c.apiUrl : undefined,\n      projectName: typeof c.projectName === \"string\" ? c.projectName : undefined,\n      workspaceName: typeof c.workspaceName === \"string\" ? c.workspaceName : undefined,\n      apiKey: typeof c.apiKey === \"string\" && c.apiKey.length > 0 ? c.apiKey : undefined,\n    };\n  } catch (err) {\n    log?.debug?.(`[opik-exporter] could not read opik-openclaw config: ${err}`);\n    return {};\n  }\n}\n\n// ---------------------------------------------------------------------------\n// UUID v7 generator (Opik requires v7, not v4)\n// ---------------------------------------------------------------------------\n\nfunction uuidV7(): string {\n  const now = Date.now();\n  const bytes = randomBytes(16);\n  // Timestamp: 48-bit ms since epoch in bytes 0-5\n  bytes[0] = (now / 2 ** 40) & 0xff;\n  bytes[1] = (now / 2 ** 32) & 0xff;\n  bytes[2] = (now / 2 ** 24) & 0xff;\n  bytes[3] = (now / 2 ** 16) & 0xff;\n  bytes[4] = (now / 2 ** 8) & 0xff;\n  bytes[5] = now & 0xff;\n  // Version 7\n  bytes[6] = (bytes[6] & 0x0f) | 0x70;\n  // Variant 10xx\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n  const hex = bytes.toString(\"hex\");\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n// ---------------------------------------------------------------------------\n// REST helpers\n// ---------------------------------------------------------------------------\n\nfunction buildHeaders(cfg: OpikExporterConfig): Record<string, string> {\n  const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (cfg.workspaceName) headers[\"Comet-Workspace\"] = cfg.workspaceName;\n  // Opik expects the raw API key in the authorization header without a Bearer prefix.\n  if (cfg.apiKey) headers[\"authorization\"] = cfg.apiKey;\n  return headers;\n}\n\nasync function postSpanBatch(\n  cfg: OpikExporterConfig,\n  spans: unknown[],\n  log: LoggerBackend,\n): Promise<void> {\n  const url = `${cfg.apiUrl.replace(/\\/$/, \"\")}/v1/private/spans/batch`;\n  try {\n    const res = await fetch(url, {\n      method: \"POST\",\n      headers: buildHeaders(cfg),\n      body: JSON.stringify({ spans }),\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => \"\");\n      log.debug?.(`[opik-exporter] span batch failed ${res.status}: ${text}`);\n    }\n  } catch (err) {\n    log.debug?.(`[opik-exporter] span batch error: ${err}`);\n  }\n}\n\nasync function postTraceBatch(\n  cfg: OpikExporterConfig,\n  traces: unknown[],\n  log: LoggerBackend,\n): Promise<boolean> {\n  const url = `${cfg.apiUrl.replace(/\\/$/, \"\")}/v1/private/traces/batch`;\n  try {\n    const res = await fetch(url, {\n      method: \"POST\",\n      headers: buildHeaders(cfg),\n      body: JSON.stringify({ traces }),\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => \"\");\n      log.debug?.(`[opik-exporter] trace batch failed ${res.status}: ${text}`);\n      return false;\n    }\n    return true;\n  } catch (err) {\n    log.debug?.(`[opik-exporter] trace batch error: ${err}`);\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// In-flight LLM span tracking\n// ---------------------------------------------------------------------------\n\ntype InFlightLlm = {\n  startedAt: number;\n  startTime: string;\n  model: string;\n  operation: string;\n  input?: string;\n  spanId: string;\n  traceId: string;\n};\n\n// ---------------------------------------------------------------------------\n// Main exporter class\n// ---------------------------------------------------------------------------\n\nexport class OpikExporter {\n  private readonly cfg: OpikExporterConfig;\n  private readonly log: LoggerBackend;\n  private _handler: ((e: EngramTraceEvent) => void) | undefined;\n  private readonly inFlight = new Map<string, InFlightLlm>();\n  /** Track which trace_ids we have already created parent trace objects for. */\n  private readonly createdTraces = new Set<string>();\n  /** In-flight ensureTrace promises keyed by traceId — concurrent callers await the same promise. */\n  private readonly pendingTraces = new Map<string, Promise<void>>();\n  /** TTL for in-flight LLM entries (ms). Entries older than this are discarded. */\n  private static readonly IN_FLIGHT_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\n  constructor(cfg: OpikExporterConfig, log: LoggerBackend) {\n    this.cfg = cfg;\n    this.log = log;\n  }\n\n  /**\n   * Subscribe to Engram's global trace slot. Safe to call multiple times —\n   * chains with existing subscribers (e.g. Langfuse) rather than replacing.\n   */\n  subscribe(): void {\n    if (!this.cfg.enabled) return;\n\n    // Idempotency guard: if this exact instance is already registered on globalThis,\n    // skip re-wrapping to avoid stacking callbacks on hot-reload / stop-start cycles.\n    const g = globalThis as Record<string, unknown>;\n    const active = g[OPIK_EXPORTER_SLOT] as OpikExporter | undefined;\n    if (active === this) {\n      this.log.debug?.(\"[opik-exporter] already subscribed — skipping duplicate\");\n      return;\n    }\n    // If a different (stale) exporter instance is registered, evict it first.\n    if (active) active._detach();\n\n    g[OPIK_EXPORTER_SLOT] = this;\n\n    const existing = g.__openclawEngramTrace as\n      | ((e: EngramTraceEvent) => void)\n      | undefined;\n\n    const handler = (event: EngramTraceEvent) => {\n      try {\n        this.handleEvent(event);\n      } catch (err) {\n        this.log.debug?.(`[opik-exporter] handler error: ${err}`);\n      }\n    };\n    // Store handler ref so _detach() can remove it from the chain.\n    this._handler = handler;\n\n    // Chain: call existing subscribers first, then ours.\n    // NOTE: when _detach() is later called, it marks this.cfg.enabled = false\n    // rather than restoring the chain, so that any subscriber that chained\n    // *after* us is not dropped. The cost is one disabled no-op wrapper\n    // remaining in the chain per stop/start cycle. In practice, Engram\n    // restarts Opik only a handful of times per process lifetime, so the\n    // overhead is negligible (one boolean check per leftover closure).\n    g.__openclawEngramTrace =\n      typeof existing === \"function\"\n        ? (event: EngramTraceEvent) => {\n            try { existing(event); } catch { /* prior subscriber threw; continue */ }\n            handler(event);\n          }\n        : handler;\n\n    this.log.info(\n      `[opik-exporter] subscribed — apiUrl=${this.cfg.apiUrl} project=${this.cfg.projectName}`,\n    );\n  }\n\n  /** Deactivate this exporter instance.\n   *\n   * We intentionally do NOT restore __openclawEngramTrace to a prior handler\n   * because any subscriber that chained *after* us would be silently dropped\n   * by such a restoration. Instead we mark the instance as disabled so that\n   * handleEvent() becomes a no-op while the callback chain itself is left\n   * untouched. The next subscribe() call from a fresh instance will re-enter\n   * the chain on top of whatever is there at that point.\n   */\n  _detach(): void {\n    const g = globalThis as Record<string, unknown>;\n    // Only clear the global slot if we are still the active exporter.\n    // A stale instance must not evict a newer exporter that already took over.\n    if (g[OPIK_EXPORTER_SLOT] === this) delete g[OPIK_EXPORTER_SLOT];\n    // Disable event processing; the wrapper closure in the chain becomes a no-op.\n    (this.cfg as OpikExporterConfig & { enabled: boolean }).enabled = false;\n    this._handler = undefined;\n    this.log.debug?.(\"[opik-exporter] detached — events silenced, chain preserved\");\n  }\n\n  unsubscribe(): void {\n    this._detach();\n  }\n\n  private handleEvent(event: EngramTraceEvent): void {\n    if (!this.cfg.enabled) return; // guard for after _detach()\n    if (event.kind === \"recall_summary\") {\n      void this.onRecall(event);\n    } else if (event.kind === \"llm_start\") {\n      this.onLlmStart(event);\n    } else if (event.kind === \"llm_end\" || event.kind === \"llm_error\") {\n      void this.onLlmEnd(event);\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Recall events → general span\n  // -------------------------------------------------------------------------\n\n  private async onRecall(evt: EngramRecallTraceEvent): Promise<void> {\n    const now = new Date();\n    const startTime = new Date(now.getTime() - evt.durationMs).toISOString();\n    const endTime = now.toISOString();\n\n    const input: Record<string, unknown> = {\n      recallMode: evt.recallMode,\n      recalledMemoryCount: evt.recalledMemoryCount,\n      recallNamespaces: evt.recallNamespaces,\n      source: evt.source,\n      qmdEnabled: evt.qmdEnabled,\n      qmdAvailable: evt.qmdAvailable,\n      retrievalQueryLength: evt.retrievalQueryLength,\n      recallResultLimit: evt.recallResultLimit,\n      promptLength: evt.promptLength,\n    };\n\n    if (this.cfg.traceRecallContent && evt.recalledContent) {\n      input.recalledContent = evt.recalledContent;\n    }\n\n    const metadata: Record<string, unknown> = {\n      source: \"engram\",\n      injected: evt.injected,\n      contextChars: evt.contextChars,\n      durationMs: evt.durationMs,\n    };\n\n    if (evt.identityInjectionMode) {\n      metadata.identityInjectionMode = evt.identityInjectionMode;\n      metadata.identityInjectedChars = evt.identityInjectedChars;\n    }\n\n    if (evt.timings) metadata.timings = evt.timings;\n\n    const traceId = evt.sessionKey ? this.sessionToTraceId(evt.sessionKey) : uuidV7();\n\n    // Ensure parent trace exists so the span is not orphaned in Opik.\n    await this.ensureTrace(traceId, evt.sessionKey ?? \"engram:recall\", startTime, endTime);\n\n    const output: Record<string, unknown> = {\n      injected: evt.injected,\n      recalledMemoryCount: evt.recalledMemoryCount,\n      contextChars: evt.contextChars,\n      durationMs: evt.durationMs,\n    };\n    if (this.cfg.traceRecallContent && evt.recalledContent) {\n      output.recalledContent = evt.recalledContent;\n    }\n\n    const span = {\n      id: uuidV7(),\n      trace_id: traceId,\n      project_name: this.cfg.projectName,\n      name: \"engram:recall\",\n      type: \"general\",\n      start_time: startTime,\n      end_time: endTime,\n      input,\n      output,\n      metadata,\n      tags: [\"engram\", \"recall\"],\n    };\n\n    await postSpanBatch(this.cfg, [span], this.log);\n  }\n\n  // -------------------------------------------------------------------------\n  // Engram internal LLM events (extraction / consolidation) → llm span\n  // -------------------------------------------------------------------------\n\n  private onLlmStart(evt: EngramLlmTraceEvent): void {\n    // Use evt.traceId (Engram's correlation key) as the Opik spanId so spans\n    // are deterministic and stable across retries. Derive a per-call Opik\n    // trace_id from the same key so each LLM call maps to its own trace.\n    this.inFlight.set(evt.traceId, {\n      startedAt: Date.now(),\n      startTime: new Date().toISOString(),\n      model: evt.model,\n      operation: evt.operation,\n      input: evt.input,\n      spanId: this.sessionToTraceId(evt.traceId + \":span\"),\n      traceId: this.sessionToTraceId(evt.traceId),\n    });\n  }\n\n  private sweepStaleInFlight(): void {\n    const cutoff = Date.now() - OpikExporter.IN_FLIGHT_TTL_MS;\n    for (const [id, entry] of this.inFlight) {\n      if (entry.startedAt < cutoff) {\n        this.inFlight.delete(id);\n      }\n    }\n  }\n\n  private async onLlmEnd(evt: EngramLlmTraceEvent): Promise<void> {\n    // Opportunistically sweep stale entries to prevent unbounded map growth.\n    if (this.inFlight.size > 20) this.sweepStaleInFlight();\n    const state = this.inFlight.get(evt.traceId);\n    this.inFlight.delete(evt.traceId);\n\n    const startTime = state?.startTime ?? new Date().toISOString();\n    const endTime = new Date().toISOString();\n\n    const usage: Record<string, number> = {};\n    if (evt.tokenUsage?.input != null) usage.prompt_tokens = evt.tokenUsage.input;\n    if (evt.tokenUsage?.output != null) usage.completion_tokens = evt.tokenUsage.output;\n    if (evt.tokenUsage?.total != null) usage.total_tokens = evt.tokenUsage.total;\n\n    const traceId = state?.traceId ?? uuidV7();\n\n    // Ensure parent trace exists so the span is not orphaned in Opik.\n    await this.ensureTrace(traceId, `engram:${evt.operation}`, startTime, endTime);\n\n    const span: Record<string, unknown> = {\n      id: state?.spanId ?? uuidV7(),\n      trace_id: traceId,\n      project_name: this.cfg.projectName,\n      name: `engram:${evt.operation}`,\n      type: \"llm\",\n      model: evt.model,\n      start_time: startTime,\n      end_time: endTime,\n      input: state?.input != null ? { prompt: state.input } : undefined,\n      output:\n        evt.kind === \"llm_end\" && evt.output != null\n          ? { completion: evt.output }\n          : evt.kind === \"llm_error\"\n            ? { error: evt.error }\n            : undefined,\n      metadata: {\n        source: \"engram\",\n        operation: evt.operation,\n        durationMs: evt.durationMs ?? (state ? Date.now() - state.startedAt : undefined),\n      },\n      tags: [\"engram\", evt.operation],\n      usage: Object.keys(usage).length > 0 ? usage : undefined,\n    };\n\n    await postSpanBatch(this.cfg, [span], this.log);\n  }\n\n  // -------------------------------------------------------------------------\n  // Helpers\n  // -------------------------------------------------------------------------\n\n  /**\n   * Create a parent trace object in Opik if we haven't already.\n   * Opik does NOT auto-create traces from spans, so without this\n   * the spans are orphaned and don't show up in the trace list UI.\n   */\n  private async ensureTrace(\n    traceId: string,\n    name: string,\n    startTime: string,\n    endTime: string,\n  ): Promise<void> {\n    if (this.createdTraces.has(traceId)) return;\n\n    // If another call is already creating this trace, wait for it and then\n    // re-check — if the first attempt failed we'll retry below.\n    const existing = this.pendingTraces.get(traceId);\n    if (existing) {\n      await existing;\n      if (this.createdTraces.has(traceId)) return;\n      // First attempt failed — check if another waiter is already retrying.\n      const retrying = this.pendingTraces.get(traceId);\n      if (retrying) {\n        await retrying;\n        // Only return if the retry actually succeeded.\n        if (this.createdTraces.has(traceId)) return;\n      }\n      // No one else retrying; fall through to create.\n    }\n\n    const work = (async () => {\n      const trace = {\n        id: traceId,\n        project_name: this.cfg.projectName,\n        name,\n        start_time: startTime,\n        end_time: endTime,\n        tags: [\"engram\"],\n      };\n\n      const ok = await postTraceBatch(this.cfg, [trace], this.log);\n      if (!ok) {\n        this.pendingTraces.delete(traceId);\n        return; // transient failure — allow retry on next span\n      }\n\n      this.createdTraces.add(traceId);\n      this.pendingTraces.delete(traceId);\n\n      // Cap the set size to prevent unbounded growth in long-running processes.\n      if (this.createdTraces.size > 10_000) {\n        const first = this.createdTraces.values().next().value;\n        if (first) this.createdTraces.delete(first);\n      }\n    })();\n\n    this.pendingTraces.set(traceId, work);\n    await work;\n  }\n\n  /**\n   * Convert a sessionKey to a stable, deterministic UUID v7-shaped ID so that\n   * spans for the same session share a trace_id and are threaded in Opik.\n   * Uses SHA-256 for collision resistance. The timestamp bytes (0-5) come from\n   * the hash itself — they don't reflect real time, but Opik only validates\n   * the version/variant bits, not timestamp ordering.\n   */\n  private sessionToTraceId(sessionKey: string): string {\n    const digest = createHash(\"sha256\").update(sessionKey).digest();\n    // Version 7 (bytes 0-5 are hash-derived, not real timestamps)\n    digest[6] = (digest[6] & 0x0f) | 0x70;\n    // Variant 10xx\n    digest[8] = (digest[8] & 0x3f) | 0x80;\n    const hex = digest.slice(0, 16).toString(\"hex\");\n    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory: build from Engram resolved config + auto-detect from opik-openclaw\n// ---------------------------------------------------------------------------\n\nexport interface OpikExporterRawConfig {\n  opikTraceEnabled?: boolean;\n  opikApiUrl?: string;\n  opikProjectName?: string;\n  opikWorkspaceName?: string;\n  opikApiKey?: string;\n  opikTraceRecallContent?: boolean;\n}\n\nexport function createOpikExporter(\n  raw: OpikExporterRawConfig,\n  log: LoggerBackend,\n): OpikExporter | null {\n  // Explicit opt-out: if set to false, never enable.\n  if (raw.opikTraceEnabled === false) return null;\n\n  // Auto-detect from opik-openclaw plugin config.\n  // If opikTraceEnabled is not set (undefined), we enable automatically\n  // whenever opik-openclaw is configured — avoids needing extra fields in\n  // Engram's openclaw.json config section (which would fail schema validation).\n  const detected = readOpikOpenclawConfig(log);\n\n  const apiUrl = raw.opikApiUrl ?? detected.apiUrl;\n  if (!apiUrl) {\n    // Only warn when the user explicitly opted in but forgot to set the URL.\n    // When auto-detecting (opikTraceEnabled not set), return silently so non-Opik\n    // users see no log noise on every startup.\n    if (raw.opikTraceEnabled === true) {\n      log.warn(\n        \"[opik-exporter] opikTraceEnabled=true but no apiUrl found — \" +\n          \"set opikApiUrl in Engram config or ensure opik-openclaw plugin is configured\",\n      );\n    }\n    return null;\n  }\n\n  const cfg: OpikExporterConfig = {\n    enabled: true,\n    apiUrl,\n    projectName: raw.opikProjectName ?? detected.projectName ?? \"openclaw\",\n    workspaceName: raw.opikWorkspaceName ?? detected.workspaceName ?? \"default\",\n    apiKey: raw.opikApiKey ?? detected.apiKey,\n    traceRecallContent: raw.opikTraceRecallContent === true,\n  };\n\n  return new OpikExporter(cfg, log);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/opik-exporter.ts"],"sourcesContent":["import { createHash, randomBytes } from \"node:crypto\";\n/**\n * opik-exporter.ts — Engram-native Opik trace exporter\n *\n * Subscribes to the globalThis.__openclawEngramTrace slot that Engram already\n * emits on, and forwards recall + LLM events to a self-hosted (or cloud) Opik\n * instance via its REST API. No extra npm dependencies — uses Node's built-in\n * fetch.\n *\n * Auto-detects apiUrl / projectName from the opik-openclaw plugin config so\n * traces land in the same project and are grouped by session thread.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport type { LoggerBackend } from \"./logger.js\";\nimport { readEnvVar, resolveHomeDir } from \"./runtime/env.js\";\n\n// GlobalThis slot that tracks the active OpikExporter instance.\n// Used to make subscribe() idempotent across hot-reload / stop-start cycles.\nconst OPIK_EXPORTER_SLOT = \"__openclawOpikExporter\";\n\n// ---------------------------------------------------------------------------\n// Engram event types (mirrors types.ts without importing from it)\n// ---------------------------------------------------------------------------\n\ntype EngramLlmTraceEvent = {\n  kind: \"llm_start\" | \"llm_end\" | \"llm_error\";\n  traceId: string;\n  model: string;\n  operation: \"extraction\" | \"consolidation\" | \"profile_consolidation\" | \"identity_consolidation\" | \"day_summary\";\n  input?: string;\n  output?: string;\n  durationMs?: number;\n  error?: string;\n  tokenUsage?: { input?: number; output?: number; total?: number };\n};\n\ntype EngramRecallTraceEvent = {\n  kind: \"recall_summary\";\n  traceId: string;\n  operation: \"recall\";\n  sessionKey?: string;\n  promptLength: number;\n  retrievalQueryLength: number;\n  recallMode: string;\n  recallResultLimit: number;\n  qmdEnabled: boolean;\n  qmdAvailable: boolean;\n  recallNamespaces: string[];\n  source: string;\n  recalledMemoryCount: number;\n  injected: boolean;\n  contextChars: number;\n  identityInjectionMode?: string;\n  identityInjectedChars?: number;\n  durationMs: number;\n  timings?: Record<string, string>;\n  recalledContent?: string;\n};\n\ntype EngramTraceEvent = EngramLlmTraceEvent | EngramRecallTraceEvent;\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface OpikExporterConfig {\n  enabled: boolean;\n  /** Base URL of the Opik API, e.g. http://192.168.3.147:5173/api */\n  apiUrl: string;\n  projectName: string;\n  workspaceName: string;\n  /** Optional API key (not required for self-hosted deployments) */\n  apiKey?: string;\n  /** Include recalled memory text in spans (default false) */\n  traceRecallContent: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Auto-detect from opik-openclaw plugin config\n// ---------------------------------------------------------------------------\n\nfunction readOpikOpenclawConfig(log?: LoggerBackend): Partial<OpikExporterConfig> {\n  try {\n    const configPath =\n      readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\") ||\n      readEnvVar(\"OPENCLAW_CONFIG_PATH\") ||\n      path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n    const raw = JSON.parse(fs.readFileSync(configPath, \"utf-8\"));\n    const entry = raw?.plugins?.entries?.[\"opik-openclaw\"];\n    if (!entry?.enabled || !entry?.config) return {};\n    const c = entry.config as Record<string, unknown>;\n    return {\n      apiUrl: typeof c.apiUrl === \"string\" && c.apiUrl.length > 0 ? c.apiUrl : undefined,\n      projectName: typeof c.projectName === \"string\" ? c.projectName : undefined,\n      workspaceName: typeof c.workspaceName === \"string\" ? c.workspaceName : undefined,\n      apiKey: typeof c.apiKey === \"string\" && c.apiKey.length > 0 ? c.apiKey : undefined,\n    };\n  } catch (err) {\n    log?.debug?.(`[opik-exporter] could not read opik-openclaw config: ${err}`);\n    return {};\n  }\n}\n\n// ---------------------------------------------------------------------------\n// UUID v7 generator (Opik requires v7, not v4)\n// ---------------------------------------------------------------------------\n\nfunction uuidV7(): string {\n  const now = Date.now();\n  const bytes = randomBytes(16);\n  // Timestamp: 48-bit ms since epoch in bytes 0-5\n  bytes[0] = (now / 2 ** 40) & 0xff;\n  bytes[1] = (now / 2 ** 32) & 0xff;\n  bytes[2] = (now / 2 ** 24) & 0xff;\n  bytes[3] = (now / 2 ** 16) & 0xff;\n  bytes[4] = (now / 2 ** 8) & 0xff;\n  bytes[5] = now & 0xff;\n  // Version 7\n  bytes[6] = (bytes[6] & 0x0f) | 0x70;\n  // Variant 10xx\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n  const hex = bytes.toString(\"hex\");\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n// ---------------------------------------------------------------------------\n// REST helpers\n// ---------------------------------------------------------------------------\n\nfunction buildHeaders(cfg: OpikExporterConfig): Record<string, string> {\n  const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (cfg.workspaceName) headers[\"Comet-Workspace\"] = cfg.workspaceName;\n  // Opik expects the raw API key in the authorization header without a Bearer prefix.\n  if (cfg.apiKey) headers[\"authorization\"] = cfg.apiKey;\n  return headers;\n}\n\nasync function postSpanBatch(\n  cfg: OpikExporterConfig,\n  spans: unknown[],\n  log: LoggerBackend,\n): Promise<void> {\n  const url = `${cfg.apiUrl.replace(/\\/$/, \"\")}/v1/private/spans/batch`;\n  try {\n    const res = await fetch(url, {\n      method: \"POST\",\n      headers: buildHeaders(cfg),\n      body: JSON.stringify({ spans }),\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => \"\");\n      log.debug?.(`[opik-exporter] span batch failed ${res.status}: ${text}`);\n    }\n  } catch (err) {\n    log.debug?.(`[opik-exporter] span batch error: ${err}`);\n  }\n}\n\nasync function postTraceBatch(\n  cfg: OpikExporterConfig,\n  traces: unknown[],\n  log: LoggerBackend,\n): Promise<boolean> {\n  const url = `${cfg.apiUrl.replace(/\\/$/, \"\")}/v1/private/traces/batch`;\n  try {\n    const res = await fetch(url, {\n      method: \"POST\",\n      headers: buildHeaders(cfg),\n      body: JSON.stringify({ traces }),\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => \"\");\n      log.debug?.(`[opik-exporter] trace batch failed ${res.status}: ${text}`);\n      return false;\n    }\n    return true;\n  } catch (err) {\n    log.debug?.(`[opik-exporter] trace batch error: ${err}`);\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// In-flight LLM span tracking\n// ---------------------------------------------------------------------------\n\ntype InFlightLlm = {\n  startedAt: number;\n  startTime: string;\n  model: string;\n  operation: string;\n  input?: string;\n  spanId: string;\n  traceId: string;\n};\n\n// ---------------------------------------------------------------------------\n// Main exporter class\n// ---------------------------------------------------------------------------\n\nexport class OpikExporter {\n  private readonly cfg: OpikExporterConfig;\n  private readonly log: LoggerBackend;\n  private _handler: ((e: EngramTraceEvent) => void) | undefined;\n  private readonly inFlight = new Map<string, InFlightLlm>();\n  /** Track which trace_ids we have already created parent trace objects for. */\n  private readonly createdTraces = new Set<string>();\n  /** In-flight ensureTrace promises keyed by traceId — concurrent callers await the same promise. */\n  private readonly pendingTraces = new Map<string, Promise<void>>();\n  /** TTL for in-flight LLM entries (ms). Entries older than this are discarded. */\n  private static readonly IN_FLIGHT_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\n  constructor(cfg: OpikExporterConfig, log: LoggerBackend) {\n    this.cfg = cfg;\n    this.log = log;\n  }\n\n  /**\n   * Subscribe to Engram's global trace slot. Safe to call multiple times —\n   * chains with existing subscribers (e.g. Langfuse) rather than replacing.\n   */\n  subscribe(): void {\n    if (!this.cfg.enabled) return;\n\n    // Idempotency guard: if this exact instance is already registered on globalThis,\n    // skip re-wrapping to avoid stacking callbacks on hot-reload / stop-start cycles.\n    const g = globalThis as Record<string, unknown>;\n    const active = g[OPIK_EXPORTER_SLOT] as OpikExporter | undefined;\n    if (active === this) {\n      this.log.debug?.(\"[opik-exporter] already subscribed — skipping duplicate\");\n      return;\n    }\n    // If a different (stale) exporter instance is registered, evict it first.\n    if (active) active._detach();\n\n    g[OPIK_EXPORTER_SLOT] = this;\n\n    const existing = g.__openclawEngramTrace as\n      | ((e: EngramTraceEvent) => void)\n      | undefined;\n\n    const handler = (event: EngramTraceEvent) => {\n      try {\n        this.handleEvent(event);\n      } catch (err) {\n        this.log.debug?.(`[opik-exporter] handler error: ${err}`);\n      }\n    };\n    // Store handler ref so _detach() can remove it from the chain.\n    this._handler = handler;\n\n    // Chain: call existing subscribers first, then ours.\n    // NOTE: when _detach() is later called, it marks this.cfg.enabled = false\n    // rather than restoring the chain, so that any subscriber that chained\n    // *after* us is not dropped. The cost is one disabled no-op wrapper\n    // remaining in the chain per stop/start cycle. In practice, Engram\n    // restarts Opik only a handful of times per process lifetime, so the\n    // overhead is negligible (one boolean check per leftover closure).\n    g.__openclawEngramTrace =\n      typeof existing === \"function\"\n        ? (event: EngramTraceEvent) => {\n            try { existing(event); } catch { /* prior subscriber threw; continue */ }\n            handler(event);\n          }\n        : handler;\n\n    this.log.info(\n      `[opik-exporter] subscribed — apiUrl=${this.cfg.apiUrl} project=${this.cfg.projectName}`,\n    );\n  }\n\n  /** Deactivate this exporter instance.\n   *\n   * We intentionally do NOT restore __openclawEngramTrace to a prior handler\n   * because any subscriber that chained *after* us would be silently dropped\n   * by such a restoration. Instead we mark the instance as disabled so that\n   * handleEvent() becomes a no-op while the callback chain itself is left\n   * untouched. The next subscribe() call from a fresh instance will re-enter\n   * the chain on top of whatever is there at that point.\n   */\n  _detach(): void {\n    const g = globalThis as Record<string, unknown>;\n    // Only clear the global slot if we are still the active exporter.\n    // A stale instance must not evict a newer exporter that already took over.\n    if (g[OPIK_EXPORTER_SLOT] === this) delete g[OPIK_EXPORTER_SLOT];\n    // Disable event processing; the wrapper closure in the chain becomes a no-op.\n    (this.cfg as OpikExporterConfig & { enabled: boolean }).enabled = false;\n    this._handler = undefined;\n    this.log.debug?.(\"[opik-exporter] detached — events silenced, chain preserved\");\n  }\n\n  unsubscribe(): void {\n    this._detach();\n  }\n\n  private handleEvent(event: EngramTraceEvent): void {\n    if (!this.cfg.enabled) return; // guard for after _detach()\n    if (event.kind === \"recall_summary\") {\n      void this.onRecall(event);\n    } else if (event.kind === \"llm_start\") {\n      this.onLlmStart(event);\n    } else if (event.kind === \"llm_end\" || event.kind === \"llm_error\") {\n      void this.onLlmEnd(event);\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Recall events → general span\n  // -------------------------------------------------------------------------\n\n  private async onRecall(evt: EngramRecallTraceEvent): Promise<void> {\n    const now = new Date();\n    const startTime = new Date(now.getTime() - evt.durationMs).toISOString();\n    const endTime = now.toISOString();\n\n    const input: Record<string, unknown> = {\n      recallMode: evt.recallMode,\n      recalledMemoryCount: evt.recalledMemoryCount,\n      recallNamespaces: evt.recallNamespaces,\n      source: evt.source,\n      qmdEnabled: evt.qmdEnabled,\n      qmdAvailable: evt.qmdAvailable,\n      retrievalQueryLength: evt.retrievalQueryLength,\n      recallResultLimit: evt.recallResultLimit,\n      promptLength: evt.promptLength,\n    };\n\n    if (this.cfg.traceRecallContent && evt.recalledContent) {\n      input.recalledContent = evt.recalledContent;\n    }\n\n    const metadata: Record<string, unknown> = {\n      source: \"engram\",\n      injected: evt.injected,\n      contextChars: evt.contextChars,\n      durationMs: evt.durationMs,\n    };\n\n    if (evt.identityInjectionMode) {\n      metadata.identityInjectionMode = evt.identityInjectionMode;\n      metadata.identityInjectedChars = evt.identityInjectedChars;\n    }\n\n    if (evt.timings) metadata.timings = evt.timings;\n\n    const traceId = evt.sessionKey ? this.sessionToTraceId(evt.sessionKey) : uuidV7();\n\n    // Ensure parent trace exists so the span is not orphaned in Opik.\n    await this.ensureTrace(traceId, evt.sessionKey ?? \"engram:recall\", startTime, endTime);\n\n    const output: Record<string, unknown> = {\n      injected: evt.injected,\n      recalledMemoryCount: evt.recalledMemoryCount,\n      contextChars: evt.contextChars,\n      durationMs: evt.durationMs,\n    };\n    if (this.cfg.traceRecallContent && evt.recalledContent) {\n      output.recalledContent = evt.recalledContent;\n    }\n\n    const span = {\n      id: uuidV7(),\n      trace_id: traceId,\n      project_name: this.cfg.projectName,\n      name: \"engram:recall\",\n      type: \"general\",\n      start_time: startTime,\n      end_time: endTime,\n      input,\n      output,\n      metadata,\n      tags: [\"engram\", \"recall\"],\n    };\n\n    await postSpanBatch(this.cfg, [span], this.log);\n  }\n\n  // -------------------------------------------------------------------------\n  // Engram internal LLM events (extraction / consolidation) → llm span\n  // -------------------------------------------------------------------------\n\n  private onLlmStart(evt: EngramLlmTraceEvent): void {\n    // Use evt.traceId (Engram's correlation key) as the Opik spanId so spans\n    // are deterministic and stable across retries. Derive a per-call Opik\n    // trace_id from the same key so each LLM call maps to its own trace.\n    this.inFlight.set(evt.traceId, {\n      startedAt: Date.now(),\n      startTime: new Date().toISOString(),\n      model: evt.model,\n      operation: evt.operation,\n      input: evt.input,\n      spanId: this.sessionToTraceId(evt.traceId + \":span\"),\n      traceId: this.sessionToTraceId(evt.traceId),\n    });\n  }\n\n  private sweepStaleInFlight(): void {\n    const cutoff = Date.now() - OpikExporter.IN_FLIGHT_TTL_MS;\n    for (const [id, entry] of this.inFlight) {\n      if (entry.startedAt < cutoff) {\n        this.inFlight.delete(id);\n      }\n    }\n  }\n\n  private async onLlmEnd(evt: EngramLlmTraceEvent): Promise<void> {\n    // Opportunistically sweep stale entries to prevent unbounded map growth.\n    if (this.inFlight.size > 20) this.sweepStaleInFlight();\n    const state = this.inFlight.get(evt.traceId);\n    this.inFlight.delete(evt.traceId);\n\n    const startTime = state?.startTime ?? new Date().toISOString();\n    const endTime = new Date().toISOString();\n\n    const usage: Record<string, number> = {};\n    if (evt.tokenUsage?.input != null) usage.prompt_tokens = evt.tokenUsage.input;\n    if (evt.tokenUsage?.output != null) usage.completion_tokens = evt.tokenUsage.output;\n    if (evt.tokenUsage?.total != null) usage.total_tokens = evt.tokenUsage.total;\n\n    const traceId = state?.traceId ?? uuidV7();\n\n    // Ensure parent trace exists so the span is not orphaned in Opik.\n    await this.ensureTrace(traceId, `engram:${evt.operation}`, startTime, endTime);\n\n    const span: Record<string, unknown> = {\n      id: state?.spanId ?? uuidV7(),\n      trace_id: traceId,\n      project_name: this.cfg.projectName,\n      name: `engram:${evt.operation}`,\n      type: \"llm\",\n      model: evt.model,\n      start_time: startTime,\n      end_time: endTime,\n      input: state?.input != null ? { prompt: state.input } : undefined,\n      output:\n        evt.kind === \"llm_end\" && evt.output != null\n          ? { completion: evt.output }\n          : evt.kind === \"llm_error\"\n            ? { error: evt.error }\n            : undefined,\n      metadata: {\n        source: \"engram\",\n        operation: evt.operation,\n        durationMs: evt.durationMs ?? (state ? Date.now() - state.startedAt : undefined),\n      },\n      tags: [\"engram\", evt.operation],\n      usage: Object.keys(usage).length > 0 ? usage : undefined,\n    };\n\n    await postSpanBatch(this.cfg, [span], this.log);\n  }\n\n  // -------------------------------------------------------------------------\n  // Helpers\n  // -------------------------------------------------------------------------\n\n  /**\n   * Create a parent trace object in Opik if we haven't already.\n   * Opik does NOT auto-create traces from spans, so without this\n   * the spans are orphaned and don't show up in the trace list UI.\n   */\n  private async ensureTrace(\n    traceId: string,\n    name: string,\n    startTime: string,\n    endTime: string,\n  ): Promise<void> {\n    if (this.createdTraces.has(traceId)) return;\n\n    // If another call is already creating this trace, wait for it and then\n    // re-check — if the first attempt failed we'll retry below.\n    const existing = this.pendingTraces.get(traceId);\n    if (existing) {\n      await existing;\n      if (this.createdTraces.has(traceId)) return;\n      // First attempt failed — check if another waiter is already retrying.\n      const retrying = this.pendingTraces.get(traceId);\n      if (retrying) {\n        await retrying;\n        // Only return if the retry actually succeeded.\n        if (this.createdTraces.has(traceId)) return;\n      }\n      // No one else retrying; fall through to create.\n    }\n\n    const work = (async () => {\n      const trace = {\n        id: traceId,\n        project_name: this.cfg.projectName,\n        name,\n        start_time: startTime,\n        end_time: endTime,\n        tags: [\"engram\"],\n      };\n\n      const ok = await postTraceBatch(this.cfg, [trace], this.log);\n      if (!ok) {\n        this.pendingTraces.delete(traceId);\n        return; // transient failure — allow retry on next span\n      }\n\n      this.createdTraces.add(traceId);\n      this.pendingTraces.delete(traceId);\n\n      // Cap the set size to prevent unbounded growth in long-running processes.\n      if (this.createdTraces.size > 10_000) {\n        const first = this.createdTraces.values().next().value;\n        if (first) this.createdTraces.delete(first);\n      }\n    })();\n\n    this.pendingTraces.set(traceId, work);\n    await work;\n  }\n\n  /**\n   * Convert a sessionKey to a stable, deterministic UUID v7-shaped ID so that\n   * spans for the same session share a trace_id and are threaded in Opik.\n   * Uses SHA-256 for collision resistance. The timestamp bytes (0-5) come from\n   * the hash itself — they don't reflect real time, but Opik only validates\n   * the version/variant bits, not timestamp ordering.\n   */\n  private sessionToTraceId(sessionKey: string): string {\n    const digest = createHash(\"sha256\").update(sessionKey).digest();\n    // Version 7 (bytes 0-5 are hash-derived, not real timestamps)\n    digest[6] = (digest[6] & 0x0f) | 0x70;\n    // Variant 10xx\n    digest[8] = (digest[8] & 0x3f) | 0x80;\n    const hex = digest.slice(0, 16).toString(\"hex\");\n    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory: build from Engram resolved config + auto-detect from opik-openclaw\n// ---------------------------------------------------------------------------\n\nexport interface OpikExporterRawConfig {\n  opikTraceEnabled?: boolean;\n  opikApiUrl?: string;\n  opikProjectName?: string;\n  opikWorkspaceName?: string;\n  opikApiKey?: string;\n  opikTraceRecallContent?: boolean;\n}\n\nexport function createOpikExporter(\n  raw: OpikExporterRawConfig,\n  log: LoggerBackend,\n): OpikExporter | null {\n  // Explicit opt-out: if set to false, never enable.\n  if (raw.opikTraceEnabled === false) return null;\n\n  // Auto-detect from opik-openclaw plugin config.\n  // If opikTraceEnabled is not set (undefined), we enable automatically\n  // whenever opik-openclaw is configured — avoids needing extra fields in\n  // Engram's openclaw.json config section (which would fail schema validation).\n  const detected = readOpikOpenclawConfig(log);\n\n  const apiUrl = raw.opikApiUrl ?? detected.apiUrl;\n  if (!apiUrl) {\n    // Only warn when the user explicitly opted in but forgot to set the URL.\n    // When auto-detecting (opikTraceEnabled not set), return silently so non-Opik\n    // users see no log noise on every startup.\n    if (raw.opikTraceEnabled === true) {\n      log.warn(\n        \"[opik-exporter] opikTraceEnabled=true but no apiUrl found — \" +\n          \"set opikApiUrl in Engram config or ensure opik-openclaw plugin is configured\",\n      );\n    }\n    return null;\n  }\n\n  const cfg: OpikExporterConfig = {\n    enabled: true,\n    apiUrl,\n    projectName: raw.opikProjectName ?? detected.projectName ?? \"openclaw\",\n    workspaceName: raw.opikWorkspaceName ?? detected.workspaceName ?? \"default\",\n    apiKey: raw.opikApiKey ?? detected.apiKey,\n    traceRecallContent: raw.opikTraceRecallContent === true,\n  };\n\n  return new OpikExporter(cfg, log);\n}\n"],"mappings":"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","names":[]}

package/dist/{orchestrator-CvUYwuaL.d.ts → orchestrator-6IvQ-Phj.d.ts}

@@ -1,5 +1,5 @@
 import { SmartBuffer } from './buffer.js';
-import { S as SearchBackend, a as SearchQueryOptions, b as SearchExecutionOptions } from './port-BkWL7hqo.js';
+import { S as SearchBackend, a as SearchQueryOptions, b as SearchExecutionOptions } from './port-B6VEDIkC.js';
 import { StorageManager } from './storage.js';
 import { TranscriptManager } from './transcript.js';
 import { HourlySummarizer } from './summarizer.js';
@@ -13,8 +13,9 @@ import { LastRecallStore, TierMigrationStatusStore, GraphRecallExpandedEntry, Ti
 import { RecallXraySnapshot } from './recall-xray.js';
 import { SessionObserverState } from './session-observer-state.js';
 import { EmbeddingFallback } from './embedding-fallback.js';
-import { L as LcmMessagePartInput, j as MessagePartSourceFormat, P as PluginConfig, S as CodingContext, U as QmdSearchResult, e as BehaviorLoopPolicyState, V as BootstrapOptions, W as BootstrapResult, X as ConsolidationObservation, f as MemoryFile, D as DaySummaryResult, s as MemoryActionEvent, R as RecallPlanMode, Y as MemoryIntent, Z as EntityTimelineEntry, _ as ExtractionResult, o as MemoryFrontmatter, $ as IdentityInjectionMode } from './types-H85grL1f.js';
-import { S as SemanticConsolidationResult } from './semantic-consolidation-CGiH52qa.js';
+import { L as LcmMessagePartInput, M as MessagePartSourceFormat } from './index-1qIcnbG1.js';
+import { PluginConfig, CodingContext, QmdSearchResult, BehaviorLoopPolicyState, BootstrapOptions, BootstrapResult, ConsolidationObservation, MemoryFile, DaySummaryResult, MemoryActionEvent, RecallPlanMode, MemoryIntent, EntityTimelineEntry, ExtractionResult, MemoryFrontmatter, IdentityInjectionMode } from './types.js';
+import { S as SemanticConsolidationResult } from './semantic-consolidation-ByBXb-sf.js';
 import { z } from 'zod';
 import { RuntimePolicyValues } from './policy-runtime.js';
 import { ProfilingCollector } from './profiling.js';
@@ -1009,7 +1010,7 @@ declare class Orchestrator {
     private readonly memoryWorthCounterCache;
     private static readonly MEMORY_WORTH_CACHE_TTL_MS;
     /**
-     * Per-session workspace overrides keyed by sessionKey.
+     * Per-session workspace selections keyed by sessionKey.
      * Set by the before_agent_start hook so recall() uses the correct
      * agent workspace for BOOT.md injection. Cleared after each recall.
      * Using a Map prevents concurrent sessions from overwriting each other.
@@ -1098,7 +1099,7 @@ declare class Orchestrator {
     private disposeSearchBackendIfNeeded;
     /** Set per-session workspace for the next recall() call (compaction reset). @internal */
     setRecallWorkspaceOverride(sessionKey: string, dir: string): void;
-    /** Remove a per-session workspace override (cleanup on error or early return). @internal */
+    /** Remove a per-session workspace selection (cleanup on error or early return). @internal */
     clearRecallWorkspaceOverride(sessionKey: string): void;
     resolvePrincipal(sessionKey?: string): string;
     resolveSelfNamespace(sessionKey?: string): string;

package/dist/orchestrator.d.ts

@@ -1,12 +1,12 @@
 import './buffer.js';
-import './port-BkWL7hqo.js';
+import './port-B6VEDIkC.js';
 import './storage.js';
 import './transcript.js';
 import './summarizer.js';
 import './local-llm.js';
 import './fallback-llm.js';
 import './live-connectors-runner.js';
-export { q as GraphRecallRankedResult, r as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, Q as QmdRecallSnapshot, t as RecallInvocationOptions, u as RecallModeDecision, w as appendMemoryToGraphContext, x as blendGraphExpandedRecallScore, y as buildCompressionGuidelinesMarkdown, z as buildMemoryPathById, A as computeArtifactCandidateFetchLimit, D as computeArtifactRecallLimit, E as computeQmdHybridFetchLimit, F as dedupeEntitySynthesisEvidenceEntries, n as defaultWorkspaceDir, H as deriveTopicsFromExtraction, J as filterRecallCandidates, K as formatCompressionGuidelinesForRecall, L as graphPathRelativeToStorage, M as hasIdentityRecoveryIntent, N as isArtifactMemoryPath, T as lifecycleRecallScoreAdjustment, U as mergeArtifactRecallCandidates, V as mergeGraphExpandedResults, W as resolveEffectiveIdentityInjectionMode, X as resolveEffectiveRecallMode, Y as resolvePersistedMemoryRelativePath, Z as resolveRecallModeDecision, _ as resolveRecentThreadMemoryPaths, s as sanitizeSessionKeyForFilename, $ as shouldFilterLifecycleRecallCandidate, a0 as summarizeGraphShadowComparison } from './orchestrator-CvUYwuaL.js';
+export { q as GraphRecallRankedResult, r as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, Q as QmdRecallSnapshot, t as RecallInvocationOptions, u as RecallModeDecision, w as appendMemoryToGraphContext, x as blendGraphExpandedRecallScore, y as buildCompressionGuidelinesMarkdown, z as buildMemoryPathById, A as computeArtifactCandidateFetchLimit, D as computeArtifactRecallLimit, E as computeQmdHybridFetchLimit, F as dedupeEntitySynthesisEvidenceEntries, n as defaultWorkspaceDir, H as deriveTopicsFromExtraction, J as filterRecallCandidates, K as formatCompressionGuidelinesForRecall, L as graphPathRelativeToStorage, M as hasIdentityRecoveryIntent, N as isArtifactMemoryPath, T as lifecycleRecallScoreAdjustment, U as mergeArtifactRecallCandidates, V as mergeGraphExpandedResults, W as resolveEffectiveIdentityInjectionMode, X as resolveEffectiveRecallMode, Y as resolvePersistedMemoryRelativePath, Z as resolveRecallModeDecision, _ as resolveRecentThreadMemoryPaths, s as sanitizeSessionKeyForFilename, $ as shouldFilterLifecycleRecallCandidate, a0 as summarizeGraphShadowComparison } from './orchestrator-6IvQ-Phj.js';
 import './model-registry.js';
 import './relevance.js';
 import './negative.js';
@@ -14,16 +14,17 @@ import './recall-state.js';
 import './recall-xray.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './types-H85grL1f.js';
-import './semantic-consolidation-CGiH52qa.js';
+import './types.js';
+import './semantic-consolidation-ByBXb-sf.js';
 import './policy-runtime.js';
 import './profiling.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-lCzmu4JX.js';
+import './memory-projection-store-CY8TU40w.js';
 import 'better-sqlite3';
+import './index-1qIcnbG1.js';
 import './session-integrity.js';
 import './framework-CyHYDcri.js';
 import 'zod';
-import './codex-materialize-xVqbEmcm.js';
+import './codex-materialize-CQlLTzke.js';
 import './logger.js';

package/dist/orchestrator.js

@@ -26,18 +26,18 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-GRDDGNYQ.js";
-import "./chunk-SRIDOT64.js";
+} from "./chunk-5GCNE7CN.js";
+import "./chunk-4DXC6HQQ.js";
 import "./chunk-CK5NTM2S.js";
 import "./chunk-FSFEQI74.js";
+import "./chunk-MDYG7VI7.js";
 import "./chunk-Z5AAYHUC.js";
 import "./chunk-S75M5ZRK.js";
 import "./chunk-TPB3I2AC.js";
 import "./chunk-UHGBNIOS.js";
-import "./chunk-S5SQDIF5.js";
+import "./chunk-PHNGXFQ6.js";
 import "./chunk-ETOW6ACV.js";
 import "./chunk-ZTSE2ZJ6.js";
-import "./chunk-MDYG7VI7.js";
 import "./chunk-JR4ZC3G4.js";
 import "./chunk-K4FLSOR5.js";
 import "./chunk-V3RXWQIE.js";
@@ -55,59 +55,59 @@ import "./chunk-H63EDPFJ.js";
 import "./chunk-3GPTTA4J.js";
 import "./chunk-IISBCCWR.js";
 import "./chunk-GGD5W7TB.js";
-import "./chunk-ASIQZXYO.js";
+import "./chunk-XMVFHBHT.js";
 import "./chunk-YAZNBMNF.js";
-import "./chunk-KNQ5YJTO.js";
+import "./chunk-Z5S5HNGY.js";
+import "./chunk-WW3QQF4H.js";
+import "./chunk-54V4BZWP.js";
+import "./chunk-QR3C7BKQ.js";
+import "./chunk-NN3LPQ5D.js";
+import "./chunk-ERUDW6DU.js";
 import "./chunk-74WWN7ZW.js";
 import "./chunk-DF3RVK3X.js";
 import "./chunk-C4SQJZAF.js";
-import "./chunk-FCGWNWG4.js";
-import "./chunk-WW3QQF4H.js";
-import "./chunk-54V4BZWP.js";
-import "./chunk-FEMOX5AD.js";
-import "./chunk-R2XRID2N.js";
-import "./chunk-GZCUW5IC.js";
+import "./chunk-3IQ2TR4N.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-6AUUAZEX.js";
 import "./chunk-Y4FHOFJ2.js";
 import "./chunk-Z2E7VW55.js";
-import "./chunk-MYH2IBSP.js";
+import "./chunk-LIO5X3CM.js";
 import "./chunk-2NMMFZ5T.js";
 import "./chunk-SRBJUAMP.js";
 import "./chunk-PYXS46O7.js";
 import "./chunk-3QKK7QOS.js";
-import "./chunk-ETA2JXP5.js";
+import "./chunk-RXTFCYQF.js";
 import "./chunk-JRNQ3RNA.js";
-import "./chunk-RLV2F337.js";
+import "./chunk-PB5KW5PL.js";
 import "./chunk-CULXMQJH.js";
 import "./chunk-E6K4NIEU.js";
-import "./chunk-RJSVRPNU.js";
+import "./chunk-57QNCUEZ.js";
 import "./chunk-YRMVARQP.js";
-import "./chunk-WSZIHQBK.js";
+import "./chunk-P77UEOU2.js";
 import "./chunk-EABGC2TL.js";
-import "./chunk-LOBRX7VD.js";
-import "./chunk-L2IO2QPY.js";
+import "./chunk-4IS4SXIQ.js";
 import "./chunk-6TBWYBJ3.js";
 import "./chunk-HMDCOMYU.js";
 import "./chunk-JXS5PDQ7.js";
 import "./chunk-K6WK37A6.js";
 import "./chunk-AJU4PJGY.js";
+import "./chunk-C6QPK5GG.js";
 import "./chunk-7SEAZFFB.js";
+import "./chunk-FYIYMQ5N.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-OZHRDTDX.js";
-import "./chunk-C6QPK5GG.js";
 import "./chunk-3PG3H5TD.js";
-import "./chunk-FYIYMQ5N.js";
 import "./chunk-KVE7R4CG.js";
 import "./chunk-4WMCPJWX.js";
 import "./chunk-JBMSGZEQ.js";
-import "./chunk-FIXIX6DE.js";
+import "./chunk-C5HUWVH2.js";
 import "./chunk-EJI5XIBB.js";
-import "./chunk-DWMXVUGO.js";
-import "./chunk-Q7FJ5ZHM.js";
-import "./chunk-ODWDQNRE.js";
+import "./chunk-VX2IUQFE.js";
+import "./chunk-S3IP6R6K.js";
 import "./chunk-L2EXJQJP.js";
+import "./chunk-7SI52C65.js";
 import "./chunk-UZB5KHKX.js";
+import "./chunk-KWBPHZUU.js";
 import "./chunk-6HZ6AO2P.js";
 import "./chunk-JWPLJLDU.js";
 import "./chunk-N53K2EXC.js";
@@ -115,34 +115,36 @@ import "./chunk-XYIK4LF6.js";
 import "./chunk-URB2WSKZ.js";
 import "./chunk-PVGDJXVK.js";
 import "./chunk-NGAVDO7E.js";
-import "./chunk-NN3TS5BM.js";
+import "./chunk-D54LZC5L.js";
 import "./chunk-EQINRHYR.js";
-import "./chunk-AV2WSYZY.js";
-import "./chunk-IXEJRKCZ.js";
-import "./chunk-3FPTCC3Z.js";
-import "./chunk-2LGMW3DJ.js";
+import "./chunk-2YMTO4ZJ.js";
+import "./chunk-IBX3VFOM.js";
+import "./chunk-5UM2VJ6D.js";
 import "./chunk-EEQLFRUM.js";
 import "./chunk-NBNN5GOB.js";
 import "./chunk-OR64ZGRZ.js";
+import "./chunk-GVPWB7EY.js";
+import "./chunk-2LGMW3DJ.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-RK2Y4XOM.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-WIICJPET.js";
 import "./chunk-G2WADRQ3.js";
+import "./chunk-IXEJRKCZ.js";
 import "./chunk-DT5TVLJE.js";
 import "./chunk-N5AKDXAI.js";
 import "./chunk-TBBDFYXW.js";
-import "./chunk-XGX4TUF6.js";
+import "./chunk-MCC6KDQF.js";
 import "./chunk-YNJHCGDT.js";
-import "./chunk-4KAN3GZ3.js";
-import "./chunk-T65SHTJP.js";
+import "./chunk-NN2DKE4T.js";
+import "./chunk-VQXK37XA.js";
 import "./chunk-PFV5C235.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-67YLUWLG.js";
+import "./chunk-XJKFSSDW.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
-import "./chunk-M62O4P4T.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";

package/dist/patterns-cli.d.ts

@@ -1,4 +1,5 @@
-import { M as MemoryCategory, f as MemoryFile } from './types-H85grL1f.js';
+import { MemoryCategory, MemoryFile } from './types.js';
+import './index-1qIcnbG1.js';
 
 /**
  * `remnic patterns` CLI helpers (issue #687 PR 4/4).

package/dist/{peers-6OSQ3NK6.js → peers-HCVGHMAE.js}

@@ -2,7 +2,7 @@ import {
   buildPeerProfileReasonerPrompt,
   parsePeerProfileReasonerResponse,
   runPeerProfileReasoner
-} from "./chunk-3LCWFNVS.js";
+} from "./chunk-SKE7JYKA.js";
 import {
   PEERS_DIR_NAME,
   PEER_ID_MAX_LENGTH,
@@ -19,7 +19,7 @@ import {
   readPeerProfile,
   writePeer,
   writePeerProfile
-} from "./chunk-TUFG6VXY.js";
+} from "./chunk-4DWOBS2A.js";
 import "./chunk-PZ5AY32C.js";
 export {
   PEERS_DIR_NAME,
@@ -41,4 +41,4 @@ export {
   writePeer,
   writePeerProfile
 };
-//# sourceMappingURL=peers-6OSQ3NK6.js.map
+//# sourceMappingURL=peers-HCVGHMAE.js.map

package/dist/peers-HCVGHMAE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/policy-runtime.d.ts

@@ -1,4 +1,5 @@
-import { P as PluginConfig, e as BehaviorLoopPolicyState } from './types-H85grL1f.js';
+import { PluginConfig, BehaviorLoopPolicyState } from './types.js';
+import './index-1qIcnbG1.js';
 
 interface RuntimePolicyValues {
     recencyWeight?: number;

package/dist/{port-BkWL7hqo.d.ts → port-B6VEDIkC.d.ts}

@@ -1,4 +1,4 @@
-import { U as QmdSearchResult } from './types-H85grL1f.js';
+import { QmdSearchResult } from './types.js';
 
 /** Alias so consumers don't need to reference "Qmd" in a backend-agnostic context. */
 type SearchResult = QmdSearchResult;
@@ -33,6 +33,12 @@ interface SearchBackend {
     hybridSearch(query: string, collection?: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]>;
     update(execution?: SearchExecutionOptions): Promise<void>;
     updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;
+    /**
+     * True when update() refreshes every indexed collection, not just this
+     * backend's configured collection. Namespace routers use this to avoid
+     * repeating the same expensive global update once per namespace.
+     */
+    updatesAllCollections?(): boolean;
     /**
      * Optional strict refresh used by callers that must know whether a collection
      * was actually refreshed before writing success markers. Ordinary update

package/dist/qmd-recall-cache.d.ts

@@ -1,5 +1,6 @@
-import { R as RecallPlanMode } from './types-H85grL1f.js';
-import { a as SearchQueryOptions } from './port-BkWL7hqo.js';
+import { RecallPlanMode } from './types.js';
+import { a as SearchQueryOptions } from './port-B6VEDIkC.js';
+import './index-1qIcnbG1.js';
 
 type QmdRecallCacheSource = "fresh" | "stale";
 interface QmdRecallCacheHit<T> {

package/dist/qmd.d.ts

@@ -1,5 +1,6 @@
-import { U as QmdSearchResult, aM as QmdSearchExplain } from './types-H85grL1f.js';
-import { S as SearchBackend, a as SearchQueryOptions, b as SearchExecutionOptions } from './port-BkWL7hqo.js';
+import { QmdSearchResult, QmdSearchExplain } from './types.js';
+import { S as SearchBackend, a as SearchQueryOptions, b as SearchExecutionOptions } from './port-B6VEDIkC.js';
+import './index-1qIcnbG1.js';
 
 interface QmdClientOptions {
     slowLog?: {
@@ -102,6 +103,7 @@ declare class QmdClient implements SearchBackend {
     update(execution?: SearchExecutionOptions): Promise<void>;
     updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;
     updateCollectionStrict(collection: string, execution?: SearchExecutionOptions): Promise<void>;
+    updatesAllCollections(): boolean;
     private runUpdateForCollection;
     embed(): Promise<void>;
     embedCollection(collection: string): Promise<void>;

package/dist/qmd.js

@@ -1,7 +1,7 @@
 import {
   QmdClient,
   parseQmdExplain
-} from "./chunk-WSZIHQBK.js";
+} from "./chunk-P77UEOU2.js";
 import "./chunk-PVGDJXVK.js";
 import "./chunk-OR64ZGRZ.js";
 import "./chunk-PFV5C235.js";

package/dist/recall-disclosure-escalation.d.ts

@@ -1,4 +1,5 @@
-import { g as RecallDisclosure } from './types-H85grL1f.js';
+import { RecallDisclosure } from './types.js';
+import './index-1qIcnbG1.js';
 
 /**
  * Recall disclosure auto-escalation policy (issue #677 PR 4/4).

package/dist/recall-explain-renderer.d.ts

@@ -1,6 +1,7 @@
 import { LastRecallSnapshot } from './recall-state.js';
-import { Q as RecallTierExplain } from './types-H85grL1f.js';
+import { RecallTierExplain } from './types.js';
 import { RecallXraySnapshot } from './recall-xray.js';
+import './index-1qIcnbG1.js';
 
 /**
  * Renderers for RecallTierExplain (issue #518).

package/dist/recall-explain-renderer.js

@@ -5,10 +5,10 @@ import {
   toRecallExplainJson,
   toRecallExplainText,
   toRecallXraySnapshotFromLegacy
-} from "./chunk-WXPPM426.js";
+} from "./chunk-O4XJUPSF.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-AV2WSYZY.js";
-import "./chunk-T65SHTJP.js";
+import "./chunk-2YMTO4ZJ.js";
+import "./chunk-VQXK37XA.js";
 import "./chunk-PZ5AY32C.js";
 export {
   parseRecallExplainFormat,

package/dist/recall-state.d.ts

@@ -1,4 +1,5 @@
-import { R as RecallPlanMode, $ as IdentityInjectionMode, Q as RecallTierExplain } from './types-H85grL1f.js';
+import { RecallPlanMode, IdentityInjectionMode, RecallTierExplain } from './types.js';
+import './index-1qIcnbG1.js';
 
 interface LastRecallBudgetSummary {
     requestedTopK?: number;