@saleso.innovations/bridge 0.1.26 → 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.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":"AAiBA,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGhG,eAAO,MAAM,oBAAoB,6mBAoCvB,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,CAsNlB;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

@@ -1,10 +1,10 @@
 import { resolveHermesApiConfig } from "./hermesForwarder.js";
 import { restartHermesGateway, startHermesGateway, stopHermesGateway } from "./gatewayControl.js";
 import { listHermesCronJobs } from "./cronList.js";
-import { listHermesSessions, listSessionMessages, countUserMessagesSent, resolveSessionTitles, } from "./hermesSessionDb.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 = [
@@ -35,11 +35,13 @@ export const HERMES_COMMAND_NAMES = [
     "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",
@@ -311,6 +313,10 @@ export async function executeHermesCommand(command, args, options = {}) {
             const sessionIds = optionalStringArray(args, "sessionIds") ?? [];
             return { titles: resolveSessionTitles(sessionIds) };
         }
+        case "sessions.usage.get": {
+            const sessionId = requireString(args, "sessionId");
+            return getSessionUsage(sessionId);
+        }
         case "sessions.list": {
             const limit = optionalNumber(args, "limit");
             return { sessions: listHermesSessions({ limit: limit ?? 200 }) };
@@ -337,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/hermesSessionDb.d.ts

@@ -24,9 +24,24 @@ export type HermesSessionListEntry = {
     previewText: string;
     messageCount: number;
 };
+/** Hermes-injected prompts for cron runs and background skills — not user chat. */
+export declare function isAutomatedHermesSessionPrompt(content: string): boolean;
 export declare function listHermesSessions(options?: {
     limit?: number;
 }): HermesSessionListEntry[];
+export type HermesSessionUsage = {
+    sessionId: string;
+    resolvedSessionId: string;
+    model: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+    estimatedCostUsd: number | null;
+    messageCount: number;
+};
+export declare function getSessionUsage(sessionId: string): HermesSessionUsage;
 export declare function hermesStateDbExists(): boolean;
 export declare function countUserMessagesSent(): {
     count: number;

package/dist/hermesSessionDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesSessionDb.d.ts","sourceRoot":"","sources":["../src/hermesSessionDb.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAyIF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAapE;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAuBxF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACxE,oBAAoB,EAAE,CAwCxB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCzD;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,sBAAsB,EAAE,CAyD7F;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAED,wBAAgB,qBAAqB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAgBzD"}
+{"version":3,"file":"hermesSessionDb.d.ts","sourceRoot":"","sources":["../src/hermesSessionDb.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAyIF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAapE;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAuBxF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACxE,oBAAoB,EAAE,CAwCxB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCzD;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAMF,mFAAmF;AACnF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAqBvE;AAcD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,sBAAsB,EAAE,CAsE7F;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAiBF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAkErE;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAED,wBAAgB,qBAAqB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAgBzD"}

package/dist/hermesSessionDb.js

@@ -216,11 +216,40 @@ export function getLatestTurnMessageIds(sessionId) {
 function normalizeTimestampMs(value) {
     return value < 1_000_000_000_000 ? value * 1000 : value;
 }
+/** Hermes-injected prompts for cron runs and background skills — not user chat. */
+export function isAutomatedHermesSessionPrompt(content) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return false;
+    if (/\[IMPORTANT:[^\]]*scheduled cron job/i.test(trimmed)) {
+        return true;
+    }
+    if (/you are running as .* background skill/i.test(trimmed)) {
+        return true;
+    }
+    if (/^Cronjob Response:\s*.+\r?\n-+\r?\n/i.test(trimmed)) {
+        return true;
+    }
+    if (/^#\s*Cron Job:/im.test(trimmed) && /\bJob ID:\s*/im.test(trimmed)) {
+        return true;
+    }
+    return false;
+}
+function firstUserMessageContent(db, sessionId) {
+    const row = db
+        .prepare(`SELECT content FROM messages
+       WHERE session_id = ? AND role = 'user'
+       ORDER BY timestamp ASC, id ASC
+       LIMIT 1`)
+        .get(sessionId);
+    return decodeMessageContent(row?.content ?? null);
+}
 export function listHermesSessions(options = {}) {
     if (!hermesStateDbExists()) {
         return [];
     }
     const limit = Math.min(Math.max(options.limit ?? 200, 1), 500);
+    const fetchLimit = Math.min(limit * 4, 500);
     const db = openReadOnlyDb();
     try {
         const rows = db
@@ -235,8 +264,12 @@ export function listHermesSessions(options = {}) {
          GROUP BY s.id
          ORDER BY last_message_at DESC
          LIMIT ?`)
-            .all(limit);
-        return rows.map((row) => {
+            .all(fetchLimit);
+        const entries = [];
+        for (const row of rows) {
+            if (isAutomatedHermesSessionPrompt(firstUserMessageContent(db, row.id))) {
+                continue;
+            }
             const previewRow = db
                 .prepare(`SELECT content FROM messages
            WHERE session_id = ? AND role IN ('user', 'assistant')
@@ -245,15 +278,19 @@ export function listHermesSessions(options = {}) {
                 .get(row.id);
             const resolvedTitle = sessionTitleForLookupId(db, row.id);
             const previewText = decodeMessageContent(previewRow?.content ?? null).trim().slice(0, 120);
-            return {
+            entries.push({
                 id: row.id,
                 title: resolvedTitle ?? row.title?.trim() ?? null,
                 startedAt: normalizeTimestampMs(row.started_at ?? row.last_message_at),
                 lastMessageAt: normalizeTimestampMs(row.last_message_at),
                 previewText,
                 messageCount: row.message_count,
-            };
-        });
+            });
+            if (entries.length >= limit) {
+                break;
+            }
+        }
+        return entries;
     }
     catch {
         return [];
@@ -262,6 +299,73 @@ export function listHermesSessions(options = {}) {
         db.close();
     }
 }
+function emptySessionUsage(sessionId, resolvedSessionId) {
+    return {
+        sessionId,
+        resolvedSessionId,
+        model: null,
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheReadTokens: 0,
+        cacheWriteTokens: 0,
+        reasoningTokens: 0,
+        estimatedCostUsd: null,
+        messageCount: 0,
+    };
+}
+export function getSessionUsage(sessionId) {
+    const trimmed = sessionId.trim();
+    if (!trimmed) {
+        return emptySessionUsage(sessionId, sessionId);
+    }
+    if (!hermesStateDbExists()) {
+        return emptySessionUsage(trimmed, trimmed);
+    }
+    const db = openReadOnlyDb();
+    try {
+        const resolved = resolveResumeSessionId(db, trimmed);
+        const chain = sessionAncestorChain(db, resolved);
+        const placeholders = chain.map(() => "?").join(", ");
+        const totals = db
+            .prepare(`SELECT
+           COALESCE(SUM(input_tokens), 0) AS input_tokens,
+           COALESCE(SUM(output_tokens), 0) AS output_tokens,
+           COALESCE(SUM(cache_read_tokens), 0) AS cache_read_tokens,
+           COALESCE(SUM(cache_write_tokens), 0) AS cache_write_tokens,
+           COALESCE(SUM(reasoning_tokens), 0) AS reasoning_tokens,
+           COALESCE(SUM(estimated_cost_usd), 0) AS estimated_cost_usd,
+           COALESCE(SUM(message_count), 0) AS message_count
+         FROM sessions
+         WHERE id IN (${placeholders})`)
+            .get(...chain);
+        const modelRow = db
+            .prepare("SELECT model FROM sessions WHERE id = ?")
+            .get(resolved);
+        const model = modelRow?.model?.trim() || null;
+        const estimatedCost = totals?.estimated_cost_usd;
+        const estimatedCostUsd = estimatedCost != null && Number.isFinite(estimatedCost) && estimatedCost > 0
+            ? estimatedCost
+            : null;
+        return {
+            sessionId: trimmed,
+            resolvedSessionId: resolved,
+            model,
+            inputTokens: totals?.input_tokens ?? 0,
+            outputTokens: totals?.output_tokens ?? 0,
+            cacheReadTokens: totals?.cache_read_tokens ?? 0,
+            cacheWriteTokens: totals?.cache_write_tokens ?? 0,
+            reasoningTokens: totals?.reasoning_tokens ?? 0,
+            estimatedCostUsd,
+            messageCount: totals?.message_count ?? 0,
+        };
+    }
+    catch {
+        return emptySessionUsage(trimmed, trimmed);
+    }
+    finally {
+        db.close();
+    }
+}
 export function hermesStateDbExists() {
     try {
         readFileSync(hermesStateDbPath());

package/dist/hermesSessionDb.test.d.ts

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

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

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

package/dist/hermesSessionDb.test.js

@@ -0,0 +1,151 @@
+import assert from "node:assert/strict";
+import { mkdirSync, mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import Database from "better-sqlite3";
+import test from "node:test";
+import { getSessionUsage, isAutomatedHermesSessionPrompt } from "./hermesSessionDb.js";
+function withHermesStateDb(setup, run) {
+    const home = mkdtempSync(join(tmpdir(), "hermes-session-db-test-"));
+    const previousHome = process.env.HERMES_HOME;
+    process.env.HERMES_HOME = home;
+    try {
+        mkdirSync(home, { recursive: true });
+        const db = new Database(join(home, "state.db"));
+        db.exec(`
+      CREATE TABLE sessions (
+        id TEXT PRIMARY KEY,
+        source TEXT NOT NULL,
+        user_id TEXT,
+        model TEXT,
+        model_config TEXT,
+        system_prompt TEXT,
+        parent_session_id TEXT,
+        started_at REAL NOT NULL,
+        ended_at REAL,
+        end_reason TEXT,
+        message_count INTEGER DEFAULT 0,
+        tool_call_count INTEGER DEFAULT 0,
+        input_tokens INTEGER DEFAULT 0,
+        output_tokens INTEGER DEFAULT 0,
+        cache_read_tokens INTEGER DEFAULT 0,
+        cache_write_tokens INTEGER DEFAULT 0,
+        reasoning_tokens INTEGER DEFAULT 0,
+        estimated_cost_usd REAL,
+        FOREIGN KEY (parent_session_id) REFERENCES sessions(id)
+      );
+      CREATE TABLE messages (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id TEXT NOT NULL REFERENCES sessions(id),
+        role TEXT NOT NULL,
+        content TEXT,
+        timestamp REAL NOT NULL
+      );
+    `);
+        setup(db);
+        db.close();
+        run();
+    }
+    finally {
+        if (previousHome === undefined) {
+            delete process.env.HERMES_HOME;
+        }
+        else {
+            process.env.HERMES_HOME = previousHome;
+        }
+    }
+}
+test("isAutomatedHermesSessionPrompt detects scheduled cron job instructions", () => {
+    const content = "[IMPORTANT: You are running as a scheduled cron job. DELIVERY: Your final response is the delivery channel.]";
+    assert.equal(isAutomatedHermesSessionPrompt(content), true);
+});
+test("isAutomatedHermesSessionPrompt detects background skill runs", () => {
+    const content = "You are running as Hermes' background skill CURATOR. This is an UMBRELLA-BUILDING task.";
+    assert.equal(isAutomatedHermesSessionPrompt(content), true);
+});
+test("isAutomatedHermesSessionPrompt detects Hermes cron wrapper prompts", () => {
+    const content = `Cronjob Response: Morning feeds
+-------------
+Summarize today's AI news.
+
+Note: The agent cannot see this message, and therefore cannot respond to it.`;
+    assert.equal(isAutomatedHermesSessionPrompt(content), true);
+});
+test("isAutomatedHermesSessionPrompt detects cron metadata headers", () => {
+    const content = `# Cron Job: Morning briefing
+- Job ID: \`abc123\`
+- Run Time: 2026-06-01 08:41:00`;
+    assert.equal(isAutomatedHermesSessionPrompt(content), true);
+});
+test("isAutomatedHermesSessionPrompt returns false for normal user chat", () => {
+    assert.equal(isAutomatedHermesSessionPrompt("Kan du lage en cron job som kjører hvert 5. minutt?"), false);
+    assert.equal(isAutomatedHermesSessionPrompt("Flott"), false);
+    assert.equal(isAutomatedHermesSessionPrompt("Sure, I can help with that."), false);
+});
+test("getSessionUsage returns zeros when state.db is missing", () => {
+    const previousHome = process.env.HERMES_HOME;
+    process.env.HERMES_HOME = mkdtempSync(join(tmpdir(), "hermes-session-db-missing-"));
+    try {
+        const usage = getSessionUsage("sess_missing");
+        assert.equal(usage.sessionId, "sess_missing");
+        assert.equal(usage.inputTokens, 0);
+        assert.equal(usage.outputTokens, 0);
+    }
+    finally {
+        if (previousHome === undefined) {
+            delete process.env.HERMES_HOME;
+        }
+        else {
+            process.env.HERMES_HOME = previousHome;
+        }
+    }
+});
+test("getSessionUsage sums token counters across parent and child sessions", () => {
+    withHermesStateDb((db) => {
+        const now = Date.now() / 1000;
+        db.prepare(`INSERT INTO sessions (
+           id, source, model, parent_session_id, started_at,
+           input_tokens, output_tokens, cache_read_tokens, cache_write_tokens,
+           reasoning_tokens, estimated_cost_usd, message_count
+         ) VALUES (?, 'cli', ?, NULL, ?, ?, ?, ?, ?, ?, ?, ?)`).run("parent_sess", "anthropic/claude-sonnet-4", now, 10_000, 2_000, 500, 100, 50, 0.12, 8);
+        db.prepare(`INSERT INTO sessions (
+           id, source, model, parent_session_id, started_at,
+           input_tokens, output_tokens, cache_read_tokens, cache_write_tokens,
+           reasoning_tokens, estimated_cost_usd, message_count
+         ) VALUES (?, 'cli', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run("child_sess", "anthropic/claude-sonnet-4", "parent_sess", now + 1, 5_000, 1_000, 200, 40, 20, 0.05, 4);
+        db.prepare(`INSERT INTO messages (session_id, role, content, timestamp)
+         VALUES (?, 'user', ?, ?)`).run("child_sess", "hello", now + 2);
+    }, () => {
+        const usage = getSessionUsage("child_sess");
+        assert.equal(usage.resolvedSessionId, "child_sess");
+        assert.equal(usage.model, "anthropic/claude-sonnet-4");
+        assert.equal(usage.inputTokens, 15_000);
+        assert.equal(usage.outputTokens, 3_000);
+        assert.equal(usage.cacheReadTokens, 700);
+        assert.equal(usage.cacheWriteTokens, 140);
+        assert.equal(usage.reasoningTokens, 70);
+        assert.equal(usage.messageCount, 12);
+        assert.ok(usage.estimatedCostUsd != null && Math.abs(usage.estimatedCostUsd - 0.17) < 0.001);
+    });
+});
+test("getSessionUsage resolves parent id to child session with messages", () => {
+    withHermesStateDb((db) => {
+        const now = Date.now() / 1000;
+        db.prepare(`INSERT INTO sessions (
+           id, source, model, parent_session_id, started_at,
+           input_tokens, output_tokens, message_count
+         ) VALUES (?, 'cli', ?, NULL, ?, ?, ?, ?)`).run("parent_only", "hermes-agent", now, 100, 50, 2);
+        db.prepare(`INSERT INTO sessions (
+           id, source, model, parent_session_id, started_at,
+           input_tokens, output_tokens, message_count
+         ) VALUES (?, 'cli', ?, ?, ?, ?, ?, ?)`).run("child_active", "hermes-agent", "parent_only", now + 1, 400, 200, 3);
+        db.prepare(`INSERT INTO messages (session_id, role, content, timestamp)
+         VALUES (?, 'user', ?, ?)`).run("child_active", "follow-up", now + 2);
+    }, () => {
+        const usage = getSessionUsage("parent_only");
+        assert.equal(usage.resolvedSessionId, "child_active");
+        assert.equal(usage.inputTokens, 500);
+        assert.equal(usage.outputTokens, 250);
+        assert.equal(usage.messageCount, 5);
+    });
+});

package/dist/index.d.ts

@@ -7,8 +7,8 @@ export type { PairingInfo } from "./resolve.js";
 export { pairWithCleos } from "./pairWithCleos.js";
 export { createHermesMessageHandler, forwardToHermes, resolveHermesApiConfig } from "./hermesForwarder.js";
 export type { HermesForwarderOptions, HermesForwardResult } from "./hermesForwarder.js";
-export { listHermesSessions, listSessionMessages, resolveSessionTitle, resolveSessionTitles, } from "./hermesSessionDb.js";
-export type { HermesSessionListEntry } from "./hermesSessionDb.js";
+export { getSessionUsage, listHermesSessions, listSessionMessages, resolveSessionTitle, resolveSessionTitles, } from "./hermesSessionDb.js";
+export type { HermesSessionListEntry, HermesSessionUsage } from "./hermesSessionDb.js";
 export type { HermesSessionMessage } from "./hermesSessionDb.js";
 export { executeHermesCommand, HERMES_COMMAND_NAMES, isHermesCommandName, userSafeCommandError, } from "./hermesCommands.js";
 export type { HermesCommandErrorCode, HermesCommandName } from "./hermesCommands.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,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,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,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

@@ -3,7 +3,7 @@ export { loadCredentials, saveCredentials, credentialsPathForDisplay } from "./c
 export { resolvePairingCode, convexSiteUrlFromEnv } from "./resolve.js";
 export { pairWithCleos } from "./pairWithCleos.js";
 export { createHermesMessageHandler, forwardToHermes, resolveHermesApiConfig } from "./hermesForwarder.js";
-export { listHermesSessions, listSessionMessages, resolveSessionTitle, resolveSessionTitles, } from "./hermesSessionDb.js";
+export { getSessionUsage, listHermesSessions, listSessionMessages, resolveSessionTitle, resolveSessionTitles, } from "./hermesSessionDb.js";
 export { executeHermesCommand, HERMES_COMMAND_NAMES, isHermesCommandName, userSafeCommandError, } from "./hermesCommands.js";
 export { startCronWatcher, listPendingCronFiles, clearDeliveredIndex } from "./cronWatcher.js";
 export { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfill.js";

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.26",
+  "version": "0.1.28",
   "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/shellSession.test.ts"
+    "test": "node --import tsx --test src/hermesFiles.test.ts src/hermesSessionDb.test.ts src/shellSession.test.ts"
   },
   "dependencies": {
     "better-sqlite3": "^11.10.0",