@rynfar/meridian 1.26.6 → 1.27.0

package/README.md

@@ -11,7 +11,7 @@
 
 ---
 
-Meridian turns your Claude Max subscription into a local Anthropic API. Any tool that speaks the Anthropic or OpenAI protocol — OpenCode, Crush, Cline, Aider, Open WebUI — connects to Meridian and gets Claude, powered by your existing subscription through the official Claude Code SDK.
+Meridian turns your Claude Max subscription into a local Anthropic API. Any tool that speaks the Anthropic or OpenAI protocol — OpenCode, Crush, Cline, Aider, Pi, Droid, Open WebUI — connects to Meridian and gets Claude, powered by your existing subscription through the official Claude Code SDK.
 
 > [!NOTE]
 > **Renamed from `opencode-claude-max-proxy`.** If you're upgrading, see [`MIGRATION.md`](MIGRATION.md) for the checklist. Your existing sessions, env vars, and agent configs all continue to work.
@@ -192,6 +192,49 @@ Point any OpenAI-compatible tool at `http://127.0.0.1:3456` with any API key val
 
 > **Note:** Multi-turn conversations work by packing prior turns into the system prompt. Each request is a fresh SDK session — OpenAI clients replay full history themselves and don't use Meridian's session resumption.
 
+### Pi
+
+Pi uses the `@mariozechner/pi-ai` library which supports a configurable `baseUrl` on the model. Add a provider-level override in `~/.pi/agent/models.json`:
+
+```json
+{
+  "anthropic": {
+    "baseUrl": "http://127.0.0.1:3456"
+  }
+}
+```
+
+Then start Meridian with the pi default adapter:
+
+```bash
+MERIDIAN_DEFAULT_AGENT=pi meridian
+```
+
+Pi mimics Claude Code's User-Agent, so automatic detection isn't possible. The `MERIDIAN_DEFAULT_AGENT` env var tells Meridian to use the pi adapter for all unrecognized requests. If you run other agents alongside pi, use the `x-meridian-agent: pi` header instead (requires pi-ai support for custom headers).
+
+### OpenClaw
+
+OpenClaw uses `@mariozechner/pi-ai` under the hood, so the pi adapter handles it with no additional code. Add a provider override in `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "models": {
+    "providers": {
+      "anthropic": {
+        "baseUrl": "http://127.0.0.1:3456",
+        "apiKey": "dummy",
+        "models": [
+          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6 (Meridian)" },
+          { "id": "claude-opus-4-6", "name": "Claude Opus 4.6 (Meridian)" }
+        ]
+      }
+    }
+  }
+}
+```
+
+Then start Meridian with the pi adapter: `MERIDIAN_DEFAULT_AGENT=pi meridian`
+
 ### Any Anthropic-compatible tool
 
 ```bash
@@ -209,6 +252,8 @@ export ANTHROPIC_BASE_URL=http://127.0.0.1:3456
 | [Cline](https://github.com/cline/cline) | ✅ Verified | Config (see above) — full tool support, file read/write/edit, bash, session resume |
 | [Aider](https://github.com/paul-gauthier/aider) | ✅ Verified | Env vars — file editing, streaming; `--no-stream` broken (litellm bug) |
 | [Open WebUI](https://github.com/open-webui/open-webui) | ✅ Verified | OpenAI-compatible endpoints — set base URL to `http://127.0.0.1:3456` |
+| [Pi](https://github.com/mariozechner/pi-coding-agent) | ✅ Verified | models.json config (see above) — requires `MERIDIAN_DEFAULT_AGENT=pi` |
+| [OpenClaw](https://github.com/openclaw/openclaw) | ✅ Verified | Provider config (see above) — uses pi adapter via `MERIDIAN_DEFAULT_AGENT=pi` |
 | [Continue](https://github.com/continuedev/continue) | 🔲 Untested | OpenAI-compatible endpoints should work — set `apiBase` to `http://127.0.0.1:3456` |
 
 Tested an agent or built a plugin? [Open an issue](https://github.com/rynfar/meridian/issues) and we'll add it.
@@ -224,6 +269,7 @@ src/proxy/
 │   ├── opencode.ts        ← OpenCode adapter
 │   ├── crush.ts           ← Crush adapter
 │   ├── droid.ts           ← Droid adapter
+│   ├── pi.ts              ← Pi adapter
 │   └── passthrough.ts     ← LiteLLM passthrough adapter
 ├── query.ts               ← SDK query options builder
 ├── errors.ts              ← Error classification
@@ -258,11 +304,13 @@ Sessions are stored in-memory (LRU) and persisted to `~/.cache/meridian/sessions
 
 Agents are identified from request headers automatically:
 
-| User-Agent prefix | Adapter |
+| Signal | Adapter |
 |---|---|
-| `Charm-Crush/` | Crush |
-| `factory-cli/` | Droid |
-| *(anything else)* | OpenCode (default) |
+| `x-meridian-agent` header | Explicit override (any adapter) |
+| `Charm-Crush/` User-Agent | Crush |
+| `factory-cli/` User-Agent | Droid |
+| `litellm/` UA or `x-litellm-*` headers | LiteLLM passthrough |
+| *(anything else)* | `MERIDIAN_DEFAULT_AGENT` env var, or OpenCode |
 
 ### Adding a New Agent
 
@@ -283,6 +331,7 @@ Implement the `AgentAdapter` interface in `src/proxy/adapters/`. See [`adapters/
 | `MERIDIAN_TELEMETRY_SIZE` | `CLAUDE_PROXY_TELEMETRY_SIZE` | `1000` | Telemetry ring buffer size |
 | `MERIDIAN_NO_FILE_CHANGES` | `CLAUDE_PROXY_NO_FILE_CHANGES` | unset | Disable "Files changed" summary in responses |
 | `MERIDIAN_SONNET_MODEL` | `CLAUDE_PROXY_SONNET_MODEL` | `sonnet[1m]`* | Force sonnet tier: `sonnet` (200k) or `sonnet[1m]` (1M). Set to `sonnet` if you hit 1M context rate limits |
+| `MERIDIAN_DEFAULT_AGENT` | — | `opencode` | Default adapter for unrecognized agents: `opencode`, `pi`, `crush`, `droid`, `passthrough`. Requires restart. |
 
 *`sonnet[1m]` requires Max subscription with Extra Usage enabled. Falls back to `sonnet` automatically if not available.
 

package/dist/{cli-jk1p4nw8.js → cli-6hehvt9f.js}

@@ -7875,7 +7875,85 @@ var passthroughAdapter = {
   }
 };
 
+// src/proxy/adapters/pi.ts
+var PI_MCP_SERVER_NAME = "pi";
+var PI_ALLOWED_MCP_TOOLS = [
+  `mcp__${PI_MCP_SERVER_NAME}__read`,
+  `mcp__${PI_MCP_SERVER_NAME}__write`,
+  `mcp__${PI_MCP_SERVER_NAME}__edit`,
+  `mcp__${PI_MCP_SERVER_NAME}__bash`,
+  `mcp__${PI_MCP_SERVER_NAME}__grep`
+];
+function extractPiCwd(body) {
+  let systemText = "";
+  if (typeof body.system === "string") {
+    systemText = body.system;
+  } else if (Array.isArray(body.system)) {
+    systemText = body.system.filter((b) => b.type === "text" && b.text).map((b) => b.text).join(`
+`);
+  }
+  if (!systemText)
+    return;
+  const match2 = systemText.match(/Current working directory:\s*([^\n]+)/i);
+  return match2?.[1]?.trim() || undefined;
+}
+var piAdapter = {
+  name: "pi",
+  getSessionId(_c) {
+    return;
+  },
+  extractWorkingDirectory(body) {
+    return extractPiCwd(body);
+  },
+  normalizeContent(content) {
+    return normalizeContent(content);
+  },
+  getBlockedBuiltinTools() {
+    return BLOCKED_BUILTIN_TOOLS;
+  },
+  getAgentIncompatibleTools() {
+    return CLAUDE_CODE_ONLY_TOOLS;
+  },
+  getMcpServerName() {
+    return PI_MCP_SERVER_NAME;
+  },
+  getAllowedMcpTools() {
+    return PI_ALLOWED_MCP_TOOLS;
+  },
+  buildSdkAgents(_body, _mcpToolNames) {
+    return {};
+  },
+  buildSdkHooks(_body, _sdkAgents) {
+    return;
+  },
+  buildSystemContextAddendum(_body, _sdkAgents) {
+    return "";
+  },
+  extractFileChangesFromToolUse(toolName, toolInput) {
+    const input = toolInput;
+    const filePath = input?.filePath ?? input?.file_path ?? input?.path;
+    if (toolName === "write" && filePath) {
+      return [{ operation: "wrote", path: String(filePath) }];
+    }
+    if (toolName === "edit" && filePath) {
+      return [{ operation: "edited", path: String(filePath) }];
+    }
+    if (toolName === "bash" && input?.command) {
+      return extractFileChangesFromBash(String(input.command));
+    }
+    return [];
+  }
+};
+
 // src/proxy/adapters/detect.ts
+var ADAPTER_MAP = {
+  opencode: openCodeAdapter,
+  droid: droidAdapter,
+  crush: crushAdapter,
+  passthrough: passthroughAdapter,
+  pi: piAdapter
+};
+var defaultAdapter = ADAPTER_MAP[process.env.MERIDIAN_DEFAULT_AGENT || ""] ?? openCodeAdapter;
 function isLiteLLMRequest(c) {
   if ((c.req.header("user-agent") || "").startsWith("litellm/"))
     return true;
@@ -7883,6 +7961,10 @@ function isLiteLLMRequest(c) {
   return Object.keys(headers).some((k) => k.toLowerCase().startsWith("x-litellm-"));
 }
 function detectAdapter(c) {
+  const agentOverride = c.req.header("x-meridian-agent");
+  if (agentOverride && ADAPTER_MAP[agentOverride]) {
+    return ADAPTER_MAP[agentOverride];
+  }
   const userAgent = c.req.header("user-agent") || "";
   if (userAgent.startsWith("factory-cli/")) {
     return droidAdapter;
@@ -7893,7 +7975,7 @@ function detectAdapter(c) {
   if (isLiteLLMRequest(c)) {
     return passthroughAdapter;
   }
-  return openCodeAdapter;
+  return defaultAdapter;
 }
 
 // src/mcpTools.ts

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startProxyServer
-} from "./cli-jk1p4nw8.js";
+} from "./cli-6hehvt9f.js";
 import"./cli-rtab0qa6.js";
 import"./cli-m9pfb7h9.js";
 import {

package/dist/proxy/adapters/detect.d.ts

@@ -10,10 +10,11 @@ import type { AgentAdapter } from "../adapter";
  * Detect which agent adapter to use based on request headers.
  *
  * Detection rules (evaluated in order):
- * 1. User-Agent starts with "factory-cli/"  → Droid adapter
- * 2. User-Agent starts with "Charm-Crush/"  → Crush adapter
- * 3. litellm/* UA or x-litellm-* headers   → LiteLLM passthrough adapter
- * 4. Default                                → OpenCode adapter (backward compatible)
+ * 1. x-meridian-agent header               → explicit adapter override
+ * 2. User-Agent starts with "factory-cli/"  → Droid adapter
+ * 3. User-Agent starts with "Charm-Crush/"  → Crush adapter
+ * 4. litellm/* UA or x-litellm-* headers   → LiteLLM passthrough adapter
+ * 5. Default                                → MERIDIAN_DEFAULT_AGENT env var, or OpenCode
  */
 export declare function detectAdapter(c: Context): AgentAdapter;
 //# sourceMappingURL=detect.d.ts.map

package/dist/proxy/adapters/detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/proxy/adapters/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAmB9C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CAgBtD"}
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/proxy/adapters/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AA+B9C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CAqBtD"}

package/dist/proxy/adapters/pi.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pi coding agent adapter.
+ *
+ * Provides pi-specific behavior for session tracking, working directory
+ * extraction, content normalization, and tool configuration.
+ *
+ * Pi (@mariozechner/pi-coding-agent) is a CLI coding agent that makes
+ * standard Anthropic Messages API calls. When using a custom baseUrl
+ * (pointing at Meridian), pi operates in non-OAuth mode with lowercase
+ * tool names and its own tool execution loop.
+ *
+ * Key characteristics:
+ * - User-Agent: claude-cli/<version> (mimics Claude Code) or default SDK UA
+ * - No session header: relies on fingerprint-based session cache
+ * - CWD in system prompt: "Current working directory: /path/to/project"
+ * - 7 lowercase tools: read, write, edit, bash, grep, find, ls
+ * - Always streams (stream: true)
+ * - Manages its own tool execution loop: passthrough mode is appropriate
+ * - No subagent routing: pi-coding-agent is single-agent (pylon adds orchestration on top)
+ *
+ * Detection: pi mimics Claude Code's User-Agent, so automatic detection is
+ * unreliable. Use one of:
+ * - x-meridian-agent: pi header (per-request)
+ * - MERIDIAN_DEFAULT_AGENT=pi env var (global default)
+ */
+import type { AgentAdapter } from "../adapter";
+export declare const piAdapter: AgentAdapter;
+//# sourceMappingURL=pi.d.ts.map

package/dist/proxy/adapters/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../../src/proxy/adapters/pi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAuC9C,eAAO,MAAM,SAAS,EAAE,YA+FvB,CAAA"}

package/dist/server.js

@@ -6,7 +6,7 @@ import {
   getMaxSessionsLimit,
   hashMessage,
   startProxyServer
-} from "./cli-jk1p4nw8.js";
+} from "./cli-6hehvt9f.js";
 import"./cli-rtab0qa6.js";
 import"./cli-m9pfb7h9.js";
 import"./cli-a05ws7rb.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rynfar/meridian",
-  "version": "1.26.6",
+  "version": "1.27.0",
   "description": "Local Anthropic API powered by your Claude Max subscription. One subscription, every agent.",
   "type": "module",
   "main": "./dist/server.js",