@saleso.innovations/bridge 0.1.26 → 0.1.27

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", "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":"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"}

package/dist/hermesCommands.js

@@ -1,7 +1,7 @@
 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";
@@ -35,6 +35,7 @@ export const HERMES_COMMAND_NAMES = [
     "sessions.messages.list",
     "sessions.messages.countSent",
     "sessions.titles.resolve",
+    "sessions.usage.get",
     "sessions.list",
     "skills.list",
     "files.list",
@@ -311,6 +312,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 }) };

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleso.innovations/bridge",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "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",