@remnic/plugin-openclaw 1.0.32 → 1.0.34

package/README.md

@@ -164,6 +164,13 @@ CI jobs that provision OpenClaw should use
 `npm run check:openclaw-sdk-surface:required` or pass
 `-- --require --package-root <path>` so a missing SDK fails instead of skipping.
 
+Last compatibility sweep: May 7, 2026. The SDK surface check passed against
+`openclaw@2026.5.3`, `openclaw@2026.5.3-1`, `openclaw@2026.5.4-beta.1`,
+`openclaw@2026.5.4-beta.2`, `openclaw@2026.5.4-beta.3`,
+`openclaw@2026.5.4`, `openclaw@2026.5.5`, and `openclaw@2026.5.6`.
+Keep the peer range broad unless an upstream release removes a runtime surface
+Remnic actively uses.
+
 Native memory registrars are tracked separately in
 [`docs/plugins/openclaw-native-memory-registrars.md`](../../docs/plugins/openclaw-native-memory-registrars.md).
 That spike explains why Remnic currently uses `registerMemoryCapability()` as

package/dist/{calibration-V6NBBNCD.js → calibration-JD4AU7FB.js}

@@ -3,12 +3,12 @@ import {
 } from "./chunk-5LE4HTVL.js";
 import {
   FallbackLlmClient
-} from "./chunk-24MGN4E3.js";
+} from "./chunk-7NUFIRM3.js";
 import "./chunk-3A5ELHTT.js";
 import {
   log
 } from "./chunk-UFU5GGGA.js";
-import "./chunk-I6B2W2IY.js";
+import "./chunk-TDRJVMUP.js";
 import "./chunk-MLKGABMK.js";
 
 // ../remnic-core/src/calibration.ts
@@ -183,7 +183,9 @@ function buildCalibrationRecallSection(rules, query, maxChars = 1200) {
 }
 async function runCalibrationConsolidation(options) {
   try {
-    const llm = new FallbackLlmClient(options.gatewayConfig);
+    const llm = new FallbackLlmClient(options.gatewayConfig, {
+      workspaceDir: options.workspaceDir
+    });
     if (!llm.isAvailable(options.gatewayAgentId)) {
       log.debug("[calibration] no LLM available \u2014 skipping consolidation");
       return [];
@@ -229,7 +231,8 @@ async function runCalibrationIfEnabled(options) {
   }
   return runCalibrationConsolidation({
     memoryDir: options.memoryDir,
-    gatewayConfig: options.gatewayConfig
+    gatewayConfig: options.gatewayConfig,
+    workspaceDir: options.workspaceDir
   });
 }
 async function getCalibrationRulesForRecall(memoryDir) {

package/dist/{causal-consolidation-3GTZFN2T.js → causal-consolidation-DSLFN64P.js}

@@ -5,7 +5,7 @@ import {
 import {
   buildExtensionsBlockForConsolidation,
   runPostConsolidationMaterialize
-} from "./chunk-HI5HX3S7.js";
+} from "./chunk-NDZNURDM.js";
 import "./chunk-WPINX4MF.js";
 import {
   isRecord
@@ -16,7 +16,7 @@ import {
 } from "./chunk-5LE4HTVL.js";
 import {
   FallbackLlmClient
-} from "./chunk-24MGN4E3.js";
+} from "./chunk-7NUFIRM3.js";
 import "./chunk-3A5ELHTT.js";
 import "./chunk-ZXLYEVOP.js";
 import "./chunk-6OJAU466.js";
@@ -25,7 +25,7 @@ import {
   log
 } from "./chunk-UFU5GGGA.js";
 import "./chunk-YGGGUTG3.js";
-import "./chunk-I6B2W2IY.js";
+import "./chunk-TDRJVMUP.js";
 import "./chunk-MLKGABMK.js";
 
 // ../remnic-core/src/causal-consolidation.ts
@@ -177,7 +177,9 @@ async function deriveCausalPromotionCandidates(options) {
         context += "\n\n" + extBlock;
       }
     }
-    const llm = new FallbackLlmClient(options.gatewayConfig);
+    const llm = new FallbackLlmClient(options.gatewayConfig, {
+      workspaceDir: options.pluginConfig?.workspaceDir ?? options.workspaceDir
+    });
     if (!llm.isAvailable(options.gatewayAgentId)) {
       log.debug("[cmc] no LLM available for consolidation \u2014 skipping");
       return [];
@@ -198,7 +200,9 @@ async function synthesizeCausalPreferencesViaLlm(options) {
     const chainsDir = resolveChainsDir(options.memoryDir, options.causalTrajectoryStoreDir);
     const chainIndex = await readChainIndex(chainsDir);
     const context = formatCausalContext(trajectories, chainIndex);
-    const llm = new FallbackLlmClient(options.gatewayConfig);
+    const llm = new FallbackLlmClient(options.gatewayConfig, {
+      workspaceDir: options.workspaceDir
+    });
     if (!llm.isAvailable(options.gatewayAgentId)) return null;
     const result = await consolidateWithLlm(context, llm, options.gatewayAgentId);
     if (result.preferences.length === 0 && result.rules.length === 0) return null;

package/dist/{chunk-UVQXEQBQ.js → chunk-7NMHI4IC.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-UFU5GGGA.js";
 import {
   expandTildePath
-} from "./chunk-OEI7GLV2.js";
+} from "./chunk-TDRJVMUP.js";
 
 // ../remnic-core/src/compounding/engine.ts
 import { createHash } from "crypto";
@@ -842,12 +842,13 @@ var CompoundingEngine = class {
     let promotionCandidates = this.config.compoundingSemanticEnabled ? this.derivePromotionCandidates(outcomeSummary, mistakes.registry, rubrics) : [];
     if (this.config.cmcConsolidationEnabled) {
       try {
-        const { deriveCausalPromotionCandidates, materializeAfterCausalConsolidation } = await import("./causal-consolidation-3GTZFN2T.js");
+        const { deriveCausalPromotionCandidates, materializeAfterCausalConsolidation } = await import("./causal-consolidation-DSLFN64P.js");
         const causalCandidates = await deriveCausalPromotionCandidates({
           memoryDir: this.config.memoryDir,
           causalTrajectoryStoreDir: this.config.causalTrajectoryStoreDir,
           gatewayConfig: this.config.gatewayConfig,
           gatewayAgentId: this.config.modelSource === "gateway" ? this.config.gatewayAgentId || void 0 : void 0,
+          workspaceDir: this.config.workspaceDir,
           pluginConfig: this.config,
           config: {
             minRecurrence: this.config.cmcConsolidationMinRecurrence,
@@ -874,11 +875,12 @@ var CompoundingEngine = class {
     }
     if (this.config.calibrationEnabled) {
       try {
-        const { runCalibrationConsolidation } = await import("./calibration-V6NBBNCD.js");
+        const { runCalibrationConsolidation } = await import("./calibration-JD4AU7FB.js");
         const calRules = await runCalibrationConsolidation({
           memoryDir: this.config.memoryDir,
           gatewayConfig: this.config.gatewayConfig,
-          gatewayAgentId: this.config.modelSource === "gateway" ? this.config.gatewayAgentId || void 0 : void 0
+          gatewayAgentId: this.config.modelSource === "gateway" ? this.config.gatewayAgentId || void 0 : void 0,
+          workspaceDir: this.config.workspaceDir
         });
         log.debug(`[calibration] weekly synthesis produced ${calRules.length} calibration rule(s)`);
       } catch (error) {

package/dist/{chunk-24MGN4E3.js → chunk-7NUFIRM3.js}

@@ -5,8 +5,13 @@ import {
   log
 } from "./chunk-UFU5GGGA.js";
 import {
-  readEnvVar
-} from "./chunk-I6B2W2IY.js";
+  expandTildePath,
+  readEnvVar,
+  resolveHomeDir
+} from "./chunk-TDRJVMUP.js";
+
+// ../remnic-core/src/fallback-llm.ts
+import path2 from "path";
 
 // ../remnic-core/src/openai-chat-compat.ts
 function normalizedModel(model) {
@@ -269,6 +274,73 @@ function loadModelsJsonProviders() {
   return {};
 }
 
+// ../remnic-core/src/codex-cli-fallback.ts
+var VALID_CODEX_CLI_REASONING_EFFORTS = /* @__PURE__ */ new Set([
+  "low",
+  "medium",
+  "high",
+  "xhigh"
+]);
+var processRunner;
+async function callCodexCliFallback(config, modelId, messages, options = {}) {
+  if (!processRunner) {
+    throw new Error(
+      'codex-cli fallback transport is not registered; install a runner with setCodexCliFallbackRunnerForProcess() before using api: "codex-cli"'
+    );
+  }
+  return await processRunner({
+    config: normalizeCodexCliFallbackConfig(config),
+    modelId: normalizeCodexCliModel(modelId),
+    messages,
+    options: normalizeCodexCliFallbackOptions(options)
+  });
+}
+function normalizeCodexCliFallbackConfig(config) {
+  return {
+    ...config,
+    ...config.executable !== void 0 ? { executable: normalizeOptionalString(config.executable, "codex-cli executable") } : {},
+    ...config.codexCliExecutable !== void 0 ? { codexCliExecutable: normalizeOptionalString(config.codexCliExecutable, "codex-cli executable") } : {},
+    ...config.reasoningEffort !== void 0 ? { reasoningEffort: normalizeCodexCliReasoningEffort(config.reasoningEffort) } : {},
+    ...config.codexCliReasoningEffort !== void 0 ? { codexCliReasoningEffort: normalizeCodexCliReasoningEffort(config.codexCliReasoningEffort) } : {},
+    ...config.retryOptions?.timeoutMs !== void 0 ? { retryOptions: { timeoutMs: normalizeCodexCliTimeoutMs(config.retryOptions.timeoutMs) } } : {}
+  };
+}
+function normalizeCodexCliFallbackOptions(options) {
+  return {
+    ...options.timeoutMs !== void 0 ? { timeoutMs: normalizeCodexCliTimeoutMs(options.timeoutMs) } : {}
+  };
+}
+function normalizeOptionalString(value, label) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${label} must be a non-empty string`);
+  }
+  return value.trim();
+}
+function normalizeCodexCliModel(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    throw new Error("codex-cli model must be a non-empty string");
+  }
+  return trimmed;
+}
+function normalizeCodexCliReasoningEffort(value) {
+  if (typeof value !== "string") {
+    throw new Error("codex-cli reasoningEffort must be one of low, medium, high, xhigh");
+  }
+  const normalized = value.trim().toLowerCase();
+  if (VALID_CODEX_CLI_REASONING_EFFORTS.has(normalized)) {
+    return normalized;
+  }
+  throw new Error("codex-cli reasoningEffort must be one of low, medium, high, xhigh");
+}
+function normalizeCodexCliTimeoutMs(value) {
+  const parsed = typeof value === "number" ? value : typeof value === "string" && value.trim().length > 0 ? Number(value) : NaN;
+  if (!Number.isFinite(parsed) || !Number.isInteger(parsed) || parsed <= 0) {
+    throw new Error("codex-cli timeoutMs must be a positive integer");
+  }
+  return parsed;
+}
+
 // ../remnic-core/src/fallback-llm.ts
 var PROVIDER_ALIASES = {
   "openai-codex": ["codex"],
@@ -291,7 +363,10 @@ var FallbackLlmClient = class {
   runtimeContext;
   constructor(gatewayConfig, runtimeContext = {}) {
     this.gatewayConfig = gatewayConfig;
-    this.runtimeContext = runtimeContext;
+    this.runtimeContext = {
+      ...runtimeContext,
+      workspaceDir: normalizeRuntimePath(runtimeContext.workspaceDir) ?? readGatewayWorkspaceDir(gatewayConfig) ?? defaultOpenClawWorkspaceDir()
+    };
   }
   /**
    * Check if fallback is available (gateway config has at least one model).
@@ -522,9 +597,9 @@ var FallbackLlmClient = class {
    * simpler providers or when the runtime module isn't loaded.
    */
   async tryModel(model, messages, options) {
-    const runtimeAuth = await this.resolveRuntimeAuth(model);
+    const runtimeAuth = model.providerConfig.api === "codex-cli" ? null : await this.resolveRuntimeAuth(model);
     const effectiveBaseUrl = runtimeAuth?.baseUrl ?? model.providerConfig.baseUrl;
-    const resolvedCredential = runtimeAuth?.["api"+"Key"] ?? await this.resolveFallbackApiKey(model);
+    const resolvedCredential = runtimeAuth?.["api"+"Key"] ?? (model.providerConfig.api === "codex-cli" && model.providerConfig["api"+"Key"] === void 0 ? void 0 : await this.resolveFallbackApiKey(model));
     const rawKey = model.providerConfig["api"+"Key"];
     const needsResolution = rawKey === "secretref-managed" || typeof rawKey === "object" && rawKey !== null;
     if (needsResolution && !resolvedCredential) {
@@ -538,6 +613,17 @@ var FallbackLlmClient = class {
     if (model.providerConfig.api === "anthropic-messages") {
       return await this.callAnthropic(effectiveConfig, model.modelId, messages, options);
     }
+    if (model.providerConfig.api === "codex-cli") {
+      return await callCodexCliFallback(
+        effectiveConfig,
+        model.modelId,
+        messages,
+        { timeoutMs: options.timeoutMs }
+      );
+    }
+    if (model.providerConfig.api === "ollama-chat") {
+      return await this.callOllamaChat(effectiveConfig, model.modelId, messages, options);
+    }
     if (model.providerConfig.api === "openai-responses" || model.providerConfig.api === "openai-codex-responses" || model.providerConfig.api === "azure-openai-responses") {
       return await this.callOpenAIResponses(
         effectiveConfig,
@@ -646,6 +732,55 @@ var FallbackLlmClient = class {
       } : void 0
     };
   }
+  /**
+   * Call Ollama's native /api/chat transport. This lets benchmark-isolated
+   * gateway configs route Remnic's own internal LLM calls to Ollama Cloud
+   * without requiring an OpenAI-compatible shim.
+   */
+  async callOllamaChat(config, modelId, messages, options) {
+    const base = config.baseUrl.replace(/\/$/, "");
+    const url = base.endsWith("/api") ? `${base}/chat` : `${base}/api/chat`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...config.headers
+    };
+    if (config["api"+"Key"] && typeof config["api"+"Key"] === "string" && config.authHeader !== false) {
+      headers.Authorization = `Bearer ${config["api"+"Key"]}`;
+    }
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        model: modelId,
+        messages,
+        stream: false,
+        ...config.disableThinking ? { think: false } : {},
+        options: {
+          temperature: options.temperature ?? 0.3,
+          num_predict: options.maxTokens ?? 4096
+        }
+      })
+    });
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Ollama API error: ${response.status} ${error}`);
+    }
+    const data = await response.json();
+    const content = data.message?.content ?? data.response;
+    if (!content) {
+      throw new Error("Empty response from Ollama API");
+    }
+    const inputTokens = data.prompt_eval_count ?? 0;
+    const outputTokens = data.eval_count ?? 0;
+    return {
+      content,
+      usage: {
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens
+      }
+    };
+  }
   /**
    * Call an OpenAI-compatible Responses API.
    */
@@ -754,6 +889,19 @@ var FallbackLlmClient = class {
     };
   }
 };
+function normalizeRuntimePath(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? expandTildePath(trimmed) : void 0;
+}
+function readGatewayWorkspaceDir(gatewayConfig) {
+  if (!gatewayConfig || typeof gatewayConfig !== "object") return void 0;
+  const raw = gatewayConfig;
+  return normalizeRuntimePath(raw.workspaceDir) ?? normalizeRuntimePath(raw.workspacePath) ?? normalizeRuntimePath(raw.workspace);
+}
+function defaultOpenClawWorkspaceDir() {
+  return path2.join(resolveHomeDir(), ".openclaw", "workspace");
+}
 function extractResponsesOutputText(data) {
   if (typeof data.output_text === "string" && data.output_text.trim().length > 0) {
     return data.output_text;

package/dist/{chunk-HI5HX3S7.js → chunk-NDZNURDM.js}

@@ -12,7 +12,7 @@ import {
 import {
   readEnvVar,
   resolveHomeDir
-} from "./chunk-I6B2W2IY.js";
+} from "./chunk-TDRJVMUP.js";
 
 // ../remnic-core/src/connectors/codex-materialize-runner.ts
 import path2 from "path";

package/dist/{chunk-I6B2W2IY.js → chunk-TDRJVMUP.js}

@@ -1,3 +1,6 @@
+// ../remnic-core/src/utils/path.ts
+import path from "path";
+
 // ../remnic-core/src/runtime/env.ts
 import os from "os";
 var REMNIC_ENGRAM_PREFIX_PAIRS = [
@@ -40,8 +43,18 @@ function mergeEnv(overrides) {
   return merged;
 }
 
+// ../remnic-core/src/utils/path.ts
+function expandTildePath(p) {
+  if (p === "~") return resolveHomeDir();
+  if (p.startsWith("~/") || p.startsWith("~\\")) {
+    return path.join(resolveHomeDir(), p.slice(2));
+  }
+  return p;
+}
+
 export {
   readEnvVar,
   resolveHomeDir,
-  mergeEnv
+  mergeEnv,
+  expandTildePath
 };

package/dist/{chunk-37NKFWSO.js → chunk-VRGUUHBV.js}

@@ -1,6 +1,6 @@
 import {
   expandTildePath
-} from "./chunk-OEI7GLV2.js";
+} from "./chunk-TDRJVMUP.js";
 
 // ../remnic-core/src/connectors/live/state-store.ts
 import { promises as fs } from "fs";

package/dist/{engine-XPEZBXIQ.js → engine-57HLTQBN.js}

@@ -1,15 +1,14 @@
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-UVQXEQBQ.js";
+} from "./chunk-7NMHI4IC.js";
 import "./chunk-EXDYWXMB.js";
 import "./chunk-ZXLYEVOP.js";
 import "./chunk-6OJAU466.js";
 import "./chunk-RKR6PTPA.js";
 import "./chunk-UFU5GGGA.js";
 import "./chunk-YGGGUTG3.js";
-import "./chunk-OEI7GLV2.js";
-import "./chunk-I6B2W2IY.js";
+import "./chunk-TDRJVMUP.js";
 import "./chunk-MLKGABMK.js";
 export {
   CompoundingEngine,

package/dist/{fallback-llm-EGB622FE.js → fallback-llm-33SPYXQY.js}

@@ -1,9 +1,9 @@
 import {
   FallbackLlmClient
-} from "./chunk-24MGN4E3.js";
+} from "./chunk-7NUFIRM3.js";
 import "./chunk-3A5ELHTT.js";
 import "./chunk-UFU5GGGA.js";
-import "./chunk-I6B2W2IY.js";
+import "./chunk-TDRJVMUP.js";
 import "./chunk-MLKGABMK.js";
 export {
   FallbackLlmClient