@kodax-ai/kodax 0.7.42 → 0.7.43

package/dist/types-chunks/{bash-prefix-extractor.d-CkhaqKkg.d.ts → bash-prefix-extractor.d-DMrGImMl.d.ts}

@@ -1,9 +1,10 @@
-import { a as KodaXCompactMemorySeed, h as KodaXSessionArtifactLedgerEntry, t as KodaXSessionScope, u as KodaXSessionStorage, f as KodaXJsonValue, S as SessionErrorMetadata } from './types.d-mM8vqvhT.js';
+import { t as KodaXSessionScope, u as KodaXSessionStorage, f as KodaXJsonValue, h as KodaXSessionArtifactLedgerEntry, S as SessionErrorMetadata } from './types.d-mM8vqvhT.js';
 import { m as KodaXMessage, W as KodaXTokenUsage, D as KodaXReasoningMode, k as KodaXHarnessProfile, R as KodaXTaskWorkIntent, H as KodaXReviewScale, N as KodaXTaskComplexity, a as KodaXAmaFanoutClass, P as KodaXTaskRoutingDecision, Q as KodaXTaskType, I as KodaXRiskLevel, i as KodaXExecutionMode, c as KodaXAmaProfile, d as KodaXAmaTactic, b as KodaXAmaFanoutPolicy } from './types.d-B1uGoVTE.js';
-import { G as Guardrail, D as DiscoveredInstance, C as ChildTaskRegistry, T as TaskAbortRegistry, r as RunnerToolCall, J as ToolGuardrail } from './instance-discovery.d-BsKnIwpg.js';
-import { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
+import { k as CompactionUpdate, o as Guardrail, D as DiscoveredInstance, C as ChildTaskRegistry, a1 as TaskAbortRegistry, K as RunnerToolCall, a4 as ToolGuardrail } from './types.d-CKJtjo-6.js';
 import { M as McpConnectMode, a as McpServerConfig, b as McpServersConfig, c as McpTransportKind } from './config.d-BfJUXxC0.js';
-import { K as KodaXBaseProvider, a as CostTracker } from './cost-tracker.d-B6vMoLLF.js';
+import { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
+import { K as KodaXBaseProvider } from './base.d-FUJahC0i.js';
+import { a as CostTracker } from './cost-tracker.d-wRtyEW9d.js';
 
 /** One tool-call breadcrumb. Captures only the name + a 60-char input
  * hint so the snapshot stays compact under fan-out. Mirrors the
@@ -61,6 +62,13 @@ interface ChildProgressSnapshot {
     /** Read-only flag forwarded from the dispatch bundle. Same rationale
      * as `parentRole` — currently captured for future surfacing. */
     readonly readOnly?: boolean;
+    /**
+     * FEATURE_191 — registered specialist agent name when the dispatch
+     * routed through a `subagent_type` argument. `undefined` for generic
+     * anonymous children. Surfaced by `task_output` so post-mortem peeks
+     * can identify which specialist owned the child.
+     */
+    readonly specialistName?: string;
 }
 
 /** Result of a cache lookup. */
@@ -315,53 +323,6 @@ interface TodoStore {
     reset(): void;
 }
 
-/**
- * @kodax-ai/agent Compaction Types
- */
-
-interface CompactionDetails {
-    readFiles: string[];
-    modifiedFiles: string[];
-}
-interface CompactionAnchor {
-    summary: string;
-    tokensBefore: number;
-    tokensAfter: number;
-    entriesRemoved: number;
-    reason: string;
-    artifactLedgerId?: string;
-    details?: CompactionDetails;
-    memorySeed?: KodaXCompactMemorySeed;
-}
-interface CompactionUpdate {
-    anchor?: CompactionAnchor;
-    artifactLedger?: KodaXSessionArtifactLedgerEntry[];
-    memorySeed?: KodaXCompactMemorySeed;
-    /**
-     * FEATURE_072: ledger-summary + file-content messages produced by
-     * `buildPostCompactAttachments` + `buildFileContentMessages`. Agent.ts
-     * passes these separately from the kept-tail messages so REPL-side
-     * `applySessionCompaction` can store them natively on the CompactionEntry
-     * rather than inlining them as loose `[Post-compact: ...]` system messages
-     * in lineage. Agent.ts keeps inlining them into its local flat `messages`
-     * via `injectPostCompactAttachments` (P4 belt-and-suspenders); the lineage
-     * is the persistence source of truth.
-     */
-    postCompactAttachments?: readonly KodaXMessage[];
-}
-interface CompactionResult {
-    compacted: boolean;
-    messages: KodaXMessage[];
-    summary?: string;
-    tokensBefore: number;
-    tokensAfter: number;
-    entriesRemoved: number;
-    details?: CompactionDetails;
-    artifactLedger?: KodaXSessionArtifactLedgerEntry[];
-    anchor?: CompactionAnchor;
-    memorySeed?: KodaXCompactMemorySeed;
-}
-
 /**
  * FEATURE_093 (v0.7.24): minimal contract interface for the coding extension
  * runtime. Extracted so `@kodax-ai/coding/src/types.ts` can reference the
@@ -798,7 +759,7 @@ interface KodaXRepoIntelligenceTrace {
  * (interactive REPL), and `acp_server`.
  *
  * Note: FEATURE_083 (v0.7.24) initially marked this as superseded by
- * `EvidenceSpan` in `@kodax-ai/tracing`. **FEATURE_086 (v0.7.27) re-evaluated
+ * `EvidenceSpan` in `@kodax-ai/agent`. **FEATURE_086 (v0.7.27) re-evaluated
  * and retained it**: `EvidenceSpanData` is a generic
  * `{ source, queryPreview?, resultCount?, cacheHit?, error? }` abstraction
  * that does not carry the repo-intelligence-specific `stage` enum,
@@ -1011,6 +972,17 @@ interface KodaXChildContextBundle {
      * lands separately.
      */
     modelHint?: KodaXChildModelHint;
+    /**
+     * FEATURE_191 — optional registered specialist agent name. When set,
+     * the child is dispatched with that agent's `instructions` /
+     * `tools` / `reasoning` / `guardrails` instead of the stock Worker
+     * bundle. Resolved via `resolveConstructedAgent(name)` at dispatch
+     * time; unknown names are rejected by `toolDispatchChildTask` with
+     * a tool-result error (not throw) before the bundle reaches
+     * `executeReadChild` / `executeWriteChild`. Optional — omitting
+     * preserves byte-identical v0.7.42 baseline dispatch behavior.
+     */
+    specialistName?: string;
 }
 /**
  * FEATURE_120 v0.7.39 Phase 4 — model tier hint. Tier semantics:
@@ -1469,7 +1441,6 @@ interface KodaXOrchestrationVerdict {
     signalReason?: string;
     signalDebugReason?: string;
     disposition?: 'complete' | 'blocked' | 'needs_continuation';
-    continuationSuggested?: boolean;
 }
 interface KodaXManagedTaskRuntimeState {
     amaProfile?: KodaXAmaProfile;
@@ -1491,24 +1462,6 @@ interface KodaXManagedTaskRuntimeState {
     currentHarness?: KodaXHarnessProfile;
     upgradeCeiling?: KodaXHarnessProfile;
     harnessTransitions?: KodaXManagedTaskHarnessTransition[];
-    scoutDecision?: {
-        summary: string;
-        recommendedHarness: KodaXHarnessProfile;
-        readyForUpgrade: boolean;
-        scope?: string[];
-        requiredEvidence?: string[];
-        reviewFilesOrAreas?: string[];
-        evidenceAcquisitionMode?: 'overview' | 'diff-bundle' | 'diff-slice' | 'file-read';
-        harnessRationale?: string;
-        blockingEvidence?: string[];
-        directCompletionReady?: 'yes' | 'no';
-        skillSummary?: string;
-        executionObligations?: string[];
-        verificationObligations?: string[];
-        ambiguities?: string[];
-        projectionConfidence?: KodaXSkillProjectionConfidence;
-    };
-    skillMap?: KodaXSkillMap;
     completionContractStatus?: Record<string, 'ready' | 'incomplete' | 'blocked' | 'missing'>;
     rawRoutingDecision?: KodaXTaskRoutingDecision;
     finalRoutingDecision?: KodaXTaskRoutingDecision;
@@ -1563,7 +1516,6 @@ interface KodaXManagedVerdictPayload {
     nextHarness?: KodaXTaskRoutingDecision['harnessProfile'];
     protocolParseFailed?: boolean;
     verificationDegraded?: boolean;
-    continuationSuggested?: boolean;
     preferredFallbackWorkerId?: string;
     /**
      * v0.7.26 Risk-3 fix — Evaluator explicit budget-extension request.
@@ -1576,72 +1528,19 @@ interface KodaXManagedVerdictPayload {
     budgetRequest?: string;
 }
 /**
- * Signals surfaced by the harness (not the LLM) when Scout's completion looks
- * suspicious. See runManagedScoutStage for the detection logic.
+ * Signals surfaced by the harness (not the LLM) when V1 Scout's completion
+ * looked suspicious.
+ *
+ * FEATURE_193 (v0.7.43) deep V1 cleanup: V1 Scout role is retired and the
+ * Runner-driven path no longer fires `onScoutSuspiciousCompletion`. The
+ * type is kept on the SDK surface so the `KodaXEvents.onScoutSuspiciousCompletion`
+ * callback signature continues to compile for pre-1.0 SDK consumers (e.g.
+ * the REPL renderers that still register a handler). New code MUST NOT
+ * emit this signal.
  */
 type KodaXScoutSuspiciousSignal = 'mutation-expected-but-none' | 'budget-exhausted' | 'no-formal-completion';
-interface KodaXManagedScoutPayload {
-    summary?: string;
-    scope: string[];
-    requiredEvidence: string[];
-    reviewFilesOrAreas?: string[];
-    evidenceAcquisitionMode?: 'overview' | 'diff-bundle' | 'diff-slice' | 'file-read';
-    confirmedHarness?: KodaXTaskRoutingDecision['harnessProfile'];
-    harnessRationale?: string;
-    blockingEvidence?: string[];
-    directCompletionReady?: 'yes' | 'no';
-    /**
-     * FEATURE_078 (v0.7.29): Scout's optional non-binding suggestion for
-     * the reasoning depth downstream workers (Planner / Generator /
-     * Evaluator) should use. Resolved by `resolveRoleReasoning(role,
-     * userCeiling, profile, scoutHint)` as the L3 input — clamped by L1
-     * (user ceiling) and L2 (agent profile max). Scout SHOULD set this
-     * sparingly: only when the scoped task signals atypically low
-     * complexity (`'quick'`) or atypically high stakes (`'deep'`); leave
-     * undefined for the default path so workers stick to their own
-     * `Agent.reasoning.default`.
-     */
-    downstreamReasoningHint?: KodaXReasoningMode;
-    userFacingText?: string;
-    skillMap?: {
-        skillSummary?: string;
-        executionObligations: string[];
-        verificationObligations: string[];
-        ambiguities: string[];
-        projectionConfidence?: KodaXSkillProjectionConfidence;
-    };
-    /**
-     * Harness-observed confidence in Scout's completion. 'confident' is the default
-     * (omitted). 'uncertain' means the harness detected signals that Scout may not
-     * have actually finished (e.g. mutation task with zero mutations, budget
-     * exhausted without explicit completion, tool calls followed by text-only exit
-     * without a completion statement).
-     *
-     * This field is set by the harness, not by the LLM — emit_managed_protocol
-     * payloads from models are ignored here and overwritten.
-     */
-    completionConfidence?: 'confident' | 'uncertain';
-    /** Which signals contributed to an 'uncertain' confidence verdict. */
-    suspiciousSignals?: KodaXScoutSuspiciousSignal[];
-}
-interface KodaXManagedContractPayload {
-    summary?: string;
-    successCriteria: string[];
-    requiredEvidence: string[];
-    constraints: string[];
-}
-interface KodaXManagedHandoffPayload {
-    status: 'ready' | 'incomplete' | 'blocked';
-    summary?: string;
-    evidence: string[];
-    followup: string[];
-    userFacingText: string;
-}
 interface KodaXManagedProtocolPayload {
     verdict?: KodaXManagedVerdictPayload;
-    scout?: KodaXManagedScoutPayload;
-    contract?: KodaXManagedContractPayload;
-    handoff?: KodaXManagedHandoffPayload;
 }
 interface KodaXResult {
     success: boolean;
@@ -2567,5 +2466,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, CONSECUTIVE_THRESHOLD as C, ERROR_THRESHOLD as E, getKodaxGlobalDir as a$, WINDOW_MS as aS, collectAllSignals as aT, computeRulesFingerprint as aU, createAutoModeToolGuardrail as aV, createBashPrefixExtractor as aW, createCircuitBreaker as aX, createDenialTracker as aY, extractCommandPrefix as aZ, formatAgentsForPrompt as a_, loadAgentsFiles as b0, loadAutoRules as b1, parseAutoRules as b2, readTrustState as b3, recordAllow as b4, recordBlock as b5, recordError as b6, shouldFallback$1 as b7, shouldFallback as b8, trustProjectRules as b9, CUMULATIVE_THRESHOLD as n };
-export type { KodaXOrchestrationVerdict as $, AgentsFile as A, DenialTracker as D, FailureStage as F, KodaXContextOptions as G, KodaXContextTokenSnapshot as H, KodaXEvents as I, KodaXFanoutBranchLifecycle as J, KodaXAgentMode as K, KodaXFanoutBranchRecord as L, KodaXFanoutBranchTransition as M, KodaXFanoutSchedulerInput as N, KodaXFanoutSchedulerPlan as O, KodaXInputArtifact as P, KodaXManagedBudgetSnapshot as Q, KodaXManagedProtocolPayload as R, KodaXManagedTask as S, KodaXManagedTaskRuntimeState as T, KodaXManagedTaskStatusEvent as U, KodaXMcpConnectMode as V, KodaXMcpServerConfig as W, KodaXMcpServersConfig as X, KodaXMcpTransport as Y, KodaXMemoryStrategy as Z, KodaXOptions as _, AskUserMultiOptions as a, KodaXParentReductionContract as a0, KodaXProviderPolicyHints as a1, KodaXRepoIntelligenceCapability as a2, KodaXRepoIntelligenceMode as a3, KodaXRepoIntelligenceResolvedMode as a4, KodaXRepoIntelligenceTrace as a5, KodaXRepoIntelligenceTraceEvent as a6, KodaXRepoRoutingSignals as a7, KodaXResult as a8, KodaXRoleRoundSummary as a9, ProviderRecoveryEvent as aA, ProviderResilienceConfig as aB, ProviderResiliencePolicy as aC, RecoveryAction as aD, RecoveryDecision as aE, RecoveryLadderStep as aF, RecoveryResult as aG, ResilienceClassification as aH, ResilienceErrorClass as aI, RulesLoadError as aJ, RulesLoadResult as aK, SignalCollector as aL, SkippedRulesSource as aM, TodoItem as aN, TodoList as aO, TodoStatus as aP, ToolCallSignal as aQ, TrustState as aR, KodaXRuntimeVerificationContract as aa, KodaXSessionControl as ab, KodaXSessionMutators as ac, KodaXSessionOptions as ad, KodaXSkillInvocationContext as ae, KodaXSkillMap as af, KodaXSkillProjectionConfidence as ag, KodaXTaskCapabilityHint as ah, KodaXTaskContract as ai, KodaXTaskEvidenceArtifact as aj, KodaXTaskEvidenceBundle as ak, KodaXTaskEvidenceEntry as al, KodaXTaskRole as am, KodaXTaskRoleAssignment as an, KodaXTaskStatus as ao, KodaXTaskSurface as ap, KodaXTaskToolPolicy as aq, KodaXTaskVerificationContract as ar, KodaXTaskVerificationCriterion as as, KodaXTaskWorkItem as at, KodaXToolExecutionContext as au, KodaXVerificationScorecard as av, KodaXVerificationScorecardCriterion as aw, LoadAgentsOptions as ax, LoadedRulesSource as ay, ProviderExecutionState as az, AskUserQuestionItem as b, AskUserQuestionOptions as c, AutoModeAskUser as d, AutoModeAskUserVerdict as e, AutoModeEngine as f, AutoModeGuardrailConfig as g, AutoModeSharedState as h, AutoModeStats as i, AutoModeToolGuardrail as j, AutoRules as k, BashPrefixExtractor as l, BashPrefixResult as m, CircuitBreaker as o, CompactionAnchor as p, CompactionDetails as q, CompactionResult as r, CompactionUpdate as s, CreateBashPrefixExtractorOptions as t, ExtensionRuntimeContract as u, ExtractCommandPrefixOptions as v, KodaXBudgetDisclosureZone as w, KodaXBudgetExtensionRequest as x, KodaXChildAgentResult as y, KodaXChildContextBundle as z };
+export { BASH_POLICY_SPEC as B, CONSECUTIVE_THRESHOLD as C, ERROR_THRESHOLD as E, readTrustState as a$, WINDOW_MS as aO, collectAllSignals as aP, computeRulesFingerprint as aQ, createAutoModeToolGuardrail as aR, createBashPrefixExtractor as aS, createCircuitBreaker as aT, createDenialTracker as aU, extractCommandPrefix as aV, formatAgentsForPrompt as aW, getKodaxGlobalDir as aX, loadAgentsFiles as aY, loadAutoRules as aZ, parseAutoRules as a_, recordAllow as b0, recordBlock as b1, recordError as b2, shouldFallback$1 as b3, shouldFallback as b4, trustProjectRules as b5, CUMULATIVE_THRESHOLD as n };
+export type { KodaXRepoIntelligenceMode as $, AgentsFile as A, DenialTracker as D, FailureStage as F, KodaXFanoutBranchRecord as G, KodaXFanoutBranchTransition as H, KodaXFanoutSchedulerInput as I, KodaXFanoutSchedulerPlan as J, KodaXAgentMode as K, KodaXInputArtifact as L, KodaXManagedBudgetSnapshot as M, KodaXManagedProtocolPayload as N, KodaXManagedTask as O, KodaXManagedTaskRuntimeState as P, KodaXManagedTaskStatusEvent as Q, KodaXMcpConnectMode as R, KodaXMcpServerConfig as S, KodaXMcpServersConfig as T, KodaXMcpTransport as U, KodaXMemoryStrategy as V, KodaXOptions as W, KodaXOrchestrationVerdict as X, KodaXParentReductionContract as Y, KodaXProviderPolicyHints as Z, KodaXRepoIntelligenceCapability as _, AskUserMultiOptions as a, KodaXRepoIntelligenceResolvedMode as a0, KodaXRepoIntelligenceTrace as a1, KodaXRepoIntelligenceTraceEvent as a2, KodaXRepoRoutingSignals as a3, KodaXResult as a4, KodaXRoleRoundSummary as a5, KodaXRuntimeVerificationContract as a6, KodaXSessionControl as a7, KodaXSessionMutators as a8, KodaXSessionOptions as a9, RecoveryDecision as aA, RecoveryLadderStep as aB, RecoveryResult as aC, ResilienceClassification as aD, ResilienceErrorClass as aE, RulesLoadError as aF, RulesLoadResult as aG, SignalCollector as aH, SkippedRulesSource as aI, TodoItem as aJ, TodoList as aK, TodoStatus as aL, ToolCallSignal as aM, TrustState as aN, KodaXSkillInvocationContext as aa, KodaXSkillMap as ab, KodaXSkillProjectionConfidence as ac, KodaXTaskCapabilityHint as ad, KodaXTaskContract as ae, KodaXTaskEvidenceArtifact as af, KodaXTaskEvidenceBundle as ag, KodaXTaskEvidenceEntry as ah, KodaXTaskRole as ai, KodaXTaskRoleAssignment as aj, KodaXTaskStatus as ak, KodaXTaskSurface as al, KodaXTaskToolPolicy as am, KodaXTaskVerificationContract as an, KodaXTaskVerificationCriterion as ao, KodaXTaskWorkItem as ap, KodaXToolExecutionContext as aq, KodaXVerificationScorecard as ar, KodaXVerificationScorecardCriterion as as, LoadAgentsOptions as at, LoadedRulesSource as au, ProviderExecutionState as av, ProviderRecoveryEvent as aw, ProviderResilienceConfig as ax, ProviderResiliencePolicy as ay, RecoveryAction as az, AskUserQuestionItem as b, AskUserQuestionOptions as c, AutoModeAskUser as d, AutoModeAskUserVerdict as e, AutoModeEngine as f, AutoModeGuardrailConfig as g, AutoModeSharedState as h, AutoModeStats as i, AutoModeToolGuardrail as j, AutoRules as k, BashPrefixExtractor as l, BashPrefixResult as m, CircuitBreaker as o, CreateBashPrefixExtractorOptions as p, ExtensionRuntimeContract as q, ExtractCommandPrefixOptions as r, KodaXBudgetDisclosureZone as s, KodaXBudgetExtensionRequest as t, KodaXChildAgentResult as u, KodaXChildContextBundle as v, KodaXContextOptions as w, KodaXContextTokenSnapshot as x, KodaXEvents as y, KodaXFanoutBranchLifecycle as z };

package/dist/types-chunks/cost-tracker.d-wRtyEW9d.d.ts

@@ -0,0 +1,110 @@
+/**
+ * KodaX Cost Rates - Multi-Provider pricing table
+ *
+ * 成本费率表 - 所有 Provider 的计费标准
+ * 支持 11 个内置 Provider 的成本追踪，用户可以覆盖默认费率
+ */
+interface CostRate {
+    readonly inputPer1M: number;
+    readonly outputPer1M: number;
+    readonly cachePer1M?: number;
+}
+declare const DEFAULT_COST_RATES: Readonly<Record<string, Readonly<Record<string, CostRate>>>>;
+declare function getCostRate(provider: string, model: string, userOverrides?: Readonly<Record<string, Readonly<Record<string, CostRate>>>>): CostRate | undefined;
+declare function calculateCost(rate: CostRate, inputTokens: number, outputTokens: number, cacheTokens?: number): number;
+
+/**
+ * KodaX Cost Tracker - Immutable session cost tracking
+ *
+ * 成本追踪器 - 不可变的会话成本追踪
+ * 使用 Immutable 模式，每次操作都返回新对象而不修改原有对象
+ */
+
+interface TokenUsageRecord {
+    readonly timestamp: number;
+    readonly provider: string;
+    readonly model: string;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly cost: number;
+    readonly role?: string;
+}
+interface ProviderCostSummary {
+    readonly cost: number;
+    readonly calls: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+}
+/**
+ * FEATURE_130 (v0.7.36) — per-retry record. Captures the wait the
+ * provider asked us to take so `/cost` can report "X retries, Ys total
+ * wait" alongside the token cost. Lives in the same tracker as token
+ * records to keep one source of truth for the session.
+ */
+interface RetryRecord {
+    readonly timestamp: number;
+    readonly provider: string;
+    readonly waitMs: number;
+    readonly reason: 'rate-limit' | 'overloaded';
+    readonly source: 'retry-after-seconds' | 'retry-after-date' | 'retry-after-ms' | 'exponential-backoff';
+}
+interface SessionCostSummary {
+    readonly totalCost: number;
+    readonly totalInputTokens: number;
+    readonly totalOutputTokens: number;
+    readonly totalCacheTokens: number;
+    /** FEATURE_116 (v0.7.37): cumulative cache-read input tokens across the
+     * session. Splits `totalCacheTokens` into the read half so the hit rate
+     * (`cacheHitRate = totalCacheReadTokens / totalCacheTokens`) is
+     * derivable for `/cost` reporting. */
+    readonly totalCacheReadTokens: number;
+    /** FEATURE_116 (v0.7.37): cumulative cache-write (creation) input tokens. */
+    readonly totalCacheWriteTokens: number;
+    /** FEATURE_116 (v0.7.37): cache-read share of all cache tokens this
+     * session, in [0, 1]. Computed as `totalCacheReadTokens /
+     * (totalCacheReadTokens + totalCacheWriteTokens)`. Returns 0 when no
+     * cache activity has been recorded — a session with zero cache
+     * activity is not "0% hit rate", just untracked. */
+    readonly cacheHitRate: number;
+    readonly callCount: number;
+    /** FEATURE_130: total retries triggered across the session. */
+    readonly retryCount: number;
+    /** FEATURE_130: cumulative milliseconds spent in retry-after sleeps. */
+    readonly retryWaitMs: number;
+    readonly byProvider: Readonly<Record<string, ProviderCostSummary>>;
+    readonly byRole: Readonly<Record<string, ProviderCostSummary>>;
+}
+interface CostTracker {
+    readonly records: readonly TokenUsageRecord[];
+    /** FEATURE_130 (v0.7.36): retry-wait records, append-only and immutable. */
+    readonly retries: readonly RetryRecord[];
+}
+declare function createCostTracker(): CostTracker;
+/**
+ * FEATURE_130 (v0.7.36): record a retry-after wait. The InkREPL spinner
+ * (or any other consumer of `KodaXEvents.onRetryAfter`) calls this so
+ * `/cost` can surface accurate session-wide retry telemetry.
+ */
+declare function recordRetry(tracker: CostTracker, entry: {
+    readonly provider: string;
+    readonly waitMs: number;
+    readonly reason: 'rate-limit' | 'overloaded';
+    readonly source: 'retry-after-seconds' | 'retry-after-date' | 'retry-after-ms' | 'exponential-backoff';
+}): CostTracker;
+declare function recordUsage(tracker: CostTracker, entry: {
+    readonly provider: string;
+    readonly model: string;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens?: number;
+    readonly cacheWriteTokens?: number;
+    readonly role?: string;
+}, userCostOverrides?: Readonly<Record<string, Readonly<Record<string, CostRate>>>>): CostTracker;
+declare function getSummary(tracker: CostTracker): SessionCostSummary;
+declare function formatCost(usd: number): string;
+declare function formatCostReport(summary: SessionCostSummary): string;
+
+export { DEFAULT_COST_RATES as D, createCostTracker as b, calculateCost as c, formatCostReport as d, getSummary as e, formatCost as f, getCostRate as g, recordUsage as h, recordRetry as r };
+export type { CostRate as C, ProviderCostSummary as P, RetryRecord as R, SessionCostSummary as S, TokenUsageRecord as T, CostTracker as a };