@saleso.innovations/bridge 0.1.27 → 0.1.28

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", "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", "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 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":"AAkBA,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGhG,eAAO,MAAM,oBAAoB,moBAqCvB,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,CA0NlB;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":"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"}

package/dist/hermesCommands.js

@@ -4,7 +4,7 @@ import { listHermesCronJobs } from "./cronList.js";
 import { listHermesSessions, listSessionMessages, countUserMessagesSent, getSessionUsage, resolveSessionTitles, } from "./hermesSessionDb.js";
 import { listHermesSkills } from "./skillsList.js";
 import { runHermesUpdate } from "./hermesUpdate.js";
-import { executeFilesList, executeFilesRead, executeFilesWrite, executeMemoriesList, } from "./hermesFileCommands.js";
+import { executeFilesList, executeFilesRead, executeFilesWrite, executeFilesDelete, executeMemoriesList, } from "./hermesFileCommands.js";
 import { executeShellExec, resetShellSession } from "./shellSession.js";
 import { fetchHermesRuntimeVersion } from "./runtimeVersion.js";
 export const HERMES_COMMAND_NAMES = [
@@ -41,6 +41,7 @@ export const HERMES_COMMAND_NAMES = [
     "files.list",
     "files.read",
     "files.write",
+    "files.delete",
     "memories.list",
     "shell.exec",
     "shell.session.reset",
@@ -342,6 +343,13 @@ export async function executeHermesCommand(command, args, options = {}) {
             }
             return await executeFilesWrite({ path, content });
         }
+        case "files.delete": {
+            const path = optionalString(args, "path");
+            if (!path) {
+                throw new HermesCommandError("invalid_command_args", 'Missing "path"');
+            }
+            return await executeFilesDelete({ path });
+        }
         case "memories.list":
             return await executeMemoriesList();
         case "shell.exec": {

package/dist/hermesFileCommands.d.ts

@@ -6,6 +6,10 @@ export declare function executeFilesWrite(args: Record<string, unknown>): Promis
     relativePath: string;
     size: number;
 }>;
+export declare function executeFilesDelete(args: Record<string, unknown>): Promise<{
+    ok: true;
+    deletedPath: string;
+}>;
 export declare function executeMemoriesList(): Promise<{
     files: import("./hermesFiles.js").HermesFileEntry[];
 }>;

package/dist/hermesFileCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesFileCommands.d.ts","sourceRoot":"","sources":["../src/hermesFileCommands.ts"],"names":[],"mappings":"AA+BA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GAKnE;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;GAUpE;AAED,wBAAsB,mBAAmB;;GAExC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;GAkCnE"}
+{"version":3,"file":"hermesFileCommands.d.ts","sourceRoot":"","sources":["../src/hermesFileCommands.ts"],"names":[],"mappings":"AAgCA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GAKnE;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;GAUpE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;GAMrE;AAED,wBAAsB,mBAAmB;;GAExC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;GAkCnE"}

package/dist/hermesFileCommands.js

@@ -1,4 +1,4 @@
-import { DEFAULT_FILES_READ_MAX_BYTES, listHermesFiles, listHermesMemoryFiles, readHermesFileBytes, writeHermesFile, } from "./hermesFiles.js";
+import { DEFAULT_FILES_READ_MAX_BYTES, deleteHermesFile, listHermesFiles, listHermesMemoryFiles, readHermesFileBytes, writeHermesFile, } from "./hermesFiles.js";
 import { uploadFileToConvex } from "./convexRelay.js";
 import { loadCredentials } from "./credentials.js";
 function optionalNumber(args, key) {
@@ -39,6 +39,13 @@ export async function executeFilesWrite(args) {
     }
     return writeHermesFile(path, content);
 }
+export async function executeFilesDelete(args) {
+    const path = typeof args.path === "string" ? args.path.trim() : "";
+    if (!path) {
+        throw new Error('Missing "path"');
+    }
+    return deleteHermesFile(path);
+}
 export async function executeMemoriesList() {
     return listHermesMemoryFiles();
 }

package/dist/hermesFiles.d.ts

@@ -2,6 +2,8 @@ export declare const MAX_RELAY_UPLOAD_BYTES: number;
 export declare const DEFAULT_FILES_READ_MAX_BYTES: number;
 export declare const SOUL_RELATIVE_PATH = "SOUL.md";
 export declare const MEMORIES_DIR = "memories";
+export declare const SKILLS_DIR = "skills";
+export declare const SKILL_FILE_NAME = "SKILL.md";
 export declare const MEMORY_MD_RELATIVE_PATH = "memories/MEMORY.md";
 export declare const USER_MD_RELATIVE_PATH = "memories/USER.md";
 export declare const MEMORY_MD_CHAR_LIMIT = 2200;
@@ -50,12 +52,17 @@ export declare function listHermesFiles(options?: {
     files: HermesFileEntry[];
 };
 export declare function normalizeHermesRelativePath(inputPath: string): string;
+export declare function isWritableSkillPath(relativePath: string): boolean;
 export declare function assertWritableHermesPath(inputPath: string): string;
 export declare function writeHermesFile(inputPath: string, content: string): {
     ok: true;
     relativePath: string;
     size: number;
 };
+export declare function deleteHermesFile(inputPath: string): {
+    ok: true;
+    deletedPath: string;
+};
 export declare function listHermesMemoryFiles(): {
     files: HermesFileEntry[];
 };

package/dist/hermesFiles.d.ts.map

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

package/dist/hermesFiles.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, statSync, writeFileSync, } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync, } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { loadHermesCronJobNames } from "./hermesCronJobs.js";
@@ -6,6 +6,8 @@ export const MAX_RELAY_UPLOAD_BYTES = 25 * 1024 * 1024;
 export const DEFAULT_FILES_READ_MAX_BYTES = 512 * 1024;
 export const SOUL_RELATIVE_PATH = "SOUL.md";
 export const MEMORIES_DIR = "memories";
+export const SKILLS_DIR = "skills";
+export const SKILL_FILE_NAME = "SKILL.md";
 export const MEMORY_MD_RELATIVE_PATH = "memories/MEMORY.md";
 export const USER_MD_RELATIVE_PATH = "memories/USER.md";
 export const MEMORY_MD_CHAR_LIMIT = 2200;
@@ -241,6 +243,15 @@ export function listHermesFiles(options = {}) {
 export function normalizeHermesRelativePath(inputPath) {
     return inputPath.trim().replace(/\\/g, "/").replace(/^\/+/, "");
 }
+export function isWritableSkillPath(relativePath) {
+    if (!relativePath.startsWith(`${SKILLS_DIR}/`)) {
+        return false;
+    }
+    if (relativePath.includes("..")) {
+        return false;
+    }
+    return relativePath.endsWith(`/${SKILL_FILE_NAME}`);
+}
 export function assertWritableHermesPath(inputPath) {
     const relativePath = normalizeHermesRelativePath(inputPath);
     if (!relativePath) {
@@ -249,6 +260,9 @@ export function assertWritableHermesPath(inputPath) {
     if (relativePath === SOUL_RELATIVE_PATH) {
         return relativePath;
     }
+    if (isWritableSkillPath(relativePath)) {
+        return relativePath;
+    }
     const memoriesPrefix = `${MEMORIES_DIR}/`;
     if (!relativePath.startsWith(memoriesPrefix)) {
         throw new Error(`Path is not writable: ${inputPath}`);
@@ -277,13 +291,30 @@ export function writeHermesFile(inputPath, content) {
     }
     const home = resolveHermesHome();
     const resolved = resolveSandboxedPath(relativePath);
-    if (relativePath.startsWith(`${MEMORIES_DIR}/`)) {
+    if (relativePath.startsWith(`${SKILLS_DIR}/`)) {
+        mkdirSync(dirname(resolved), { recursive: true });
+    }
+    else if (relativePath.startsWith(`${MEMORIES_DIR}/`)) {
         mkdirSync(join(home, MEMORIES_DIR), { recursive: true });
     }
     const bytes = Buffer.from(content, "utf8");
     writeFileSync(resolved, bytes);
     return { ok: true, relativePath, size: bytes.length };
 }
+export function deleteHermesFile(inputPath) {
+    const relativePath = normalizeHermesRelativePath(inputPath);
+    if (!isWritableSkillPath(relativePath)) {
+        throw new Error(`Path is not deletable: ${inputPath}`);
+    }
+    const resolved = resolveSandboxedPath(relativePath);
+    if (!existsSync(resolved)) {
+        throw new Error(`File not found: ${inputPath}`);
+    }
+    const skillDir = dirname(resolved);
+    const deletedPath = relativePath.slice(0, relativePath.length - `/${SKILL_FILE_NAME}`.length);
+    rmSync(skillDir, { recursive: true, force: true });
+    return { ok: true, deletedPath };
+}
 function memoryFileEntry(home, fileName) {
     const relativePath = `${MEMORIES_DIR}/${fileName}`;
     const fullPath = join(home, MEMORIES_DIR, fileName);

package/dist/hermesFiles.test.js

@@ -1,9 +1,9 @@
 import assert from "node:assert/strict";
-import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import test from "node:test";
-import { assertWritableHermesPath, cronOutputSourceKey, listHermesFiles, listHermesMemoryFiles, MEMORY_MD_CHAR_LIMIT, MEMORY_MD_RELATIVE_PATH, readHermesFileBytes, SOUL_RELATIVE_PATH, USER_MD_CHAR_LIMIT, writeHermesFile, } from "./hermesFiles.js";
+import { assertWritableHermesPath, cronOutputSourceKey, deleteHermesFile, listHermesFiles, listHermesMemoryFiles, MEMORY_MD_CHAR_LIMIT, MEMORY_MD_RELATIVE_PATH, readHermesFileBytes, SKILLS_DIR, SKILL_FILE_NAME, SOUL_RELATIVE_PATH, USER_MD_CHAR_LIMIT, writeHermesFile, } from "./hermesFiles.js";
 test("cronOutputSourceKey extracts jobId/filename from cron output paths", () => {
     assert.equal(cronOutputSourceKey("cron/output/abc123/2026-05-25_06-30-00.md"), "abc123/2026-05-25_06-30-00.md");
     assert.equal(cronOutputSourceKey("cache/documents/report.pdf"), undefined);
@@ -36,13 +36,38 @@ test("listHermesFiles includes cron output with source metadata", () => {
         }
     }
 });
-test("assertWritableHermesPath allows SOUL.md and memories markdown only", () => {
+test("assertWritableHermesPath allows SOUL.md, memories markdown, and skills", () => {
     assert.equal(assertWritableHermesPath("SOUL.md"), SOUL_RELATIVE_PATH);
     assert.equal(assertWritableHermesPath("memories/MEMORY.md"), MEMORY_MD_RELATIVE_PATH);
+    assert.equal(assertWritableHermesPath(`${SKILLS_DIR}/my-skill/${SKILL_FILE_NAME}`), `${SKILLS_DIR}/my-skill/${SKILL_FILE_NAME}`);
     assert.throws(() => assertWritableHermesPath("cron/output/x.md"));
     assert.throws(() => assertWritableHermesPath("memories/nested/x.md"));
+    assert.throws(() => assertWritableHermesPath(`${SKILLS_DIR}/my-skill/other.md`));
     assert.throws(() => assertWritableHermesPath("../SOUL.md"));
 });
+test("writeHermesFile creates skill directories and deleteHermesFile removes them", () => {
+    const home = mkdtempSync(join(tmpdir(), "hermes-skill-write-test-"));
+    const previousHome = process.env.HERMES_HOME;
+    process.env.HERMES_HOME = home;
+    try {
+        const skillPath = `${SKILLS_DIR}/demo-skill/${SKILL_FILE_NAME}`;
+        const content = "---\nname: demo-skill\ndescription: Demo\n---\n\n# Demo\n";
+        writeHermesFile(skillPath, content);
+        const written = readHermesFileBytes(skillPath);
+        assert.equal(written.bytes.toString("utf8"), content);
+        const result = deleteHermesFile(skillPath);
+        assert.equal(result.deletedPath, `${SKILLS_DIR}/demo-skill`);
+        assert.equal(existsSync(join(home, SKILLS_DIR, "demo-skill")), false);
+    }
+    finally {
+        if (previousHome === undefined) {
+            delete process.env.HERMES_HOME;
+        }
+        else {
+            process.env.HERMES_HOME = previousHome;
+        }
+    }
+});
 test("writeHermesFile enforces memory char limits and round-trips", () => {
     const home = mkdtempSync(join(tmpdir(), "hermes-write-test-"));
     const previousHome = process.env.HERMES_HOME;

package/dist/skillsList.d.ts

@@ -2,6 +2,7 @@ export type HermesSkillEntry = {
     name: string;
     description: string;
     category?: string;
+    relativePath?: string;
 };
 export declare function listHermesSkills(): Promise<{
     skills: HermesSkillEntry[];

package/dist/skillsList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillsList.d.ts","sourceRoot":"","sources":["../src/skillsList.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA4LF,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;AAuOF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAOhF"}

package/dist/skillsList.js

@@ -1,14 +1,17 @@
 import { execFile } from "node:child_process";
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { homedir } from "node:os";
 import { join, relative } from "node:path";
 import { promisify } from "node:util";
+import { resolveHermesHome } from "./hermesFiles.js";
 const execFileAsync = promisify(execFile);
-const HERMES_SKILLS_DIR = join(homedir(), ".hermes", "skills");
 const LIST_TIMEOUT_MS = 30_000;
 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 normalizeSkillsPayload(value) {
     if (Array.isArray(value)) {
         return { skills: value.flatMap((item) => parseSkillRecord(item)) };
@@ -33,11 +36,15 @@ function parseSkillRecord(value) {
         return [];
     }
     const description = pickString(record, ["description", "desc", "summary"]) ?? "";
-    const category = pickString(record, ["category", "path", "group"]);
+    const category = pickString(record, ["category", "group"]);
+    const relativePath = pickString(record, ["relativePath", "relative_path", "path"]);
     const entry = { name, description };
     if (category) {
         entry.category = category;
     }
+    if (relativePath && relativePath.endsWith(`/${SKILL_FILE_NAME}`)) {
+        entry.relativePath = relativePath.replace(/\\/g, "/");
+    }
     return [entry];
 }
 function pickString(record, keys) {
@@ -79,9 +86,9 @@ function parseFrontmatter(raw) {
     }
     return frontmatter;
 }
-function deriveCategory(skillsRoot, skillFilePath) {
+function deriveCategory(skillsRootDir, skillFilePath) {
     const skillDir = join(skillFilePath, "..");
-    const relativePath = relative(skillsRoot, skillDir);
+    const relativePath = relative(skillsRootDir, skillDir);
     if (!relativePath || relativePath === ".") {
         return undefined;
     }
@@ -91,8 +98,16 @@ function deriveCategory(skillsRoot, skillFilePath) {
     }
     return segments[0];
 }
+function skillLookupKey(skill) {
+    return `${skill.category ?? ""}\0${skill.name.toLowerCase()}`;
+}
+function toHermesRelativeSkillPath(skillsRootDir, skillFilePath) {
+    const fromSkillsDir = relative(skillsRootDir, skillFilePath).replace(/\\/g, "/");
+    return `${SKILLS_DIR}/${fromSkillsDir}`;
+}
 function readSkillsFromDirectory() {
-    if (!existsSync(HERMES_SKILLS_DIR)) {
+    const root = skillsRoot();
+    if (!existsSync(root)) {
         return { skills: [] };
     }
     const skills = [];
@@ -134,22 +149,26 @@ function readSkillsFromDirectory() {
                 continue;
             }
             const frontmatter = parseFrontmatter(raw);
-            const relativePath = relative(HERMES_SKILLS_DIR, join(fullPath, ".."));
-            const fallbackName = relativePath.split(/[/\\]/).filter(Boolean).pop() ?? relativePath;
+            const dirRelativePath = relative(root, join(fullPath, ".."));
+            const fallbackName = dirRelativePath.split(/[/\\]/).filter(Boolean).pop() ?? dirRelativePath;
             const name = frontmatter.name?.trim() || fallbackName;
             if (!name) {
                 continue;
             }
             const description = frontmatter.description?.trim() ?? "";
-            const category = deriveCategory(HERMES_SKILLS_DIR, fullPath);
-            const skill = { name, description };
+            const category = deriveCategory(root, fullPath);
+            const skill = {
+                name,
+                description,
+                relativePath: toHermesRelativeSkillPath(root, fullPath),
+            };
             if (category) {
                 skill.category = category;
             }
             skills.push(skill);
         }
     }
-    walk(HERMES_SKILLS_DIR);
+    walk(root);
     skills.sort((left, right) => {
         const categoryCompare = (left.category ?? "").localeCompare(right.category ?? "", undefined, {
             sensitivity: "base",
@@ -161,6 +180,25 @@ function readSkillsFromDirectory() {
     });
     return { skills };
 }
+function enrichSkillsWithFilesystemPaths(skills) {
+    const filesystemSkills = readSkillsFromDirectory();
+    const pathByKey = new Map();
+    for (const skill of filesystemSkills.skills) {
+        if (skill.relativePath) {
+            pathByKey.set(skillLookupKey(skill), skill.relativePath);
+        }
+    }
+    return skills.map((skill) => {
+        if (skill.relativePath) {
+            return skill;
+        }
+        const relativePath = pathByKey.get(skillLookupKey(skill));
+        if (!relativePath) {
+            return skill;
+        }
+        return { ...skill, relativePath };
+    });
+}
 async function runHermesSkillsListJson() {
     try {
         const { stdout } = await execFileAsync("hermes", ["skills", "list", "--json"], {
@@ -181,7 +219,7 @@ async function runHermesSkillsListJson() {
 export async function listHermesSkills() {
     const jsonResult = await runHermesSkillsListJson();
     if (jsonResult != null) {
-        return jsonResult;
+        return { skills: enrichSkillsWithFilesystemPaths(jsonResult.skills) };
     }
     return readSkillsFromDirectory();
 }

package/package.json

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