@crowdedkingdoms/crowdyjs 16.0.0 → 16.2.0-dev.1

package/dist/generated/graphql.d.ts

@@ -1145,8 +1145,13 @@ export type AppPlayerUsageRow = {
     __typename?: 'AppPlayerUsageRow';
     /** Player automation units used. */
     automationUnits: Scalars['BigInt']['output'];
-    /** Cents charged in the window. */
+    /**
+     * DEPRECATED. chargedMicrousd / 10,000 truncated toward zero.
+     * @deprecated Derived from chargedMicrousd (truncated). Read chargedMicrousd.
+     */
     chargedCents: Scalars['BigInt']['output'];
+    /** Micro-USD charged to the player for this app in the window (exact). */
+    chargedMicrousd: Scalars['BigInt']['output'];
     /** Compile submissions. */
     compileCount: Scalars['Int']['output'];
     /** Player compute units used. */
@@ -1435,6 +1440,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 +1479,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 +5031,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 +5551,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 +6516,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 +7167,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 +7188,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. */
@@ -7407,8 +7505,13 @@ export type Query = {
     appPlayerCodeListingVersions: Array<PlayerCodeVersion>;
     /** List an app's marketplace code listings (studio administration view), newest first. Requires 'view_compute_diagnostics'. includeDelisted adds delisted/killed rows for moderation history. */
     appPlayerCodeListings: Array<PlayerCodeListing>;
-    /** Total player rate-card markup accrued to this app's org income line, in cents (payouts arrive with the P4b ledger). Requires 'view_billing'. */
+    /**
+     * DEPRECATED (cents, truncated): read appPlayerMarkupAccruedMicrousd. Total player rate-card markup credited to this app's org wallet, in cents. Requires 'view_billing'.
+     * @deprecated Cents truncate; appPlayerMarkupAccruedMicrousd carries the exact amount.
+     */
     appPlayerMarkupAccrued: Scalars['BigInt']['output'];
+    /** Total player rate-card markup credited to this app's org wallet (`markup_payout` rows, mirrored as CREDIT events on the ledger), in micro-USD, exact. Cents-era accruals from before the ledger are included. Requires 'view_billing'. */
+    appPlayerMarkupAccruedMicrousd: Scalars['BigInt']['output'];
     /** Per-player usage aggregate for an app over a trailing window (top spenders / quota utilization, 06 §5): compute units, automation units, compiles, and cents charged per player. Requires 'view_compute_diagnostics'. */
     appPlayerUsage: Array<AppPlayerUsageRow>;
     /** Shared-environment runtime gate decision plus current hour/day billing-window usage for an app. Read this to learn why an app is not running (runtimeDenialReason). Caller must be a member of the app's org. */
@@ -7439,10 +7542,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 +7586,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. */
@@ -7857,6 +7970,9 @@ export type QueryAppPlayerCodeListingsArgs = {
 export type QueryAppPlayerMarkupAccruedArgs = {
     appId: Scalars['BigInt']['input'];
 };
+export type QueryAppPlayerMarkupAccruedMicrousdArgs = {
+    appId: Scalars['BigInt']['input'];
+};
 export type QueryAppPlayerUsageArgs = {
     appId: Scalars['BigInt']['input'];
     hours?: InputMaybe<Scalars['Int']['input']>;
@@ -7916,9 +8032,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 +8113,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 +10532,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 +11874,8 @@ export type WalletBalanceQuery = {
         __typename?: 'OrgWallet';
         walletId: string;
         orgId: string;
+        balanceMicrousd: string;
+        holdsMicrousd: string;
         balanceCents: string;
         currency: string;
         createdAt: string;
@@ -11748,6 +11894,8 @@ export type WalletTransactionsQuery = {
         transactionId: string;
         walletId: string;
         orgId: string;
+        amountMicrousd: string;
+        balanceAfterMicrousd: string;
         amountCents: string;
         balanceAfter: string;
         transactionType: string;
@@ -11775,6 +11923,8 @@ export type WalletTransactionsConnectionQuery = {
                 transactionId: string;
                 walletId: string;
                 orgId: string;
+                amountMicrousd: string;
+                balanceAfterMicrousd: string;
                 amountCents: string;
                 balanceAfter: string;
                 transactionType: string;
@@ -16673,6 +16823,8 @@ export type PlayerWalletFieldsFragment = {
     __typename?: 'PlayerWallet';
     walletId: string;
     userId: string;
+    balanceMicrousd: string;
+    holdsMicrousd: string;
     balanceCents: string;
     currency: string;
     createdAt: string;
@@ -16682,6 +16834,8 @@ export type PlayerWalletTransactionFieldsFragment = {
     transactionId: string;
     walletId: string;
     userId: string;
+    amountMicrousd: string;
+    balanceAfterMicrousd: string;
     amountCents: string;
     balanceAfter: string;
     transactionType: string;
@@ -16757,6 +16911,8 @@ export type PlayerWalletBalanceQuery = {
         __typename?: 'PlayerWallet';
         walletId: string;
         userId: string;
+        balanceMicrousd: string;
+        holdsMicrousd: string;
         balanceCents: string;
         currency: string;
         createdAt: string;
@@ -16773,6 +16929,8 @@ export type PlayerWalletTransactionsQuery = {
         transactionId: string;
         walletId: string;
         userId: string;
+        amountMicrousd: string;
+        balanceAfterMicrousd: string;
         amountCents: string;
         balanceAfter: string;
         transactionType: string;
@@ -16995,6 +17153,7 @@ export type AppPlayerUsageQuery = {
         computeUnits: string;
         automationUnits: string;
         compileCount: number;
+        chargedMicrousd: string;
         chargedCents: string;
     }>;
 };
@@ -17005,6 +17164,13 @@ export type AppPlayerMarkupAccruedQuery = {
     __typename?: 'Query';
     appPlayerMarkupAccrued: string;
 };
+export type AppPlayerMarkupAccruedMicrousdQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+}>;
+export type AppPlayerMarkupAccruedMicrousdQuery = {
+    __typename?: 'Query';
+    appPlayerMarkupAccruedMicrousd: string;
+};
 export type DeleteQuotaMutationVariables = Exact<{
     quotaId: Scalars['BigInt']['input'];
 }>;
@@ -18861,6 +19027,7 @@ export declare const PlayerRateMarkupDocument: DocumentNode<PlayerRateMarkupQuer
 export declare const SetPlayerRateMarkupDocument: DocumentNode<SetPlayerRateMarkupMutation, SetPlayerRateMarkupMutationVariables>;
 export declare const AppPlayerUsageDocument: DocumentNode<AppPlayerUsageQuery, AppPlayerUsageQueryVariables>;
 export declare const AppPlayerMarkupAccruedDocument: DocumentNode<AppPlayerMarkupAccruedQuery, AppPlayerMarkupAccruedQueryVariables>;
+export declare const AppPlayerMarkupAccruedMicrousdDocument: DocumentNode<AppPlayerMarkupAccruedMicrousdQuery, AppPlayerMarkupAccruedMicrousdQueryVariables>;
 export declare const DeleteQuotaDocument: DocumentNode<DeleteQuotaMutation, DeleteQuotaMutationVariables>;
 export declare const EffectiveQuotaDocument: DocumentNode<EffectiveQuotaQuery, EffectiveQuotaQueryVariables>;
 export declare const QuotasForAppDocument: DocumentNode<QuotasForAppQuery, QuotasForAppQueryVariables>;