@surething/cockpit 1.0.236 → 1.0.237

package/.next-prod/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":13094140,"timestamp":92586508,"id":14,"parentId":1,"tags":{},"startTime":1783345301168,"traceId":"32a6e89d3c090b4d"},{"name":"run-typescript","duration":10343512,"timestamp":105683410,"id":1606,"parentId":1,"tags":{},"startTime":1783345314265,"traceId":"32a6e89d3c090b4d"},{"name":"static-check","duration":664290,"timestamp":116060179,"id":1609,"parentId":1,"tags":{},"startTime":1783345324641,"traceId":"32a6e89d3c090b4d"},{"name":"static-generation","duration":3406583,"timestamp":116960668,"id":1881,"parentId":1,"tags":{},"startTime":1783345325542,"traceId":"32a6e89d3c090b4d"},{"name":"collect-build-traces","duration":10918258,"timestamp":116724991,"id":1878,"parentId":1,"tags":{},"startTime":1783345325306,"traceId":"32a6e89d3c090b4d"},{"name":"telemetry-flush","duration":33,"timestamp":127645744,"id":1890,"parentId":1,"tags":{},"startTime":1783345336227,"traceId":"32a6e89d3c090b4d"},{"name":"next-build","duration":35156409,"timestamp":92489376,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1783345301071,"traceId":"32a6e89d3c090b4d"}]
+[{"name":"run-webpack","duration":19984693,"timestamp":161374706,"id":14,"parentId":1,"tags":{},"startTime":1783396708397,"traceId":"281b860421a58a40"},{"name":"run-typescript","duration":18381890,"timestamp":181363309,"id":1606,"parentId":1,"tags":{},"startTime":1783396728385,"traceId":"281b860421a58a40"},{"name":"static-check","duration":1188175,"timestamp":199787563,"id":1609,"parentId":1,"tags":{},"startTime":1783396746810,"traceId":"281b860421a58a40"},{"name":"static-generation","duration":6203546,"timestamp":201425767,"id":1881,"parentId":1,"tags":{},"startTime":1783396748448,"traceId":"281b860421a58a40"},{"name":"collect-build-traces","duration":20799726,"timestamp":200976359,"id":1878,"parentId":1,"tags":{},"startTime":1783396747998,"traceId":"281b860421a58a40"},{"name":"telemetry-flush","duration":50,"timestamp":221781229,"id":1890,"parentId":1,"tags":{},"startTime":1783396768803,"traceId":"281b860421a58a40"},{"name":"next-build","duration":60572981,"timestamp":161208309,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1783396708230,"traceId":"281b860421a58a40"}]

package/bin/cock.mjs

@@ -3,6 +3,7 @@
 import { dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { spawnSync } from 'child_process';
+import { hasClaudeBinary } from '../scripts/claudeBinary.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = resolve(__dirname, '..');
@@ -124,11 +125,27 @@ if (process.argv[2] === 'connection') {
 
 if (process.argv[2] === 'update') {
   console.log('Updating @surething/cockpit...');
-  const result = spawnSync('npm', ['install', '-g', '@surething/cockpit@latest'], { stdio: 'inherit' });
+  const installArgs = ['install', '-g', '@surething/cockpit@latest', '--include=optional'];
+  let result = spawnSync('npm', installArgs, { stdio: 'inherit' });
+
+  // An in-place `npm i -g` can drop the SDK's platform-specific native binary
+  // (an optional dependency) when the SDK version bumps — see
+  // scripts/claudeBinary.mjs. A clean uninstall + reinstall reliably refetches
+  // it. Guard here so `cockpit update` never leaves chat silently broken.
+  if (result.status === 0 && !hasClaudeBinary()) {
+    console.log('Native Claude binary missing after update — reinstalling to repair...');
+    spawnSync('npm', ['uninstall', '-g', '@surething/cockpit'], { stdio: 'inherit' });
+    result = spawnSync('npm', installArgs, { stdio: 'inherit' });
+  }
+
   if (result.status === 0) {
     const { readFileSync } = await import('fs');
     const pkg = JSON.parse(readFileSync(resolve(PROJECT_ROOT, 'package.json'), 'utf8'));
     console.log(`\nUpdated to v${pkg.version}`);
+    if (!hasClaudeBinary()) {
+      console.error('\nWarning: the native Claude CLI binary is still missing; chat will not work.');
+      console.error('Fix manually: npm uninstall -g @surething/cockpit && npm install -g @surething/cockpit');
+    }
   }
   process.exit(result.status ?? 1);
 }
@@ -194,6 +211,14 @@ if (!isDev && !existsSync(resolve(PROJECT_ROOT, '.next-prod', 'BUILD_ID'))) {
   process.exit(1);
 }
 
+// Warn (don't block) if the SDK's native binary is missing — every panel but
+// the Claude chat still works, but chat would otherwise fail with a cryptic
+// runtime error only once the user sends a message. See scripts/claudeBinary.mjs.
+if (!hasClaudeBinary()) {
+  console.error('Warning: the native Claude CLI binary is missing; chat may not work.');
+  console.error('Fix: npm uninstall -g @surething/cockpit && npm install -g @surething/cockpit\n');
+}
+
 // Hand the project directory to server.mjs so it opens the right URL
 if (projectDir) {
   process.env.COCKPIT_OPEN_PROJECT = projectDir;

package/bin/postinstall.mjs

@@ -7,6 +7,7 @@ import { execSync } from 'child_process';
 import { homedir } from 'os';
 import { copyTreeSitterWasms } from '../scripts/copy-tree-sitter-wasms.mjs';
 import { copyPdfjsWorker } from '../scripts/copy-pdfjs-worker.mjs';
+import { hasClaudeBinary } from '../scripts/claudeBinary.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const projectRoot = join(__dirname, '..');
@@ -28,6 +29,20 @@ try {
   console.warn('[postinstall] pdf.js worker copy failed:', err?.message ?? err);
 }
 
+// Warn (don't fail) if the Claude Agent SDK's native binary didn't land — the
+// chat engine needs it. npm can skip this optional platform sub-package during
+// an in-place `npm i -g` upgrade; catching it here turns a mid-chat runtime
+// error into an install-time hint. See scripts/claudeBinary.mjs.
+try {
+  if (!hasClaudeBinary()) {
+    const plat = `${process.platform}-${process.arch}`;
+    console.warn(`[postinstall] Warning: Claude native binary (${plat}) is missing — chat will not work.`);
+    console.warn('[postinstall] Fix: npm uninstall -g @surething/cockpit && npm install -g @surething/cockpit');
+  }
+} catch (err) {
+  console.warn('[postinstall] Claude binary check failed:', err?.message ?? err);
+}
+
 if (process.platform !== 'win32') {
   // node-pty: spawn-helper needs the executable bit
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surething/cockpit",
-  "version": "1.0.236",
+  "version": "1.0.237",
   "description": "The open-source Claude Code GUI — an IDE-like workbench for parallel AI coding. Drive Claude (default), Codex, DeepSeek, Kimi, or local Ollama in tabs. Terminal, browser & DB bubbles, code review. Self-host on a shared dev box — a seat for every teammate. Local-first, MIT.",
   "author": "Robert",
   "license": "MIT",
@@ -75,6 +75,7 @@
     "next.config.mjs",
     "scripts/copy-tree-sitter-wasms.mjs",
     "scripts/copy-pdfjs-worker.mjs",
+    "scripts/claudeBinary.mjs",
     "LICENSE",
     "README.md"
   ],

package/scripts/claudeBinary.mjs

@@ -0,0 +1,38 @@
+/**
+ * Detect whether the Claude Agent SDK's platform-specific native `claude`
+ * binary is actually installed for the current platform.
+ *
+ * The binary ships as an OPTIONAL dependency of `@anthropic-ai/claude-agent-sdk`
+ * (one sub-package per platform, e.g. `-darwin-arm64`). npm can silently skip it
+ * during an in-place `npm i -g` upgrade when the SDK version bumps via its caret
+ * range, leaving the SDK unable to spawn `claude` at runtime with:
+ *   "Native CLI binary for <platform>-<arch> not found. Reinstall
+ *    @anthropic-ai/claude-agent-sdk without --omit=optional, ..."
+ *
+ * `cockpit update`, postinstall, and CLI startup all call this so the problem is
+ * surfaced (and repaired) BEFORE the user hits the runtime error mid-chat.
+ */
+import { createRequire } from 'module';
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+
+const require = createRequire(import.meta.url);
+
+/** @returns {boolean} true if the current platform's `claude` binary resolves. */
+export function hasClaudeBinary() {
+  const base = `${process.platform}-${process.arch}`;
+  // linux ships glibc and musl variants under distinct package names.
+  const variants = process.platform === 'linux' ? [base, `${base}-musl`] : [base];
+  for (const variant of variants) {
+    try {
+      const pkgJson = require.resolve(
+        `@anthropic-ai/claude-agent-sdk-${variant}/package.json`,
+      );
+      const bin = join(dirname(pkgJson), 'claude');
+      if (existsSync(bin) || existsSync(`${bin}.exe`)) return true;
+    } catch {
+      // Not resolvable → this variant's sub-package isn't installed.
+    }
+  }
+  return false;
+}