@saleso.innovations/bridge 0.1.42 → 0.1.43

package/dist/profiles.js

@@ -0,0 +1,409 @@
+import { execFile } from "node:child_process";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { DEFAULT_HERMES_API_URL } from "./constants.js";
+import { countSessions, hermesStateDbExists } from "./hermesSessionDb.js";
+import { listSkillsFromFilesystem } from "./skillsList.js";
+const execFileAsync = promisify(execFile);
+const PROFILE_TIMEOUT_MS = 30_000;
+const MAX_OUTPUT_BYTES = 10 * 1024 * 1024;
+/** Hermes default profile is the base home (`~/.hermes`) itself. */
+export const DEFAULT_PROFILE = "default";
+const PROFILE_NAME_PATTERN = /^[A-Za-z0-9._-]+$/;
+export class HermesProfileError extends Error {
+}
+export function isValidProfileName(name) {
+    if (name === "." || name === "..")
+        return false;
+    return PROFILE_NAME_PATTERN.test(name);
+}
+export function normalizeProfileName(profile) {
+    const trimmed = (profile ?? "").trim();
+    if (!trimmed || trimmed.toLowerCase() === DEFAULT_PROFILE)
+        return DEFAULT_PROFILE;
+    return trimmed;
+}
+export function isDefaultProfile(profile) {
+    return normalizeProfileName(profile) === DEFAULT_PROFILE;
+}
+/** Base Hermes home — the default profile's directory. */
+export function resolveBaseHermesHome() {
+    return process.env.HERMES_HOME?.trim() || join(homedir(), ".hermes");
+}
+export function profilesRootDir() {
+    return join(resolveBaseHermesHome(), "profiles");
+}
+/** Resolve the Hermes home directory for a given profile (default → base home). */
+export function resolveProfileHome(profile) {
+    const name = normalizeProfileName(profile);
+    if (name === DEFAULT_PROFILE)
+        return resolveBaseHermesHome();
+    return join(profilesRootDir(), name);
+}
+/** Build an env that scopes child `hermes` processes to the given profile. */
+export function profileEnv(profile) {
+    return { ...process.env, HERMES_HOME: resolveProfileHome(profile) };
+}
+function readEnvValue(home, key) {
+    try {
+        const contents = readFileSync(join(home, ".env"), "utf8");
+        for (const line of contents.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eq = trimmed.indexOf("=");
+            if (eq <= 0)
+                continue;
+            if (trimmed.slice(0, eq).trim() === key) {
+                return trimmed.slice(eq + 1).trim().replace(/^["']|["']$/g, "");
+            }
+        }
+    }
+    catch {
+        // Profile env file is optional.
+    }
+    return undefined;
+}
+function readConfigYaml(home) {
+    try {
+        return readFileSync(join(home, "config.yaml"), "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Best-effort parse of `model.default` from a profile's config.yaml. */
+export function readProfileModel(home) {
+    const yaml = readConfigYaml(home);
+    if (!yaml)
+        return undefined;
+    let inModelBlock = false;
+    for (const line of yaml.split(/\r?\n/)) {
+        const inline = line.match(/^model:\s*(\S.*)$/);
+        if (inline?.[1] && !inline[1].trim().startsWith("{")) {
+            return inline[1].trim().replace(/^["']|["']$/g, "");
+        }
+        if (/^model:\s*$/.test(line)) {
+            inModelBlock = true;
+            continue;
+        }
+        if (inModelBlock) {
+            if (/^\S/.test(line)) {
+                inModelBlock = false;
+            }
+            else {
+                const match = line.match(/^\s+default:\s*(.+?)\s*$/);
+                if (match?.[1])
+                    return match[1].trim().replace(/^["']|["']$/g, "");
+            }
+        }
+    }
+    return undefined;
+}
+function readGatewayPortFromConfig(home) {
+    const yaml = readConfigYaml(home);
+    if (!yaml)
+        return undefined;
+    let inSection = false;
+    for (const line of yaml.split(/\r?\n/)) {
+        if (/^(api_server|api|gateway|server):\s*$/.test(line)) {
+            inSection = true;
+            continue;
+        }
+        if (inSection) {
+            if (/^\S/.test(line)) {
+                inSection = false;
+            }
+            else {
+                const match = line.match(/^\s+port:\s*(\d+)/);
+                if (match?.[1])
+                    return Number(match[1]);
+            }
+        }
+    }
+    return undefined;
+}
+export function resolveProfileGatewayPort(profile) {
+    const home = resolveProfileHome(profile);
+    const fromEnv = readEnvValue(home, "API_SERVER_PORT");
+    if (fromEnv && /^\d+$/.test(fromEnv))
+        return Number(fromEnv);
+    return readGatewayPortFromConfig(home);
+}
+export function resolveProfileGatewayUrl(profile) {
+    if (isDefaultProfile(profile)) {
+        return process.env.HERMES_API_URL?.trim() || DEFAULT_HERMES_API_URL;
+    }
+    const port = resolveProfileGatewayPort(profile);
+    if (port)
+        return `http://127.0.0.1:${port}/v1/chat/completions`;
+    return DEFAULT_HERMES_API_URL;
+}
+export function resolveProfileContext(profile) {
+    const name = normalizeProfileName(profile);
+    const home = resolveProfileHome(name);
+    const apiKey = isDefaultProfile(name)
+        ? readEnvValue(home, "API_SERVER_KEY")
+        : readEnvValue(home, "API_SERVER_KEY");
+    return {
+        profile: name,
+        home,
+        apiUrl: resolveProfileGatewayUrl(name),
+        apiKey,
+        env: { ...process.env, HERMES_HOME: home },
+    };
+}
+async function gatewayHealthy(apiUrl, apiKey) {
+    const healthUrl = apiUrl.replace(/\/v1\/chat\/completions\/?$/, "/health");
+    const headers = {};
+    if (apiKey)
+        headers.authorization = `Bearer ${apiKey}`;
+    try {
+        const response = await fetch(healthUrl, { headers, signal: AbortSignal.timeout(2_000) });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function skillsCountForHome(home) {
+    try {
+        return listSkillsFromFilesystem(home).skills.length;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Cheap, sync enumeration of profile homes (default + on-disk profiles). */
+export function listProfileHomes() {
+    const homes = [{ profile: DEFAULT_PROFILE, home: resolveBaseHermesHome() }];
+    for (const name of discoverProfileNamesFromDisk()) {
+        homes.push({ profile: name, home: resolveProfileHome(name) });
+    }
+    return homes;
+}
+function discoverProfileNamesFromDisk() {
+    const root = profilesRootDir();
+    if (!existsSync(root))
+        return [];
+    try {
+        return readdirSync(root).filter((name) => {
+            if (name.startsWith("."))
+                return false;
+            try {
+                return statSync(join(root, name)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+async function listProfileNamesFromCli() {
+    try {
+        const { stdout } = await execFileAsync("hermes", ["profile", "list", "--json"], {
+            timeout: PROFILE_TIMEOUT_MS,
+            maxBuffer: MAX_OUTPUT_BYTES,
+            env: process.env,
+        });
+        const trimmed = stdout.trim();
+        if (!trimmed)
+            return null;
+        const parsed = JSON.parse(trimmed);
+        const rows = Array.isArray(parsed)
+            ? parsed
+            : parsed && typeof parsed === "object" && Array.isArray(parsed.profiles)
+                ? (parsed.profiles)
+                : [];
+        const out = [];
+        for (const row of rows) {
+            if (typeof row === "string") {
+                out.push({ name: row.trim(), active: false });
+            }
+            else if (row && typeof row === "object") {
+                const record = row;
+                const name = typeof record.name === "string" ? record.name.trim() : "";
+                if (name)
+                    out.push({ name, active: record.active === true || record.isActive === true });
+            }
+        }
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function listProfileNamesFromCliText() {
+    try {
+        const { stdout } = await execFileAsync("hermes", ["profile", "list"], {
+            timeout: PROFILE_TIMEOUT_MS,
+            maxBuffer: MAX_OUTPUT_BYTES,
+            env: process.env,
+        });
+        const out = [];
+        for (const rawLine of stdout.split(/\r?\n/)) {
+            const line = rawLine.trim();
+            if (!line)
+                continue;
+            const active = line.startsWith("*");
+            const name = line.replace(/^\*/, "").trim().split(/\s+/)[0] ?? "";
+            if (name && isValidProfileName(name))
+                out.push({ name, active });
+        }
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function listHermesProfiles() {
+    const cli = (await listProfileNamesFromCli()) ?? (await listProfileNamesFromCliText());
+    const names = new Map();
+    names.set(DEFAULT_PROFILE, false);
+    if (cli) {
+        for (const profile of cli)
+            names.set(normalizeProfileName(profile.name), profile.active);
+    }
+    else {
+        for (const name of discoverProfileNamesFromDisk())
+            names.set(name, false);
+    }
+    const entries = await Promise.all([...names.entries()].map(async ([name, active]) => {
+        const home = resolveProfileHome(name);
+        const apiUrl = resolveProfileGatewayUrl(name);
+        const apiKey = readEnvValue(home, "API_SERVER_KEY");
+        const [running] = await Promise.all([gatewayHealthy(apiUrl, apiKey)]);
+        return {
+            name,
+            isDefault: name === DEFAULT_PROFILE,
+            isActive: active,
+            model: readProfileModel(home),
+            gatewayRunning: running,
+            gatewayPort: resolveProfileGatewayPort(name),
+            skillsCount: skillsCountForHome(home),
+            sessionsCount: hermesStateDbExists(home) ? countSessions(home) : 0,
+            home,
+        };
+    }));
+    entries.sort((left, right) => {
+        if (left.isDefault !== right.isDefault)
+            return left.isDefault ? -1 : 1;
+        return left.name.localeCompare(right.name, undefined, { sensitivity: "base" });
+    });
+    return { profiles: entries };
+}
+function execFailureMessage(error, fallback) {
+    if (error && typeof error === "object") {
+        const record = error;
+        const stderr = record.stderr?.trim();
+        if (stderr)
+            return stderr;
+        const stdout = record.stdout?.trim();
+        if (stdout)
+            return stdout;
+        if (typeof record.message === "string" && record.message.trim())
+            return record.message.trim();
+    }
+    return fallback;
+}
+export async function createHermesProfile(name, options = {}) {
+    const trimmed = name.trim();
+    if (!isValidProfileName(trimmed)) {
+        throw new HermesProfileError(`Invalid profile name "${name}". Use letters, numbers, dot, dash or underscore.`);
+    }
+    if (normalizeProfileName(trimmed) === DEFAULT_PROFILE) {
+        throw new HermesProfileError('"default" is reserved for the base Hermes home.');
+    }
+    const args = ["profile", "create", trimmed];
+    if (options.clone)
+        args.push("--clone");
+    try {
+        await execFileAsync("hermes", args, {
+            timeout: PROFILE_TIMEOUT_MS,
+            maxBuffer: MAX_OUTPUT_BYTES,
+            env: process.env,
+        });
+        return { ok: true, name: trimmed };
+    }
+    catch (error) {
+        throw new HermesProfileError(execFailureMessage(error, "Could not create Hermes profile."));
+    }
+}
+export async function renameHermesProfile(oldName, newName) {
+    const from = oldName.trim();
+    const to = newName.trim();
+    if (normalizeProfileName(from) === DEFAULT_PROFILE) {
+        throw new HermesProfileError("The default profile cannot be renamed.");
+    }
+    if (!isValidProfileName(from)) {
+        throw new HermesProfileError(`Invalid profile name "${oldName}".`);
+    }
+    if (!isValidProfileName(to) || normalizeProfileName(to) === DEFAULT_PROFILE) {
+        throw new HermesProfileError(`Invalid new profile name "${newName}".`);
+    }
+    try {
+        await execFileAsync("hermes", ["profile", "rename", from, to], {
+            timeout: PROFILE_TIMEOUT_MS,
+            maxBuffer: MAX_OUTPUT_BYTES,
+            env: process.env,
+        });
+        return { ok: true, oldName: from, newName: to };
+    }
+    catch (error) {
+        throw new HermesProfileError(execFailureMessage(error, "Could not rename Hermes profile."));
+    }
+}
+export async function deleteHermesProfile(name) {
+    const trimmed = name.trim();
+    if (normalizeProfileName(trimmed) === DEFAULT_PROFILE) {
+        throw new HermesProfileError("The default profile cannot be deleted.");
+    }
+    if (!isValidProfileName(trimmed)) {
+        throw new HermesProfileError(`Invalid profile name "${name}".`);
+    }
+    try {
+        await execFileAsync("hermes", ["profile", "delete", trimmed, "--yes"], {
+            timeout: PROFILE_TIMEOUT_MS,
+            maxBuffer: MAX_OUTPUT_BYTES,
+            env: process.env,
+        });
+        return { ok: true, name: trimmed };
+    }
+    catch (error) {
+        // Some builds use `--force` instead of `--yes`; retry once without the flag.
+        try {
+            await execFileAsync("hermes", ["profile", "delete", trimmed], {
+                timeout: PROFILE_TIMEOUT_MS,
+                maxBuffer: MAX_OUTPUT_BYTES,
+                env: process.env,
+            });
+            return { ok: true, name: trimmed };
+        }
+        catch {
+            throw new HermesProfileError(execFailureMessage(error, "Could not delete Hermes profile."));
+        }
+    }
+}
+export async function setHermesProfileModel(profile, model) {
+    const name = normalizeProfileName(profile);
+    const trimmedModel = model.trim();
+    if (!trimmedModel) {
+        throw new HermesProfileError('Missing "model".');
+    }
+    try {
+        await execFileAsync("hermes", ["config", "set", "model.default", trimmedModel], {
+            timeout: PROFILE_TIMEOUT_MS,
+            maxBuffer: MAX_OUTPUT_BYTES,
+            env: profileEnv(name),
+        });
+        return { ok: true, profile: name, model: trimmedModel };
+    }
+    catch (error) {
+        throw new HermesProfileError(execFailureMessage(error, "Could not set the model for this profile."));
+    }
+}

package/dist/renameHermesSession.d.ts

@@ -3,5 +3,5 @@ export type RenameHermesSessionResult = {
     sessionId: string;
     title: string;
 };
-export declare function renameHermesSession(sessionId: string, title: string): Promise<RenameHermesSessionResult>;
+export declare function renameHermesSession(sessionId: string, title: string, env?: NodeJS.ProcessEnv): Promise<RenameHermesSessionResult>;
 //# sourceMappingURL=renameHermesSession.d.ts.map

package/dist/renameHermesSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renameHermesSession.d.ts","sourceRoot":"","sources":["../src/renameHermesSession.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAgBF,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,yBAAyB,CAAC,CAmBpC"}
+{"version":3,"file":"renameHermesSession.d.ts","sourceRoot":"","sources":["../src/renameHermesSession.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAgBF,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,yBAAyB,CAAC,CAmBpC"}

package/dist/renameHermesSession.js

@@ -17,7 +17,7 @@ function execFailureMessage(error) {
     }
     return "Could not rename Hermes session.";
 }
-export async function renameHermesSession(sessionId, title) {
+export async function renameHermesSession(sessionId, title, env = process.env) {
     const trimmedId = sessionId.trim();
     const trimmedTitle = title.trim().slice(0, 120);
     if (!trimmedId) {
@@ -29,7 +29,7 @@ export async function renameHermesSession(sessionId, title) {
     try {
         await execFileAsync("hermes", ["sessions", "rename", trimmedId, trimmedTitle], {
             timeout: RENAME_TIMEOUT_MS,
-            env: process.env,
+            env,
         });
         return { ok: true, sessionId: trimmedId, title: trimmedTitle };
     }

package/dist/skillLearnedDetector.d.ts

@@ -7,7 +7,7 @@ export type SkillSnapshotEntry = HermesSkillEntry & {
  * Captures the set of skills currently on disk, keyed by relative path, with each
  * file's mtime so a later diff can ignore writes that predate the turn.
  */
-export declare function snapshotSkills(): Map<string, SkillSnapshotEntry>;
+export declare function snapshotSkills(home?: string): Map<string, SkillSnapshotEntry>;
 /**
  * Returns skills present in `after` but not in `before` — i.e. newly written during the
  * turn. When `turnStartedAt` is provided, entries whose file mtime predates the turn

package/dist/skillLearnedDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillLearnedDetector.d.ts","sourceRoot":"","sources":["../src/skillLearnedDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElF,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAchE;AAKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACtC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAuBjD"}
+{"version":3,"file":"skillLearnedDetector.d.ts","sourceRoot":"","sources":["../src/skillLearnedDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElF,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAA4B,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAalG;AAKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACtC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAuBjD"}

package/dist/skillLearnedDetector.js

@@ -6,10 +6,9 @@ import { listSkillsFromFilesystem } from "./skillsList.js";
  * Captures the set of skills currently on disk, keyed by relative path, with each
  * file's mtime so a later diff can ignore writes that predate the turn.
  */
-export function snapshotSkills() {
-    const home = resolveHermesHome();
+export function snapshotSkills(home = resolveHermesHome()) {
     const snapshot = new Map();
-    for (const skill of listSkillsFromFilesystem().skills) {
+    for (const skill of listSkillsFromFilesystem(home).skills) {
         if (!skill.relativePath)
             continue;
         let mtimeMs;

package/dist/skillsList.d.ts

@@ -8,10 +8,13 @@ export type HermesSkillEntry = {
  * Synchronously reads the Hermes skills directory from disk. Used for fast turn-boundary
  * snapshots without shelling out to the `hermes` CLI.
  */
-export declare function listSkillsFromFilesystem(): {
+export declare function listSkillsFromFilesystem(home?: string): {
     skills: HermesSkillEntry[];
 };
-export declare function listHermesSkills(): Promise<{
+export declare function listHermesSkills(options?: {
+    home?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
     skills: HermesSkillEntry[];
 }>;
 //# sourceMappingURL=skillsList.d.ts.map

package/dist/skillsList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillsList.d.ts","sourceRoot":"","sources":["../src/skillsList.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA6GF;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAEzE;AA4HD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAOhF"}
+{"version":3,"file":"skillsList.d.ts","sourceRoot":"","sources":["../src/skillsList.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA6GF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAEtF;AA4HD,wBAAsB,gBAAgB,CACpC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACvD,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAOzC"}

package/dist/skillsList.js

@@ -9,8 +9,8 @@ const MAX_OUTPUT_BYTES = 10 * 1024 * 1024;
 const SKILL_FILE_NAME = "SKILL.md";
 const SKILLS_DIR = "skills";
 const HIDDEN_DIR_NAMES = new Set([".hub", ".git"]);
-function skillsRoot() {
-    return join(resolveHermesHome(), SKILLS_DIR);
+function skillsRoot(home = resolveHermesHome()) {
+    return join(home, SKILLS_DIR);
 }
 function normalizeSkillsPayload(value) {
     if (Array.isArray(value)) {
@@ -109,11 +109,11 @@ function toHermesRelativeSkillPath(skillsRootDir, skillFilePath) {
  * Synchronously reads the Hermes skills directory from disk. Used for fast turn-boundary
  * snapshots without shelling out to the `hermes` CLI.
  */
-export function listSkillsFromFilesystem() {
-    return readSkillsFromDirectory();
+export function listSkillsFromFilesystem(home) {
+    return readSkillsFromDirectory(home);
 }
-function readSkillsFromDirectory() {
-    const root = skillsRoot();
+function readSkillsFromDirectory(home) {
+    const root = skillsRoot(home);
     if (!existsSync(root)) {
         return { skills: [] };
     }
@@ -187,8 +187,8 @@ function readSkillsFromDirectory() {
     });
     return { skills };
 }
-function enrichSkillsWithFilesystemPaths(skills) {
-    const filesystemSkills = readSkillsFromDirectory();
+function enrichSkillsWithFilesystemPaths(skills, home) {
+    const filesystemSkills = readSkillsFromDirectory(home);
     const pathByKey = new Map();
     for (const skill of filesystemSkills.skills) {
         if (skill.relativePath) {
@@ -206,12 +206,12 @@ function enrichSkillsWithFilesystemPaths(skills) {
         return { ...skill, relativePath };
     });
 }
-async function runHermesSkillsListJson() {
+async function runHermesSkillsListJson(env = process.env) {
     try {
         const { stdout } = await execFileAsync("hermes", ["skills", "list", "--json"], {
             timeout: LIST_TIMEOUT_MS,
             maxBuffer: MAX_OUTPUT_BYTES,
-            env: process.env,
+            env,
         });
         const trimmed = stdout.trim();
         if (!trimmed) {
@@ -223,10 +223,10 @@ async function runHermesSkillsListJson() {
         return null;
     }
 }
-export async function listHermesSkills() {
-    const jsonResult = await runHermesSkillsListJson();
+export async function listHermesSkills(options = {}) {
+    const jsonResult = await runHermesSkillsListJson(options.env);
     if (jsonResult != null) {
-        return { skills: enrichSkillsWithFilesystemPaths(jsonResult.skills) };
+        return { skills: enrichSkillsWithFilesystemPaths(jsonResult.skills, options.home) };
     }
-    return readSkillsFromDirectory();
+    return readSkillsFromDirectory(options.home);
 }

package/dist/toolsList.d.ts

@@ -5,10 +5,10 @@ export type HermesToolEntry = {
     category?: string;
 };
 export declare function parseToolsListOutput(stdout: string): HermesToolEntry[];
-export declare function listHermesTools(platform?: string): Promise<{
+export declare function listHermesTools(platform?: string, env?: NodeJS.ProcessEnv): Promise<{
     tools: HermesToolEntry[];
 }>;
-export declare function setHermesToolEnabled(name: string, enabled: boolean): Promise<{
+export declare function setHermesToolEnabled(name: string, enabled: boolean, env?: NodeJS.ProcessEnv): Promise<{
     ok: true;
     name: string;
     enabled: boolean;

package/dist/toolsList.d.ts.map

@@ -1 +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"}
+{"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,EACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAYvC;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAQvD"}

package/dist/toolsList.js

@@ -64,21 +64,21 @@ export function parseToolsListOutput(stdout) {
     }
     return tools;
 }
-export async function listHermesTools(platform = DEFAULT_PLATFORM) {
+export async function listHermesTools(platform = DEFAULT_PLATFORM, env = process.env) {
     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,
+        env,
     });
     return { tools: parseToolsListOutput(stdout) };
 }
-export async function setHermesToolEnabled(name, enabled) {
+export async function setHermesToolEnabled(name, enabled, env = process.env) {
     const subcommand = enabled ? "enable" : "disable";
     await execFileAsync("hermes", ["tools", subcommand, name], {
         timeout: SET_TIMEOUT_MS,
         maxBuffer: MAX_OUTPUT_BYTES,
-        env: process.env,
+        env,
     });
     return { ok: true, name, enabled };
 }

package/package.json

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