crewly 1.20.73 → 1.20.75

package/dist/backend/backend/src/services/monitoring/claude-transcript-sync.service.js

@@ -0,0 +1,484 @@
+/**
+ * Claude Transcript Sync Service
+ *
+ * Keeps the Usage dashboard honest for `claude-code` agents by reading the
+ * exact per-turn `usage` block that Claude Code writes into its own session
+ * transcript, and feeding it into {@link TokenUsageService}.
+ *
+ * This replaces a boot-time sync that never recorded anything. That version
+ * had four defects, each of which this module exists to avoid:
+ *
+ * 1. It derived the transcript directory from `CREWLY_HOME`, but agents run
+ *    with their project as the working directory, so it always read an empty
+ *    or absent folder. We take each session's real `cwd` from
+ *    {@link SessionStatePersistence} instead.
+ * 2. It ran once at startup, so nothing an agent did afterwards was counted.
+ *    We poll on an interval and read only the bytes appended since last time.
+ * 3. It keyed records on the Claude conversation UUID and re-added the whole
+ *    running total on every call, so a restart double-counted the entire
+ *    history. We key on the Crewly session name and keep a byte cursor plus a
+ *    recent-message-id set so a turn is counted exactly once.
+ * 4. Its price table stopped at an older model generation, so current models
+ *    silently fell through to the sonnet default. Pricing now lives in
+ *    {@link module:services/monitoring/model-pricing} and reports whether a
+ *    rate was an exact match.
+ *
+ * As a side effect the sync knows each agent's true context size — the sum of
+ * fresh, cached and cache-written input on its most recent turn — which is the
+ * only reliable source for it, since Claude Code's TUI context readout is not
+ * capturable from PTY scrollback. That number is handed to an observer so the
+ * context-window monitor can act on real figures.
+ *
+ * @module services/monitoring/claude-transcript-sync
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { LoggerService } from '../core/logger.service.js';
+import { getSessionStatePersistence } from '../session/session-state-persistence.js';
+import { TokenUsageService } from './token-usage.service.js';
+import { calculateCost } from './model-pricing.js';
+import { CLAUDE_TRANSCRIPT_SYNC_CONSTANTS } from '../../constants.js';
+import { encodeProjectSlug } from './claude-session-tokens.service.js';
+/**
+ * Reads Claude Code transcripts on an interval and records exact token usage.
+ *
+ * @example
+ * ```typescript
+ * const sync = ClaudeTranscriptSyncService.getInstance();
+ * sync.onContextReading((r) => monitor.updateContextTokens(r.sessionName, r.contextTokens));
+ * await sync.start();
+ * ```
+ */
+export class ClaudeTranscriptSyncService {
+    static instance = null;
+    logger;
+    cursorFile;
+    /**
+     * Home directory that `~/.claude/projects` is resolved against.
+     *
+     * Injectable because `os.homedir()` does not reliably follow a `$HOME`
+     * override once the process has already resolved it, which makes it
+     * untestable against a temp tree.
+     */
+    homeDir;
+    cursors = new Map();
+    timer = null;
+    observers = [];
+    loaded = false;
+    /** Guards against a slow pass overlapping the next tick. */
+    running = false;
+    /**
+     * @param cursorFile - Override the cursor persistence path (tests)
+     * @param homeDir - Override the home directory transcripts live under (tests)
+     */
+    constructor(cursorFile, homeDir) {
+        this.logger = LoggerService.getInstance().createComponentLogger('ClaudeTranscriptSync');
+        this.homeDir = homeDir ?? os.homedir();
+        this.cursorFile =
+            cursorFile ?? path.join(this.homeDir, '.crewly', CLAUDE_TRANSCRIPT_SYNC_CONSTANTS.CURSOR_FILE);
+    }
+    /**
+     * Get the shared instance.
+     *
+     * @returns The singleton service
+     */
+    static getInstance() {
+        if (!ClaudeTranscriptSyncService.instance) {
+            ClaudeTranscriptSyncService.instance = new ClaudeTranscriptSyncService();
+        }
+        return ClaudeTranscriptSyncService.instance;
+    }
+    /** Drops the singleton and stops its timer (tests). */
+    static resetInstance() {
+        ClaudeTranscriptSyncService.instance?.stop();
+        ClaudeTranscriptSyncService.instance = null;
+    }
+    /**
+     * Register a callback to receive each session's context size per pass.
+     *
+     * @param observer - Invoked once per session that produced a new turn
+     */
+    onContextReading(observer) {
+        this.observers.push(observer);
+    }
+    /**
+     * Load cursors, run one pass immediately, then poll.
+     *
+     * Safe to call twice; the second call is a no-op.
+     */
+    async start() {
+        if (this.timer)
+            return;
+        await this.loadCursors();
+        await this.sync();
+        this.timer = setInterval(() => {
+            void this.sync();
+        }, CLAUDE_TRANSCRIPT_SYNC_CONSTANTS.SYNC_INTERVAL_MS);
+        // Never hold the event loop open for a metrics poll.
+        this.timer.unref?.();
+        this.logger.info('Claude transcript sync started', {
+            intervalMs: CLAUDE_TRANSCRIPT_SYNC_CONSTANTS.SYNC_INTERVAL_MS,
+            cursorFile: this.cursorFile,
+        });
+    }
+    /** Stops polling. Cursors already on disk are left alone. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Run one sync pass across every registered claude-code session.
+     *
+     * Overlapping calls are dropped rather than queued — a pass that outruns
+     * the interval means the machine is busy, and piling up reads of
+     * multi-megabyte transcripts would make that worse.
+     *
+     * @returns What the pass counted
+     */
+    async sync() {
+        const result = {
+            sessionsUpdated: 0,
+            turnsCounted: 0,
+            costAdded: 0,
+            sessionsWithoutTranscript: 0,
+        };
+        if (this.running)
+            return result;
+        this.running = true;
+        try {
+            if (!this.loaded)
+                await this.loadCursors();
+            const sessions = getSessionStatePersistence().getRegisteredSessionsMap();
+            // Several agents commonly work in one repo. Count them up front so
+            // transcript resolution knows when a directory cannot identify a
+            // single agent.
+            const perCwd = new Map();
+            for (const info of sessions.values()) {
+                if (info.runtimeType !== 'claude-code' || !info.cwd)
+                    continue;
+                perCwd.set(info.cwd, (perCwd.get(info.cwd) ?? 0) + 1);
+            }
+            for (const [sessionName, info] of sessions) {
+                // Only Claude Code writes the transcripts this service reads.
+                if (info.runtimeType !== 'claude-code')
+                    continue;
+                if (!info.cwd)
+                    continue;
+                const filePath = await this.resolveTranscript(info.cwd, info.claudeSessionId, (perCwd.get(info.cwd) ?? 0) > 1);
+                if (!filePath) {
+                    result.sessionsWithoutTranscript += 1;
+                    continue;
+                }
+                const counted = await this.syncOne(sessionName, filePath);
+                if (counted.turns > 0) {
+                    result.sessionsUpdated += 1;
+                    result.turnsCounted += counted.turns;
+                    result.costAdded += counted.cost;
+                }
+                else {
+                    // No new turns, but the agent is still carrying whatever it
+                    // was carrying. Re-announce it so a monitor that started
+                    // after the first reading still learns the figure.
+                    const known = this.cursors.get(sessionName)?.lastContextTokens;
+                    if (known !== undefined) {
+                        this.emitContext({ sessionName, contextTokens: known, model: '' });
+                    }
+                }
+            }
+            if (result.sessionsUpdated > 0) {
+                await this.saveCursors();
+                this.logger.info('Synced Claude transcripts', result);
+            }
+        }
+        catch (err) {
+            // A metrics poll must never take the server down.
+            this.logger.warn('Claude transcript sync pass failed', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        finally {
+            this.running = false;
+        }
+        return result;
+    }
+    /**
+     * Locate a session's transcript file.
+     *
+     * Prefers the conversation id Crewly recorded when it launched the agent.
+     * Falls back to the newest transcript in the project's slug directory,
+     * which covers an agent whose id has not been captured yet.
+     *
+     * @param cwd - The agent's working directory
+     * @param claudeSessionId - Conversation id, when known
+     * @param cwdIsShared - Whether another registered session works in the
+     *                      same directory, which makes newest-wins unsafe
+     * @returns Absolute path, or null when nothing readable exists
+     */
+    async resolveTranscript(cwd, claudeSessionId, cwdIsShared) {
+        const dir = path.join(this.homeDir, '.claude', 'projects', encodeProjectSlug(cwd));
+        if (claudeSessionId) {
+            const direct = path.join(dir, `${claudeSessionId}.jsonl`);
+            try {
+                await fs.access(direct);
+                return direct;
+            }
+            catch {
+                // Recorded id has no file — fall through to newest-wins.
+            }
+        }
+        // Newest transcript in the project directory. Covers an agent whose
+        // conversation id Crewly has not captured yet.
+        //
+        // Only safe when this agent is the sole one working in this directory.
+        // Several agents in one repo share a slug directory, so newest-wins
+        // would hand all of them the same transcript and attribute one busy
+        // agent's turns — and its context size — to every one of its
+        // colleagues. Observed exactly that: four agents each reported the
+        // same 726,475 tokens, which was one agent's figure. Waiting for the
+        // conversation id costs a little early data; guessing costs the
+        // dashboard its meaning.
+        if (cwdIsShared)
+            return null;
+        let files;
+        try {
+            files = await fs.readdir(dir);
+        }
+        catch {
+            return null;
+        }
+        let newest = '';
+        let newestMtime = -1;
+        for (const file of files) {
+            if (!file.endsWith('.jsonl'))
+                continue;
+            try {
+                const { mtimeMs } = await fs.stat(path.join(dir, file));
+                if (mtimeMs > newestMtime) {
+                    newestMtime = mtimeMs;
+                    newest = file;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return newest ? path.join(dir, newest) : null;
+    }
+    /**
+     * Consume the unread tail of one transcript and record what it holds.
+     *
+     * @param sessionName - Crewly session name, used as the usage key
+     * @param filePath - Transcript to read
+     * @returns Turns counted and cost added for this session
+     */
+    async syncOne(sessionName, filePath) {
+        let cursor = this.cursors.get(sessionName);
+        // A different transcript means the agent was given a new conversation
+        // (a fresh session id, not a resume). Start its cursor over, but keep
+        // the cost so the dashboard shows the agent's lifetime spend.
+        if (!cursor || cursor.filePath !== filePath) {
+            cursor = { filePath, offset: 0, seenMessageIds: [], cost: cursor?.cost ?? 0 };
+            this.cursors.set(sessionName, cursor);
+        }
+        let size;
+        try {
+            size = (await fs.stat(filePath)).size;
+        }
+        catch {
+            return { turns: 0, cost: 0 };
+        }
+        // Truncated or rotated underneath us — re-read from the top rather
+        // than seeking past the end and silently counting nothing forever.
+        if (size < cursor.offset) {
+            cursor.offset = 0;
+            cursor.seenMessageIds = [];
+        }
+        if (size === cursor.offset)
+            return { turns: 0, cost: 0 };
+        const tail = await this.readFrom(filePath, cursor.offset, size);
+        // Only advance past whole lines; a partial trailing line is re-read next pass.
+        const lastNewline = tail.lastIndexOf('\n');
+        if (lastNewline < 0)
+            return { turns: 0, cost: 0 };
+        const complete = tail.slice(0, lastNewline);
+        const consumedBytes = Buffer.byteLength(complete, 'utf-8') + 1;
+        const seen = new Set(cursor.seenMessageIds);
+        const turns = this.parseTurns(complete, seen);
+        cursor.offset += consumedBytes;
+        if (turns.length === 0)
+            return { turns: 0, cost: 0 };
+        const tokenSvc = TokenUsageService.getInstance();
+        let costAdded = 0;
+        let latest = null;
+        for (const turn of turns) {
+            const { cost } = calculateCost({ input: turn.input, output: turn.output, cacheRead: turn.cacheRead, cacheWrite: turn.cacheWrite }, turn.model);
+            costAdded += cost;
+            // `input` stays the fresh-token count so the dashboard's input
+            // column means what it says; cached tokens ride along in `detail`
+            // and are what make the cost figure meaningful.
+            tokenSvc.recordUsage(sessionName, sessionName, turn.input, turn.output, turn.model, undefined, {
+                cachedInput: turn.cacheRead + turn.cacheWrite,
+                timestamp: turn.timestamp,
+            });
+            seen.add(turn.messageId);
+            latest = turn;
+        }
+        cursor.cost += costAdded;
+        tokenSvc.overrideSessionCost(sessionName, cursor.cost);
+        // Keep the dedupe set bounded — only the newest ids can collide with
+        // a line Claude Code rewrites.
+        cursor.seenMessageIds = Array.from(seen).slice(-CLAUDE_TRANSCRIPT_SYNC_CONSTANTS.MAX_DEDUPE_IDS);
+        if (latest) {
+            const contextTokens = latest.input + latest.cacheRead + latest.cacheWrite;
+            cursor.lastContextTokens = contextTokens;
+            this.emitContext({ sessionName, contextTokens, model: latest.model });
+        }
+        return { turns: turns.length, cost: costAdded };
+    }
+    /**
+     * Read a byte range of a file as UTF-8.
+     *
+     * Reads only the new tail; these transcripts reach tens of megabytes and
+     * loading one whole on every poll is what makes a naive version of this
+     * service more expensive than the usage it measures.
+     *
+     * @param filePath - File to read
+     * @param start - First byte to read
+     * @param end - Exclusive end byte
+     * @returns The decoded slice
+     */
+    async readFrom(filePath, start, end) {
+        const handle = await fs.open(filePath, 'r');
+        try {
+            const length = end - start;
+            const buf = Buffer.alloc(length);
+            await handle.read(buf, 0, length, start);
+            return buf.toString('utf-8');
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    /**
+     * Extract the assistant turns from a slice of transcript.
+     *
+     * @param text - Whole lines of JSONL
+     * @param seen - Message ids already counted; matches are skipped
+     * @returns Turns in file order
+     */
+    parseTurns(text, seen) {
+        const turns = [];
+        for (const line of text.split('\n')) {
+            if (!line.trim())
+                continue;
+            let entry;
+            try {
+                entry = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (entry.type !== 'assistant')
+                continue;
+            const msg = entry.message;
+            const usage = msg?.usage;
+            if (!msg || !usage)
+                continue;
+            const input = usage.input_tokens || 0;
+            const output = usage.output_tokens || 0;
+            const cacheRead = usage.cache_read_input_tokens || 0;
+            const cacheWrite = usage.cache_creation_input_tokens || 0;
+            // Claude Code writes `<synthetic>` entries — cancellations, tool
+            // bookkeeping — with an all-zero usage block. They are not model
+            // round-trips. Counting them inflates the turn count, and worse,
+            // one landing last makes the agent look like it is carrying no
+            // context at all: Atlas sat behind three of them reporting 0
+            // while actually holding 726k tokens.
+            if (input === 0 && output === 0 && cacheRead === 0 && cacheWrite === 0)
+                continue;
+            const messageId = msg.id || `${entry.timestamp}`;
+            if (seen.has(messageId))
+                continue;
+            seen.add(messageId);
+            turns.push({
+                messageId,
+                timestamp: entry.timestamp || new Date().toISOString(),
+                model: msg.model || '',
+                input,
+                output,
+                cacheRead,
+                cacheWrite,
+            });
+        }
+        return turns;
+    }
+    /**
+     * Hand a context reading to every observer, isolating their failures.
+     *
+     * @param reading - The measurement to publish
+     */
+    emitContext(reading) {
+        for (const observer of this.observers) {
+            try {
+                observer(reading);
+            }
+            catch (err) {
+                this.logger.warn('Context observer threw', {
+                    sessionName: reading.sessionName,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    /** Reads persisted cursors; a missing or corrupt file starts fresh. */
+    async loadCursors() {
+        this.loaded = true;
+        try {
+            const raw = await fs.readFile(this.cursorFile, 'utf-8');
+            const parsed = JSON.parse(raw);
+            this.cursors = new Map(Object.entries(parsed));
+            this.logger.debug('Loaded transcript cursors', { sessions: this.cursors.size });
+        }
+        catch {
+            this.cursors = new Map();
+        }
+    }
+    /** Writes cursors atomically so a crash mid-write cannot corrupt them. */
+    async saveCursors() {
+        const obj = {};
+        for (const [k, v] of this.cursors)
+            obj[k] = v;
+        const tmp = `${this.cursorFile}.tmp`;
+        try {
+            await fs.mkdir(path.dirname(this.cursorFile), { recursive: true });
+            await fs.writeFile(tmp, JSON.stringify(obj, null, 2), 'utf-8');
+            await fs.rename(tmp, this.cursorFile);
+        }
+        catch (err) {
+            this.logger.warn('Failed to persist transcript cursors', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    /**
+     * Current cursor for a session (tests and diagnostics).
+     *
+     * @param sessionName - Crewly session name
+     * @returns The cursor, or undefined if the session has never synced
+     */
+    getCursor(sessionName) {
+        return this.cursors.get(sessionName);
+    }
+}
+/**
+ * Convenience accessor for the shared sync service.
+ *
+ * @returns The singleton instance
+ */
+export function getClaudeTranscriptSync() {
+    return ClaudeTranscriptSyncService.getInstance();
+}
+//# sourceMappingURL=claude-transcript-sync.service.js.map

package/dist/backend/backend/src/services/monitoring/claude-transcript-sync.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-transcript-sync.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/monitoring/claude-transcript-sync.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/monitoring/model-pricing.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Model Pricing Table
+ *
+ * List prices for the runtimes Crewly drives, used to turn raw token counts
+ * into a cost figure for the Usage dashboard.
+ *
+ * Two things to keep in mind when reading a cost produced from this table:
+ *
+ * 1. These are pay-as-you-go API list prices. An agent running under a Max
+ *    subscription does not generate a bill at these rates — the number is an
+ *    API-equivalent, useful for comparing agents against each other and for
+ *    spotting runaway context, not for reconciling an invoice.
+ * 2. Cache reads are far cheaper than fresh input and cache writes are dearer,
+ *    so a cost computed without splitting them out is wrong by an order of
+ *    magnitude for a long-lived agent. Every rate here is cache-aware and
+ *    {@link calculateCost} requires the split.
+ *
+ * When a model is not listed by name we fall back to its family (the `opus` /
+ * `sonnet` / `haiku` substring) and finally to the sonnet tier. The resolved
+ * rate carries a `source` so callers can mark an estimated cost as estimated
+ * rather than presenting a guess as a measurement.
+ *
+ * @module services/monitoring/model-pricing
+ */
+/** Per-token USD rates for one model, split by how the tokens were billed. */
+export interface ModelRate {
+    /** USD per fresh (uncached) input token */
+    input: number;
+    /** USD per output token */
+    output: number;
+    /** USD per token read from the prompt cache */
+    cacheRead: number;
+    /** USD per token written to the prompt cache */
+    cacheWrite: number;
+}
+/** A {@link ModelRate} plus how confidently it was matched to the model. */
+export interface ResolvedModelRate extends ModelRate {
+    /**
+     * `exact` — the model id is listed by name.
+     * `family` — matched on an `opus`/`sonnet`/`haiku`/`fable` substring.
+     * `default` — nothing matched; the sonnet tier was assumed.
+     *
+     * Anything other than `exact` means the cost is an estimate.
+     */
+    source: 'exact' | 'family' | 'default';
+}
+/** Opus-class list price (USD per 1M tokens). */
+export declare const OPUS_TIER: ModelRate;
+/** Sonnet-class list price (USD per 1M tokens). */
+export declare const SONNET_TIER: ModelRate;
+/** Haiku-class list price (USD per 1M tokens), 4.5 generation. */
+export declare const HAIKU_TIER: ModelRate;
+/**
+ * Resolves the billing rate for a model id.
+ *
+ * @param model - Model id as the runtime reported it (e.g. `claude-opus-5`)
+ * @returns The rate plus how it was matched; never throws, never returns null
+ *
+ * @example
+ * ```typescript
+ * const rate = resolveRate('claude-opus-5');   // source: 'exact'
+ * const guess = resolveRate('claude-fable-5-1'); // source: 'family'
+ * ```
+ */
+export declare function resolveRate(model: string): ResolvedModelRate;
+/** The four token counts that make up one model round-trip. */
+export interface TokenSplit {
+    /** Fresh input tokens (not served from cache) */
+    input: number;
+    /** Output tokens */
+    output: number;
+    /** Input tokens served from the prompt cache */
+    cacheRead: number;
+    /** Input tokens written into the prompt cache */
+    cacheWrite: number;
+}
+/**
+ * Computes the cache-aware cost of one or more model round-trips.
+ *
+ * @param split - The four token counts; pass 0 for any the runtime omits
+ * @param model - Model id as the runtime reported it
+ * @returns Cost in USD, and whether the rate was an exact match
+ *
+ * @example
+ * ```typescript
+ * const { cost, estimated } = calculateCost(
+ *   { input: 500, output: 200, cacheRead: 690_000, cacheWrite: 0 },
+ *   'claude-opus-5',
+ * );
+ * ```
+ */
+export declare function calculateCost(split: TokenSplit, model: string): {
+    cost: number;
+    estimated: boolean;
+    rateSource: ResolvedModelRate['source'];
+};
+//# sourceMappingURL=model-pricing.d.ts.map

package/dist/backend/backend/src/services/monitoring/model-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/monitoring/model-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IACnD;;;;;;OAMG;IACH,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvC;AAYD,iDAAiD;AACjD,eAAO,MAAM,SAAS,WAAiC,CAAC;AACxD,mDAAmD;AACnD,eAAO,MAAM,WAAW,WAA+B,CAAC;AACxD,kEAAkE;AAClE,eAAO,MAAM,UAAU,WAA8B,CAAC;AAsCtD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAW5D;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;CAAE,CAQ/E"}