@autohq/cli 0.1.564 → 0.1.565

package/dist/agent-bridge.js

@@ -30870,7 +30870,7 @@ Object.assign(lookup, {
 // package.json
 var package_default = {
   name: "@autohq/cli",
-  version: "0.1.564",
+  version: "0.1.565",
   license: "SEE LICENSE IN README.md",
   publishConfig: {
     access: "public"
@@ -38656,6 +38656,210 @@ 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,
+  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/session-introspection.ts
 var TruncatedValueSchema = external_exports.object({
   truncated: external_exports.literal(true),
@@ -38808,6 +39012,44 @@ var RunModelFallbackSchema = external_exports.object({
   activatedAt: external_exports.string().datetime().nullable(),
   fallbackModelId: external_exports.string().nullable()
 });
+var RUN_USAGE_BREAKDOWN_LIMIT = 8;
+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 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()
+});
 var RunSummarySchema = external_exports.object({
   session: external_exports.object({
     id: SessionIdSchema2,
@@ -38923,7 +39165,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 +39464,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 +39615,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"];

package/dist/index.js

@@ -23003,8 +23003,234 @@ var init_runtime_restart_diagnostics = __esm({
   }
 });
 
+// ../../packages/schemas/src/session-attribution-epochs.ts
+var ATTRIBUTION_GRADES, AttributionGradeSchema, AttributionRequesterSnapshotSchema, SessionAttributionEpochCreateSchema, SessionAttributionEpochRecordSchema;
+var init_session_attribution_epochs = __esm({
+  "../../packages/schemas/src/session-attribution-epochs.ts"() {
+    "use strict";
+    init_zod();
+    init_ids();
+    init_model_credential_funding();
+    init_requester();
+    ATTRIBUTION_GRADES = ["derived", "asserted"];
+    AttributionGradeSchema = external_exports.enum(ATTRIBUTION_GRADES);
+    AttributionRequesterSnapshotSchema = external_exports.object({
+      origin: RequesterRootOriginSchema,
+      userId: UserIdSchema.nullable()
+    }).strict();
+    SessionAttributionEpochCreateSchema = external_exports.object({
+      organizationId: OrganizationIdSchema,
+      projectId: ProjectIdSchema.nullable(),
+      sessionId: SessionIdSchema,
+      sourceCommandId: SessionCommandIdSchema,
+      requesterKey: external_exports.string().trim().min(1),
+      requesterSnapshot: AttributionRequesterSnapshotSchema.nullable(),
+      attributionGrade: AttributionGradeSchema,
+      assertedByCommandId: SessionCommandIdSchema.nullable(),
+      assertedBySessionId: SessionIdSchema.nullable(),
+      assertedByAgentResourceId: external_exports.string().trim().min(1).nullable(),
+      fundingSource: ModelCredentialFundingSourceSchema.nullable(),
+      providerGrantId: ProviderGrantIdSchema.nullable(),
+      userModelSubscriptionId: UserSubscriptionCredentialIdSchema.nullable()
+    }).strict();
+    SessionAttributionEpochRecordSchema = SessionAttributionEpochCreateSchema.extend({
+      id: SessionAttributionEpochIdSchema,
+      createdAt: external_exports.string().datetime()
+    }).strict();
+  }
+});
+
+// ../../packages/schemas/src/usage.ts
+var UsageHarnessSchema, NonNegativeTokenCountSchema, NonNegativeUsdSchema2, UsageEventSchema, UsageEventRecordSchema, UsageTotalsSchema, SessionUsageModelSummarySchema, UsageFundingSummarySchema, SessionModelFundingStateSchema, SessionUsageCurrentAttributionSchema, SessionUsageRequesterSummarySchema, SessionUsageResponseSchema, PROJECT_USAGE_RANGE_KEYS, ProjectUsageRangeKeySchema, UtcDateSchema, ProjectUsageTotalsSchema, ProjectUsageAgentSummarySchema, ProjectUsageModelSummarySchema, ProjectUsageSubscriptionSummarySchema, ProjectUsageSubscriptionSliceSchema, ProjectUsageRequesterAttributionSchema, ProjectUsageRequesterSummarySchema, ProjectUsageDayAgentSliceSchema, ProjectUsageDayModelSliceSchema, ProjectUsageDayPointSchema, ProjectUsageResponseSchema;
+var init_usage = __esm({
+  "../../packages/schemas/src/usage.ts"() {
+    "use strict";
+    init_zod();
+    init_agents();
+    init_ids();
+    init_model_credential_funding();
+    init_session_attribution_epochs();
+    init_model_credential_funding();
+    UsageHarnessSchema = external_exports.enum(AGENT_HARNESSES);
+    NonNegativeTokenCountSchema = external_exports.number().int().nonnegative();
+    NonNegativeUsdSchema2 = external_exports.number().nonnegative();
+    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: SessionIdSchema,
+      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()
+    });
+    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()
+    });
+    UsageTotalsSchema = external_exports.object({
+      eventCount: NonNegativeTokenCountSchema,
+      inputTokens: NonNegativeTokenCountSchema,
+      outputTokens: NonNegativeTokenCountSchema,
+      cacheCreationTokens: NonNegativeTokenCountSchema,
+      cacheReadTokens: NonNegativeTokenCountSchema,
+      totalTokens: NonNegativeTokenCountSchema,
+      billedCostUsd: NonNegativeUsdSchema2
+    });
+    SessionUsageModelSummarySchema = UsageTotalsSchema.extend({
+      model: external_exports.string().trim().min(1)
+    });
+    UsageFundingSummarySchema = UsageTotalsSchema.extend({
+      fundingSource: ModelCredentialFundingSourceSchema,
+      coveredInferenceCostUsd: NonNegativeUsdSchema2
+    });
+    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()
+    });
+    SessionUsageCurrentAttributionSchema = external_exports.object({
+      requesterKey: external_exports.string().trim().min(1),
+      requesterDisplayName: external_exports.string().trim().min(1).nullable(),
+      attributionGrade: AttributionGradeSchema
+    }).strip();
+    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();
+    SessionUsageResponseSchema = external_exports.object({
+      sessionId: SessionIdSchema,
+      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();
+    PROJECT_USAGE_RANGE_KEYS = ["7d", "30d"];
+    ProjectUsageRangeKeySchema = external_exports.enum(PROJECT_USAGE_RANGE_KEYS);
+    UtcDateSchema = external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/);
+    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)
+    });
+    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
+    });
+    ProjectUsageModelSummarySchema = UsageTotalsSchema.extend({
+      model: external_exports.string().trim().min(1)
+    });
+    ProjectUsageSubscriptionSummarySchema = UsageTotalsSchema.extend({
+      userSubscriptionId: UserSubscriptionCredentialIdSchema.nullable(),
+      coveredInferenceCostUsd: NonNegativeUsdSchema2
+    });
+    ProjectUsageSubscriptionSliceSchema = external_exports.object({
+      totals: UsageTotalsSchema.extend({
+        coveredInferenceCostUsd: NonNegativeUsdSchema2
+      }),
+      subscriptions: external_exports.array(ProjectUsageSubscriptionSummarySchema)
+    });
+    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)
+    });
+    ProjectUsageRequesterSummarySchema = UsageTotalsSchema.extend({
+      ...ProjectUsageRequesterAttributionSchema.shape,
+      sessionCount: NonNegativeTokenCountSchema
+    });
+    ProjectUsageDayAgentSliceSchema = external_exports.object({
+      agentResourceId: external_exports.string().trim().min(1),
+      billedCostUsd: NonNegativeUsdSchema2
+    });
+    ProjectUsageDayModelSliceSchema = external_exports.object({
+      model: external_exports.string().trim().min(1),
+      billedCostUsd: NonNegativeUsdSchema2
+    });
+    ProjectUsageDayPointSchema = UsageTotalsSchema.extend({
+      date: UtcDateSchema,
+      byAgent: external_exports.array(ProjectUsageDayAgentSliceSchema),
+      byModel: external_exports.array(ProjectUsageDayModelSliceSchema)
+    });
+    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, RunConversationSearchSnippetSchema, RunConversationSearchMatchSchema, RunConversationSearchResponseSchema, SessionToolExchangeSchema, SessionToolExchangesResponseSchema, SESSION_TRIGGER_DELIVERY_ACTIONS, SessionTriggerDeliveryActionSchema, SESSION_EVENT_ORIGIN_KINDS, SessionEventOriginKindSchema, SessionTriggerDeliveryRecordSchema, SessionTriggersResponseSchema, RunBindingRecordSchema, RunBindingsResponseSchema, RunTurnSchema, SessionToolStatSchema, RunRuntimeRestartSchema, RunModelFallbackSchema, RunSummarySchema;
+var TruncatedValueSchema, RunConversationSearchSnippetSchema, RunConversationSearchMatchSchema, RunConversationSearchResponseSchema, SessionToolExchangeSchema, SessionToolExchangesResponseSchema, SESSION_TRIGGER_DELIVERY_ACTIONS, SessionTriggerDeliveryActionSchema, SESSION_EVENT_ORIGIN_KINDS, SessionEventOriginKindSchema, SessionTriggerDeliveryRecordSchema, SessionTriggersResponseSchema, RunBindingRecordSchema, RunBindingsResponseSchema, RunTurnSchema, SessionToolStatSchema, RunRuntimeRestartSchema, RunModelFallbackSchema, RUN_USAGE_BREAKDOWN_LIMIT, RunUsageTotalsSchema, RunUsageHarnessModelSchema, RunUsageSummarySchema, RunSummarySchema;
 var init_session_introspection = __esm({
   "../../packages/schemas/src/session-introspection.ts"() {
     "use strict";
@@ -23017,6 +23243,7 @@ var init_session_introspection = __esm({
     init_runtime_restart_diagnostics();
     init_session_bindings();
     init_sessions();
+    init_usage();
     init_work_provenance();
     TruncatedValueSchema = external_exports.object({
       truncated: external_exports.literal(true),
@@ -23169,6 +23396,44 @@ var init_session_introspection = __esm({
       activatedAt: external_exports.string().datetime().nullable(),
       fallbackModelId: external_exports.string().nullable()
     });
+    RUN_USAGE_BREAKDOWN_LIMIT = 8;
+    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()
+    });
+    RunUsageHarnessModelSchema = RunUsageTotalsSchema.extend({
+      harness: UsageHarnessSchema,
+      model: external_exports.string().trim().min(1)
+    });
+    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()
+    });
     RunSummarySchema = external_exports.object({
       session: external_exports.object({
         id: SessionIdSchema,
@@ -23284,7 +23549,9 @@ var init_session_introspection = __esm({
         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
     });
   }
 });
@@ -23630,43 +23897,6 @@ var init_runtimes = __esm({
   }
 });
 
-// ../../packages/schemas/src/session-attribution-epochs.ts
-var ATTRIBUTION_GRADES, AttributionGradeSchema, AttributionRequesterSnapshotSchema, SessionAttributionEpochCreateSchema, SessionAttributionEpochRecordSchema;
-var init_session_attribution_epochs = __esm({
-  "../../packages/schemas/src/session-attribution-epochs.ts"() {
-    "use strict";
-    init_zod();
-    init_ids();
-    init_model_credential_funding();
-    init_requester();
-    ATTRIBUTION_GRADES = ["derived", "asserted"];
-    AttributionGradeSchema = external_exports.enum(ATTRIBUTION_GRADES);
-    AttributionRequesterSnapshotSchema = external_exports.object({
-      origin: RequesterRootOriginSchema,
-      userId: UserIdSchema.nullable()
-    }).strict();
-    SessionAttributionEpochCreateSchema = external_exports.object({
-      organizationId: OrganizationIdSchema,
-      projectId: ProjectIdSchema.nullable(),
-      sessionId: SessionIdSchema,
-      sourceCommandId: SessionCommandIdSchema,
-      requesterKey: external_exports.string().trim().min(1),
-      requesterSnapshot: AttributionRequesterSnapshotSchema.nullable(),
-      attributionGrade: AttributionGradeSchema,
-      assertedByCommandId: SessionCommandIdSchema.nullable(),
-      assertedBySessionId: SessionIdSchema.nullable(),
-      assertedByAgentResourceId: external_exports.string().trim().min(1).nullable(),
-      fundingSource: ModelCredentialFundingSourceSchema.nullable(),
-      providerGrantId: ProviderGrantIdSchema.nullable(),
-      userModelSubscriptionId: UserSubscriptionCredentialIdSchema.nullable()
-    }).strict();
-    SessionAttributionEpochRecordSchema = SessionAttributionEpochCreateSchema.extend({
-      id: SessionAttributionEpochIdSchema,
-      createdAt: external_exports.string().datetime()
-    }).strict();
-  }
-});
-
 // ../../packages/schemas/src/spend-cap-runtime.ts
 var SpendCapOverrideStateSchema, SpendCapOverrideUpdateRequestSchema, SPEND_CAP_LIMIT_KINDS, SpendCapLimitKindSchema, EffectiveSpendCapHitSchema, SessionSpendCapRuntimeStatusSchema, AgentSpendCapRuntimeStatusSchema, SessionCreationSpendCapDecisionSchema, SPEND_CAP_RUNTIME_ERROR_CODES, SpendCapRuntimeErrorResponseSchema;
 var init_spend_cap_runtime = __esm({
@@ -81718,195 +81948,6 @@ var init_temporal = __esm({
   }
 });
 
-// ../../packages/schemas/src/usage.ts
-var UsageHarnessSchema, NonNegativeTokenCountSchema, NonNegativeUsdSchema2, UsageEventSchema, UsageEventRecordSchema, UsageTotalsSchema, SessionUsageModelSummarySchema, UsageFundingSummarySchema, SessionModelFundingStateSchema, SessionUsageCurrentAttributionSchema, SessionUsageRequesterSummarySchema, SessionUsageResponseSchema, PROJECT_USAGE_RANGE_KEYS, ProjectUsageRangeKeySchema, UtcDateSchema, ProjectUsageTotalsSchema, ProjectUsageAgentSummarySchema, ProjectUsageModelSummarySchema, ProjectUsageSubscriptionSummarySchema, ProjectUsageSubscriptionSliceSchema, ProjectUsageRequesterAttributionSchema, ProjectUsageRequesterSummarySchema, ProjectUsageDayAgentSliceSchema, ProjectUsageDayModelSliceSchema, ProjectUsageDayPointSchema, ProjectUsageResponseSchema;
-var init_usage = __esm({
-  "../../packages/schemas/src/usage.ts"() {
-    "use strict";
-    init_zod();
-    init_agents();
-    init_ids();
-    init_model_credential_funding();
-    init_session_attribution_epochs();
-    init_model_credential_funding();
-    UsageHarnessSchema = external_exports.enum(AGENT_HARNESSES);
-    NonNegativeTokenCountSchema = external_exports.number().int().nonnegative();
-    NonNegativeUsdSchema2 = external_exports.number().nonnegative();
-    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: SessionIdSchema,
-      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()
-    });
-    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()
-    });
-    UsageTotalsSchema = external_exports.object({
-      eventCount: NonNegativeTokenCountSchema,
-      inputTokens: NonNegativeTokenCountSchema,
-      outputTokens: NonNegativeTokenCountSchema,
-      cacheCreationTokens: NonNegativeTokenCountSchema,
-      cacheReadTokens: NonNegativeTokenCountSchema,
-      totalTokens: NonNegativeTokenCountSchema,
-      billedCostUsd: NonNegativeUsdSchema2
-    });
-    SessionUsageModelSummarySchema = UsageTotalsSchema.extend({
-      model: external_exports.string().trim().min(1)
-    });
-    UsageFundingSummarySchema = UsageTotalsSchema.extend({
-      fundingSource: ModelCredentialFundingSourceSchema,
-      coveredInferenceCostUsd: NonNegativeUsdSchema2
-    });
-    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()
-    });
-    SessionUsageCurrentAttributionSchema = external_exports.object({
-      requesterKey: external_exports.string().trim().min(1),
-      requesterDisplayName: external_exports.string().trim().min(1).nullable(),
-      attributionGrade: AttributionGradeSchema
-    }).strip();
-    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();
-    SessionUsageResponseSchema = external_exports.object({
-      sessionId: SessionIdSchema,
-      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();
-    PROJECT_USAGE_RANGE_KEYS = ["7d", "30d"];
-    ProjectUsageRangeKeySchema = external_exports.enum(PROJECT_USAGE_RANGE_KEYS);
-    UtcDateSchema = external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/);
-    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)
-    });
-    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
-    });
-    ProjectUsageModelSummarySchema = UsageTotalsSchema.extend({
-      model: external_exports.string().trim().min(1)
-    });
-    ProjectUsageSubscriptionSummarySchema = UsageTotalsSchema.extend({
-      userSubscriptionId: UserSubscriptionCredentialIdSchema.nullable(),
-      coveredInferenceCostUsd: NonNegativeUsdSchema2
-    });
-    ProjectUsageSubscriptionSliceSchema = external_exports.object({
-      totals: UsageTotalsSchema.extend({
-        coveredInferenceCostUsd: NonNegativeUsdSchema2
-      }),
-      subscriptions: external_exports.array(ProjectUsageSubscriptionSummarySchema)
-    });
-    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)
-    });
-    ProjectUsageRequesterSummarySchema = UsageTotalsSchema.extend({
-      ...ProjectUsageRequesterAttributionSchema.shape,
-      sessionCount: NonNegativeTokenCountSchema
-    });
-    ProjectUsageDayAgentSliceSchema = external_exports.object({
-      agentResourceId: external_exports.string().trim().min(1),
-      billedCostUsd: NonNegativeUsdSchema2
-    });
-    ProjectUsageDayModelSliceSchema = external_exports.object({
-      model: external_exports.string().trim().min(1),
-      billedCostUsd: NonNegativeUsdSchema2
-    });
-    ProjectUsageDayPointSchema = UsageTotalsSchema.extend({
-      date: UtcDateSchema,
-      byAgent: external_exports.array(ProjectUsageDayAgentSliceSchema),
-      byModel: external_exports.array(ProjectUsageDayModelSliceSchema)
-    });
-    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, USER_SUBSCRIPTION_PROVIDERS, UserSubscriptionProviderSchema, USER_SUBSCRIPTION_CREDENTIAL_STATUSES, UserSubscriptionCredentialStatusSchema, OpenAiUserSubscriptionCredentialSecretSchema, UserSubscriptionCredentialSchema, USER_SUBSCRIPTION_POLICY_MODES, UserSubscriptionPolicyModeSchema, USER_SUBSCRIPTION_POLICY_ORIGINS, UserSubscriptionPolicyOriginSchema, UserSubscriptionPolicySchema, UserSubscriptionFundingCandidateSchema, UserSubscriptionFundingDecisionInputSchema, USER_SUBSCRIPTION_REJECTION_REASONS, UserSubscriptionRejectionReasonSchema, USER_SUBSCRIPTION_SELECTION_REASONS, UserSubscriptionSelectionReasonSchema, UserSubscriptionFundingDecisionSchema;
 var init_user_subscriptions = __esm({
@@ -84895,7 +84936,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@autohq/cli",
-      version: "0.1.564",
+      version: "0.1.565",
       license: "SEE LICENSE IN README.md",
       publishConfig: {
         access: "public"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autohq/cli",
-  "version": "0.1.564",
+  "version": "0.1.565",
   "license": "SEE LICENSE IN README.md",
   "publishConfig": {
     "access": "public"