@elvatis_com/openclaw-cli-bridge-elvatis 0.2.19 → 0.2.21

package/.ai/handoff/STATUS.md

@@ -1,14 +1,15 @@
 # STATUS.md — openclaw-cli-bridge-elvatis
 
-_Last updated: 2026-03-08 by Akido (claude-sonnet-4-6)_
+_Last updated: 2026-03-11 by Akido (claude-sonnet-4-6)_
 
-## Current Version: 0.2.19 — STABLE
+## Current Version: 0.2.21 — STABLE
 
 ## What is done
 
 - ✅ Repo: `https://github.com/elvatis/openclaw-cli-bridge-elvatis`
-- ✅ npm: `@@@@elvatis_com/openclaw-cli-bridge-elvatis@0.2.19`
-- ✅ ClawHub: `openclaw-cli-bridge-elvatis@0.2.19`
+- ✅ npm: `@elvatis_com/openclaw-cli-bridge-elvatis@0.2.21`
+- ✅ ClawHub: `openclaw-cli-bridge-elvatis@0.2.21`
+- ✅ **v0.2.21 fix:** `buildMinimalEnv()` forwards `XDG_RUNTIME_DIR` + `DBUS_SESSION_BUS_ADDRESS` — fixes Claude Code OAuth (Gnome Keyring) 401 timeout
 - ✅ Phase 1: `openai-codex` provider via `~/.codex/auth.json` (no re-login)
 - ✅ Phase 2: Local OpenAI-compatible proxy on `127.0.0.1:31337` (Gemini + Claude CLI)
 - ✅ Phase 3: 10 slash commands (`/cli-sonnet`, `/cli-opus`, `/cli-haiku`, `/cli-gemini`, `/cli-gemini-flash`, `/cli-gemini3`, `/cli-codex`, `/cli-codex-mini`, `/cli-back`, `/cli-test`)

package/README.md

@@ -2,7 +2,7 @@
 
 > OpenClaw plugin that bridges locally installed AI CLIs (Codex, Gemini, Claude Code) as model providers — with slash commands for instant model switching, restore, health testing, and model listing.
 
-**Current version:** `0.2.19`
+**Current version:** `0.2.21`
 
 ---
 
@@ -263,6 +263,12 @@ Slash commands (requireAuth=false, gateway commands.allowFrom is the auth layer)
 **Cause:** Gateway injects large values into `process.env` at runtime. Spreading it into `spawn()` exceeds Linux's `ARG_MAX` (~2MB).
 **Fix:** `buildMinimalEnv()` — only passes `HOME`, `PATH`, `USER`, and auth keys.
 
+### Claude Code 401 / timeout on OAuth login (fixed in v0.2.21)
+**Symptom:** `/cli-test cli-claude/*` times out after 30s; logs show `401 Invalid authentication credentials`.
+**Cause:** `buildMinimalEnv()` did not forward `XDG_RUNTIME_DIR` and `DBUS_SESSION_BUS_ADDRESS` to the spawned `claude` subprocess. Claude Code authenticated via `claude.ai` OAuth (Claude Max plan) stores its tokens in the system keyring (Gnome Keyring / libsecret) and needs these env vars to access it.
+**Affects:** Only systems using `claude auth` OAuth login (Claude Max / Teams). API-key users (`ANTHROPIC_API_KEY`) are not affected.
+**Fix:** Added `XDG_RUNTIME_DIR` and `DBUS_SESSION_BUS_ADDRESS` to the forwarded env keys in `buildMinimalEnv()`.
+
 ### Gemini agentic mode / hangs (fixed in v0.2.4)
 **Symptom:** Gemini hangs, returns wrong answers, or says "directory does not exist".
 **Cause:** `@file` syntax (`gemini -p @/tmp/xxx.txt`) triggers agentic mode — Gemini scans the working directory for project context and treats prompts as task instructions.
@@ -281,6 +287,14 @@ npm test            # vitest run (45 tests)
 
 ## Changelog
 
+### v0.2.21
+- **fix:** `buildMinimalEnv()` now forwards `XDG_RUNTIME_DIR` and `DBUS_SESSION_BUS_ADDRESS` to Claude Code subprocesses — required for Gnome Keyring / libsecret access when Claude Code is authenticated via `claude.ai` OAuth (Claude Max). Without these, the spawned `claude` process cannot read its OAuth token from the system keyring, resulting in `401 Invalid authentication credentials` and a 30-second timeout on `/cli-test` and all `/cli-claude/*` requests.
+
+### v0.2.20
+- **fix:** `formatPrompt` now defensively coerces `content` to string via `contentToString()` — prevents `[object Object]` reaching the CLI when WhatsApp group messages contain structured content objects instead of plain strings
+- **feat:** `ChatMessage.content` now accepts `string | ContentPart[] | unknown` (OpenAI multimodal content arrays supported)
+- **feat:** New `contentToString()` helper: handles string, OpenAI ContentPart arrays, arbitrary objects (JSON.stringify), null/undefined
+
 ### v0.2.19
 - **feat:** `/cli-list` command — formatted overview of all registered models grouped by provider
 - **docs:** Rewrite README to reflect current state (correct model names, command count, requireAuth, test count, /cli-list docs)

package/SKILL.md

@@ -53,4 +53,4 @@ Each command runs `openclaw models set <model>` atomically and replies with a co
 
 See `README.md` for full configuration reference and architecture diagram.
 
-**Version:** 0.2.19
+**Version:** 0.2.21

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-cli-bridge-elvatis",
   "name": "OpenClaw CLI Bridge",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "Phase 1: openai-codex auth bridge. Phase 2: local HTTP proxy routing model calls through gemini/claude CLIs (vllm provider).",
   "providers": [
     "openai-codex"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elvatis_com/openclaw-cli-bridge-elvatis",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "Bridges gemini, claude, and codex CLI tools as OpenClaw model providers. Reads existing CLI auth without re-login.",
   "type": "module",
   "openclaw": {
@@ -19,4 +19,4 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   }
-}
+}

package/src/cli-runner.ts

@@ -24,9 +24,15 @@ const MAX_MSG_CHARS = 4000;
 // Message formatting
 // ──────────────────────────────────────────────────────────────────────────────
 
+export interface ContentPart {
+  type: string;
+  text?: string;
+}
+
 export interface ChatMessage {
   role: "system" | "user" | "assistant";
-  content: string;
+  /** Plain string or OpenAI-style content array (multimodal / structured). */
+  content: string | ContentPart[] | unknown;
 }
 
 /**
@@ -61,7 +67,30 @@ export function formatPrompt(messages: ChatMessage[]): string {
     .join("\n\n");
 }
 
-function truncateContent(s: string): string {
+/**
+ * Coerce any message content value to a plain string.
+ *
+ * Handles:
+ *  - string          → as-is
+ *  - ContentPart[]   → join text parts (OpenAI multimodal format)
+ *  - other object    → JSON.stringify (prevents "[object Object]" from reaching the CLI)
+ *  - null/undefined  → ""
+ */
+function contentToString(content: unknown): string {
+  if (typeof content === "string") return content;
+  if (content === null || content === undefined) return "";
+  if (Array.isArray(content)) {
+    return (content as ContentPart[])
+      .filter((c) => c?.type === "text" && typeof c.text === "string")
+      .map((c) => c.text!)
+      .join("\n");
+  }
+  if (typeof content === "object") return JSON.stringify(content);
+  return String(content);
+}
+
+function truncateContent(raw: unknown): string {
+  const s = contentToString(raw);
   if (s.length <= MAX_MSG_CHARS) return s;
   return s.slice(0, MAX_MSG_CHARS) + `\n...[truncated ${s.length - MAX_MSG_CHARS} chars]`;
 }
@@ -96,6 +125,9 @@ function buildMinimalEnv(): Record<string, string> {
     "XDG_CONFIG_HOME",
     "XDG_DATA_HOME",
     "XDG_CACHE_HOME",
+    // Required for Claude Code OAuth (Gnome Keyring / libsecret access)
+    "XDG_RUNTIME_DIR",
+    "DBUS_SESSION_BUS_ADDRESS",
   ]) {
     const v = pick(key);
     if (v) env[key] = v;

package/test/cli-runner.test.ts

@@ -99,6 +99,60 @@ describe("formatPrompt", () => {
     expect(result).toContain("[System]");
     expect(result).toContain("[User]");
   });
+
+  // contentToString coercion tests (fix: [object Object] in WhatsApp group messages)
+  it("coerces ContentPart array to plain text", () => {
+    const result = formatPrompt([
+      { role: "user", content: [{ type: "text", text: "Hello from WA group" }] },
+    ]);
+    expect(result).toBe("Hello from WA group");
+    expect(result).not.toContain("[object Object]");
+  });
+
+  it("joins multiple text ContentParts with newline", () => {
+    const result = formatPrompt([
+      {
+        role: "user",
+        content: [
+          { type: "text", text: "Part one" },
+          { type: "text", text: "Part two" },
+        ],
+      },
+    ]);
+    expect(result).toContain("Part one");
+    expect(result).toContain("Part two");
+  });
+
+  it("ignores non-text ContentParts (e.g. image)", () => {
+    const result = formatPrompt([
+      {
+        role: "user",
+        content: [
+          { type: "image_url", url: "https://example.com/img.png" },
+          { type: "text", text: "describe this" },
+        ],
+      },
+    ]);
+    expect(result).toBe("describe this");
+  });
+
+  it("coerces plain object content to JSON string (not [object Object])", () => {
+    const result = formatPrompt([
+      { role: "user", content: { text: "structured", extra: 42 } as any },
+    ]);
+    expect(result).not.toBe("[object Object]");
+    expect(result).toContain("structured");
+  });
+
+  it("handles null content gracefully", () => {
+    const result = formatPrompt([{ role: "user", content: null as any }]);
+    expect(result).toBe("");
+  });
+
+  it("handles undefined content gracefully", () => {
+    const result = formatPrompt([{ role: "user", content: undefined as any }]);
+    expect(result).toBe("");
+  });
 });
 
 // ──────────────────────────────────────────────────────────────────────────────