@aventurevc/api-schemas 0.8.156 → 0.8.159

package/dist/billing/additional-usage-funding-type.d.ts

@@ -4,6 +4,8 @@ import { z } from "zod/v4";
  *
  * @openapiSchema BillingAdditionalUsageFundingType
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
+ * @usedBySchema BillingAdditionalUsageMutationSchema
  * @usedBySchema BillingAdditionalUsageSchema
  * @contractShape billing.additional-usage-funding-type
  * @contractRole canonical

package/dist/billing/additional-usage-funding-type.js

@@ -5,6 +5,8 @@ import { z } from "zod/v4";
  *
  * @openapiSchema BillingAdditionalUsageFundingType
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
+ * @usedBySchema BillingAdditionalUsageMutationSchema
  * @usedBySchema BillingAdditionalUsageSchema
  * @contractShape billing.additional-usage-funding-type
  * @contractRole canonical

package/dist/billing/additional-usage-meter.d.ts

@@ -20,6 +20,7 @@ export interface BillingAdditionalUsageMeterSchemaInput extends z.input<typeof B
  *
  * @openapiSchema BillingAdditionalUsageMeter
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
  * @usedBySchema BillingAdditionalUsageSchema
  * @contractShape billing.additional-usage-meter
  * @contractRole canonical

package/dist/billing/additional-usage-meter.js

@@ -12,6 +12,7 @@ const BillingAdditionalUsageMeterSchemaDefinition = z.object({
  *
  * @openapiSchema BillingAdditionalUsageMeter
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
  * @usedBySchema BillingAdditionalUsageSchema
  * @contractShape billing.additional-usage-meter
  * @contractRole canonical

package/dist/billing/additional-usage-mutation.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+declare const BillingAdditionalUsageMutationSchemaDefinition: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    funding: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        PREPAID_CREDIT: "PREPAID_CREDIT";
+        USAGE_INVOICE: "USAGE_INVOICE";
+    }>>>;
+    invoiceIncrementCents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    spendCapCents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+type BillingAdditionalUsageMutationDefinition = z.infer<typeof BillingAdditionalUsageMutationSchemaDefinition>;
+export interface BillingAdditionalUsageMutationSchemaInput extends z.input<typeof BillingAdditionalUsageMutationSchemaDefinition> {
+}
+/**
+ * Merge patch of the additional-usage settings. Enabling requires funding; USAGE_INVOICE also requires spendCapCents and invoiceIncrementCents.
+ *
+ * @openapiSchema BillingAdditionalUsageMutation
+ * @endpoint PATCH /v1/billing/additional-usage
+ * @contractShape billing.additional-usage-mutation
+ * @contractRole canonical
+ */
+export declare const BillingAdditionalUsageMutationSchema: z.ZodType<BillingAdditionalUsageMutationDefinition, BillingAdditionalUsageMutationSchemaInput>;
+export type BillingAdditionalUsageMutation = z.infer<typeof BillingAdditionalUsageMutationSchema>;
+export {};
+//# sourceMappingURL=additional-usage-mutation.d.ts.map

package/dist/billing/additional-usage-mutation.js

@@ -0,0 +1,22 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { BillingAdditionalUsageFundingTypeSchema } from "./additional-usage-funding-type.js";
+const BillingAdditionalUsageMutationSchemaDefinition = z.object({
+    /** Turn recording of usage past the monthly caps on or off. */
+    enabled: z.boolean().nullish(),
+    funding: BillingAdditionalUsageFundingTypeSchema.nullish(),
+    /** Unbilled cents that trigger a USAGE_INVOICE invoice; one of the plan catalog's invoiceIncrementCents. */
+    invoiceIncrementCents: z.number().int().nullish(),
+    /** Monthly spend cap in cents; required for USAGE_INVOICE. */
+    spendCapCents: z.number().int().nullish(),
+});
+/**
+ * Merge patch of the additional-usage settings. Enabling requires funding; USAGE_INVOICE also requires spendCapCents and invoiceIncrementCents.
+ *
+ * @openapiSchema BillingAdditionalUsageMutation
+ * @endpoint PATCH /v1/billing/additional-usage
+ * @contractShape billing.additional-usage-mutation
+ * @contractRole canonical
+ */
+export const BillingAdditionalUsageMutationSchema = BillingAdditionalUsageMutationSchemaDefinition;
+//# sourceMappingURL=additional-usage-mutation.js.map

package/dist/billing/additional-usage-type.d.ts

@@ -5,6 +5,7 @@ import { z } from "zod/v4";
  * @openapiSchema BillingAdditionalUsageType
  * @endpoint GET /v1/billing/plans
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
  * @usedBySchema BillingAdditionalUsageMeterSchema
  * @usedBySchema BillingCatalogAdditionalUsageSchema
  * @contractShape billing.additional-usage-type

package/dist/billing/additional-usage-type.js

@@ -6,6 +6,7 @@ import { z } from "zod/v4";
  * @openapiSchema BillingAdditionalUsageType
  * @endpoint GET /v1/billing/plans
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
  * @usedBySchema BillingAdditionalUsageMeterSchema
  * @usedBySchema BillingCatalogAdditionalUsageSchema
  * @contractShape billing.additional-usage-type

package/dist/billing/additional-usage.d.ts

@@ -30,6 +30,7 @@ export interface BillingAdditionalUsageSchemaInput extends z.input<typeof Billin
  *
  * @openapiSchema BillingAdditionalUsage
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
  * @usedBySchema BillingSubscriptionSchema
  * @contractShape billing.additional-usage
  * @contractRole canonical

package/dist/billing/additional-usage.js

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 import { BillingAdditionalUsageFundingTypeSchema } from "./additional-usage-funding-type.js";
 import { BillingAdditionalUsageMeterSchema } from "./additional-usage-meter.js";
 const BillingAdditionalUsageSchemaDefinition = z.object({
-    /** Prepaid credit not yet consumed by priced usage, in cents. */
+    /** Spendable prepaid credit after pending usage and invoice-line rounding reserves, in cents. */
     availableCreditCents: z.number(),
     /** True while a failed threshold invoice blocks additional usage; paying it in Billing Portal clears the block. */
     blocked: z.boolean(),
@@ -27,6 +27,7 @@ const BillingAdditionalUsageSchemaDefinition = z.object({
  *
  * @openapiSchema BillingAdditionalUsage
  * @endpoint GET /v1/billing/subscription
+ * @endpoint PATCH /v1/billing/additional-usage
  * @usedBySchema BillingSubscriptionSchema
  * @contractShape billing.additional-usage
  * @contractRole canonical

package/dist/billing/catalog-plan.d.ts

@@ -5,13 +5,13 @@ declare const BillingCatalogPlanSchemaDefinition: z.ZodObject<{
     currency: z.ZodString;
     displayName: z.ZodString;
     introductoryAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    plan: z.ZodEnum<{
+    plan: z.ZodUnion<readonly [z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-    }>;
+    }>, z.ZodString]>;
     tier: z.ZodEnum<{
         ESSENTIAL: "ESSENTIAL";
         PLUS: "PLUS";

package/dist/billing/catalog.d.ts

@@ -21,7 +21,7 @@ declare const BillingCatalogSchemaDefinition: z.ZodObject<{
         currency: string;
         displayName: string;
         introductoryAmount?: number | null | undefined;
-        plan: "PLUS_MONTHLY" | "PLUS_YEARLY" | "PRO_MONTHLY" | "PRO_YEARLY" | "PRO_YEARLY_PROMOTION";
+        plan: string;
         tier: "ESSENTIAL" | "PLUS" | "PRO" | "UNLIMITED";
         unitAmount: number;
     }, import("./catalog-plan.ts").BillingCatalogPlanSchemaInput, z.core.$ZodTypeInternals<{
@@ -30,7 +30,7 @@ declare const BillingCatalogSchemaDefinition: z.ZodObject<{
         currency: string;
         displayName: string;
         introductoryAmount?: number | null | undefined;
-        plan: "PLUS_MONTHLY" | "PLUS_YEARLY" | "PRO_MONTHLY" | "PRO_YEARLY" | "PRO_YEARLY_PROMOTION";
+        plan: string;
         tier: "ESSENTIAL" | "PLUS" | "PRO" | "UNLIMITED";
         unitAmount: number;
     }, import("./catalog-plan.ts").BillingCatalogPlanSchemaInput>>>;

package/dist/billing/checkout-mutation.d.ts

@@ -1,12 +1,12 @@
 import { z } from "zod/v4";
 declare const BillingCheckoutMutationSchemaDefinition: z.ZodObject<{
-    plan: z.ZodEnum<{
+    plan: z.ZodUnion<readonly [z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-    }>;
+    }>, z.ZodString]>;
     uiMode: z.ZodOptional<z.ZodEnum<{
         ELEMENTS: "ELEMENTS";
         HOSTED_PAGE: "HOSTED_PAGE";

package/dist/billing/checkout.d.ts

@@ -2,13 +2,13 @@ import { z } from "zod/v4";
 declare const BillingCheckoutSchemaDefinition: z.ZodObject<{
     clientSecret: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     expiresAt: z.ZodISODateTime;
-    plan: z.ZodEnum<{
+    plan: z.ZodUnion<readonly [z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-    }>;
+    }>, z.ZodString]>;
     publishableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;

package/dist/billing/credit-pack-type.d.ts

@@ -4,7 +4,10 @@ import { z } from "zod/v4";
  *
  * @openapiSchema BillingCreditPackType
  * @endpoint GET /v1/billing/plans
+ * @endpoint POST /v1/billing/credit-purchases
  * @usedBySchema BillingCatalogCreditPackSchema
+ * @usedBySchema BillingCreditPurchaseMutationSchema
+ * @usedBySchema BillingCreditPurchaseSchema
  * @contractShape billing.credit-pack-type
  * @contractRole canonical
  */

package/dist/billing/credit-pack-type.js

@@ -5,7 +5,10 @@ import { z } from "zod/v4";
  *
  * @openapiSchema BillingCreditPackType
  * @endpoint GET /v1/billing/plans
+ * @endpoint POST /v1/billing/credit-purchases
  * @usedBySchema BillingCatalogCreditPackSchema
+ * @usedBySchema BillingCreditPurchaseMutationSchema
+ * @usedBySchema BillingCreditPurchaseSchema
  * @contractShape billing.credit-pack-type
  * @contractRole canonical
  */

package/dist/billing/credit-purchase-confirmation.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const BillingCreditPurchaseConfirmationSchemaDefinition: z.ZodObject<{
+    amountCents: z.ZodNumber;
+    closedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    grantedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    id: z.ZodUUID;
+}, z.core.$strip>;
+type BillingCreditPurchaseConfirmationDefinition = z.infer<typeof BillingCreditPurchaseConfirmationSchemaDefinition>;
+export interface BillingCreditPurchaseConfirmationSchemaInput extends z.input<typeof BillingCreditPurchaseConfirmationSchemaDefinition> {
+}
+/**
+ * One account-owned purchase's confirmed credit grant or checkout closure.
+ *
+ * @openapiSchema BillingCreditPurchaseConfirmation
+ * @endpoint GET /v1/billing/credit-purchases/{purchaseId}
+ * @contractShape billing.credit-purchase-confirmation
+ * @contractRole canonical
+ */
+export declare const BillingCreditPurchaseConfirmationSchema: z.ZodType<BillingCreditPurchaseConfirmationDefinition, BillingCreditPurchaseConfirmationSchemaInput>;
+export type BillingCreditPurchaseConfirmation = z.infer<typeof BillingCreditPurchaseConfirmationSchema>;
+export {};
+//# sourceMappingURL=credit-purchase-confirmation.d.ts.map

package/dist/billing/credit-purchase-confirmation.js

@@ -0,0 +1,18 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const BillingCreditPurchaseConfirmationSchemaDefinition = z.object({
+    amountCents: z.number().int(),
+    closedAt: z.iso.datetime({ offset: true }).nullish(),
+    grantedAt: z.iso.datetime({ offset: true }).nullish(),
+    id: z.uuid(),
+});
+/**
+ * One account-owned purchase's confirmed credit grant or checkout closure.
+ *
+ * @openapiSchema BillingCreditPurchaseConfirmation
+ * @endpoint GET /v1/billing/credit-purchases/{purchaseId}
+ * @contractShape billing.credit-purchase-confirmation
+ * @contractRole canonical
+ */
+export const BillingCreditPurchaseConfirmationSchema = BillingCreditPurchaseConfirmationSchemaDefinition;
+//# sourceMappingURL=credit-purchase-confirmation.js.map

package/dist/billing/credit-purchase-mutation.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+declare const BillingCreditPurchaseMutationSchemaDefinition: z.ZodObject<{
+    pack: z.ZodEnum<{
+        USD_100: "USD_100";
+        USD_25: "USD_25";
+        USD_250: "USD_250";
+        USD_50: "USD_50";
+    }>;
+}, z.core.$strip>;
+type BillingCreditPurchaseMutationDefinition = z.infer<typeof BillingCreditPurchaseMutationSchemaDefinition>;
+export interface BillingCreditPurchaseMutationSchemaInput extends z.input<typeof BillingCreditPurchaseMutationSchemaDefinition> {
+}
+/**
+ * Prepaid credit pack to buy through hosted Checkout.
+ *
+ * @openapiSchema BillingCreditPurchaseMutation
+ * @endpoint POST /v1/billing/credit-purchases
+ * @contractShape billing.credit-purchase-mutation
+ * @contractRole canonical
+ */
+export declare const BillingCreditPurchaseMutationSchema: z.ZodType<BillingCreditPurchaseMutationDefinition, BillingCreditPurchaseMutationSchemaInput>;
+export type BillingCreditPurchaseMutation = z.infer<typeof BillingCreditPurchaseMutationSchema>;
+export {};
+//# sourceMappingURL=credit-purchase-mutation.d.ts.map

package/dist/billing/credit-purchase-mutation.js

@@ -0,0 +1,17 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { BillingCreditPackTypeSchema } from "./credit-pack-type.js";
+const BillingCreditPurchaseMutationSchemaDefinition = z.object({
+    /** Credit pack to buy; its amount becomes prepaid credit. */
+    pack: BillingCreditPackTypeSchema,
+});
+/**
+ * Prepaid credit pack to buy through hosted Checkout.
+ *
+ * @openapiSchema BillingCreditPurchaseMutation
+ * @endpoint POST /v1/billing/credit-purchases
+ * @contractShape billing.credit-purchase-mutation
+ * @contractRole canonical
+ */
+export const BillingCreditPurchaseMutationSchema = BillingCreditPurchaseMutationSchemaDefinition;
+//# sourceMappingURL=credit-purchase-mutation.js.map

package/dist/billing/credit-purchase.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod/v4";
+declare const BillingCreditPurchaseSchemaDefinition: z.ZodObject<{
+    expiresAt: z.ZodISODateTime;
+    id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    pack: z.ZodEnum<{
+        USD_100: "USD_100";
+        USD_25: "USD_25";
+        USD_250: "USD_250";
+        USD_50: "USD_50";
+    }>;
+    url: z.ZodString;
+}, z.core.$strip>;
+type BillingCreditPurchaseDefinition = z.infer<typeof BillingCreditPurchaseSchemaDefinition>;
+export interface BillingCreditPurchaseSchemaInput extends z.input<typeof BillingCreditPurchaseSchemaDefinition> {
+}
+/**
+ * Hosted Checkout destination and expiry for a prepaid credit pack.
+ *
+ * @openapiSchema BillingCreditPurchase
+ * @endpoint POST /v1/billing/credit-purchases
+ * @contractShape billing.credit-purchase
+ * @contractRole canonical
+ */
+export declare const BillingCreditPurchaseSchema: z.ZodType<BillingCreditPurchaseDefinition, BillingCreditPurchaseSchemaInput>;
+export type BillingCreditPurchase = z.infer<typeof BillingCreditPurchaseSchema>;
+export {};
+//# sourceMappingURL=credit-purchase.d.ts.map

package/dist/billing/credit-purchase.js

@@ -0,0 +1,19 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { BillingCreditPackTypeSchema } from "./credit-pack-type.js";
+const BillingCreditPurchaseSchemaDefinition = z.object({
+    expiresAt: z.iso.datetime({ offset: true }),
+    id: z.uuid().nullish(),
+    pack: BillingCreditPackTypeSchema,
+    url: z.string(),
+});
+/**
+ * Hosted Checkout destination and expiry for a prepaid credit pack.
+ *
+ * @openapiSchema BillingCreditPurchase
+ * @endpoint POST /v1/billing/credit-purchases
+ * @contractShape billing.credit-purchase
+ * @contractRole canonical
+ */
+export const BillingCreditPurchaseSchema = BillingCreditPurchaseSchemaDefinition;
+//# sourceMappingURL=credit-purchase.js.map

package/dist/billing/discount.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+declare const BillingDiscountSchemaDefinition: z.ZodObject<{
+    amountOff: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    discountedAmount: z.ZodNumber;
+    endsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    percentOff: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+type BillingDiscountDefinition = z.infer<typeof BillingDiscountSchemaDefinition>;
+export interface BillingDiscountSchemaInput extends z.input<typeof BillingDiscountSchemaDefinition> {
+}
+/**
+ * A coupon applied to the next invoice.
+ *
+ * @openapiSchema BillingDiscount
+ * @endpoint GET /v1/billing/subscription/next-charge
+ * @usedBySchema BillingNextChargeSchema
+ * @contractShape billing.discount
+ * @contractRole canonical
+ */
+export declare const BillingDiscountSchema: z.ZodType<BillingDiscountDefinition, BillingDiscountSchemaInput>;
+export type BillingDiscount = z.infer<typeof BillingDiscountSchema>;
+export {};
+//# sourceMappingURL=discount.d.ts.map

package/dist/billing/discount.js

@@ -0,0 +1,25 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const BillingDiscountSchemaDefinition = z.object({
+    /** Fixed amount taken off in the minor unit; absent for a percentage coupon */
+    amountOff: z.number().int().nullish(),
+    /** Amount this discount takes off the next invoice, minor unit */
+    discountedAmount: z.number().int(),
+    /** When the discount stops applying; absent when it never ends */
+    endsAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Coupon name shown to the customer; absent when it has none */
+    name: z.string().nullish(),
+    /** Percentage taken off; absent for a fixed-amount coupon */
+    percentOff: z.number().nullish(),
+});
+/**
+ * A coupon applied to the next invoice.
+ *
+ * @openapiSchema BillingDiscount
+ * @endpoint GET /v1/billing/subscription/next-charge
+ * @usedBySchema BillingNextChargeSchema
+ * @contractShape billing.discount
+ * @contractRole canonical
+ */
+export const BillingDiscountSchema = BillingDiscountSchemaDefinition;
+//# sourceMappingURL=discount.js.map

package/dist/billing/next-charge.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod/v4";
+declare const BillingNextChargeSchemaDefinition: z.ZodObject<{
+    amountDue: z.ZodNumber;
+    chargeAt: z.ZodISODateTime;
+    currency: z.ZodString;
+    discount: z.ZodArray<z.ZodType<{
+        amountOff?: number | null | undefined;
+        discountedAmount: number;
+        endsAt?: string | null | undefined;
+        name?: string | null | undefined;
+        percentOff?: number | null | undefined;
+    }, import("./discount.ts").BillingDiscountSchemaInput, z.core.$ZodTypeInternals<{
+        amountOff?: number | null | undefined;
+        discountedAmount: number;
+        endsAt?: string | null | undefined;
+        name?: string | null | undefined;
+        percentOff?: number | null | undefined;
+    }, import("./discount.ts").BillingDiscountSchemaInput>>>;
+}, z.core.$strip>;
+type BillingNextChargeDefinition = z.infer<typeof BillingNextChargeSchemaDefinition>;
+export interface BillingNextChargeSchemaInput extends z.input<typeof BillingNextChargeSchemaDefinition> {
+}
+/**
+ * Next invoice of the caller's renewing Stripe subscription as Stripe previews it, after discounts and credits.
+ *
+ * @openapiSchema BillingNextCharge
+ * @endpoint GET /v1/billing/subscription/next-charge
+ * @contractShape billing.next-charge
+ * @contractRole canonical
+ */
+export declare const BillingNextChargeSchema: z.ZodType<BillingNextChargeDefinition, BillingNextChargeSchemaInput>;
+export type BillingNextCharge = z.infer<typeof BillingNextChargeSchema>;
+export {};
+//# sourceMappingURL=next-charge.d.ts.map

package/dist/billing/next-charge.js

@@ -0,0 +1,23 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { BillingDiscountSchema } from "./discount.js";
+const BillingNextChargeSchemaDefinition = z.object({
+    /** Amount the next invoice will charge in the currency's minor unit, after discounts, credits, and usage so far; 0 when a discount covers it */
+    amountDue: z.number().int(),
+    /** When the next invoice is raised and charged */
+    chargeAt: z.iso.datetime({ offset: true }),
+    /** ISO 4217 currency code. */
+    currency: z.string(),
+    /** Discounts applied to the next invoice; empty when none apply */
+    discount: z.array(BillingDiscountSchema),
+});
+/**
+ * Next invoice of the caller's renewing Stripe subscription as Stripe previews it, after discounts and credits.
+ *
+ * @openapiSchema BillingNextCharge
+ * @endpoint GET /v1/billing/subscription/next-charge
+ * @contractShape billing.next-charge
+ * @contractRole canonical
+ */
+export const BillingNextChargeSchema = BillingNextChargeSchemaDefinition;
+//# sourceMappingURL=next-charge.js.map

package/dist/billing/plan-change-mutation.d.ts

@@ -1,12 +1,12 @@
 import { z } from "zod/v4";
 declare const BillingPlanChangeMutationSchemaDefinition: z.ZodObject<{
-    plan: z.ZodEnum<{
+    plan: z.ZodUnion<readonly [z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-    }>;
+    }>, z.ZodString]>;
     prorationDate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 type BillingPlanChangeMutationDefinition = z.infer<typeof BillingPlanChangeMutationSchemaDefinition>;

package/dist/billing/plan-change.d.ts

@@ -3,13 +3,13 @@ declare const BillingPlanChangeSchemaDefinition: z.ZodObject<{
     effectiveAt: z.ZodISODateTime;
     paymentClientSecret: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     paymentUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    plan: z.ZodEnum<{
+    plan: z.ZodUnion<readonly [z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-    }>;
+    }>, z.ZodString]>;
     publishableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type BillingPlanChangeDefinition = z.infer<typeof BillingPlanChangeSchemaDefinition>;

package/dist/billing/plan-type.d.ts

@@ -17,12 +17,12 @@ import { z } from "zod/v4";
  * @contractShape billing.plan-type
  * @contractRole canonical
  */
-export declare const BillingPlanTypeSchema: z.ZodEnum<{
+export declare const BillingPlanTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     PLUS_MONTHLY: "PLUS_MONTHLY";
     PLUS_YEARLY: "PLUS_YEARLY";
     PRO_MONTHLY: "PRO_MONTHLY";
     PRO_YEARLY: "PRO_YEARLY";
     PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-}>;
+}>, z.ZodString]>;
 export type BillingPlanType = z.infer<typeof BillingPlanTypeSchema>;
 //# sourceMappingURL=plan-type.d.ts.map

package/dist/billing/plan-type.js

@@ -18,11 +18,8 @@ import { z } from "zod/v4";
  * @contractShape billing.plan-type
  * @contractRole canonical
  */
-export const BillingPlanTypeSchema = z.enum([
-    "PLUS_MONTHLY",
-    "PLUS_YEARLY",
-    "PRO_MONTHLY",
-    "PRO_YEARLY",
-    "PRO_YEARLY_PROMOTION",
+export const BillingPlanTypeSchema = z.union([
+    z.enum(["PLUS_MONTHLY", "PLUS_YEARLY", "PRO_MONTHLY", "PRO_YEARLY", "PRO_YEARLY_PROMOTION"]),
+    z.string(),
 ]);
 //# sourceMappingURL=plan-type.js.map

package/dist/billing/portal-mutation.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const BillingPortalMutationSchemaDefinition: z.ZodObject<{
+    flow: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        PAYMENT_METHOD_UPDATE: "PAYMENT_METHOD_UPDATE";
+    }>>>;
+}, z.core.$strip>;
+type BillingPortalMutationDefinition = z.infer<typeof BillingPortalMutationSchemaDefinition>;
+export interface BillingPortalMutationSchemaInput extends z.input<typeof BillingPortalMutationSchemaDefinition> {
+}
+/**
+ * Where the hosted Billing Portal session opens.
+ *
+ * @openapiSchema BillingPortalMutation
+ * @endpoint POST /v1/billing/portal-sessions
+ * @contractShape billing.portal-mutation
+ * @contractRole canonical
+ */
+export declare const BillingPortalMutationSchema: z.ZodType<BillingPortalMutationDefinition, BillingPortalMutationSchemaInput>;
+export type BillingPortalMutation = z.infer<typeof BillingPortalMutationSchema>;
+export {};
+//# sourceMappingURL=portal-mutation.d.ts.map

package/dist/billing/portal-mutation.js

@@ -0,0 +1,16 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const BillingPortalMutationSchemaDefinition = z.object({
+    /** PAYMENT_METHOD_UPDATE opens straight to adding or replacing the card and returns to subscription settings when done. Omit to open the portal home. Plan changes use POST /v1/billing/plan-changes and cancellation uses PATCH /v1/billing/subscription. */
+    flow: z.enum(["PAYMENT_METHOD_UPDATE"]).nullish(),
+});
+/**
+ * Where the hosted Billing Portal session opens.
+ *
+ * @openapiSchema BillingPortalMutation
+ * @endpoint POST /v1/billing/portal-sessions
+ * @contractShape billing.portal-mutation
+ * @contractRole canonical
+ */
+export const BillingPortalMutationSchema = BillingPortalMutationSchemaDefinition;
+//# sourceMappingURL=portal-mutation.js.map

package/dist/billing/subscription.d.ts

@@ -157,23 +157,23 @@ declare const BillingSubscriptionSchemaDefinition: z.ZodObject<{
     cancelAtPeriodEnd: z.ZodBoolean;
     entitled: z.ZodBoolean;
     originalStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
-    pendingPlan: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    pendingPlan: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-    }>>>;
+    }>, z.ZodString]>>>;
     pendingPlanAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     periodStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
-    plan: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    plan: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
         PLUS_MONTHLY: "PLUS_MONTHLY";
         PLUS_YEARLY: "PLUS_YEARLY";
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
-    }>>>;
+    }>, z.ZodString]>>>;
     provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         APP_STORE: "APP_STORE";
         STRIPE: "STRIPE";

package/dist/http/problem-detail.d.ts

@@ -21,6 +21,7 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         account_exists: "account_exists";
         billing_additional_usage_cap_reached: "billing_additional_usage_cap_reached";
         billing_allowance_exhausted: "billing_allowance_exhausted";
+        billing_credit_checkout_closed: "billing_credit_checkout_closed";
         callback_challenge_failed: "callback_challenge_failed";
         callback_connection_refused: "callback_connection_refused";
         callback_http_4xx: "callback_http_4xx";
@@ -69,12 +70,14 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         sentry_api_error: "sentry_api_error";
         source_document_body_unavailable: "source_document_body_unavailable";
         source_document_capture_limit_exceeded: "source_document_capture_limit_exceeded";
+        source_document_fetch_busy: "source_document_fetch_busy";
         subscription_canceled: "subscription_canceled";
         subscription_past_due: "subscription_past_due";
         subscription_paused: "subscription_paused";
         subscription_required: "subscription_required";
         suspectedShellStrip: "suspectedShellStrip";
         suspected_shell_strip: "suspected_shell_strip";
+        task_plan_operation_unserved: "task_plan_operation_unserved";
         url_surface_misclassification: "url_surface_misclassification";
         web_crawl_fetch_failed: "web_crawl_fetch_failed";
     }>, z.ZodString]>>>;

package/dist/http/problem-detail.js

@@ -34,6 +34,8 @@ const ProblemDetailSchemaDefinition = z.object({
             "billing_allowance_exhausted",
             /** The caller's monthly allowance is spent and the next additional-usage unit would pass the monthly spend cap or the prepaid credit left. Agent action: stop and report ProblemDetail.allowanceType, limit, used, remaining, and resetAt; raise the cap or buy credit through /v1/billing/additional-usage, or wait for resetAt. */
             "billing_additional_usage_cap_reached",
+            /** The prepaid credit Checkout is paid, expired, or closed. Retire this purchase intent before explicitly starting another Checkout; ambiguous transport failures and in-progress conflicts must keep the original key. */
+            "billing_credit_checkout_closed",
             /** A signed-out purchase named an email that already belongs to an account. Agent action: sign that account in with its email code, then subscribe signed in; never retry the signed-out purchase for that email. */
             "account_exists",
             /** Detail-origin cold-miss coalescing is saturated. Agent action: treat as backend capacity impairment, back off, and inspect backend pool/bulkhead metrics; this is not a caller throttle. */
@@ -52,6 +54,8 @@ const ProblemDetailSchemaDefinition = z.object({
             "JOBRUNR_DISABLED",
             /** JobRunr background worker is disabled in this environment. Agent action: stop (this is an admin/ops configuration condition, not a retriable user error). */
             "jobrunr_disabled",
+            /** A catalog task step runs an operation this API instance does not serve, so its plan cannot be projected: rollout skew, or an instance whose configuration disables that operation. Agent action: retry after the rollout; on a deployed instance that persists, report it as rollout skew. */
+            "task_plan_operation_unserved",
             /** JobRunr backing storage (Postgres) is unavailable. Agent action: stop; retrying will not help until DB connectivity is restored. */
             "JOBRUNR_STORAGE_UNAVAILABLE",
             /** JobRunr backing storage (Postgres) is unavailable. Agent action: stop; retrying will not help until DB connectivity is restored. */
@@ -86,6 +90,8 @@ const ProblemDetailSchemaDefinition = z.object({
             "image_photographic",
             /** An outbound fetch from an external target site (robots.txt, sitemap, page, or logo or thumbnail image) failed after retries or with the breaker open. Agent action: the failure belongs to the target; crawl jobs may fall back to rendered extraction; do not retry immediately. */
             "web_crawl_fetch_failed",
+            /** A request that must not wait found another request already fetching its source document. Agent action: retry after retryAfterSeconds (also in the Retry-After header); the existing fetch keeps running and this request did not start another. */
+            "source_document_fetch_busy",
             /** A crawl-run request named an entity or person that has no current primary website URL. Agent action: add or activate the owner's website URL, then resubmit; retrying the unchanged request cannot succeed. */
             "primary_website_missing",
             /** RSS news-ingest feed fetch failed after retries or with the breaker open. Agent action: inspect the configured feed URL and upstream status; do not retry the enqueue immediately. */

package/dist/openapi-component-manifest.js

@@ -53,6 +53,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "billing/additional-usage-meter",
         schemaName: "BillingAdditionalUsageMeterSchema",
     },
+    BillingAdditionalUsageMutation: {
+        modulePath: "billing/additional-usage-mutation",
+        schemaName: "BillingAdditionalUsageMutationSchema",
+    },
     BillingAdditionalUsageType: {
         modulePath: "billing/additional-usage-type",
         schemaName: "BillingAdditionalUsageTypeSchema",
@@ -91,6 +95,20 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "billing/credit-pack-type",
         schemaName: "BillingCreditPackTypeSchema",
     },
+    BillingCreditPurchase: {
+        modulePath: "billing/credit-purchase",
+        schemaName: "BillingCreditPurchaseSchema",
+    },
+    BillingCreditPurchaseConfirmation: {
+        modulePath: "billing/credit-purchase-confirmation",
+        schemaName: "BillingCreditPurchaseConfirmationSchema",
+    },
+    BillingCreditPurchaseMutation: {
+        modulePath: "billing/credit-purchase-mutation",
+        schemaName: "BillingCreditPurchaseMutationSchema",
+    },
+    BillingDiscount: { modulePath: "billing/discount", schemaName: "BillingDiscountSchema" },
+    BillingNextCharge: { modulePath: "billing/next-charge", schemaName: "BillingNextChargeSchema" },
     BillingPaymentMethod: {
         modulePath: "billing/payment-method",
         schemaName: "BillingPaymentMethodSchema",
@@ -106,6 +124,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     },
     BillingPlanType: { modulePath: "billing/plan-type", schemaName: "BillingPlanTypeSchema" },
     BillingPortal: { modulePath: "billing/portal", schemaName: "BillingPortalSchema" },
+    BillingPortalMutation: {
+        modulePath: "billing/portal-mutation",
+        schemaName: "BillingPortalMutationSchema",
+    },
     BillingRecurringPrice: {
         modulePath: "billing/recurring-price",
         schemaName: "BillingRecurringPriceSchema",
@@ -853,6 +875,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "SearchAiOverviewReferenceSchema",
     },
     SearchAnswer: { modulePath: "search/answer", schemaName: "SearchAnswerSchema" },
+    SearchAnswerBox: { modulePath: "search/answer-box", schemaName: "SearchAnswerBoxSchema" },
     SearchAnswerCitation: {
         modulePath: "search/answer-citation",
         schemaName: "SearchAnswerCitationSchema",
@@ -878,6 +901,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     },
     SearchInvestment: { modulePath: "search/investment", schemaName: "SearchInvestmentSchema" },
     SearchJudgment: { modulePath: "search/judgment", schemaName: "SearchJudgmentSchema" },
+    SearchKnowledgeGraph: {
+        modulePath: "search/knowledge-graph",
+        schemaName: "SearchKnowledgeGraphSchema",
+    },
     SearchLayer: { modulePath: "search/layer", schemaName: "SearchLayerSchema" },
     SearchMode: { modulePath: "search/mode", schemaName: "SearchModeSchema" },
     SearchModeExecution: {
@@ -898,7 +925,16 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "search/qualifier-option",
         schemaName: "SearchQualifierOptionSchema",
     },
+    SearchRelatedQuestion: {
+        modulePath: "search/related-question",
+        schemaName: "SearchRelatedQuestionSchema",
+    },
     SearchRelevance: { modulePath: "search/relevance", schemaName: "SearchRelevanceSchema" },
+    SearchSportsResult: {
+        modulePath: "search/sports-result",
+        schemaName: "SearchSportsResultSchema",
+    },
+    SearchSportsTeam: { modulePath: "search/sports-team", schemaName: "SearchSportsTeamSchema" },
     SecCompany: { modulePath: "sec/company", schemaName: "SecCompanySchema" },
     SecListingProspectus: {
         modulePath: "sec/listing-prospectus",

package/dist/search/answer-box.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+/**
+ * Google's direct answer shown above the results
+ *
+ * @openapiSchema SearchAnswerBox
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.answer-box
+ * @contractRole canonical
+ */
+export declare const SearchAnswerBoxSchema: z.ZodObject<{
+    answer: z.ZodString;
+    snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SearchAnswerBox = z.infer<typeof SearchAnswerBoxSchema>;
+//# sourceMappingURL=answer-box.d.ts.map

package/dist/search/answer-box.js

@@ -0,0 +1,25 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+/**
+ * Google's direct answer shown above the results
+ *
+ * @openapiSchema SearchAnswerBox
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.answer-box
+ * @contractRole canonical
+ */
+export const SearchAnswerBoxSchema = z.object({
+    /** Direct answer text; Google's snippet when the box states no separate answer */
+    answer: z.string(),
+    /** Supporting snippet the box shows */
+    snippet: z.string().nullish(),
+    /** Title of the page the answer comes from */
+    title: z.string().nullish(),
+    /** Google's answer-box kind */
+    type: z.string().nullish(),
+    /** URL of the page the answer comes from */
+    url: z.string().nullish(),
+});
+//# sourceMappingURL=answer-box.js.map

package/dist/search/knowledge-graph.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+/**
+ * Google's knowledge panel for the entity the query names
+ *
+ * @openapiSchema SearchKnowledgeGraph
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.knowledge-graph
+ * @contractRole canonical
+ */
+export declare const SearchKnowledgeGraphSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    website: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SearchKnowledgeGraph = z.infer<typeof SearchKnowledgeGraphSchema>;
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/search/knowledge-graph.js

@@ -0,0 +1,23 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+/**
+ * Google's knowledge panel for the entity the query names
+ *
+ * @openapiSchema SearchKnowledgeGraph
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.knowledge-graph
+ * @contractRole canonical
+ */
+export const SearchKnowledgeGraphSchema = z.object({
+    /** Entity description the panel shows */
+    description: z.string().nullish(),
+    /** Entity name the panel shows */
+    title: z.string().nullish(),
+    /** Entity kind Google states */
+    type: z.string().nullish(),
+    /** Official website the panel links */
+    website: z.string().nullish(),
+});
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/search/related-question.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+declare const SearchRelatedQuestionSchemaDefinition: z.ZodObject<{
+    question: z.ZodString;
+    snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type SearchRelatedQuestionDefinition = z.infer<typeof SearchRelatedQuestionSchemaDefinition>;
+export interface SearchRelatedQuestionSchemaInput extends z.input<typeof SearchRelatedQuestionSchemaDefinition> {
+}
+/**
+ * One "People also ask" question Google shows for the query
+ *
+ * @openapiSchema SearchRelatedQuestion
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.related-question
+ * @contractRole canonical
+ */
+export declare const SearchRelatedQuestionSchema: z.ZodType<SearchRelatedQuestionDefinition, SearchRelatedQuestionSchemaInput>;
+export type SearchRelatedQuestion = z.infer<typeof SearchRelatedQuestionSchema>;
+export {};
+//# sourceMappingURL=related-question.d.ts.map

package/dist/search/related-question.js

@@ -0,0 +1,24 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const SearchRelatedQuestionSchemaDefinition = z.object({
+    /** Question text */
+    question: z.string(),
+    /** Answer snippet; null when Google answers the question with an AI Overview */
+    snippet: z.string().nullish(),
+    /** Title of the page the snippet comes from */
+    title: z.string().nullish(),
+    /** URL of the page the snippet comes from */
+    url: z.string().nullish(),
+});
+/**
+ * One "People also ask" question Google shows for the query
+ *
+ * @openapiSchema SearchRelatedQuestion
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.related-question
+ * @contractRole canonical
+ */
+export const SearchRelatedQuestionSchema = SearchRelatedQuestionSchemaDefinition;
+//# sourceMappingURL=related-question.js.map

package/dist/search/sports-result.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+/**
+ * Google's spotlight for one game the query names
+ *
+ * @openapiSchema SearchSportsResult
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.sports-result
+ * @contractRole canonical
+ */
+export declare const SearchSportsResultSchema: z.ZodObject<{
+    date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    league: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    team: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        name: string;
+        seeding?: number | null | undefined;
+    }, import("./sports-team.ts").SearchSportsTeamSchemaInput, z.core.$ZodTypeInternals<{
+        name: string;
+        seeding?: number | null | undefined;
+    }, import("./sports-team.ts").SearchSportsTeamSchemaInput>>>>>;
+    venue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SearchSportsResult = z.infer<typeof SearchSportsResultSchema>;
+//# sourceMappingURL=sports-result.d.ts.map

package/dist/search/sports-result.js

@@ -0,0 +1,26 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { SearchSportsTeamSchema } from "./sports-team.js";
+/**
+ * Google's spotlight for one game the query names
+ *
+ * @openapiSchema SearchSportsResult
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema WebSearchSchema
+ * @contractShape search.sports-result
+ * @contractRole canonical
+ */
+export const SearchSportsResultSchema = z.object({
+    /** Game date as Google states it */
+    date: z.string().nullish(),
+    /** League or tournament */
+    league: z.string().nullish(),
+    /** Stage of the competition */
+    stage: z.string().nullish(),
+    /** Teams in the game */
+    team: z.array(SearchSportsTeamSchema).nullish(),
+    /** Venue or stadium */
+    venue: z.string().nullish(),
+});
+//# sourceMappingURL=sports-result.js.map

package/dist/search/sports-team.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const SearchSportsTeamSchemaDefinition: z.ZodObject<{
+    name: z.ZodString;
+    seeding: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+}, z.core.$strip>;
+type SearchSportsTeamDefinition = z.infer<typeof SearchSportsTeamSchemaDefinition>;
+export interface SearchSportsTeamSchemaInput extends z.input<typeof SearchSportsTeamSchemaDefinition> {
+}
+/**
+ * One team in a spotlighted game
+ *
+ * @openapiSchema SearchSportsTeam
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSportsResultSchema
+ * @contractShape search.sports-team
+ * @contractRole canonical
+ */
+export declare const SearchSportsTeamSchema: z.ZodType<SearchSportsTeamDefinition, SearchSportsTeamSchemaInput>;
+export type SearchSportsTeam = z.infer<typeof SearchSportsTeamSchema>;
+export {};
+//# sourceMappingURL=sports-team.d.ts.map

package/dist/search/sports-team.js

@@ -0,0 +1,20 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+const SearchSportsTeamSchemaDefinition = z.object({
+    /** Team name */
+    name: z.string(),
+    /** Tournament seeding when Google states one */
+    seeding: z.int().nullish(),
+});
+/**
+ * One team in a spotlighted game
+ *
+ * @openapiSchema SearchSportsTeam
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
+ * @endpoint POST /v1/web/search
+ * @usedBySchema SearchSportsResultSchema
+ * @contractShape search.sports-team
+ * @contractRole canonical
+ */
+export const SearchSportsTeamSchema = SearchSportsTeamSchemaDefinition;
+//# sourceMappingURL=sports-team.js.map

package/dist/web/search.d.ts

@@ -16,6 +16,13 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         }, import("../search/ai-overview-reference.ts").SearchAiOverviewReferenceSchemaInput>>>;
         text: z.ZodString;
     }, z.core.$strip>>>;
+    answerBox: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        answer: z.ZodString;
+        snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
     document: z.ZodType<{
         cacheHitCount: number;
         createdAt: string;
@@ -47,6 +54,24 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         sourceKey: string;
         upstreamContentEncoding?: string | null | undefined;
     }, import("../source/document-list.ts").SourceDocumentListSchemaInput>>;
+    knowledgeGraph: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        website: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    relatedQuestion: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        question: string;
+        snippet?: string | null | undefined;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+    }, import("../search/related-question.ts").SearchRelatedQuestionSchemaInput, z.core.$ZodTypeInternals<{
+        question: string;
+        snippet?: string | null | undefined;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+    }, import("../search/related-question.ts").SearchRelatedQuestionSchemaInput>>>>>;
+    relatedSearch: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     result: z.ZodArray<z.ZodType<{
         relevanceScore: number;
         snippet: string;
@@ -97,6 +122,19 @@ declare const WebSearchSchemaDefinition: z.ZodObject<{
         tenant?: "development" | "production" | "staging" | "unassigned" | null | undefined;
         tenantPolicyRevision?: number | null | undefined;
     }, import("../search/search.ts").SearchSchemaInput>>;
+    sportsResult: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        league: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        stage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        team: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+            name: string;
+            seeding?: number | null | undefined;
+        }, import("../search/sports-team.ts").SearchSportsTeamSchemaInput, z.core.$ZodTypeInternals<{
+            name: string;
+            seeding?: number | null | undefined;
+        }, import("../search/sports-team.ts").SearchSportsTeamSchemaInput>>>>>;
+        venue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type WebSearchDefinition = z.infer<typeof WebSearchSchemaDefinition>;
 export interface WebSearchSchemaInput extends z.input<typeof WebSearchSchemaDefinition> {

package/dist/web/search.js

@@ -1,18 +1,32 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
 import { SearchAiOverviewSchema } from "../search/ai-overview.js";
+import { SearchAnswerBoxSchema } from "../search/answer-box.js";
 import { SearchHitSchema } from "../search/hit.js";
+import { SearchKnowledgeGraphSchema } from "../search/knowledge-graph.js";
+import { SearchRelatedQuestionSchema } from "../search/related-question.js";
 import { SearchSchema } from "../search/search.js";
+import { SearchSportsResultSchema } from "../search/sports-result.js";
 import { SourceDocumentListSchema } from "../source/document-list.js";
 const WebSearchSchemaDefinition = z.object({
     /** Google's AI Overview: returned whenever Google answers inline or its deferred overview is stored (fetched by this or an earlier search that set `deferredAiOverview`); null when Google produced none or no such fetch stored its deferred overview */
     aiOverview: SearchAiOverviewSchema.nullish(),
+    /** Google's direct answer box; null when the page shows none */
+    answerBox: SearchAnswerBoxSchema.nullish(),
     /** Source-document ledger row backing this result */
     document: SourceDocumentListSchema,
+    /** Google's knowledge panel; null when the page shows none */
+    knowledgeGraph: SearchKnowledgeGraphSchema.nullish(),
+    /** Google's "People also ask" questions; null when the page shows none */
+    relatedQuestion: z.array(SearchRelatedQuestionSchema).nullish(),
+    /** Google's related searches; null when the page shows none */
+    relatedSearch: z.array(z.string()).nullish(),
     /** Normalized result items in provider rank order */
     result: z.array(SearchHitSchema),
     /** Web search request represented by this result */
     search: SearchSchema,
+    /** Google's game spotlight; null when the page shows none */
+    sportsResult: SearchSportsResultSchema.nullish(),
 });
 /**
  * Live web search result with its backing source-document row and normalized items

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.8.156",
+  "version": "0.8.159",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",