@saleso.innovations/bridge 0.1.41 → 0.1.43

package/dist/hermesSessionDb.js

@@ -2,12 +2,16 @@ import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import Database from "better-sqlite3";
-function hermesStateDbPath() {
-    const home = process.env.HERMES_HOME?.trim() || join(homedir(), ".hermes");
-    return join(home, "state.db");
+import { unwrapHermesStructuredContent } from "./hermesStructuredContent.js";
+/** Default state-db home (the default profile). Kept local to avoid a cycle with profiles.ts. */
+function resolveStateHome(home) {
+    return home?.trim() || process.env.HERMES_HOME?.trim() || join(homedir(), ".hermes");
 }
-function openReadOnlyDb() {
-    const dbPath = hermesStateDbPath();
+function hermesStateDbPath(home) {
+    return join(resolveStateHome(home), "state.db");
+}
+function openReadOnlyDb(home) {
+    const dbPath = hermesStateDbPath(home);
     return new Database(dbPath, { readonly: true, fileMustExist: true });
 }
 function decodeMessageContent(raw) {
@@ -24,6 +28,9 @@ function decodeMessageContent(raw) {
                 .map((part) => part.text)
                 .join("\n");
         }
+        if (parsed && typeof parsed === "object") {
+            return unwrapHermesStructuredContent(raw);
+        }
     }
     catch {
         // Plain text content.
@@ -109,11 +116,11 @@ function sessionTitleFromFirstUserMessage(db, sessionId) {
 function sessionTitleForLookupId(db, sessionId) {
     return sessionTitleFromChain(db, sessionId) ?? sessionTitleFromFirstUserMessage(db, sessionId);
 }
-export function resolveSessionTitle(sessionId) {
-    if (!sessionId.trim() || !hermesStateDbExists()) {
+export function resolveSessionTitle(sessionId, home) {
+    if (!sessionId.trim() || !hermesStateDbExists(home)) {
         return null;
     }
-    const db = openReadOnlyDb();
+    const db = openReadOnlyDb(home);
     try {
         return sessionTitleForLookupId(db, sessionId);
     }
@@ -124,16 +131,16 @@ export function resolveSessionTitle(sessionId) {
         db.close();
     }
 }
-export function resolveSessionTitles(sessionIds) {
+export function resolveSessionTitles(sessionIds, home) {
     const uniqueIds = [...new Set(sessionIds.map((id) => id.trim()).filter(Boolean))];
     const titles = {};
     for (const sessionId of uniqueIds) {
         titles[sessionId] = null;
     }
-    if (uniqueIds.length === 0 || !hermesStateDbExists()) {
+    if (uniqueIds.length === 0 || !hermesStateDbExists(home)) {
         return titles;
     }
-    const db = openReadOnlyDb();
+    const db = openReadOnlyDb(home);
     try {
         for (const sessionId of uniqueIds) {
             titles[sessionId] = sessionTitleForLookupId(db, sessionId);
@@ -148,7 +155,7 @@ export function resolveSessionTitles(sessionIds) {
     return titles;
 }
 export function listSessionMessages(sessionId, options = {}) {
-    const db = openReadOnlyDb();
+    const db = openReadOnlyDb(options.home);
     try {
         const resolved = resolveResumeSessionId(db, sessionId);
         const chain = sessionAncestorChain(db, resolved);
@@ -181,8 +188,8 @@ export function listSessionMessages(sessionId, options = {}) {
         db.close();
     }
 }
-export function getLatestTurnMessageIds(sessionId) {
-    const db = openReadOnlyDb();
+export function getLatestTurnMessageIds(sessionId, home) {
+    const db = openReadOnlyDb(home);
     try {
         const resolved = resolveResumeSessionId(db, sessionId);
         const chain = sessionAncestorChain(db, resolved);
@@ -245,12 +252,12 @@ function firstUserMessageContent(db, sessionId) {
     return decodeMessageContent(row?.content ?? null);
 }
 export function listHermesSessions(options = {}) {
-    if (!hermesStateDbExists()) {
+    if (!hermesStateDbExists(options.home)) {
         return [];
     }
     const limit = Math.min(Math.max(options.limit ?? 200, 1), 500);
     const fetchLimit = Math.min(limit * 4, 500);
-    const db = openReadOnlyDb();
+    const db = openReadOnlyDb(options.home);
     try {
         const rows = db
             .prepare(`SELECT
@@ -313,15 +320,15 @@ function emptySessionUsage(sessionId, resolvedSessionId) {
         messageCount: 0,
     };
 }
-export function getSessionUsage(sessionId) {
+export function getSessionUsage(sessionId, home) {
     const trimmed = sessionId.trim();
     if (!trimmed) {
         return emptySessionUsage(sessionId, sessionId);
     }
-    if (!hermesStateDbExists()) {
+    if (!hermesStateDbExists(home)) {
         return emptySessionUsage(trimmed, trimmed);
     }
-    const db = openReadOnlyDb();
+    const db = openReadOnlyDb(home);
     try {
         const resolved = resolveResumeSessionId(db, trimmed);
         const chain = sessionAncestorChain(db, resolved);
@@ -366,20 +373,20 @@ export function getSessionUsage(sessionId) {
         db.close();
     }
 }
-export function hermesStateDbExists() {
+export function hermesStateDbExists(home) {
     try {
-        readFileSync(hermesStateDbPath());
+        readFileSync(hermesStateDbPath(home));
         return true;
     }
     catch {
         return false;
     }
 }
-export function countUserMessagesSent() {
-    if (!hermesStateDbExists()) {
+export function countUserMessagesSent(home) {
+    if (!hermesStateDbExists(home)) {
         return { count: 0 };
     }
-    const db = openReadOnlyDb();
+    const db = openReadOnlyDb(home);
     try {
         const row = db
             .prepare("SELECT COUNT(*) AS count FROM messages WHERE role = 'user'")
@@ -393,3 +400,20 @@ export function countUserMessagesSent() {
         db.close();
     }
 }
+/** Total number of sessions in a profile's state.db (best-effort). */
+export function countSessions(home) {
+    if (!hermesStateDbExists(home)) {
+        return 0;
+    }
+    const db = openReadOnlyDb(home);
+    try {
+        const row = db.prepare("SELECT COUNT(*) AS count FROM sessions").get();
+        return row?.count ?? 0;
+    }
+    catch {
+        return 0;
+    }
+    finally {
+        db.close();
+    }
+}

package/dist/hermesStructuredContent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Keep in sync with @repo/backend-types/src/hermesStructuredContent.ts
+ * (duplicated here so the published bridge package stays self-contained).
+ */
+export declare function isHermesStructuredContent(content: string): boolean;
+export declare function unwrapHermesStructuredContent(content: string): string;
+export declare function looksLikeHermesStructuredStream(text: string): boolean;
+//# sourceMappingURL=hermesStructuredContent.d.ts.map

package/dist/hermesStructuredContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermesStructuredContent.d.ts","sourceRoot":"","sources":["../src/hermesStructuredContent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0CH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE;AA6JD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIrE"}

package/dist/hermesStructuredContent.js

@@ -0,0 +1,197 @@
+/**
+ * Keep in sync with @repo/backend-types/src/hermesStructuredContent.ts
+ * (duplicated here so the published bridge package stays self-contained).
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function stringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((entry) => typeof entry === "string");
+}
+function stringMatrix(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((row) => Array.isArray(row))
+        .map((row) => row.filter((cell) => typeof cell === "string"));
+}
+function parseHermesStructuredRoot(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("{"))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(parsed) || typeof parsed.component !== "string") {
+        return null;
+    }
+    return parsed;
+}
+export function isHermesStructuredContent(content) {
+    return parseHermesStructuredRoot(content) !== null;
+}
+function hermesChildren(node) {
+    const children = node.children;
+    if (!Array.isArray(children))
+        return [];
+    return children.filter(isRecord);
+}
+function joinBlocks(blocks) {
+    return blocks
+        .map((block) => block.trim())
+        .filter((block) => block.length > 0)
+        .join("\n\n");
+}
+function markdownTable(headers, rows) {
+    if (headers.length === 0)
+        return "";
+    const separator = headers.map(() => "---");
+    const body = rows.map((row) => {
+        const cells = headers.map((_, index) => row[index] ?? "");
+        return `| ${cells.join(" | ")} |`;
+    });
+    return joinBlocks([
+        `| ${headers.join(" | ")} |`,
+        `| ${separator.join(" | ")} |`,
+        ...body,
+    ]);
+}
+function nodeToPlainText(node) {
+    const component = node.component;
+    if (typeof component !== "string")
+        return "";
+    switch (component) {
+        case "root":
+            return joinBlocks(hermesChildren(node).map(nodeToPlainText));
+        case "text":
+            return asString(node.text) ?? "";
+        case "heading": {
+            const text = asString(node.text);
+            if (!text)
+                return "";
+            const level = node.level === 3 ? 3 : 2;
+            return `${"#".repeat(level)} ${text}`;
+        }
+        case "table": {
+            const headers = stringArray(node.headers).length > 0
+                ? stringArray(node.headers)
+                : stringArray(node.columns);
+            const rows = stringMatrix(node.rows);
+            if (headers.length === 0)
+                return "";
+            const caption = asString(node.caption);
+            const table = markdownTable(headers, rows);
+            return caption ? joinBlocks([caption, table]) : table;
+        }
+        case "list": {
+            const items = stringArray(node.items);
+            if (items.length === 0)
+                return "";
+            const style = node.style === "numbered" ? "numbered" : "bullet";
+            return items
+                .map((item, index) => (style === "numbered" ? `${index + 1}. ${item}` : `- ${item}`))
+                .join("\n");
+        }
+        case "code": {
+            const content = asString(node.content) ?? "";
+            const language = asString(node.language) ?? "";
+            return `\`\`\`${language}\n${content}\n\`\`\``;
+        }
+        case "link": {
+            const label = asString(node.label);
+            const url = asString(node.url);
+            if (label && url)
+                return `${label}: ${url}`;
+            return label ?? url ?? "";
+        }
+        case "key_value":
+        case "stat_cards": {
+            const items = Array.isArray(node.items) ? node.items.filter(isRecord) : [];
+            return joinBlocks(items.map((item) => {
+                const label = asString(item.label);
+                const value = asString(item.value);
+                if (!label || !value)
+                    return "";
+                const hint = asString(item.hint);
+                return hint ? `${label}: ${value} (${hint})` : `${label}: ${value}`;
+            }));
+        }
+        case "callout": {
+            const title = asString(node.title);
+            const body = asString(node.body) ?? "";
+            return joinBlocks([title, body].filter((part) => Boolean(part)));
+        }
+        case "choice": {
+            const prompt = asString(node.prompt) ?? "";
+            const options = Array.isArray(node.options) ? node.options.filter(isRecord) : [];
+            const optionLines = options
+                .map((option) => asString(option.label) ?? asString(option.id))
+                .filter((label) => Boolean(label))
+                .map((label) => `- ${label}`);
+            return joinBlocks([prompt, optionLines.join("\n")]);
+        }
+        case "yes_no":
+            return asString(node.prompt) ?? "";
+        case "suggestions": {
+            const items = Array.isArray(node.items) ? node.items.filter(isRecord) : [];
+            return items
+                .map((item) => asString(item.label) ?? asString(item.id))
+                .filter((label) => Boolean(label))
+                .map((label) => `- ${label}`)
+                .join("\n");
+        }
+        case "button_row": {
+            const buttons = Array.isArray(node.buttons) ? node.buttons.filter(isRecord) : [];
+            return buttons
+                .map((button) => asString(button.label) ?? asString(button.id))
+                .filter((label) => Boolean(label))
+                .join(" · ");
+        }
+        case "chart": {
+            const title = asString(node.title);
+            const labels = stringArray(node.labels);
+            const values = Array.isArray(node.values)
+                ? node.values.map((value) => (typeof value === "number" ? String(value) : String(value ?? "")))
+                : [];
+            const series = labels
+                .map((label, index) => {
+                const value = values[index];
+                return value ? `${label}: ${value}` : label;
+            })
+                .join("\n");
+            return joinBlocks([title, series].filter((part) => Boolean(part)));
+        }
+        default: {
+            const text = asString(node.text) ?? asString(node.body) ?? asString(node.content);
+            if (text)
+                return text;
+            const children = hermesChildren(node);
+            if (children.length > 0) {
+                return joinBlocks(children.map(nodeToPlainText));
+            }
+            return "";
+        }
+    }
+}
+export function unwrapHermesStructuredContent(content) {
+    const root = parseHermesStructuredRoot(content);
+    if (!root)
+        return content;
+    const plain = nodeToPlainText(root).trim();
+    return plain.length > 0 ? plain : content;
+}
+export function looksLikeHermesStructuredStream(text) {
+    const trimmed = text.trimStart();
+    if (!trimmed.startsWith("{"))
+        return false;
+    return /^\{\s*"component"\s*:/.test(trimmed);
+}

package/dist/hermesStructuredContent.test.d.ts

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

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

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

package/dist/hermesStructuredContent.test.js

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { isHermesStructuredContent, looksLikeHermesStructuredStream, unwrapHermesStructuredContent, } from "./hermesStructuredContent.js";
+test("unwrapHermesStructuredContent extracts simple text block", () => {
+    const input = JSON.stringify({
+        component: "root",
+        children: [{ component: "text", text: "Det går fint! Hvordan står det til med deg?" }],
+    });
+    assert.equal(isHermesStructuredContent(input), true);
+    assert.equal(unwrapHermesStructuredContent(input), "Det går fint! Hvordan står det til med deg?");
+});
+test("looksLikeHermesStructuredStream detects early JSON envelope", () => {
+    assert.equal(looksLikeHermesStructuredStream('{"component":"root"'), true);
+    assert.equal(looksLikeHermesStructuredStream("Hello"), false);
+});

package/dist/index.d.ts

@@ -19,5 +19,7 @@ export { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfil
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
 export type { RunBridgeOptions } from "./daemon.js";
-export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, HERMES_SESSIONS_LIST_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
+export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, HERMES_SESSIONS_LIST_CAPABILITY, HERMES_PROFILES_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
+export { DEFAULT_PROFILE, isValidProfileName, listHermesProfiles, normalizeProfileName, resolveProfileContext, resolveProfileHome, } from "./profiles.js";
+export type { HermesProfileContext, HermesProfileEntry } from "./profiles.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,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"}
+{"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,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -10,4 +10,5 @@ export { startCronWatcher, listPendingCronFiles, clearDeliveredIndex } from "./c
 export { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfill.js";
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
-export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, HERMES_SESSIONS_LIST_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
+export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, HERMES_SESSIONS_LIST_CAPABILITY, HERMES_PROFILES_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
+export { DEFAULT_PROFILE, isValidProfileName, listHermesProfiles, normalizeProfileName, resolveProfileContext, resolveProfileHome, } from "./profiles.js";

package/dist/mcpList.d.ts

@@ -6,17 +6,18 @@ export type HermesMcpServerEntry = {
     enabled: boolean;
 };
 export declare function parseMcpListOutput(stdout: string): HermesMcpServerEntry[];
-export declare function listHermesMcpServers(): Promise<{
+export declare function listHermesMcpServers(env?: NodeJS.ProcessEnv): Promise<{
     servers: HermesMcpServerEntry[];
 }>;
 export declare function addHermesMcpServer(input: {
     name?: string;
     json: string;
+    env?: NodeJS.ProcessEnv;
 }): Promise<{
     ok: true;
     name: string;
 }>;
-export declare function removeHermesMcpServer(name: string): Promise<{
+export declare function removeHermesMcpServer(name: string, env?: NodeJS.ProcessEnv): Promise<{
     ok: true;
     name: string;
 }>;

package/dist/mcpList.d.ts.map

@@ -1 +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"}
+{"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,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC;IAAE,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAAC,CAgB9C;AAuLD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYtC;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAOrC"}

package/dist/mcpList.js

@@ -85,12 +85,12 @@ export function parseMcpListOutput(stdout) {
     }
     return servers;
 }
-export async function listHermesMcpServers() {
+export async function listHermesMcpServers(env = process.env) {
     try {
         const { stdout } = await execFileAsync("hermes", ["mcp", "list"], {
             timeout: LIST_TIMEOUT_MS,
             maxBuffer: MAX_OUTPUT_BYTES,
-            env: process.env,
+            env,
         });
         return { servers: parseMcpListOutput(stdout) };
     }
@@ -261,15 +261,15 @@ export async function addHermesMcpServer(input) {
     await execFileAsync("hermes", argv, {
         timeout: ADD_TIMEOUT_MS,
         maxBuffer: MAX_OUTPUT_BYTES,
-        env: process.env,
+        env: input.env ?? process.env,
     });
     return { ok: true, name: normalized.name };
 }
-export async function removeHermesMcpServer(name) {
+export async function removeHermesMcpServer(name, env = process.env) {
     await execFileAsync("hermes", ["mcp", "remove", name], {
         timeout: REMOVE_TIMEOUT_MS,
         maxBuffer: MAX_OUTPUT_BYTES,
-        env: process.env,
+        env,
     });
     return { ok: true, name };
 }

package/dist/profiles.d.ts

@@ -0,0 +1,66 @@
+/** Hermes default profile is the base home (`~/.hermes`) itself. */
+export declare const DEFAULT_PROFILE = "default";
+export declare class HermesProfileError extends Error {
+}
+export declare function isValidProfileName(name: string): boolean;
+export declare function normalizeProfileName(profile?: string | null): string;
+export declare function isDefaultProfile(profile?: string | null): boolean;
+/** Base Hermes home — the default profile's directory. */
+export declare function resolveBaseHermesHome(): string;
+export declare function profilesRootDir(): string;
+/** Resolve the Hermes home directory for a given profile (default → base home). */
+export declare function resolveProfileHome(profile?: string | null): string;
+/** Build an env that scopes child `hermes` processes to the given profile. */
+export declare function profileEnv(profile?: string | null): NodeJS.ProcessEnv;
+/** Best-effort parse of `model.default` from a profile's config.yaml. */
+export declare function readProfileModel(home: string): string | undefined;
+export declare function resolveProfileGatewayPort(profile?: string | null): number | undefined;
+export declare function resolveProfileGatewayUrl(profile?: string | null): string;
+export type HermesProfileContext = {
+    profile: string;
+    home: string;
+    apiUrl: string;
+    apiKey: string | undefined;
+    env: NodeJS.ProcessEnv;
+};
+export declare function resolveProfileContext(profile?: string | null): HermesProfileContext;
+export type HermesProfileEntry = {
+    name: string;
+    isDefault: boolean;
+    isActive: boolean;
+    model?: string;
+    gatewayRunning: boolean;
+    gatewayPort?: number;
+    skillsCount: number;
+    sessionsCount: number;
+    home: string;
+};
+/** Cheap, sync enumeration of profile homes (default + on-disk profiles). */
+export declare function listProfileHomes(): {
+    profile: string;
+    home: string;
+}[];
+export declare function listHermesProfiles(): Promise<{
+    profiles: HermesProfileEntry[];
+}>;
+export declare function createHermesProfile(name: string, options?: {
+    clone?: boolean;
+}): Promise<{
+    ok: true;
+    name: string;
+}>;
+export declare function renameHermesProfile(oldName: string, newName: string): Promise<{
+    ok: true;
+    oldName: string;
+    newName: string;
+}>;
+export declare function deleteHermesProfile(name: string): Promise<{
+    ok: true;
+    name: string;
+}>;
+export declare function setHermesProfileModel(profile: string | undefined, model: string): Promise<{
+    ok: true;
+    profile: string;
+    model: string;
+}>;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/profiles.d.ts.map

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