feat(connectd): native-binary connectors + companion sidecar lifecycle #2

Open
tim.lingo wants to merge 5 commits from feat/bin-native-connector into main

5 Commits

Author SHA1 Message Date
Tim Lingo b3f3944c95 fix(build): sync package-lock with a012367's added deps — npm ci was failing for every clean installer build
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-17 10:31:14 -05:00
Tim Lingo 995b9a8548 feat(connectd): companion cwd (writable session dir for the WhatsApp bridge)
companion.cwd (created if missing; ~/$HOME expanded) sets the sidecar's working directory so the
WhatsApp bridge writes its session store to a writable path (~/.neuron/whatsapp), never the read-only
app bundle. Typecheck clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-27 14:56:38 -05:00
Tim Lingo edf276c51e feat(connectd): companion sidecar lifecycle (connectd-child, v1)
Adds optional ServerConfig.companion {command,args,env,healthUrl}. On stdio connect, ensureCompanion
spawns the sidecar (e.g. the WhatsApp bridge) if healthUrl isn't already serving, polls health (15s),
then spawns the MCP server that talks to it. Killed on closeServer + SIGINT/SIGTERM (disposeCompanions)
so it never orphans. Reuses an already-running bridge (idempotent). Typecheck clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-27 14:27:28 -05:00
Tim Lingo fed166202e feat(connectd): @bin/<file> — spawn a bundled native MCP server binary
Adds @bin/<file> command resolution alongside @node/@bundled: resolves to a native binary in the
bundled-servers dir, spawned directly (no Node runtime). Enables native MCP connectors like the Go
whatsapp-mcp. Typecheck clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-27 14:23:20 -05:00
Tim Lingo a01236753a feat(connectors): clean-install bundling + Google OAuth foundation
Make connectors work on a clean Mac with no Node/npm installed, and lay
the foundation for one-click Google sign-in.

Clean-install bundling:
- bundle scripts: `npm run bundle` -> self-contained dist/connectd.cjs (CJS,
  no node_modules); `bundle:servers` -> pre-bundled MCP servers (fs-server.mjs
  for "Your files", runs without npx); `bundle:all`.
- runtime resolution in the bridge: a connector config can use command "@node"
  (the bundled runtime, process.execPath) and arg "@bundled/<server>" (a server
  shipped alongside the bridge), resolved at spawn time via
  NEURON_CONNECTD_BUNDLE_DIR. So remote connectors + "Your files" work offline,
  zero deps.
- graceful ENOENT -> needs_setup ("coming soon") instead of a cryptic spawn
  crash for not-yet-bundled npx connectors on a clean machine.

Google OAuth foundation (google-oauth.ts):
- desktop-style authorization-code + PKCE flow, refresh, Keychain storage,
  gated on GOOGLE_OAUTH_CLIENT_ID (honest needs_setup until configured).
- new auth mode "google" for stdio connectors + /google/oauth/start and
  /google/callback endpoints. NOTE: pending the Neuron Google OAuth client +
  Google verification; not certified end-to-end yet.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 14:27:04 -05:00