synabun 2.0.0-beta → 2.0.0

package/neural-interface/lib/offline-page.js

@@ -0,0 +1,54 @@
+// The offline page is the one page that must work with the server down: the
+// service worker serves the copy it cached while the server was still up. So
+// everything it needs is put into that copy here: where SynaBun is installed,
+// how it was installed, whether the Start Server launcher is registered, and
+// the bridge code itself (public/shared/start-bridge.js, shared with the
+// in-app loading overlay).
+
+const BRIDGE_SLOT = '/*__SYNABUN_START_BRIDGE__*/';
+const FACTS_SLOT = '/*__SYNABUN_OFFLINE_FACTS__*/';
+
+/** An ES module with only top-level `export function` / `export const` → a classic script. */
+export function moduleToClassicScript(source) {
+  const text = String(source || '');
+  if (/^\s*import\s/m.test(text) || /^\s*export\s+(?!function\b|const\b|async\s+function\b)/m.test(text)) {
+    throw new Error('start-bridge.js must only use `export function` / `export const` and no imports');
+  }
+  return text.replace(/^export\s+/gm, '');
+}
+
+/** JSON that is safe inside a <script> element. */
+export function scriptJson(value) {
+  return JSON.stringify(value)
+    .replace(/</g, '\\u003c')
+    .replace(/>/g, '\\u003e')
+    .replace(/&/g, '\\u0026')
+    .replace(/\u2028/g, '\\u2028')
+    .replace(/\u2029/g, '\\u2029');
+}
+
+/**
+ * facts: { projectDir, install: 'npm' | 'git' | 'app', launcher: 'registered' | 'stale' | 'missing' | 'skipped',
+ *          entry: a packaged application's entry executable }
+ * A template without the slots (an older cached copy, a hand-edited file) is
+ * returned as it is: the page then shows the commands and no button.
+ */
+export function renderOfflinePage(template, { bridgeSource = '', facts = {} } = {}) {
+  let html = String(template || '');
+  if (html.includes(BRIDGE_SLOT)) {
+    let script = '';
+    try { script = moduleToClassicScript(bridgeSource).replace(/<\/script/gi, '<\\/script'); } catch {}
+    html = html.replace(BRIDGE_SLOT, () => script);
+  }
+  if (html.includes(FACTS_SLOT)) {
+    html = html.replace(FACTS_SLOT, () => `window.__SYNABUN_OFFLINE__ = ${scriptJson({
+      projectDir: facts.projectDir || '',
+      install: ['npm', 'app'].includes(facts.install) ? facts.install : 'git',
+      launcher: String(facts.launcher || ''),
+      ...(facts.entry ? { entry: String(facts.entry) } : {}),
+    })};`);
+  }
+  return html;
+}
+
+export const OFFLINE_SLOTS = Object.freeze({ bridge: BRIDGE_SLOT, facts: FACTS_SLOT });

package/neural-interface/lib/session-title-generator.js

@@ -70,6 +70,10 @@ export function extractCodexText(stdout) {
 }
 
 async function generateClaudeTitle(input, deps) {
+  // The user's Claude Code, as every other SDK call (lib/claude-executable.js).
+  // Without one there is no title to ask for: the caller falls back to its own.
+  const executable = typeof deps.claudeExecutable === 'function' ? deps.claudeExecutable() : null;
+  if (!executable?.path && !deps.claudeQuery) throw new Error(executable?.reason || 'Claude CLI not found');
   const abortController = new AbortController();
   const timer = setTimeout(() => abortController.abort(new Error('Session title request timed out')), SESSION_TITLE_TIMEOUT_MS);
   timer.unref?.();
@@ -89,6 +93,7 @@ async function generateClaudeTitle(input, deps) {
         persistSession: false,
         includePartialMessages: false,
         abortController,
+        ...(executable?.path ? { pathToClaudeCodeExecutable: executable.path } : {}),
         env: cleanClaudeEnv(deps.env || process.env),
         canUseTool: async () => ({ behavior: 'deny', message: 'Session title generation cannot use tools.' }),
       },

package/neural-interface/lib/synabun-update-plan.js

@@ -246,6 +246,25 @@ export function buildSynabunInstallPlan({
   const version = formatSynabunVersion(latest);
   const target = version || latest;
 
+  if (kind === 'packaged-app') {
+    // A packaged application carries its own runtime and dependencies: npm and
+    // git never write inside it. A newer build is installed over it instead.
+    const releasesUrl = `${repoUrl}/releases`;
+    return {
+      source: 'github',
+      installSource: kind,
+      canAutoUpdate: false,
+      reason: 'packaged-app',
+      current,
+      target,
+      channel: installedChannel,
+      displayCommand: releasesUrl,
+      openUrl: releasesUrl,
+      manualCommand: null,
+      manualHint: `This copy of SynaBun is a packaged application, so v${target} is installed by replacing it with the newer build, not from inside the app. Nothing was installed. Get the build for your system from the releases page and install it over this one; your data stays where it is.`,
+    };
+  }
+
   if (kind !== 'npm-global') {
     const clonedHint = kind === 'github-clone'
       ? 'This SynaBun install is a GitHub checkout. Open the repository to pull or reinstall from the correct source.'

package/neural-interface/package-lock.json

@@ -49,138 +49,12 @@
       "engines": {
         "node": ">=18.0.0"
       },
-      "optionalDependencies": {
-        "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.288",
-        "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.288",
-        "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.288",
-        "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.288",
-        "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.288",
-        "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.288",
-        "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.288",
-        "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.288"
-      },
       "peerDependencies": {
         "@anthropic-ai/sdk": ">=0.93.0",
         "@modelcontextprotocol/sdk": "^1.29.0",
         "zod": "^4.0.0"
       }
     },
-    "node_modules/@anthropic-ai/claude-agent-sdk-darwin-arm64": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-darwin-arm64/-/claude-agent-sdk-darwin-arm64-0.3.288.tgz",
-      "integrity": "sha512-85niGScWj8sr7yqOjSfqINaKv/zB47T45o4NBq1BmpaKRYFK7grtK24LA6C7cjx1Pznp+WT68mo373fbbwFW0A==",
-      "cpu": [
-        "arm64"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@anthropic-ai/claude-agent-sdk-darwin-x64": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-darwin-x64/-/claude-agent-sdk-darwin-x64-0.3.288.tgz",
-      "integrity": "sha512-hY8MQtgAi+cRedFb+qSqZzAYXIfjC+ZiXtCxKCs4OqWbqrdVZ0GKcEv4nB6MfQGs/Qr4U24cDNuO2lskBbZAWA==",
-      "cpu": [
-        "x64"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@anthropic-ai/claude-agent-sdk-linux-arm64": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-arm64/-/claude-agent-sdk-linux-arm64-0.3.288.tgz",
-      "integrity": "sha512-CCj0xau64T+Ia+X2wZgjYFSUIWfNJRWIGFbT8+jKiCzQggaBo6OSZ8hAYyME3h13JYrgpyrUTzB5YiwKaw8ZFg==",
-      "cpu": [
-        "arm64"
-      ],
-      "libc": [
-        "glibc"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@anthropic-ai/claude-agent-sdk-linux-arm64-musl": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-arm64-musl/-/claude-agent-sdk-linux-arm64-musl-0.3.288.tgz",
-      "integrity": "sha512-66MD4hzNTqrTL5MN21bSfxm/fhbnM+ERsmWHGEsJojxAWY5DXCUlDkaAYM0rxDpdvLMVt9PpRVIiWDptaiFPxA==",
-      "cpu": [
-        "arm64"
-      ],
-      "libc": [
-        "musl"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@anthropic-ai/claude-agent-sdk-linux-x64": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-x64/-/claude-agent-sdk-linux-x64-0.3.288.tgz",
-      "integrity": "sha512-Y5M496UZKttScbzptA45NI+CMHYONnskw0aq3rJ6s+gE6L6Jy8F8UoKt0lQO11R5xTY65TIeCasjQf/bLavuNg==",
-      "cpu": [
-        "x64"
-      ],
-      "libc": [
-        "glibc"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@anthropic-ai/claude-agent-sdk-linux-x64-musl": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-x64-musl/-/claude-agent-sdk-linux-x64-musl-0.3.288.tgz",
-      "integrity": "sha512-g3HDERLfEamirfp+MJDVl1fT8YYQMILUH65jPzl+SzKLeBu26WmAXAoZFmU4dasEmKZkEnBdL0ZQy3qnDy5EXg==",
-      "cpu": [
-        "x64"
-      ],
-      "libc": [
-        "musl"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@anthropic-ai/claude-agent-sdk-win32-arm64": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-win32-arm64/-/claude-agent-sdk-win32-arm64-0.3.288.tgz",
-      "integrity": "sha512-ijVSU5Vl1L1SlEm1djPNEekxHm9FS5GOitz8kL8KLdYDspMA97bgFM4gy/+riA3qn4ERepJkjdDLE+oYMTO+UA==",
-      "cpu": [
-        "arm64"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@anthropic-ai/claude-agent-sdk-win32-x64": {
-      "version": "0.3.288",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-win32-x64/-/claude-agent-sdk-win32-x64-0.3.288.tgz",
-      "integrity": "sha512-zh4yfGduDEBKUqb3BPtq/cLYwHoScqm7X5fJhmkSs0BJiSJGlb38j6FXWDvoPfe+OXNjE5onNx5HlAnDzsQzrA==",
-      "cpu": [
-        "x64"
-      ],
-      "license": "SEE LICENSE IN LICENSE.md",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
     "node_modules/@anthropic-ai/sdk": {
       "version": "0.104.1",
       "resolved": "https://registry.npmjs.org/@anthropic-ai/sdk/-/sdk-0.104.1.tgz",
@@ -1585,140 +1459,15 @@
         "url": "https://opencollective.com/express"
       }
     },
-    "node_modules/@openai/codex": {
-      "version": "0.160.0",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.160.0.tgz",
-      "integrity": "sha512-kEtVGzjRAYAMOwJxN39bGcna7LT3IDQgq64NNJ/dDTfu4OzZaocJcyNb5/gGJ/IVF/Vj7oK7E2m3nmTan7lpjg==",
-      "license": "Apache-2.0",
-      "bin": {
-        "codex": "bin/codex.js"
-      },
-      "engines": {
-        "node": ">=16"
-      },
-      "optionalDependencies": {
-        "@openai/codex-darwin-arm64": "npm:@openai/codex@0.160.0-darwin-arm64",
-        "@openai/codex-darwin-x64": "npm:@openai/codex@0.160.0-darwin-x64",
-        "@openai/codex-linux-arm64": "npm:@openai/codex@0.160.0-linux-arm64",
-        "@openai/codex-linux-x64": "npm:@openai/codex@0.160.0-linux-x64",
-        "@openai/codex-win32-arm64": "npm:@openai/codex@0.160.0-win32-arm64",
-        "@openai/codex-win32-x64": "npm:@openai/codex@0.160.0-win32-x64"
-      }
-    },
-    "node_modules/@openai/codex-darwin-arm64": {
-      "name": "@openai/codex",
-      "version": "0.160.0-darwin-arm64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.160.0-darwin-arm64.tgz",
-      "integrity": "sha512-aefV6cqZA2REZgR//4McyXlp7zLcTti4CI2v3j9IVgNndPBv2kCeNEcz07qeelXcwOdSFPUKb6roA48vZmDgrQ==",
-      "cpu": [
-        "arm64"
-      ],
-      "license": "Apache-2.0",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">=16"
-      }
-    },
-    "node_modules/@openai/codex-darwin-x64": {
-      "name": "@openai/codex",
-      "version": "0.160.0-darwin-x64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.160.0-darwin-x64.tgz",
-      "integrity": "sha512-ir7cdsPrb9VkqNqpTECoTiomv04xws/FQ968mHQzuL+2J5Da0Dkh2Qlxp7sguDDZJab4YpYmNjQvBVMXbTeQaQ==",
-      "cpu": [
-        "x64"
-      ],
-      "license": "Apache-2.0",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">=16"
-      }
-    },
-    "node_modules/@openai/codex-linux-arm64": {
-      "name": "@openai/codex",
-      "version": "0.160.0-linux-arm64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.160.0-linux-arm64.tgz",
-      "integrity": "sha512-VnVdsS06YlDsL8OwaJjQ3xdqdJNG4i+eBJBV3LytddknzSaF/urijLzVg3ptkwvoj8C7Gn7iWpVE+y8WEaPiCg==",
-      "cpu": [
-        "arm64"
-      ],
-      "license": "Apache-2.0",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=16"
-      }
-    },
-    "node_modules/@openai/codex-linux-x64": {
-      "name": "@openai/codex",
-      "version": "0.160.0-linux-x64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.160.0-linux-x64.tgz",
-      "integrity": "sha512-KI/73OqGrHmR18s7ya7E1NqV6rT0y3lxr0s8S1qR2m6zU6QRF/HlR529jALLh5vjdUnsRT4Ahoxt0axb4kY99g==",
-      "cpu": [
-        "x64"
-      ],
-      "license": "Apache-2.0",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=16"
-      }
-    },
     "node_modules/@openai/codex-sdk": {
       "version": "0.160.0",
       "resolved": "https://registry.npmjs.org/@openai/codex-sdk/-/codex-sdk-0.160.0.tgz",
       "integrity": "sha512-PWmoVvX/YqofBnauvao7IEUSYWzbbbIBmwQfRu3ARb2ZbcwIUeuMaicchEpdBzpE8Bw3KOMyhlPlcSQWeg+EoA==",
       "license": "Apache-2.0",
-      "dependencies": {
-        "@openai/codex": "0.160.0"
-      },
       "engines": {
         "node": ">=18"
       }
     },
-    "node_modules/@openai/codex-win32-arm64": {
-      "name": "@openai/codex",
-      "version": "0.160.0-win32-arm64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.160.0-win32-arm64.tgz",
-      "integrity": "sha512-tTvK9ZIGuj9WnYaYOAnfjJVSfPV7dKqWtDHqUPLf0Hadp6SgynTxx7S7iMXRieFeXVOI2XH76KxEHSOTOnz3zw==",
-      "cpu": [
-        "arm64"
-      ],
-      "license": "Apache-2.0",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=16"
-      }
-    },
-    "node_modules/@openai/codex-win32-x64": {
-      "name": "@openai/codex",
-      "version": "0.160.0-win32-x64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.160.0-win32-x64.tgz",
-      "integrity": "sha512-/gCFcuOmGlQkgGivWCtY8BNEDixh70Pue0HZOk9S8bj2vUIE1GLD9zcNB/KqqDJmn0S+lIttauLpzQnw6HOCHA==",
-      "cpu": [
-        "x64"
-      ],
-      "license": "Apache-2.0",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=16"
-      }
-    },
     "node_modules/@opencode-ai/sdk": {
       "version": "1.18.34",
       "resolved": "https://registry.npmjs.org/@opencode-ai/sdk/-/sdk-1.18.34.tgz",

package/neural-interface/public/install-app.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Install as App — SynaBun</title>
+  <link rel="icon" href="/favicon-32x32.png">
+  <link rel="apple-touch-icon" href="/apple-touch-icon.png">
+  <link rel="manifest" href="/manifest.json">
+  <link rel="stylesheet" href="/shared/styles.css">
+  <link rel="stylesheet" href="/shared/pwa-install.css">
+</head>
+<body id="pwa-install">
+  <main aria-labelledby="install-title">
+    <img src="/icon-192.png" width="48" height="48" alt="SynaBun">
+    <h1 id="install-title">Install SynaBun as an app</h1>
+    <p id="install-intro">The server is running in the background. Confirm installation once in your browser to give SynaBun its own app window.</p>
+    <ol>
+      <li id="install-chromium">Chrome or Edge: choose Install as App below, or the browser's Install app menu.</li>
+      <li id="install-safari">Safari on macOS: choose File → Add to Dock. Keep the name SynaBun.</li>
+    </ol>
+    <p id="install-later">After installation, reopen the native SynaBun launcher. It starts or reuses the server and opens your installed PWA. Closing the app window leaves the server running. Use Apps → Stop Server to stop it.</p>
+    <div class="actions">
+      <button id="install-button" type="button">Install as App</button>
+      <a id="install-continue" href="/">Continue to SynaBun</a>
+    </div>
+    <p id="install-status" role="status" aria-live="polite"></p>
+  </main>
+  <script type="module" src="/shared/pwa-install-page.js"></script>
+</body>
+</html>

package/neural-interface/public/manifest.json

@@ -1,6 +1,8 @@
 {
   "name": "SynaBun",
   "short_name": "SynaBun",
+  "id": "/",
+  "scope": "/",
   "start_url": "/",
   "display": "standalone",
   "display_override": ["window-controls-overlay", "standalone"],