@saleso.innovations/bridge 0.1.28 → 0.1.30

package/dist/bridgeVersion.d.ts

@@ -0,0 +1,10 @@
+export type BridgeRuntimeVersionInfo = {
+    installed: string | null;
+    latest: string | null;
+    updateAvailable: boolean | null;
+    checkError?: string;
+};
+export declare function fetchInstalledBridgeVersion(): string | null;
+export declare function fetchLatestBridgeVersionFromNpm(): Promise<string | null>;
+export declare function fetchBridgeRuntimeVersion(): Promise<BridgeRuntimeVersionInfo>;
+//# sourceMappingURL=bridgeVersion.d.ts.map

package/dist/bridgeVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeVersion.d.ts","sourceRoot":"","sources":["../src/bridgeVersion.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoB9E;AAiBD,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAsBnF"}

package/dist/bridgeVersion.js

@@ -0,0 +1,63 @@
+import { BRIDGE_PACKAGE, readInstalledBridgeVersion, resolveBridgeInstallDir } from "./bridgePaths.js";
+import { NPM_PUBLIC_REGISTRY } from "./constants.js";
+const LATEST_CHECK_TIMEOUT_MS = 30_000;
+export function fetchInstalledBridgeVersion() {
+    return readInstalledBridgeVersion(resolveBridgeInstallDir());
+}
+export async function fetchLatestBridgeVersionFromNpm() {
+    const url = `${NPM_PUBLIC_REGISTRY}${BRIDGE_PACKAGE.replace("/", "%2F")}`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), LATEST_CHECK_TIMEOUT_MS);
+    try {
+        const response = await fetch(url, {
+            headers: { accept: "application/vnd.npm.install-v1+json" },
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const body = (await response.json());
+        const latest = body["dist-tags"]?.latest;
+        return typeof latest === "string" && latest.trim().length > 0 ? latest.trim() : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function compareSemver(a, b) {
+    const parse = (value) => value
+        .split(".")
+        .map((part) => Number.parseInt(part, 10))
+        .map((part) => (Number.isFinite(part) ? part : 0));
+    const left = parse(a);
+    const right = parse(b);
+    for (let i = 0; i < Math.max(left.length, right.length); i++) {
+        const diff = (left[i] ?? 0) - (right[i] ?? 0);
+        if (diff !== 0)
+            return diff > 0 ? 1 : -1;
+    }
+    return 0;
+}
+export async function fetchBridgeRuntimeVersion() {
+    const installed = fetchInstalledBridgeVersion();
+    const latest = await fetchLatestBridgeVersionFromNpm();
+    if (latest === null) {
+        return {
+            installed,
+            latest: null,
+            updateAvailable: null,
+            checkError: "Could not reach the npm registry to check the latest cleos-bridge version.",
+        };
+    }
+    if (installed === null) {
+        return { installed: null, latest, updateAvailable: null };
+    }
+    return {
+        installed,
+        latest,
+        updateAvailable: compareSemver(installed, latest) < 0,
+    };
+}

package/dist/bridgeVersion.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bridgeVersion.test.d.ts.map

package/dist/bridgeVersion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeVersion.test.d.ts","sourceRoot":"","sources":["../src/bridgeVersion.test.ts"],"names":[],"mappings":""}

package/dist/bridgeVersion.test.js

@@ -0,0 +1,33 @@
+import assert from "node:assert/strict";
+import test, { afterEach } from "node:test";
+import { fetchBridgeRuntimeVersion, fetchLatestBridgeVersionFromNpm } from "./bridgeVersion.js";
+const realFetch = globalThis.fetch;
+function mockFetch(impl) {
+    globalThis.fetch = impl;
+}
+afterEach(() => {
+    globalThis.fetch = realFetch;
+});
+test("fetchLatestBridgeVersionFromNpm reads dist-tags.latest", async () => {
+    mockFetch(async () => new Response(JSON.stringify({ "dist-tags": { latest: "0.1.31" } }), { status: 200 }));
+    assert.equal(await fetchLatestBridgeVersionFromNpm(), "0.1.31");
+});
+test("fetchLatestBridgeVersionFromNpm returns null on non-200", async () => {
+    mockFetch(async () => new Response("nope", { status: 503 }));
+    assert.equal(await fetchLatestBridgeVersionFromNpm(), null);
+});
+test("fetchLatestBridgeVersionFromNpm returns null when fetch throws", async () => {
+    mockFetch(async () => {
+        throw new Error("network down");
+    });
+    assert.equal(await fetchLatestBridgeVersionFromNpm(), null);
+});
+test("fetchBridgeRuntimeVersion reports checkError when npm is unreachable", async () => {
+    mockFetch(async () => {
+        throw new Error("network down");
+    });
+    const info = await fetchBridgeRuntimeVersion();
+    assert.equal(info.latest, null);
+    assert.equal(info.updateAvailable, null);
+    assert.ok(info.checkError);
+});

package/dist/hermesCommands.d.ts

@@ -1,5 +1,5 @@
 import { type ShellDeltaEmitter } from "./shellSession.js";
-export declare const HERMES_COMMAND_NAMES: readonly ["runtime.health", "runtime.detailedHealth", "runtime.version", "runtime.capabilities", "models.list", "model.set", "responses.create", "runs.create", "runs.status", "runs.stop", "jobs.list", "jobs.get", "jobs.create", "jobs.update", "jobs.pause", "jobs.resume", "jobs.runNow", "jobs.delete", "profiles.list", "profiles.create", "gateway.start", "gateway.stop", "gateway.restart", "hermes.update", "sessions.messages.list", "sessions.messages.countSent", "sessions.titles.resolve", "sessions.usage.get", "sessions.list", "skills.list", "files.list", "files.read", "files.write", "files.delete", "memories.list", "shell.exec", "shell.session.reset"];
+export declare const HERMES_COMMAND_NAMES: readonly ["runtime.health", "runtime.detailedHealth", "runtime.version", "runtime.capabilities", "models.list", "model.set", "responses.create", "runs.create", "runs.status", "runs.stop", "jobs.list", "jobs.get", "jobs.create", "jobs.update", "jobs.pause", "jobs.resume", "jobs.runNow", "jobs.delete", "profiles.list", "profiles.create", "gateway.start", "gateway.stop", "gateway.restart", "hermes.update", "bridge.version", "bridge.update", "sessions.messages.list", "sessions.messages.countSent", "sessions.titles.resolve", "sessions.usage.get", "sessions.list", "skills.list", "tools.list", "tools.set", "mcp.list", "mcp.add", "mcp.remove", "files.list", "files.read", "files.write", "files.delete", "memories.list", "shell.exec", "shell.session.reset"];
 export type HermesCommandName = (typeof HERMES_COMMAND_NAMES)[number];
 export declare function isHermesCommandName(value: string): value is HermesCommandName;
 export type HermesCommandErrorCode = "command_unsupported" | "hermes_unreachable" | "hermes_request_failed" | "invalid_command_args" | "unsupported_by_http";

package/dist/hermesCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGhG,eAAO,MAAM,oBAAoB,mpBAsCvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAI1D;AA6GD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAAO,GAC9F,OAAO,CAAC,OAAO,CAAC,CAiOlB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAetG"}
+{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAMhG,eAAO,MAAM,oBAAoB,svBA6CvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAI1D;AAkID,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAAO,GAC9F,OAAO,CAAC,OAAO,CAAC,CAkQlB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAetG"}

package/dist/hermesCommands.js

@@ -3,10 +3,15 @@ import { restartHermesGateway, startHermesGateway, stopHermesGateway } from "./g
 import { listHermesCronJobs } from "./cronList.js";
 import { listHermesSessions, listSessionMessages, countUserMessagesSent, getSessionUsage, resolveSessionTitles, } from "./hermesSessionDb.js";
 import { listHermesSkills } from "./skillsList.js";
+import { listHermesTools, setHermesToolEnabled } from "./toolsList.js";
+import { addHermesMcpServer, listHermesMcpServers, removeHermesMcpServer } from "./mcpList.js";
 import { runHermesUpdate } from "./hermesUpdate.js";
 import { executeFilesList, executeFilesRead, executeFilesWrite, executeFilesDelete, executeMemoriesList, } from "./hermesFileCommands.js";
 import { executeShellExec, resetShellSession } from "./shellSession.js";
 import { fetchHermesRuntimeVersion } from "./runtimeVersion.js";
+import { fetchBridgeRuntimeVersion, fetchInstalledBridgeVersion } from "./bridgeVersion.js";
+import { runBridgeUpdate } from "./update.js";
+import { spawn } from "node:child_process";
 export const HERMES_COMMAND_NAMES = [
     "runtime.health",
     "runtime.detailedHealth",
@@ -32,12 +37,19 @@ export const HERMES_COMMAND_NAMES = [
     "gateway.stop",
     "gateway.restart",
     "hermes.update",
+    "bridge.version",
+    "bridge.update",
     "sessions.messages.list",
     "sessions.messages.countSent",
     "sessions.titles.resolve",
     "sessions.usage.get",
     "sessions.list",
     "skills.list",
+    "tools.list",
+    "tools.set",
+    "mcp.list",
+    "mcp.add",
+    "mcp.remove",
     "files.list",
     "files.read",
     "files.write",
@@ -143,6 +155,23 @@ async function hermesFetchVoid(config, path, init = {}) {
     await hermesFetchJson(config, path, init);
     return { ok: true };
 }
+/**
+ * Restart the cleos-bridge systemd service out-of-band so the freshly installed package is
+ * loaded. Detached + delayed so the in-flight `bridge.update` result can be flushed to the app
+ * before this process is replaced. No-op when the service unit is absent.
+ */
+function scheduleDetachedBridgeRestart() {
+    try {
+        const child = spawn("bash", [
+            "-c",
+            "sleep 3; systemctl restart cleos-bridge.service || sudo systemctl restart cleos-bridge.service",
+        ], { detached: true, stdio: "ignore" });
+        child.unref();
+    }
+    catch {
+        // Service not managed by systemd; the new package loads on the next manual restart.
+    }
+}
 export async function executeHermesCommand(command, args, options = {}) {
     const config = resolveHermesApiConfig(options);
     const { onDelta } = options;
@@ -300,6 +329,19 @@ export async function executeHermesCommand(command, args, options = {}) {
             const restartGateway = args.restartGateway === true || args.restart_gateway === true;
             return await runHermesUpdate({ restartGateway });
         }
+        case "bridge.version":
+            return await fetchBridgeRuntimeVersion();
+        case "bridge.update": {
+            const tag = optionalString(args, "tag") ?? "latest";
+            const before = fetchInstalledBridgeVersion();
+            // Install without restarting inline: restarting the service here would kill this
+            // process before the result reaches the app. We schedule a detached restart so the
+            // new package is picked up shortly after the result is delivered.
+            runBridgeUpdate({ tag, skipRestart: true });
+            const after = fetchInstalledBridgeVersion();
+            scheduleDetachedBridgeRestart();
+            return { ok: true, before, after };
+        }
         case "sessions.messages.list": {
             const sessionId = requireString(args, "sessionId");
             const limit = optionalNumber(args, "limit");
@@ -323,6 +365,26 @@ export async function executeHermesCommand(command, args, options = {}) {
         }
         case "skills.list":
             return await listHermesSkills();
+        case "tools.list": {
+            const platform = optionalString(args, "platform");
+            return await listHermesTools(platform);
+        }
+        case "tools.set": {
+            const name = requireString(args, "name");
+            const enabled = args.enabled === true;
+            return await setHermesToolEnabled(name, enabled);
+        }
+        case "mcp.list":
+            return await listHermesMcpServers();
+        case "mcp.add": {
+            const name = optionalString(args, "name");
+            const json = requireString(args, "json");
+            return await addHermesMcpServer({ name, json });
+        }
+        case "mcp.remove": {
+            const name = requireString(args, "name");
+            return await removeHermesMcpServer(name);
+        }
         case "files.list":
             return await executeFilesList(args);
         case "files.read": {

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export type { HermesSessionListEntry, HermesSessionUsage } from "./hermesSession
 export type { HermesSessionMessage } from "./hermesSessionDb.js";
 export { executeHermesCommand, HERMES_COMMAND_NAMES, isHermesCommandName, userSafeCommandError, } from "./hermesCommands.js";
 export type { HermesCommandErrorCode, HermesCommandName } from "./hermesCommands.js";
+export { fetchBridgeRuntimeVersion, fetchInstalledBridgeVersion, fetchLatestBridgeVersionFromNpm, } from "./bridgeVersion.js";
+export type { BridgeRuntimeVersionInfo } from "./bridgeVersion.js";
 export { startCronWatcher, listPendingCronFiles, clearDeliveredIndex } from "./cronWatcher.js";
 export { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfill.js";
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";

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,EACV,oBAAoB,EACpB,kBAAkB,EAClB,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,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACvF,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACtF,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,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,EAC/B,oBAAoB,EACpB,mBAAmB,GACpB,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,kBAAkB,EAClB,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,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACvF,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACtF,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,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,EAC/B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { pairWithCleos } from "./pairWithCleos.js";
 export { createHermesMessageHandler, forwardToHermes, resolveHermesApiConfig } from "./hermesForwarder.js";
 export { getSessionUsage, listHermesSessions, listSessionMessages, resolveSessionTitle, resolveSessionTitles, } from "./hermesSessionDb.js";
 export { executeHermesCommand, HERMES_COMMAND_NAMES, isHermesCommandName, userSafeCommandError, } from "./hermesCommands.js";
+export { fetchBridgeRuntimeVersion, fetchInstalledBridgeVersion, fetchLatestBridgeVersionFromNpm, } from "./bridgeVersion.js";
 export { startCronWatcher, listPendingCronFiles, clearDeliveredIndex } from "./cronWatcher.js";
 export { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfill.js";
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";

package/dist/mcpList.d.ts

@@ -0,0 +1,23 @@
+export type HermesMcpServerEntry = {
+    name: string;
+    transport?: string;
+    tools?: string;
+    status?: string;
+    enabled: boolean;
+};
+export declare function parseMcpListOutput(stdout: string): HermesMcpServerEntry[];
+export declare function listHermesMcpServers(): Promise<{
+    servers: HermesMcpServerEntry[];
+}>;
+export declare function addHermesMcpServer(input: {
+    name?: string;
+    json: string;
+}): Promise<{
+    ok: true;
+    name: string;
+}>;
+export declare function removeHermesMcpServer(name: string): Promise<{
+    ok: true;
+    name: string;
+}>;
+//# sourceMappingURL=mcpList.d.ts.map

package/dist/mcpList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpList.d.ts","sourceRoot":"","sources":["../src/mcpList.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAqBF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAwEzE;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAAC,CAgBzF;AAuLD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYtC;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAO7F"}

package/dist/mcpList.js

@@ -0,0 +1,275 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const LIST_TIMEOUT_MS = 30_000;
+const ADD_TIMEOUT_MS = 120_000;
+const REMOVE_TIMEOUT_MS = 30_000;
+const MAX_OUTPUT_BYTES = 10 * 1024 * 1024;
+const HEADER_KEYS = ["Name", "Transport", "Tools", "Status"];
+function isSeparatorLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+        return true;
+    }
+    return /^[\s─_=-]+$/u.test(trimmed);
+}
+function stripLeadingGlyph(value) {
+    const trimmed = value.trim();
+    const match = trimmed.match(/^([^\p{L}\p{N}]+)\s*(.*)$/u);
+    if (match && match[2] && match[2].trim().length > 0) {
+        return match[2].trim();
+    }
+    return trimmed;
+}
+export function parseMcpListOutput(stdout) {
+    const lines = stdout.split(/\r?\n/);
+    let headerIndex = -1;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        if (line.includes("Name") && line.includes("Status")) {
+            headerIndex = i;
+            break;
+        }
+    }
+    if (headerIndex < 0) {
+        return [];
+    }
+    const headerLine = lines[headerIndex] ?? "";
+    const columns = [];
+    for (const key of HEADER_KEYS) {
+        const start = headerLine.indexOf(key);
+        if (start >= 0) {
+            columns.push({ key, start });
+        }
+    }
+    columns.sort((a, b) => a.start - b.start);
+    if (columns.length === 0) {
+        return [];
+    }
+    const servers = [];
+    const seen = new Set();
+    for (let i = headerIndex + 1; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        if (isSeparatorLine(line)) {
+            continue;
+        }
+        const cells = {};
+        for (let c = 0; c < columns.length; c += 1) {
+            const column = columns[c];
+            if (!column) {
+                continue;
+            }
+            const end = c + 1 < columns.length ? columns[c + 1]?.start ?? line.length : line.length;
+            cells[column.key] = line.slice(column.start, end).trim();
+        }
+        const name = (cells.Name ?? "").trim();
+        if (name.length === 0 || seen.has(name)) {
+            continue;
+        }
+        const status = cells.Status ? stripLeadingGlyph(cells.Status) : undefined;
+        const entry = {
+            name,
+            enabled: (status ?? "").toLowerCase().includes("enabled") && !(status ?? "").toLowerCase().includes("disabled"),
+        };
+        if (cells.Transport && cells.Transport.length > 0) {
+            entry.transport = cells.Transport;
+        }
+        if (cells.Tools && cells.Tools.length > 0) {
+            entry.tools = cells.Tools;
+        }
+        if (status && status.length > 0) {
+            entry.status = status;
+        }
+        servers.push(entry);
+        seen.add(name);
+    }
+    return servers;
+}
+export async function listHermesMcpServers() {
+    try {
+        const { stdout } = await execFileAsync("hermes", ["mcp", "list"], {
+            timeout: LIST_TIMEOUT_MS,
+            maxBuffer: MAX_OUTPUT_BYTES,
+            env: process.env,
+        });
+        return { servers: parseMcpListOutput(stdout) };
+    }
+    catch (error) {
+        // `hermes mcp list` exits non-zero when no servers are configured on some builds.
+        const stdout = readExecStdout(error);
+        if (stdout != null) {
+            return { servers: parseMcpListOutput(stdout) };
+        }
+        throw error;
+    }
+}
+function readExecStdout(error) {
+    if (error && typeof error === "object" && "stdout" in error) {
+        const stdout = error.stdout;
+        if (typeof stdout === "string") {
+            return stdout;
+        }
+    }
+    return null;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const items = value
+        .filter((entry) => typeof entry === "string" || typeof entry === "number")
+        .map((entry) => String(entry));
+    return items;
+}
+function asStringRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const record = {};
+    for (const [key, raw] of Object.entries(value)) {
+        if (typeof raw === "string" || typeof raw === "number" || typeof raw === "boolean") {
+            record[key] = String(raw);
+        }
+    }
+    return Object.keys(record).length > 0 ? record : undefined;
+}
+function pickConfigString(record, keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "string") {
+            const trimmed = value.trim();
+            if (trimmed.length > 0) {
+                return trimmed;
+            }
+        }
+    }
+    return undefined;
+}
+function toConfig(value) {
+    const config = {};
+    const command = pickConfigString(value, ["command", "cmd"]);
+    if (command) {
+        config.command = command;
+    }
+    const args = asStringArray(value.args);
+    if (args && args.length > 0) {
+        config.args = args;
+    }
+    const env = asStringRecord(value.env);
+    if (env) {
+        config.env = env;
+    }
+    const url = pickConfigString(value, ["url", "endpoint"]);
+    if (url) {
+        config.url = url;
+    }
+    const auth = pickConfigString(value, ["auth"]);
+    if (auth === "oauth" || auth === "header") {
+        config.auth = auth;
+    }
+    const preset = pickConfigString(value, ["preset"]);
+    if (preset) {
+        config.preset = preset;
+    }
+    return config;
+}
+function looksLikeConfig(value) {
+    return (typeof value.command === "string" ||
+        typeof value.url === "string" ||
+        typeof value.preset === "string" ||
+        Array.isArray(value.args) ||
+        (typeof value.env === "object" && value.env != null));
+}
+function normalizeAddInput(name, json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new Error("MCP configuration is not valid JSON.");
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("MCP configuration must be a JSON object.");
+    }
+    const record = parsed;
+    // Shape 1: { "mcpServers": { name: cfg } }
+    const mcpServers = record.mcpServers ?? record.servers;
+    if (mcpServers && typeof mcpServers === "object" && !Array.isArray(mcpServers)) {
+        const entries = Object.entries(mcpServers);
+        const entry = entries[0];
+        if (entry && entry[1] && typeof entry[1] === "object") {
+            return {
+                name: (name && name.trim().length > 0 ? name.trim() : entry[0]).trim(),
+                config: toConfig(entry[1]),
+            };
+        }
+    }
+    // Shape 2: bare config object { command/url/args/env/... }
+    if (looksLikeConfig(record)) {
+        const resolvedName = (name ?? "").trim();
+        if (resolvedName.length === 0) {
+            throw new Error('Missing server "name".');
+        }
+        return { name: resolvedName, config: toConfig(record) };
+    }
+    // Shape 3: { name: cfg } single-entry map
+    const entries = Object.entries(record);
+    const entry = entries[0];
+    if (entries.length >= 1 && entry && entry[1] && typeof entry[1] === "object" && !Array.isArray(entry[1])) {
+        return {
+            name: (name && name.trim().length > 0 ? name.trim() : entry[0]).trim(),
+            config: toConfig(entry[1]),
+        };
+    }
+    throw new Error("Could not parse MCP server configuration from the provided JSON.");
+}
+function buildAddArgs(input) {
+    const { name, config } = input;
+    const argv = ["mcp", "add", name];
+    if (config.url) {
+        argv.push("--url", config.url);
+    }
+    if (config.command) {
+        argv.push("--command", config.command);
+    }
+    if (config.args && config.args.length > 0) {
+        argv.push("--args", ...config.args);
+    }
+    if (config.env) {
+        const envPairs = Object.entries(config.env).map(([key, value]) => `${key}=${value}`);
+        if (envPairs.length > 0) {
+            argv.push("--env", ...envPairs);
+        }
+    }
+    if (config.auth) {
+        argv.push("--auth", config.auth);
+    }
+    if (config.preset) {
+        argv.push("--preset", config.preset);
+    }
+    if (!config.url && !config.command && !config.preset) {
+        throw new Error('MCP configuration needs a "command", "url", or "preset".');
+    }
+    return argv;
+}
+export async function addHermesMcpServer(input) {
+    const normalized = normalizeAddInput(input.name, input.json);
+    if (normalized.name.length === 0) {
+        throw new Error('Missing server "name".');
+    }
+    const argv = buildAddArgs(normalized);
+    await execFileAsync("hermes", argv, {
+        timeout: ADD_TIMEOUT_MS,
+        maxBuffer: MAX_OUTPUT_BYTES,
+        env: process.env,
+    });
+    return { ok: true, name: normalized.name };
+}
+export async function removeHermesMcpServer(name) {
+    await execFileAsync("hermes", ["mcp", "remove", name], {
+        timeout: REMOVE_TIMEOUT_MS,
+        maxBuffer: MAX_OUTPUT_BYTES,
+        env: process.env,
+    });
+    return { ok: true, name };
+}

package/dist/toolsList.d.ts

@@ -0,0 +1,16 @@
+export type HermesToolEntry = {
+    name: string;
+    description: string;
+    enabled: boolean;
+    category?: string;
+};
+export declare function parseToolsListOutput(stdout: string): HermesToolEntry[];
+export declare function listHermesTools(platform?: string): Promise<{
+    tools: HermesToolEntry[];
+}>;
+export declare function setHermesToolEnabled(name: string, enabled: boolean): Promise<{
+    ok: true;
+    name: string;
+    enabled: boolean;
+}>;
+//# sourceMappingURL=toolsList.d.ts.map

package/dist/toolsList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolsList.d.ts","sourceRoot":"","sources":["../src/toolsList.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA+BF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAqCtE;AAED,wBAAsB,eAAe,CACnC,QAAQ,GAAE,MAAyB,GAClC,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAYvC;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAQvD"}

package/dist/toolsList.js

@@ -0,0 +1,84 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const LIST_TIMEOUT_MS = 30_000;
+const SET_TIMEOUT_MS = 30_000;
+const MAX_OUTPUT_BYTES = 10 * 1024 * 1024;
+const DEFAULT_PLATFORM = "cli";
+const ROW_PATTERN = /^\s*(?:✓|✗|×|x|☑|☒|•|-)?\s*(enabled|disabled)\b\s+(\S+)\s*(.*)$/i;
+function stripLeadingIcon(value) {
+    // Hermes prints an emoji/icon before the human label (e.g. "🔍 Web Search").
+    // Drop a single leading non-alphanumeric, non-ASCII glyph plus following spaces.
+    const trimmed = value.trim();
+    const match = trimmed.match(/^([^\p{L}\p{N}(]+)\s*(.*)$/u);
+    if (match && match[2] && match[2].trim().length > 0) {
+        return match[2].trim();
+    }
+    return trimmed;
+}
+function isSectionHeader(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    if (!trimmed.endsWith(":")) {
+        return undefined;
+    }
+    if (ROW_PATTERN.test(line)) {
+        return undefined;
+    }
+    // Normalize "Built-in toolsets (cli):" -> "Built-in toolsets".
+    const label = trimmed.replace(/:\s*$/, "").replace(/\s*\([^)]*\)\s*$/, "").trim();
+    return label.length > 0 ? label : undefined;
+}
+export function parseToolsListOutput(stdout) {
+    const tools = [];
+    const seen = new Set();
+    let currentCategory;
+    for (const rawLine of stdout.split(/\r?\n/)) {
+        const header = isSectionHeader(rawLine);
+        if (header) {
+            currentCategory = header;
+            continue;
+        }
+        const match = rawLine.match(ROW_PATTERN);
+        if (!match) {
+            continue;
+        }
+        const statusToken = (match[1] ?? "").toLowerCase();
+        const name = (match[2] ?? "").trim();
+        if (name.length === 0 || seen.has(name)) {
+            continue;
+        }
+        const description = stripLeadingIcon(match[3] ?? "");
+        const entry = {
+            name,
+            description,
+            enabled: statusToken === "enabled",
+        };
+        if (currentCategory) {
+            entry.category = currentCategory;
+        }
+        tools.push(entry);
+        seen.add(name);
+    }
+    return tools;
+}
+export async function listHermesTools(platform = DEFAULT_PLATFORM) {
+    const resolvedPlatform = platform.trim().length > 0 ? platform.trim() : DEFAULT_PLATFORM;
+    const { stdout } = await execFileAsync("hermes", ["tools", "list", "--platform", resolvedPlatform], {
+        timeout: LIST_TIMEOUT_MS,
+        maxBuffer: MAX_OUTPUT_BYTES,
+        env: process.env,
+    });
+    return { tools: parseToolsListOutput(stdout) };
+}
+export async function setHermesToolEnabled(name, enabled) {
+    const subcommand = enabled ? "enable" : "disable";
+    await execFileAsync("hermes", ["tools", subcommand, name], {
+        timeout: SET_TIMEOUT_MS,
+        maxBuffer: MAX_OUTPUT_BYTES,
+        env: process.env,
+    });
+    return { ok: true, name, enabled };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleso.innovations/bridge",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Connect your Hermes agent to the Cleos iOS app via pairing code.",
   "type": "module",
   "license": "MIT",
@@ -36,7 +36,7 @@
     "lint": "eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
     "prepublishOnly": "npm run build",
-    "test": "node --import tsx --test src/hermesFiles.test.ts src/hermesSessionDb.test.ts src/shellSession.test.ts"
+    "test": "node --import tsx --test src/hermesFiles.test.ts src/hermesSessionDb.test.ts src/shellSession.test.ts src/bridgeVersion.test.ts"
   },
   "dependencies": {
     "better-sqlite3": "^11.10.0",