@elvatis_com/openclaw-cli-bridge-elvatis 0.2.12 → 0.2.14

package/.ai/handoff/CONVENTIONS.md

@@ -70,3 +70,32 @@ package.json / tsconfig.json
 - `SKILL.md` — if commands or config changed
 
 Skipping documentation = incomplete release. No exceptions.
+
+---
+
+## 🚨 Release-Regel: Erst fertig, dann publishen (gilt für ALLE Plattformen)
+
+**IMMER erst alles fertigstellen, danach publishen. Kein einziger Commit mehr dazwischen.**
+Gilt für GitHub, npm, ClawHub, PyPI — egal ob ein Projekt auf einer oder mehreren Plattformen ist.
+Sonst divergieren die Tarballs/Releases zwangsläufig.
+
+### Reihenfolge (nie abweichen)
+1. Alle Änderungen + Versionsbumps in **einem einzigen Commit** abschließen
+2. `git push` → Plattform 1 (z.B. GitHub)
+3. `npm publish` / `clawhub publish` / etc. — alle weiteren Plattformen
+4. Kein weiterer Commit bis zum nächsten Release (außer reine interne Doku)
+
+### Vor jedem Release: Alle Versionsstellen prüfen
+```bash
+grep -rn "X\.Y\.Z\|Current version\|Version:" \
+  --include="*.md" --include="*.json" \
+  --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=.git
+```
+Typische vergessene Stellen: `README.md` Header, `SKILL.md` Footer, `package.json`,
+`openclaw.plugin.json`, `.ai/handoff/STATUS.md` (Header + Plattform-Zeilen), Changelog-Eintrag.
+
+### Secrets & private Pfade — NIEMALS in Repos
+- Keine API Keys, Tokens, Passwörter, Secrets in Code oder Docs
+- Keine absoluten lokalen Pfade (`/home/user/...`) in publizierten Dateien
+- Keine `.env`-Dateien committen — immer in `.gitignore`
+- Vor jedem Push: `git diff --staged` auf Secrets prüfen

package/.ai/handoff/STATUS.md

@@ -2,13 +2,13 @@
 
 _Last updated: 2026-03-07 by Akido (claude-sonnet-4-6)_
 
-## Current Version: 0.2.12 — STABLE
+## Current Version: 0.2.14 — STABLE
 
 ## What is done
 
 - ✅ Repo: `https://github.com/elvatis/openclaw-cli-bridge-elvatis`
-- ✅ npm: `@elvatis_com/openclaw-cli-bridge-elvatis@0.2.12`
-- ✅ ClawHub: `openclaw-cli-bridge-elvatis@0.2.12`
+- ✅ npm: `@elvatis_com/openclaw-cli-bridge-elvatis@0.2.14`
+- ✅ ClawHub: `openclaw-cli-bridge-elvatis@0.2.14`
 - ✅ 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, and health testing.
 
-**Current version:** `0.2.12`
+**Current version:** `0.2.14`
 
 ---
 
@@ -234,7 +234,7 @@ npm test            # vitest run (5 unit tests for formatPrompt)
 
 ## Changelog
 
-### v0.2.12
+### v0.2.14
 - **docs:** Fix changelog (v0.2.10 entry was lost by sed, v0.2.11 description was wrong); enforce single-commit publish discipline
 
 ### v0.2.11

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.12
+**Version:** 0.2.14

package/index.ts

@@ -277,7 +277,7 @@ function proxyTestRequest(
 const plugin = {
   id: "openclaw-cli-bridge-elvatis",
   name: "OpenClaw CLI Bridge",
-  version: "0.2.5",
+  version: "0.2.14",
   description:
     "Phase 1: openai-codex auth bridge. " +
     "Phase 2: HTTP proxy for gemini/claude CLIs. " +
@@ -458,7 +458,7 @@ const plugin = {
       api.registerCommand({
         name,
         description,
-        requireAuth: true,
+        requireAuth: false,
         handler: async (ctx: PluginCommandContext): Promise<PluginCommandResult> => {
           api.logger.info(`[cli-bridge] /${name} by ${ctx.senderId ?? "?"}`);
           return switchModel(api, model, label);
@@ -470,7 +470,7 @@ const plugin = {
     api.registerCommand({
       name: "cli-back",
       description: "Restore the model that was active before the last /cli-* switch",
-      requireAuth: true,
+      requireAuth: false,
       handler: async (ctx: PluginCommandContext): Promise<PluginCommandResult> => {
         api.logger.info(`[cli-bridge] /cli-back by ${ctx.senderId ?? "?"}`);
 
@@ -508,7 +508,7 @@ const plugin = {
       name: "cli-test",
       description: "Test the CLI bridge proxy without switching your active model. Usage: /cli-test [model]",
       acceptsArgs: true,
-      requireAuth: true,
+      requireAuth: false,
       handler: async (ctx: PluginCommandContext): Promise<PluginCommandResult> => {
         const targetModel = ctx.args?.trim() || CLI_TEST_DEFAULT_MODEL;
         // Accept short names like "cli-sonnet" or full "vllm/cli-claude/claude-sonnet-4-6"

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-cli-bridge-elvatis",
   "name": "OpenClaw CLI Bridge",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "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.12",
+  "version": "0.2.14",
   "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

@@ -254,11 +254,16 @@ export async function routeToCliRunner(
 ): Promise<string> {
   const prompt = formatPrompt(messages);
 
-  if (model.startsWith("cli-gemini/")) return runGemini(prompt, model, timeoutMs);
-  if (model.startsWith("cli-claude/")) return runClaude(prompt, model, timeoutMs);
+  // Strip "vllm/" prefix if present — OpenClaw sends the full provider path
+  // (e.g. "vllm/cli-claude/claude-sonnet-4-6") but the router only needs the
+  // "cli-<type>/<model>" portion.
+  const normalized = model.startsWith("vllm/") ? model.slice(5) : model;
+
+  if (normalized.startsWith("cli-gemini/")) return runGemini(prompt, normalized, timeoutMs);
+  if (normalized.startsWith("cli-claude/")) return runClaude(prompt, normalized, timeoutMs);
 
   throw new Error(
-    `Unknown CLI bridge model: "${model}". Use "cli-gemini/<model>" or "cli-claude/<model>".`
+    `Unknown CLI bridge model: "${model}". Use "vllm/cli-gemini/<model>" or "vllm/cli-claude/<model>".`
   );
 }
 

package/test/cli-runner.test.ts

@@ -1,5 +1,5 @@
-import { describe, it, expect } from "vitest";
-import { formatPrompt } from "../src/cli-runner.js";
+import { describe, it, expect, vi } from "vitest";
+import { formatPrompt, routeToCliRunner } from "../src/cli-runner.js";
 
 describe("formatPrompt", () => {
   it("returns empty string for empty messages", () => {
@@ -44,3 +44,31 @@ describe("formatPrompt", () => {
     expect(result).toContain("truncated");
   });
 });
+
+describe("routeToCliRunner — model normalization", () => {
+  it("rejects unknown model without vllm prefix", async () => {
+    await expect(
+      routeToCliRunner("unknown/model", [], 1000)
+    ).rejects.toThrow("Unknown CLI bridge model");
+  });
+
+  it("rejects unknown model with vllm prefix", async () => {
+    await expect(
+      routeToCliRunner("vllm/unknown/model", [], 1000)
+    ).rejects.toThrow("Unknown CLI bridge model");
+  });
+
+  it("accepts cli-claude/ without vllm prefix (calls runClaude path)", async () => {
+    // Should throw CLI spawn error (no real claude), not "Unknown CLI bridge model"
+    await expect(
+      routeToCliRunner("cli-claude/claude-sonnet-4-6", [{ role: "user", content: "hi" }], 500)
+    ).rejects.not.toThrow("Unknown CLI bridge model");
+  });
+
+  it("accepts vllm/cli-claude/ — strips vllm prefix before routing", async () => {
+    // Should throw CLI spawn error (no real claude), not "Unknown CLI bridge model"
+    await expect(
+      routeToCliRunner("vllm/cli-claude/claude-sonnet-4-6", [{ role: "user", content: "hi" }], 500)
+    ).rejects.not.toThrow("Unknown CLI bridge model");
+  });
+});