@autohq/cli 0.1.564 → 0.1.566

package/dist/agent-bridge.js

@@ -27222,13 +27222,23 @@ var RuntimeBridgeOutputLivenessEnvelopeSchema = external_exports.object({
   intervalMs: external_exports.number().int().positive(),
   createdAt: external_exports.string().datetime()
 });
+var RuntimeBridgeOutputUsageTurnEnvelopeSchema = external_exports.object({
+  type: external_exports.literal("runtime.usage_turn"),
+  sessionId: SessionIdSchema,
+  runtimeId: RuntimeIdSchema,
+  bridgeLeaseId: RuntimeBridgeLeaseIdSchema,
+  outputSeq: external_exports.number().int().positive(),
+  turnId: SessionCommandIdSchema.nullable(),
+  createdAt: external_exports.string().datetime()
+});
 var RuntimeBridgeOutputEnvelopeSchema = external_exports.union([
   RuntimeBridgeOutputEntryEnvelopeSchema,
   RuntimeBridgeOutputDeltaEnvelopeSchema,
   RuntimeBridgeOutputUiMessageChunkEnvelopeSchema,
   RuntimeBridgeOutputUiMessagePartEnvelopeSchema,
   RuntimeBridgeOutputUiMessageCompletedEnvelopeSchema,
-  RuntimeBridgeOutputLivenessEnvelopeSchema
+  RuntimeBridgeOutputLivenessEnvelopeSchema,
+  RuntimeBridgeOutputUsageTurnEnvelopeSchema
 ]);
 function isLiveOnlyRuntimeOutputEnvelope(envelope) {
   return envelope.type === "ui.message.chunk" || envelope.type === "conversation.delta";
@@ -30870,7 +30880,7 @@ Object.assign(lookup, {
 // package.json
 var package_default = {
   name: "@autohq/cli",
-  version: "0.1.564",
+  version: "0.1.566",
   license: "SEE LICENSE IN README.md",
   publishConfig: {
     access: "public"
@@ -38656,6 +38666,215 @@ var RuntimeRestartDiagnosticRecordSchema = external_exports.object({
   createdAt: external_exports.string().datetime()
 });
 
+// ../../packages/schemas/src/session-attribution-epochs.ts
+var ATTRIBUTION_GRADES = ["derived", "asserted"];
+var AttributionGradeSchema = external_exports.enum(ATTRIBUTION_GRADES);
+var AttributionRequesterSnapshotSchema = external_exports.object({
+  origin: RequesterRootOriginSchema,
+  userId: UserIdSchema.nullable()
+}).strict();
+var SessionAttributionEpochCreateSchema = external_exports.object({
+  organizationId: OrganizationIdSchema,
+  projectId: ProjectIdSchema.nullable(),
+  sessionId: SessionIdSchema2,
+  sourceCommandId: SessionCommandIdSchema2,
+  requesterKey: external_exports.string().trim().min(1),
+  requesterSnapshot: AttributionRequesterSnapshotSchema.nullable(),
+  attributionGrade: AttributionGradeSchema,
+  assertedByCommandId: SessionCommandIdSchema2.nullable(),
+  assertedBySessionId: SessionIdSchema2.nullable(),
+  assertedByAgentResourceId: external_exports.string().trim().min(1).nullable(),
+  fundingSource: ModelCredentialFundingSourceSchema.nullable(),
+  providerGrantId: ProviderGrantIdSchema.nullable(),
+  userModelSubscriptionId: UserSubscriptionCredentialIdSchema.nullable()
+}).strict();
+var SessionAttributionEpochRecordSchema = SessionAttributionEpochCreateSchema.extend({
+  id: SessionAttributionEpochIdSchema,
+  createdAt: external_exports.string().datetime()
+}).strict();
+
+// ../../packages/schemas/src/usage.ts
+var UsageHarnessSchema = external_exports.enum(AGENT_HARNESSES);
+var NonNegativeTokenCountSchema = external_exports.number().int().nonnegative();
+var NonNegativeUsdSchema2 = external_exports.number().nonnegative();
+var UsageEventSchema = external_exports.object({
+  // Tenant + lineage attribution. projectId is nullable because a resource can
+  // belong directly to an organization with no project.
+  organizationId: OrganizationIdSchema,
+  projectId: ProjectIdSchema.nullable(),
+  sessionId: SessionIdSchema2,
+  // Authoritative platform turn association. Null/absent is an explicit
+  // compatibility state for legacy writers and usage outside a model turn;
+  // readers must never infer it from timestamps or ledger order.
+  turnId: SessionCommandIdSchema2.nullable().optional(),
+  agentResourceId: external_exports.string().trim().min(1),
+  harness: UsageHarnessSchema,
+  // The concrete model id the call billed against (e.g. "claude-opus-4-8"),
+  // taken from the response rather than any selection layer — a single run can
+  // touch multiple models, so this is per-call, never per-run.
+  model: external_exports.string().trim().min(1),
+  inputTokens: NonNegativeTokenCountSchema,
+  outputTokens: NonNegativeTokenCountSchema,
+  cacheCreationTokens: NonNegativeTokenCountSchema,
+  cacheReadTokens: NonNegativeTokenCountSchema,
+  // The provider's own cost when it reports one, kept only for reconciliation.
+  // Nullable/absent because it can be 0 or missing — never the billing source.
+  providerCostUsd: NonNegativeUsdSchema2.nullable(),
+  // Platform-derived cost and the rate-card version it was derived under, so a
+  // later rate-card change never silently rewrites historical cost.
+  derivedCostUsd: NonNegativeUsdSchema2,
+  pricingVersion: external_exports.string().trim().min(1),
+  // What this call debits from the organization's credit balance, and the fee
+  // card it was derived under (see `./billing`). Required — a writer that
+  // forgets it would silently record unbilled usage, so there is no default.
+  billedCostUsd: NonNegativeUsdSchema2,
+  billingFeeVersion: external_exports.string().trim().min(1),
+  // Historical funding attribution for the model call. The provider grant id is
+  // denormalized and nullable for platform-funded usage, matching the ledger's
+  // no-FK audit-trail contract.
+  fundingSource: ModelCredentialFundingSourceSchema.default("platform"),
+  modelCredentialProviderGrantId: ProviderGrantIdSchema.nullable().default(null),
+  // Optional during the cross-chunk rollout: B1 defines the attribution field
+  // before B3 deploys its persistence column and D3 begins populating it.
+  modelCredentialUserSubscriptionId: UserSubscriptionCredentialIdSchema.nullable().optional(),
+  attributionEpochId: SessionAttributionEpochIdSchema.nullable().optional(),
+  requesterKey: external_exports.string().trim().min(1).nullable().optional(),
+  attributionGrade: AttributionGradeSchema.nullable().optional(),
+  occurredAt: external_exports.string().datetime()
+});
+var UsageEventRecordSchema = UsageEventSchema.extend({
+  id: external_exports.string().trim().min(1),
+  turnId: SessionCommandIdSchema2.nullable().default(null),
+  attributionEpochId: SessionAttributionEpochIdSchema.nullable().default(null),
+  requesterKey: external_exports.string().trim().min(1).nullable().default(null),
+  attributionGrade: AttributionGradeSchema.nullable().default(null),
+  // Set on append-only correction rows: this row replaces the pointed-at row's
+  // amounts, and ledger readers exclude any row another row supersedes.
+  supersedesUsageEventId: external_exports.string().trim().min(1).nullable().default(null),
+  createdAt: external_exports.string().datetime()
+});
+var UsageTotalsSchema = external_exports.object({
+  eventCount: NonNegativeTokenCountSchema,
+  inputTokens: NonNegativeTokenCountSchema,
+  outputTokens: NonNegativeTokenCountSchema,
+  cacheCreationTokens: NonNegativeTokenCountSchema,
+  cacheReadTokens: NonNegativeTokenCountSchema,
+  totalTokens: NonNegativeTokenCountSchema,
+  billedCostUsd: NonNegativeUsdSchema2
+});
+var SessionUsageModelSummarySchema = UsageTotalsSchema.extend({
+  model: external_exports.string().trim().min(1)
+});
+var UsageFundingSummarySchema = UsageTotalsSchema.extend({
+  fundingSource: ModelCredentialFundingSourceSchema,
+  coveredInferenceCostUsd: NonNegativeUsdSchema2
+});
+var SessionModelFundingStateSchema = external_exports.object({
+  fundingSource: ModelCredentialFundingSourceSchema,
+  provider: external_exports.string().trim().min(1),
+  // The subscription owner's display name for user_subscription funding, so
+  // the session header can say whose key is being used. Optional for old
+  // writers; null when the name cannot resolve.
+  ownerDisplayName: external_exports.string().trim().min(1).nullable().optional()
+});
+var SessionUsageCurrentAttributionSchema = external_exports.object({
+  requesterKey: external_exports.string().trim().min(1),
+  requesterDisplayName: external_exports.string().trim().min(1).nullable(),
+  attributionGrade: AttributionGradeSchema
+}).strip();
+var SessionUsageRequesterSummarySchema = external_exports.object({
+  requesterKey: external_exports.string().trim().min(1).nullable(),
+  requesterDisplayName: external_exports.string().trim().min(1).nullable(),
+  billedCostUsd: NonNegativeUsdSchema2,
+  attributionGrades: external_exports.array(AttributionGradeSchema)
+}).strip();
+var SessionUsageResponseSchema = external_exports.object({
+  sessionId: SessionIdSchema2,
+  totals: UsageTotalsSchema,
+  models: external_exports.array(SessionUsageModelSummarySchema),
+  byFundingSource: external_exports.array(UsageFundingSummarySchema),
+  byRequester: external_exports.array(SessionUsageRequesterSummarySchema).optional().default([]),
+  currentAttribution: SessionUsageCurrentAttributionSchema.nullable().optional().default(null),
+  funding: SessionModelFundingStateSchema.nullable(),
+  firstUsageAt: external_exports.string().datetime().nullable(),
+  lastUsageAt: external_exports.string().datetime().nullable()
+}).strip();
+var PROJECT_USAGE_RANGE_KEYS = ["7d", "30d"];
+var ProjectUsageRangeKeySchema = external_exports.enum(PROJECT_USAGE_RANGE_KEYS);
+var UtcDateSchema = external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/);
+var ProjectUsageTotalsSchema = UsageTotalsSchema.extend({
+  sessionCount: NonNegativeTokenCountSchema,
+  // Share of all tokens served from prompt-cache reads (0..1); 0 when the
+  // window has no tokens at all.
+  cacheReadShare: external_exports.number().min(0).max(1)
+});
+var ProjectUsageAgentSummarySchema = UsageTotalsSchema.extend({
+  agentResourceId: external_exports.string().trim().min(1),
+  // Resolved from the agent resource (archived agents included); null only
+  // when the agent row no longer exists at all — the ledger deliberately
+  // outlives its attribution targets.
+  agentName: external_exports.string().trim().min(1).nullable(),
+  sessionCount: NonNegativeTokenCountSchema
+});
+var ProjectUsageModelSummarySchema = UsageTotalsSchema.extend({
+  model: external_exports.string().trim().min(1)
+});
+var ProjectUsageSubscriptionSummarySchema = UsageTotalsSchema.extend({
+  userSubscriptionId: UserSubscriptionCredentialIdSchema.nullable(),
+  coveredInferenceCostUsd: NonNegativeUsdSchema2
+});
+var ProjectUsageSubscriptionSliceSchema = external_exports.object({
+  totals: UsageTotalsSchema.extend({
+    coveredInferenceCostUsd: NonNegativeUsdSchema2
+  }),
+  subscriptions: external_exports.array(ProjectUsageSubscriptionSummarySchema)
+});
+var ProjectUsageRequesterAttributionSchema = external_exports.object({
+  requesterKey: external_exports.string().trim().min(1).nullable(),
+  requesterDisplayName: external_exports.string().trim().min(1).nullable(),
+  attributionEpochIds: external_exports.array(SessionAttributionEpochIdSchema),
+  attributionGrades: external_exports.array(AttributionGradeSchema)
+});
+var ProjectUsageRequesterSummarySchema = UsageTotalsSchema.extend({
+  ...ProjectUsageRequesterAttributionSchema.shape,
+  sessionCount: NonNegativeTokenCountSchema
+});
+var ProjectUsageDayAgentSliceSchema = external_exports.object({
+  agentResourceId: external_exports.string().trim().min(1),
+  billedCostUsd: NonNegativeUsdSchema2
+});
+var ProjectUsageDayModelSliceSchema = external_exports.object({
+  model: external_exports.string().trim().min(1),
+  billedCostUsd: NonNegativeUsdSchema2
+});
+var ProjectUsageDayPointSchema = UsageTotalsSchema.extend({
+  date: UtcDateSchema,
+  byAgent: external_exports.array(ProjectUsageDayAgentSliceSchema),
+  byModel: external_exports.array(ProjectUsageDayModelSliceSchema)
+});
+var ProjectUsageResponseSchema = external_exports.object({
+  organizationId: OrganizationIdSchema,
+  projectId: ProjectIdSchema,
+  range: external_exports.object({
+    key: ProjectUsageRangeKeySchema,
+    since: external_exports.string().datetime(),
+    until: external_exports.string().datetime()
+  }),
+  totals: ProjectUsageTotalsSchema,
+  taskThroughput: external_exports.object({
+    created: external_exports.number().int().nonnegative(),
+    completed: external_exports.number().int().nonnegative(),
+    dropped: external_exports.number().int().nonnegative(),
+    costPerCompletedTaskUsd: NonNegativeUsdSchema2.nullable()
+  }).optional(),
+  byAgent: external_exports.array(ProjectUsageAgentSummarySchema),
+  byModel: external_exports.array(ProjectUsageModelSummarySchema),
+  byFundingSource: external_exports.array(UsageFundingSummarySchema),
+  subscriptionUsage: ProjectUsageSubscriptionSliceSchema,
+  byRequester: external_exports.array(ProjectUsageRequesterSummarySchema),
+  daily: external_exports.array(ProjectUsageDayPointSchema)
+});
+
 // ../../packages/schemas/src/session-introspection.ts
 var TruncatedValueSchema = external_exports.object({
   truncated: external_exports.literal(true),
@@ -38808,6 +39027,62 @@ var RunModelFallbackSchema = external_exports.object({
   activatedAt: external_exports.string().datetime().nullable(),
   fallbackModelId: external_exports.string().nullable()
 });
+var RUN_USAGE_BREAKDOWN_LIMIT = 8;
+var RUN_USAGE_TURN_LIMIT = 50;
+var RunUsageTotalsSchema = external_exports.object({
+  eventCount: external_exports.number().int().nonnegative(),
+  inputTokens: external_exports.number().int().nonnegative(),
+  outputTokens: external_exports.number().int().nonnegative(),
+  cacheCreationTokens: external_exports.number().int().nonnegative(),
+  cacheReadTokens: external_exports.number().int().nonnegative(),
+  /**
+   * Stored rate-card-derived model cost; never recomputed by this read.
+   * Omitted when the caller lacks `billing:read`.
+   */
+  derivedCostUsd: external_exports.number().nonnegative().optional(),
+  /**
+   * Sum of provider-reported costs only when every included event reported
+   * one; null for empty, legacy, or partially reported groups, and omitted
+   * when the caller lacks `billing:read`.
+   */
+  providerCostUsd: external_exports.number().nonnegative().nullable().optional()
+});
+var RunUsageHarnessModelSchema = RunUsageTotalsSchema.extend({
+  harness: UsageHarnessSchema,
+  model: external_exports.string().trim().min(1)
+});
+var RunUsageTurnSchema = RunUsageTotalsSchema.extend({
+  /** Immutable platform-issued session turn identity. */
+  turnId: SessionCommandIdSchema2,
+  /**
+   * Immutable turn creation time. The series is ordered oldest-to-newest by
+   * this field, then turnId, within the bounded most-recent window.
+   */
+  turnCreatedAt: external_exports.string().datetime()
+});
+var RunUsageSummarySchema = external_exports.object({
+  totals: RunUsageTotalsSchema,
+  /**
+   * Cache reads divided by prompt-side tokens: input + cache creation/write +
+   * cache read. Output tokens are excluded; value is null when the exposed
+   * denominator is zero.
+   */
+  cacheReadRatio: external_exports.object({
+    denominatorTokens: external_exports.number().int().nonnegative(),
+    value: external_exports.number().min(0).max(1).nullable()
+  }),
+  /** Highest derived-cost harness/model groups, in descending spend order. */
+  byHarnessModel: external_exports.array(RunUsageHarnessModelSchema).max(RUN_USAGE_BREAKDOWN_LIMIT),
+  breakdownTruncated: external_exports.boolean(),
+  /** Most recent authoritative turn aggregates, returned oldest-to-newest. */
+  byTurn: external_exports.array(RunUsageTurnSchema).max(RUN_USAGE_TURN_LIMIT),
+  turnBreakdownTruncated: external_exports.boolean(),
+  /**
+   * Current events with no authoritative turn id. These remain in session
+   * totals but are excluded from byTurn rather than guessed into a turn.
+   */
+  unassociated: RunUsageTotalsSchema
+});
 var RunSummarySchema = external_exports.object({
   session: external_exports.object({
     id: SessionIdSchema2,
@@ -38923,7 +39198,9 @@ var RunSummarySchema = external_exports.object({
     recent: external_exports.array(RunRuntimeRestartSchema)
   }),
   /** Latest same-provider model-fallback activation for the session, if any. */
-  modelFallback: RunModelFallbackSchema
+  modelFallback: RunModelFallbackSchema,
+  /** Current unsuperseded model usage for the session. */
+  usage: RunUsageSummarySchema
 });
 
 // ../../packages/schemas/src/session-turns.ts
@@ -39220,33 +39497,6 @@ var SessionCommandDebounceRevertInputSchema = external_exports.object({
 }).strip();
 var RealtimeRunCursorSchema = external_exports.string().regex(/^rt:(0|[1-9]\d*)$/);
 
-// ../../packages/schemas/src/session-attribution-epochs.ts
-var ATTRIBUTION_GRADES = ["derived", "asserted"];
-var AttributionGradeSchema = external_exports.enum(ATTRIBUTION_GRADES);
-var AttributionRequesterSnapshotSchema = external_exports.object({
-  origin: RequesterRootOriginSchema,
-  userId: UserIdSchema.nullable()
-}).strict();
-var SessionAttributionEpochCreateSchema = external_exports.object({
-  organizationId: OrganizationIdSchema,
-  projectId: ProjectIdSchema.nullable(),
-  sessionId: SessionIdSchema2,
-  sourceCommandId: SessionCommandIdSchema2,
-  requesterKey: external_exports.string().trim().min(1),
-  requesterSnapshot: AttributionRequesterSnapshotSchema.nullable(),
-  attributionGrade: AttributionGradeSchema,
-  assertedByCommandId: SessionCommandIdSchema2.nullable(),
-  assertedBySessionId: SessionIdSchema2.nullable(),
-  assertedByAgentResourceId: external_exports.string().trim().min(1).nullable(),
-  fundingSource: ModelCredentialFundingSourceSchema.nullable(),
-  providerGrantId: ProviderGrantIdSchema.nullable(),
-  userModelSubscriptionId: UserSubscriptionCredentialIdSchema.nullable()
-}).strict();
-var SessionAttributionEpochRecordSchema = SessionAttributionEpochCreateSchema.extend({
-  id: SessionAttributionEpochIdSchema,
-  createdAt: external_exports.string().datetime()
-}).strict();
-
 // ../../packages/schemas/src/spend-cap-runtime.ts
 var SpendCapOverrideStateSchema = external_exports.object({
   active: external_exports.boolean(),
@@ -39398,183 +39648,6 @@ var ResourceReconciliationScopeSchema = external_exports.object({
   projectId: external_exports.string().trim().min(1).nullable()
 }).strict();
 
-// ../../packages/schemas/src/usage.ts
-var UsageHarnessSchema = external_exports.enum(AGENT_HARNESSES);
-var NonNegativeTokenCountSchema = external_exports.number().int().nonnegative();
-var NonNegativeUsdSchema2 = external_exports.number().nonnegative();
-var UsageEventSchema = external_exports.object({
-  // Tenant + lineage attribution. projectId is nullable because a resource can
-  // belong directly to an organization with no project.
-  organizationId: OrganizationIdSchema,
-  projectId: ProjectIdSchema.nullable(),
-  sessionId: SessionIdSchema2,
-  agentResourceId: external_exports.string().trim().min(1),
-  harness: UsageHarnessSchema,
-  // The concrete model id the call billed against (e.g. "claude-opus-4-8"),
-  // taken from the response rather than any selection layer — a single run can
-  // touch multiple models, so this is per-call, never per-run.
-  model: external_exports.string().trim().min(1),
-  inputTokens: NonNegativeTokenCountSchema,
-  outputTokens: NonNegativeTokenCountSchema,
-  cacheCreationTokens: NonNegativeTokenCountSchema,
-  cacheReadTokens: NonNegativeTokenCountSchema,
-  // The provider's own cost when it reports one, kept only for reconciliation.
-  // Nullable/absent because it can be 0 or missing — never the billing source.
-  providerCostUsd: NonNegativeUsdSchema2.nullable(),
-  // Platform-derived cost and the rate-card version it was derived under, so a
-  // later rate-card change never silently rewrites historical cost.
-  derivedCostUsd: NonNegativeUsdSchema2,
-  pricingVersion: external_exports.string().trim().min(1),
-  // What this call debits from the organization's credit balance, and the fee
-  // card it was derived under (see `./billing`). Required — a writer that
-  // forgets it would silently record unbilled usage, so there is no default.
-  billedCostUsd: NonNegativeUsdSchema2,
-  billingFeeVersion: external_exports.string().trim().min(1),
-  // Historical funding attribution for the model call. The provider grant id is
-  // denormalized and nullable for platform-funded usage, matching the ledger's
-  // no-FK audit-trail contract.
-  fundingSource: ModelCredentialFundingSourceSchema.default("platform"),
-  modelCredentialProviderGrantId: ProviderGrantIdSchema.nullable().default(null),
-  // Optional during the cross-chunk rollout: B1 defines the attribution field
-  // before B3 deploys its persistence column and D3 begins populating it.
-  modelCredentialUserSubscriptionId: UserSubscriptionCredentialIdSchema.nullable().optional(),
-  attributionEpochId: SessionAttributionEpochIdSchema.nullable().optional(),
-  requesterKey: external_exports.string().trim().min(1).nullable().optional(),
-  attributionGrade: AttributionGradeSchema.nullable().optional(),
-  occurredAt: external_exports.string().datetime()
-});
-var UsageEventRecordSchema = UsageEventSchema.extend({
-  id: external_exports.string().trim().min(1),
-  attributionEpochId: SessionAttributionEpochIdSchema.nullable().default(null),
-  requesterKey: external_exports.string().trim().min(1).nullable().default(null),
-  attributionGrade: AttributionGradeSchema.nullable().default(null),
-  // Set on append-only correction rows: this row replaces the pointed-at row's
-  // amounts, and ledger readers exclude any row another row supersedes.
-  supersedesUsageEventId: external_exports.string().trim().min(1).nullable().default(null),
-  createdAt: external_exports.string().datetime()
-});
-var UsageTotalsSchema = external_exports.object({
-  eventCount: NonNegativeTokenCountSchema,
-  inputTokens: NonNegativeTokenCountSchema,
-  outputTokens: NonNegativeTokenCountSchema,
-  cacheCreationTokens: NonNegativeTokenCountSchema,
-  cacheReadTokens: NonNegativeTokenCountSchema,
-  totalTokens: NonNegativeTokenCountSchema,
-  billedCostUsd: NonNegativeUsdSchema2
-});
-var SessionUsageModelSummarySchema = UsageTotalsSchema.extend({
-  model: external_exports.string().trim().min(1)
-});
-var UsageFundingSummarySchema = UsageTotalsSchema.extend({
-  fundingSource: ModelCredentialFundingSourceSchema,
-  coveredInferenceCostUsd: NonNegativeUsdSchema2
-});
-var SessionModelFundingStateSchema = external_exports.object({
-  fundingSource: ModelCredentialFundingSourceSchema,
-  provider: external_exports.string().trim().min(1),
-  // The subscription owner's display name for user_subscription funding, so
-  // the session header can say whose key is being used. Optional for old
-  // writers; null when the name cannot resolve.
-  ownerDisplayName: external_exports.string().trim().min(1).nullable().optional()
-});
-var SessionUsageCurrentAttributionSchema = external_exports.object({
-  requesterKey: external_exports.string().trim().min(1),
-  requesterDisplayName: external_exports.string().trim().min(1).nullable(),
-  attributionGrade: AttributionGradeSchema
-}).strip();
-var SessionUsageRequesterSummarySchema = external_exports.object({
-  requesterKey: external_exports.string().trim().min(1).nullable(),
-  requesterDisplayName: external_exports.string().trim().min(1).nullable(),
-  billedCostUsd: NonNegativeUsdSchema2,
-  attributionGrades: external_exports.array(AttributionGradeSchema)
-}).strip();
-var SessionUsageResponseSchema = external_exports.object({
-  sessionId: SessionIdSchema2,
-  totals: UsageTotalsSchema,
-  models: external_exports.array(SessionUsageModelSummarySchema),
-  byFundingSource: external_exports.array(UsageFundingSummarySchema),
-  byRequester: external_exports.array(SessionUsageRequesterSummarySchema).optional().default([]),
-  currentAttribution: SessionUsageCurrentAttributionSchema.nullable().optional().default(null),
-  funding: SessionModelFundingStateSchema.nullable(),
-  firstUsageAt: external_exports.string().datetime().nullable(),
-  lastUsageAt: external_exports.string().datetime().nullable()
-}).strip();
-var PROJECT_USAGE_RANGE_KEYS = ["7d", "30d"];
-var ProjectUsageRangeKeySchema = external_exports.enum(PROJECT_USAGE_RANGE_KEYS);
-var UtcDateSchema = external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/);
-var ProjectUsageTotalsSchema = UsageTotalsSchema.extend({
-  sessionCount: NonNegativeTokenCountSchema,
-  // Share of all tokens served from prompt-cache reads (0..1); 0 when the
-  // window has no tokens at all.
-  cacheReadShare: external_exports.number().min(0).max(1)
-});
-var ProjectUsageAgentSummarySchema = UsageTotalsSchema.extend({
-  agentResourceId: external_exports.string().trim().min(1),
-  // Resolved from the agent resource (archived agents included); null only
-  // when the agent row no longer exists at all — the ledger deliberately
-  // outlives its attribution targets.
-  agentName: external_exports.string().trim().min(1).nullable(),
-  sessionCount: NonNegativeTokenCountSchema
-});
-var ProjectUsageModelSummarySchema = UsageTotalsSchema.extend({
-  model: external_exports.string().trim().min(1)
-});
-var ProjectUsageSubscriptionSummarySchema = UsageTotalsSchema.extend({
-  userSubscriptionId: UserSubscriptionCredentialIdSchema.nullable(),
-  coveredInferenceCostUsd: NonNegativeUsdSchema2
-});
-var ProjectUsageSubscriptionSliceSchema = external_exports.object({
-  totals: UsageTotalsSchema.extend({
-    coveredInferenceCostUsd: NonNegativeUsdSchema2
-  }),
-  subscriptions: external_exports.array(ProjectUsageSubscriptionSummarySchema)
-});
-var ProjectUsageRequesterAttributionSchema = external_exports.object({
-  requesterKey: external_exports.string().trim().min(1).nullable(),
-  requesterDisplayName: external_exports.string().trim().min(1).nullable(),
-  attributionEpochIds: external_exports.array(SessionAttributionEpochIdSchema),
-  attributionGrades: external_exports.array(AttributionGradeSchema)
-});
-var ProjectUsageRequesterSummarySchema = UsageTotalsSchema.extend({
-  ...ProjectUsageRequesterAttributionSchema.shape,
-  sessionCount: NonNegativeTokenCountSchema
-});
-var ProjectUsageDayAgentSliceSchema = external_exports.object({
-  agentResourceId: external_exports.string().trim().min(1),
-  billedCostUsd: NonNegativeUsdSchema2
-});
-var ProjectUsageDayModelSliceSchema = external_exports.object({
-  model: external_exports.string().trim().min(1),
-  billedCostUsd: NonNegativeUsdSchema2
-});
-var ProjectUsageDayPointSchema = UsageTotalsSchema.extend({
-  date: UtcDateSchema,
-  byAgent: external_exports.array(ProjectUsageDayAgentSliceSchema),
-  byModel: external_exports.array(ProjectUsageDayModelSliceSchema)
-});
-var ProjectUsageResponseSchema = external_exports.object({
-  organizationId: OrganizationIdSchema,
-  projectId: ProjectIdSchema,
-  range: external_exports.object({
-    key: ProjectUsageRangeKeySchema,
-    since: external_exports.string().datetime(),
-    until: external_exports.string().datetime()
-  }),
-  totals: ProjectUsageTotalsSchema,
-  taskThroughput: external_exports.object({
-    created: external_exports.number().int().nonnegative(),
-    completed: external_exports.number().int().nonnegative(),
-    dropped: external_exports.number().int().nonnegative(),
-    costPerCompletedTaskUsd: NonNegativeUsdSchema2.nullable()
-  }).optional(),
-  byAgent: external_exports.array(ProjectUsageAgentSummarySchema),
-  byModel: external_exports.array(ProjectUsageModelSummarySchema),
-  byFundingSource: external_exports.array(UsageFundingSummarySchema),
-  subscriptionUsage: ProjectUsageSubscriptionSliceSchema,
-  byRequester: external_exports.array(ProjectUsageRequesterSummarySchema),
-  daily: external_exports.array(ProjectUsageDayPointSchema)
-});
-
 // ../../packages/schemas/src/user-subscriptions.ts
 var ATTRIBUTION_COLD_BOUNDARY_IDLE_MS = 5 * 6e4;
 var USER_SUBSCRIPTION_PROVIDERS = ["openai"];
@@ -71868,6 +71941,9 @@ function replacePayloadWithMarker(envelope, originalBytes) {
           parts: [{ type: "text", text: text2, state: "done" }]
         }
       };
+    case "runtime.liveness":
+    case "runtime.usage_turn":
+      return envelope;
   }
 }
 
@@ -72300,6 +72376,23 @@ var AgentBridgeOutputBuffer = class {
     );
     await this.drainPendingOutputs();
   }
+  /**
+   * Publish and await the active immutable platform turn before model work.
+   * Unlike liveness, every transition is retained and replayed: skipping one
+   * could attribute a billed call to the preceding turn.
+   */
+  async emitUsageTurn(context, turnId) {
+    this.outputSeq += 1;
+    this.enqueueOutput(
+      buildUsageTurnOutputEnvelope({
+        context,
+        outputSeq: this.outputSeq,
+        turnId,
+        createdAt: now2()
+      })
+    );
+    await this.drainPendingOutputs({ failIfBlocked: true });
+  }
   async emitUiMessageChunk(context, projection) {
     await this.flushPendingDelta();
     await this.emitLiveUiMessageChunk(context, projection.chunk);
@@ -73080,6 +73173,18 @@ function buildLivenessOutputEnvelope(input) {
     createdAt: input.createdAt
   });
 }
+function buildUsageTurnOutputEnvelope(input) {
+  const { context } = input;
+  return RuntimeBridgeOutputEnvelopeSchema.parse({
+    type: "runtime.usage_turn",
+    sessionId: context.sessionId,
+    runtimeId: context.runtimeId,
+    bridgeLeaseId: context.bridgeLeaseId,
+    outputSeq: input.outputSeq,
+    turnId: input.turnId,
+    createdAt: input.createdAt
+  });
+}
 function buildUiMessagePartOutputEnvelope(input) {
   const { context, snapshot } = input;
   return RuntimeBridgeOutputEnvelopeSchema.parse({
@@ -74364,7 +74469,7 @@ var ClaudeAgentBridgeSessionImpl = class {
       return;
     }
     await this.awaitMcpRegistration();
-    this.enqueueUserMessage(message, commandIds);
+    await this.enqueueUserMessage(message, commandIds);
     this.input.runtimeLogger?.info("agent_bridge_claude_send_message_queued", {
       delivery_mode: mode,
       duration_ms: Date.now() - startedAt,
@@ -74470,6 +74575,7 @@ var ClaudeAgentBridgeSessionImpl = class {
     }
     this.openTurnCommandIds.length = 0;
     this.publishActiveTurnCommandIds();
+    void this.input.onUsageTurnChanged?.(null);
     this.stderr.flush();
     this.inputQueue.close();
     if (previousState.kind === "started") {
@@ -74563,6 +74669,7 @@ var ClaudeAgentBridgeSessionImpl = class {
               consumedCommandIds: this.openTurnCommandIds.shift() ?? []
             };
             this.publishActiveTurnCommandIds();
+            await this.input.onUsageTurnChanged?.(null);
             this.pendingToolUses.clear();
             this.interruptSettling = false;
             this.turnResultCount += 1;
@@ -74574,7 +74681,7 @@ var ClaudeAgentBridgeSessionImpl = class {
               consumed_command_ids: meta3.consumedCommandIds
             });
             if (this.activeTurnCount === 0) {
-              this.flushDeferredMessages();
+              await this.flushDeferredMessages();
             }
             if (this.deferredMessages.length === 0) {
               this.cancelledToolRuns = [];
@@ -74604,6 +74711,7 @@ var ClaudeAgentBridgeSessionImpl = class {
         this.activeTurnCount = 0;
         this.openTurnCommandIds.length = 0;
         this.publishActiveTurnCommandIds();
+        await this.input.onUsageTurnChanged?.(null);
         this.pendingToolUses.clear();
         this.interruptSettling = false;
         this.disarmToolBoundaryWait();
@@ -74616,7 +74724,8 @@ var ClaudeAgentBridgeSessionImpl = class {
   // lets injection work while the SDK session is still starting; the queue
   // drains once the query attaches. Startup failures surface through onError
   // instead of failing injection.
-  enqueueUserMessage(message, commandIds) {
+  async enqueueUserMessage(message, commandIds) {
+    await this.input.onUsageTurnChanged?.(commandIds[0] ?? null);
     this.inputQueue.push(claudeAgentUserMessage(message));
     this.activeTurnCount += 1;
     this.openTurnCommandIds.push(commandIds);
@@ -74724,7 +74833,7 @@ var ClaudeAgentBridgeSessionImpl = class {
     clearTimeout(this.toolBoundaryWait.timer);
     this.toolBoundaryWait = null;
   }
-  flushDeferredMessages() {
+  async flushDeferredMessages() {
     if (this.deferredMessages.length === 0) {
       return;
     }
@@ -74735,7 +74844,7 @@ var ClaudeAgentBridgeSessionImpl = class {
       `agent_bridge_claude_deferred_flush count=${pending.length} cancelled_tool_count=${cancelledToolRuns.length}`
     );
     const text2 = pending.map((entry) => entry.text).join("\n\n");
-    this.enqueueUserMessage(
+    await this.enqueueUserMessage(
       cancelledToolRuns.length > 0 ? `${text2}
 
 ${cancelledToolPlatformNotice(cancelledToolRuns)}` : text2,
@@ -75652,6 +75761,13 @@ var ClaudeCodeCommandHandler = class {
       RUNTIME_LIVENESS_INTERVAL_MS
     );
   }
+  async emitUsageTurn(turnId) {
+    const activeContext = this.context;
+    if (!activeContext) {
+      throw new Error("Cannot publish usage turn without bridge context");
+    }
+    await this.outputBuffer.emitUsageTurn(activeContext, turnId);
+  }
   async emitBridgeOutput(activeContext, projection) {
     try {
       await this.outputBuffer.emitProjection(activeContext, projection);
@@ -75819,6 +75935,7 @@ var ClaudeCodeCommandHandler = class {
         }
       },
       onActiveTurnCommandIds: (commandIds) => this.autoMcpShim.setActiveTurnCommandIds(commandIds),
+      onUsageTurnChanged: (turnId) => this.emitUsageTurn(turnId),
       canUseTool: this.canUseTool,
       onMessage: (message, meta3) => this.handleAgentMessage(message, meta3),
       onError: (error51) => this.handleAgentError(error51),
@@ -77027,6 +77144,7 @@ var CodexAgentBridgeSessionImpl = class {
     this.pendingCommandIds = [...commandIds];
     this.publishActiveTurnCommandIds(commandIds);
     try {
+      await this.input.onUsageTurnChanged?.(commandIds[0] ?? null);
       await this.request("turn/start", {
         threadId,
         input: [userTextInput(message)]
@@ -77034,6 +77152,7 @@ var CodexAgentBridgeSessionImpl = class {
     } catch (error51) {
       this.pendingCommandIds = [];
       this.publishActiveTurnCommandIds();
+      await this.input.onUsageTurnChanged?.(null);
       throw error51;
     }
   }
@@ -77041,6 +77160,7 @@ var CodexAgentBridgeSessionImpl = class {
     this.pendingCommandIds = [...commandIds];
     this.publishActiveTurnCommandIds(commandIds);
     try {
+      await this.input.onUsageTurnChanged?.(commandIds[0] ?? null);
       await this.request("turn/start", {
         threadId,
         input: []
@@ -77048,6 +77168,7 @@ var CodexAgentBridgeSessionImpl = class {
     } catch (error51) {
       this.pendingCommandIds = [];
       this.publishActiveTurnCommandIds();
+      await this.input.onUsageTurnChanged?.(null);
       throw error51;
     }
   }
@@ -77411,6 +77532,7 @@ var CodexAgentBridgeSessionImpl = class {
       this.activeTurnId = null;
       this.activeCommandIds = [];
       this.publishActiveTurnCommandIds();
+      void this.input.onUsageTurnChanged?.(null);
     }
     this.pendingToolItemIds.clear();
     this.resolveSettlement();
@@ -77426,6 +77548,7 @@ var CodexAgentBridgeSessionImpl = class {
     this.activeCommandIds = [];
     this.pendingCommandIds = [];
     this.publishActiveTurnCommandIds();
+    void this.input.onUsageTurnChanged?.(null);
     this.pendingToolItemIds.clear();
     this.resolveSettlement();
     this.input.writeOutput?.(`agent_bridge_codex_exited code=${code ?? ""}`);
@@ -77821,6 +77944,13 @@ var CodexCommandHandler = class {
       RUNTIME_LIVENESS_INTERVAL_MS
     );
   }
+  async emitUsageTurn(turnId) {
+    const activeContext = this.context;
+    if (!activeContext) {
+      throw new Error("Cannot publish usage turn without bridge context");
+    }
+    await this.outputBuffer.emitUsageTurn(activeContext, turnId);
+  }
   async emit(activeContext, projection) {
     try {
       await this.outputBuffer.emitProjection(activeContext, projection);
@@ -77843,6 +77973,7 @@ var CodexCommandHandler = class {
       onServerRequest: (request) => this.handleServerRequest(request),
       onThreadId: (threadId) => this.persistThreadId(threadId),
       onActiveTurnCommandIds: (commandIds) => this.autoMcpShim.setActiveTurnCommandIds(commandIds),
+      onUsageTurnChanged: (turnId) => this.emitUsageTurn(turnId),
       onError: (error51) => this.handleSessionError(error51),
       onExit: () => {
         if (this.session === session) {