@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/runtime/config.js

@@ -0,0 +1,467 @@
+/**
+ * Squad Configuration Loader
+ *
+ * Loads and validates squad.config.ts or squad.config.json configuration files.
+ * Implements the config schema design from spike #72.
+ *
+ * @module runtime/config
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { pathToFileURL } from 'url';
+import { MODELS } from './constants.js';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+/**
+ * Default Squad configuration with typed defaults.
+ */
+export const DEFAULT_CONFIG = {
+    version: '1.0.0',
+    models: {
+        defaultModel: MODELS.DEFAULT,
+        defaultTier: 'standard',
+        fallbackChains: {
+            premium: [...MODELS.FALLBACK_CHAINS.premium],
+            standard: [...MODELS.FALLBACK_CHAINS.standard],
+            fast: [...MODELS.FALLBACK_CHAINS.fast]
+        },
+        preferSameProvider: true,
+        respectTierCeiling: true,
+        nuclearFallback: {
+            enabled: false,
+            model: MODELS.NUCLEAR_FALLBACK,
+            maxRetriesBeforeNuclear: MODELS.NUCLEAR_MAX_RETRIES
+        }
+    },
+    routing: {
+        rules: [
+            {
+                workType: 'feature-dev',
+                agents: ['@coordinator'],
+                confidence: 'high'
+            }
+        ],
+        governance: {
+            eagerByDefault: true,
+            scribeAutoRuns: false,
+            allowRecursiveSpawn: false
+        }
+    },
+    casting: {
+        allowlistUniverses: [
+            'The Usual Suspects',
+            'Breaking Bad',
+            'The Wire',
+            'Firefly',
+            'Star Trek',
+            'Lord of the Rings',
+            'The Godfather',
+            'Inception',
+            'The Matrix',
+            'Blade Runner',
+            'Harry Potter',
+            'Game of Thrones',
+            'The Expanse',
+            'Westworld',
+            'Sherlock Holmes'
+        ],
+        overflowStrategy: 'generic',
+        universeCapacity: {}
+    },
+    platforms: {
+        vscode: {
+            disableModelSelection: false,
+            scribeMode: 'sync'
+        }
+    }
+};
+/**
+ * Configuration validation error.
+ */
+export class ConfigValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Discovers Squad configuration file by walking up directory tree.
+ *
+ * Search order per directory:
+ * 1. squad.config.ts
+ * 2. squad.config.js
+ * 3. squad.config.json
+ * 4. .squad/config.json
+ *
+ * @param cwd - Starting directory for upward search
+ * @returns Path to config file if found, undefined otherwise
+ */
+export function discoverConfigFile(cwd = process.cwd()) {
+    let currentDir = resolve(cwd);
+    const root = resolve(dirname(currentDir), '..');
+    const configFiles = [
+        'squad.config.ts',
+        'squad.config.js',
+        'squad.config.json',
+        join('.squad', 'config.json')
+    ];
+    while (true) {
+        for (const configFile of configFiles) {
+            const configPath = join(currentDir, configFile);
+            if (existsSync(configPath)) {
+                return configPath;
+            }
+        }
+        // Check if we've reached the root
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir || currentDir === root) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return undefined;
+}
+/**
+ * Loads Squad configuration from squad.config.ts, squad.config.js, squad.config.json, or .squad/config.json.
+ *
+ * Search order:
+ * 1. squad.config.ts (ESM import)
+ * 2. squad.config.js (ESM import)
+ * 3. squad.config.json (JSON parse)
+ * 4. .squad/config.json (JSON parse)
+ * 5. Walk up directory tree to find config file
+ * 6. DEFAULT_CONFIG (fallback)
+ *
+ * @param cwd - Working directory to search for config files
+ * @returns Configuration load result with validation
+ * @throws {ConfigValidationError} If config validation fails
+ */
+export async function loadConfig(cwd = process.cwd()) {
+    const resolvedCwd = resolve(cwd);
+    // Try local configs first
+    const localConfigs = [
+        { path: join(resolvedCwd, 'squad.config.ts'), type: 'ts' },
+        { path: join(resolvedCwd, 'squad.config.js'), type: 'js' },
+        { path: join(resolvedCwd, 'squad.config.json'), type: 'json' },
+        { path: join(resolvedCwd, '.squad', 'config.json'), type: 'json' }
+    ];
+    for (const { path: configPath, type } of localConfigs) {
+        if (existsSync(configPath)) {
+            try {
+                if (type === 'ts' || type === 'js') {
+                    const configUrl = pathToFileURL(configPath).href;
+                    const module = await import(configUrl);
+                    const config = module.default || module.squadConfig;
+                    if (!config) {
+                        throw new Error(`${configPath} must export default or named export "squadConfig"`);
+                    }
+                    const validated = validateConfig(config);
+                    return {
+                        config: validated,
+                        source: configPath,
+                        isDefault: false
+                    };
+                }
+                else {
+                    const content = readFileSync(configPath, 'utf-8');
+                    const config = JSON.parse(content);
+                    const validated = validateConfig(config);
+                    return {
+                        config: validated,
+                        source: configPath,
+                        isDefault: false
+                    };
+                }
+            }
+            catch (error) {
+                if (error instanceof ConfigValidationError) {
+                    throw error;
+                }
+                throw new Error(`Failed to load ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    // Walk up directory tree
+    const discoveredPath = discoverConfigFile(dirname(resolvedCwd));
+    if (discoveredPath) {
+        try {
+            if (discoveredPath.endsWith('.ts') || discoveredPath.endsWith('.js')) {
+                const configUrl = pathToFileURL(discoveredPath).href;
+                const module = await import(configUrl);
+                const config = module.default || module.squadConfig;
+                if (!config) {
+                    throw new Error(`${discoveredPath} must export default or named export "squadConfig"`);
+                }
+                const validated = validateConfig(config);
+                return {
+                    config: validated,
+                    source: discoveredPath,
+                    isDefault: false
+                };
+            }
+            else {
+                const content = readFileSync(discoveredPath, 'utf-8');
+                const config = JSON.parse(content);
+                const validated = validateConfig(config);
+                return {
+                    config: validated,
+                    source: discoveredPath,
+                    isDefault: false
+                };
+            }
+        }
+        catch (error) {
+            if (error instanceof ConfigValidationError) {
+                throw error;
+            }
+            throw new Error(`Failed to load ${discoveredPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Fall back to default config
+    return {
+        config: DEFAULT_CONFIG,
+        source: undefined,
+        isDefault: true
+    };
+}
+/**
+ * Validates Squad configuration schema and returns detailed result.
+ *
+ * @param config - Configuration object to validate
+ * @returns Validation result with errors and warnings
+ */
+export function validateConfigDetailed(config) {
+    const errors = [];
+    const warnings = [];
+    if (!config || typeof config !== 'object') {
+        return {
+            valid: false,
+            errors: ['Config must be an object'],
+            warnings
+        };
+    }
+    const cfg = config;
+    // Validate version
+    if (!cfg.version || typeof cfg.version !== 'string') {
+        errors.push('config.version is required and must be a string');
+    }
+    // Validate models section
+    if (!cfg.models) {
+        errors.push('config.models is required');
+    }
+    else {
+        const models = cfg.models;
+        if (!models.defaultModel || typeof models.defaultModel !== 'string') {
+            errors.push('config.models.defaultModel is required and must be a string');
+        }
+        if (!models.defaultTier || !['premium', 'standard', 'fast'].includes(models.defaultTier)) {
+            errors.push('config.models.defaultTier must be "premium", "standard", or "fast"');
+        }
+        if (!models.fallbackChains) {
+            errors.push('config.models.fallbackChains is required');
+        }
+        else {
+            if (!Array.isArray(models.fallbackChains.premium)) {
+                errors.push('config.models.fallbackChains.premium must be an array');
+            }
+            if (!Array.isArray(models.fallbackChains.standard)) {
+                errors.push('config.models.fallbackChains.standard must be an array');
+            }
+            if (!Array.isArray(models.fallbackChains.fast)) {
+                errors.push('config.models.fallbackChains.fast must be an array');
+            }
+        }
+        // Validate task rules if present
+        if (models.taskRules) {
+            if (!Array.isArray(models.taskRules)) {
+                errors.push('config.models.taskRules must be an array');
+            }
+            else {
+                models.taskRules.forEach((rule, idx) => {
+                    if (!rule.outputType || typeof rule.outputType !== 'string') {
+                        errors.push(`config.models.taskRules[${idx}].outputType is required`);
+                    }
+                    if (!rule.model || typeof rule.model !== 'string') {
+                        errors.push(`config.models.taskRules[${idx}].model is required`);
+                    }
+                });
+            }
+        }
+        // Validate role mapping if present
+        if (models.roleMapping) {
+            if (!Array.isArray(models.roleMapping)) {
+                errors.push('config.models.roleMapping must be an array');
+            }
+            else {
+                models.roleMapping.forEach((mapping, idx) => {
+                    if (!mapping.role || typeof mapping.role !== 'string') {
+                        errors.push(`config.models.roleMapping[${idx}].role is required`);
+                    }
+                    if (!mapping.model || typeof mapping.model !== 'string') {
+                        errors.push(`config.models.roleMapping[${idx}].model is required`);
+                    }
+                });
+            }
+        }
+    }
+    // Validate routing section
+    if (!cfg.routing) {
+        errors.push('config.routing is required');
+    }
+    else {
+        if (!Array.isArray(cfg.routing.rules)) {
+            errors.push('config.routing.rules must be an array');
+        }
+        else {
+            const agentNames = new Set();
+            cfg.routing.rules.forEach((rule, idx) => {
+                if (!rule.workType || typeof rule.workType !== 'string') {
+                    errors.push(`config.routing.rules[${idx}].workType is required`);
+                }
+                if (!Array.isArray(rule.agents) || rule.agents.length === 0) {
+                    errors.push(`config.routing.rules[${idx}].agents must be a non-empty array`);
+                }
+                else {
+                    rule.agents.forEach(agent => agentNames.add(agent));
+                }
+            });
+            // Check for duplicate work types
+            const workTypes = new Set();
+            cfg.routing.rules.forEach(rule => {
+                if (rule.workType) {
+                    if (workTypes.has(rule.workType)) {
+                        warnings.push(`Duplicate work type in routing rules: ${rule.workType}`);
+                    }
+                    workTypes.add(rule.workType);
+                }
+            });
+        }
+        // Validate issue routing if present
+        if (cfg.routing.issueRouting) {
+            if (!Array.isArray(cfg.routing.issueRouting)) {
+                errors.push('config.routing.issueRouting must be an array');
+            }
+            else {
+                cfg.routing.issueRouting.forEach((rule, idx) => {
+                    if (!rule.label || typeof rule.label !== 'string') {
+                        errors.push(`config.routing.issueRouting[${idx}].label is required`);
+                    }
+                    if (!rule.action || !['assign', 'route', 'evaluate'].includes(rule.action)) {
+                        errors.push(`config.routing.issueRouting[${idx}].action must be "assign", "route", or "evaluate"`);
+                    }
+                });
+            }
+        }
+    }
+    // Validate agent sources if present
+    if (cfg.agentSources) {
+        if (!Array.isArray(cfg.agentSources)) {
+            errors.push('config.agentSources must be an array');
+        }
+        else {
+            cfg.agentSources.forEach((source, idx) => {
+                if (!source.type || !['local', 'git', 'npm', 'url'].includes(source.type)) {
+                    errors.push(`config.agentSources[${idx}].type must be "local", "git", "npm", or "url"`);
+                }
+                if (!source.location || typeof source.location !== 'string') {
+                    errors.push(`config.agentSources[${idx}].location is required`);
+                }
+            });
+        }
+    }
+    // Validate casting policy if present
+    if (cfg.casting) {
+        if (cfg.casting.allowlistUniverses && !Array.isArray(cfg.casting.allowlistUniverses)) {
+            errors.push('config.casting.allowlistUniverses must be an array');
+        }
+        if (cfg.casting.overflowStrategy && !['reject', 'generic', 'rotate'].includes(cfg.casting.overflowStrategy)) {
+            errors.push('config.casting.overflowStrategy must be "reject", "generic", or "rotate"');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Validates Squad configuration schema.
+ *
+ * @param config - Configuration object to validate
+ * @returns Validated configuration with defaults merged
+ * @throws {ConfigValidationError} If validation fails
+ */
+export function validateConfig(config) {
+    const result = validateConfigDetailed(config);
+    if (!result.valid) {
+        throw new ConfigValidationError(`Configuration validation failed:\n${result.errors.map(e => `  - ${e}`).join('\n')}`, result.errors);
+    }
+    const cfg = config;
+    // Merge with defaults for optional fields
+    const validated = {
+        ...DEFAULT_CONFIG,
+        ...cfg,
+        models: {
+            ...DEFAULT_CONFIG.models,
+            ...cfg.models
+        },
+        routing: {
+            ...DEFAULT_CONFIG.routing,
+            ...cfg.routing,
+            governance: {
+                ...DEFAULT_CONFIG.routing.governance,
+                ...cfg.routing?.governance
+            }
+        },
+        casting: {
+            ...DEFAULT_CONFIG.casting,
+            ...cfg.casting
+        },
+        platforms: {
+            ...DEFAULT_CONFIG.platforms,
+            ...cfg.platforms
+        }
+    };
+    return validated;
+}
+/**
+ * Synchronously loads Squad configuration.
+ * Only supports squad.config.json (TypeScript config requires async import).
+ *
+ * @param cwd - Working directory to search for config files
+ * @returns Configuration load result with validation
+ * @throws {ConfigValidationError} If config validation fails
+ */
+export function loadConfigSync(cwd = process.cwd()) {
+    const resolvedCwd = resolve(cwd);
+    // Only check squad.config.json (sync loading of .ts not supported)
+    const jsonConfigPath = join(resolvedCwd, 'squad.config.json');
+    if (existsSync(jsonConfigPath)) {
+        try {
+            const content = readFileSync(jsonConfigPath, 'utf-8');
+            const config = JSON.parse(content);
+            const validated = validateConfig(config);
+            return {
+                config: validated,
+                source: jsonConfigPath,
+                isDefault: false
+            };
+        }
+        catch (error) {
+            if (error instanceof ConfigValidationError) {
+                throw error;
+            }
+            throw new Error(`Failed to load squad.config.json: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Fall back to default config
+    return {
+        config: DEFAULT_CONFIG,
+        source: undefined,
+        isDefault: true
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/runtime/config.js.map

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

package/dist/runtime/constants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Central constants — single source of truth for model names, timeouts, roles.
+ * All magic values live here. Environment variables override where noted.
+ *
+ * @module runtime/constants
+ */
+export declare const MODELS: {
+    /** Default model for config files and new projects (env-overridable) */
+    readonly DEFAULT: string;
+    /** Default model for model-selector Layer 4 — cost-first */
+    readonly SELECTOR_DEFAULT: "claude-haiku-4.5";
+    /** Default tier for the model-selector Layer 4 fallback */
+    readonly SELECTOR_DEFAULT_TIER: "fast";
+    /** Fallback chains by tier — ordered by preference */
+    readonly FALLBACK_CHAINS: {
+        readonly premium: readonly ["claude-opus-4.6", "claude-opus-4.6-fast", "claude-opus-4.5", "claude-sonnet-4.5"];
+        readonly standard: readonly ["claude-sonnet-4.5", "gpt-5.2-codex", "claude-sonnet-4", "gpt-5.2"];
+        readonly fast: readonly ["claude-haiku-4.5", "gpt-5.1-codex-mini", "gpt-4.1", "gpt-5-mini"];
+    };
+    /** Nuclear fallback model when all chains are exhausted */
+    readonly NUCLEAR_FALLBACK: "claude-haiku-4.5";
+    /** Maximum retries before nuclear fallback engages */
+    readonly NUCLEAR_MAX_RETRIES: 3;
+};
+export declare const TIMEOUTS: {
+    /** Health check timeout in milliseconds */
+    readonly HEALTH_CHECK_MS: number;
+    /** Git clone timeout in milliseconds */
+    readonly GIT_CLONE_MS: number;
+    /** Plugin/marketplace fetch timeout in milliseconds */
+    readonly PLUGIN_FETCH_MS: number;
+};
+export declare const AGENT_ROLES: readonly ["lead", "developer", "tester", "designer", "scribe", "coordinator"];
+export type AgentRole = typeof AGENT_ROLES[number];
+//# sourceMappingURL=constants.d.ts.map

package/dist/runtime/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/runtime/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,MAAM;IACjB,wEAAwE;;IAGxE,4DAA4D;;IAG5D,2DAA2D;;IAG3D,sDAAsD;;;;;;IAsBtD,2DAA2D;;IAG3D,sDAAsD;;CAE9C,CAAC;AAMX,eAAO,MAAM,QAAQ;IACnB,2CAA2C;;IAG3C,wCAAwC;;IAGxC,uDAAuD;;CAE/C,CAAC;AAMX,eAAO,MAAM,WAAW,+EAAgF,CAAC;AACzG,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC"}

package/dist/runtime/constants.js

@@ -0,0 +1,58 @@
+/**
+ * Central constants — single source of truth for model names, timeouts, roles.
+ * All magic values live here. Environment variables override where noted.
+ *
+ * @module runtime/constants
+ */
+// ============================================================================
+// Models
+// ============================================================================
+export const MODELS = {
+    /** Default model for config files and new projects (env-overridable) */
+    DEFAULT: process.env['SQUAD_DEFAULT_MODEL'] ?? 'claude-sonnet-4.5',
+    /** Default model for model-selector Layer 4 — cost-first */
+    SELECTOR_DEFAULT: 'claude-haiku-4.5',
+    /** Default tier for the model-selector Layer 4 fallback */
+    SELECTOR_DEFAULT_TIER: 'fast',
+    /** Fallback chains by tier — ordered by preference */
+    FALLBACK_CHAINS: {
+        premium: [
+            'claude-opus-4.6',
+            'claude-opus-4.6-fast',
+            'claude-opus-4.5',
+            'claude-sonnet-4.5',
+        ],
+        standard: [
+            'claude-sonnet-4.5',
+            'gpt-5.2-codex',
+            'claude-sonnet-4',
+            'gpt-5.2',
+        ],
+        fast: [
+            'claude-haiku-4.5',
+            'gpt-5.1-codex-mini',
+            'gpt-4.1',
+            'gpt-5-mini',
+        ],
+    },
+    /** Nuclear fallback model when all chains are exhausted */
+    NUCLEAR_FALLBACK: 'claude-haiku-4.5',
+    /** Maximum retries before nuclear fallback engages */
+    NUCLEAR_MAX_RETRIES: 3,
+};
+// ============================================================================
+// Timeouts
+// ============================================================================
+export const TIMEOUTS = {
+    /** Health check timeout in milliseconds */
+    HEALTH_CHECK_MS: parseInt(process.env['SQUAD_HEALTH_CHECK_MS'] ?? '5000', 10),
+    /** Git clone timeout in milliseconds */
+    GIT_CLONE_MS: parseInt(process.env['SQUAD_GIT_CLONE_MS'] ?? '60000', 10),
+    /** Plugin/marketplace fetch timeout in milliseconds */
+    PLUGIN_FETCH_MS: parseInt(process.env['SQUAD_PLUGIN_FETCH_MS'] ?? '15000', 10),
+};
+// ============================================================================
+// Agent Roles
+// ============================================================================
+export const AGENT_ROLES = ['lead', 'developer', 'tester', 'designer', 'scribe', 'coordinator'];
+//# sourceMappingURL=constants.js.map

package/dist/runtime/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/runtime/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,mBAAmB;IAElE,4DAA4D;IAC5D,gBAAgB,EAAE,kBAAkB;IAEpC,2DAA2D;IAC3D,qBAAqB,EAAE,MAAM;IAE7B,sDAAsD;IACtD,eAAe,EAAE;QACf,OAAO,EAAE;YACP,iBAAiB;YACjB,sBAAsB;YACtB,iBAAiB;YACjB,mBAAmB;SACpB;QACD,QAAQ,EAAE;YACR,mBAAmB;YACnB,eAAe;YACf,iBAAiB;YACjB,SAAS;SACV;QACD,IAAI,EAAE;YACJ,kBAAkB;YAClB,oBAAoB;YACpB,SAAS;YACT,YAAY;SACb;KACF;IAED,2DAA2D;IAC3D,gBAAgB,EAAE,kBAAkB;IAEpC,sDAAsD;IACtD,mBAAmB,EAAE,CAAC;CACd,CAAC;AAEX,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,2CAA2C;IAC3C,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC;IAE7E,wCAAwC;IACxC,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC;IAExE,uDAAuD;IACvD,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC;CACtE,CAAC;AAEX,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAC"}

package/dist/runtime/cost-tracker.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Cost Tracker
+ *
+ * Accumulates cost and token data across a squad run with per-agent and
+ * per-session breakdowns. Wires into EventBus for real-time updates.
+ *
+ * @module runtime/cost-tracker
+ */
+import type { EventBus } from './event-bus.js';
+/** Per-agent cost/token breakdown. */
+export interface AgentCostEntry {
+    agentName: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    estimatedCost: number;
+    turnCount: number;
+    fallbackCount: number;
+}
+/** Per-session cost/token breakdown. */
+export interface SessionCostEntry {
+    sessionId: string;
+    agentName?: string;
+    inputTokens: number;
+    outputTokens: number;
+    estimatedCost: number;
+    turnCount: number;
+}
+/** Total summary across all agents and sessions. */
+export interface CostSummary {
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalEstimatedCost: number;
+    agents: Map<string, AgentCostEntry>;
+    sessions: Map<string, SessionCostEntry>;
+}
+/**
+ * Accumulates cost/token data across the squad run.
+ *
+ * Can be wired to an EventBus to receive live usage events or fed
+ * data manually via `recordUsage()`.
+ */
+export declare class CostTracker {
+    private agents;
+    private sessions;
+    private unsubscribe;
+    /**
+     * Record a single usage event.
+     */
+    recordUsage(opts: {
+        sessionId: string;
+        agentName?: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        estimatedCost: number;
+        isFallback?: boolean;
+    }): void;
+    /** Record a model fallback for an agent (increments fallback counter). */
+    recordFallback(agentName: string): void;
+    /** Get the full cost summary. */
+    getSummary(): CostSummary;
+    /** Get formatted summary string suitable for terminal output. */
+    formatSummary(): string;
+    /** Clear all accumulated data. */
+    reset(): void;
+    /**
+     * Wire into an EventBus to receive real-time `session:message` events
+     * that carry usage payloads. Returns an unsubscribe function.
+     */
+    wireToEventBus(bus: EventBus): () => void;
+}
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/runtime/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/runtime/cost-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,gBAAgB,CAAC;AAM3D,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACzC;AAMD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,WAAW,CAA6B;IAEhD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,IAAI;IA2CR,0EAA0E;IAC1E,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOvC,iCAAiC;IACjC,UAAU,IAAI,WAAW;IAoBzB,iEAAiE;IACjE,aAAa,IAAI,MAAM;IAmCvB,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,IAAI;CA8B1C"}