paracosm 0.4.146 → 0.4.148

package/dist/src/runtime/citations-catalog.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Flat, deduplicated citation catalog builder.
+ *
+ * Every department report in a run carries its own citations. The
+ * catalog merges them by URL (falling back to text when no URL is
+ * present) and tracks which departments + turns referenced each
+ * citation, so the References section in reports can show
+ * provenance across the whole run.
+ *
+ * Pure — takes the per-turn report list, returns a serialisable array.
+ *
+ * @module paracosm/runtime/citations-catalog
+ */
+import type { DepartmentReport } from './contracts.js';
+/** One row in the run's flat citation catalog. */
+export interface CitationCatalogEntry {
+    text: string;
+    url: string;
+    doi?: string;
+    departments: string[];
+    turns: number[];
+}
+/**
+ * Build the canonical citation catalog from a run's department reports.
+ * Dedup key is URL when present, else the citation text. DOI is
+ * preserved from whichever occurrence first supplies it. Turn numbers
+ * are sorted ascending in the output so consumers render a clean
+ * chronological trail.
+ */
+export declare function buildCitationCatalog(allDepartmentReports: ReadonlyArray<{
+    turn: number;
+    report: DepartmentReport;
+}>): CitationCatalogEntry[];
+//# sourceMappingURL=citations-catalog.d.ts.map

package/dist/src/runtime/citations-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations-catalog.d.ts","sourceRoot":"","sources":["../../../src/runtime/citations-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,oBAAoB,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC9E,oBAAoB,EAAE,CAiCxB"}

package/dist/src/runtime/citations-catalog.js

@@ -0,0 +1,52 @@
+/**
+ * Flat, deduplicated citation catalog builder.
+ *
+ * Every department report in a run carries its own citations. The
+ * catalog merges them by URL (falling back to text when no URL is
+ * present) and tracks which departments + turns referenced each
+ * citation, so the References section in reports can show
+ * provenance across the whole run.
+ *
+ * Pure — takes the per-turn report list, returns a serialisable array.
+ *
+ * @module paracosm/runtime/citations-catalog
+ */
+/**
+ * Build the canonical citation catalog from a run's department reports.
+ * Dedup key is URL when present, else the citation text. DOI is
+ * preserved from whichever occurrence first supplies it. Turn numbers
+ * are sorted ascending in the output so consumers render a clean
+ * chronological trail.
+ */
+export function buildCitationCatalog(allDepartmentReports) {
+    const byKey = new Map();
+    for (const { turn, report } of allDepartmentReports) {
+        for (const c of report.citations) {
+            const key = (c.url || '').trim() || `text:${(c.text || '').trim()}`;
+            if (!key)
+                continue;
+            let entry = byKey.get(key);
+            if (!entry) {
+                entry = {
+                    text: c.text || c.url || '',
+                    url: c.url || '',
+                    doi: c.doi,
+                    departments: new Set(),
+                    turns: new Set(),
+                };
+                byKey.set(key, entry);
+            }
+            if (report.department)
+                entry.departments.add(report.department);
+            entry.turns.add(turn);
+            if (!entry.doi && c.doi)
+                entry.doi = c.doi;
+        }
+    }
+    return [...byKey.values()].map(e => ({
+        ...e,
+        departments: [...e.departments],
+        turns: [...e.turns].sort((a, b) => a - b),
+    }));
+}
+//# sourceMappingURL=citations-catalog.js.map

package/dist/src/runtime/citations-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations-catalog.js","sourceRoot":"","sources":["../../../src/runtime/citations-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,oBAA+E;IAE/E,MAAM,KAAK,GAAG,IAAI,GAAG,EAMjB,CAAC;IACL,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,oBAAoB,EAAE,CAAC;QACpD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACpE,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG;oBACN,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE;oBAC3B,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;oBAChB,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,WAAW,EAAE,IAAI,GAAG,EAAE;oBACtB,KAAK,EAAE,IAAI,GAAG,EAAE;iBACjB,CAAC;gBACF,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,IAAI,MAAM,CAAC,UAAU;gBAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG;gBAAE,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnC,GAAG,CAAC;QACJ,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QAC/B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;KAC1C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/src/runtime/commander-setup.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Commander bootstrap + turn-0 department-head promotions.
+ *
+ * Extracted from orchestrator.ts so runSimulation reads as a turn loop
+ * rather than a 100-line setup block before the loop even starts.
+ * The two responsibilities are:
+ *
+ *   1. Build a personality-cue line from the leader's HEXACO so the
+ *      commander's first message reinforces trait-driven decision
+ *      style (high-openness → "favor novel approaches", etc.).
+ *   2. Fire the turn-0 promotion LLM call, parse the response, and
+ *      ask the kernel to promote the named candidates. A top-candidate
+ *      fallback runs for any department the commander skipped so
+ *      every dept always has a head going into turn 1.
+ *
+ * All kernel mutations, SSE emits, and cost-tracker calls flow through
+ * callbacks passed in by the orchestrator, so this module stays free
+ * of the turn-loop's closure state.
+ *
+ * @module paracosm/runtime/commander-setup
+ */
+import type { HexacoProfile } from '../engine/core/state.js';
+import type { SimulationKernel } from '../engine/core/kernel.js';
+import type { ScenarioPackage, LeaderConfig } from '../engine/types.js';
+import type { CallUsage } from './cost-tracker.js';
+/** Build a short "Your decision style" line from the leader's HEXACO profile. */
+export declare function buildPersonalityCue(h: HexacoProfile): string;
+/**
+ * Assemble the bootstrap message sent to the commander session right
+ * after it's created. Reinforces the leader's personality cue + the
+ * selectedOptionId JSON format the downstream turn loop expects.
+ */
+export declare function buildCommanderBootstrap(personalityCue: string): string;
+/**
+ * Candidate-summary dependencies needed to run the turn-0 promotion.
+ * Kept minimal so the flow doesn't couple to the full kernel surface —
+ * tests can stub getCandidates + promoteAgent with ~20 lines of fakes.
+ */
+export interface PromotionKernel {
+    getCandidates: SimulationKernel['getCandidates'];
+    promoteAgent: SimulationKernel['promoteAgent'];
+    getState: SimulationKernel['getState'];
+}
+export interface RunPromotionArgs {
+    kernel: PromotionKernel;
+    scenario: ScenarioPackage;
+    leader: LeaderConfig;
+    startYear: number;
+    /** Commander session `.send(prompt)` — returns whatever AgentOS returns. */
+    sendToCommander: (prompt: string) => Promise<{
+        text: string;
+        usage?: CallUsage;
+    }>;
+    /** Tagged cost-tracker entry point so the commander bucket gets charged. */
+    trackUsage: (result: {
+        usage?: CallUsage;
+    }, site?: 'commander') => void;
+    /** SSE emit used to publish each successful promotion. */
+    emit: (type: 'promotion', data?: Record<string, unknown>) => void;
+}
+/**
+ * Run the turn-0 promotion flow end to end: build the candidate summary
+ * from the kernel, send it to the commander session, parse the returned
+ * JSON, and tell the kernel to promote each accepted candidate. When
+ * the commander skips a department (bad JSON, refused promotion, etc.)
+ * the top kernel candidate for that department is promoted as a
+ * fallback so no department enters turn 1 without a head.
+ */
+export declare function runDepartmentPromotions(args: RunPromotionArgs): Promise<void>;
+//# sourceMappingURL=commander-setup.d.ts.map

package/dist/src/runtime/commander-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-setup.d.ts","sourceRoot":"","sources":["../../../src/runtime/commander-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAW5D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAYtE;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;IACjD,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAClF,4EAA4E;IAC5E,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACxE,0DAA0D;IAC1D,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnE;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CnF"}

package/dist/src/runtime/commander-setup.js

@@ -0,0 +1,116 @@
+/**
+ * Commander bootstrap + turn-0 department-head promotions.
+ *
+ * Extracted from orchestrator.ts so runSimulation reads as a turn loop
+ * rather than a 100-line setup block before the loop even starts.
+ * The two responsibilities are:
+ *
+ *   1. Build a personality-cue line from the leader's HEXACO so the
+ *      commander's first message reinforces trait-driven decision
+ *      style (high-openness → "favor novel approaches", etc.).
+ *   2. Fire the turn-0 promotion LLM call, parse the response, and
+ *      ask the kernel to promote the named candidates. A top-candidate
+ *      fallback runs for any department the commander skipped so
+ *      every dept always has a head going into turn 1.
+ *
+ * All kernel mutations, SSE emits, and cost-tracker calls flow through
+ * callbacks passed in by the orchestrator, so this module stays free
+ * of the turn-loop's closure state.
+ *
+ * @module paracosm/runtime/commander-setup
+ */
+import { buildPromotionPrompt } from './runtime-helpers.js';
+/** Build a short "Your decision style" line from the leader's HEXACO profile. */
+export function buildPersonalityCue(h) {
+    const cues = [];
+    if (h.openness > 0.7)
+        cues.push('You favor novel, untested approaches over proven ones');
+    if (h.openness < 0.3)
+        cues.push('You favor proven protocols over experiments');
+    if (h.conscientiousness > 0.7)
+        cues.push('You demand evidence and contingency plans before committing');
+    if (h.conscientiousness < 0.3)
+        cues.push('You move fast and accept ambiguity');
+    if (h.emotionality > 0.7)
+        cues.push('You weigh human cost heavily — even small mortality risks deter you');
+    if (h.emotionality < 0.3)
+        cues.push('You will accept casualties for strategic gain');
+    if (h.agreeableness < 0.4)
+        cues.push('You override department consensus when you see a better path');
+    if (h.honestyHumility < 0.4)
+        cues.push('You leverage information asymmetries when useful');
+    return cues.length ? `Your decision style: ${cues.join('. ')}.` : '';
+}
+/**
+ * Assemble the bootstrap message sent to the commander session right
+ * after it's created. Reinforces the leader's personality cue + the
+ * selectedOptionId JSON format the downstream turn loop expects.
+ */
+export function buildCommanderBootstrap(personalityCue) {
+    return (`You are the colony commander. You receive department reports and make strategic decisions. ` +
+        `${personalityCue} ` +
+        `Your personality MUST visibly shape your choices — do not converge on a centrist option just because ` +
+        `it sounds reasonable. If your traits push you toward the risky option, take it; if they push you toward ` +
+        `the safe option, take it. The simulation's value is in how different leaders produce different outcomes ` +
+        `from the same starting state. ` +
+        `When the crisis includes options with IDs, you MUST include selectedOptionId in your JSON response. ` +
+        `Return JSON with selectedOptionId, decision, rationale, selectedPolicies, rejectedPolicies, ` +
+        `expectedTradeoffs, watchMetricsNextTurn. Acknowledge.`);
+}
+/**
+ * Run the turn-0 promotion flow end to end: build the candidate summary
+ * from the kernel, send it to the commander session, parse the returned
+ * JSON, and tell the kernel to promote each accepted candidate. When
+ * the commander skips a department (bad JSON, refused promotion, etc.)
+ * the top kernel candidate for that department is promoted as a
+ * fallback so no department enters turn 1 without a head.
+ */
+export async function runDepartmentPromotions(args) {
+    const { kernel, scenario, leader, startYear, sendToCommander, trackUsage, emit } = args;
+    console.log('  [Turn 0] Commander evaluating roster for promotions...');
+    const promotionDepts = scenario.departments.map(d => d.id);
+    const roleNames = Object.fromEntries(scenario.departments.map(d => [d.id, d.role]));
+    const candidateSummaries = promotionDepts.map(dept => {
+        const candidates = kernel.getCandidates(dept, 5);
+        return `## ${dept.toUpperCase()} — Top 5 Candidates:\n${candidates.map(c => {
+            const age = startYear - c.core.birthYear;
+            const h = c.hexaco;
+            return `- ${c.core.name} (${c.core.id}), age ${age}, spec: ${c.career.specialization}, O:${h.openness.toFixed(2)} C:${h.conscientiousness.toFixed(2)} E:${h.extraversion.toFixed(2)} A:${h.agreeableness.toFixed(2)} Em:${h.emotionality.toFixed(2)} HH:${h.honestyHumility.toFixed(2)}`;
+        }).join('\n')}`;
+    }).join('\n\n');
+    const promoResult = await sendToCommander(buildPromotionPrompt(candidateSummaries));
+    trackUsage(promoResult, 'commander');
+    const promoMatch = promoResult.text.match(/\{[\s\S]*"promotions"[\s\S]*\}/);
+    if (promoMatch) {
+        try {
+            const pd = JSON.parse(promoMatch[0]);
+            for (const p of pd.promotions || []) {
+                try {
+                    kernel.promoteAgent(p.agentId, p.department, p.role, leader.name);
+                    console.log(`  ✦ ${p.agentId} → ${p.role}: ${p.reason?.slice(0, 80)}`);
+                    emit('promotion', { agentId: p.agentId, department: p.department, role: p.role, reason: p.reason?.slice(0, 120) });
+                }
+                catch (err) {
+                    console.log(`  ✦ Promotion failed: ${err}`);
+                }
+            }
+        }
+        catch (e) {
+            console.warn('  [promotion] Failed to parse promotion JSON:', e);
+        }
+    }
+    // Fallback: promote the top candidate for any department the commander
+    // left unfilled, so turn 1 starts with a full cabinet regardless of
+    // how well the LLM followed instructions.
+    for (const dept of promotionDepts) {
+        const hasLeader = kernel.getState().agents.some(c => c.promotion?.department === dept);
+        if (!hasLeader) {
+            const top = kernel.getCandidates(dept, 1)[0];
+            if (top) {
+                kernel.promoteAgent(top.core.id, dept, roleNames[dept] || `Head of ${dept}`, leader.name);
+                console.log(`  ✦ [fallback] ${top.core.name} → ${roleNames[dept]}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=commander-setup.js.map

package/dist/src/runtime/commander-setup.js.map

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

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

@@ -0,0 +1,87 @@
+/**
+ * Per-run cost + token telemetry with per-stage buckets.
+ *
+ * Extracted from orchestrator.ts so the trackUsage / cache-savings math
+ * has one home, testable in isolation from the turn loop. The tracker
+ * is stateful (totals accumulate across every tagged LLM call) and
+ * returns a buildCostPayload() helper the orchestrator invokes before
+ * every SSE emit so the dashboard breakdown modal reflects the latest
+ * per-stage split + cache hit rate.
+ *
+ * Pricing lookup comes from pricing.ts so MODEL_PRICING has one home.
+ *
+ * @module paracosm/runtime/cost-tracker
+ */
+import type { SimulationModelConfig } from '../engine/types.js';
+import { type CostSite } from './pricing.js';
+/** Token + cost rollup for a single pipeline stage across a run. */
+export interface CostBucket {
+    totalTokens: number;
+    totalCostUSD: number;
+    calls: number;
+    /** Cache-read tokens billed at 0.1× input rate (prompt-cache hit). */
+    cacheReadTokens: number;
+    /** Cache-write tokens billed at 1.25× input rate (new cache entry). */
+    cacheCreationTokens: number;
+}
+/** Shape of the `usage` field providers return on each LLM call. */
+export interface CallUsage {
+    totalTokens?: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    costUSD?: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+}
+/** Per-stage entry on the breakdown payload attached to every SSE emit. */
+export interface CostBreakdownEntry {
+    totalTokens: number;
+    totalCostUSD: number;
+    calls: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+    /** USD saved vs no-caching run. Negative during turn 1, positive turn 2+. */
+    cacheSavingsUSD?: number;
+}
+/** Aggregate cost payload embedded on every SSE event's `_cost` field. */
+export interface CostPayload {
+    totalTokens: number;
+    totalCostUSD: number;
+    llmCalls: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    /** Run-wide USD saved by prompt caching vs a no-cache run. */
+    cacheSavingsUSD: number;
+    breakdown: Record<string, CostBreakdownEntry>;
+}
+/** Cost tracker bundle returned by createCostTracker. */
+export interface CostTracker {
+    /** Record token + cost usage from a single LLM call, tagged by site. */
+    trackUsage(result: {
+        usage?: CallUsage;
+    }, site?: CostSite): void;
+    /** Build the _cost payload attached to every SSE event. */
+    buildCostPayload(): CostPayload;
+    /** Final-run snapshot for the output JSON. */
+    finalCost(): {
+        totalTokens: number;
+        totalCostUSD: number;
+        llmCalls: number;
+    };
+}
+/**
+ * Create a per-run cost tracker bound to a specific model config.
+ *
+ * Cache cost math: Anthropic bills cache_read at 0.10× input (saves
+ * 0.90×) and cache_creation at 1.25× (costs +0.25×). Net savings per
+ * site = (reads × 0.90 − creates × 0.25) × inputPrice. Turn 1 is a
+ * net COST because the cache hasn't amortized. Turn 3+ with reads
+ * dominating produces substantial savings.
+ *
+ * Fallback cost estimate (when provider omits costUSD) uses
+ * commander-tier pricing as an approximation. Previously this path
+ * ignored cache entirely so heavy-caching runs under-reported billed
+ * amount by ~10-15%.
+ */
+export declare function createCostTracker(modelConfig: SimulationModelConfig): CostTracker;
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/src/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;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AAEtB,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC/C;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,UAAU,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjE,2DAA2D;IAC3D,gBAAgB,IAAI,WAAW,CAAC;IAChC,8CAA8C;IAC9C,SAAS,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,qBAAqB,GAAG,WAAW,CA6FjF"}

package/dist/src/runtime/cost-tracker.js

@@ -0,0 +1,119 @@
+/**
+ * Per-run cost + token telemetry with per-stage buckets.
+ *
+ * Extracted from orchestrator.ts so the trackUsage / cache-savings math
+ * has one home, testable in isolation from the turn loop. The tracker
+ * is stateful (totals accumulate across every tagged LLM call) and
+ * returns a buildCostPayload() helper the orchestrator invokes before
+ * every SSE emit so the dashboard breakdown modal reflects the latest
+ * per-stage split + cache hit rate.
+ *
+ * Pricing lookup comes from pricing.ts so MODEL_PRICING has one home.
+ *
+ * @module paracosm/runtime/cost-tracker
+ */
+import { buildPriceForSite, getDefaultPricing, } from './pricing.js';
+/**
+ * Create a per-run cost tracker bound to a specific model config.
+ *
+ * Cache cost math: Anthropic bills cache_read at 0.10× input (saves
+ * 0.90×) and cache_creation at 1.25× (costs +0.25×). Net savings per
+ * site = (reads × 0.90 − creates × 0.25) × inputPrice. Turn 1 is a
+ * net COST because the cache hasn't amortized. Turn 3+ with reads
+ * dominating produces substantial savings.
+ *
+ * Fallback cost estimate (when provider omits costUSD) uses
+ * commander-tier pricing as an approximation. Previously this path
+ * ignored cache entirely so heavy-caching runs under-reported billed
+ * amount by ~10-15%.
+ */
+export function createCostTracker(modelConfig) {
+    let totalTokens = 0;
+    let totalCostUSD = 0;
+    let llmCalls = 0;
+    let cacheReadTokens = 0;
+    let cacheCreationTokens = 0;
+    const defaultPricing = getDefaultPricing(modelConfig);
+    const priceForSite = buildPriceForSite(modelConfig);
+    const newBucket = () => ({
+        totalTokens: 0, totalCostUSD: 0, calls: 0,
+        cacheReadTokens: 0, cacheCreationTokens: 0,
+    });
+    const costBySite = {
+        director: newBucket(),
+        commander: newBucket(),
+        departments: newBucket(),
+        judge: newBucket(),
+        reactions: newBucket(),
+        other: newBucket(),
+    };
+    const trackUsage = (result, site = 'other') => {
+        if (!result?.usage)
+            return;
+        const tokensThisCall = result.usage.totalTokens ?? 0;
+        const callCacheRead = result.usage.cacheReadTokens ?? 0;
+        const callCacheCreate = result.usage.cacheCreationTokens ?? 0;
+        let costThisCall;
+        if (typeof result.usage.costUSD === 'number') {
+            costThisCall = result.usage.costUSD;
+        }
+        else {
+            const input = result.usage.promptTokens ?? 0;
+            const output = result.usage.completionTokens ?? 0;
+            costThisCall =
+                (input * defaultPricing.input / 1_000_000)
+                    + (output * defaultPricing.output / 1_000_000)
+                    + (callCacheRead * defaultPricing.input * 0.10 / 1_000_000)
+                    + (callCacheCreate * defaultPricing.input * 1.25 / 1_000_000);
+        }
+        totalTokens += tokensThisCall;
+        totalCostUSD += costThisCall;
+        llmCalls++;
+        cacheReadTokens += callCacheRead;
+        cacheCreationTokens += callCacheCreate;
+        const bucket = costBySite[site];
+        bucket.totalTokens += tokensThisCall;
+        bucket.totalCostUSD += costThisCall;
+        bucket.calls++;
+        bucket.cacheReadTokens += callCacheRead;
+        bucket.cacheCreationTokens += callCacheCreate;
+    };
+    const buildCostPayload = () => {
+        let runCacheSavingsUSD = 0;
+        const breakdown = {};
+        for (const [k, v] of Object.entries(costBySite)) {
+            if (v.calls > 0) {
+                const sitePricing = priceForSite(k);
+                const siteSavings = ((v.cacheReadTokens * 0.90) - (v.cacheCreationTokens * 0.25))
+                    * sitePricing.input / 1_000_000;
+                runCacheSavingsUSD += siteSavings;
+                breakdown[k] = {
+                    totalTokens: v.totalTokens,
+                    totalCostUSD: Math.round(v.totalCostUSD * 10000) / 10000,
+                    calls: v.calls,
+                    ...(v.cacheReadTokens > 0 ? { cacheReadTokens: v.cacheReadTokens } : {}),
+                    ...(v.cacheCreationTokens > 0 ? { cacheCreationTokens: v.cacheCreationTokens } : {}),
+                    ...(Math.abs(siteSavings) >= 0.0001
+                        ? { cacheSavingsUSD: Math.round(siteSavings * 10000) / 10000 }
+                        : {}),
+                };
+            }
+        }
+        return {
+            totalTokens,
+            totalCostUSD: Math.round(totalCostUSD * 10000) / 10000,
+            llmCalls,
+            cacheReadTokens,
+            cacheCreationTokens,
+            cacheSavingsUSD: Math.round(runCacheSavingsUSD * 10000) / 10000,
+            breakdown,
+        };
+    };
+    const finalCost = () => ({
+        totalTokens,
+        totalCostUSD: Math.round(totalCostUSD * 10000) / 10000,
+        llmCalls,
+    });
+    return { trackUsage, buildCostPayload, finalCost };
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/src/runtime/cost-tracker.js.map

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

package/dist/src/runtime/orchestrator.d.ts

@@ -102,48 +102,9 @@ export declare function runSimulation(leader: LeaderConfig, keyPersonnel: KeyPer
         eventIndex: number;
     })[];
     /** Canonical deduplicated forged toolbox (parity with dashboard ToolboxSection). */
-    forgedToolbox: {
-        name: string;
-        description: string;
-        mode: string;
-        firstForgedTurn: number;
-        firstForgedDepartment: string;
-        firstForgedEventTitle: string;
-        departments: string[];
-        /** Total uses minus the original forge. */
-        reuseCount: number;
-        /** Total uses including the original forge. */
-        totalUses: number;
-        /** How many of those uses were re-forge attempts. */
-        reforgeCount: number;
-        /** Re-forge attempts that the judge rejected. */
-        rejectedReforges: number;
-        approved: boolean;
-        confidence: number;
-        inputSchema: unknown;
-        outputSchema: unknown;
-        sampleOutput: unknown;
-        /** Full audit trail: every invocation with turn, year, dept, output. */
-        history: Array<{
-            turn: number;
-            year: number;
-            eventIndex: number;
-            eventTitle: string;
-            department: string;
-            output: string | null;
-            isReforge: boolean;
-            rejected: boolean;
-            confidence?: number;
-        }>;
-    }[];
+    forgedToolbox: import("./tool-ledger.js").ForgedToolboxEntry[];
     /** Canonical deduplicated citation catalog (parity with References). */
-    citationCatalog: {
-        departments: string[];
-        turns: number[];
-        text: string;
-        url: string;
-        doi?: string;
-    }[];
+    citationCatalog: import("./citations-catalog.js").CitationCatalogEntry[];
     /** Per-turn agent reactions with mood + quote + memory snippets. */
     agentReactions: {
         turn: number;

package/dist/src/runtime/orchestrator.d.ts.map

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