@saleso.innovations/bridge 0.1.39 → 0.1.41

package/INTEGRATION.md

@@ -34,10 +34,21 @@ export async function onCleosPairingCodeSubmitted(code: string) {
       for await (const chunk of stream) {
         reply.delta(chunk, sequence++);
       }
-      // If you stream from Hermes /v1/chat/completions, also forward tool progress via
-      // reply.activity() when you receive `event: hermes.tool.progress` SSE events.
+      // If you stream from Hermes /v1/chat/completions, also forward activity via
+      // reply.activity() when you receive progress SSE events:
+      //   - `event: hermes.tool.progress`   { tool, label?, emoji?, source?, server? }
+      //   - `event: hermes.skill.progress`  { skill, label?, emoji? }
+      //   - `event: hermes.memory.progress` { memory, label?, emoji? }
+      //   - `event: hermes.mcp.progress`    { server, tool?, label?, emoji? }
       // Do not inject tool markers into assistant text (see Hermes #6972).
-      reply.complete(stream.finalText, sequence);
+      // Accumulate the capabilities used during the turn and pass a `turnActivity`
+      // summary (plus the model that produced the reply) to reply.complete() so Cleos
+      // can show it on the completed message. The `forwardToHermes` helper does this
+      // automatically when you use createHermesMessageHandler().
+      reply.complete(stream.finalText, sequence, undefined, undefined, {
+        tools: [{ name: "web_search", count: 2 }],
+        model: "anthropic/claude-sonnet-4",
+      });
     },
   });
   return session.agentId;

package/dist/client.d.ts

@@ -22,13 +22,49 @@ export type UserMessageMeta = {
     replyMessageId: string;
     attachments?: UserMessageAttachment[];
 };
+export type AgentActivityKind = "tool" | "skill" | "memory" | "mcp";
 export type AgentActivityPayload = {
     activityType: "tool.started" | "tool.completed";
+    kind?: AgentActivityKind;
     tool?: string;
+    skill?: string;
+    memory?: string;
+    server?: string;
+    source?: string;
     label?: string;
     emoji?: string;
     sequence: number;
 };
+/** Per-message summary of capabilities the agent used. Keep in sync with @repo/backend-types. */
+export type AgentTurnActivity = {
+    tools?: Array<{
+        name: string;
+        label?: string;
+        emoji?: string;
+        count?: number;
+        source?: string;
+    }>;
+    skills?: Array<{
+        name: string;
+        label?: string;
+    }>;
+    skillsLearned?: Array<{
+        name: string;
+        label?: string;
+        description?: string;
+    }>;
+    memories?: Array<{
+        name: string;
+        label?: string;
+    }>;
+    mcps?: Array<{
+        server: string;
+        tool?: string;
+        label?: string;
+        count?: number;
+    }>;
+    model?: string;
+};
 export type AgentFailedPayload = {
     error: string;
     code?: string;
@@ -37,7 +73,7 @@ export type AgentFailedPayload = {
 export type AgentReply = {
     delta: (text: string, sequence: number) => void;
     activity: (activity: AgentActivityPayload) => void;
-    complete: (text: string, sequence: number, attachments?: UserMessageAttachment[], hermesAssistantMessageId?: string) => void;
+    complete: (text: string, sequence: number, attachments?: UserMessageAttachment[], hermesAssistantMessageId?: string, turnActivity?: AgentTurnActivity) => void;
     failed: (failure: AgentFailedPayload) => void;
 };
 export type CronDeliveryMeta = {

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAYhG,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrG,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,cAAc,GAAG,gBAAgB,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACnD,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,qBAAqB,EAAE,EACrC,wBAAwB,CAAC,EAAE,MAAM,KAC9B,IAAI,CAAC;IACV,MAAM,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E,CAAC;AAkXF,wBAAsB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA2BD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAcxF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAClD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,aAAa,CAAC,CAc9B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -9,6 +9,14 @@ import { DEFAULT_BRIDGE_CAPABILITIES } from "./constants.js";
 export function cronDeliveryMessageId(sourceKey) {
     return `cron:${sourceKey}`;
 }
+function hasTurnActivity(activity) {
+    return ((activity.tools?.length ?? 0) > 0 ||
+        (activity.skills?.length ?? 0) > 0 ||
+        (activity.skillsLearned?.length ?? 0) > 0 ||
+        (activity.memories?.length ?? 0) > 0 ||
+        (activity.mcps?.length ?? 0) > 0 ||
+        typeof activity.model === "string");
+}
 function parseUserMessageAttachments(raw) {
     if (!Array.isArray(raw))
         return undefined;
@@ -71,13 +79,25 @@ function createReplySender(ws, agentId, conversationId, messageId) {
                 conversationId,
                 messageId,
                 activityType: activity.activityType,
+                kind: activity.kind,
                 tool: activity.tool,
+                skill: activity.skill,
+                memory: activity.memory,
+                server: activity.server,
+                source: activity.source,
                 label: activity.label,
                 emoji: activity.emoji,
                 sequence: activity.sequence,
             }));
         },
-        complete(text, sequence, attachments, hermesAssistantMessageId) {
+        complete(text, sequence, attachments, hermesAssistantMessageId, turnActivity) {
+            const metadata = {};
+            if (hermesAssistantMessageId) {
+                metadata.hermes = { assistantMessageId: hermesAssistantMessageId };
+            }
+            if (turnActivity && hasTurnActivity(turnActivity)) {
+                metadata.turnActivity = turnActivity;
+            }
             ws.send(JSON.stringify({
                 type: "agent.message",
                 agentId,
@@ -87,9 +107,7 @@ function createReplySender(ws, agentId, conversationId, messageId) {
                 sequence,
                 final: true,
                 ...(attachments && attachments.length > 0 ? { attachments } : {}),
-                ...(hermesAssistantMessageId
-                    ? { metadata: { hermes: { assistantMessageId: hermesAssistantMessageId } } }
-                    : {}),
+                ...(Object.keys(metadata).length > 0 ? { metadata } : {}),
             }));
         },
         failed(failure) {

package/dist/hermesForwarder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesForwarder.d.ts","sourceRoot":"","sources":["../src/hermesForwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAyB,eAAe,EAAE,MAAM,aAAa,CAAC;AAWtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAkBF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AA+MD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CA6E9B;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,sBAA2B,IAC/D,SAAS,MAAM,EAAE,MAAM,eAAe,EAAE,OAAO,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC,CAMxF"}
+{"version":3,"file":"hermesForwarder.d.ts","sourceRoot":"","sources":["../src/hermesForwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAyB,eAAe,EAAE,MAAM,aAAa,CAAC;AAmBtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAkBF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AAgID,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAyF9B;AA2BD,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,sBAA2B,IAC/D,SAAS,MAAM,EAAE,MAAM,eAAe,EAAE,OAAO,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC,CAMxF"}

package/dist/hermesForwarder.js

@@ -3,7 +3,9 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { linkHermesMessageIds, uploadFileToConvex } from "./convexRelay.js";
 import { DEFAULT_HERMES_API_URL } from "./constants.js";
-import { getLatestTurnMessageIds, hermesStateDbExists } from "./hermesSessionDb.js";
+import { getLatestTurnMessageIds, getSessionUsage, hermesStateDbExists } from "./hermesSessionDb.js";
+import { diffSkillsLearned, snapshotSkills } from "./skillLearnedDetector.js";
+import { buildTurnActivity, createTurnActivityAccumulator, parseSseDataLines, processSseEventBlock, } from "./turnActivity.js";
 import { parseMediaReferences, resolveMediaReferenceBytes, stripMediaReferences, } from "./hermesFiles.js";
 function readHermesApiKeyFromEnvFile() {
     const envPath = join(homedir(), ".hermes", ".env");
@@ -49,70 +51,6 @@ async function ensureHermesReachable(apiUrl, apiKey) {
         throw new Error(`Hermes is not reachable at ${healthUrl}. Ensure Hermes is installed and run \`hermes gateway\` on this machine. ${message}`);
     }
 }
-function parseSseDataLines(buffer) {
-    const parts = buffer.split("\n\n");
-    const rest = parts.pop() ?? "";
-    return { events: parts, rest };
-}
-function extractDeltaFromChunk(payload) {
-    const choices = payload.choices;
-    if (!Array.isArray(choices) || choices.length === 0)
-        return null;
-    const choice = choices[0];
-    if (!choice || typeof choice !== "object")
-        return null;
-    const delta = choice.delta;
-    if (!delta || typeof delta !== "object")
-        return null;
-    const content = delta.content;
-    return typeof content === "string" ? content : null;
-}
-function processSseEventBlock(eventBlock, reply, counters, onTextDelta) {
-    let eventName = "message";
-    for (const line of eventBlock.split("\n")) {
-        if (line.startsWith("event:")) {
-            eventName = line.slice(6).trim();
-            continue;
-        }
-        if (!line.startsWith("data:"))
-            continue;
-        const data = line.slice(5).trim();
-        if (!data || data === "[DONE]")
-            continue;
-        if (eventName === "hermes.tool.progress") {
-            try {
-                const payload = JSON.parse(data);
-                const tool = typeof payload.tool === "string" ? payload.tool : undefined;
-                const label = typeof payload.label === "string" ? payload.label : undefined;
-                const emoji = typeof payload.emoji === "string" ? payload.emoji : undefined;
-                reply.activity({
-                    activityType: "tool.started",
-                    tool,
-                    label,
-                    emoji,
-                    sequence: counters.activitySequence,
-                });
-                counters.activitySequence += 1;
-            }
-            catch {
-                // Ignore malformed tool progress payloads.
-            }
-            continue;
-        }
-        try {
-            const payload = JSON.parse(data);
-            const delta = extractDeltaFromChunk(payload);
-            if (delta && delta.trim()) {
-                onTextDelta(delta);
-                reply.delta(delta, counters.textSequence);
-                counters.textSequence += 1;
-            }
-        }
-        catch {
-            // Ignore malformed SSE chunks.
-        }
-    }
-}
 function buildHermesUserContent(text, attachments) {
     const trimmed = text.trim();
     const imageParts = (attachments ?? [])
@@ -223,6 +161,8 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
         messages: [{ role: "user", content: userContent }],
         user: sessionId,
     };
+    const turnStartedAt = Date.now();
+    const skillsBefore = snapshotSkills();
     const response = await fetch(apiUrl, {
         method: "POST",
         headers,
@@ -233,6 +173,7 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
         throw new Error(`Hermes request failed (${response.status}): ${text}`);
     }
     const resolvedSessionId = response.headers.get("X-Hermes-Session-Id")?.trim() || sessionId;
+    const modelFromHeader = response.headers.get("X-Hermes-Model")?.trim() || undefined;
     if (!response.body) {
         throw new Error("Hermes returned an empty streaming body");
     }
@@ -240,6 +181,7 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
     const decoder = new TextDecoder();
     let buffer = "";
     const counters = { textSequence: 0, activitySequence: 0 };
+    const accumulator = createTurnActivityAccumulator();
     let fullText = "";
     while (true) {
         const { done, value } = await reader.read();
@@ -249,7 +191,7 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
         const { events, rest } = parseSseDataLines(buffer);
         buffer = rest;
         for (const eventBlock of events) {
-            processSseEventBlock(eventBlock, reply, counters, (delta) => {
+            processSseEventBlock(eventBlock, reply, counters, accumulator, (delta) => {
                 fullText += delta;
             });
         }
@@ -263,10 +205,37 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
     const attachments = mediaRefs.length > 0 ? await uploadMediaAttachments(meta.agentId, mediaRefs) : [];
     const displayText = attachments.length > 0 ? stripMediaReferences(fullText, mediaRefs) : fullText.trim() || fullText;
     const { assistantMessageId } = getLatestTurnMessageIds(resolvedSessionId);
-    reply.complete(displayText, counters.textSequence, attachments.length > 0 ? attachments : undefined, assistantMessageId !== undefined ? String(assistantMessageId) : undefined);
+    const replyModel = resolveReplyModel(modelFromHeader, resolvedSessionId, model);
+    const turnActivity = buildTurnActivity(accumulator, replyModel);
+    const skillsLearned = diffSkillsLearned(skillsBefore, snapshotSkills(), { turnStartedAt });
+    if (skillsLearned.length > 0) {
+        turnActivity.skillsLearned = skillsLearned;
+    }
+    reply.complete(displayText, counters.textSequence, attachments.length > 0 ? attachments : undefined, assistantMessageId !== undefined ? String(assistantMessageId) : undefined, turnActivity);
     await linkTurnToConvex(meta, resolvedSessionId);
     return { sessionId: resolvedSessionId };
 }
+/**
+ * Resolves which model produced the reply, in priority order:
+ * 1. The `X-Hermes-Model` response header.
+ * 2. The session's recorded model in Hermes `state.db`.
+ * 3. The model from the outbound request (skipping the generic placeholder alias).
+ */
+function resolveReplyModel(modelFromHeader, resolvedSessionId, requestModel) {
+    if (modelFromHeader)
+        return modelFromHeader;
+    if (hermesStateDbExists()) {
+        try {
+            const usage = getSessionUsage(resolvedSessionId);
+            if (usage.model)
+                return usage.model;
+        }
+        catch {
+            // Fall through to request model.
+        }
+    }
+    return requestModel && requestModel !== "hermes-agent" ? requestModel : undefined;
+}
 export function createHermesMessageHandler(options = {}) {
     return async (content, meta, reply) => {
         await forwardToHermes(content, meta, reply, {

package/dist/skillLearnedDetector.d.ts

@@ -0,0 +1,20 @@
+import type { AgentTurnActivity } from "./client.js";
+import { type HermesSkillEntry } from "./skillsList.js";
+export type SkillSnapshotEntry = HermesSkillEntry & {
+    mtimeMs?: number;
+};
+/**
+ * Captures the set of skills currently on disk, keyed by relative path, with each
+ * file's mtime so a later diff can ignore writes that predate the turn.
+ */
+export declare function snapshotSkills(): Map<string, SkillSnapshotEntry>;
+/**
+ * Returns skills present in `after` but not in `before` — i.e. newly written during the
+ * turn. When `turnStartedAt` is provided, entries whose file mtime predates the turn
+ * start (beyond a small grace window) are excluded to guard against concurrent
+ * background writes.
+ */
+export declare function diffSkillsLearned(before: Map<string, SkillSnapshotEntry>, after: Map<string, SkillSnapshotEntry>, options?: {
+    turnStartedAt?: number;
+}): NonNullable<AgentTurnActivity["skillsLearned"]>;
+//# sourceMappingURL=skillLearnedDetector.d.ts.map

package/dist/skillLearnedDetector.d.ts.map

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

package/dist/skillLearnedDetector.js

@@ -0,0 +1,53 @@
+import { statSync } from "node:fs";
+import { join } from "node:path";
+import { resolveHermesHome } from "./hermesFiles.js";
+import { listSkillsFromFilesystem } from "./skillsList.js";
+/**
+ * Captures the set of skills currently on disk, keyed by relative path, with each
+ * file's mtime so a later diff can ignore writes that predate the turn.
+ */
+export function snapshotSkills() {
+    const home = resolveHermesHome();
+    const snapshot = new Map();
+    for (const skill of listSkillsFromFilesystem().skills) {
+        if (!skill.relativePath)
+            continue;
+        let mtimeMs;
+        try {
+            mtimeMs = statSync(join(home, skill.relativePath)).mtimeMs;
+        }
+        catch {
+            // File may be unreadable; record without mtime.
+        }
+        snapshot.set(skill.relativePath, { ...skill, mtimeMs });
+    }
+    return snapshot;
+}
+/** Tolerance for clock skew between the turn start and a freshly written skill file. */
+const MTIME_GRACE_MS = 5_000;
+/**
+ * Returns skills present in `after` but not in `before` — i.e. newly written during the
+ * turn. When `turnStartedAt` is provided, entries whose file mtime predates the turn
+ * start (beyond a small grace window) are excluded to guard against concurrent
+ * background writes.
+ */
+export function diffSkillsLearned(before, after, options = {}) {
+    const learned = [];
+    const threshold = typeof options.turnStartedAt === "number" ? options.turnStartedAt - MTIME_GRACE_MS : undefined;
+    for (const [relativePath, entry] of after) {
+        if (before.has(relativePath))
+            continue;
+        if (threshold !== undefined &&
+            typeof entry.mtimeMs === "number" &&
+            entry.mtimeMs < threshold) {
+            continue;
+        }
+        learned.push({
+            name: entry.name,
+            ...(entry.category ? { label: entry.category } : {}),
+            ...(entry.description ? { description: entry.description } : {}),
+        });
+    }
+    learned.sort((left, right) => left.name.localeCompare(right.name, undefined, { sensitivity: "base" }));
+    return learned;
+}

package/dist/skillLearnedDetector.test.d.ts

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

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

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

package/dist/skillLearnedDetector.test.js

@@ -0,0 +1,81 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { diffSkillsLearned } from "./skillLearnedDetector.js";
+function snapshot(entries) {
+    const map = new Map();
+    for (const entry of entries) {
+        if (entry.relativePath)
+            map.set(entry.relativePath, entry);
+    }
+    return map;
+}
+test("returns empty when nothing changed", () => {
+    const before = snapshot([
+        { name: "alpha", description: "", relativePath: "skills/alpha/SKILL.md" },
+    ]);
+    const after = snapshot([
+        { name: "alpha", description: "", relativePath: "skills/alpha/SKILL.md" },
+    ]);
+    assert.deepEqual(diffSkillsLearned(before, after), []);
+});
+test("detects a single new skill with label and description", () => {
+    const before = snapshot([]);
+    const after = snapshot([
+        {
+            name: "crypto-technical-analysis",
+            description: "Analyze crypto charts",
+            category: "trading",
+            relativePath: "skills/trading/crypto-technical-analysis/SKILL.md",
+        },
+    ]);
+    assert.deepEqual(diffSkillsLearned(before, after), [
+        {
+            name: "crypto-technical-analysis",
+            label: "trading",
+            description: "Analyze crypto charts",
+        },
+    ]);
+});
+test("detects multiple new skills sorted by name", () => {
+    const before = snapshot([
+        { name: "alpha", description: "", relativePath: "skills/alpha/SKILL.md" },
+    ]);
+    const after = snapshot([
+        { name: "alpha", description: "", relativePath: "skills/alpha/SKILL.md" },
+        { name: "zeta", description: "", relativePath: "skills/zeta/SKILL.md" },
+        { name: "beta", description: "", relativePath: "skills/beta/SKILL.md" },
+    ]);
+    assert.deepEqual(diffSkillsLearned(before, after).map((skill) => skill.name), ["beta", "zeta"]);
+});
+test("excludes new entries whose mtime predates the turn start", () => {
+    const turnStartedAt = 1_000_000;
+    const before = snapshot([]);
+    const after = snapshot([
+        {
+            name: "stale",
+            description: "",
+            relativePath: "skills/stale/SKILL.md",
+            mtimeMs: turnStartedAt - 60_000,
+        },
+        {
+            name: "fresh",
+            description: "",
+            relativePath: "skills/fresh/SKILL.md",
+            mtimeMs: turnStartedAt + 1_000,
+        },
+    ]);
+    assert.deepEqual(diffSkillsLearned(before, after, { turnStartedAt }).map((skill) => skill.name), ["fresh"]);
+});
+test("keeps new entries within the mtime grace window", () => {
+    const turnStartedAt = 1_000_000;
+    const before = snapshot([]);
+    const after = snapshot([
+        {
+            name: "borderline",
+            description: "",
+            relativePath: "skills/borderline/SKILL.md",
+            mtimeMs: turnStartedAt - 2_000,
+        },
+    ]);
+    assert.deepEqual(diffSkillsLearned(before, after, { turnStartedAt }).map((skill) => skill.name), ["borderline"]);
+});

package/dist/skillsList.d.ts

@@ -4,6 +4,13 @@ export type HermesSkillEntry = {
     category?: string;
     relativePath?: string;
 };
+/**
+ * Synchronously reads the Hermes skills directory from disk. Used for fast turn-boundary
+ * snapshots without shelling out to the `hermes` CLI.
+ */
+export declare function listSkillsFromFilesystem(): {
+    skills: HermesSkillEntry[];
+};
 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":"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"}
+{"version":3,"file":"skillsList.d.ts","sourceRoot":"","sources":["../src/skillsList.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA6GF;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAEzE;AA4HD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAOhF"}

package/dist/skillsList.js

@@ -105,6 +105,13 @@ function toHermesRelativeSkillPath(skillsRootDir, skillFilePath) {
     const fromSkillsDir = relative(skillsRootDir, skillFilePath).replace(/\\/g, "/");
     return `${SKILLS_DIR}/${fromSkillsDir}`;
 }
+/**
+ * Synchronously reads the Hermes skills directory from disk. Used for fast turn-boundary
+ * snapshots without shelling out to the `hermes` CLI.
+ */
+export function listSkillsFromFilesystem() {
+    return readSkillsFromDirectory();
+}
 function readSkillsFromDirectory() {
     const root = skillsRoot();
     if (!existsSync(root)) {

package/dist/turnActivity.d.ts

@@ -0,0 +1,36 @@
+import type { AgentReply, AgentTurnActivity } from "./client.js";
+export type StreamCounters = {
+    textSequence: number;
+    activitySequence: number;
+};
+export type TurnActivityAccumulator = {
+    tools: Map<string, {
+        name: string;
+        label?: string;
+        emoji?: string;
+        count: number;
+        source?: string;
+    }>;
+    skills: Map<string, {
+        name: string;
+        label?: string;
+    }>;
+    memories: Map<string, {
+        name: string;
+        label?: string;
+    }>;
+    mcps: Map<string, {
+        server: string;
+        tool?: string;
+        label?: string;
+        count: number;
+    }>;
+};
+export declare function createTurnActivityAccumulator(): TurnActivityAccumulator;
+export declare function buildTurnActivity(acc: TurnActivityAccumulator, model?: string): AgentTurnActivity;
+export declare function parseSseDataLines(buffer: string): {
+    events: string[];
+    rest: string;
+};
+export declare function processSseEventBlock(eventBlock: string, reply: AgentReply, counters: StreamCounters, accumulator: TurnActivityAccumulator, onTextDelta: (delta: string) => void): void;
+//# sourceMappingURL=turnActivity.d.ts.map

package/dist/turnActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnActivity.d.ts","sourceRoot":"","sources":["../src/turnActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAgCF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrG,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrF,CAAC;AAEF,wBAAgB,6BAA6B,IAAI,uBAAuB,CAEvE;AAmCD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,uBAAuB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,CA6CjG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAIpF;AAiBD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,uBAAuB,EACpC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GACnC,IAAI,CA4IN"}

package/dist/turnActivity.js

@@ -0,0 +1,233 @@
+/** Caps how many distinct items per category are persisted on a message summary. */
+const MAX_TURN_ACTIVITY_ITEMS = 20;
+export function createTurnActivityAccumulator() {
+    return { tools: new Map(), skills: new Map(), memories: new Map(), mcps: new Map() };
+}
+function recordToolUse(acc, name, label, emoji, source) {
+    const existing = acc.tools.get(name);
+    if (existing) {
+        existing.count += 1;
+        if (!existing.label && label)
+            existing.label = label;
+        if (!existing.emoji && emoji)
+            existing.emoji = emoji;
+        return;
+    }
+    acc.tools.set(name, { name, label, emoji, count: 1, source });
+}
+function recordMcpUse(acc, server, tool, label) {
+    const key = `${server}\u0000${tool ?? ""}`;
+    const existing = acc.mcps.get(key);
+    if (existing) {
+        existing.count += 1;
+        if (!existing.label && label)
+            existing.label = label;
+        return;
+    }
+    acc.mcps.set(key, { server, tool, label, count: 1 });
+}
+export function buildTurnActivity(acc, model) {
+    const activity = {};
+    const tools = [...acc.tools.values()].slice(0, MAX_TURN_ACTIVITY_ITEMS);
+    if (tools.length > 0) {
+        activity.tools = tools.map((tool) => ({
+            name: tool.name,
+            ...(tool.label ? { label: tool.label } : {}),
+            ...(tool.emoji ? { emoji: tool.emoji } : {}),
+            ...(tool.count > 1 ? { count: tool.count } : {}),
+            ...(tool.source ? { source: tool.source } : {}),
+        }));
+    }
+    const skills = [...acc.skills.values()].slice(0, MAX_TURN_ACTIVITY_ITEMS);
+    if (skills.length > 0) {
+        activity.skills = skills.map((skill) => ({
+            name: skill.name,
+            ...(skill.label ? { label: skill.label } : {}),
+        }));
+    }
+    const memories = [...acc.memories.values()].slice(0, MAX_TURN_ACTIVITY_ITEMS);
+    if (memories.length > 0) {
+        activity.memories = memories.map((memory) => ({
+            name: memory.name,
+            ...(memory.label ? { label: memory.label } : {}),
+        }));
+    }
+    const mcps = [...acc.mcps.values()].slice(0, MAX_TURN_ACTIVITY_ITEMS);
+    if (mcps.length > 0) {
+        activity.mcps = mcps.map((mcp) => ({
+            server: mcp.server,
+            ...(mcp.tool ? { tool: mcp.tool } : {}),
+            ...(mcp.label ? { label: mcp.label } : {}),
+            ...(mcp.count > 1 ? { count: mcp.count } : {}),
+        }));
+    }
+    if (model) {
+        activity.model = model;
+    }
+    return activity;
+}
+export function parseSseDataLines(buffer) {
+    const parts = buffer.split("\n\n");
+    const rest = parts.pop() ?? "";
+    return { events: parts, rest };
+}
+function extractDeltaFromChunk(payload) {
+    const choices = payload.choices;
+    if (!Array.isArray(choices) || choices.length === 0)
+        return null;
+    const choice = choices[0];
+    if (!choice || typeof choice !== "object")
+        return null;
+    const delta = choice.delta;
+    if (!delta || typeof delta !== "object")
+        return null;
+    const content = delta.content;
+    return typeof content === "string" ? content : null;
+}
+function asString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+}
+export function processSseEventBlock(eventBlock, reply, counters, accumulator, onTextDelta) {
+    let eventName = "message";
+    for (const line of eventBlock.split("\n")) {
+        if (line.startsWith("event:")) {
+            eventName = line.slice(6).trim();
+            continue;
+        }
+        if (!line.startsWith("data:"))
+            continue;
+        const data = line.slice(5).trim();
+        if (!data || data === "[DONE]")
+            continue;
+        if (eventName === "hermes.tool.progress") {
+            try {
+                const payload = JSON.parse(data);
+                const tool = asString(payload.tool);
+                const label = asString(payload.label);
+                const emoji = asString(payload.emoji);
+                const source = asString(payload.source);
+                const server = asString(payload.server);
+                // MCP tool calls may arrive as tool progress; bucket them as MCP usage.
+                if (source === "mcp" || server) {
+                    const mcpServer = server ?? "mcp";
+                    recordMcpUse(accumulator, mcpServer, tool, label);
+                    reply.activity({
+                        activityType: "tool.started",
+                        kind: "mcp",
+                        tool,
+                        server: mcpServer,
+                        source: "mcp",
+                        label,
+                        emoji,
+                        sequence: counters.activitySequence,
+                    });
+                }
+                else {
+                    if (tool)
+                        recordToolUse(accumulator, tool, label, emoji, source);
+                    reply.activity({
+                        activityType: "tool.started",
+                        kind: "tool",
+                        tool,
+                        source,
+                        label,
+                        emoji,
+                        sequence: counters.activitySequence,
+                    });
+                }
+                counters.activitySequence += 1;
+            }
+            catch {
+                // Ignore malformed tool progress payloads.
+            }
+            continue;
+        }
+        if (eventName === "hermes.skill.progress") {
+            try {
+                const payload = JSON.parse(data);
+                const skill = asString(payload.skill);
+                const label = asString(payload.label);
+                const emoji = asString(payload.emoji);
+                if (skill && !accumulator.skills.has(skill)) {
+                    accumulator.skills.set(skill, { name: skill, label });
+                }
+                reply.activity({
+                    activityType: "tool.started",
+                    kind: "skill",
+                    skill,
+                    label,
+                    emoji,
+                    sequence: counters.activitySequence,
+                });
+                counters.activitySequence += 1;
+            }
+            catch {
+                // Ignore malformed skill progress payloads.
+            }
+            continue;
+        }
+        if (eventName === "hermes.memory.progress") {
+            try {
+                const payload = JSON.parse(data);
+                const memory = asString(payload.memory);
+                const label = asString(payload.label);
+                const emoji = asString(payload.emoji);
+                if (memory && !accumulator.memories.has(memory)) {
+                    accumulator.memories.set(memory, { name: memory, label });
+                }
+                reply.activity({
+                    activityType: "tool.started",
+                    kind: "memory",
+                    memory,
+                    label,
+                    emoji,
+                    sequence: counters.activitySequence,
+                });
+                counters.activitySequence += 1;
+            }
+            catch {
+                // Ignore malformed memory progress payloads.
+            }
+            continue;
+        }
+        if (eventName === "hermes.mcp.progress") {
+            try {
+                const payload = JSON.parse(data);
+                const server = asString(payload.server);
+                const tool = asString(payload.tool);
+                const label = asString(payload.label);
+                const emoji = asString(payload.emoji);
+                if (server) {
+                    recordMcpUse(accumulator, server, tool, label);
+                    reply.activity({
+                        activityType: "tool.started",
+                        kind: "mcp",
+                        server,
+                        tool,
+                        source: "mcp",
+                        label,
+                        emoji,
+                        sequence: counters.activitySequence,
+                    });
+                    counters.activitySequence += 1;
+                }
+            }
+            catch {
+                // Ignore malformed MCP progress payloads.
+            }
+            continue;
+        }
+        try {
+            const payload = JSON.parse(data);
+            const delta = extractDeltaFromChunk(payload);
+            if (delta && delta.trim()) {
+                onTextDelta(delta);
+                reply.delta(delta, counters.textSequence);
+                counters.textSequence += 1;
+            }
+        }
+        catch {
+            // Ignore malformed SSE chunks.
+        }
+    }
+}

package/dist/turnActivity.test.d.ts

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

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

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

package/dist/turnActivity.test.js

@@ -0,0 +1,69 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { buildTurnActivity, createTurnActivityAccumulator, processSseEventBlock, } from "./turnActivity.js";
+function collectingReply() {
+    const activities = [];
+    const deltas = [];
+    const reply = {
+        delta: (text) => {
+            deltas.push(text);
+        },
+        activity: (activity) => {
+            activities.push(activity);
+        },
+        complete: () => { },
+        failed: () => { },
+    };
+    return { reply, activities, deltas };
+}
+function sseEvent(event, data) {
+    return `event: ${event}\ndata: ${JSON.stringify(data)}`;
+}
+test("accumulates and dedupes tool usage with counts", () => {
+    const { reply, activities } = collectingReply();
+    const accumulator = createTurnActivityAccumulator();
+    const counters = { textSequence: 0, activitySequence: 0 };
+    processSseEventBlock(sseEvent("hermes.tool.progress", { tool: "web_search", label: "Searching", emoji: "🔍" }), reply, counters, accumulator, () => { });
+    processSseEventBlock(sseEvent("hermes.tool.progress", { tool: "web_search" }), reply, counters, accumulator, () => { });
+    const activity = buildTurnActivity(accumulator);
+    assert.deepEqual(activity.tools, [
+        { name: "web_search", label: "Searching", emoji: "🔍", count: 2 },
+    ]);
+    assert.equal(activities.length, 2);
+    assert.equal(activities[0]?.kind, "tool");
+});
+test("buckets MCP tool progress into mcps, not tools", () => {
+    const { reply } = collectingReply();
+    const accumulator = createTurnActivityAccumulator();
+    const counters = { textSequence: 0, activitySequence: 0 };
+    processSseEventBlock(sseEvent("hermes.tool.progress", { tool: "search", source: "mcp", server: "context7" }), reply, counters, accumulator, () => { });
+    processSseEventBlock(sseEvent("hermes.mcp.progress", { server: "context7", tool: "search" }), reply, counters, accumulator, () => { });
+    const activity = buildTurnActivity(accumulator);
+    assert.equal(activity.tools, undefined);
+    assert.deepEqual(activity.mcps, [{ server: "context7", tool: "search", count: 2 }]);
+});
+test("collects skills and memories uniquely", () => {
+    const { reply } = collectingReply();
+    const accumulator = createTurnActivityAccumulator();
+    const counters = { textSequence: 0, activitySequence: 0 };
+    processSseEventBlock(sseEvent("hermes.skill.progress", { skill: "frontend-design", label: "Frontend design" }), reply, counters, accumulator, () => { });
+    processSseEventBlock(sseEvent("hermes.skill.progress", { skill: "frontend-design" }), reply, counters, accumulator, () => { });
+    processSseEventBlock(sseEvent("hermes.memory.progress", { memory: "USER.md" }), reply, counters, accumulator, () => { });
+    const activity = buildTurnActivity(accumulator, "anthropic/claude-sonnet-4");
+    assert.deepEqual(activity.skills, [{ name: "frontend-design", label: "Frontend design" }]);
+    assert.deepEqual(activity.memories, [{ name: "USER.md" }]);
+    assert.equal(activity.model, "anthropic/claude-sonnet-4");
+});
+test("text deltas are forwarded and not treated as activity", () => {
+    const { reply, deltas, activities } = collectingReply();
+    const accumulator = createTurnActivityAccumulator();
+    const counters = { textSequence: 0, activitySequence: 0 };
+    let captured = "";
+    processSseEventBlock(`data: ${JSON.stringify({ choices: [{ delta: { content: "Hello" } }] })}`, reply, counters, accumulator, (delta) => {
+        captured += delta;
+    });
+    assert.equal(captured, "Hello");
+    assert.deepEqual(deltas, ["Hello"]);
+    assert.equal(activities.length, 0);
+    assert.equal(buildTurnActivity(accumulator).model, undefined);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleso.innovations/bridge",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "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/hermesSessionDb.test.ts src/renameHermesSession.test.ts src/shellSession.test.ts src/bridgeVersion.test.ts"
+    "test": "node --import tsx --test src/hermesFiles.test.ts src/hermesSessionDb.test.ts src/renameHermesSession.test.ts src/shellSession.test.ts src/bridgeVersion.test.ts src/turnActivity.test.ts src/skillLearnedDetector.test.ts"
   },
   "dependencies": {
     "better-sqlite3": "^11.10.0",