@rynfar/meridian 1.31.1 → 1.34.0

package/README.md

@@ -12,7 +12,7 @@
 
 ---
 
-Meridian bridges the Claude Code SDK to the standard Anthropic API. No OAuth interception. No binary patches. No hacks. Just pure, documented SDK calls. Any tool that speaks the Anthropic or OpenAI protocol — OpenCode, Crush, Cline, Aider, Pi, Droid, Open WebUI — connects to Meridian and gets Claude, with session management, streaming, and prompt caching handled natively by the SDK.
+Meridian bridges the Claude Code SDK to the standard Anthropic API. No OAuth interception. No binary patches. No hacks. Just pure, documented SDK calls. Any tool that speaks the Anthropic or OpenAI protocol — OpenCode, ForgeCode, Crush, Cline, Aider, Pi, Droid, Open WebUI — connects to Meridian and gets Claude, with session management, streaming, and prompt caching handled natively by the SDK.
 
 > [!NOTE]
 > ### How Meridian works with Anthropic
@@ -273,6 +273,45 @@ 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.
 
+### ForgeCode
+
+Add a custom provider to `~/forge/.forge.toml`:
+
+```toml
+[[providers]]
+id            = "meridian"
+url           = "http://127.0.0.1:3456/v1/messages"
+models        = "http://127.0.0.1:3456/v1/models"
+api_key_vars  = "MERIDIAN_API_KEY"
+response_type = "Anthropic"
+auth_methods  = ["api_key"]
+
+[session]
+provider_id = "meridian"
+model_id    = "claude-opus-4-6"
+```
+
+Set the API key env var (any value — Meridian authenticates through the SDK, not API keys):
+
+```bash
+export MERIDIAN_API_KEY=unused
+```
+
+Then log in and select the model:
+
+```bash
+forge provider login meridian    # enter any value when prompted
+forge config set provider meridian --model claude-opus-4-6
+```
+
+Start Meridian with the ForgeCode adapter:
+
+```bash
+MERIDIAN_DEFAULT_AGENT=forgecode meridian
+```
+
+ForgeCode uses reqwest's default User-Agent, so automatic detection isn't possible. The `MERIDIAN_DEFAULT_AGENT` env var tells Meridian to use the ForgeCode adapter for all unrecognized requests. If you run other agents alongside ForgeCode, use the `x-meridian-agent: forgecode` header instead (add `[providers.headers]` to your `.forge.toml`).
+
 ### 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`:
@@ -305,6 +344,7 @@ export ANTHROPIC_BASE_URL=http://127.0.0.1:3456
 | Agent | Status | Notes |
 |-------|--------|-------|
 | [OpenCode](https://github.com/anomalyco/opencode) | ✅ Verified | Requires `meridian setup` — full tool support, session resume, streaming, subagents |
+| [ForgeCode](https://forgecode.dev) | ✅ Verified | Provider config (see above) — passthrough tool execution, session resume, streaming |
 | [Droid (Factory AI)](https://factory.ai/product/ide) | ✅ Verified | BYOK config (see above) — full tool support, session resume, streaming |
 | [Crush](https://github.com/charmbracelet/crush) | ✅ Verified | Provider config (see above) — full tool support, session resume, headless `crush run` |
 | [Cline](https://github.com/cline/cline) | ✅ Verified | Config (see above) — full tool support, file read/write/edit, bash, session resume |
@@ -324,6 +364,7 @@ src/proxy/
 ├── adapters/
 │   ├── detect.ts          ← Agent detection from request headers
 │   ├── opencode.ts        ← OpenCode adapter
+│   ├── forgecode.ts       ← ForgeCode adapter
 │   ├── crush.ts           ← Crush adapter
 │   ├── droid.ts           ← Droid adapter
 │   ├── pi.ts              ← Pi adapter
@@ -394,7 +435,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` | Sonnet context tier: `sonnet` (200k, default) or `sonnet[1m]` (1M, requires Extra Usage†) |
-| `MERIDIAN_DEFAULT_AGENT` | — | `opencode` | Default adapter for unrecognized agents: `opencode`, `pi`, `crush`, `droid`, `passthrough`. Requires restart. |
+| `MERIDIAN_DEFAULT_AGENT` | — | `opencode` | Default adapter for unrecognized agents: `opencode`, `forgecode`, `pi`, `crush`, `droid`, `passthrough`. Requires restart. |
 | `MERIDIAN_PROFILES` | — | unset | JSON array of profile configs (overrides disk discovery). See [Multi-Profile Support](#multi-profile-support). |
 | `MERIDIAN_DEFAULT_PROFILE` | — | *(first profile)* | Default profile ID when no header is sent |
 

package/dist/{cli-7hathpbb.js → cli-1qv75efv.js}

@@ -7413,7 +7413,6 @@ function translateAnthropicSseEvent(event, completionId, model, created) {
   return null;
 }
 function buildModelList(isMaxSubscription, now = Math.floor(Date.now() / 1000)) {
-  const extendedContext = isMaxSubscription ? 1e6 : 200000;
   return [
     {
       id: "claude-sonnet-4-6",
@@ -7421,7 +7420,7 @@ function buildModelList(isMaxSubscription, now = Math.floor(Date.now() / 1000))
       created: now,
       owned_by: "anthropic",
       display_name: "Claude Sonnet 4.6",
-      context_window: extendedContext
+      context_window: 200000
     },
     {
       id: "claude-opus-4-6",
@@ -7429,7 +7428,7 @@ function buildModelList(isMaxSubscription, now = Math.floor(Date.now() / 1000))
       created: now,
       owned_by: "anthropic",
       display_name: "Claude Opus 4.6",
-      context_window: extendedContext
+      context_window: isMaxSubscription ? 1e6 : 200000
     },
     {
       id: "claude-haiku-4-5-20251001",
@@ -8132,13 +8131,85 @@ var piAdapter = {
   }
 };
 
+// src/proxy/adapters/forgecode.ts
+var FORGECODE_MCP_SERVER_NAME = "forgecode";
+var FORGECODE_ALLOWED_MCP_TOOLS = [
+  `mcp__${FORGECODE_MCP_SERVER_NAME}__read`,
+  `mcp__${FORGECODE_MCP_SERVER_NAME}__write`,
+  `mcp__${FORGECODE_MCP_SERVER_NAME}__edit`,
+  `mcp__${FORGECODE_MCP_SERVER_NAME}__bash`,
+  `mcp__${FORGECODE_MCP_SERVER_NAME}__glob`,
+  `mcp__${FORGECODE_MCP_SERVER_NAME}__grep`
+];
+function extractForgeCodeCwd(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*([^<]+?)\s*<\/current_working_directory>/i);
+  return match2?.[1]?.trim() || undefined;
+}
+var forgeCodeAdapter = {
+  name: "forgecode",
+  getSessionId(_c) {
+    return;
+  },
+  extractWorkingDirectory(body) {
+    return extractForgeCodeCwd(body);
+  },
+  normalizeContent(content) {
+    return normalizeContent(content);
+  },
+  getBlockedBuiltinTools() {
+    return BLOCKED_BUILTIN_TOOLS;
+  },
+  getAgentIncompatibleTools() {
+    return CLAUDE_CODE_ONLY_TOOLS;
+  },
+  getMcpServerName() {
+    return FORGECODE_MCP_SERVER_NAME;
+  },
+  getAllowedMcpTools() {
+    return FORGECODE_ALLOWED_MCP_TOOLS;
+  },
+  buildSdkAgents(_body, _mcpToolNames) {
+    return {};
+  },
+  buildSdkHooks(_body, _sdkAgents) {
+    return;
+  },
+  buildSystemContextAddendum(_body, _sdkAgents) {
+    return "";
+  },
+  extractFileChangesFromToolUse(toolName, toolInput) {
+    const input = toolInput;
+    const filePath = input?.file_path ?? input?.filePath ?? input?.path;
+    if (toolName === "write" && filePath) {
+      return [{ operation: "wrote", path: String(filePath) }];
+    }
+    if ((toolName === "patch" || toolName === "multi_patch") && filePath) {
+      return [{ operation: "edited", path: String(filePath) }];
+    }
+    if (toolName === "shell" && 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
+  pi: piAdapter,
+  forgecode: forgeCodeAdapter
 };
 var envDefault = process.env.MERIDIAN_DEFAULT_AGENT || "";
 if (envDefault && !ADAPTER_MAP[envDefault]) {
@@ -14028,6 +14099,33 @@ function formatAnomalyAlerts(requestId, anomalies) {
   });
 }
 
+// src/proxy/tokenUsage.ts
+function computeCacheHitRate(usage) {
+  if (!usage)
+    return;
+  const read = usage.cache_read_input_tokens ?? 0;
+  const creation = usage.cache_creation_input_tokens ?? 0;
+  const uncached = usage.input_tokens ?? 0;
+  const total = uncached + read + creation;
+  if (total === 0)
+    return;
+  return read / total;
+}
+function formatTokenCount(n) {
+  return n > 1000 ? `${Math.round(n / 1000)}k` : String(n);
+}
+function formatUsageSummary(usage) {
+  const parts = [
+    `input=${formatTokenCount(usage.input_tokens ?? 0)}`,
+    `output=${formatTokenCount(usage.output_tokens ?? 0)}`,
+    ...usage.cache_read_input_tokens ? [`cache_read=${formatTokenCount(usage.cache_read_input_tokens)}`] : [],
+    ...usage.cache_creation_input_tokens ? [`cache_write=${formatTokenCount(usage.cache_creation_input_tokens)}`] : []
+  ];
+  const rate = computeCacheHitRate(usage);
+  const cacheTag = rate !== undefined ? ` cache=${Math.round(rate * 100)}%` : "";
+  return `${parts.join(" ")}${cacheTag}`;
+}
+
 // src/proxy/session/lineage.ts
 import { createHash as createHash2 } from "crypto";
 var MIN_SUFFIX_FOR_COMPACTION = 2;
@@ -14706,29 +14804,7 @@ function buildFreshPrompt(messages, stripCacheControl) {
 `) || "";
 }
 function logUsage(requestId, usage) {
-  const fmt2 = (n) => n > 1000 ? `${Math.round(n / 1000)}k` : String(n);
-  const cacheRead = usage.cache_read_input_tokens ?? 0;
-  const totalInput = usage.input_tokens ?? 0;
-  const cacheRate = totalInput > 0 ? Math.round(cacheRead / totalInput * 100) : 0;
-  const cacheTag = totalInput > 0 ? ` cache=${cacheRate}%` : "";
-  const parts = [
-    `input=${fmt2(usage.input_tokens ?? 0)}`,
-    `output=${fmt2(usage.output_tokens ?? 0)}`,
-    ...usage.cache_read_input_tokens ? [`cache_read=${fmt2(usage.cache_read_input_tokens)}`] : [],
-    ...usage.cache_creation_input_tokens ? [`cache_write=${fmt2(usage.cache_creation_input_tokens)}`] : []
-  ];
-  console.error(`[PROXY] ${requestId} usage: ${parts.join(" ")}${cacheTag}`);
-}
-function computeCacheHitRate(usage) {
-  if (!usage)
-    return;
-  const read = usage.cache_read_input_tokens ?? 0;
-  const creation = usage.cache_creation_input_tokens ?? 0;
-  const uncached = usage.input_tokens ?? 0;
-  const total = uncached + read + creation;
-  if (total === 0)
-    return;
-  return read / total;
+  console.error(`[PROXY] ${requestId} usage: ${formatUsageSummary(usage)}`);
 }
 function checkTokenHealth(requestId, sdkSessionId, usage, turnNumber, isResume, isPassthrough) {
   if (!usage || !sdkSessionId)
@@ -14881,6 +14957,13 @@ function createProxyServer(config = {}) {
             console.error(`[PROXY] ${requestMeta.requestId} ignoring malformed x-opencode-thinking header: ${e instanceof Error ? e.message : String(e)}`);
           }
         }
+        const thinkingBetaStripped = betaFilter.stripped.some((b) => b.startsWith("interleaved-thinking"));
+        if (thinkingBetaStripped) {
+          thinking = { type: "disabled" };
+          if (betaFilter.stripped.length > 0) {
+            console.error(`[PROXY] ${requestMeta.requestId} thinking disabled (thinking beta stripped by ${getBetaPolicyFromEnv()} policy)`);
+          }
+        }
         const parsedBudget = taskBudgetHeader ? Number.parseInt(taskBudgetHeader, 10) : NaN;
         const taskBudget = Number.isFinite(parsedBudget) ? { total: parsedBudget } : body.task_budget ? { total: body.task_budget.total ?? body.task_budget } : undefined;
         const betas = betaFilter.forwarded;

package/dist/cli.js

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

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;AAqC9C;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CA+BtD"}
+{"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;AAuC9C;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CA+BtD"}

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

@@ -0,0 +1,28 @@
+/**
+ * ForgeCode agent adapter.
+ *
+ * Provides ForgeCode-specific behavior for session tracking, working directory
+ * extraction, content normalization, and tool configuration.
+ *
+ * ForgeCode (forgecode.dev) is a Rust-based terminal coding agent by Antinomy
+ * that makes standard Anthropic Messages API calls. When using a custom provider
+ * URL (pointing at Meridian), ForgeCode operates in passthrough mode with its
+ * own tool execution loop.
+ *
+ * Key characteristics:
+ * - User-Agent: reqwest default (no distinctive prefix) — use x-meridian-agent or env var
+ * - No session header: relies on fingerprint-based session cache
+ * - CWD in system prompt: <current_working_directory>/path</current_working_directory>
+ * - Snake_case tools: read, write, patch, multi_patch, shell, fs_search, etc.
+ * - Always streams (stream: true by default)
+ * - Manages its own tool execution loop: passthrough mode is appropriate
+ * - Subagent routing handled client-side via Task tool — invisible to proxy
+ *
+ * Detection: ForgeCode uses reqwest's default User-Agent, so automatic detection
+ * is unreliable. Use one of:
+ * - x-meridian-agent: forgecode header (per-request)
+ * - MERIDIAN_DEFAULT_AGENT=forgecode env var (global default)
+ */
+import type { AgentAdapter } from "../adapter";
+export declare const forgeCodeAdapter: AgentAdapter;
+//# sourceMappingURL=forgecode.d.ts.map

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

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

package/dist/proxy/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/proxy/openai.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/proxy/openai.ts"],"names":[],"mappings":"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"}

package/dist/proxy/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAuBvD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAsC,MAAM,iBAAiB,CAAA;AAGzI,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AAyK7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CA0vDhF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiEhG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAwBvD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAsC,MAAM,iBAAiB,CAAA;AAGzI,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AAkJ7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAqwDhF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiEhG"}

package/dist/proxy/tokenUsage.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Token usage formatting and cache-hit-rate calculations.
+ *
+ * Pure functions shared between stderr request logging and telemetry storage.
+ * Extracting these out of server.ts guarantees a single source of truth for
+ * the cache-hit-rate formula — stderr logs and the telemetry dashboard now
+ * agree.
+ *
+ * Previously `logUsage` computed `cache_read / input_tokens`, but the SDK
+ * reports `input_tokens` as *only* the non-cached portion, so the ratio blew
+ * past 100% (e.g. `cache=2600000%`) whenever a cache hit actually happened.
+ * `computeCacheHitRate` already had the correct formula; this module moves
+ * `logUsage` onto the same helper.
+ *
+ * This module is pure — no I/O, no imports from server.ts or session/.
+ */
+import type { TokenUsage } from "./session/lineage";
+/**
+ * Compute the fraction of input tokens served from cache for a single turn.
+ *
+ * The SDK's `input_tokens` field reports only the non-cached portion, so the
+ * true total input size is `input_tokens + cache_read_input_tokens +
+ * cache_creation_input_tokens`. Returns a value in [0, 1], or `undefined` if
+ * there is no input to measure against.
+ */
+export declare function computeCacheHitRate(usage: TokenUsage | undefined): number | undefined;
+/**
+ * Format an integer token count for compact display.
+ *
+ *  - values ≤ 1000 → exact integer (e.g. `"847"`)
+ *  - values > 1000 → rounded to nearest thousand with "k" suffix (e.g. `"71k"`)
+ */
+export declare function formatTokenCount(n: number): string;
+/**
+ * Build the single-line stderr summary for a request's token usage.
+ *
+ * Example outputs:
+ *   "input=3 output=416 cache_read=71k cache_write=2k cache=97%"
+ *   "input=10 output=8 cache_write=59k cache=0%"
+ *   "input=1000 output=50"                 (no caching activity)
+ *
+ * The `cache=XX%` tag is emitted whenever `computeCacheHitRate` returns a
+ * defined value. The tag is suppressed only when there is literally no input
+ * data to compute a ratio from (neither uncached nor cached).
+ */
+export declare function formatUsageSummary(usage: TokenUsage): string;
+//# sourceMappingURL=tokenUsage.d.ts.map

package/dist/proxy/tokenUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenUsage.d.ts","sourceRoot":"","sources":["../../src/proxy/tokenUsage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQrF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAU5D"}

package/dist/server.js

@@ -6,7 +6,7 @@ import {
   getMaxSessionsLimit,
   hashMessage,
   startProxyServer
-} from "./cli-7hathpbb.js";
+} from "./cli-1qv75efv.js";
 import"./cli-g9ypdz51.js";
 import"./cli-rtab0qa6.js";
 import"./cli-m9pfb7h9.js";

package/package.json

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