@essentialai/cogent-bridge 3.5.6 → 3.5.8

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 3.5.8 — 2026-07-03
+
+### Added
+- **`watch` subcommand — a proactive poller/notifier.** `npx @essentialai/cogent-bridge watch --peer <id>`
+  runs a standalone, read-only process that polls the relay's existing `GET /api/sessions/:sessionId/poll`
+  and fires an OS notification (`osascript` on macOS / `notify-send` on Linux, with a stdout fallback) when
+  a message is directed at a peer that can't auto-respond — e.g. a **Claude Desktop** agent, which the
+  `claude --resume` auto-response mechanism can't wake. Reuses the per-cwd credential store; flags:
+  `--peer` (required), `--label`, `--interval` (default 15s), `--cwd`. New `src/watch/` (filter, poll-client,
+  notifier, orchestrator) + one additive `watch` branch in `cli.ts` — ZERO core-runtime edits, no breaking
+  change. (Approach C, an in-process WS hook, remains a backlog iteration.)
+
+### Internal
+- 20 new unit tests (`src/watch/*.test.ts`); full unit gate green.
+
+## 3.5.7 — 2026-07-01
+
+### Fixed
+- **Plugin now pins the exact bridge version, so `plugin update` actually updates the bridge.**
+  The plugin's `.mcp.json` spawned `npx -y @essentialai/cogent-bridge` with NO version — a bare
+  `npx <pkg>` reuses whatever build is already in the `~/.npm/_npx` cache and does not re-fetch,
+  so updating the plugin (skill) left the MCP-server BINARY stale (agents kept registering an old
+  `clientVersion` even after `claude plugin update` + restart). Both plugin manifests now pin
+  `@essentialai/cogent-bridge@3.5.7`; because each release bumps this pin, `claude plugin update
+  cogent` (then restart) pulls the plugin whose config names the exact matching bridge — plugin
+  and bridge move together, deterministically, with no manual npx-cache clearing. See
+  `plugin/.mcp.json`, `codex-plugin/.mcp.json`. (Release convention: bump the mcp.json pin every
+  release — added to the release skill.)
+
 ## 3.5.6 — 2026-07-01
 
 ### Added

package/README.md

@@ -349,3 +349,16 @@ src/
 ## License
 
 Apache-2.0
+
+### `watch` — proactive notifier for a peer
+
+Watches a channel and fires an OS notification when a message is directed at a peer
+that can't auto-respond (e.g. a Claude Desktop agent). Read-only; it does not reply.
+
+    # run from the SAME directory you registered the channel in (so it finds the saved creds)
+    npx @essentialai/cogent-bridge watch --peer dnarc-architect --label DARC --interval 15
+
+Flags: `--peer <peerId>` (required), `--label <displayLabel>` (optional, for `[→ Label]` tags),
+`--interval <seconds>` (default 15), `--cwd <dir>` (informational). Credentials are read from the
+per-cwd store the bridge writes on join (`~/.cogent/credentials/…`), or `COGENT_CREDENTIALS_FILE`.
+Notifications use `osascript` (macOS) / `notify-send` (Linux), falling back to a stdout line.

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAU5C"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAa5C"}

package/dist/cli.js

@@ -5,6 +5,10 @@ export async function runCli() {
         const { runWizard } = await import("./wizard/index.js");
         await runWizard();
     }
+    else if (command === "watch") {
+        const { runWatch } = await import("./watch/index.js");
+        await runWatch(process.argv.slice(3));
+    }
     else {
         // Default: start MCP server (existing behavior)
         await import("./index.js");

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACxD,MAAM,SAAS,EAAE,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,gDAAgD;QAChD,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC9B,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACxD,MAAM,SAAS,EAAE,CAAC;IACpB,CAAC;SAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACtD,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,gDAAgD;QAChD,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC9B,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/watch/filter.d.ts

@@ -0,0 +1,18 @@
+import type { MessageRecord } from "../types.js";
+/** The peer this watcher notifies for. `label` is the peer's optional display name. */
+export interface WatchTarget {
+    peerId: string;
+    label?: string;
+}
+/**
+ * True when `msg` is a directed message the watched peer should be notified about.
+ * Excludes the peer's own messages and auto-relay echoes. Matches either a
+ * strict-directed toPeerId or an obey-tag `[→ peerId]` / `[→ label]` in the body.
+ */
+export declare function isDirectedTo(msg: MessageRecord, target: WatchTarget): boolean;
+/**
+ * From a poll batch, return the directed messages not yet notified, adding each
+ * returned id to `seen`. Only directed ids are tracked, so `seen` stays bounded.
+ */
+export declare function selectFreshDirected(messages: MessageRecord[], target: WatchTarget, seen: Set<string>): MessageRecord[];
+//# sourceMappingURL=filter.d.ts.map

package/dist/watch/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/watch/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAO7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAChB,aAAa,EAAE,CASjB"}

package/dist/watch/filter.js

@@ -0,0 +1,34 @@
+/**
+ * True when `msg` is a directed message the watched peer should be notified about.
+ * Excludes the peer's own messages and auto-relay echoes. Matches either a
+ * strict-directed toPeerId or an obey-tag `[→ peerId]` / `[→ label]` in the body.
+ */
+export function isDirectedTo(msg, target) {
+    if (msg.fromPeerId === target.peerId)
+        return false;
+    if (msg.isRelayEcho)
+        return false;
+    if (msg.toPeerId === target.peerId)
+        return true;
+    const tags = [`[→ ${target.peerId}]`];
+    if (target.label)
+        tags.push(`[→ ${target.label}]`);
+    return tags.some((t) => msg.message.includes(t));
+}
+/**
+ * From a poll batch, return the directed messages not yet notified, adding each
+ * returned id to `seen`. Only directed ids are tracked, so `seen` stays bounded.
+ */
+export function selectFreshDirected(messages, target, seen) {
+    const fresh = [];
+    for (const m of messages) {
+        if (!isDirectedTo(m, target))
+            continue;
+        if (seen.has(m.id))
+            continue;
+        seen.add(m.id);
+        fresh.push(m);
+    }
+    return fresh;
+}
+//# sourceMappingURL=filter.js.map

package/dist/watch/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/watch/filter.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAkB,EAAE,MAAmB;IAClE,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,GAAG,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAyB,EACzB,MAAmB,EACnB,IAAiB;IAEjB,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;YAAE,SAAS;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/watch/index.d.ts

@@ -0,0 +1,31 @@
+import { type PersistedCredentials } from "../cloud/credential-store.js";
+import { pollOnce } from "./poll-client.js";
+import { notify as notifyOs } from "./notifier.js";
+import { type WatchTarget } from "./filter.js";
+export interface WatchConfig {
+    peerId: string;
+    label?: string;
+    intervalSec: number;
+    cwd?: string;
+}
+export interface WatchState {
+    lastMessageId?: string;
+    seen: Set<string>;
+}
+export interface WatchContext {
+    creds: PersistedCredentials;
+    target: WatchTarget;
+    poll: typeof pollOnce;
+    notify: typeof notifyOs;
+}
+/** Parse `watch` flags. Throws if --peer is missing. */
+export declare function parseWatchArgs(argv: string[]): WatchConfig;
+/** One poll → notify cycle. Advances state; never re-notifies a seen message. */
+export declare function runTick(state: WatchState, ctx: WatchContext): Promise<void>;
+/**
+ * Entry point for `cogent-bridge watch`. Loads creds, primes state (seeds `seen`
+ * from the current backlog WITHOUT notifying), then loops with exponential backoff
+ * on error. Runs until SIGINT/SIGTERM.
+ */
+export declare function runWatch(argv: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/watch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,OAAO,QAAQ,CAAC;IACtB,MAAM,EAAE,OAAO,QAAQ,CAAC;CACzB;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAY1D;AAMD,iFAAiF;AACjF,wBAAsB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAejF;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C5D"}

package/dist/watch/index.js

@@ -0,0 +1,91 @@
+import { loadCredentials } from "../cloud/credential-store.js";
+import { pollOnce } from "./poll-client.js";
+import { notify as notifyOs } from "./notifier.js";
+import { selectFreshDirected } from "./filter.js";
+/** Parse `watch` flags. Throws if --peer is missing. */
+export function parseWatchArgs(argv) {
+    const get = (flag) => {
+        const i = argv.indexOf(flag);
+        return i >= 0 && i + 1 < argv.length ? argv[i + 1] : undefined;
+    };
+    const peerId = get("--peer");
+    if (!peerId)
+        throw new Error("watch: --peer <peerId> is required");
+    const label = get("--label");
+    const cwd = get("--cwd");
+    const intervalRaw = Number(get("--interval"));
+    const intervalSec = Number.isFinite(intervalRaw) && intervalRaw > 0 ? intervalRaw : 15;
+    return { peerId, ...(label ? { label } : {}), ...(cwd ? { cwd } : {}), intervalSec };
+}
+function snippet(s) {
+    return s.replace(/\s+/g, " ").trim().slice(0, 140);
+}
+/** One poll → notify cycle. Advances state; never re-notifies a seen message. */
+export async function runTick(state, ctx) {
+    const { messages } = await ctx.poll({
+        endpoint: ctx.creds.endpoint,
+        sessionId: ctx.creds.sessionId,
+        peerId: ctx.target.peerId,
+        token: ctx.creds.token,
+        lastMessageId: state.lastMessageId,
+    });
+    const fresh = selectFreshDirected(messages, ctx.target, state.seen);
+    for (const m of fresh) {
+        await ctx.notify(`Cogent: ${m.fromPeerId} → ${ctx.target.peerId}`, snippet(m.message));
+    }
+    if (messages.length > 0) {
+        state.lastMessageId = messages[messages.length - 1].id;
+    }
+}
+/**
+ * Entry point for `cogent-bridge watch`. Loads creds, primes state (seeds `seen`
+ * from the current backlog WITHOUT notifying), then loops with exponential backoff
+ * on error. Runs until SIGINT/SIGTERM.
+ */
+export async function runWatch(argv) {
+    const cfg = parseWatchArgs(argv);
+    // Credentials resolve per-cwd via process.cwd() or COGENT_CREDENTIALS_FILE. `--cwd` is
+    // informational in v1 — run the watcher from the directory you registered in (documented in README).
+    const creds = await loadCredentials();
+    if (!creds) {
+        process.stderr.write("watch: no saved credentials for this directory. Join the channel first " +
+            "(/cogent:register), or run watch from the same cwd, or set COGENT_CREDENTIALS_FILE.\n");
+        process.exit(1);
+        return;
+    }
+    const target = { peerId: cfg.peerId, ...(cfg.label ? { label: cfg.label } : {}) };
+    const ctx = { creds, target, poll: pollOnce, notify: notifyOs };
+    const state = { seen: new Set() };
+    // Prime: seed lastMessageId + seen from the backlog without notifying.
+    try {
+        const primed = await pollOnce({ endpoint: creds.endpoint, sessionId: creds.sessionId, peerId: cfg.peerId, token: creds.token });
+        selectFreshDirected(primed.messages, target, state.seen);
+        if (primed.messages.length > 0)
+            state.lastMessageId = primed.messages[primed.messages.length - 1].id;
+    }
+    catch (err) {
+        process.stderr.write(`watch: initial poll failed (${err.message}); will retry.\n`);
+    }
+    process.stdout.write(`watch: notifying for [→ ${cfg.peerId}] on ${creds.label ?? creds.sessionId} every ${cfg.intervalSec}s. Ctrl-C to stop.\n`);
+    let stopped = false;
+    const stop = () => { stopped = true; };
+    process.on("SIGINT", stop);
+    process.on("SIGTERM", stop);
+    let backoff = 0;
+    while (!stopped) {
+        const waitMs = (backoff > 0 ? Math.min(cfg.intervalSec * 2 ** backoff, 120) : cfg.intervalSec) * 1000;
+        await new Promise((r) => setTimeout(r, waitMs));
+        if (stopped)
+            break;
+        try {
+            await runTick(state, ctx);
+            backoff = 0;
+        }
+        catch (err) {
+            backoff = Math.min(backoff + 1, 6);
+            process.stderr.write(`watch: poll error (${err.message}); backing off.\n`);
+        }
+    }
+    process.stdout.write("watch: stopped.\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/watch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"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"}

package/dist/watch/notifier.d.ts

@@ -0,0 +1,22 @@
+export type CommandRunner = (cmd: string, args: string[]) => Promise<void>;
+/**
+ * Build the platform-appropriate notifier command, or null on an unsupported OS
+ * (the caller then falls back to stdout). macOS uses `osascript`; Linux uses
+ * `notify-send`. Args are passed as an argv array (no shell), so only the
+ * AppleScript string literal needs sanitizing.
+ */
+export declare function notifierCommand(platform: NodeJS.Platform, title: string, body: string): {
+    cmd: string;
+    args: string[];
+} | null;
+export interface NotifyOptions {
+    platform?: NodeJS.Platform;
+    runner?: CommandRunner;
+}
+/**
+ * Fire an OS notification. Never rejects: an unsupported platform or a failing
+ * command falls back to a stdout line (with a terminal bell), so the watch loop
+ * is never broken by a notifier problem.
+ */
+export declare function notify(title: string, body: string, opts?: NotifyOptions): Promise<void>;
+//# sourceMappingURL=notifier.d.ts.map

package/dist/watch/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/watch/notifier.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAW3E;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CASxC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAajG"}

package/dist/watch/notifier.js

@@ -0,0 +1,47 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const pexecFile = promisify(execFile);
+const defaultRunner = async (cmd, args) => {
+    await pexecFile(cmd, args);
+};
+/** Strip characters that would break an AppleScript double-quoted string literal. */
+function sanitize(s) {
+    return s.replace(/["\\]/g, "'").replace(/[\r\n]+/g, " ").slice(0, 200);
+}
+/**
+ * Build the platform-appropriate notifier command, or null on an unsupported OS
+ * (the caller then falls back to stdout). macOS uses `osascript`; Linux uses
+ * `notify-send`. Args are passed as an argv array (no shell), so only the
+ * AppleScript string literal needs sanitizing.
+ */
+export function notifierCommand(platform, title, body) {
+    if (platform === "darwin") {
+        const script = `display notification "${sanitize(body)}" with title "${sanitize(title)}"`;
+        return { cmd: "osascript", args: ["-e", script] };
+    }
+    if (platform === "linux") {
+        return { cmd: "notify-send", args: [title, body] };
+    }
+    return null;
+}
+/**
+ * Fire an OS notification. Never rejects: an unsupported platform or a failing
+ * command falls back to a stdout line (with a terminal bell), so the watch loop
+ * is never broken by a notifier problem.
+ */
+export async function notify(title, body, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const runner = opts.runner ?? defaultRunner;
+    const cmd = notifierCommand(platform, title, body);
+    if (!cmd) {
+        process.stdout.write(`\x07🔔 ${title}: ${body}\n`);
+        return;
+    }
+    try {
+        await runner(cmd.cmd, cmd.args);
+    }
+    catch {
+        process.stdout.write(`\x07🔔 ${title}: ${body}\n`);
+    }
+}
+//# sourceMappingURL=notifier.js.map

package/dist/watch/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../../src/watch/notifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAItC,MAAM,aAAa,GAAkB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IACvD,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,qFAAqF;AACrF,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAyB,EACzB,KAAa,EACb,IAAY;IAEZ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,yBAAyB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC;QAC1F,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAa,EAAE,IAAY,EAAE,OAAsB,EAAE;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC;IAC5C,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/watch/poll-client.d.ts

@@ -0,0 +1,20 @@
+import type { MessageRecord } from "../types.js";
+export interface PollResult {
+    messages: MessageRecord[];
+    events: unknown[];
+}
+export interface PollOptions {
+    endpoint: string;
+    sessionId: string;
+    peerId: string;
+    token: string;
+    lastMessageId?: string;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * One call to the relay's poll endpoint. Returns the peer-relevant messages since
+ * `lastMessageId` (all of them on the first, priming poll). Throws on a non-2xx
+ * response so the loop can back off; the caller owns retry/backoff.
+ */
+export declare function pollOnce(opts: PollOptions): Promise<PollResult>;
+//# sourceMappingURL=poll-client.d.ts.map

package/dist/watch/poll-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-client.d.ts","sourceRoot":"","sources":["../../src/watch/poll-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBrE"}

package/dist/watch/poll-client.js

@@ -0,0 +1,23 @@
+/**
+ * One call to the relay's poll endpoint. Returns the peer-relevant messages since
+ * `lastMessageId` (all of them on the first, priming poll). Throws on a non-2xx
+ * response so the loop can back off; the caller owns retry/backoff.
+ */
+export async function pollOnce(opts) {
+    const f = opts.fetchImpl ?? fetch;
+    const url = new URL(`${opts.endpoint.replace(/\/$/, "")}/api/sessions/${encodeURIComponent(opts.sessionId)}/poll`);
+    url.searchParams.set("peerId", opts.peerId);
+    if (opts.lastMessageId)
+        url.searchParams.set("lastMessageId", opts.lastMessageId);
+    const res = await f(url.toString(), {
+        method: "GET",
+        headers: { authorization: `Bearer ${opts.token}` },
+        // Bounded deadline so a stalled relay never pins the loop.
+        signal: AbortSignal.timeout(10_000),
+    });
+    if (!res.ok)
+        throw new Error(`poll failed: HTTP ${res.status}`);
+    const body = (await res.json());
+    return { messages: body.messages ?? [], events: body.events ?? [] };
+}
+//# sourceMappingURL=poll-client.js.map

package/dist/watch/poll-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-client.js","sourceRoot":"","sources":["../../src/watch/poll-client.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAiB;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAC9F,CAAC;IACF,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,aAAa;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAElF,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;QAClC,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE,EAAE;QAClD,2DAA2D;QAC3D,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuD,CAAC;IACtF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@essentialai/cogent-bridge",
-  "version": "3.5.6",
+  "version": "3.5.8",
   "description": "MCP server for inter-Claude-Code session communication bridge",
   "type": "module",
   "workspaces": [

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.5.6",
+  "version": "3.5.8",
   "repository": {
     "url": "https://github.com/eaisdevelopment/cogent",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "@essentialai/cogent-bridge",
-      "version": "3.5.6",
+      "version": "3.5.8",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"