@essentialai/cogent-bridge 3.12.2 → 3.12.4

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 3.12.4 — 2026-07-30
+
+### Fixed
+- **Codex plugin now also ships the bundled bridge** (no npx cold-start) — same fresh-install fix as 3.12.3, extended to Codex (`node ${CLAUDE_PLUGIN_ROOT}/bridge/cogent-bridge.mjs`, `COGENT_PLATFORM=codex`).
+- FAQ + README: recovery steps for anyone who hit the pre-3.12.3 npx-timeout install state.
+
+
+## 3.12.3 — 2026-07-30
+
+### Fixed — CRITICAL: fresh install could never complete (cold npx > 30s MCP budget)
+- **The plugin no longer launches the bridge via `npx`.** On a fresh machine the cold
+  `npx -y @essentialai/cogent-bridge@X` download took ~39s, over Claude Code's ~30s MCP
+  connect budget, so the `cogent_*` tools never bound to the session (`/cogent:register`
+  and `/cogent:status` were impossible). Worse, the timeout killed npm mid-install and
+  left a corrupt npx cache (`ajv-formats` present, `ajv` missing → `Cannot find module
+  'ajv'` → crash), a self-sustaining loop.
+- **Fix:** the Claude Code plugin now **ships a single self-contained bundle**
+  (`bridge/cogent-bridge.mjs`, all deps inlined via esbuild) and launches it with
+  `node ${CLAUDE_PLUGIN_ROOT}/bridge/cogent-bridge.mjs` — **no npx, no network at connect
+  time, ~0.4s cold start**, no cache corruption. The npm `@essentialai/cogent-bridge`
+  package is unchanged for direct/npx/Team consumers. (Codex plugin still uses npx — pinned
+  to 3.12.3; codex bundling is a fast-follow.)
+
 ## 3.12.2 — 2026-07-29
 
 ### Added — check-on-stop ("C"): catch messages that arrived while busy

package/README.md

@@ -245,6 +245,17 @@ To override defaults, set environment variables in your `.mcp.json`:
 
 ## Troubleshooting
 
+### Fresh install: Cogent tools aren't available / `/cogent:register` can't run
+
+Fixed in **3.12.3**. Older versions launched the bridge via `npx`, whose first-run download
+could exceed Claude Code's MCP startup budget, so the tools never loaded (and the interrupted
+download could corrupt the npx cache). The plugin now ships a self-contained bundle and starts
+instantly. If you already hit the broken state, run once then fully quit + relaunch:
+
+```bash
+rm -rf ~/.npm/_npx && claude plugin marketplace update && claude plugin update cogent@cogent
+```
+
 ### NVM/PATH: "npx not found" or server fails to start
 
 MCP servers are spawned as subprocesses and may not inherit your NVM configuration.

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,+DACsC,CAAC;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,QAAiB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,WAAW,+DACsC,CAAC;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,QAAmB,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,QAAiB,CAAC"}

package/dist/constants.js

@@ -1,6 +1,18 @@
 import { createRequire } from "node:module";
-const require = createRequire(import.meta.url);
-const pkg = require("../package.json");
+function resolveVersion() {
+    // `typeof` on an undeclared identifier is safe (returns "undefined"); in the bundle
+    // esbuild replaces the identifier with a string literal so this branch wins.
+    if (typeof __COGENT_VERSION__ === "string" && __COGENT_VERSION__) {
+        return __COGENT_VERSION__;
+    }
+    try {
+        const require = createRequire(import.meta.url);
+        return require("../package.json").version;
+    }
+    catch {
+        return "unknown";
+    }
+}
 export const SERVER_NAME = "Cogent Bridge from Essential AI Solutions (essentialai.uk)";
 /**
  * cogent-bridge npm package version. Historically named SERVER_VERSION
@@ -10,7 +22,7 @@ export const SERVER_NAME = "Cogent Bridge from Essential AI Solutions (essential
  * all of which legitimately identify cogent-bridge AS the MCP server to the
  * user/CLI/CC).
  */
-export const SERVER_VERSION = pkg.version;
+export const SERVER_VERSION = resolveVersion();
 /**
  * Alias of SERVER_VERSION for use sites where this string identifies the
  * client (cogent-bridge npm package) talking to cogent-server. Audit L4:

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GACtB,4DAA4D,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU5C,SAAS,cAAc;IACrB,oFAAoF;IACpF,6EAA6E;IAC7E,IAAI,OAAO,kBAAkB,KAAK,QAAQ,IAAI,kBAAkB,EAAE,CAAC;QACjE,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAQ,OAAO,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GACtB,4DAA4D,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,EAAE,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@essentialai/cogent-bridge",
-  "version": "3.12.2",
+  "version": "3.12.4",
   "description": "MCP server for inter-Claude-Code session communication bridge",
   "type": "module",
   "workspaces": [
@@ -24,8 +24,9 @@
   "scripts": {
     "start": "node dist/index.js",
     "dev": "tsx watch src/index.ts",
-    "build": "node node_modules/typescript/bin/tsc",
-    "clean": "rm -rf dist",
+    "build": "node node_modules/typescript/bin/tsc && npm run build:bundle",
+    "build:bundle": "node scripts/build-bundle.mjs",
+    "clean": "rm -rf dist plugin/bridge",
     "test": "node node_modules/vitest/vitest.mjs run",
     "test:watch": "node node_modules/vitest/vitest.mjs",
     "test:unit": "node node_modules/vitest/vitest.mjs run --exclude 'src/e2e/**'",
@@ -72,6 +73,7 @@
     "@types/node": "^22.10.0",
     "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^4.0.18",
+    "esbuild": "^0.28.1",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.18"

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.eaisdevelopment/cogent",
   "title": "Cogent Bridge from Essential AI Solutions (essentialai.uk)",
   "description": "MCP bridge for inter-session communication between Claude Code instances",
-  "version": "3.12.2",
+  "version": "3.12.4",
   "repository": {
     "url": "https://github.com/eaisdevelopment/cogent",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "@essentialai/cogent-bridge",
-      "version": "3.12.2",
+      "version": "3.12.4",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"