@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.0

package/dist/bounded-execution/activity-tracker.js

@@ -0,0 +1,381 @@
+import { formatElapsed, STAGE_LABELS, REVIEW_STAGES, } from './activity-tracker-types.js';
+export { formatElapsed, } from './activity-tracker-types.js';
+export class ActivityTracker {
+    onProgress;
+    intervalMs;
+    mainModel;
+    _recordHeartbeat;
+    _batchId;
+    timer = null;
+    startTime = 0;
+    lastLlmMs = 0;
+    lastToolMs = 0;
+    lastTextMs = 0;
+    stageLastEventMs = 0;
+    started = false;
+    stopped = false;
+    // State fields
+    provider;
+    stage = 'implementing';
+    stageIndex = 1;
+    stageCount = 1;
+    reviewRound;
+    attemptCap;
+    // Progress counters (cumulative totals)
+    filesRead = 0;
+    filesWritten = 0;
+    toolCalls = 0;
+    // Cost
+    costUSD = null;
+    costDeltaVsParentUSD = null;
+    // Most recent phase-change, surfaced via getHeartbeatTickInfo so callers can
+    // emit task_phase_change events. Cleared after each getHeartbeatTickInfo read.
+    phaseChangeFrom = null;
+    phaseChangeTo = null;
+    // Rate-card-unresolved flag: true when at least one turn could not be priced
+    // because the model's rate card is unknown (unprofiled model).
+    _rateCardUnresolved = false;
+    constructor(onProgress, options) {
+        this.onProgress = onProgress;
+        this.provider = options.provider;
+        this.mainModel = options.mainModel;
+        this.intervalMs = options.intervalMs ?? 5000;
+        this._recordHeartbeat = options.recordHeartbeat;
+        this._batchId = options.batchId;
+    }
+    /**
+     * Returns a snapshot of the timer's current state for use by recordHeartbeat
+     * callbacks to compose the running headline.
+     */
+    getHeartbeatTickInfo() {
+        const phaseChange = this.phaseChangeFrom !== null && this.phaseChangeTo !== null
+            ? { from: this.phaseChangeFrom, to: this.phaseChangeTo }
+            : undefined;
+        // Consume the pending phase change so the next tick doesn't re-fire it.
+        this.phaseChangeFrom = null;
+        this.phaseChangeTo = null;
+        const now = Date.now();
+        const elapsedMs = this.startTime > 0 ? now - this.startTime : 0;
+        return {
+            batchId: this._batchId ?? '',
+            elapsedMs,
+            idleSinceLlmMs: this.lastLlmMs > 0 ? now - this.lastLlmMs : 0,
+            idleSinceToolMs: this.lastToolMs > 0 ? now - this.lastToolMs : 0,
+            idleSinceTextMs: this.lastTextMs > 0 ? now - this.lastTextMs : 0,
+            stage: this.stage,
+            stageIndex: this.stageIndex,
+            stageCount: this.stageCount,
+            reviewRound: this.reviewRound,
+            attemptCap: this.attemptCap,
+            provider: this.provider,
+            progress: {
+                filesRead: this.filesRead,
+                filesWritten: this.filesWritten,
+                toolCalls: this.toolCalls,
+            },
+            costUSD: this.costUSD,
+            costDeltaVsParentUSD: this.costDeltaVsParentUSD,
+            stageIdleMs: this.stageLastEventMs > 0 ? now - this.stageLastEventMs : 0,
+            headline: this.composeHeadline(formatElapsed(elapsedMs)),
+            snapshot: this.getHeadlineSnapshot(),
+            ...(phaseChange !== undefined && { phaseChange }),
+        };
+    }
+    start(stageCount) {
+        // Clear any existing timer without emitting final heartbeat
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (!Number.isInteger(stageCount) || stageCount < 1) {
+            throw new Error(`stageCount must be a positive integer, got ${stageCount}`);
+        }
+        this.started = true;
+        this.stopped = false;
+        this.startTime = Date.now();
+        this.lastLlmMs = this.startTime;
+        this.lastToolMs = this.startTime;
+        this.lastTextMs = this.startTime;
+        this.stageLastEventMs = this.startTime;
+        this.stage = 'implementing';
+        this.stageIndex = 1;
+        this.stageCount = stageCount;
+        this.reviewRound = undefined;
+        this.attemptCap = undefined;
+        this.filesRead = 0;
+        this.filesWritten = 0;
+        this.toolCalls = 0;
+        this.costUSD = null;
+        this.costDeltaVsParentUSD = null;
+        this.timer = setInterval(() => this.emit(false), this.intervalMs);
+    }
+    stop() {
+        if (this.stopped || !this.started)
+            return; // no-op before start() or after stop()
+        this.stopped = true;
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.emit(true); // final flush
+    }
+    transition(fields) {
+        if (!this.started || this.stopped)
+            return;
+        // Apply provider
+        if (fields.provider !== undefined) {
+            this.provider = fields.provider;
+        }
+        // Apply cost
+        if (fields.costUSD !== undefined) {
+            this.costUSD = fields.costUSD;
+        }
+        if (fields.costDeltaVsParentUSD !== undefined) {
+            this.costDeltaVsParentUSD = fields.costDeltaVsParentUSD;
+        }
+        // Apply stageCount
+        if (fields.stageCount !== undefined) {
+            this.stageCount = fields.stageCount;
+        }
+        // Apply stage with invariant enforcement
+        if (fields.stage !== undefined) {
+            const newStageIndex = fields.stageIndex ?? this.stageIndex;
+            const prevStage = this.stage;
+            this.stage = fields.stage;
+            this.stageIndex = newStageIndex;
+            if (prevStage !== fields.stage) {
+                this.phaseChangeFrom = prevStage;
+                this.phaseChangeTo = fields.stage;
+                this.stageLastEventMs = Date.now();
+            }
+            // Auto-clear review fields for implementing
+            if (fields.stage === 'implementing') {
+                this.reviewRound = undefined;
+                this.attemptCap = undefined;
+            }
+            else if (REVIEW_STAGES.has(fields.stage)) {
+                // Review/rework requires round fields
+                const round = fields.reviewRound ?? this.reviewRound;
+                const attemptCap = fields.attemptCap ?? this.attemptCap;
+                if (round === undefined || attemptCap === undefined) {
+                    throw new Error(`reviewRound and attemptCap required for stage '${fields.stage}'`);
+                }
+                this.reviewRound = round;
+                this.attemptCap = attemptCap;
+            }
+        }
+        else {
+            // Stage didn't change but stageIndex might
+            if (fields.stageIndex !== undefined) {
+                this.stageIndex = fields.stageIndex;
+            }
+            // Apply review fields if provided
+            if (fields.reviewRound !== undefined) {
+                this.reviewRound = fields.reviewRound;
+            }
+            if (fields.attemptCap !== undefined) {
+                this.attemptCap = fields.attemptCap;
+            }
+            // Reject review fields if current stage is implementing
+            if (this.stage === 'implementing' && (this.reviewRound !== undefined || this.attemptCap !== undefined)) {
+                throw new Error('reviewRound and attemptCap must not be set for implementing stage');
+            }
+        }
+        // Validate stageIndex >= 1
+        if (this.stageIndex < 1) {
+            throw new Error(`stageIndex must be >= 1, got ${this.stageIndex}`);
+        }
+        // Auto-grow stageCount when a transition advances past the current cap.
+        // Phase 0 of 3.6.0 telemetry adds verifying/diff_review/committing/terminal
+        // stages that the original `start(stageCount)` call cannot anticipate
+        // (the count was set before those stages joined the lifecycle).
+        if (this.stageIndex > this.stageCount) {
+            this.stageCount = this.stageIndex;
+        }
+        this.emit(false);
+    }
+    setProvider(provider) {
+        this.transition({ provider });
+    }
+    setStage(stage, stageIndex, reviewRound, attemptCap) {
+        this.transition({ stage, stageIndex, reviewRound, attemptCap });
+        // Terminal is the absorbing state: clear the interval so post-terminal
+        // ticks can't fire even if the caller forgets to call stop() (P4).
+        if (stage === 'terminal') {
+            this.stop();
+        }
+    }
+    updateStageCount(stageCount) {
+        if (!this.started || this.stopped)
+            return;
+        if (stageCount < 1 || stageCount < this.stageIndex) {
+            throw new Error(`stageCount ${stageCount} invalid: must be >= 1 and >= current stageIndex ${this.stageIndex}`);
+        }
+        this.stageCount = stageCount;
+    }
+    updateProgress(filesRead, filesWritten, toolCalls) {
+        if (!this.started || this.stopped)
+            return;
+        this.filesRead = filesRead;
+        this.filesWritten = filesWritten;
+        this.toolCalls = toolCalls;
+    }
+    updateCost(costUSD, costDeltaVsParentUSD) {
+        if (!this.started || this.stopped)
+            return;
+        this.costUSD = costUSD;
+        this.costDeltaVsParentUSD = costDeltaVsParentUSD;
+    }
+    recordFileRead() {
+        if (!this.started || this.stopped)
+            return;
+        this.filesRead++;
+    }
+    recordToolCall() {
+        if (!this.started || this.stopped)
+            return;
+        this.toolCalls++;
+    }
+    applyCost(cost) {
+        if (!this.started || this.stopped)
+            return;
+        this.costUSD = cost.costUSD;
+        this.costDeltaVsParentUSD = cost.costDeltaVsParentUSD;
+    }
+    /**
+     * Signal that the running cost is incomplete because the rate card for
+     * the active model is unresolved. When set, heartbeat display shows
+     * "$X.YY+" instead of "$X.YY" to indicate unprofiled pricing.
+     */
+    markRateCardUnresolved() {
+        if (!this.started || this.stopped)
+            return;
+        this._rateCardUnresolved = true;
+    }
+    markEvent(kind) {
+        if (!this.started || this.stopped)
+            return;
+        const now = Date.now();
+        this.stageLastEventMs = now;
+        if (kind === 'llm') {
+            this.lastLlmMs = now;
+        }
+        else if (kind === 'tool') {
+            this.lastToolMs = now;
+        }
+        else {
+            this.lastTextMs = now;
+        }
+    }
+    emit(final) {
+        if (this.stopped && !final)
+            return;
+        const elapsed = formatElapsed(Date.now() - this.startTime);
+        this.onProgress({
+            kind: 'heartbeat',
+            elapsed,
+            provider: this.provider,
+            idleSinceLlmMs: this.lastLlmMs > 0 ? Date.now() - this.lastLlmMs : 0,
+            idleSinceToolMs: this.lastToolMs > 0 ? Date.now() - this.lastToolMs : 0,
+            idleSinceTextMs: this.lastTextMs > 0 ? Date.now() - this.lastTextMs : 0,
+            stage: this.stage,
+            stageIndex: this.stageIndex,
+            stageCount: this.stageCount,
+            reviewRound: this.reviewRound,
+            attemptCap: this.attemptCap,
+            progress: {
+                filesRead: this.filesRead,
+                filesWritten: this.filesWritten,
+                toolCalls: this.toolCalls,
+            },
+            costUSD: this.costUSD,
+            costDeltaVsParentUSD: this.costDeltaVsParentUSD,
+            final,
+            headline: this.composeHeadline(elapsed),
+            stageIdleMs: this.stageLastEventMs > 0 ? Date.now() - this.stageLastEventMs : 0,
+            snapshot: this.getHeadlineSnapshot(),
+        });
+        // Push a tick snapshot so the server can recompose the running headline
+        // and call BatchRegistry.updateRunningHeadline on every tick.
+        if (this._recordHeartbeat) {
+            this._recordHeartbeat(this.getHeartbeatTickInfo());
+        }
+    }
+    composeHeadline(elapsed) {
+        const prefix = `[${this.stageIndex}/${this.stageCount}] ${STAGE_LABELS[this.stage]}`;
+        const roundSuffix = this.reviewRound !== undefined && this.attemptCap !== undefined
+            ? ` (round ${this.reviewRound}/${this.attemptCap})`
+            : '';
+        const providerClause = ` (${this.provider})`;
+        const costClause = this.composeCostClause();
+        const stats = [
+            elapsed,
+            ...(costClause ? [costClause] : []),
+            `${this.filesRead} read`,
+            `${this.filesWritten} written`,
+            `${this.toolCalls} tool calls`,
+        ].join(', ');
+        return `${prefix}${roundSuffix}${providerClause} — ${stats}`;
+    }
+    composeCostClause() {
+        if (this.mainModel && this.costDeltaVsParentUSD !== null && this.costUSD !== null && this.costDeltaVsParentUSD < 0) {
+            const saved = -this.costDeltaVsParentUSD;
+            if (this.costUSD > 0) {
+                const parentCost = this.costUSD - this.costDeltaVsParentUSD;
+                const roi = parentCost / this.costUSD;
+                return `$${saved.toFixed(2)} saved (${roi.toFixed(1)}x)${this._rateCardUnresolved ? '+' : ''}`;
+            }
+            return `$${saved.toFixed(2)} saved${this._rateCardUnresolved ? '+' : ''}`;
+        }
+        if (this.costUSD !== null) {
+            return `$${this.costUSD.toFixed(2)}${this._rateCardUnresolved ? '+' : ''}`;
+        }
+        return null;
+    }
+    getHeadlineSnapshot() {
+        const prefix = this.composeHeadlinePrefix();
+        const statsClause = this.composeStatsClause();
+        const dispatchedAt = Number.isFinite(this.startTime) && this.startTime > 0
+            ? this.startTime
+            : Date.now();
+        return {
+            prefix,
+            statsClause,
+            dispatchedAt,
+            fallback: prefix.trim() || '1/1 queued',
+        };
+    }
+    composeHeadlinePrefix() {
+        const head = `[${this.stageIndex}/${this.stageCount}] ${STAGE_LABELS[this.stage]}`;
+        const roundSuffix = this.reviewRound !== undefined && this.attemptCap !== undefined
+            ? ` (round ${this.reviewRound}/${this.attemptCap})`
+            : '';
+        const providerClause = ` (${this.provider})`;
+        return `${head}${roundSuffix}${providerClause} — `;
+    }
+    composeStatsClause() {
+        const parts = [];
+        const cost = this.composeCostClauseSafe();
+        if (cost)
+            parts.push(cost);
+        if (this.filesRead > 0)
+            parts.push(`${this.filesRead} read`);
+        if (this.filesWritten > 0)
+            parts.push(`${this.filesWritten} written`);
+        if (this.toolCalls > 0)
+            parts.push(`${this.toolCalls} tool ${this.toolCalls === 1 ? 'call' : 'calls'}`);
+        return parts.length === 0 ? '' : `, ${parts.join(', ')}`;
+    }
+    composeCostClauseSafe() {
+        if (this.costDeltaVsParentUSD === null || !Number.isFinite(this.costDeltaVsParentUSD) || this.costDeltaVsParentUSD >= 0)
+            return null;
+        const saved = -this.costDeltaVsParentUSD;
+        if (this.costUSD !== null && Number.isFinite(this.costUSD) && this.costUSD > 0) {
+            const parentCost = this.costUSD - this.costDeltaVsParentUSD;
+            const roi = parentCost / this.costUSD;
+            return `$${saved.toFixed(2)} saved (${roi.toFixed(1)}x)${this._rateCardUnresolved ? '+' : ''}`;
+        }
+        return `$${saved.toFixed(2)} saved${this._rateCardUnresolved ? '+' : ''}`;
+    }
+}
+//# sourceMappingURL=activity-tracker.js.map

package/dist/bounded-execution/activity-tracker.js.map

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

package/dist/bounded-execution/cost-compute.d.ts

@@ -0,0 +1,27 @@
+import type { TokenUsage } from '../providers/runner-types.js';
+export interface RateCard {
+    inputCostPerMTok: number;
+    outputCostPerMTok: number;
+    cachedReadCostPerMTok: number;
+    cachedNonReadCostPerMTok: number;
+}
+export declare function resolveRateCard(model: string | null | undefined, override?: Partial<RateCard>): RateCard | null;
+/**
+ * Per-field max(0, cur − prev) — for incremental delta-from-cumulative tracking.
+ *
+ * Two anomaly cases:
+ * - Single field decreases: provider reporting glitch. Clamp that field to 0;
+ *   warn; carry on. Other fields' deltas remain valid.
+ * - All fields decrease (counter reset, e.g., new sub-agent session with fresh
+ *   counters): treat `prev` as if it were zero — the entire `cur` becomes the
+ *   new delta. Without this branch, lastCumulative would never re-anchor and
+ *   every subsequent turn would also produce zero deltas, freezing the meter.
+ */
+export declare function subtractTokens(cur: TokenUsage, prev: TokenUsage): TokenUsage;
+/**
+ * Pure pricing — multiplies each token class by its rate. No defaults applied here.
+ * Defaults live in resolveRateCard. reasoningTokens are folded into outputTokens
+ * by each runner before emission, so there is no separate reasoning term.
+ */
+export declare function priceTokens(t: TokenUsage, r: RateCard): number;
+//# sourceMappingURL=cost-compute.d.ts.map

package/dist/bounded-execution/cost-compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-compute.d.ts","sourceRoot":"","sources":["../../src/bounded-execution/cost-compute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAID,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAC3B,QAAQ,GAAG,IAAI,CA8BjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAoB5E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAO9D"}

package/dist/bounded-execution/cost-compute.js

@@ -0,0 +1,72 @@
+import { findModelProfile } from '../config/model-profile-registry.js';
+export function resolveRateCard(model, override) {
+    if (!model)
+        return null;
+    const profile = findModelProfile(model);
+    const input = override?.inputCostPerMTok ?? profile.inputCostPerMTok;
+    const rawOutput = override?.outputCostPerMTok ?? profile.outputCostPerMTok;
+    if (input === undefined || rawOutput === undefined ||
+        !Number.isFinite(input) || !Number.isFinite(rawOutput) ||
+        input < 0 || rawOutput < 0) {
+        return null;
+    }
+    // reasoning tokens are folded into outputTokens by each runner.
+    // When a model had a separate (higher) reasoning rate, use that as the
+    // output rate to avoid undercounting cost.
+    const reasoning = profile.reasoningCostPerMTok;
+    const output = (reasoning !== undefined && Number.isFinite(reasoning) && reasoning > rawOutput)
+        ? reasoning
+        : rawOutput;
+    const cachedRead = override?.cachedReadCostPerMTok ?? profile.cachedReadCostPerMTok ?? input * 0.10;
+    const cachedNonRead = override?.cachedNonReadCostPerMTok ?? profile.cachedNonReadCostPerMTok ?? input;
+    return {
+        inputCostPerMTok: input,
+        outputCostPerMTok: output,
+        cachedReadCostPerMTok: cachedRead,
+        cachedNonReadCostPerMTok: cachedNonRead,
+    };
+}
+/**
+ * Per-field max(0, cur − prev) — for incremental delta-from-cumulative tracking.
+ *
+ * Two anomaly cases:
+ * - Single field decreases: provider reporting glitch. Clamp that field to 0;
+ *   warn; carry on. Other fields' deltas remain valid.
+ * - All fields decrease (counter reset, e.g., new sub-agent session with fresh
+ *   counters): treat `prev` as if it were zero — the entire `cur` becomes the
+ *   new delta. Without this branch, lastCumulative would never re-anchor and
+ *   every subsequent turn would also produce zero deltas, freezing the meter.
+ */
+export function subtractTokens(cur, prev) {
+    const fields = [
+        'inputTokens', 'outputTokens', 'cachedReadTokens', 'cachedNonReadTokens',
+    ];
+    const allDecreased = fields.every(f => cur[f] <= prev[f]) && fields.some(f => cur[f] < prev[f]);
+    if (allDecreased) {
+        // eslint-disable-next-line no-console
+        console.warn(`[cost] subtractTokens: detected counter reset (all fields ≤ prev); treating cur as full delta`);
+        return { ...cur };
+    }
+    const out = {};
+    for (const f of fields) {
+        const raw = cur[f] - prev[f];
+        if (raw < 0) {
+            // eslint-disable-next-line no-console
+            console.warn(`[cost] subtractTokens: ${f} went negative (cur=${cur[f]}, prev=${prev[f]}); clamping to 0`);
+        }
+        out[f] = Math.max(0, raw);
+    }
+    return out;
+}
+/**
+ * Pure pricing — multiplies each token class by its rate. No defaults applied here.
+ * Defaults live in resolveRateCard. reasoningTokens are folded into outputTokens
+ * by each runner before emission, so there is no separate reasoning term.
+ */
+export function priceTokens(t, r) {
+    return (t.inputTokens * r.inputCostPerMTok +
+        t.outputTokens * r.outputCostPerMTok +
+        t.cachedReadTokens * r.cachedReadCostPerMTok +
+        t.cachedNonReadTokens * r.cachedNonReadCostPerMTok) / 1_000_000;
+}
+//# sourceMappingURL=cost-compute.js.map

package/dist/bounded-execution/cost-compute.js.map

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

package/dist/bounded-execution/cost-meter.d.ts

@@ -0,0 +1,20 @@
+import type { TokenUsage } from '../providers/runner-types.js';
+export interface Pricing {
+    inputUSDPerMillion: number;
+    outputUSDPerMillion: number;
+    cachedReadUSDPerMillion: number;
+    cachedNonReadUSDPerMillion: number;
+}
+export declare class CostMeter {
+    private accumulated;
+    accumulate(usage: TokenUsage): void;
+    calculate(pricing: Pricing): {
+        actualCostUSD: number;
+    };
+    delta(prior: {
+        actualCostUSD: number;
+    }, current: {
+        actualCostUSD: number;
+    }): number;
+}
+//# sourceMappingURL=cost-meter.d.ts.map

package/dist/bounded-execution/cost-meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-meter.d.ts","sourceRoot":"","sources":["../../src/bounded-execution/cost-meter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,WAAW,OAAO;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAoF;IAEvG,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOnC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE;IAUtD,KAAK,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CAGpF"}

package/dist/bounded-execution/cost-meter.js

@@ -0,0 +1,21 @@
+export class CostMeter {
+    accumulated = { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 };
+    accumulate(usage) {
+        this.accumulated.inputTokens += usage.inputTokens;
+        this.accumulated.outputTokens += usage.outputTokens;
+        this.accumulated.cachedReadTokens += usage.cachedReadTokens;
+        this.accumulated.cachedNonReadTokens += usage.cachedNonReadTokens;
+    }
+    calculate(pricing) {
+        const a = this.accumulated;
+        const cost = (a.inputTokens / 1e6) * pricing.inputUSDPerMillion +
+            (a.outputTokens / 1e6) * pricing.outputUSDPerMillion +
+            (a.cachedReadTokens / 1e6) * pricing.cachedReadUSDPerMillion +
+            (a.cachedNonReadTokens / 1e6) * pricing.cachedNonReadUSDPerMillion;
+        return { actualCostUSD: cost };
+    }
+    delta(prior, current) {
+        return current.actualCostUSD - prior.actualCostUSD;
+    }
+}
+//# sourceMappingURL=cost-meter.js.map

package/dist/bounded-execution/cost-meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-meter.js","sourceRoot":"","sources":["../../src/bounded-execution/cost-meter.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,SAAS;IACZ,WAAW,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC;IAEvG,UAAU,CAAC,KAAiB;QAC1B,IAAI,CAAC,WAAW,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;QAClD,IAAI,CAAC,WAAW,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;QACpD,IAAI,CAAC,WAAW,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,CAAC;QAC5D,IAAI,CAAC,WAAW,CAAC,mBAAmB,IAAI,KAAK,CAAC,mBAAmB,CAAC;IACpE,CAAC;IAED,SAAS,CAAC,OAAgB;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC3B,MAAM,IAAI,GACR,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,kBAAkB;YAClD,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,mBAAmB;YACpD,CAAC,CAAC,CAAC,gBAAgB,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,uBAAuB;YAC5D,CAAC,CAAC,CAAC,mBAAmB,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC;QACrE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAgC,EAAE,OAAkC;QACxE,OAAO,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;IACrD,CAAC;CACF"}

package/dist/bounded-execution/cost-rollup.d.ts

@@ -0,0 +1,17 @@
+import type { TokenUsage } from '../providers/runner-types.js';
+export interface StageLike extends TokenUsage {
+    tier: 'standard' | 'complex';
+    model: string;
+    costUSD: number | null;
+}
+export interface TierUsage extends TokenUsage {
+    model: string;
+    costUSD: number | null;
+}
+export type TierRollup = {
+    standard?: TierUsage;
+    complex?: TierUsage;
+};
+export declare function sumTokens(stages: ReadonlyArray<TokenUsage>): TokenUsage;
+export declare function rollupByTier(stages: ReadonlyArray<StageLike>): TierRollup;
+//# sourceMappingURL=cost-rollup.d.ts.map

package/dist/bounded-execution/cost-rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-rollup.d.ts","sourceRoot":"","sources":["../../src/bounded-execution/cost-rollup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAG,SAAS,CAAC;CACtB,CAAC;AAEF,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,UAAU,CAYvE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,UAAU,CAwBzE"}

package/dist/bounded-execution/cost-rollup.js

@@ -0,0 +1,40 @@
+export function sumTokens(stages) {
+    const acc = {
+        inputTokens: 0, outputTokens: 0,
+        cachedReadTokens: 0, cachedNonReadTokens: 0,
+    };
+    for (const s of stages) {
+        acc.inputTokens += s.inputTokens;
+        acc.outputTokens += s.outputTokens;
+        acc.cachedReadTokens += s.cachedReadTokens;
+        acc.cachedNonReadTokens += s.cachedNonReadTokens;
+    }
+    return acc;
+}
+export function rollupByTier(stages) {
+    const out = {};
+    for (const s of stages) {
+        const cur = out[s.tier];
+        if (!cur) {
+            out[s.tier] = {
+                model: s.model,
+                costUSD: s.costUSD,
+                inputTokens: s.inputTokens,
+                outputTokens: s.outputTokens,
+                cachedReadTokens: s.cachedReadTokens,
+                cachedNonReadTokens: s.cachedNonReadTokens,
+            };
+        }
+        else {
+            cur.model = s.model; // last-seen
+            cur.inputTokens += s.inputTokens;
+            cur.outputTokens += s.outputTokens;
+            cur.cachedReadTokens += s.cachedReadTokens;
+            cur.cachedNonReadTokens += s.cachedNonReadTokens;
+            // honest-null: any contributing null poisons the tier total
+            cur.costUSD = (cur.costUSD === null || s.costUSD === null) ? null : cur.costUSD + s.costUSD;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=cost-rollup.js.map

package/dist/bounded-execution/cost-rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-rollup.js","sourceRoot":"","sources":["../../src/bounded-execution/cost-rollup.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,SAAS,CAAC,MAAiC;IACzD,MAAM,GAAG,GAAe;QACtB,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;QAC/B,gBAAgB,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC;KAC5C,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,WAAW,IAAa,CAAC,CAAC,WAAW,CAAC;QAC1C,GAAG,CAAC,YAAY,IAAY,CAAC,CAAC,YAAY,CAAC;QAC3C,GAAG,CAAC,gBAAgB,IAAQ,CAAC,CAAC,gBAAgB,CAAC;QAC/C,GAAG,CAAC,mBAAmB,IAAK,CAAC,CAAC,mBAAmB,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;gBACpC,mBAAmB,EAAE,CAAC,CAAC,mBAAmB;aAC3C,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY;YACjC,GAAG,CAAC,WAAW,IAAa,CAAC,CAAC,WAAW,CAAC;YAC1C,GAAG,CAAC,YAAY,IAAY,CAAC,CAAC,YAAY,CAAC;YAC3C,GAAG,CAAC,gBAAgB,IAAQ,CAAC,CAAC,gBAAgB,CAAC;YAC/C,GAAG,CAAC,mBAAmB,IAAK,CAAC,CAAC,mBAAmB,CAAC;YAClD,4DAA4D;YAC5D,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC9F,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/bounded-execution/error-classifier.d.ts

@@ -0,0 +1,11 @@
+import type { ErrorCode } from '../error-codes.js';
+export interface ClassifiedError {
+    code: ErrorCode;
+    message: string;
+    retriable: boolean;
+}
+export declare function classifyError(err: unknown, _ctx?: {
+    stage?: string;
+    route?: string;
+}): ClassifiedError;
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/bounded-execution/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../src/bounded-execution/error-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAYnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,eAAe,CAejB"}