@crowdedkingdoms/crowdyjs 16.0.0-test.1 → 16.1.0-dev.1

package/dist/default-origin.d.ts

@@ -1,6 +1,6 @@
 /**
  * GENERATED — do not edit. The operator tooling's
- * `sync-client-origins.mjs --write --tier test` writes this file, and
+ * `sync-client-origins.mjs --write --tier dev` writes this file, and
  * `check-sdk-default-origin.mjs` refuses it when it names the wrong tier or a
  * host that declaration does not carry. Regenerate; never hand-edit.
  *
@@ -10,14 +10,14 @@
  * than no default at all. Every fallback this SDK ever removed named a host that
  * was already dead. A generated file plus a gate is what makes this one different.
  *
- * Source: the operator's per-tier public CK API origin declaration, tier 'test'
+ * Source: the operator's per-tier public CK API origin declaration, tier 'dev'
  */
 /** The tier this build of the SDK is published for. */
-export declare const CROWDY_DEFAULT_TIER = "test";
+export declare const CROWDY_DEFAULT_TIER = "dev";
 /** The public CK API origin for that tier. */
-export declare const CROWDY_DEFAULT_HTTP_ORIGIN = "https://ck.test.crowdedkingdoms.com";
+export declare const CROWDY_DEFAULT_HTTP_ORIGIN = "https://ck.dev.crowdedkingdoms.com";
 /** The same host over WebSocket. A scheme is composed; a hostname is looked up. */
-export declare const CROWDY_DEFAULT_WS_ORIGIN = "wss://ck.test.crowdedkingdoms.com";
+export declare const CROWDY_DEFAULT_WS_ORIGIN = "wss://ck.dev.crowdedkingdoms.com";
 /** The bare hostname, for callers that need to compare rather than dial. */
-export declare const CROWDY_DEFAULT_HOST = "ck.test.crowdedkingdoms.com";
+export declare const CROWDY_DEFAULT_HOST = "ck.dev.crowdedkingdoms.com";
 //# sourceMappingURL=default-origin.d.ts.map

package/dist/default-origin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-origin.d.ts","sourceRoot":"","sources":["../src/default-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,wCAAwC,CAAC;AAEhF,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAE5E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,gCAAgC,CAAC"}
+{"version":3,"file":"default-origin.d.ts","sourceRoot":"","sources":["../src/default-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,uCAAuC,CAAC;AAE/E,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,qCAAqC,CAAC;AAE3E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,+BAA+B,CAAC"}

package/dist/default-origin.js

@@ -1,6 +1,6 @@
 /**
  * GENERATED — do not edit. The operator tooling's
- * `sync-client-origins.mjs --write --tier test` writes this file, and
+ * `sync-client-origins.mjs --write --tier dev` writes this file, and
  * `check-sdk-default-origin.mjs` refuses it when it names the wrong tier or a
  * host that declaration does not carry. Regenerate; never hand-edit.
  *
@@ -10,13 +10,13 @@
  * than no default at all. Every fallback this SDK ever removed named a host that
  * was already dead. A generated file plus a gate is what makes this one different.
  *
- * Source: the operator's per-tier public CK API origin declaration, tier 'test'
+ * Source: the operator's per-tier public CK API origin declaration, tier 'dev'
  */
 /** The tier this build of the SDK is published for. */
-export const CROWDY_DEFAULT_TIER = 'test';
+export const CROWDY_DEFAULT_TIER = 'dev';
 /** The public CK API origin for that tier. */
-export const CROWDY_DEFAULT_HTTP_ORIGIN = 'https://ck.test.crowdedkingdoms.com';
+export const CROWDY_DEFAULT_HTTP_ORIGIN = 'https://ck.dev.crowdedkingdoms.com';
 /** The same host over WebSocket. A scheme is composed; a hostname is looked up. */
-export const CROWDY_DEFAULT_WS_ORIGIN = 'wss://ck.test.crowdedkingdoms.com';
+export const CROWDY_DEFAULT_WS_ORIGIN = 'wss://ck.dev.crowdedkingdoms.com';
 /** The bare hostname, for callers that need to compare rather than dial. */
-export const CROWDY_DEFAULT_HOST = 'ck.test.crowdedkingdoms.com';
+export const CROWDY_DEFAULT_HOST = 'ck.dev.crowdedkingdoms.com';

package/dist/domains/billing.d.ts

@@ -5,9 +5,13 @@ import { type WalletBalanceQuery, type WalletTransactionsQuery, type WalletTrans
  * `client.admin`).
  *
  * Part of the management surface. Reads require the `view_billing` org/app
- * permission; {@link setAppBudget} requires `manage_billing`. Monetary values
- * are minor currency units (`*Cents`) and serialized as `BigInt` decimal
- * strings.
+ * permission; {@link setAppBudget} requires `manage_billing`. Wallet money is
+ * MICRO-USD (`*Microusd`, 1 USD = 1,000,000) serialized as `BigInt` decimal
+ * strings -- the unit of account since the lossless ledger (ck-api 2026-09-11),
+ * in which nothing is rounded. The `*Cents` fields remain as deprecated
+ * derived values (micro-USD / 10,000, truncated toward zero) and will be
+ * removed in a later major. Budget caps (`monthlyLimitCents`) stay in cents:
+ * they are limits, not money of record.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `FORBIDDEN` / `SCOPE_MISSING`
  *   per the permission notes above.
@@ -20,7 +24,9 @@ export declare class BillingAPI {
      * permission.
      *
      * @param orgId - Numeric org id (`BigInt` as a decimal string).
-     * @returns The wallet balance (cents as a decimal string).
+     * @returns The wallet balance: `balanceMicrousd` and `holdsMicrousd`
+     *   (micro-USD as decimal strings; spendable = balance − holds), plus the
+     *   deprecated `balanceCents`.
      */
     walletBalance(orgId: string): Promise<WalletBalanceQuery['walletBalance']>;
     /**

package/dist/domains/billing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/domains/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,0CAA0C,EAC/C,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAE/C;;;;;;OAMG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAK/C;;;;;;;OAOG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7C,OAAO,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;IASzD;;;;;;;OAOG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAQvC;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAKvE;;;;;;;;;OASG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAShD;;;;;;;;OAQG;IACG,4BAA4B,CAChC,IAAI,EAAE,0CAA0C,GAC/C,OAAO,CACR,iCAAiC,CAAC,8BAA8B,CAAC,CAClE;CAWF"}
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/domains/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,0CAA0C,EAC/C,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAE/C;;;;;;;;OAQG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAK/C;;;;;;;OAOG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7C,OAAO,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;IASzD;;;;;;;OAOG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAQvC;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAKvE;;;;;;;;;OASG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAShD;;;;;;;;OAQG;IACG,4BAA4B,CAChC,IAAI,EAAE,0CAA0C,GAC/C,OAAO,CACR,iCAAiC,CAAC,8BAA8B,CAAC,CAClE;CAWF"}

package/dist/domains/billing.js

@@ -4,9 +4,13 @@ import { WalletBalanceDocument, WalletTransactionsDocument, WalletTransactionsCo
  * `client.admin`).
  *
  * Part of the management surface. Reads require the `view_billing` org/app
- * permission; {@link setAppBudget} requires `manage_billing`. Monetary values
- * are minor currency units (`*Cents`) and serialized as `BigInt` decimal
- * strings.
+ * permission; {@link setAppBudget} requires `manage_billing`. Wallet money is
+ * MICRO-USD (`*Microusd`, 1 USD = 1,000,000) serialized as `BigInt` decimal
+ * strings -- the unit of account since the lossless ledger (ck-api 2026-09-11),
+ * in which nothing is rounded. The `*Cents` fields remain as deprecated
+ * derived values (micro-USD / 10,000, truncated toward zero) and will be
+ * removed in a later major. Budget caps (`monthlyLimitCents`) stay in cents:
+ * they are limits, not money of record.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `FORBIDDEN` / `SCOPE_MISSING`
  *   per the permission notes above.
@@ -20,7 +24,9 @@ export class BillingAPI {
      * permission.
      *
      * @param orgId - Numeric org id (`BigInt` as a decimal string).
-     * @returns The wallet balance (cents as a decimal string).
+     * @returns The wallet balance: `balanceMicrousd` and `holdsMicrousd`
+     *   (micro-USD as decimal strings; spendable = balance − holds), plus the
+     *   deprecated `balanceCents`.
      */
     async walletBalance(orgId) {
         const data = await this.api.request(WalletBalanceDocument, { orgId });

package/dist/domains/playerWallet.d.ts

@@ -16,7 +16,12 @@ import { type BeginPlayerCardSetupMutation, type PlayerWalletBalanceQuery, type
 export declare class PlayerWalletAPI {
     private readonly graphql;
     constructor(graphql: GraphQLClient);
-    /** The caller's wallet, created empty on first access (never null). */
+    /**
+     * The caller's wallet, created empty on first access (never null).
+     * `balanceMicrousd` / `holdsMicrousd` are micro-USD (1 USD = 1,000,000)
+     * decimal strings; spendable = balance − holds (a model turn holds its
+     * worst case while it runs). `balanceCents` is the deprecated truncation.
+     */
     balance(): Promise<PlayerWalletBalanceQuery['playerWalletBalance']>;
     /** The caller's wallet ledger, newest first. */
     transactions(variables?: PlayerWalletTransactionsQueryVariables): Promise<PlayerWalletTransactionsQuery['playerWalletTransactions']>;

package/dist/domains/playerWallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playerWallet.d.ts","sourceRoot":"","sources":["../../src/domains/playerWallet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playerWallet.d.ts","sourceRoot":"","sources":["../../src/domains/playerWallet.ts"],"names":[],"mappings":"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"}

package/dist/domains/playerWallet.js

@@ -16,7 +16,12 @@ export class PlayerWalletAPI {
     constructor(graphql) {
         this.graphql = graphql;
     }
-    /** The caller's wallet, created empty on first access (never null). */
+    /**
+     * The caller's wallet, created empty on first access (never null).
+     * `balanceMicrousd` / `holdsMicrousd` are micro-USD (1 USD = 1,000,000)
+     * decimal strings; spendable = balance − holds (a model turn holds its
+     * worst case while it runs). `balanceCents` is the deprecated truncation.
+     */
     async balance() {
         const data = await this.graphql.request(PlayerWalletBalanceDocument, {});
         return data.playerWalletBalance;

package/dist/generated/graphql.d.ts

@@ -1435,6 +1435,29 @@ export type BatchActorLookupInput = {
     /** Actor ids to look up. Each is exactly 32 ASCII characters (the UDP-wire actor id), NOT a hyphenated RFC-4122 UUID. Must be non-empty; unknown ids are silently omitted from the result. */
     uuids: Array<Scalars['String']['input']>;
 };
+/** One settlement unit of the lossless ledger: a (payer, meter, period) for a continuous meter, or one request for a request-priced meter. Amounts in micro-USD; nothing is rounded. */
+export type BillingCharge = {
+    __typename?: 'BillingCharge';
+    appId: Scalars['BigInt']['output'];
+    billedMicrousd: Scalars['BigInt']['output'];
+    chargeId: Scalars['String']['output'];
+    heldMicrousd: Scalars['BigInt']['output'];
+    meter: Scalars['String']['output'];
+    payerId: Scalars['BigInt']['output'];
+    payerKind: Scalars['String']['output'];
+    periodStart: Maybe<Scalars['DateTime']['output']>;
+    pricedTotalMicrousd: Scalars['BigInt']['output'];
+    quantityFree: Scalars['BigInt']['output'];
+    quantityTotal: Scalars['BigInt']['output'];
+    settlementRef: Scalars['String']['output'];
+    state: Scalars['String']['output'];
+    updatedAt: Scalars['DateTime']['output'];
+    writtenOffMicrousd: Scalars['BigInt']['output'];
+};
+export type BillingCreditResult = {
+    __typename?: 'BillingCreditResult';
+    creditedMicrousd: Scalars['BigInt']['output'];
+};
 /** An organization whose wallet is not debited and whose apps are not denied for funds. Usage is still metered; waived amounts are in org_billing_waivers. */
 export type BillingExemptOrgType = {
     __typename?: 'BillingExemptOrgType';
@@ -1451,6 +1474,45 @@ export type BillingExemptOrgType = {
     /** Organization slug. */
     slug: Scalars['String']['output'];
 };
+/** One run of the ledger invariant checks. */
+export type BillingInvariantRun = {
+    __typename?: 'BillingInvariantRun';
+    /** JSON text. */
+    detail: Maybe<Scalars['String']['output']>;
+    ok: Scalars['Boolean']['output'];
+    ranAt: Scalars['DateTime']['output'];
+    residueMicrousd: Scalars['BigInt']['output'];
+    runId: Scalars['String']['output'];
+    /** JSON text. */
+    sums: Scalars['String']['output'];
+};
+/** Ledger versus provider for one UTC day. */
+export type BillingReconciliation = {
+    __typename?: 'BillingReconciliation';
+    day: Scalars['String']['output'];
+    deltaMicrousd: Maybe<Scalars['BigInt']['output']>;
+    /** JSON text. */
+    detail: Maybe<Scalars['String']['output']>;
+    expectedMicrousd: Scalars['BigInt']['output'];
+    provider: Scalars['String']['output'];
+    providerReportedMicrousd: Maybe<Scalars['BigInt']['output']>;
+    status: Scalars['String']['output'];
+};
+/** A billable amount that could not be billed, with the reason. */
+export type BillingWriteOff = {
+    __typename?: 'BillingWriteOff';
+    amountMicrousd: Scalars['BigInt']['output'];
+    appId: Maybe<Scalars['BigInt']['output']>;
+    createdAt: Scalars['DateTime']['output'];
+    /** JSON text. */
+    evidence: Maybe<Scalars['String']['output']>;
+    meter: Scalars['String']['output'];
+    payerId: Scalars['BigInt']['output'];
+    payerKind: Scalars['String']['output'];
+    quantity: Scalars['BigInt']['output'];
+    reason: Scalars['String']['output'];
+    writeOffId: Scalars['String']['output'];
+};
 export type BindCrowdyStudioGitHubInput = {
     appId: Scalars['BigInt']['input'];
     branch?: InputMaybe<Scalars['String']['input']>;
@@ -4964,6 +5026,8 @@ export type Mutation = {
     connectUdpProxy: UdpProxyConnectionStatus;
     /** Consent to run a grid-attached client mod (D2): acknowledges the attachment's exact capability hash. A newer version with a widened summary carries a different hash, so stale consents fail closed — re-consent is always explicit. Consent is per player per attachment. */
     consentGridClientMod: Scalars['Boolean']['output'];
+    /** Operator only. Credit the payer of an over-billed charge (an I3 finding: an allowance or rate was raised after the charge landed) the difference, and close the charge row. Idempotent per charge state. SIDE EFFECT: a wallet credit and a CREDIT event. */
+    cpBillingCreditOverbill: BillingCreditResult;
     /** Operator only (is_operator). Patches the platform compute ceilings: omitted fields stay unchanged, an explicit null clears that override (game-api falls back to env/default), a value (> 0) sets it. SIDE EFFECTS: fans a replica notify out to every game-api so the new ceilings clamp computeSetPolicy within ~30 seconds without a restart, and writes an audit entry. Lowering a ceiling does not shrink already-stored per-app policies; it rejects future computeSetPolicy values above the new ceiling. Returns the updated ceilings row. */
     cpSetComputePlatformCeilings: CpComputePlatformCeilings;
     /** Operator only (is_operator or is_super_admin). Publish or release an emergency kill for one app. This state is separate from the app's own kill and always takes precedence in Management's effective envelope; app users cannot clear it. SIDE EFFECTS: revision increment and a sanitized audit event. NOTHING IS PUSHED TO GAME API: preemption takes effect when its runtime next pulls this app's crowdy.studio-agent-policy/1 replica, which is within about a minute for an app already holding one and not at all for an app that does not until a permitted caller asks. Releasing the operator kill does not enable the app or clear its own kill. Stable errors: AGENT_POLICY_INVALID, AGENT_POLICY_REVISION_CONFLICT, IDEMPOTENCY_CONFLICT. */
@@ -5482,6 +5546,11 @@ export type MutationConsentGridClientModArgs = {
     attachmentId: Scalars['String']['input'];
     consentCapabilityHash: Scalars['String']['input'];
 };
+export type MutationCpBillingCreditOverbillArgs = {
+    appId: Scalars['BigInt']['input'];
+    chargeId: Scalars['String']['input'];
+    reason: Scalars['String']['input'];
+};
 export type MutationCpSetComputePlatformCeilingsArgs = {
     input: CpSetComputePlatformCeilingsInput;
 };
@@ -6442,12 +6511,19 @@ export type OrgUsageSummary = {
 };
 export type OrgWallet = {
     __typename?: 'OrgWallet';
-    /** Current wallet balance in minor currency units (cents) of `currency`, as a BigInt decimal string. May be negative if usage was charged against an empty wallet. */
+    /**
+     * DEPRECATED. balanceMicrousd / 10,000 truncated toward zero, as a BigInt decimal string.
+     * @deprecated Cents are a display convenience derived from balanceMicrousd (truncated toward zero). Read balanceMicrousd.
+     */
     balanceCents: Scalars['BigInt']['output'];
+    /** Current wallet balance in MICRO-USD (1 USD = 1,000,000), as a BigInt decimal string. The unit of account since 2026-09-11: every charge is recorded to the micro-USD and nothing is rounded. May be negative when accrued usage settled against an empty wallet. */
+    balanceMicrousd: Scalars['BigInt']['output'];
     /** When the wallet was created (ISO-8601 UTC timestamp). */
     createdAt: Scalars['DateTime']['output'];
     /** ISO-4217 currency code for `balanceCents`, lowercase (e.g. "usd"). Defaults to "usd". */
     currency: Scalars['String']['output'];
+    /** Micro-USD currently held against in-flight request-priced usage (a model turn reserves its worst case here before it runs and releases the difference when it settles). Spendable balance is balanceMicrousd - holdsMicrousd. */
+    holdsMicrousd: Scalars['BigInt']['output'];
     /** Organization that owns this wallet (BigInt as a decimal string). There is exactly one wallet per organization. */
     orgId: Scalars['BigInt']['output'];
     /** When the wallet was last modified, e.g. on balance change (ISO-8601 UTC timestamp). */
@@ -7086,12 +7162,19 @@ export type PlayerUsageCharge = {
 /** The caller's player wallet (player compute P2, DN-5): a platform-scoped balance funding that player's grid compute across every org/app they play in. Out-of-band from org wallets — player usage never touches an org's money. */
 export type PlayerWallet = {
     __typename?: 'PlayerWallet';
-    /** Current balance in cents (may go negative on a closed hour). */
+    /**
+     * DEPRECATED. balanceMicrousd / 10,000 truncated toward zero.
+     * @deprecated Derived from balanceMicrousd (truncated toward zero). Read balanceMicrousd.
+     */
     balanceCents: Scalars['BigInt']['output'];
+    /** Current balance in MICRO-USD (1 USD = 1,000,000). The unit of account since 2026-09-11; nothing is rounded. May go negative when accrued usage settles against an empty wallet. */
+    balanceMicrousd: Scalars['BigInt']['output'];
     /** Wallet creation time. */
     createdAt: Scalars['DateTime']['output'];
     /** ISO currency code (lowercase). */
     currency: Scalars['String']['output'];
+    /** Micro-USD held against in-flight request-priced usage (a model turn reserves its worst case before it runs). Spendable = balanceMicrousd - holdsMicrousd. */
+    holdsMicrousd: Scalars['BigInt']['output'];
     /** The owning player user id. */
     userId: Scalars['BigInt']['output'];
     /** Wallet id. */
@@ -7100,12 +7183,22 @@ export type PlayerWallet = {
 /** One player-wallet ledger entry: top-ups, hourly usage debits, auto-recharges, refunds, and adjustments. Usage debits carry the app and reference the hour's charge row, whose snapshot splits platform vs studio-markup components. */
 export type PlayerWalletTransaction = {
     __typename?: 'PlayerWalletTransaction';
-    /** Signed amount in cents (debits negative). */
+    /**
+     * DEPRECATED. amountMicrousd / 10,000 truncated toward zero.
+     * @deprecated Derived from amountMicrousd (truncated toward zero). Read amountMicrousd.
+     */
     amountCents: Scalars['BigInt']['output'];
+    /** Signed amount in micro-USD (debits negative). Exact. */
+    amountMicrousd: Scalars['BigInt']['output'];
     /** The app a usage debit covers; null for wallet-level entries. */
     appId: Maybe<Scalars['BigInt']['output']>;
-    /** Balance after this entry. */
+    /**
+     * DEPRECATED. balanceAfterMicrousd / 10,000 truncated toward zero.
+     * @deprecated Derived from balanceAfterMicrousd. Read balanceAfterMicrousd.
+     */
     balanceAfter: Scalars['BigInt']['output'];
+    /** Balance in micro-USD after this entry. */
+    balanceAfterMicrousd: Scalars['BigInt']['output'];
     /** Entry time. */
     createdAt: Scalars['DateTime']['output'];
     /** Human description. */
@@ -7439,10 +7532,14 @@ export type Query = {
     avatarAppStates: Array<AppAvatarState>;
     /** Bulk-fetches actors by a list of 32-character ASCII uuids in one round-trip. Requires a valid game token. PUBLIC-STATE ONLY: `privateState` is stripped (null) for every result regardless of ownership. Unknown uuids are silently omitted. Use this to resolve many actors at once; use `actor` for a single owner-scoped fetch. */
     batchLookupActors: Array<Actor>;
+    /** The lossless ledger's charge rows for one app: every (payer, meter, period) or request that has been priced, with what was billed, held and written off, in micro-USD. Requires 'view_billing' on the org. */
+    billingCharges: Array<BillingCharge>;
     /** OPERATOR ONLY. Every organization currently marked billing_exempt. An exemption nobody can enumerate is an exemption that outlives its reason. */
     billingExemptOrgs: Array<BillingExemptOrgType>;
     /** OPERATOR ONLY. The metered rate card for a scope: every priced dimension with its unit, price and hourly free allowance. SHARED is organization usage billed to the org wallet as "shared_usage"; PLAYER is player compute billed to the player wallet as "usage_debit". A dimension priced at 0 is metered but not charged. Read-only. Customers read the same rates through `meteredRateCard`, which is public and omits the operator note. */
     billingRateCard: Array<RateCardEntryType>;
+    /** Amounts the platform could not bill this org for, with the reason (an exempt org, a provider with no generation record, a process that died with metered usage in memory). Requires 'view_billing' on the org. */
+    billingWriteOffs: Array<BillingWriteOff>;
     /** Fetch one channel by id. Errors if the id is not a channel. */
     channel: Group;
     /** List the members of a channel (the subscriber set, including pending requests), each with their status and roles. */
@@ -7479,6 +7576,12 @@ export type Query = {
     computeModules: Array<WasmModule>;
     /** The platform's engine-template registry: ready-made compute engines (mob/world/match/deck/instance/director/matchmaking/market/board/minigame/abilities/movement-warden/territory/racing/...) deployable by name with computeDeployTemplate. Requires the org 'manage_compute' permission. */
     computeTemplates: Array<ComputeTemplateInfo>;
+    /** Operator only. The ledger invariant runs, newest first: whether the sums closed and, when they did not, which check failed and by how much. */
+    cpBillingInvariantRuns: Array<BillingInvariantRun>;
+    /** Operator only. Ledger-versus-provider reconciliation, one row per provider per UTC day. */
+    cpBillingReconciliations: Array<BillingReconciliation>;
+    /** Operator only (is_operator or is_super_admin). Every write-off, newest first. */
+    cpBillingWriteOffs: Array<BillingWriteOff>;
     /** Operator only (is_operator). The stored platform ceilings for the per-app WASM compute policy (the knobs computeSetPolicy clamps against). Null fields mean no operator override: game-api uses its COMPUTE_PLATFORM_MAX_* env var, then the code default. Read-only. */
     cpComputePlatformCeilings: CpComputePlatformCeilings;
     /** Operator only (is_operator or is_super_admin). What the ANSWERING ck-api instance carries for Agentic Studio: allowlisted models with their pinned micro-USD prices, the implemented crowdy.agent-tools/1 tools with risk classes, and the complete mode and risk-class value sets a policy may draw from. It is deployed configuration read from that one process, not stored policy and not a fleet-wide claim, so it reports which instance and datacenter answered. A platform policy may name a model or tool absent here: the write succeeds, the value is stored and echoed back, and no run can use it. */
@@ -7916,9 +8019,18 @@ export type QueryAvatarAppStatesArgs = {
 export type QueryBatchLookupActorsArgs = {
     input: BatchActorLookupInput;
 };
+export type QueryBillingChargesArgs = {
+    appId: Scalars['BigInt']['input'];
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    orgId: Scalars['BigInt']['input'];
+};
 export type QueryBillingRateCardArgs = {
     scope: RateScope;
 };
+export type QueryBillingWriteOffsArgs = {
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    orgId: Scalars['BigInt']['input'];
+};
 export type QueryChannelArgs = {
     groupId: Scalars['BigInt']['input'];
 };
@@ -7988,6 +8100,15 @@ export type QueryComputeModulesArgs = {
 export type QueryComputeTemplatesArgs = {
     appId: Scalars['BigInt']['input'];
 };
+export type QueryCpBillingInvariantRunsArgs = {
+    limit?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryCpBillingReconciliationsArgs = {
+    limit?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryCpBillingWriteOffsArgs = {
+    limit?: InputMaybe<Scalars['Int']['input']>;
+};
 export type QueryCrowdyStudioAgentEffectivePolicyArgs = {
     appId: Scalars['BigInt']['input'];
 };
@@ -10398,12 +10519,22 @@ export type VoxelUpdatesByDistanceResponse = {
 };
 export type WalletTransaction = {
     __typename?: 'WalletTransaction';
-    /** Signed change applied to the wallet in minor currency units (cents), as a BigInt decimal string: positive credits funds, negative debits funds. */
+    /**
+     * DEPRECATED. amountMicrousd / 10,000 truncated toward zero.
+     * @deprecated Derived from amountMicrousd (truncated toward zero). Read amountMicrousd.
+     */
     amountCents: Scalars['BigInt']['output'];
+    /** Signed change applied to the wallet in MICRO-USD, as a BigInt decimal string: positive credits funds, negative debits funds. Exact; nothing is rounded. */
+    amountMicrousd: Scalars['BigInt']['output'];
     /** App that incurred the charge (BigInt as a decimal string), set on usage-type transactions; null for org-level credits such as top-ups. */
     appId: Maybe<Scalars['BigInt']['output']>;
-    /** Wallet balance in cents immediately after this transaction was applied, as a BigInt decimal string. */
+    /**
+     * DEPRECATED. balanceAfterMicrousd / 10,000 truncated toward zero.
+     * @deprecated Derived from balanceAfterMicrousd (truncated toward zero). Read balanceAfterMicrousd.
+     */
     balanceAfter: Scalars['BigInt']['output'];
+    /** Wallet balance in micro-USD immediately after this transaction was applied, as a BigInt decimal string. */
+    balanceAfterMicrousd: Scalars['BigInt']['output'];
     /** When the transaction was recorded (ISO-8601 UTC timestamp). */
     createdAt: Scalars['DateTime']['output'];
     /** Optional human-readable note describing the transaction; null when not set. */
@@ -11730,6 +11861,8 @@ export type WalletBalanceQuery = {
         __typename?: 'OrgWallet';
         walletId: string;
         orgId: string;
+        balanceMicrousd: string;
+        holdsMicrousd: string;
         balanceCents: string;
         currency: string;
         createdAt: string;
@@ -11748,6 +11881,8 @@ export type WalletTransactionsQuery = {
         transactionId: string;
         walletId: string;
         orgId: string;
+        amountMicrousd: string;
+        balanceAfterMicrousd: string;
         amountCents: string;
         balanceAfter: string;
         transactionType: string;
@@ -11775,6 +11910,8 @@ export type WalletTransactionsConnectionQuery = {
                 transactionId: string;
                 walletId: string;
                 orgId: string;
+                amountMicrousd: string;
+                balanceAfterMicrousd: string;
                 amountCents: string;
                 balanceAfter: string;
                 transactionType: string;
@@ -16673,6 +16810,8 @@ export type PlayerWalletFieldsFragment = {
     __typename?: 'PlayerWallet';
     walletId: string;
     userId: string;
+    balanceMicrousd: string;
+    holdsMicrousd: string;
     balanceCents: string;
     currency: string;
     createdAt: string;
@@ -16682,6 +16821,8 @@ export type PlayerWalletTransactionFieldsFragment = {
     transactionId: string;
     walletId: string;
     userId: string;
+    amountMicrousd: string;
+    balanceAfterMicrousd: string;
     amountCents: string;
     balanceAfter: string;
     transactionType: string;
@@ -16757,6 +16898,8 @@ export type PlayerWalletBalanceQuery = {
         __typename?: 'PlayerWallet';
         walletId: string;
         userId: string;
+        balanceMicrousd: string;
+        holdsMicrousd: string;
         balanceCents: string;
         currency: string;
         createdAt: string;
@@ -16773,6 +16916,8 @@ export type PlayerWalletTransactionsQuery = {
         transactionId: string;
         walletId: string;
         userId: string;
+        amountMicrousd: string;
+        balanceAfterMicrousd: string;
         amountCents: string;
         balanceAfter: string;
         transactionType: string;