crewly 1.20.186 → 1.20.187

package/dist/backend/backend/src/services/spend/spend-cap.store.js

@@ -0,0 +1,95 @@
+/**
+ * Spend caps on disk: the owner's caps plus today's bookkeeping (raises,
+ * the 80% notices and stop cards already sent). One small JSON file under
+ * CREWLY_HOME, written atomically.
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.store
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'fs';
+import * as path from 'path';
+/**
+ * Caps off, nothing recorded.
+ *
+ * @param date - Local day
+ * @returns Fresh file
+ */
+export function emptySpendCapFile(date) {
+    return {
+        config: { defaultAgentCapUsd: null, totalCapUsd: null, agentCapsUsd: {} },
+        day: emptyDay(date),
+    };
+}
+/**
+ * Empty day state.
+ *
+ * @param date - Local day
+ * @returns State
+ */
+export function emptyDay(date) {
+    return { date, raised: {}, warned: [], stopped: [], cards: {} };
+}
+/**
+ * JSON file store.
+ */
+export class FileSpendCapStore {
+    file;
+    /**
+     * @param file - Absolute path
+     */
+    constructor(file) {
+        this.file = file;
+    }
+    /**
+     * @returns The file, or null when absent / unreadable
+     */
+    read() {
+        try {
+            if (!existsSync(this.file))
+                return null;
+            const raw = JSON.parse(readFileSync(this.file, 'utf-8'));
+            if (!raw || typeof raw !== 'object' || !raw.config)
+                return null;
+            return {
+                config: {
+                    defaultAgentCapUsd: raw.config.defaultAgentCapUsd ?? null,
+                    totalCapUsd: raw.config.totalCapUsd ?? null,
+                    agentCapsUsd: raw.config.agentCapsUsd ?? {},
+                    ...(raw.config.updatedAt ? { updatedAt: raw.config.updatedAt } : {}),
+                },
+                day: {
+                    ...emptyDay(raw.day?.date ?? ''),
+                    ...(raw.day ?? {}),
+                },
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * @param file - Contents to persist
+     */
+    write(file) {
+        mkdirSync(path.dirname(this.file), { recursive: true });
+        const tmp = `${this.file}.tmp`;
+        writeFileSync(tmp, JSON.stringify(file, null, 2), 'utf-8');
+        renameSync(tmp, this.file);
+    }
+}
+/**
+ * In-memory store (tests).
+ */
+export class MemorySpendCapStore {
+    file = null;
+    /** @returns Stored copy */
+    read() {
+        return this.file ? JSON.parse(JSON.stringify(this.file)) : null;
+    }
+    /** @param file - Contents */
+    write(file) {
+        this.file = JSON.parse(JSON.stringify(file));
+    }
+}
+//# sourceMappingURL=spend-cap.store.js.map

package/dist/backend/backend/src/services/spend/spend-cap.store.js.map

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

package/dist/backend/backend/src/services/spend/spend-cap.wiring.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Spend caps — the real dependencies, bound to the running backend.
+ *
+ * Kept apart from the service so the service stays testable with fakes;
+ * heavy services are imported lazily so importing this module from index.ts
+ * adds no import cycles.
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.wiring
+ */
+import { SpendCapService, type SpendCapLogger } from './spend-cap.service.js';
+/** Team facts the wiring reads. */
+interface StorageLike {
+    getTeams(): Promise<Array<{
+        members: Array<{
+            name: string;
+            sessionName: string;
+        }>;
+    }>>;
+}
+/** The registration-service calls the wiring makes. */
+interface RegistrationLike {
+    isInProcessRuntimeActive(sessionName: string): boolean;
+    sendMessageToAgent(sessionName: string, message: string): Promise<{
+        success: boolean;
+        queued?: boolean;
+    }>;
+}
+/** What index.ts provides. */
+export interface SpendCapWiringInput {
+    crewlyHome: string;
+    storage: StorageLike;
+    registration: () => RegistrationLike | null;
+    /** Whether a PTY session exists */
+    sessionExists: (sessionName: string) => boolean;
+    /** Start a stopped team member (activate-on-send) */
+    activate: (sessionName: string) => Promise<unknown>;
+    logger: SpendCapLogger;
+}
+/**
+ * Build the service, install it as the delivery / wake gate, register the
+ * decision-card handler and the orc-DM commands, and start its tick.
+ *
+ * @param input - Backend context
+ * @returns The running service
+ */
+export declare function startSpendCaps(input: SpendCapWiringInput): Promise<SpendCapService>;
+export {};
+//# sourceMappingURL=spend-cap.wiring.d.ts.map

package/dist/backend/backend/src/services/spend/spend-cap.wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-cap.wiring.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/spend/spend-cap.wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,EAAE,eAAe,EAAsB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIlG,mCAAmC;AACnC,UAAU,WAAW;IACnB,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;CACvF;AAED,uDAAuD;AACvD,UAAU,gBAAgB;IACxB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACvD,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC3G;AAED,8BAA8B;AAC9B,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAC5C,mCAAmC;IACnC,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,qDAAqD;IACrD,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4EzF"}

package/dist/backend/backend/src/services/spend/spend-cap.wiring.js

@@ -0,0 +1,98 @@
+/**
+ * Spend caps — the real dependencies, bound to the running backend.
+ *
+ * Kept apart from the service so the service stays testable with fakes;
+ * heavy services are imported lazily so importing this module from index.ts
+ * adds no import cycles.
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.wiring
+ */
+import * as path from 'path';
+import { ORCHESTRATOR_SESSION_NAME, SPEND_CAP_CONSTANTS } from '../../constants.js';
+import { DecisionService } from '../decisions/decision.service.js';
+import { TokenUsageService } from '../monitoring/token-usage.service.js';
+import { SubAgentMessageQueue } from '../messaging/sub-agent-message-queue.service.js';
+import { setSpendCapGate } from './spend-cap.gate.js';
+import { createSpendCapInterceptor } from './spend-cap-command.js';
+import { SpendCapService, setSpendCapService } from './spend-cap.service.js';
+import { FileSpendCapStore } from './spend-cap.store.js';
+import { SpendLedger } from './spend-ledger.service.js';
+/**
+ * Build the service, install it as the delivery / wake gate, register the
+ * decision-card handler and the orc-DM commands, and start its tick.
+ *
+ * @param input - Backend context
+ * @returns The running service
+ */
+export async function startSpendCaps(input) {
+    const names = new Map([[ORCHESTRATOR_SESSION_NAME, 'Orc']]);
+    const agents = async () => {
+        const list = [{ session: ORCHESTRATOR_SESSION_NAME, name: 'Orc' }];
+        for (const team of await input.storage.getTeams().catch(() => [])) {
+            for (const m of team.members ?? []) {
+                if (!m.sessionName)
+                    continue;
+                list.push({ session: m.sessionName, name: m.name || m.sessionName });
+                names.set(m.sessionName, m.name || m.sessionName);
+            }
+        }
+        return list;
+    };
+    const { SlackReloginDmService } = await import('../slack/slack-relogin-dm.service.js');
+    const { getSlackService } = await import('../slack/slack.service.js');
+    const { getSlackAgentIdentityService } = await import('../slack/slack-agent-identity.service.js');
+    const dm = new SlackReloginDmService(() => getSlackService(), undefined, (agentSession) => getSlackAgentIdentityService()?.getInstalled(agentSession)?.botToken ?? null);
+    const release = async (sessions) => {
+        const reg = input.registration();
+        if (!reg)
+            return;
+        const queue = SubAgentMessageQueue.getInstance();
+        for (const session of sessions) {
+            if (!queue.hasPending(session))
+                continue;
+            const live = reg.isInProcessRuntimeActive(session) || input.sessionExists(session);
+            if (live || session === ORCHESTRATOR_SESSION_NAME) {
+                await queue.flush(session, (data) => reg.sendMessageToAgent(session, data));
+            }
+            else {
+                // Registration flushes the persistent queue once the agent is up.
+                await input.activate(session);
+            }
+        }
+    };
+    const service = new SpendCapService({
+        store: new FileSpendCapStore(path.join(input.crewlyHome, SPEND_CAP_CONSTANTS.STORE_FILE)),
+        ledger: new SpendLedger(TokenUsageService.getInstance()),
+        notifyOwner: (text) => dm.sendToOwner(text),
+        decisions: () => DecisionService.getInstance(),
+        displayNameOf: (session) => names.get(session) ?? session,
+        knownSessions: async () => (await agents()).map((a) => a.session),
+        onReleased: release,
+        logger: input.logger,
+    });
+    setSpendCapService(service);
+    setSpendCapGate(service);
+    DecisionService.registerKindHandler(SPEND_CAP_CONSTANTS.DECISION_KIND, service);
+    try {
+        const { getSlackOrchestratorBridge } = await import('../slack/slack-orchestrator-bridge.js');
+        getSlackOrchestratorBridge().addInboundInterceptor('the spend cap commands', createSpendCapInterceptor({
+            ownerDmScope: (m) => dm.ownerDmScope(m),
+            replyTargetOf: (m) => dm.replyTargetOf(m),
+            reply: (text, target) => dm.sendToOwner(text, target),
+            agents,
+            setCaps: (patch) => service.setCaps(patch),
+            raiseToday: (target, usd) => service.raiseToday(target, usd),
+            orcStop: () => service.stopOf(ORCHESTRATOR_SESSION_NAME),
+            onError: (err) => input.logger.warn('Spend cap command failed', { error: err instanceof Error ? err.message : String(err) }),
+        }));
+    }
+    catch (err) {
+        input.logger.warn('Spend cap Slack commands not wired (non-critical)', { error: err instanceof Error ? err.message : String(err) });
+    }
+    await agents().catch(() => undefined);
+    service.start();
+    return service;
+}
+//# sourceMappingURL=spend-cap.wiring.js.map

package/dist/backend/backend/src/services/spend/spend-cap.wiring.js.map

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

package/dist/backend/backend/src/services/spend/spend-ledger.service.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Spend ledger — what each agent actually spent, in USD, per local day.
+ *
+ * Reads the shared token ledger (`~/.crewly/token-usage.json`, held in
+ * memory by {@link TokenUsageService}). Both sources of agent usage land
+ * there: the in-process Crewly Agent runtime records every run (DeepSeek,
+ * cache-aware), and the Claude transcript sync records every Claude Code
+ * turn with its cache split. Each event is priced with {@link eventCostUsd},
+ * the same computation the ticket autopilot budget and the team budget gate
+ * use through `getSessionUsageSince` — there is no second cost formula here.
+ *
+ * Claude Code under a subscription does not produce a bill at these rates;
+ * its figure is the API-equivalent cost (see model-pricing).
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-ledger.service
+ */
+import { type TokenUsageEvent } from '../monitoring/token-usage.service.js';
+/** The part of {@link TokenUsageService} the ledger reads. */
+export interface SpendEventSource {
+    forEachEvent(visit: (sessionName: string, event: TokenUsageEvent) => void, since?: Date): void;
+    getSessionUsageSince(sessionName: string, since: Date, until?: Date): {
+        cost: number;
+    };
+}
+/** One local day of spend. */
+export interface SpendDay {
+    /** `YYYY-MM-DD`, local */
+    date: string;
+    totalUsd: number;
+    /** Session → USD */
+    byAgent: Record<string, number>;
+    /** Runtime → USD */
+    byRuntime: Record<string, number>;
+}
+/** One agent across the window. */
+export interface SpendAgentRow {
+    session: string;
+    /** Runtimes its usage came from (inferred from the model id) */
+    runtimes: string[];
+    todayUsd: number;
+    windowUsd: number;
+    /** USD per day, oldest first, aligned with {@link SpendSummary.days} */
+    daily: number[];
+}
+/** What `GET /api/system/spend` returns (before cap info is added). */
+export interface SpendSummary {
+    /** Local day of `now` */
+    today: string;
+    /** Oldest first; the last one is today */
+    days: SpendDay[];
+    /** Highest window spend first */
+    agents: SpendAgentRow[];
+    /** Runtime → USD over the window */
+    byRuntime: Record<string, number>;
+    totalUsd: number;
+    todayUsd: number;
+    /** 90th percentile of per-agent daily spend (agent-days with any spend), USD */
+    p90AgentDayUsd: number;
+}
+/**
+ * The runtime a usage event came from, inferred from its model id.
+ *
+ * @param model - Model id as recorded (`deepseek/deepseek-chat`, `claude-opus-5-5`, `codex-cli-default`)
+ * @returns Runtime id, or `other`
+ *
+ * @example
+ * runtimeOfModel('deepseek/deepseek-chat') // 'crewly-agent'
+ * runtimeOfModel('claude-sonnet-5') // 'claude-code'
+ */
+export declare function runtimeOfModel(model: string): string;
+/**
+ * Nearest-rank percentile.
+ *
+ * @param values - Samples
+ * @param p - Percentile (0–100)
+ * @returns The value, or 0 for no samples
+ */
+export declare function percentile(values: number[], p: number): number;
+/**
+ * Round to whole cents.
+ *
+ * @param usd - Amount
+ * @returns Rounded amount
+ */
+export declare function cents(usd: number): number;
+/**
+ * Per-agent / per-runtime / per-day spend.
+ */
+export declare class SpendLedger {
+    private readonly source;
+    private readonly now;
+    private totalCache;
+    /**
+     * @param source - Token ledger
+     * @param now - Clock
+     */
+    constructor(source: SpendEventSource, now?: () => Date);
+    /**
+     * USD a session spent since local midnight (the autopilot's computation).
+     *
+     * @param session - Agent session
+     * @returns USD
+     */
+    spentToday(session: string): number;
+    /**
+     * USD every agent together spent since local midnight. Cached briefly:
+     * the delivery gate asks on every message.
+     *
+     * @returns USD
+     */
+    totalToday(): number;
+    /** Forget the cached total (after new usage is known). */
+    invalidate(): void;
+    /**
+     * Spend over the last `days` local days, today included.
+     *
+     * @param days - Window length (clamped to 1…MAX_DAYS)
+     * @returns Summary
+     */
+    summarize(days?: number): SpendSummary;
+}
+//# sourceMappingURL=spend-ledger.service.d.ts.map

package/dist/backend/backend/src/services/spend/spend-ledger.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-ledger.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/spend/spend-ledger.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAG1F,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC/F,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxF;AAED,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;GAEG;AACH,qBAAa,WAAW;IAQpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,OAAO,CAAC,UAAU,CAA8D;IAEhF;;;OAGG;gBAEgB,MAAM,EAAE,gBAAgB,EACxB,GAAG,GAAE,MAAM,IAAuB;IAGrD;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQnC;;;;;OAKG;IACH,UAAU,IAAI,MAAM;IAiBpB,0DAA0D;IAC1D,UAAU,IAAI,IAAI;IAIlB;;;;;OAKG;IACH,SAAS,CAAC,IAAI,GAAE,MAAyC,GAAG,YAAY;CAuDzE"}

package/dist/backend/backend/src/services/spend/spend-ledger.service.js

@@ -0,0 +1,189 @@
+/**
+ * Spend ledger — what each agent actually spent, in USD, per local day.
+ *
+ * Reads the shared token ledger (`~/.crewly/token-usage.json`, held in
+ * memory by {@link TokenUsageService}). Both sources of agent usage land
+ * there: the in-process Crewly Agent runtime records every run (DeepSeek,
+ * cache-aware), and the Claude transcript sync records every Claude Code
+ * turn with its cache split. Each event is priced with {@link eventCostUsd},
+ * the same computation the ticket autopilot budget and the team budget gate
+ * use through `getSessionUsageSince` — there is no second cost formula here.
+ *
+ * Claude Code under a subscription does not produce a bill at these rates;
+ * its figure is the API-equivalent cost (see model-pricing).
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-ledger.service
+ */
+import { SPEND_CAP_CONSTANTS, RUNTIME_TYPES } from '../../constants.js';
+import { eventCostUsd } from '../monitoring/token-usage.service.js';
+import { localDateKey, localMidnight } from '../project-tickets/ticket-autopilot-decision.js';
+/**
+ * The runtime a usage event came from, inferred from its model id.
+ *
+ * @param model - Model id as recorded (`deepseek/deepseek-chat`, `claude-opus-5-5`, `codex-cli-default`)
+ * @returns Runtime id, or `other`
+ *
+ * @example
+ * runtimeOfModel('deepseek/deepseek-chat') // 'crewly-agent'
+ * runtimeOfModel('claude-sonnet-5') // 'claude-code'
+ */
+export function runtimeOfModel(model) {
+    const m = (model || '').toLowerCase();
+    for (const rt of Object.values(RUNTIME_TYPES)) {
+        if (m.startsWith(`${rt}-`))
+            return rt;
+    }
+    if (m.includes('/'))
+        return RUNTIME_TYPES.CREWLY_AGENT;
+    if (/claude|opus|sonnet|haiku|fable|synthetic/.test(m))
+        return RUNTIME_TYPES.CLAUDE_CODE;
+    if (/gpt|codex|^o\d/.test(m))
+        return RUNTIME_TYPES.CODEX_CLI;
+    if (/gemini/.test(m))
+        return RUNTIME_TYPES.GEMINI_CLI;
+    return 'other';
+}
+/**
+ * Nearest-rank percentile.
+ *
+ * @param values - Samples
+ * @param p - Percentile (0–100)
+ * @returns The value, or 0 for no samples
+ */
+export function percentile(values, p) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const rank = Math.ceil((p / 100) * sorted.length);
+    return sorted[Math.min(sorted.length, Math.max(1, rank)) - 1];
+}
+/**
+ * Round to whole cents.
+ *
+ * @param usd - Amount
+ * @returns Rounded amount
+ */
+export function cents(usd) {
+    return Math.round(usd * 100) / 100;
+}
+/**
+ * Per-agent / per-runtime / per-day spend.
+ */
+export class SpendLedger {
+    source;
+    now;
+    totalCache = null;
+    /**
+     * @param source - Token ledger
+     * @param now - Clock
+     */
+    constructor(source, now = () => new Date()) {
+        this.source = source;
+        this.now = now;
+    }
+    /**
+     * USD a session spent since local midnight (the autopilot's computation).
+     *
+     * @param session - Agent session
+     * @returns USD
+     */
+    spentToday(session) {
+        try {
+            return this.source.getSessionUsageSince(session, localMidnight(this.now())).cost;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * USD every agent together spent since local midnight. Cached briefly:
+     * the delivery gate asks on every message.
+     *
+     * @returns USD
+     */
+    totalToday() {
+        const now = this.now();
+        const dayStart = localMidnight(now).getTime();
+        const c = this.totalCache;
+        if (c && c.dayStart === dayStart && now.getTime() - c.at < SPEND_CAP_CONSTANTS.TOTAL_CACHE_MS)
+            return c.usd;
+        let usd = 0;
+        try {
+            this.source.forEachEvent((_s, e) => {
+                usd += eventCostUsd(e);
+            }, new Date(dayStart));
+        }
+        catch {
+            usd = 0;
+        }
+        this.totalCache = { at: now.getTime(), dayStart, usd };
+        return usd;
+    }
+    /** Forget the cached total (after new usage is known). */
+    invalidate() {
+        this.totalCache = null;
+    }
+    /**
+     * Spend over the last `days` local days, today included.
+     *
+     * @param days - Window length (clamped to 1…MAX_DAYS)
+     * @returns Summary
+     */
+    summarize(days = SPEND_CAP_CONSTANTS.DEFAULT_DAYS) {
+        const n = Math.min(SPEND_CAP_CONSTANTS.MAX_DAYS, Math.max(1, Math.floor(Number.isFinite(days) ? days : SPEND_CAP_CONSTANTS.DEFAULT_DAYS)));
+        const now = this.now();
+        const keys = [];
+        for (let i = n - 1; i >= 0; i--) {
+            const d = new Date(now.getTime());
+            d.setDate(d.getDate() - i);
+            keys.push(localDateKey(d));
+        }
+        const first = new Date(now.getTime());
+        first.setDate(first.getDate() - (n - 1));
+        const since = localMidnight(first);
+        const index = new Map(keys.map((k, i) => [k, i]));
+        const dayRows = keys.map((date) => ({ date, totalUsd: 0, byAgent: {}, byRuntime: {} }));
+        const agents = new Map();
+        const byRuntime = {};
+        this.source.forEachEvent((session, e) => {
+            const i = index.get(localDateKey(new Date(e.timestamp)));
+            if (i === undefined)
+                return;
+            const usd = eventCostUsd(e);
+            const runtime = runtimeOfModel(e.model);
+            const day = dayRows[i];
+            day.totalUsd += usd;
+            day.byAgent[session] = (day.byAgent[session] ?? 0) + usd;
+            day.byRuntime[runtime] = (day.byRuntime[runtime] ?? 0) + usd;
+            byRuntime[runtime] = (byRuntime[runtime] ?? 0) + usd;
+            let a = agents.get(session);
+            if (!a) {
+                a = { runtimes: new Set(), daily: keys.map(() => 0) };
+                agents.set(session, a);
+            }
+            a.runtimes.add(runtime);
+            a.daily[i] += usd;
+        }, since);
+        const rows = [...agents].map(([session, a]) => ({
+            session,
+            runtimes: [...a.runtimes].sort(),
+            todayUsd: a.daily[a.daily.length - 1],
+            windowUsd: a.daily.reduce((s, v) => s + v, 0),
+            daily: a.daily,
+        }));
+        rows.sort((x, y) => y.windowUsd - x.windowUsd);
+        const agentDays = rows.flatMap((r) => r.daily.filter((v) => v > 0));
+        return {
+            today: keys[keys.length - 1],
+            days: dayRows,
+            agents: rows,
+            byRuntime,
+            totalUsd: dayRows.reduce((s, d) => s + d.totalUsd, 0),
+            todayUsd: dayRows[dayRows.length - 1].totalUsd,
+            p90AgentDayUsd: percentile(agentDays, 90),
+        };
+    }
+}
+//# sourceMappingURL=spend-ledger.service.js.map

package/dist/backend/backend/src/services/spend/spend-ledger.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-ledger.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/spend/spend-ledger.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAwB,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AA8C9F;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC,YAAY,CAAC;IACvD,IAAI,0CAA0C,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC,WAAW,CAAC;IACzF,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC,SAAS,CAAC;IAC7D,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC,UAAU,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,MAAgB,EAAE,CAAS;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,WAAW;IAQH;IACA;IARX,UAAU,GAAyD,IAAI,CAAC;IAEhF;;;OAGG;IACH,YACmB,MAAwB,EACxB,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;QADlC,WAAM,GAAN,MAAM,CAAkB;QACxB,QAAG,GAAH,GAAG,CAA+B;IAClD,CAAC;IAEJ;;;;;OAKG;IACH,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,mBAAmB,CAAC,cAAc;YAAE,OAAO,CAAC,CAAC,GAAG,CAAC;QAC5G,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;gBACjC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,CAAC,CAAC;QACV,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACvD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,0DAA0D;IAC1D,UAAU;QACR,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAe,mBAAmB,CAAC,YAAY;QACvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3I,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAClC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,OAAO,GAAe,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACpG,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsD,CAAC;QAC7E,MAAM,SAAS,GAA2B,EAAE,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO;YAC5B,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACvB,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC;YACpB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;YACzD,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;YAC7D,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;YACrD,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACzB,CAAC;YACD,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACpB,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,MAAM,IAAI,GAAoB,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/D,OAAO;YACP,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;YAChC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACrC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7C,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5B,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,IAAI;YACZ,SAAS;YACT,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACrD,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ;YAC9C,cAAc,EAAE,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;CACF"}

package/dist/backend/backend/src/services/task-pool/claim-target-waker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Start the target of a targeted claim that was refused because the target
+ * is not running (#929).
+ *
+ * The orchestrator's delegate-task skill claims the WorkItem it just created
+ * on the worker's behalf. When the worker was down (a restart leaves idle
+ * agents down), `claimSpecificItem` refused with "agent session not active"
+ * and nothing else happened until the reconciler's wake pass, minutes later;
+ * on 2026-10-01 the orchestrator restarted Dana by hand instead.
+ *
+ * The start goes through the normal member-start endpoint with the WorkItem
+ * id, so every start gate still applies (the WorkItem is queued for that
+ * member, and a dormant team still needs the owner). The claim itself stays
+ * refused: the item stays queued and is dispatched once the agent registers.
+ *
+ * @module services/task-pool/claim-target-waker
+ */
+import type { WorkItem } from '../../types/v2/work-item.types.js';
+import type { AssigneeWaker, AssigneeWakeResult } from '../project-tickets/ticket-assignee-waker.js';
+/** What {@link wakeRefusedClaimTarget} needs. */
+export interface ClaimTargetWakerDeps {
+    /** Current state of a WorkItem. */
+    findWorkItem: (id: string) => Promise<Pick<WorkItem, 'id' | 'status' | 'target'> | null>;
+    /** Whether the session has a live PTY (or in-process runtime). */
+    sessionLive: (sessionName: string) => boolean;
+    /** The team and member bound to a session. */
+    findMember: (sessionName: string) => Promise<{
+        team: {
+            id: string;
+        };
+        member: {
+            id: string;
+        };
+    } | null>;
+    /** Starts the member through the member-start endpoint. */
+    wake: AssigneeWaker;
+}
+/**
+ * Start the agent a refused targeted claim was for, when it is simply down.
+ *
+ * @param input - The refused claim and who made it
+ * @param deps - Lookups and the waker
+ * @returns The start outcome, or null when no start applies (the item is not
+ *   queued for that agent, the agent is running, or it is no team member)
+ */
+export declare function wakeRefusedClaimTarget(input: {
+    agentId: string;
+    workItemId: string;
+    callerSession?: string;
+}, deps: ClaimTargetWakerDeps): Promise<AssigneeWakeResult | null>;
+//# sourceMappingURL=claim-target-waker.d.ts.map

package/dist/backend/backend/src/services/task-pool/claim-target-waker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-target-waker.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/task-pool/claim-target-waker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAErG,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACpC,mCAAmC;IACnC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACzF,kEAAkE;IAClE,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,8CAA8C;IAC9C,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACtG,2DAA2D;IAC3D,IAAI,EAAE,aAAa,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,IAAI,EAAE,oBAAoB,GACxB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAapC"}