release: merge develop into main for v0.32.2

Author: DavidsonGomes

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.32.2] - 2026-04-24
+
+Patch release working around a bug in `@anthropic-ai/claude-agent-sdk` (v0.2.104+) where Linux auto-discovery tries the `-musl` platform package before glibc regardless of the host's actual libc. On glibc VPS installs (Ubuntu / Debian) with both platform packages present in `node_modules`, the SDK spawned the musl binary and failed with `Claude Code native binary not found` because the musl dynamic loader was absent — breaking every chat session on the affected VPS with no local repro. See upstream [issue #296](https://github.com/anthropics/claude-agent-sdk-typescript/issues/296).
+
+### Fixed
+
+- **`dashboard/terminal-server/src/chat-bridge.js`** — add `resolveClaudeExecutable()` that probes `/lib` and `/usr/lib` for `ld-musl-*` to detect the host's libc, then reorders the candidate platform packages to prefer the matching variant (glibc-first on glibc hosts, musl-first on Alpine/musl). Resolved path is passed via `queryOptions.pathToClaudeCodeExecutable` so the SDK skips its own (buggy) discovery. Respects `CLAUDE_CODE_EXECUTABLE` env override and falls back to SDK auto-discovery if no candidate resolves (preserves macOS dev flow).
+
+### Changed
+
+- **`dashboard/terminal-server/package.json`** — pin `@anthropic-ai/claude-agent-sdk` to exact `0.2.119` (was `^0.2.104`) so fresh `npm install` on the VPS doesn't drift into a newer minor with the same or worse regression before upstream lands a libc-aware fix.
+
 ## [0.32.1] - 2026-04-24
 
 Patch release fixing a `tsc -b` strict-mode type error in `PluginDetail.tsx` that broke fresh frontend builds (`npm run build` fails with TS2322 on `manifest['description']`). Local incremental builds passed because `.tsbuildinfo` cached the file as clean; fresh installs hit the error on first compile.

cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evoapi/evo-nexus",
-  "version": "0.32.1",
+  "version": "0.32.2",
   "description": "Unofficial open source toolkit for Claude Code — AI-powered business operating system",
   "keywords": [
     "claude-code",

dashboard/terminal-server/package-lock.json

@@ -14,7 +14,7 @@
     "postinstall": "chmod +x node_modules/node-pty/prebuilds/darwin-arm64/spawn-helper node_modules/node-pty/prebuilds/darwin-x64/spawn-helper 2>/dev/null || true"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.104",
+    "@anthropic-ai/claude-agent-sdk": "0.2.119",
     "cors": "^2.8.5",
     "express": "^4.19.2",
     "node-pty": "^1.0.0",

dashboard/terminal-server/package.json

@@ -100,6 +100,60 @@ async function loadSDK() {
   return sdkModule;
 }
 
+/**
+ * Resolve the Claude Code native binary path, working around a bug in
+ * @anthropic-ai/claude-agent-sdk where Linux auto-discovery tries the
+ * `-musl` variant before glibc regardless of the host's actual libc.
+ * On glibc hosts with both packages installed, the SDK picks the musl
+ * binary, which fails to spawn because its dynamic loader is absent.
+ * See https://github.com/anthropics/claude-agent-sdk-typescript/issues/296
+ *
+ * Resolution order:
+ *   1. CLAUDE_CODE_EXECUTABLE env var (explicit override)
+ *   2. Platform-specific sibling package under node_modules, preferring the
+ *      libc variant that matches this host (glibc → no suffix; musl → -musl)
+ *   3. null → fall back to the SDK's own (buggy) discovery
+ */
+let _claudeExecutablePath = undefined;
+function resolveClaudeExecutable() {
+  if (_claudeExecutablePath !== undefined) return _claudeExecutablePath;
+
+  const envPath = process.env.CLAUDE_CODE_EXECUTABLE;
+  if (envPath && fs.existsSync(envPath)) {
+    console.log(`[chat-bridge] Using CLAUDE_CODE_EXECUTABLE=${envPath}`);
+    _claudeExecutablePath = envPath;
+    return _claudeExecutablePath;
+  }
+
+  const { platform, arch } = process;
+  const suffix = platform === 'win32' ? '.exe' : '';
+  const isMusl = platform === 'linux' && (() => {
+    try {
+      return fs.readdirSync('/lib').some((f) => f.startsWith('ld-musl-'))
+          || fs.readdirSync('/usr/lib').some((f) => f.startsWith('ld-musl-'));
+    } catch { return false; }
+  })();
+
+  const candidates = platform === 'linux'
+    ? (isMusl
+        ? [`claude-agent-sdk-linux-${arch}-musl`, `claude-agent-sdk-linux-${arch}`]
+        : [`claude-agent-sdk-linux-${arch}`, `claude-agent-sdk-linux-${arch}-musl`])
+    : [`claude-agent-sdk-${platform}-${arch}`];
+
+  for (const pkg of candidates) {
+    try {
+      const p = require.resolve(`@anthropic-ai/${pkg}/claude${suffix}`);
+      console.log(`[chat-bridge] Resolved Claude binary: ${p} (libc: ${isMusl ? 'musl' : 'glibc'})`);
+      _claudeExecutablePath = p;
+      return _claudeExecutablePath;
+    } catch { /* try next */ }
+  }
+
+  console.warn('[chat-bridge] Could not resolve Claude binary; letting SDK auto-discover');
+  _claudeExecutablePath = null;
+  return _claudeExecutablePath;
+}
+
 /**
  * Scan a tool_result text for a ticket-creation response.
  * Returns the ticket id if a POST /api/tickets response is detected, else null.
@@ -369,6 +423,9 @@ class ChatBridge {
       abortController,
     };
 
+    const claudeExe = resolveClaudeExecutable();
+    if (claudeExe) queryOptions.pathToClaudeCodeExecutable = claudeExe;
+
     // Load agent definition from .claude/agents/{name}.md
     if (agentName) {
       const agentDef = loadAgentFile(agentName, queryOptions.cwd);

dashboard/terminal-server/src/chat-bridge.js

@@ -1,6 +1,6 @@
 [project]
 name = "evo-nexus"
-version = "0.32.1"
+version = "0.32.2"
 description = "Unofficial open source toolkit for Claude Code — AI-powered business operating system"
 requires-python = ">=3.10"
 dependencies = [