@raysonmeng/agentbridge 0.1.6 → 0.1.8

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@raysonmeng/agentbridge",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Bridge between Claude Code and Codex — bidirectional agent communication via MCP Channel + JSON-RPC",
   "type": "module",
+  "packageManager": "bun@1.3.11",
+  "engines": {
+    "bun": ">=1.3.11"
+  },
   "bin": {
     "agentbridge": "dist/cli.js",
     "abg": "dist/cli.js"
@@ -12,21 +16,30 @@
     "plugins/",
     ".claude-plugin/",
     "scripts/postinstall.cjs",
+    "scripts/install-safety.cjs",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "start": "bun run src/bridge.ts",
-    "build:cli": "mkdir -p dist && bun build src/cli.ts --outfile dist/cli.js --target bun && chmod +x dist/cli.js",
-    "build:plugin": "mkdir -p plugins/agentbridge/server && bun build src/bridge.ts --outfile plugins/agentbridge/server/bridge-server.js --target bun && bun build src/daemon.ts --outfile plugins/agentbridge/server/daemon.js --target bun",
+    "build:cli": "node scripts/build-bundles.mjs cli daemon",
+    "build:plugin": "node scripts/build-bundles.mjs bridge-plugin daemon-plugin",
+    "smoke:built": "bun scripts/smoke-built-cli.mjs",
+    "smoke:pack": "bun scripts/smoke-pack.mjs",
     "verify:plugin-sync": "node scripts/verify-plugin-sync.cjs",
     "postinstall": "node scripts/postinstall.cjs",
-    "prepublishOnly": "bun run build:cli && bun run build:plugin",
+    "prepublishOnly": "bun run build:cli && bun run build:plugin && bun run verify:plugin-sync && bun scripts/check-plugin-versions.js",
     "validate:plugin": "claude plugin validate plugins/agentbridge && claude plugin validate .claude-plugin/marketplace.json",
     "test": "bun test src",
+    "e2e:transport": "bun scripts/e2e-codex-transport.mjs",
+    "install:global": "node scripts/install-global.mjs local",
+    "install:global:local": "node scripts/install-global.mjs local",
+    "install:global:npm": "node scripts/install-global.mjs npm",
+    "release:bump": "node scripts/bump-version.mjs",
     "typecheck": "tsc --noEmit",
     "validate:plugin-versions": "bun scripts/check-plugin-versions.js",
-    "check": "tsc --noEmit && bun test src && bun run verify:plugin-sync && bun scripts/check-plugin-versions.js"
+    "check": "tsc --noEmit && bun test src && bun run verify:plugin-sync && bun scripts/check-plugin-versions.js",
+    "ci:local": "bun run check && bun run smoke:built && bun run smoke:pack"
   },
   "repository": {
     "type": "git",

package/plugins/agentbridge/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentbridge",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Bridge Claude Code and Codex with a shared daemon, push channel delivery, and bidirectional reply tooling.",
   "author": {
     "name": "AgentBridge Contributors",

package/plugins/agentbridge/README.md

@@ -1,6 +1,6 @@
 # AgentBridge Plugin
 
-Claude Code plugin for AgentBridge. This plugin packages the AgentBridge MCP frontend, dual-mode Claude transport (push channel delivery plus pull-mode `get_messages`), the `/agentbridge:init` command, and a non-blocking SessionStart health check.
+Claude Code plugin for AgentBridge. This plugin packages the AgentBridge MCP frontend with push channel delivery (a failed push falls back to an in-memory queue drained by `get_messages`), the `/agentbridge:init` command, and a non-blocking SessionStart health check.
 
 ## Structure
 
@@ -38,6 +38,6 @@ This creates self-contained bundles at:
 ## Notes
 
 - The plugin frontend launches the sibling daemon bundle via `AGENTBRIDGE_DAEMON_ENTRY=./daemon.js`.
-- Claude delivery supports both push notifications and pull-mode polling via `get_messages`, depending on the runtime mode.
+- Claude delivery is always push notifications. If a push fails, the message is queued and can be drained via `get_messages` (per-message fallback — the legacy `AGENTBRIDGE_MODE=pull` mode was removed and the env var is ignored with a one-time warning).
 - The SessionStart hook is informational only. It never starts or stops the daemon.
 - The command at `/agentbridge:init` edits project-local `.agentbridge/` files only; plugin installation and marketplace registration remain terminal-side tasks (`agentbridge init` / `agentbridge dev`).

package/plugins/agentbridge/scripts/health-check.sh

@@ -9,6 +9,16 @@ cooldown_seconds="${AGENTBRIDGE_HEALTH_HOOK_COOLDOWN_SECONDS:-120}"
 state_root="${AGENTBRIDGE_HOOK_STATE_DIR:-${TMPDIR:-/tmp}/agentbridge-hooks}"
 port="${AGENTBRIDGE_CONTROL_PORT:-4502}"
 
+# In multi-pair mode the resolver exports AGENTBRIDGE_PAIR_ID, inherited here via
+# the SessionStart hook env. Scope the suggested commands to that pair so the
+# user is not sent to a different (cwd-derived) pair. Guard the charset (the
+# resolver already restricts it) so nothing unsafe is interpolated into the JSON.
+pair_id="${AGENTBRIDGE_PAIR_ID:-}"
+pair_arg=""
+if printf '%s' "$pair_id" | grep -Eq '^[A-Za-z0-9._-]+$'; then
+  pair_arg=" --pair ${pair_id}"
+fi
+
 if ! command -v curl >/dev/null 2>&1; then
   exit 0
 fi
@@ -27,6 +37,15 @@ fi
 
 printf '%s' "$now" >"$stamp_file" 2>/dev/null || true
 
+# In-session plugin-update reminder: compare the INSTALLED plugin version against
+# the latest npm version cached by the CLI notifier (src/update-notifier.ts). This
+# is how a user who updated the npm CLI but not the plugin learns of the mismatch
+# from inside Claude Code. Best-effort + silent: never blocks the hook.
+plugin_notice=""
+if command -v bun >/dev/null 2>&1 && [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
+  plugin_notice="$(bun "${CLAUDE_PLUGIN_ROOT}/scripts/plugin-update-notice.mjs" "${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json" 2>/dev/null || true)"
+fi
+
 health_json="$(curl -fsS --max-time 1 "http://127.0.0.1:${port}/healthz" 2>/dev/null || true)"
 
 if [ -n "$health_json" ]; then
@@ -37,15 +56,15 @@ if [ -n "$health_json" ]; then
 
   if [ "$tui_connected" = "true" ]; then
     cat <<EOF
-{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge is running. Daemon healthy, Codex TUI connected. Bridge is ready for communication."}}
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge is running. Daemon healthy, Codex TUI connected. Bridge is ready for communication.${plugin_notice:+ $plugin_notice}"}}
 EOF
   else
     cat <<EOF
-{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge daemon is running but Codex TUI is not connected yet. Start Codex in another terminal with: agentbridge codex"}}
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge daemon is running but Codex TUI is not connected yet. Start Codex in another terminal with: agentbridge codex${pair_arg}${plugin_notice:+ $plugin_notice}"}}
 EOF
   fi
 else
   cat <<EOF
-{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge daemon is not reachable on http://127.0.0.1:${port}/healthz yet. Start the bridge with: agentbridge claude (this terminal) + agentbridge codex (another terminal). If you're already using agentbridge claude, the daemon may still be starting up."}}
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge daemon is not reachable on http://127.0.0.1:${port}/healthz yet. Start the bridge with: agentbridge claude${pair_arg} (this terminal) + agentbridge codex${pair_arg} (another terminal). If you're already using agentbridge claude${pair_arg}, the daemon may still be starting up.${plugin_notice:+ $plugin_notice}"}}
 EOF
 fi

package/plugins/agentbridge/scripts/plugin-update-notice.mjs

@@ -0,0 +1,73 @@
+#!/usr/bin/env bun
+/**
+ * In-session plugin-update reminder.
+ *
+ * The CLI notifier (src/update-notifier.ts) writes the latest npm version to the
+ * update-check cache. This script — invoked by the SessionStart hook
+ * (scripts/health-check.sh) — compares that `latest` against the INSTALLED
+ * plugin version (plugin.json, passed as argv[2]) and prints a one-line reminder
+ * to stdout if the plugin is behind. Prints NOTHING otherwise.
+ *
+ * Why a separate plugin-side reminder: the CLI prints its notice to the terminal
+ * before Claude Code's TUI takes over, so a user who updates npm but not the
+ * plugin would otherwise never see the mismatch from inside the session.
+ *
+ * Self-contained on purpose: the shipped plugin does not include src/, so the
+ * tiny state-dir resolution + stable-semver compare are inlined here. Keep them
+ * in sync with src/state-dir.ts (StateDirResolver) and src/version-utils.ts.
+ * Silent on ANY error — it must never break the SessionStart hook.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
+
+/** Mirror of StateDirResolver (src/state-dir.ts). */
+function stateDir() {
+  const override = process.env.AGENTBRIDGE_STATE_DIR;
+  if (override) return override;
+  if (platform() === "darwin") {
+    return join(homedir(), "Library", "Application Support", "AgentBridge");
+  }
+  const xdg = process.env.XDG_STATE_HOME ?? join(homedir(), ".local", "state");
+  return join(xdg, "agentbridge");
+}
+
+const STABLE = /^\d+\.\d+\.\d+$/;
+
+/** Mirror of isStableUpgrade (src/version-utils.ts): stable latest strictly > stable current. */
+function isStableUpgrade(current, latest) {
+  if (!STABLE.test(current) || !STABLE.test(latest)) return false;
+  const a = current.split(".").map(Number);
+  const b = latest.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if (b[i] > a[i]) return true;
+    if (b[i] < a[i]) return false;
+  }
+  return false;
+}
+
+try {
+  // Honor the same opt-out as the CLI notifier (src/update-notifier.ts): a user
+  // who silenced update notices must not still get the in-session reminder.
+  if (process.env.NO_UPDATE_NOTIFIER || process.env.AGENTBRIDGE_NO_UPDATE_NOTIFIER) {
+    process.exit(0);
+  }
+
+  const pluginJsonPath = process.argv[2];
+  if (!pluginJsonPath) process.exit(0);
+
+  const current = JSON.parse(readFileSync(pluginJsonPath, "utf-8")).version;
+  const cache = JSON.parse(readFileSync(join(stateDir(), "update-check.json"), "utf-8"));
+  const latest = cache?.latest;
+
+  if (typeof current === "string" && typeof latest === "string" && isStableUpgrade(current, latest)) {
+    process.stdout.write(
+      `AgentBridge plugin update available: ${current} -> ${latest}. ` +
+        `Update the plugin with /plugin marketplace update agentbridge then /reload-plugins ` +
+        `(and the CLI with npm install -g @raysonmeng/agentbridge@latest) so the CLI and plugin versions match.`,
+    );
+  }
+} catch {
+  // No cache yet / no plugin.json / malformed — stay silent.
+}
+process.exit(0);