@lumoai/cli 1.18.0 → 1.19.0

package/assets/skill/references/worktree.md

@@ -36,6 +36,16 @@ do `generate + tsc` atomically once at the end.
 in first) — `cli/` has no jest config, and running from the main checkout hits
 the `cli/package.json` haste collision and silently runs the wrong tests.
 
+**Never run `npm install` / `npm ci` inside a worktree.** The worktree shares
+the main checkout's `node_modules` via a symlink; npm does not respect the link
+— it deletes it and reifies a full standalone `node_modules` (thousands of
+packages, ~1 min, and the shared prisma-client is gone). Run installs only in
+the main checkout, then re-create the symlink if npm replaced it. (Older npm
+could instead plant a self-referential `node_modules/node_modules` in the shared
+tree, which hard-panics Turbopack's `next build`; the `prebuild`/`predev`/
+`preanalyze` guard — `scripts/fix-nodemodules-selflink.ts` — removes that link
+automatically, but the rule above avoids the whole mess.)
+
 ## `lumo worktree rm <LUM-N>`
 
 Removes the worktree for a task. Requires `--yes`. Refuses a dirty worktree

package/dist/cli/src/lib/hook-runner.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatHookStdoutLines = formatHookStdoutLines;
 exports.formatAutoBindLine = formatAutoBindLine;
 exports.resolveSessionStartStdout = resolveSessionStartStdout;
+exports.augmentBodyWithUsage = augmentBodyWithUsage;
 exports.runHook = runHook;
 exports.runHookWithBody = runHookWithBody;
 const config_1 = require("./config");
@@ -12,6 +13,7 @@ const sanitize_1 = require("./sanitize");
 const agent_1 = require("./agent");
 const git_task_1 = require("./git-task");
 const format_1 = require("./format");
+const transcript_usage_1 = require("./transcript-usage");
 /**
  * Hard timeout for the hook POST. On timeout the request is aborted,
  * logged, and `runHook` exits 0 — Claude Code is never blocked beyond
@@ -260,6 +262,31 @@ async function postBindTask(sessionId, identifier, token, apiUrl) {
         clearTimeout(timer);
     }
 }
+/**
+ * For stop/stop-failure hooks, read the transcript named in the payload and
+ * fold cumulative token totals into the body under `_lumo_usage` so the server
+ * can persist them on the Session. Best-effort: returns the body unchanged on
+ * any failure (no transcript_path, unreadable, unparseable, no usage). The
+ * hook is never blocked or failed by this.
+ */
+function augmentBodyWithUsage(path, body) {
+    if (path !== 'stop' && path !== 'stop-failure')
+        return body;
+    let parsed;
+    try {
+        parsed = JSON.parse(body || '{}');
+    }
+    catch {
+        return body;
+    }
+    const transcriptPath = parsed['transcript_path'];
+    if (typeof transcriptPath !== 'string' || !transcriptPath)
+        return body;
+    const usage = (0, transcript_usage_1.sumTranscriptUsage)(transcriptPath);
+    if (!usage)
+        return body;
+    return JSON.stringify({ ...parsed, _lumo_usage: usage });
+}
 /**
  * POST the hook body to /api/hooks/<path> with a short timeout. All errors
  * — credential missing, network failure, timeout, non-2xx — are routed to
@@ -308,11 +335,12 @@ async function runHookWithBody(path, body, agentToken) {
         const agentEnum = agentToken ? (0, agent_1.normalizeAgent)(agentToken) : null;
         if (agentEnum)
             headers['X-Lumo-Agent'] = agentEnum;
+        const outgoingBody = augmentBodyWithUsage(path, body) || '{}';
         try {
             const res = await fetch(url, {
                 method: 'POST',
                 headers,
-                body: body || '{}',
+                body: outgoingBody,
                 signal: controller.signal,
             });
             if (!res.ok) {

package/dist/cli/src/lib/transcript-usage.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sumTranscriptUsage = sumTranscriptUsage;
+const node_fs_1 = require("node:fs");
+function asNumber(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : 0;
+}
+/**
+ * Read a Claude Code transcript JSONL and sum `message.usage` across all
+ * assistant entries -> cumulative session token totals. Best-effort: returns
+ * null if the file can't be read or has no assistant usage. Never throws.
+ */
+function sumTranscriptUsage(transcriptPath) {
+    let text;
+    try {
+        text = (0, node_fs_1.readFileSync)(transcriptPath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const total = {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheReadTokens: 0,
+        cacheCreationTokens: 0,
+    };
+    let seen = false;
+    for (const raw of text.split('\n')) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!obj || typeof obj !== 'object')
+            continue;
+        const o = obj;
+        if (o.type !== 'assistant')
+            continue;
+        const usage = o.message?.usage;
+        if (!usage)
+            continue;
+        seen = true;
+        total.inputTokens += asNumber(usage.input_tokens);
+        total.outputTokens += asNumber(usage.output_tokens);
+        total.cacheReadTokens += asNumber(usage.cache_read_input_tokens);
+        total.cacheCreationTokens += asNumber(usage.cache_creation_input_tokens);
+    }
+    return seen ? total : null;
+}

package/dist/shared/src/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // ── Agent Error types ────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tiptapToMarkdown = exports.markdownToTiptap = exports.AgentError = void 0;
+exports.parseStreamJsonUsage = exports.tiptapToMarkdown = exports.markdownToTiptap = exports.AgentError = void 0;
 exports.userFriendlyError = userFriendlyError;
 class AgentError extends Error {
     code;
@@ -33,3 +33,6 @@ function userFriendlyError(code) {
 var markdown_tiptap_1 = require("./markdown-tiptap");
 Object.defineProperty(exports, "markdownToTiptap", { enumerable: true, get: function () { return markdown_tiptap_1.markdownToTiptap; } });
 Object.defineProperty(exports, "tiptapToMarkdown", { enumerable: true, get: function () { return markdown_tiptap_1.tiptapToMarkdown; } });
+// ── Stream-json run usage parser ──────────────────────────────────────────────
+var stream_json_usage_1 = require("./stream-json-usage");
+Object.defineProperty(exports, "parseStreamJsonUsage", { enumerable: true, get: function () { return stream_json_usage_1.parseStreamJsonUsage; } });

package/dist/shared/src/stream-json-usage.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStreamJsonUsage = parseStreamJsonUsage;
+function asNumber(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : 0;
+}
+/**
+ * Parse the final `type: "result"` message of a stream-json claude run.
+ * Accepts either the whole stdout log or a single result line. Scans for the
+ * LAST parseable line whose `type === 'result'` and lifts `usage.*` +
+ * `num_turns`. Returns null when no result line is present (agent crashed or
+ * timed out before emitting one) — callers leave the cost columns null.
+ */
+function parseStreamJsonUsage(text) {
+    if (!text)
+        return null;
+    const lines = text.split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i]?.trim();
+        if (!line)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (obj &&
+            typeof obj === 'object' &&
+            obj.type === 'result') {
+            const r = obj;
+            const usage = r.usage ?? {};
+            return {
+                inputTokens: asNumber(usage['input_tokens']),
+                outputTokens: asNumber(usage['output_tokens']),
+                cacheReadTokens: asNumber(usage['cache_read_input_tokens']),
+                cacheCreationTokens: asNumber(usage['cache_creation_input_tokens']),
+                loopCount: asNumber(r.num_turns),
+            };
+        }
+    }
+    return null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumoai/cli",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "Lumo CLI — manage tasks and sessions from the terminal",
   "license": "MIT",
   "author": "cli@uselumo.ai",