@saleso.innovations/bridge 0.1.7 → 0.1.8

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/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/index.d.ts

@@ -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,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,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.8",
   "description": "Connect your Hermes agent to the Cleos iOS app via pairing code.",
   "type": "module",
   "license": "MIT",