@rynfar/meridian 1.22.2 → 1.23.1

package/README.md

@@ -302,6 +302,7 @@ See [`adapters/detect.ts`](src/proxy/adapters/detect.ts) and [`adapters/opencode
 | `MERIDIAN_WORKDIR` | `CLAUDE_PROXY_WORKDIR` | `cwd()` | Default working directory for SDK |
 | `MERIDIAN_IDLE_TIMEOUT_SECONDS` | `CLAUDE_PROXY_IDLE_TIMEOUT_SECONDS` | `120` | HTTP keep-alive timeout |
 | `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 |
 
 ## Programmatic API
 

package/dist/{cli-avsc9sr9.js → cli-nnnww55k.js}

@@ -6964,11 +6964,21 @@ function classifyError(errMsg) {
   if (lower.includes("exited with code") || lower.includes("process exited")) {
     const codeMatch = errMsg.match(/exited with code (\d+)/);
     const code = codeMatch ? codeMatch[1] : "unknown";
+    const hasStderr = lower.includes("subprocess stderr:");
+    const stderrContent = hasStderr ? lower.split("subprocess stderr:")[1]?.trim() ?? "" : "";
+    if (stderrContent.includes("authentication") || stderrContent.includes("401") || stderrContent.includes("oauth")) {
+      return {
+        status: 401,
+        type: "authentication_error",
+        message: "Claude authentication expired or invalid. Run 'claude login' in your terminal to re-authenticate, then restart the proxy."
+      };
+    }
     if (code === "1" && !lower.includes("tool") && !lower.includes("mcp")) {
+      const stderrHint = stderrContent ? ` Subprocess output: ${stderrContent.slice(0, 200)}` : " Run with CLAUDE_PROXY_DEBUG=1 for more detail.";
       return {
         status: 401,
         type: "authentication_error",
-        message: "Claude Code process crashed (exit code 1). This usually means authentication expired. Run 'claude login' in your terminal to re-authenticate, then restart the proxy."
+        message: `Claude Code process exited (code 1). This is often an authentication issue — try 'claude login' and restart the proxy.${stderrHint}`
       };
     }
     return {
@@ -13358,7 +13368,8 @@ function buildQueryOptions(ctx) {
     isUndo,
     undoRollbackUuid,
     sdkHooks,
-    adapter
+    adapter,
+    onStderr
   } = ctx;
   const blockedTools = [...adapter.getBlockedBuiltinTools(), ...adapter.getAgentIncompatibleTools()];
   const mcpServerName = adapter.getMcpServerName();
@@ -13388,6 +13399,7 @@ function buildQueryOptions(ctx) {
         mcpServers: { [mcpServerName]: createOpencodeMcpServer() }
       },
       plugins: [],
+      ...onStderr ? { stderr: onStderr } : {},
       env: {
         ...cleanEnv,
         ENABLE_TOOL_SEARCH: "false",
@@ -14194,7 +14206,8 @@ function createProxyServer(config = {}) {
           passthroughMcp = createPassthroughMcpServer(body.tools);
         }
         const mcpPrefix = `mcp__${adapter.getMcpServerName()}__`;
-        const fileChangeHook = createFileChangeHook(fileChanges, mcpPrefix);
+        const trackFileChanges = !(process.env.MERIDIAN_NO_FILE_CHANGES ?? process.env.CLAUDE_PROXY_NO_FILE_CHANGES);
+        const fileChangeHook = trackFileChanges ? createFileChangeHook(fileChanges, mcpPrefix) : undefined;
         const sdkHooks = passthrough ? {
           PreToolUse: [{
             matcher: "",
@@ -14212,7 +14225,12 @@ function createProxyServer(config = {}) {
           }]
         } : {
           ...adapter.buildSdkHooks?.(body, sdkAgents) ?? {},
-          PostToolUse: [fileChangeHook]
+          ...fileChangeHook ? { PostToolUse: [fileChangeHook] } : {}
+        };
+        const stderrLines = [];
+        const onStderr = (data) => {
+          stderrLines.push(data.trimEnd());
+          claudeLog("subprocess.stderr", { line: data.trimEnd() });
         };
         if (!stream2) {
           const contentBlocks = [];
@@ -14250,7 +14268,8 @@ function createProxyServer(config = {}) {
                     isUndo,
                     undoRollbackUuid,
                     sdkHooks,
-                    adapter
+                    adapter,
+                    onStderr
                   }))) {
                     if (event.type === "assistant") {
                       didYieldContent = true;
@@ -14288,7 +14307,8 @@ function createProxyServer(config = {}) {
                       isUndo: false,
                       undoRollbackUuid: undefined,
                       sdkHooks,
-                      adapter
+                      adapter,
+                      onStderr
                     }));
                     return;
                   }
@@ -14357,11 +14377,18 @@ function createProxyServer(config = {}) {
               durationMs: Date.now() - upstreamStartAt
             });
           } catch (error) {
+            const stderrOutput = stderrLines.join(`
+`).trim();
+            if (stderrOutput && error instanceof Error && !error.message.includes(stderrOutput)) {
+              error.message = `${error.message}
+Subprocess stderr: ${stderrOutput}`;
+            }
             claudeLog("upstream.failed", {
               mode: "non_stream",
               model,
               durationMs: Date.now() - upstreamStartAt,
-              error: error instanceof Error ? error.message : String(error)
+              error: error instanceof Error ? error.message : String(error),
+              ...stderrOutput ? { stderr: stderrOutput } : {}
             });
             throw error;
           }
@@ -14379,19 +14406,21 @@ function createProxyServer(config = {}) {
           }
           const hasToolUse = contentBlocks.some((b) => b.type === "tool_use");
           const stopReason = hasToolUse ? "tool_use" : "end_turn";
-          if (passthrough && stopReason === "end_turn" && adapter.extractFileChangesFromToolUse) {
-            const passthroughChanges = extractFileChangesFromMessages(body.messages || [], adapter.extractFileChangesFromToolUse.bind(adapter));
-            fileChanges.push(...passthroughChanges);
-          }
-          const fileChangeSummary = formatFileChangeSummary(fileChanges);
-          if (fileChangeSummary) {
-            const lastTextBlock = [...contentBlocks].reverse().find((b) => b.type === "text");
-            if (lastTextBlock) {
-              lastTextBlock.text = lastTextBlock.text + fileChangeSummary;
-            } else {
-              contentBlocks.push({ type: "text", text: fileChangeSummary.trimStart() });
+          if (trackFileChanges) {
+            if (passthrough && stopReason === "end_turn" && adapter.extractFileChangesFromToolUse) {
+              const passthroughChanges = extractFileChangesFromMessages(body.messages || [], adapter.extractFileChangesFromToolUse.bind(adapter));
+              fileChanges.push(...passthroughChanges);
+            }
+            const fileChangeSummary = formatFileChangeSummary(fileChanges);
+            if (fileChangeSummary) {
+              const lastTextBlock = [...contentBlocks].reverse().find((b) => b.type === "text");
+              if (lastTextBlock) {
+                lastTextBlock.text = lastTextBlock.text + fileChangeSummary;
+              } else {
+                contentBlocks.push({ type: "text", text: fileChangeSummary.trimStart() });
+              }
+              claudeLog("response.file_changes", { mode: "non_stream", count: fileChanges.length });
             }
-            claudeLog("response.file_changes", { mode: "non_stream", count: fileChanges.length });
           }
           if (contentBlocks.length === 0) {
             contentBlocks.push({
@@ -14509,7 +14538,8 @@ function createProxyServer(config = {}) {
                       isUndo,
                       undoRollbackUuid,
                       sdkHooks,
-                      adapter
+                      adapter,
+                      onStderr
                     }))) {
                       if (event.type === "stream_event") {
                         didYieldClientEvent = true;
@@ -14547,7 +14577,8 @@ function createProxyServer(config = {}) {
                         isUndo: false,
                         undoRollbackUuid: undefined,
                         sdkHooks,
-                        adapter
+                        adapter,
+                        onStderr
                       }));
                       return;
                     }
@@ -14750,37 +14781,39 @@ data: ${JSON.stringify({
 
 `), "passthrough_message_delta");
                 }
-                if (passthrough && adapter.extractFileChangesFromToolUse) {
+                if (trackFileChanges && passthrough && adapter.extractFileChangesFromToolUse) {
                   const passthroughChanges = extractFileChangesFromMessages(body.messages || [], adapter.extractFileChangesFromToolUse.bind(adapter));
                   fileChanges.push(...passthroughChanges);
                 }
-                const streamFileChangeSummary = formatFileChangeSummary(fileChanges);
-                if (streamFileChangeSummary && messageStartEmitted) {
-                  const fcBlockIndex = nextClientBlockIndex++;
-                  safeEnqueue(encoder.encode(`event: content_block_start
+                if (trackFileChanges) {
+                  const streamFileChangeSummary = formatFileChangeSummary(fileChanges);
+                  if (streamFileChangeSummary && messageStartEmitted) {
+                    const fcBlockIndex = nextClientBlockIndex++;
+                    safeEnqueue(encoder.encode(`event: content_block_start
 data: ${JSON.stringify({
-                    type: "content_block_start",
-                    index: fcBlockIndex,
-                    content_block: { type: "text", text: "" }
-                  })}
+                      type: "content_block_start",
+                      index: fcBlockIndex,
+                      content_block: { type: "text", text: "" }
+                    })}
 
 `), "file_changes_block_start");
-                  safeEnqueue(encoder.encode(`event: content_block_delta
+                    safeEnqueue(encoder.encode(`event: content_block_delta
 data: ${JSON.stringify({
-                    type: "content_block_delta",
-                    index: fcBlockIndex,
-                    delta: { type: "text_delta", text: streamFileChangeSummary }
-                  })}
+                      type: "content_block_delta",
+                      index: fcBlockIndex,
+                      delta: { type: "text_delta", text: streamFileChangeSummary }
+                    })}
 
 `), "file_changes_text_delta");
-                  safeEnqueue(encoder.encode(`event: content_block_stop
+                    safeEnqueue(encoder.encode(`event: content_block_stop
 data: ${JSON.stringify({
-                    type: "content_block_stop",
-                    index: fcBlockIndex
-                  })}
+                      type: "content_block_stop",
+                      index: fcBlockIndex
+                    })}
 
 `), "file_changes_block_stop");
-                  claudeLog("response.file_changes", { mode: "stream", count: fileChanges.length });
+                    claudeLog("response.file_changes", { mode: "stream", count: fileChanges.length });
+                  }
                 }
                 if (messageStartEmitted) {
                   safeEnqueue(encoder.encode(`event: message_stop
@@ -14852,6 +14885,12 @@ data: {"type":"message_stop"}
                 });
                 return;
               }
+              const stderrOutput = stderrLines.join(`
+`).trim();
+              if (stderrOutput && error instanceof Error && !error.message.includes(stderrOutput)) {
+                error.message = `${error.message}
+Subprocess stderr: ${stderrOutput}`;
+              }
               const errMsg = error instanceof Error ? error.message : String(error);
               claudeLog("upstream.failed", {
                 mode: "stream",
@@ -14859,7 +14898,8 @@ data: {"type":"message_stop"}
                 durationMs: Date.now() - upstreamStartAt,
                 streamEventsSeen,
                 textEventsForwarded,
-                error: errMsg
+                error: errMsg,
+                ...stderrOutput ? { stderr: stderrOutput } : {}
               });
               const streamErr = classifyError(errMsg);
               claudeLog("proxy.anthropic.error", { error: errMsg, classified: streamErr.type });

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   __require,
   startProxyServer
-} from "./cli-avsc9sr9.js";
+} from "./cli-nnnww55k.js";
 
 // bin/cli.ts
 import { createRequire } from "module";

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/proxy/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAoF7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGxD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/proxy/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAmG7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGxD"}

package/dist/proxy/query.d.ts

@@ -37,6 +37,8 @@ export interface QueryContext {
     sdkHooks?: any;
     /** The agent adapter providing tool configuration */
     adapter: AgentAdapter;
+    /** Callback to receive stderr lines from the Claude subprocess */
+    onStderr?: (line: string) => void;
 }
 /**
  * Build the options object for the Claude Agent SDK query() call.
@@ -51,11 +53,12 @@ export declare function buildQueryOptions(ctx: QueryContext): {
         forkSession?: boolean | undefined;
         resume?: string | undefined;
         agents?: Record<string, any> | undefined;
-        plugins: never[];
         env: {
             ENABLE_CLAUDEAI_MCP_SERVERS?: string | undefined;
             ENABLE_TOOL_SEARCH: string;
         };
+        stderr?: ((line: string) => void) | undefined;
+        plugins: never[];
         allowedTools?: string[] | undefined;
         mcpServers?: {
             oc: import("@anthropic-ai/claude-agent-sdk").McpSdkServerConfigWithInstance;
@@ -79,11 +82,12 @@ export declare function buildQueryOptions(ctx: QueryContext): {
         forkSession?: boolean | undefined;
         resume?: string | undefined;
         agents?: Record<string, any> | undefined;
-        plugins: never[];
         env: {
             ENABLE_CLAUDEAI_MCP_SERVERS?: string | undefined;
             ENABLE_TOOL_SEARCH: string;
         };
+        stderr?: ((line: string) => void) | undefined;
+        plugins: never[];
         disallowedTools: string[];
         allowedTools: string[];
         mcpServers: {

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

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/proxy/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,OAAO,EAAE,0BAA0B,EAAwB,MAAM,oBAAoB,CAAA;AAErF,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IACnC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,WAAW,EAAE,OAAO,CAAA;IACpB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAA;IACf,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,mEAAmE;IACnE,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;IAC9D,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC5C,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAA;IACf,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,qDAAqD;IACrD,OAAO,EAAE,YAAY,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDlD"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/proxy/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,OAAO,EAAE,0BAA0B,EAAwB,MAAM,oBAAoB,CAAA;AAErF,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IACnC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,WAAW,EAAE,OAAO,CAAA;IACpB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAA;IACf,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,mEAAmE;IACnE,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;IAC9D,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC5C,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAA;IACf,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,qDAAqD;IACrD,OAAO,EAAE,YAAY,CAAA;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY;;;;;;;;;;;;yBAR/B,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAf,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;EAiElC"}

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAiBvD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAgB,MAAM,iBAAiB,CAAA;AAEnH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AAyF7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CA2qChF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA0ChG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAiBvD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAgB,MAAM,iBAAiB,CAAA;AAEnH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AAyF7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAksChF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA0ChG"}

package/dist/server.js

@@ -6,7 +6,7 @@ import {
   getMaxSessionsLimit,
   hashMessage,
   startProxyServer
-} from "./cli-avsc9sr9.js";
+} from "./cli-nnnww55k.js";
 export {
   startProxyServer,
   hashMessage,

package/package.json

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