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

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.20`
 
 ---
 
@@ -281,6 +281,11 @@ npm test            # vitest run (45 tests)
 
 ## Changelog
 
+### 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.20

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-cli-bridge-elvatis",
   "name": "OpenClaw CLI Bridge",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "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.20",
   "description": "Bridges gemini, claude, and codex CLI tools as OpenClaw model providers. Reads existing CLI auth without re-login.",
   "type": "module",
   "openclaw": {

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]`;
 }

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("");
+  });
 });
 
 // ──────────────────────────────────────────────────────────────────────────────