@saleso.innovations/bridge 0.1.7 → 0.1.9

package/INTEGRATION.md

@@ -34,6 +34,9 @@ export async function onCleosPairingCodeSubmitted(code: string) {
       for await (const chunk of stream) {
         reply.delta(chunk, sequence++);
       }
+      // If you stream from Hermes /v1/chat/completions, also forward tool progress via
+      // reply.activity() when you receive `event: hermes.tool.progress` SSE events.
+      // Do not inject tool markers into assistant text (see Hermes #6972).
       reply.complete(stream.finalText, sequence);
     },
   });

package/README.md

@@ -15,9 +15,25 @@ Requirements:
 - Node.js 20+
 - Hermes installed on the same machine (`hermes gateway` — the install script configures the API automatically)
 
+## Update
+
+After the first install, updates are one command:
+
+```bash
+cleos-bridge update
+```
+
+The install script links `cleos-bridge` to `/usr/local/bin` (root) or `~/.local/bin` (non-root). If that command is not found yet, use:
+
+```bash
+curl -fsSL https://amicable-elephant-407.convex.site/update-bridge.sh | bash
+```
+
+This installs the latest package, refreshes the CLI symlink, and restarts `cleos-bridge.service` when present.
+
 ## Manual usage
 
-The install script puts the bridge in `~/.cleos/bridge` (no PATH setup needed). To run manually:
+The install script puts the bridge in `~/.cleos/bridge`. To run without the symlink:
 
 ```bash
 node ~/.cleos/bridge/node_modules/@saleso.innovations/bridge/dist/cli.js pair ABCD1234

package/dist/bridgePaths.d.ts

@@ -0,0 +1,7 @@
+export declare const BRIDGE_PACKAGE = "@saleso.innovations/bridge";
+export declare function defaultBridgeInstallDir(): string;
+export declare function bridgeCliPath(bridgeDir: string): string;
+/** Directory used by `npm install --prefix` (usually ~/.cleos/bridge). */
+export declare function resolveBridgeInstallDir(): string;
+export declare function readInstalledBridgeVersion(bridgeDir: string): string | null;
+//# sourceMappingURL=bridgePaths.d.ts.map

package/dist/bridgePaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgePaths.d.ts","sourceRoot":"","sources":["../src/bridgePaths.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,+BAA+B,CAAC;AAE3D,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAwBD,0EAA0E;AAC1E,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3E"}

package/dist/bridgePaths.js

@@ -0,0 +1,51 @@
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+export const BRIDGE_PACKAGE = "@saleso.innovations/bridge";
+export function defaultBridgeInstallDir() {
+    return join(homedir(), ".cleos", "bridge");
+}
+export function bridgeCliPath(bridgeDir) {
+    return join(bridgeDir, "node_modules", BRIDGE_PACKAGE, "dist", "cli.js");
+}
+function inferBridgeDirFromCliPath(cliPath) {
+    const marker = `${sep}node_modules${sep}${BRIDGE_PACKAGE.replace("/", sep)}${sep}`;
+    const idx = cliPath.indexOf(marker);
+    if (idx < 0)
+        return null;
+    const nodeModulesDir = join(cliPath.slice(0, idx), "node_modules");
+    return dirname(nodeModulesDir);
+}
+function readBridgeDirFromSystemd() {
+    try {
+        const unit = execFileSync("systemctl", ["cat", "cleos-bridge.service"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const match = unit.match(/ExecStart=\S+\s+(\S+\/dist\/cli\.js)/);
+        if (!match?.[1])
+            return null;
+        return inferBridgeDirFromCliPath(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+/** Directory used by `npm install --prefix` (usually ~/.cleos/bridge). */
+export function resolveBridgeInstallDir() {
+    return (readBridgeDirFromSystemd() ??
+        inferBridgeDirFromCliPath(fileURLToPath(import.meta.url)) ??
+        defaultBridgeInstallDir());
+}
+export function readInstalledBridgeVersion(bridgeDir) {
+    const pkgJson = join(bridgeDir, "node_modules", BRIDGE_PACKAGE, "package.json");
+    try {
+        const parsed = JSON.parse(readFileSync(pkgJson, "utf8"));
+        return parsed.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/cli.js

@@ -3,6 +3,7 @@ import { credentialsPathForDisplay, loadCredentials } from "./credentials.js";
 import { connectHermesAgent, pairCleosAgent, reconnectHermesAgent } from "./client.js";
 import { startCronWatcher } from "./cronWatcher.js";
 import { runBridgeDaemon } from "./daemon.js";
+import { runBridgeUpdate } from "./update.js";
 import { prepareHermesForBridge } from "./ensureHermesApi.js";
 import { createHermesMessageHandler } from "./hermesForwarder.js";
 import { convexSiteUrlFromEnv } from "./resolve.js";
@@ -65,6 +66,10 @@ async function main() {
         await waitForExit(session, () => startCronWatcher({ session }));
         return;
     }
+    if (command === "update") {
+        runBridgeUpdate({ tag: codeArg || "latest" });
+        return;
+    }
     printUsage();
     process.exit(1);
 }
@@ -74,6 +79,7 @@ function printUsage() {
     console.error("  cleos-bridge connect <CODE>   Pair and stay connected in the foreground");
     console.error("  cleos-bridge start [CODE]     Run as a reconnecting daemon (systemd)");
     console.error("  cleos-bridge reconnect        Reconnect once using saved credentials");
+    console.error("  cleos-bridge update [TAG]     Update package and restart systemd service");
 }
 async function waitForExit(session, onStart) {
     const stop = onStart?.();

package/dist/client.d.ts

@@ -21,8 +21,16 @@ export type UserMessageMeta = {
     messageId: string;
     attachments?: UserMessageAttachment[];
 };
+export type AgentActivityPayload = {
+    activityType: "tool.started" | "tool.completed";
+    tool?: string;
+    label?: string;
+    emoji?: string;
+    sequence: number;
+};
 export type AgentReply = {
     delta: (text: string, sequence: number) => void;
+    activity: (activity: AgentActivityPayload) => void;
     complete: (text: string, sequence: number) => void;
 };
 export type CronDeliveryMeta = {

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAKhG,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrG,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtE,CAAC;AA2LF,wBAAsB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA2BD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAcxF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAClD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,aAAa,CAAC,CAc9B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAKhG,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrG,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,cAAc,GAAG,gBAAgB,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACnD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtE,CAAC;AA0MF,wBAAsB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA2BD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAcxF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAClD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,aAAa,CAAC,CAc9B"}

package/dist/client.js

@@ -57,6 +57,19 @@ function createReplySender(ws, agentId, conversationId, messageId) {
                 sequence,
             }));
         },
+        activity(activity) {
+            ws.send(JSON.stringify({
+                type: "agent.activity",
+                agentId,
+                conversationId,
+                messageId,
+                activityType: activity.activityType,
+                tool: activity.tool,
+                label: activity.label,
+                emoji: activity.emoji,
+                sequence: activity.sequence,
+            }));
+        },
         complete(text, sequence) {
             ws.send(JSON.stringify({
                 type: "agent.message",

package/dist/constants.d.ts

@@ -4,5 +4,8 @@ export declare const DEFAULT_CLEOS_CONVEX_SITE_URL = "https://amicable-elephant-
 export declare const DEFAULT_HERMES_API_URL = "http://127.0.0.1:8642/v1/chat/completions";
 /** VPS one-line installer (served from public Convex HTTP). */
 export declare const DEFAULT_BRIDGE_INSTALL_URL = "https://amicable-elephant-407.convex.site/install-bridge.sh";
+/** VPS one-line updater (served from public Convex HTTP). */
+export declare const DEFAULT_BRIDGE_UPDATE_URL = "https://amicable-elephant-407.convex.site/update-bridge.sh";
 export declare function bridgeInstallCommand(code: string): string;
+export declare function bridgeUpdateCommand(): string;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,8CAA8C,CAAC;AAEzF,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,8CAA8C,CAAC;AAElF,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,gEACwB,CAAC;AAEhE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,8CAA8C,CAAC;AAEzF,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,8CAA8C,CAAC;AAElF,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,gEACwB,CAAC;AAEhE,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,+DACwB,CAAC;AAE/D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/constants.js

@@ -4,6 +4,11 @@ export const DEFAULT_CLEOS_CONVEX_SITE_URL = "https://amicable-elephant-407.conv
 export const DEFAULT_HERMES_API_URL = "http://127.0.0.1:8642/v1/chat/completions";
 /** VPS one-line installer (served from public Convex HTTP). */
 export const DEFAULT_BRIDGE_INSTALL_URL = "https://amicable-elephant-407.convex.site/install-bridge.sh";
+/** VPS one-line updater (served from public Convex HTTP). */
+export const DEFAULT_BRIDGE_UPDATE_URL = "https://amicable-elephant-407.convex.site/update-bridge.sh";
 export function bridgeInstallCommand(code) {
     return `curl -fsSL ${DEFAULT_BRIDGE_INSTALL_URL} | bash -s -- ${code}`;
 }
+export function bridgeUpdateCommand() {
+    return `curl -fsSL ${DEFAULT_BRIDGE_UPDATE_URL} | bash`;
+}

package/dist/hermesForwarder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesForwarder.d.ts","sourceRoot":"","sources":["../src/hermesForwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAyB,eAAe,EAAE,MAAM,aAAa,CAAC;AAGtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAkBF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AA2ED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,sBAA2B,IAC/D,SAAS,MAAM,EAAE,MAAM,eAAe,EAAE,OAAO,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC,CAMxF"}
+{"version":3,"file":"hermesForwarder.d.ts","sourceRoot":"","sources":["../src/hermesForwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAyB,eAAe,EAAE,MAAM,aAAa,CAAC;AAGtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAkBF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AAyID,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,sBAA2B,IAC/D,SAAS,MAAM,EAAE,MAAM,eAAe,EAAE,OAAO,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC,CAMxF"}

package/dist/hermesForwarder.js

@@ -64,6 +64,52 @@ function extractDeltaFromChunk(payload) {
     const content = delta.content;
     return typeof content === "string" ? content : null;
 }
+function processSseEventBlock(eventBlock, reply, counters, onTextDelta) {
+    let eventName = "message";
+    for (const line of eventBlock.split("\n")) {
+        if (line.startsWith("event:")) {
+            eventName = line.slice(6).trim();
+            continue;
+        }
+        if (!line.startsWith("data:"))
+            continue;
+        const data = line.slice(5).trim();
+        if (!data || data === "[DONE]")
+            continue;
+        if (eventName === "hermes.tool.progress") {
+            try {
+                const payload = JSON.parse(data);
+                const tool = typeof payload.tool === "string" ? payload.tool : undefined;
+                const label = typeof payload.label === "string" ? payload.label : undefined;
+                const emoji = typeof payload.emoji === "string" ? payload.emoji : undefined;
+                reply.activity({
+                    activityType: "tool.started",
+                    tool,
+                    label,
+                    emoji,
+                    sequence: counters.activitySequence,
+                });
+                counters.activitySequence += 1;
+            }
+            catch {
+                // Ignore malformed tool progress payloads.
+            }
+            continue;
+        }
+        try {
+            const payload = JSON.parse(data);
+            const delta = extractDeltaFromChunk(payload);
+            if (delta) {
+                onTextDelta(delta);
+                reply.delta(delta, counters.textSequence);
+                counters.textSequence += 1;
+            }
+        }
+        catch {
+            // Ignore malformed SSE chunks.
+        }
+    }
+}
 function buildHermesUserContent(text, attachments) {
     const trimmed = text.trim();
     const imageParts = (attachments ?? [])
@@ -121,7 +167,7 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
     const reader = response.body.getReader();
     const decoder = new TextDecoder();
     let buffer = "";
-    let sequence = 0;
+    const counters = { textSequence: 0, activitySequence: 0 };
     let fullText = "";
     while (true) {
         const { done, value } = await reader.read();
@@ -130,34 +176,18 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
         buffer += decoder.decode(value, { stream: true });
         const { events, rest } = parseSseDataLines(buffer);
         buffer = rest;
-        for (const event of events) {
-            for (const line of event.split("\n")) {
-                if (!line.startsWith("data: "))
-                    continue;
-                const data = line.slice(6).trim();
-                if (!data || data === "[DONE]")
-                    continue;
-                try {
-                    const payload = JSON.parse(data);
-                    const delta = extractDeltaFromChunk(payload);
-                    if (delta) {
-                        fullText += delta;
-                        reply.delta(delta, sequence);
-                        sequence += 1;
-                    }
-                }
-                catch {
-                    // Ignore malformed SSE chunks.
-                }
-            }
+        for (const eventBlock of events) {
+            processSseEventBlock(eventBlock, reply, counters, (delta) => {
+                fullText += delta;
+            });
         }
     }
     if (!fullText.trim()) {
         fullText = "(Hermes returned an empty response)";
-        reply.delta(fullText, sequence);
-        sequence += 1;
+        reply.delta(fullText, counters.textSequence);
+        counters.textSequence += 1;
     }
-    reply.complete(fullText, sequence);
+    reply.complete(fullText, counters.textSequence);
 }
 export function createHermesMessageHandler(options = {}) {
     return async (content, meta, reply) => {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { connectHermesAgent, pairCleosAgent, reconnectHermesAgent } from "./client.js";
-export type { AgentReply, ConnectOptions, ConnectResult, CronDeliveryMeta, UserMessageMeta } from "./client.js";
+export type { AgentActivityPayload, AgentReply, ConnectOptions, ConnectResult, CronDeliveryMeta, UserMessageMeta, } from "./client.js";
 export { loadCredentials, saveCredentials, credentialsPathForDisplay } from "./credentials.js";
 export type { SavedAgentCredentials } from "./credentials.js";
 export { resolvePairingCode, convexSiteUrlFromEnv } from "./resolve.js";
@@ -11,5 +11,5 @@ export { startCronWatcher } from "./cronWatcher.js";
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
 export type { RunBridgeOptions } from "./daemon.js";
-export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, bridgeInstallCommand, } from "./constants.js";
+export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -6,4 +6,4 @@ export { createHermesMessageHandler, forwardToHermes, resolveHermesApiConfig } f
 export { startCronWatcher } from "./cronWatcher.js";
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
-export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, bridgeInstallCommand, } from "./constants.js";
+export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";

package/dist/update.d.ts

@@ -0,0 +1,8 @@
+export type RunBridgeUpdateOptions = {
+    /** npm dist-tag or semver, default `latest`. */
+    tag?: string;
+    /** Skip systemd / service restart after install. */
+    skipRestart?: boolean;
+};
+export declare function runBridgeUpdate(options?: RunBridgeUpdateOptions): void;
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,sBAAsB,GAAG;IACnC,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,IAAI,CAsC1E"}

package/dist/update.js

@@ -0,0 +1,80 @@
+import { execFileSync, spawnSync } from "node:child_process";
+import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { BRIDGE_PACKAGE, bridgeCliPath, readInstalledBridgeVersion, resolveBridgeInstallDir, } from "./bridgePaths.js";
+export function runBridgeUpdate(options = {}) {
+    const tag = options.tag ?? "latest";
+    const bridgeDir = resolveBridgeInstallDir();
+    const beforeVersion = readInstalledBridgeVersion(bridgeDir);
+    mkdirSync(bridgeDir, { recursive: true });
+    console.log(`Updating ${BRIDGE_PACKAGE}@${tag} in ${bridgeDir}...`);
+    const npm = spawnSync("npm", [
+        "install",
+        "--prefix",
+        bridgeDir,
+        `${BRIDGE_PACKAGE}@${tag}`,
+        "--no-fund",
+        "--no-audit",
+        "--omit=dev",
+    ], { stdio: "inherit", env: process.env });
+    if (npm.status !== 0) {
+        throw new Error("npm install failed");
+    }
+    const cliPath = bridgeCliPath(bridgeDir);
+    linkBridgeCli(cliPath);
+    const afterVersion = readInstalledBridgeVersion(bridgeDir);
+    if (beforeVersion && afterVersion && beforeVersion === afterVersion) {
+        console.log(`Already on ${afterVersion}.`);
+    }
+    else {
+        console.log(`Updated ${beforeVersion ?? "unknown"} → ${afterVersion ?? "unknown"}.`);
+    }
+    if (!options.skipRestart) {
+        restartBridgeService();
+    }
+}
+function linkBridgeCli(cliPath) {
+    const nodeBin = process.execPath;
+    const wrapper = `#!/usr/bin/env bash\nexec "${nodeBin}" "${cliPath}" "$@"\n`;
+    const targets = process.getuid?.() === 0
+        ? ["/usr/local/bin/cleos-bridge"]
+        : [join(homedir(), ".local", "bin", "cleos-bridge")];
+    for (const target of targets) {
+        try {
+            mkdirSync(join(target, ".."), { recursive: true });
+            writeFileSync(target, wrapper, { mode: 0o755 });
+            chmodSync(target, 0o755);
+            console.log(`Linked ${target}`);
+            return;
+        }
+        catch {
+            // try next target
+        }
+    }
+}
+function restartBridgeService() {
+    const unitExists = spawnSync("systemctl", ["cat", "cleos-bridge.service"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    if (unitExists.status !== 0) {
+        console.log("No cleos-bridge.service found. Restart manually if the bridge is running:");
+        console.log("  cleos-bridge start");
+        return;
+    }
+    console.log("Restarting cleos-bridge.service...");
+    let restart = spawnSync("systemctl", ["restart", "cleos-bridge.service"], { stdio: "inherit" });
+    if (restart.status === 0) {
+        console.log("cleos-bridge.service restarted.");
+        return;
+    }
+    try {
+        execFileSync("sudo", ["systemctl", "restart", "cleos-bridge.service"], { stdio: "inherit" });
+        console.log("cleos-bridge.service restarted (via sudo).");
+    }
+    catch {
+        console.log("Could not restart the service. Run:");
+        console.log("  sudo systemctl restart cleos-bridge");
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleso.innovations/bridge",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Connect your Hermes agent to the Cleos iOS app via pairing code.",
   "type": "module",
   "license": "MIT",