opencode-swarm 7.159.0 → 7.159.1

package/dist/observability/catalog.d.ts

@@ -1,7 +1,7 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 51 entries, matching the `TelemetryEvent` union at
+ * Exactly 54 entries, matching the `TelemetryEvent` union at
  * `src/telemetry.ts:15-131`. Thirty-eight predate the #2029 contract; the 39th is
  * `agent_conflict_detected` (previously emitted through a force-cast past the
  * type system), the 40th is `close_archive_result` (issue #2030 — the
@@ -22,7 +22,9 @@
  * the bounded `trajectory_health` storage audit for the issue-#2041
  * `.swarm/trajectories/` PRM session store, and the 51st is the bounded
  * `pr_subscription_health` storage audit for the issue-#2042
- * `.swarm/pr-monitor/` PR-monitor subscription checkpoint store. These late
+ * `.swarm/pr-monitor/` subscription checkpoint store. The 52nd is
+ * `delegation_cost_correction`, the 53rd is `delegation_cost_binding`, and the
+ * 54th is `delegation_cost_join`. These late
  * additions are instances
  * of the defect class this contract exists to close: an event kind entering
  * the stream with no registration.
@@ -78,7 +80,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 51 entries today, and that is a truthful statement about
+     * `false` for all 54 entries today, and that is a truthful statement about
      * the current system rather than a placeholder: no producer supplies a
      * parent span, so `createObservation` never sets one. Setting this to `true`
      * for a kind whose producer cannot supply a parent would make every

package/dist/review/contracts.d.ts

@@ -1,5 +1,6 @@
 import type { OpencodeClient } from '@opencode-ai/sdk';
 import { type EphemeralAgentDispatchResult } from '../evaluation/ephemeral-agent-dispatcher.js';
+import type { PricingConfig } from '../services/cost-accounting.js';
 import type { ModelOverride } from '../utils/model-dispatch-fallback.js';
 export type ReviewDispatchRequest = {
     directory: string;
@@ -26,4 +27,4 @@ export interface ReviewModelDispatcher {
  * The returned dispatcher is instance-local and safe to inject into hooks and
  * tools; it does not read or mutate module-level client state.
  */
-export declare function createReviewModelDispatcher(client: OpencodeClient): ReviewModelDispatcher;
+export declare function createReviewModelDispatcher(client: OpencodeClient, pricing?: PricingConfig): ReviewModelDispatcher;

package/dist/review/evidence.d.ts

@@ -1,7 +1,10 @@
+import * as fs from 'node:fs';
 import { type FindingValidation, type ReviewFinding } from '../agents/agent-output-schema.js';
 import type { Plan } from '../config/plan-schema.js';
 import type { AutoReviewConfig } from '../config/schema.js';
 import { type ReviewFindingSeverity, type ReviewReceipt } from '../hooks/review-receipt.js';
+import type { CostEvidence, CostEvidenceReason, CostEvidenceStatus } from '../services/cost-accounting.js';
+import { bunWrite } from '../utils/bun-compat.js';
 import type { ReviewDiffCompleteness, ReviewDiffManifest, ReviewDiffSelector } from './diff-source.js';
 export interface AutoReviewEvidenceFinding extends ReviewFinding {
     finding_id: string;
@@ -64,6 +67,10 @@ export interface AutoReviewEvidence {
         tokens_cache: number;
         cost_usd: number | null;
         cost_source: 'reported' | 'estimated' | 'unavailable';
+        /** Bounded per-dispatch provenance; scalar totals remain compatibility projections. */
+        cost_evidence: CostEvidence[];
+        evidence_status: CostEvidenceStatus;
+        evidence_reason?: CostEvidenceReason;
     };
 }
 export declare function computeAutoReviewManifestHash(manifest: Omit<AutoReviewScopeManifest, 'hash'>): string;
@@ -72,6 +79,11 @@ export interface PersistAutoReviewEvidenceOptions {
     /** Rebuild the exact reviewed scope immediately before the atomic rename. */
     verifyCurrent?: () => Promise<boolean>;
 }
+/** Dependency seam for failure-path tests; production defaults stay unchanged. */
+export declare const _internals: {
+    bunWrite: typeof bunWrite;
+    renameSync: typeof fs.renameSync;
+};
 export declare function persistAutoReviewEvidence(directory: string, evidence: AutoReviewEvidence, options?: PersistAutoReviewEvidenceOptions): Promise<string>;
 export declare function readAutoReviewEvidenceForPhase(directory: string, phase: number): AutoReviewEvidence | null;
 export declare function isAutoReviewEvidence(value: unknown): value is AutoReviewEvidence;

package/dist/services/cost-accounting.d.ts

@@ -1,4 +1,33 @@
 export type CostSource = 'reported' | 'estimated' | 'unavailable';
+export type CostEvidenceKind = 'provider_reported' | 'normalized_estimate';
+export type CostEvidenceStatus = 'complete' | 'inconclusive';
+export type CostCurrency = 'USD' | 'unknown' | (string & {});
+export type CostEvidenceReason = 'authoritative' | 'missing_cost' | 'invalid_number' | 'pricing_missing' | 'unsupported_currency' | 'conflict' | 'unbilled' | 'join_miss' | 'legacy' | 'unreadable' | 'partial';
+/** Fixed, non-provider-controlled paths accepted by the evidence adapter. */
+export type CostEvidenceSourcePath = 'assistant.cost' | 'step-finish.cost' | 'response.info.cost' | 'response.cost' | 'legacy.cost' | 'pricing.model';
+export type CostEvidence = {
+    kind: CostEvidenceKind;
+    amount_usd: number | null;
+    currency: CostCurrency;
+    source_path: CostEvidenceSourcePath;
+    reason: CostEvidenceReason;
+    usage: TokenUsage;
+    model?: string;
+    pricing_version?: string;
+    pricing_effective_at?: string;
+    billing_basis?: string;
+    /** A bounded canonical digest is useful to correction producers. */
+    digest?: string;
+};
+export type CostCandidate = {
+    kind: CostEvidenceKind;
+    amount: number | null;
+    currency: CostCurrency;
+    source_path: CostEvidenceSourcePath;
+    usage: TokenUsage;
+    model?: string;
+    reason?: CostEvidenceReason;
+};
 export type ModelPricing = {
     input_per_million: number;
     output_per_million: number;
@@ -7,6 +36,14 @@ export type ModelPricing = {
 };
 export type PricingConfig = {
     models?: Record<string, ModelPricing>;
+    /** Currency of normalized table rows. Defaults to USD for compatibility. */
+    currency?: string;
+    version?: string;
+    effective_at?: string;
+    billing_basis?: string;
+    /** Explicit provider declarations; reported currency is never inferred. */
+    reported_cost_currency?: Record<string, string>;
+    subscription_unbilled?: boolean;
 };
 export type TokenUsage = {
     tokens_input: number;
@@ -17,6 +54,15 @@ export type TokenUsage = {
 export type DelegationCostFields = TokenUsage & {
     cost_usd: number | null;
     cost_source: CostSource;
+    cost_evidence?: CostEvidence[];
+    evidence_status?: CostEvidenceStatus;
+    evidence_reason?: CostEvidenceReason;
+    record_id?: string;
+    identity_fingerprint?: string;
+    child_session_digest?: string;
+    parent_session_digest?: string;
+    version?: number;
+    currency?: CostCurrency;
     model?: string;
     gate?: string;
     retry_index?: number;
@@ -27,6 +73,7 @@ export type DelegationCostInput = {
     gate?: string;
     retry_index?: number;
     pricing?: PricingConfig;
+    reported_cost_currency?: string;
 };
 export type CostSummary = {
     total_cost_usd: number;
@@ -46,6 +93,16 @@ export type CostSummary = {
         delegations: number;
         cost_usd: number;
     }>;
+    total_legacy_usd: number;
+    conflict_count: number;
+    legacy_count: number;
+    join_miss_count: number;
+    telemetry_error_count: number;
+    accepted_corrections: number;
+    rejected_corrections: number;
+    duplicate_corrections: number;
+    evidence_status: CostEvidenceStatus;
+    currencies: string[];
 };
 export type CostSummaryRow = {
     name: string;
@@ -59,7 +116,50 @@ export type CostSummaryRow = {
 };
 export declare const BUNDLED_MODEL_PRICING: Record<string, ModelPricing>;
 export declare function buildDelegationCostFields(input?: DelegationCostInput): DelegationCostFields;
+/**
+ * Extract only the pinned SDK shapes. The old generic traversal was
+ * intentionally removed: a wrapper's default cost must not shadow a child
+ * AssistantMessage/StepFinishPart report.
+ */
+export declare function extractCostEvidence(raw: unknown, input?: Pick<DelegationCostInput, 'model' | 'pricing' | 'reported_cost_currency'>): CostEvidence[];
+export type CostProjection = {
+    cost_usd: number | null;
+    cost_source: CostSource;
+    evidence_status: CostEvidenceStatus;
+    reason: CostEvidenceReason;
+    currency: CostCurrency;
+};
+/** Project additive evidence to the legacy scalar fields. Unknown is never zero. */
+export declare function projectCostEvidence(evidence: readonly CostEvidence[]): CostProjection;
+export declare function isCostEvidenceComplete(evidence: readonly CostEvidence[] | undefined): boolean;
 export declare function summarizeTelemetryCosts(directory: string): CostSummary;
+export type CostFoldStats = {
+    conflict_count: number;
+    join_miss_count: number;
+    telemetry_error_count: number;
+    accepted_corrections: number;
+    rejected_corrections: number;
+    duplicate_corrections: number;
+};
+export type FoldedCostTelemetry = {
+    events: Record<string, unknown>[];
+    stats: CostFoldStats;
+    versions: Record<string, number>;
+};
+/**
+ * Fold append-only cost corrections into one effective delegation snapshot.
+ * Corrections are buffered and replayed in version order so telemetry arrival
+ * order cannot permanently discard a valid correction. Invalid/orphan
+ * corrections remain diagnostics and can never create a row.
+ */
+export declare function foldTelemetryEvents(events: readonly Record<string, unknown>[]): FoldedCostTelemetry;
+export declare function isCostUpgrade(current: readonly CostEvidence[], next: readonly CostEvidence[]): boolean;
 export declare function readTelemetryEvents(directory: string): Record<string, unknown>[];
+/**
+ * Bounded asynchronous telemetry reader for live recovery paths. The status
+ * service and offline summaries retain the atomic synchronous snapshot above;
+ * recovery must not block event delivery on a full-file synchronous read.
+ */
+export declare function readTelemetryEventsAsync(directory: string): Promise<Record<string, unknown>[]>;
 export declare function estimateCostUsd(usage: TokenUsage, model?: string, pricing?: PricingConfig): number | null;
 export declare function roundUsd(value: number): number;

package/dist/services/status-service.d.ts

@@ -4,6 +4,7 @@ import { loadFullAutoRunState } from '../full-auto/state';
 import { type RecentEscalation } from '../hooks/knowledge-escalator';
 import { getActiveFullAutoSessionID, hasActiveFullAuto, hasActiveLeanTurbo } from '../state';
 import { loadLeanTurboRunState } from '../turbo/lean/state';
+import { summarizeTelemetryCosts } from './cost-accounting.js';
 /**
  * Dependency-injection seam for status-service.
  * Allows tests to intercept Lean Turbo state queries without mock.module leakage.
@@ -14,6 +15,7 @@ export declare const _internals: {
     hasActiveFullAuto: typeof hasActiveFullAuto;
     getActiveFullAutoSessionID: typeof getActiveFullAutoSessionID;
     loadFullAutoRunState: typeof loadFullAutoRunState;
+    summarizeTelemetryCosts: typeof summarizeTelemetryCosts;
 };
 /**
  * Structured status data returned by the status service.
@@ -175,6 +177,16 @@ export interface StatusData {
      * stores surface as typed uncertainty, never partially-trusted counts.
      */
     backgroundWork?: BackgroundWorkStatus;
+    /** Issue #2043: compatibility total plus provenance completeness. */
+    costs?: {
+        totalCostUsd: number;
+        delegations: number;
+        unavailableDelegations: number;
+        evidenceStatus: 'complete' | 'inconclusive';
+        conflictCount: number;
+        joinMissCount: number;
+        telemetryErrorCount: number;
+    };
 }
 /** Issue #2104: opt-in background-work status snapshot for /swarm status. */
 export interface BackgroundWorkStatus {

package/dist/telemetry.d.ts

@@ -1,6 +1,6 @@
 import { createObservation, toLegacyTelemetryLine } from './observability/index.js';
 import type { DelegationCostFields } from './services/cost-accounting.js';
-export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'reviewer_gate_decision' | 'phase_changed' | 'budget_updated' | 'context_pruned' | 'model_fallback'
+export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'delegation_cost_correction' | 'delegation_cost_binding' | 'delegation_cost_join' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'reviewer_gate_decision' | 'phase_changed' | 'budget_updated' | 'context_pruned' | 'model_fallback'
 /**
  * Issue #2271 bug 4 — a configured agent model id was POSITIVELY confirmed
  * unresolvable against the live provider catalog (distinct from a runtime

package/opencode-swarm.schema.json

@@ -746,6 +746,46 @@
       "description": "Token/cost estimation fallback table. Provider-reported cost wins when present; entries only estimate from usage tokens when reports omit cost.",
       "type": "object",
       "properties": {
+        "currency": {
+          "default": "USD",
+          "type": "string",
+          "const": "USD"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "effective_at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "billing_basis": {
+          "type": "string",
+          "enum": [
+            "token",
+            "request",
+            "subscription"
+          ]
+        },
+        "reported_cost_currency": {
+          "default": {},
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "additionalProperties": {
+            "type": "string",
+            "const": "USD"
+          }
+        },
+        "subscription_unbilled": {
+          "default": false,
+          "type": "boolean"
+        },
         "models": {
           "default": {},
           "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.159.0",
+	"version": "7.159.1",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",