@vibesdotdev/account 1.0.0-rc.4 → 1.0.0-rc.5

package/dist/billing/overage/overage-policy.js

@@ -0,0 +1,93 @@
+/**
+ * Overage policy — what happens to running work when a billing subject's
+ * credits reach zero.
+ *
+ * Three behaviors:
+ *   - `continue-invoice`  — keep running and invoice the overage.
+ *   - `pause`             — pause immediately.
+ *   - `continue-internal` — keep running, never invoice, and record the
+ *                           overage for system visibility.
+ *
+ * The declared defaults live in the `billing.overage` config manifest
+ * (`overage-policy.config.descriptor.ts`) and resolve through the runtime
+ * like any other setting; this module is the schema they parse against, never
+ * a second copy of the values. Account Web resolves a subject's behavior
+ * (`POST /api/billing/overage/resolve`): an explicit override for the user in
+ * the org, then the role in the org, then the org, then the class default,
+ * then `userDefault` for usage with no org. Callers never hard-code one.
+ */
+import * as z from 'zod/v4';
+export const OVERAGE_POLICY_MANIFEST_ID = 'billing.overage';
+export const OverageBehaviorSchema = z.enum(['continue-invoice', 'pause', 'continue-internal']);
+/**
+ * The org class a default is keyed by. `enterprise` is an org whose
+ * subscription tier is `accountType: enterprise`; `standard` is every other
+ * individual or team org; `internal` is the org a system admin marks as
+ * Vibes-internal.
+ */
+export const OverageOrgClassSchema = z.enum(['enterprise', 'standard', 'internal']);
+/** Who may set an org's overage behavior. */
+export const OverageSetterRoleSchema = z.enum(['owner', 'admin']);
+/**
+ * The behaviors the Vibes internal org may run under. Drew, 2026-10-29: the
+ * internal org "keeps moving" — it is never paused for credits, so `pause` is
+ * not a value its default can hold, and Account never resolves it to `pause`
+ * from an override either.
+ */
+export const InternalOverageBehaviorSchema = OverageBehaviorSchema.exclude(['pause']);
+/** Per-class defaults (Drew, 2026-10-29). */
+export const OverageClassDefaultsSchema = z.strictObject({
+    enterprise: OverageBehaviorSchema.default('continue-invoice'),
+    standard: OverageBehaviorSchema.default('pause'),
+    internal: InternalOverageBehaviorSchema.default('continue-internal')
+});
+/**
+ * Whether a `standard` org may opt in to `continue-invoice`, and on what
+ * terms. The terms are the lane D review's (2026-10-29): a payment method on
+ * file and an owner or admin making the choice. `allowed` defaults to true and
+ * is policy, so it can be changed without code.
+ */
+export const StandardContinueInvoicePolicySchema = z.strictObject({
+    allowed: z.boolean().default(true),
+    requiresPaymentMethod: z.boolean().default(true),
+    setterRoles: z.array(OverageSetterRoleSchema).min(1).default(['owner', 'admin'])
+});
+export const OveragePolicySchema = z.strictObject({
+    defaults: OverageClassDefaultsSchema.default(() => OverageClassDefaultsSchema.parse({})),
+    /** Usage billed to a user with no org. */
+    userDefault: OverageBehaviorSchema.default('pause'),
+    standardContinueInvoice: StandardContinueInvoicePolicySchema.default(() => StandardContinueInvoicePolicySchema.parse({}))
+});
+/** Where a resolved behavior came from, most specific first. */
+export const OverageBehaviorSourceSchema = z.enum([
+    'user-override',
+    'role-override',
+    'org-override',
+    'class-default',
+    'user-default'
+]);
+/** A resolved overage behavior and where it came from. */
+export const OverageResolutionSchema = z.object({
+    behavior: OverageBehaviorSchema,
+    source: OverageBehaviorSourceSchema
+});
+/**
+ * Whether an org of `orgClass` may choose `behavior`, set by `setterRole`.
+ * Only `continue-invoice` on a `standard` org is conditioned here; the
+ * owner/admin-edit rule for every other choice belongs to the override
+ * route's own authorization.
+ */
+export function overageChoiceRefusal(policy, choice) {
+    if (choice.orgClass !== 'standard' || choice.behavior !== 'continue-invoice')
+        return null;
+    const terms = policy.standardContinueInvoice;
+    if (!terms.allowed)
+        return 'standard-continue-invoice-disallowed';
+    if (terms.requiresPaymentMethod && !choice.hasPaymentMethod)
+        return 'payment-method-required';
+    if (choice.setterRole === 'member' || !terms.setterRoles.includes(choice.setterRole)) {
+        return 'setter-role-not-permitted';
+    }
+    return null;
+}
+//# sourceMappingURL=overage-policy.js.map

package/dist/billing/overage/overage-policy.js.map

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

package/dist/billing/usage/delivery.d.ts

@@ -7,6 +7,7 @@
 import type { Logger } from '@vibesdotdev/logging';
 import { type Settled, type ValueFreeFailure } from '@vibesdotdev/kernel';
 import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import { type OverageBehavior, type OverageBehaviorSource } from '../overage/overage-policy.ts';
 /** Metadata a usage event carries to Account Web: JSON values; an undefined entry is dropped when serialized. */
 export type BillingEventMetadata = Record<string, JsonValue | undefined>;
 /** How a delivery failed: a non-2xx status, the deadline, or a thrown failure described value-free. */
@@ -20,7 +21,10 @@ export type DeliveryFailure = {
     error: ValueFreeFailure;
 };
 /** The failure a settled delivery ended with, or null when Account Web accepted it. */
-export declare function deliveryFailure(delivered: Settled<Response>): DeliveryFailure | null;
+export declare function deliveryFailure(delivered: Settled<{
+    readonly ok: boolean;
+    readonly status: number;
+}>): DeliveryFailure | null;
 /** The journal message for a failed delivery: the status, the deadline, or the failure class, never response text. */
 export declare function deliveryFailureMessage(failure: DeliveryFailure, timeoutMs: number): string;
 /**
@@ -31,4 +35,95 @@ export declare function deliveryFailureMessage(failure: DeliveryFailure, timeout
 export declare function keepAlive<Platform>(logger: Pick<Logger, 'error'>, label: string, platform: Platform, promise: Promise<void>): void;
 /** Run a caller's journal callback; a throw or rejection is logged by failure class, never raised into the emitter. */
 export declare function notifyJournal(logger: Pick<Logger, 'warn'>, label: string, callback: (() => Promise<void> | void) | undefined): Promise<void>;
+/**
+ * What Account Web did with a delivered usage record, as
+ * `/api/billing/usage/record-internal` reports it in its 200 body.
+ *
+ * Delivery and deduction are separate facts. The usage row is written before
+ * the credit deduction, so a record that could not be paid for is still
+ * DELIVERED: the journal marks it delivered and the reconciler must not retry
+ * it (a retry would write a second usage row). The deduction outcome is what
+ * tells a caller the charge was not collected.
+ *
+ *   - `charged`    — the rated charge was deducted in full.
+ *   - `shortfall`  — the pools could not cover the charge; `charged` is what
+ *                    was deducted and `shortfallUsd` the uncollected
+ *                    cost-basis USD (rating value of the credits not paid).
+ *                    It carries the subject's overage behavior (see
+ *                    {@link UsageRecordOverage}) so a caller can enforce it.
+ *   - `unrecorded` — Account Web accepted the request but recorded no charge
+ *                    for a reason other than balance (unknown feature, a
+ *                    failed insert).
+ *   - `unreported` — the body did not carry the outcome (an Account Web that
+ *                    predates it, or an unreadable body). Never read as paid.
+ */
+export type UsageRecordOutcome = {
+    readonly status: 'charged';
+    readonly charged: number;
+} | ({
+    readonly status: 'shortfall';
+    readonly charged: number;
+    readonly shortfallUsd: number;
+} & UsageRecordOverage) | {
+    readonly status: 'unrecorded';
+    readonly error: string;
+} | {
+    readonly status: 'unreported';
+};
+/**
+ * The overage facts a shortfall carries, as record-internal reports them
+ * (lane D step 3): the subject's resolved overage behavior, the layer that
+ * decided it, and the overage record written for the shortfall.
+ *
+ * Each is null when the answering Account Web did not report it (one that
+ * predates the field) or reported a value this client cannot read. A null
+ * behavior is never read as any behavior: an enforcer acts only on an
+ * explicit `pause`.
+ */
+export interface UsageRecordOverage {
+    readonly behavior: OverageBehavior | null;
+    readonly behaviorSource: OverageBehaviorSource | null;
+    /** The `billing_overage_records` row; null when none was written or reported. */
+    readonly overageRecordId: string | null;
+}
+/** Read the deduction outcome from a record-internal 200 body. */
+export declare function usageRecordOutcome(body: JsonValue): UsageRecordOutcome;
+/** A settled record-internal response: its status, and on a 2xx the outcome its body reported. */
+export interface UsageRecordDelivery {
+    readonly ok: boolean;
+    readonly status: number;
+    readonly outcome: UsageRecordOutcome | null;
+}
+/**
+ * Read a record-internal response, body included. Call it inside the same
+ * lifecycle deadline as the fetch, so a stalled body is a timeout rather than
+ * a read that outlives the emitter's budget.
+ */
+export declare function readUsageRecordDelivery(response: Response): Promise<UsageRecordDelivery>;
+/**
+ * How one fire-and-forget usage emission ended: skipped before sending, not
+ * delivered, or delivered with the deduction outcome Account Web reported.
+ * Every record-internal emitter reports through this one shape, so a caller
+ * reads a shortfall the same way whichever emitter it used.
+ */
+export type UsageEmissionOutcome = {
+    readonly delivery: 'skipped';
+    readonly message: string;
+} | {
+    readonly delivery: 'failed';
+    readonly failure: DeliveryFailure;
+} | {
+    readonly delivery: 'delivered';
+    readonly outcome: UsageRecordOutcome;
+};
+/** A settled record-internal call: not delivered (and why), or delivered with its deduction outcome. */
+export type UsageRecordSettlement = {
+    readonly delivered: false;
+    readonly failure: DeliveryFailure;
+} | {
+    readonly delivered: true;
+    readonly outcome: UsageRecordOutcome;
+};
+/** Classify a settled {@link readUsageRecordDelivery}; a 2xx without a readable outcome is `unreported`. */
+export declare function usageRecordSettlement(settled: Settled<UsageRecordDelivery>): UsageRecordSettlement;
 //# sourceMappingURL=delivery.d.ts.map

package/dist/billing/usage/delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/delivery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAuC,KAAK,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,iHAAiH;AACjH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAEzE,uGAAuG;AACvG,MAAM,MAAM,eAAe,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEhD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,eAAe,GAAG,IAAI,CAIpF;AAED,sHAAsH;AACtH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI1F;AAaD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EACjC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GACpB,IAAI,CASN;AAED,uHAAuH;AACvH,wBAAsB,aAAa,CAClC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,GAChD,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/delivery.ts"],"names":[],"mappings":"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"}

package/dist/billing/usage/delivery.js

@@ -7,6 +7,7 @@
 import * as z from 'zod/v4';
 import { settle, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
 import { isWaitTimeout } from "./wait-timeout.js";
+import { OverageBehaviorSchema, OverageBehaviorSourceSchema } from "../overage/overage-policy.js";
 /** The failure a settled delivery ended with, or null when Account Web accepted it. */
 export function deliveryFailure(delivered) {
     if (delivered.ok)
@@ -58,4 +59,58 @@ export async function notifyJournal(logger, label, callback) {
         error: valueFreeFailure(settled.cause)
     });
 }
+/** The fields of the record-internal 200 body the outcome is read from. */
+const recordInternalOutcomeBodySchema = z.object({
+    success: z.boolean(),
+    charged: z.number().nonnegative(),
+    shortfallUsd: z.number().nonnegative(),
+    error: z.string().optional(),
+    behavior: OverageBehaviorSchema.nullable().optional().catch(null),
+    behaviorSource: OverageBehaviorSourceSchema.nullable().optional().catch(null),
+    overageRecordId: z.string().min(1).nullable().optional().catch(null)
+});
+/** Read the deduction outcome from a record-internal 200 body. */
+export function usageRecordOutcome(body) {
+    const parsed = recordInternalOutcomeBodySchema.safeParse(body);
+    if (!parsed.success)
+        return { status: 'unreported' };
+    const { success, charged, shortfallUsd, error } = parsed.data;
+    if (shortfallUsd > 0) {
+        return {
+            status: 'shortfall',
+            charged,
+            shortfallUsd,
+            behavior: parsed.data.behavior ?? null,
+            behaviorSource: parsed.data.behaviorSource ?? null,
+            overageRecordId: parsed.data.overageRecordId ?? null
+        };
+    }
+    if (!success)
+        return { status: 'unrecorded', error: error ?? 'not recorded' };
+    return { status: 'charged', charged };
+}
+const jsonBodySchema = z.json();
+/**
+ * Read a record-internal response, body included. Call it inside the same
+ * lifecycle deadline as the fetch, so a stalled body is a timeout rather than
+ * a read that outlives the emitter's budget.
+ */
+export async function readUsageRecordDelivery(response) {
+    if (!response.ok)
+        return { ok: false, status: response.status, outcome: null };
+    const body = await settle(async () => jsonBodySchema.parse(await response.json()));
+    return {
+        ok: true,
+        status: response.status,
+        outcome: body.ok ? usageRecordOutcome(body.value) : { status: 'unreported' }
+    };
+}
+/** Classify a settled {@link readUsageRecordDelivery}; a 2xx without a readable outcome is `unreported`. */
+export function usageRecordSettlement(settled) {
+    const failure = deliveryFailure(settled);
+    if (failure)
+        return { delivered: false, failure };
+    const outcome = settled.ok ? settled.value.outcome : null;
+    return { delivered: true, outcome: outcome ?? { status: 'unreported' } };
+}
 //# sourceMappingURL=delivery.js.map

package/dist/billing/usage/delivery.js.map

@@ -1 +1 @@
-{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../src/billing/usage/delivery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAuC,MAAM,qBAAqB,CAAC;AAE/G,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWlD,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,SAA4B;IAC3D,IAAI,SAAS,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACxG,IAAI,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,sBAAsB,CAAC,OAAwB,EAAE,SAAiB;IACjF,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,SAAS,IAAI,CAAC;IAClE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjG,CAAC;AAKD,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAEpH;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAmB,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAE9H;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACxB,MAA6B,EAC7B,KAAa,EACb,QAAkB,EAClB,OAAsB;IAEtB,MAAM,OAAO,GAAG,sBAAsB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO;IAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO;IACpB,MAAM,CAAC,KAAK,CAAC,8CAA8C,EAAE;QAC5D,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;AACJ,CAAC;AAED,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAA4B,EAC5B,KAAa,EACb,QAAkD;IAElD,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,EAAE;QAAE,OAAO;IACvB,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE;QAC5C,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC;KACtC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../src/billing/usage/delivery.ts"],"names":[],"mappings":"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"}

package/dist/billing/usage/record-code-session-usage.d.ts

@@ -26,8 +26,8 @@
 import type { RuntimeRef } from '@vibesdotdev/kernel';
 import type { CostBasis } from '../rating/schemas/cost-basis.ts';
 import type { HardwarePath } from '../rating/schemas/rated-usage.ts';
-import { type PlatformResourceReason } from './record-platform-resource.ts';
-import type { BillingEventMetadata } from './delivery.ts';
+import { type PlatformResourceOutcome, type PlatformResourceReason } from './record-platform-resource.ts';
+import { type BillingEventMetadata } from './delivery.ts';
 /** The metadata this emitter's input accepts: JSON values, undefined entries dropped. */
 export type { BillingEventMetadata };
 export interface RecordCodeSessionUsageInput {
@@ -80,6 +80,13 @@ export interface RecordCodeSessionUsageInput {
             message: string;
         }) => Promise<void> | void;
     };
+    /**
+     * Receives how the emission ended, deduction outcome included (see
+     * `record-platform-resource`). A `shortfall` carries the owner's overage
+     * behavior, which the code-session meter enforces. Always called once: a
+     * zero-compute emission sends nothing and reports `skipped`.
+     */
+    onOutcome?: (outcome: PlatformResourceOutcome) => Promise<void> | void;
 }
 /**
  * Fire-and-forget rated emission for code-session compute. Consumer / local

package/dist/billing/usage/record-code-session-usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-code-session-usage.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/record-code-session-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,yFAAyF;AACzF,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAQrC,MAAM,WAAW,2BAA2B;IAC3C,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,6FAA6F;IAC7F,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,4EAA4E;IAC5E,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YAC9C,OAAO,EAAE,MAAM,CAAC;SAChB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC3B,CAAC;CACF;AAYD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAuCpG"}
+{"version":3,"file":"record-code-session-usage.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/record-code-session-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAEN,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEzE,yFAAyF;AACzF,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAQrC,MAAM,WAAW,2BAA2B;IAC3C,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,6FAA6F;IAC7F,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,4EAA4E;IAC5E,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YAC9C,OAAO,EAAE,MAAM,CAAC;SAChB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvE;AAYD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,2BAA2B,GAAG,IAAI,CA2CpG"}

package/dist/billing/usage/record-code-session-usage.js

@@ -27,6 +27,7 @@ import { getLogger } from '@vibesdotdev/logging';
 import { FEATURE_SLUGS } from "../schemas/core/feature-slugs.js";
 import { codeSessionComputeCostBasis } from "./build-session-cost-basis.js";
 import { recordPlatformResource } from "./record-platform-resource.js";
+import { notifyJournal } from "./delivery.js";
 function log(runtime) {
     return getLogger('account', runtime).child({ context: 'record-code-session-usage' });
 }
@@ -52,6 +53,7 @@ export function recordCodeSessionUsage(runtime, input) {
             sessionId: input.sessionId,
             reason: input.reason
         });
+        void notifyJournal(log(runtime), 'recordCodeSessionUsage', () => input.onOutcome?.({ delivery: 'skipped', message: 'zero-compute' }));
         return;
     }
     const hardware = input.hardware ?? 'cloud';
@@ -79,7 +81,8 @@ export function recordCodeSessionUsage(runtime, input) {
             computeSeconds,
             ...input.metadata
         },
-        journal: input.journal
+        journal: input.journal,
+        onOutcome: input.onOutcome
     });
 }
 //# sourceMappingURL=record-code-session-usage.js.map

package/dist/billing/usage/record-code-session-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-code-session-usage.js","sourceRoot":"","sources":["../../../src/billing/usage/record-code-session-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIjD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EACN,sBAAsB,EAEtB,MAAM,+BAA+B,CAAC;AAMvC,SAAS,GAAG,CAAC,OAAmB;IAC/B,OAAO,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAsD9B,SAAS,qBAAqB,CAAC,KAAkC;IAChE,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QACjF,OAAO,KAAK,CAAC,cAAc,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC,OAAO,GAAG,kBAAkB,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAmB,EAAE,KAAkC;IAC7F,MAAM,cAAc,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,gDAAgD,EAAE;YACpE,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO;IACR,CAAC;IAED,MAAM,QAAQ,GAAiB,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC;IACzD,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,+DAA+D;IAC/D,MAAM,SAAS,GACd,KAAK,CAAC,SAAS,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAE1F,sBAAsB,CAAC,OAAO,EAAE;QAC/B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,aAAa,CAAC,wBAAwB,CAAC;QACpD,OAAO,EAAE,oBAAoB;QAC7B,UAAU,EAAE,KAAK,CAAC,SAAS;QAC3B,aAAa,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE;QACjD,SAAS;QACT,QAAQ;QACR,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE;YACT,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;YACxC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,cAAc;YACd,GAAG,KAAK,CAAC,QAAQ;SACjB;QACD,OAAO,EAAE,KAAK,CAAC,OAAO;KACtB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"record-code-session-usage.js","sourceRoot":"","sources":["../../../src/billing/usage/record-code-session-usage.ts"],"names":[],"mappings":"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"}

package/dist/billing/usage/record-platform-resource.d.ts

@@ -19,13 +19,18 @@
  *   - Returns `void`; failures log structured context.
  *   - Honors the same journal callback contract as
  *     `record-sandbox-uptime` so app-local audit tables stay consistent.
+ *   - A delivered record that could not be paid for is NOT success: the
+ *     caller's `onOutcome` receives `shortfall` with the uncollected
+ *     cost-basis USD, exactly as `record-sandbox-uptime` reports it.
  */
 import { type RuntimeRef } from '@vibesdotdev/kernel';
-import { type BillingEventMetadata } from './delivery.ts';
+import { type BillingEventMetadata, type UsageEmissionOutcome, type UsageRecordOutcome } from './delivery.ts';
 import type { CostBasis } from '../rating/schemas/cost-basis.ts';
 import type { HardwarePath, MeasuredUnits } from '../rating/schemas/rated-usage.ts';
 /** The metadata this emitter's input accepts: JSON values, undefined entries dropped. */
-export type { BillingEventMetadata };
+export type { BillingEventMetadata, UsageRecordOutcome };
+/** How one platform-resource emission ended; the shared record-internal outcome. */
+export type PlatformResourceOutcome = UsageEmissionOutcome;
 export type PlatformResourceReason = 'sweep' | 'tick' | 'completion' | 'manual' | 'reconcile';
 export interface RecordPlatformResourceInput {
     /** Origin of the account app. Omit to skip metering. */
@@ -80,6 +85,13 @@ export interface RecordPlatformResourceInput {
             message: string;
         }) => Promise<void> | void;
     };
+    /**
+     * Receives how the emission ended. The journal tracks DELIVERY (a
+     * delivered record must not be re-sent, or the usage row is written
+     * twice); this tracks whether the charge was collected. A `shortfall`
+     * outcome is delivered and still unpaid.
+     */
+    onOutcome?: (outcome: PlatformResourceOutcome) => Promise<void> | void;
 }
 /**
  * Fire-and-forget rated emission. Skipped silently when the inputs

package/dist/billing/usage/record-platform-resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-platform-resource.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/record-platform-resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAIN,KAAK,oBAAoB,EACzB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EACX,YAAY,EACZ,aAAa,EACb,MAAM,kCAAkC,CAAC;AAE1C,yFAAyF;AACzF,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAQrC,MAAM,MAAM,sBAAsB,GAC/B,OAAO,GACP,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,WAAW,CAAC;AAEf,MAAM,WAAW,2BAA2B;IAC3C,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,EAAE,aAAa,CAAC;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,+BAA+B;IAC/B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,yEAAyE;IACzE,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YAC9C,OAAO,EAAE,MAAM,CAAC;SAChB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC3B,CAAC;CACF;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAgGpG"}
+{"version":3,"file":"record-platform-resource.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/record-platform-resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAKN,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EACX,YAAY,EACZ,aAAa,EACb,MAAM,kCAAkC,CAAC;AAE1C,yFAAyF;AACzF,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;AAEzD,oFAAoF;AACpF,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAQ3D,MAAM,MAAM,sBAAsB,GAC/B,OAAO,GACP,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,WAAW,CAAC;AAEf,MAAM,WAAW,2BAA2B;IAC3C,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,EAAE,aAAa,CAAC;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,+BAA+B;IAC/B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,yEAAyE;IACzE,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YAC9C,OAAO,EAAE,MAAM,CAAC;SAChB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvE;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,2BAA2B,GAAG,IAAI,CA6HpG"}

package/dist/billing/usage/record-platform-resource.js

@@ -19,10 +19,13 @@
  *   - Returns `void`; failures log structured context.
  *   - Honors the same journal callback contract as
  *     `record-sandbox-uptime` so app-local audit tables stay consistent.
+ *   - A delivered record that could not be paid for is NOT success: the
+ *     caller's `onOutcome` receives `shortfall` with the uncollected
+ *     cost-basis USD, exactly as `record-sandbox-uptime` reports it.
  */
 import { getLogger } from '@vibesdotdev/logging';
 import { settle } from '@vibesdotdev/kernel';
-import { deliveryFailure, deliveryFailureMessage, notifyJournal } from "./delivery.js";
+import { deliveryFailureMessage, notifyJournal, readUsageRecordDelivery, usageRecordSettlement } from "./delivery.js";
 function log(runtime) {
     return getLogger('account', runtime).child({ context: 'record-platform-resource' });
 }
@@ -42,8 +45,12 @@ function totalMeasured(units) {
  */
 export function recordPlatformResource(runtime, input) {
     const total = totalMeasured(input.measuredUnits);
-    if (total <= 0)
+    if (total <= 0) {
+        // Nothing to bill, but still an outcome: a caller waiting on
+        // `onOutcome` (the code-session meter) must always hear back.
+        void notifyJournal(log(runtime), 'recordPlatformResource', () => input.onOutcome?.({ delivery: 'skipped', message: 'zero-quantity' }));
         return;
+    }
     if (!input.billingUserId && !input.organizationId) {
         const message = 'neither-billing-user-nor-organization-set';
         log(runtime).debug('recordPlatformResource: skipping (' + message + ')', {
@@ -52,6 +59,7 @@ export function recordPlatformResource(runtime, input) {
             reason: input.reason
         });
         void notifyJournal(log(runtime), 'recordPlatformResource', () => input.journal?.onFailure?.({ reason: 'skip', message }));
+        void notifyJournal(log(runtime), 'recordPlatformResource', () => input.onOutcome?.({ delivery: 'skipped', message }));
         return;
     }
     if (!input.accountOrigin) {
@@ -62,6 +70,7 @@ export function recordPlatformResource(runtime, input) {
             reason: input.reason
         });
         void notifyJournal(log(runtime), 'recordPlatformResource', () => input.journal?.onFailure?.({ reason: 'skip', message }));
+        void notifyJournal(log(runtime), 'recordPlatformResource', () => input.onOutcome?.({ delivery: 'skipped', message }));
         return;
     }
     const accountOrigin = input.accountOrigin;
@@ -73,6 +82,7 @@ export function recordPlatformResource(runtime, input) {
             reason: input.reason
         });
         void notifyJournal(log(runtime), 'recordPlatformResource', () => input.journal?.onFailure?.({ reason: 'skip', message }));
+        void notifyJournal(log(runtime), 'recordPlatformResource', () => input.onOutcome?.({ delivery: 'skipped', message }));
         return;
     }
     const effectiveHardware = input.hardware ?? 'cloud';
@@ -102,13 +112,21 @@ export function recordPlatformResource(runtime, input) {
             }
         }),
         signal
-    }), { timeoutMs: USAGE_RECORD_TIMEOUT_MS, reason: 'account platform resource usage record' })).then(async (delivered) => {
-        const failure = deliveryFailure(delivered);
-        if (!failure) {
+    }).then(readUsageRecordDelivery), { timeoutMs: USAGE_RECORD_TIMEOUT_MS, reason: 'account platform resource usage record' })).then(async (settled) => {
+        const settlement = usageRecordSettlement(settled);
+        const context = { featureSlug: input.featureSlug, resourceId: input.resourceId };
+        if (settlement.delivered) {
+            // Delivered, so the journal row is done even when the charge was
+            // not collected: re-sending would write the usage row twice.
             await notifyJournal(log(runtime), 'recordPlatformResource', input.journal?.onSuccess);
+            const { outcome } = settlement;
+            if (outcome.status !== 'charged') {
+                log(runtime).warn('recordPlatformResource: usage delivered but not charged in full', { ...context, outcome });
+            }
+            await notifyJournal(log(runtime), 'recordPlatformResource', () => input.onOutcome?.({ delivery: 'delivered', outcome }));
             return;
         }
-        const context = { featureSlug: input.featureSlug, resourceId: input.resourceId };
+        const { failure } = settlement;
         if (failure.reason === 'http') {
             log(runtime).warn('recordPlatformResource: non-2xx from account', { ...context, status: failure.status });
         }
@@ -120,6 +138,7 @@ export function recordPlatformResource(runtime, input) {
         }
         const message = deliveryFailureMessage(failure, USAGE_RECORD_TIMEOUT_MS);
         await notifyJournal(log(runtime), 'recordPlatformResource', () => input.journal?.onFailure?.({ reason: failure.reason, message }));
+        await notifyJournal(log(runtime), 'recordPlatformResource', () => input.onOutcome?.({ delivery: 'failed', failure }));
     });
 }
 //# sourceMappingURL=record-platform-resource.js.map

package/dist/billing/usage/record-platform-resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-platform-resource.js","sourceRoot":"","sources":["../../../src/billing/usage/record-platform-resource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"record-platform-resource.js","sourceRoot":"","sources":["../../../src/billing/usage/record-platform-resource.ts"],"names":[],"mappings":"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"}

package/dist/billing/usage/record-sandbox-uptime.d.ts

@@ -18,14 +18,20 @@
  * Design constraints (same as record-generation-usage.ts)
  * - MUST NOT fail the heartbeat path. Always returns void; swallows
  *   errors with structured log.
- * - MUST be time-bounded. 500ms hard cap via AbortController.
+ * - MUST be time-bounded. 500ms hard cap via AbortController, body
+ *   read included.
+ * - A delivered record that could not be paid for is NOT success: the
+ *   caller's `onOutcome` receives `shortfall` with the uncollected
+ *   cost-basis USD.
  */
 import { type RuntimeRef } from '@vibesdotdev/kernel';
-import { type BillingEventMetadata } from './delivery.ts';
+import { type BillingEventMetadata, type UsageEmissionOutcome, type UsageRecordOutcome } from './delivery.ts';
 import type { CostBasis } from '../rating/schemas/cost-basis.ts';
 import type { HardwarePath } from '../rating/schemas/rated-usage.ts';
 /** The metadata this emitter's input accepts: JSON values, undefined entries dropped. */
-export type { BillingEventMetadata };
+export type { BillingEventMetadata, UsageRecordOutcome };
+/** How one uptime emission ended; the shared record-internal outcome. */
+export type SandboxUptimeOutcome = UsageEmissionOutcome;
 export interface RecordSandboxUptimeInput {
     /** Origin of the account app. Omit to skip metering (dev without account). */
     accountOrigin: string | null | undefined;
@@ -88,6 +94,13 @@ export interface RecordSandboxUptimeInput {
             message: string;
         }) => Promise<void> | void;
     };
+    /**
+     * Receives how the emission ended. The journal tracks DELIVERY (a
+     * delivered record must not be re-sent, or the usage row is written
+     * twice); this tracks whether the charge was collected. A `shortfall`
+     * outcome is delivered and still unpaid.
+     */
+    onOutcome?: (outcome: SandboxUptimeOutcome) => Promise<void> | void;
 }
 export declare function recordSandboxUptime(runtime: RuntimeRef, input: RecordSandboxUptimeInput): void;
 //# sourceMappingURL=record-sandbox-uptime.d.ts.map

package/dist/billing/usage/record-sandbox-uptime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-sandbox-uptime.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/record-sandbox-uptime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAIN,KAAK,oBAAoB,EACzB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,yFAAyF;AACzF,YAAY,EAAE,oBAAoB,EAAE,CAAC;AASrC,MAAM,WAAW,wBAAwB;IACxC,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+FAA+F;IAC/F,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC/G,CAAC;CACF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAwG9F"}
+{"version":3,"file":"record-sandbox-uptime.d.ts","sourceRoot":"","sources":["../../../src/billing/usage/record-sandbox-uptime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAKN,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,yFAAyF;AACzF,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;AAEzD,yEAAyE;AACzE,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AASxD,MAAM,WAAW,wBAAwB;IACxC,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+FAA+F;IAC/F,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC/G,CAAC;IACF;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAiI9F"}