crewly 1.20.186 → 1.20.188

package/dist/backend/backend/src/services/monitoring/codex-rollout-sync.service.js

@@ -0,0 +1,311 @@
+/**
+ * Codex Rollout Sync — records Codex CLI token usage in the shared ledger.
+ *
+ * Codex writes every conversation to `<codexHome>/sessions/YYYY/MM/DD/
+ * rollout-<time>-<conversation id>.jsonl`. After each model call it appends
+ * an `event_msg` line of type `token_count` whose `info.total_token_usage`
+ * is the conversation's running total (OpenAI convention: `input_tokens`
+ * includes `cached_input_tokens`; `output_tokens` includes reasoning) and
+ * `info.last_token_usage` is that one call. The model comes from the
+ * preceding `turn_context` line.
+ *
+ * Each pass reads only the bytes appended since the last pass (a byte
+ * cursor per file, persisted under CREWLY_HOME like the Claude transcript
+ * cursors) and records the DELTA of the running total, so a `token_count`
+ * line Codex repeats (it re-emits the same totals) is counted once, and a
+ * restart never re-counts a file.
+ *
+ * Attribution: Crewly persists each Codex agent's conversation id (learned
+ * from the rollout right after launch, see runtime-session-recovery) in the
+ * session state, so the rollout named `…-<id>.jsonl` belongs to that
+ * session. A cursor keeps its session after the agent moves to a fresh
+ * conversation, so the old file's last turns are still counted. Rollouts no
+ * Crewly agent owns (the owner's own Codex use) are never read.
+ *
+ * Events are stored in the ledger's "cached on top" shape (`input` = fresh
+ * tokens, `cachedInput` beside it, `runtime: 'codex-cli'`), the same as
+ * Claude transcript turns. specs/2026-10-02-spend-cap.md §Sources.
+ *
+ * @module services/monitoring/codex-rollout-sync
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { CODEX_USAGE_SYNC_CONSTANTS as C, RUNTIME_TYPES } from '../../constants.js';
+/**
+ * Read a usage block.
+ *
+ * @param u - `total_token_usage` / `last_token_usage`
+ * @returns Totals, or null when it is not one
+ */
+function totalsOf(u) {
+    if (!u || typeof u !== 'object')
+        return null;
+    const o = u;
+    const num = (k) => (typeof o[k] === 'number' && Number.isFinite(o[k]) ? Math.max(0, o[k]) : 0);
+    const input = num('input_tokens');
+    const output = num('output_tokens');
+    const total = typeof o.total_tokens === 'number' ? num('total_tokens') : input + output;
+    return { input, cached: Math.min(num('cached_input_tokens'), input), output, total };
+}
+/**
+ * Turn whole JSONL lines of a rollout into usage events. Mutates `state`.
+ *
+ * - `turn_context` sets the model;
+ * - `token_count` with a running total records the delta since the last
+ *   counted total (0 = a repeated line, skipped);
+ * - a running total that went DOWN, or the first total of a file, records
+ *   only that call's `last_token_usage` (a resumed conversation's file may
+ *   open with history counted elsewhere).
+ *
+ * @param text - Whole lines
+ * @param state - Parse state (model, last total)
+ * @returns Events in file order
+ */
+export function parseCodexRolloutLines(text, state) {
+    const events = [];
+    for (const line of text.split('\n')) {
+        if (!line.trim())
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const payload = entry.payload;
+        if (!payload || typeof payload !== 'object')
+            continue;
+        if (entry.type === 'turn_context') {
+            if (typeof payload.model === 'string' && payload.model)
+                state.model = payload.model;
+            continue;
+        }
+        if (entry.type !== 'event_msg' || payload.type !== 'token_count')
+            continue;
+        const info = payload.info;
+        if (!info)
+            continue;
+        const total = totalsOf(info.total_token_usage);
+        const last = totalsOf(info.last_token_usage);
+        if (!total && !last)
+            continue;
+        let delta;
+        const prev = state.lastTotal;
+        if (total && prev && total.total >= prev.total) {
+            delta = {
+                input: Math.max(0, total.input - prev.input),
+                cached: Math.max(0, total.cached - prev.cached),
+                output: Math.max(0, total.output - prev.output),
+                total: total.total - prev.total,
+            };
+        }
+        else {
+            delta = last ?? total;
+        }
+        if (total)
+            state.lastTotal = total;
+        if (!delta || delta.input + delta.output <= 0)
+            continue;
+        const cached = Math.min(delta.cached, delta.input);
+        events.push({
+            timestamp: entry.timestamp || new Date().toISOString(),
+            model: state.model || C.DEFAULT_MODEL,
+            input: delta.input - cached,
+            cachedInput: cached,
+            output: delta.output,
+        });
+    }
+    return events;
+}
+/**
+ * Find a conversation's rollout file by id.
+ *
+ * @param codexHome - Codex home
+ * @param conversationId - Conversation id
+ * @returns Absolute path, or null
+ */
+export async function findCodexRollout(codexHome, conversationId) {
+    const suffix = `-${conversationId}.jsonl`;
+    const stack = [path.join(codexHome, 'sessions')];
+    let visited = 0;
+    while (stack.length > 0 && visited < C.MAX_SCAN_ENTRIES) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        // Newest day directories last on the stack = visited first.
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const e of entries) {
+            visited += 1;
+            if (e.isDirectory())
+                stack.push(path.join(dir, e.name));
+            else if (e.name.startsWith('rollout-') && e.name.endsWith(suffix))
+                return path.join(dir, e.name);
+        }
+    }
+    return null;
+}
+/**
+ * Polls Codex rollouts of Crewly's Codex agents and records their usage.
+ */
+export class CodexRolloutSyncService {
+    deps;
+    cursors = new Map();
+    loaded = false;
+    running = false;
+    timer = null;
+    /** Conversation id → when a lookup last failed (ms), to avoid rescanning every pass */
+    missing = new Map();
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Run a pass now, then poll. */
+    async start() {
+        if (this.timer)
+            return;
+        await this.sync();
+        this.timer = setInterval(() => void this.sync(), C.SYNC_INTERVAL_MS);
+        this.timer.unref?.();
+    }
+    /** Stop polling. */
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /**
+     * @param filePath - Rollout path
+     * @returns Its cursor (tests, diagnostics)
+     */
+    getCursor(filePath) {
+        return this.cursors.get(filePath);
+    }
+    /**
+     * One pass: adopt rollouts of newly seen Codex conversations, then read
+     * the new tail of every known rollout.
+     *
+     * @returns What the pass recorded
+     */
+    async sync() {
+        const result = { filesRead: 0, eventsRecorded: 0, tokensRecorded: 0 };
+        if (this.running)
+            return result;
+        this.running = true;
+        let changed = false;
+        try {
+            if (!this.loaded)
+                await this.load();
+            const known = new Set([...this.cursors.values()].map((c) => c.conversationId));
+            for (const [session, info] of this.deps.sessions()) {
+                const id = info.claudeSessionId;
+                if (info.runtimeType !== RUNTIME_TYPES.CODEX_CLI || !id || known.has(id))
+                    continue;
+                const failedAt = this.missing.get(id);
+                if (failedAt !== undefined && Date.now() - failedAt < 10 * C.SYNC_INTERVAL_MS)
+                    continue;
+                const file = await findCodexRollout(this.deps.codexHome, id);
+                if (!file) {
+                    this.missing.set(id, Date.now());
+                    continue;
+                }
+                this.missing.delete(id);
+                this.cursors.set(file, { session, conversationId: id, offset: 0, model: '', lastTotal: null });
+                known.add(id);
+                changed = true;
+            }
+            for (const [file, cursor] of this.cursors) {
+                const r = await this.syncFile(file, cursor);
+                if (r.read) {
+                    result.filesRead += 1;
+                    changed = true;
+                }
+                result.eventsRecorded += r.events;
+                result.tokensRecorded += r.tokens;
+            }
+            if (changed)
+                await this.save();
+            if (result.eventsRecorded > 0)
+                this.deps.logger?.info('Synced Codex rollouts', { ...result });
+        }
+        catch (err) {
+            this.deps.logger?.warn('Codex rollout sync pass failed', { error: err instanceof Error ? err.message : String(err) });
+        }
+        finally {
+            this.running = false;
+        }
+        return result;
+    }
+    async syncFile(file, cursor) {
+        let size;
+        try {
+            size = (await fs.stat(file)).size;
+        }
+        catch {
+            return { read: false, events: 0, tokens: 0 };
+        }
+        if (size < cursor.offset) {
+            // Rewritten underneath us: start over (the running-total delta keeps
+            // already counted calls from counting twice only within one file
+            // generation, so drop the total too).
+            cursor.offset = 0;
+            cursor.lastTotal = null;
+        }
+        if (size === cursor.offset)
+            return { read: false, events: 0, tokens: 0 };
+        const handle = await fs.open(file, 'r');
+        let tail;
+        try {
+            const buf = Buffer.alloc(size - cursor.offset);
+            await handle.read(buf, 0, buf.length, cursor.offset);
+            tail = buf.toString('utf-8');
+        }
+        finally {
+            await handle.close();
+        }
+        const nl = tail.lastIndexOf('\n');
+        if (nl < 0)
+            return { read: false, events: 0, tokens: 0 };
+        const complete = tail.slice(0, nl);
+        const state = { model: cursor.model, lastTotal: cursor.lastTotal };
+        const events = parseCodexRolloutLines(complete, state);
+        cursor.offset += Buffer.byteLength(complete, 'utf-8') + 1;
+        cursor.model = state.model;
+        cursor.lastTotal = state.lastTotal;
+        let tokens = 0;
+        for (const e of events) {
+            this.deps.record(cursor.session, e);
+            tokens += e.input + e.cachedInput + e.output;
+        }
+        return { read: true, events: events.length, tokens };
+    }
+    async load() {
+        this.loaded = true;
+        try {
+            const parsed = JSON.parse(await fs.readFile(this.deps.cursorFile, 'utf-8'));
+            this.cursors = new Map(Object.entries(parsed));
+        }
+        catch {
+            this.cursors = new Map();
+        }
+    }
+    async save() {
+        const tmp = `${this.deps.cursorFile}.tmp`;
+        try {
+            await fs.mkdir(path.dirname(this.deps.cursorFile), { recursive: true });
+            await fs.writeFile(tmp, JSON.stringify(Object.fromEntries(this.cursors), null, 2), 'utf-8');
+            await fs.rename(tmp, this.deps.cursorFile);
+        }
+        catch (err) {
+            this.deps.logger?.warn('Could not save Codex rollout cursors', { error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+}
+//# sourceMappingURL=codex-rollout-sync.service.js.map

package/dist/backend/backend/src/services/monitoring/codex-rollout-sync.service.js.map

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

package/dist/backend/backend/src/services/monitoring/token-usage.service.d.ts

@@ -34,6 +34,12 @@ export interface TokenUsageEvent {
      * rate) rather than read from it. Claude only; absent when unknown.
      */
     cacheWrite?: number;
+    /**
+     * Runtime that produced the event (`codex-cli`, `antigravity-cli`, …), set
+     * by the sources that know it. Absent on older events and on sources that
+     * only know the model; {@link runtimeOfEvent} then infers it from the model.
+     */
+    runtime?: string;
 }
 /** Optional per-event detail beyond the raw input/output counts. */
 export interface TokenUsageDetail {
@@ -49,6 +55,8 @@ export interface TokenUsageDetail {
      * any per-day or per-hour view of the data is wrong.
      */
     timestamp?: string;
+    /** See {@link TokenUsageEvent.runtime}. */
+    runtime?: string;
 }
 /**
  * Per-session token usage record containing all events and aggregates
@@ -137,6 +145,63 @@ export declare const TOKEN_COSTS: Record<string, {
  * @returns Cost in USD
  */
 export declare function calculateCost(inputTokens: number, outputTokens: number, model: string, cachedInputTokens?: number): number;
+/**
+ * USD cost of one recorded usage event — the one cost computation every
+ * spend view uses (session windows, the team budget gate, the ticket
+ * autopilot budget, the per-agent spend cap).
+ *
+ * The ledger holds two shapes of event:
+ * - in-process runs (`provider/model`, e.g. DeepSeek): `cachedInput` is the
+ *   cache-hit PART of `input`, priced with {@link TOKEN_COSTS};
+ * - Claude Code transcript turns: `input` is the fresh tokens only and
+ *   `cachedInput` (cache reads + `cacheWrite`) comes on top, priced with the
+ *   cache-aware model-pricing table. Pricing these with {@link TOKEN_COSTS}
+ *   dropped every cached token and used sonnet rates for opus.
+ *
+ * @param event - The usage event
+ * @returns Cost in USD
+ */
+export declare function eventCostUsd(event: Pick<TokenUsageEvent, 'input' | 'output' | 'model' | 'cachedInput' | 'cacheWrite'>): number;
+/** The token figures of one event in the owner-facing unit (see {@link eventTokens}). */
+export interface EventTokens {
+    /** Every input token, cached ones included */
+    input: number;
+    /** The cached part of {@link input} (cache reads + cache writes) */
+    cachedInput: number;
+    output: number;
+    /** {@link input} + {@link output} — what caps, boosts and budgets count */
+    total: number;
+}
+/**
+ * Whether an event's `cachedInput` is part of its `input` (true) or comes
+ * on top of it (false).
+ *
+ * - In-process runs (`provider/model`, e.g. DeepSeek) report the provider's
+ *   prompt-token count, which includes cache hits: part of `input`.
+ * - Claude Code transcript turns, Codex rollouts and Antigravity record
+ *   `input` as the fresh tokens only, with the cached ones on top.
+ *
+ * @param event - Usage event
+ * @returns True when cached tokens are already inside `input`
+ */
+export declare function cachedIsPartOfInput(event: Pick<TokenUsageEvent, 'model' | 'runtime'>): boolean;
+/**
+ * The token unit — ONE formula for every cap, boost, budget and stat:
+ *
+ *   total tokens = input tokens (fresh + cached) + output tokens
+ *
+ * Cached input counts in full (it is shown separately, never left out), and
+ * whether an account is billed by subscription or by API makes no
+ * difference. specs/2026-10-02-spend-cap.md §Token unit.
+ *
+ * @param event - Usage event
+ * @returns Input (cached included), cached input, output, total
+ *
+ * @example
+ * eventTokens({ model: 'claude-opus-5-5', input: 10, cachedInput: 990, output: 50 }).total // 1050
+ * eventTokens({ model: 'deepseek/deepseek-chat', input: 1000, cachedInput: 990, output: 50 }).total // 1050
+ */
+export declare function eventTokens(event: Pick<TokenUsageEvent, 'model' | 'runtime' | 'input' | 'output' | 'cachedInput'>): EventTokens;
 /**
  * Set a cost override for a session. When present, getSummary() uses this
  * instead of recalculating from events.
@@ -264,13 +329,25 @@ export declare class TokenUsageService {
      * @param sessionName - The session to query (e.g. 'crewly-orc')
      * @param since - Only return events recorded at or after this time
      * @param until - Only return events before this time (defaults to now)
-     * @returns Aggregated input tokens, output tokens, and cost in the window
+     * @returns Aggregated input tokens, output tokens, and cost in the window,
+     *   plus the token-unit figures ({@link eventTokens}): `totalTokens` (the
+     *   unit caps and budgets count) and `cachedInputTokens`
      */
     getSessionUsageSince(sessionName: string, since: Date, until?: Date): {
         inputTokens: number;
         outputTokens: number;
         cost: number;
+        totalTokens: number;
+        cachedInputTokens: number;
     };
+    /**
+     * Visit every recorded event at or after `since` (all events when omitted).
+     * Read-only; used by the spend ledger for per-day / per-agent views.
+     *
+     * @param visit - Called with the session name and the event
+     * @param since - Lower bound (inclusive)
+     */
+    forEachEvent(visit: (sessionName: string, event: TokenUsageEvent) => void, since?: Date): void;
     /**
      * Clear all tracked token usage data.
      */

package/dist/backend/backend/src/services/monitoring/token-usage.service.d.ts.map

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

package/dist/backend/backend/src/services/monitoring/token-usage.service.js

@@ -8,6 +8,7 @@
  */
 import { promises as fs } from 'fs';
 import * as path from 'path';
+import { calculateCost as calculateCacheAwareCost, resolveRate } from './model-pricing.js';
 /** File name for persisting token usage data */
 const TOKEN_USAGE_FILE = 'token-usage.json';
 /** Interval in milliseconds between periodic flushes to disk (5 minutes) */
@@ -59,6 +60,73 @@ export function calculateCost(inputTokens, outputTokens, model, cachedInputToken
     const cached = rates.cachedInput !== undefined ? Math.min(Math.max(cachedInputTokens, 0), inputTokens) : 0;
     return (inputTokens - cached) * rates.input + cached * (rates.cachedInput ?? 0) + outputTokens * rates.output;
 }
+/**
+ * USD cost of one recorded usage event — the one cost computation every
+ * spend view uses (session windows, the team budget gate, the ticket
+ * autopilot budget, the per-agent spend cap).
+ *
+ * The ledger holds two shapes of event:
+ * - in-process runs (`provider/model`, e.g. DeepSeek): `cachedInput` is the
+ *   cache-hit PART of `input`, priced with {@link TOKEN_COSTS};
+ * - Claude Code transcript turns: `input` is the fresh tokens only and
+ *   `cachedInput` (cache reads + `cacheWrite`) comes on top, priced with the
+ *   cache-aware model-pricing table. Pricing these with {@link TOKEN_COSTS}
+ *   dropped every cached token and used sonnet rates for opus.
+ *
+ * @param event - The usage event
+ * @returns Cost in USD
+ */
+export function eventCostUsd(event) {
+    const model = event.model || '';
+    const unprefixed = model.includes('/') ? model.slice(model.indexOf('/') + 1) : model;
+    const legacyKey = TOKEN_COSTS[model] ? model : TOKEN_COSTS[unprefixed] ? unprefixed : null;
+    if (!model.includes('/') && resolveRate(model).source !== 'default') {
+        const write = Math.max(0, event.cacheWrite ?? 0);
+        const read = Math.max(0, (event.cachedInput ?? 0) - write);
+        return calculateCacheAwareCost({ input: event.input, output: event.output, cacheRead: read, cacheWrite: write }, model).cost;
+    }
+    return calculateCost(event.input, event.output, legacyKey ?? model, event.cachedInput ?? 0);
+}
+/**
+ * Whether an event's `cachedInput` is part of its `input` (true) or comes
+ * on top of it (false).
+ *
+ * - In-process runs (`provider/model`, e.g. DeepSeek) report the provider's
+ *   prompt-token count, which includes cache hits: part of `input`.
+ * - Claude Code transcript turns, Codex rollouts and Antigravity record
+ *   `input` as the fresh tokens only, with the cached ones on top.
+ *
+ * @param event - Usage event
+ * @returns True when cached tokens are already inside `input`
+ */
+export function cachedIsPartOfInput(event) {
+    if (event.runtime)
+        return event.runtime === 'crewly-agent';
+    return (event.model || '').includes('/');
+}
+/**
+ * The token unit — ONE formula for every cap, boost, budget and stat:
+ *
+ *   total tokens = input tokens (fresh + cached) + output tokens
+ *
+ * Cached input counts in full (it is shown separately, never left out), and
+ * whether an account is billed by subscription or by API makes no
+ * difference. specs/2026-10-02-spend-cap.md §Token unit.
+ *
+ * @param event - Usage event
+ * @returns Input (cached included), cached input, output, total
+ *
+ * @example
+ * eventTokens({ model: 'claude-opus-5-5', input: 10, cachedInput: 990, output: 50 }).total // 1050
+ * eventTokens({ model: 'deepseek/deepseek-chat', input: 1000, cachedInput: 990, output: 50 }).total // 1050
+ */
+export function eventTokens(event) {
+    const raw = Math.max(0, event.input || 0);
+    const cached = Math.max(0, event.cachedInput || 0);
+    const output = Math.max(0, event.output || 0);
+    const input = cachedIsPartOfInput(event) ? Math.max(raw, cached) : raw + cached;
+    return { input, cachedInput: Math.min(cached, input), output, total: input + output };
+}
 /**
  * Stores a pre-calculated cost override for a session.
  * Used when the caller has more accurate cost data (e.g., cache-aware pricing
@@ -169,6 +237,7 @@ export class TokenUsageService {
             ...(detail?.cachedInput !== undefined ? { cachedInput: detail.cachedInput } : {}),
             ...(detail?.steps !== undefined ? { steps: detail.steps } : {}),
             ...(detail?.cacheWrite ? { cacheWrite: detail.cacheWrite } : {}),
+            ...(detail?.runtime ? { runtime: detail.runtime } : {}),
         };
         record.events.push(event);
         record.totalInput += input;
@@ -326,17 +395,21 @@ export class TokenUsageService {
      * @param sessionName - The session to query (e.g. 'crewly-orc')
      * @param since - Only return events recorded at or after this time
      * @param until - Only return events before this time (defaults to now)
-     * @returns Aggregated input tokens, output tokens, and cost in the window
+     * @returns Aggregated input tokens, output tokens, and cost in the window,
+     *   plus the token-unit figures ({@link eventTokens}): `totalTokens` (the
+     *   unit caps and budgets count) and `cachedInputTokens`
      */
     getSessionUsageSince(sessionName, since, until) {
         const record = this.sessions.get(sessionName);
         if (!record)
-            return { inputTokens: 0, outputTokens: 0, cost: 0 };
+            return { inputTokens: 0, outputTokens: 0, cost: 0, totalTokens: 0, cachedInputTokens: 0 };
         const sinceMs = since.getTime();
         const untilMs = until ? until.getTime() : Infinity;
         let inputTokens = 0;
         let outputTokens = 0;
         let cost = 0;
+        let totalTokens = 0;
+        let cachedInputTokens = 0;
         for (const event of record.events) {
             const eventMs = new Date(event.timestamp).getTime();
             if (eventMs >= sinceMs && eventMs <= untilMs) {
@@ -345,10 +418,29 @@ export class TokenUsageService {
                 // Cache-aware: a cache hit is billed at a fraction of the miss rate,
                 // and the team budget gate keys on this figure — pricing every input
                 // token at the miss rate would trip monthly USD caps ~40x early.
-                cost += calculateCost(event.input, event.output, event.model, event.cachedInput ?? 0);
+                cost += eventCostUsd(event);
+                const t = eventTokens(event);
+                totalTokens += t.total;
+                cachedInputTokens += t.cachedInput;
+            }
+        }
+        return { inputTokens, outputTokens, cost, totalTokens, cachedInputTokens };
+    }
+    /**
+     * Visit every recorded event at or after `since` (all events when omitted).
+     * Read-only; used by the spend ledger for per-day / per-agent views.
+     *
+     * @param visit - Called with the session name and the event
+     * @param since - Lower bound (inclusive)
+     */
+    forEachEvent(visit, since) {
+        const sinceMs = since ? since.getTime() : -Infinity;
+        for (const record of this.sessions.values()) {
+            for (const event of record.events) {
+                if (new Date(event.timestamp).getTime() >= sinceMs)
+                    visit(record.sessionName, event);
             }
         }
-        return { inputTokens, outputTokens, cost };
     }
     /**
      * Clear all tracked token usage data.