@openmeter/client 1.0.0-beta.234 → 1.0.0-beta.236

package/dist/models/schemas.js

@@ -428,7 +428,7 @@ export const createVersionFilter = z
         .lte(2147483647)
         .optional()
         .describe('Match this exact version.'),
-    in: z
+    oeq: z
         .array(z.number().int().gte(-2147483648).lte(2147483647))
         .min(1)
         .max(100)
@@ -462,7 +462,7 @@ export const versionFilter = z
         .lte(2147483647)
         .optional()
         .describe('Match this exact version.'),
-    in: z
+    oeq: z
         .array(z.number().int().gte(-2147483648).lte(2147483647))
         .min(1)
         .max(100)
@@ -723,9 +723,19 @@ export const appInstallMethods = z
 export const appStatus = z
     .enum(['ready', 'unauthorized'])
     .describe('Connection status of an installed app.');
+export const appActionType = z
+    .enum(['reconcile_webhook_events'])
+    .describe('App action type.');
 export const updateLabels = z
     .record(z.string(), z.string())
     .describe('Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\\_".');
+export const appReconcileWebhookEventsActionRequest = z
+    .object({
+    actionType: z
+        .literal('reconcile_webhook_events')
+        .describe('The action to execute.'),
+})
+    .describe("Request to reconcile the app's webhook events with the latest supported event set.");
 export const installAppStripeWithApiKey = z
     .object({
     type: z.literal('stripe').describe('Type of the app.'),
@@ -751,9 +761,9 @@ export const installAppExternalInvoicing = z
     name: z.string().describe('Name of the app.'),
     createBillingProfile: z
         .boolean()
-        .describe('If true, a billing profile will be created for the app. The Stripe app will be also set as the default billing profile if the current default is a Sandbox app.'),
+        .describe('If true, creates the Auto Collection preset with an OpenMeter supplier in the US (postal code 94114), without replacing the default profile.'),
 })
-    .describe('Base model for installing an app from the catalog.');
+    .describe('Model for installing an External Invoicing app from the catalog.');
 export const workflowCollectionAlignmentSubscription = z
     .object({
     type: z.literal('subscription').describe('The type of alignment.'),
@@ -906,6 +916,43 @@ export const booleanFieldFilter = z
 export const notificationChannelType = z
     .enum(['webhook'])
     .describe('The type of a notification channel. Currently the only supported channel type is `webhook`; the domain model anticipates additional channel types (e.g. email, Slack) in the future, so this is modeled as an enum rather than a boolean/constant even though it has a single member today.');
+export const notificationBalanceThresholdType = z
+    .enum(['balance_value', 'usage_percentage', 'usage_value'])
+    .describe('What a balance threshold is measured against.');
+export const notificationEventType = z
+    .enum([
+    'entitlements.balance.threshold',
+    'entitlements.reset',
+    'invoice.created',
+    'invoice.updated',
+])
+    .describe('The type of a notification event. It determines which payload variant the event carries.');
+export const notificationEventDeliveryState = z
+    .enum(['success', 'failed', 'sending', 'pending', 'resending'])
+    .describe('The delivery state of a notification event for a single channel.');
+export const notificationEventDeliveryAttemptResponse = z
+    .object({
+    statusCode: z
+        .number()
+        .int()
+        .gte(-2147483648)
+        .lte(2147483647)
+        .optional()
+        .describe('The HTTP status code returned by the recipient. Absent when no response was received.'),
+    body: z
+        .string()
+        .describe('The response body returned by the recipient. Empty when no body was received.'),
+    durationMs: z.coerce
+        .bigint()
+        .gte(-9223372036854775808n)
+        .lte(9223372036854775807n)
+        .describe('How long the delivery attempt took, in milliseconds.'),
+    url: z
+        .string()
+        .optional()
+        .describe('The URL the event was delivered to. Only set for webhook channels.'),
+})
+    .describe('The response the recipient returned for a delivery attempt. For webhook channels this is the HTTP response.');
 export const queryFilterInteger = z
     .object({
     eq: z
@@ -1619,6 +1666,31 @@ export const updateResourceReference = z
     id: ulid,
 })
     .describe('TaxCode reference.');
+export const notificationChannelReference = z
+    .object({
+    id: ulid,
+})
+    .describe('NotificationChannel reference.');
+export const notificationEventFeatureReference = z
+    .object({
+    id: ulid,
+    key: z.string().describe('The immutable key of the feature.'),
+})
+    .describe('A reference to the feature of an entitlement notification event.');
+export const notificationEventInvoiceReference = z
+    .object({
+    id: ulid,
+    number: z.string().describe('The human-readable invoice number.'),
+})
+    .describe('A reference to the invoice of an invoice notification event.');
+export const resendBillingNotificationEventRequest = z
+    .object({
+    channels: z
+        .array(ulid)
+        .optional()
+        .describe('The channels to resend the event to. When omitted or empty, the event is resent to every enabled channel of the rule. Channels not targeted by the rule or disabled are rejected.'),
+})
+    .describe('Request body for resending a notification event.');
 export const billingCustomerReference = z
     .object({
     id: ulid,
@@ -2476,6 +2548,14 @@ export const appCapability = z
     description: z.string().describe('Description of the capability.'),
 })
     .describe('App capability describes a function that an App can perform.');
+export const appAction = z
+    .object({
+    type: appActionType,
+    description: z
+        .string()
+        .describe('Human readable explanation of why the action is needed.'),
+})
+    .describe('An action the operator should take on an installed app.');
 export const updateAppStripeRequest = z
     .object({
     name: z
@@ -2534,6 +2614,9 @@ export const updateAppExternalInvoicingRequest = z
         .describe('Enable issuing synchronization hook. When enabled, invoices will pause at the issuing state and wait for the integration to call the issuing synchronized endpoint before progressing to the issued state. This ensures the external invoicing system has successfully created and finalized the invoice before it is marked as issued. When disabled, invoices automatically progress through the issuing state and are immediately marked as issued.'),
 })
     .describe('AppExternalInvoicing update request.');
+export const appActionRequest = z
+    .discriminatedUnion('actionType', [appReconcileWebhookEventsActionRequest])
+    .describe('Request to execute an operator action on an installed app.');
 export const installAppRequest = z
     .discriminatedUnion('type', [
     installAppStripeWithApiKey,
@@ -2703,7 +2786,7 @@ export const createNotificationChannelRequest = z
         .describe('Secret used to sign outgoing webhook payloads so recipients can verify their authenticity. If omitted on create, a secret is generated automatically by the delivery provider. This is a sensitive credential returned in responses (unlike most secrets) specifically so clients can retrieve a server-generated value and verify webhook signatures; handle it with the same care as any other credential.'),
 })
     .describe('NotificationChannel create request.');
-export const updateNotificationChannelRequest = z
+export const updateBillingNotificationChannelRequest = z
     .object({
     name: z
         .string()
@@ -2730,6 +2813,26 @@ export const updateNotificationChannelRequest = z
         .describe('Secret used to sign outgoing webhook payloads so recipients can verify their authenticity. If omitted on create, a secret is generated automatically by the delivery provider. This is a sensitive credential returned in responses (unlike most secrets) specifically so clients can retrieve a server-generated value and verify webhook signatures; handle it with the same care as any other credential.'),
 })
     .describe("Request body for updating a notification channel. Updates replace the channel's mutable state rather than merging it: `type`, `name`, and `url` must always be provided, and omitting `disabled`, `labels`, or `custom_headers` resets them to their defaults (enabled, no labels, no custom headers). `signing_secret` is the one exception: omitting it keeps the channel's current signing secret instead of clearing the credential.");
+export const notificationBalanceThreshold = z
+    .object({
+    type: notificationBalanceThresholdType,
+    value: z.number().describe('The threshold value.'),
+})
+    .describe('A balance threshold of a notification rule. Crossing it generates an `entitlements.balance.threshold` event.');
+export const notificationRuleReference = z
+    .object({
+    id: ulid,
+    type: notificationEventType,
+    name: z.string().describe('The user-provided name of the rule.'),
+})
+    .describe('A reference to the notification rule that generated an event.');
+export const notificationEventDeliveryAttempt = z
+    .object({
+    state: notificationEventDeliveryState,
+    response: notificationEventDeliveryAttemptResponse,
+    timestamp: dateTime,
+})
+    .describe('A single delivery attempt to a channel.');
 export const appCustomerData = z
     .object({
     stripe: appCustomerDataStripe
@@ -3141,6 +3244,169 @@ export const updateTaxCodeConfig = z
     code: updateResourceReference.optional(),
 })
     .describe('Tax configuration for a billable resource. Applies a tax code and tax behavior to the resulting invoice line items. When not set, the applicable default is used: the billing profile default tax configuration, then the organization default tax code.');
+export const notificationRuleEntitlementReset = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z
+        .literal('entitlements.reset')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    features: z
+        .array(featureReference)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('A rule that generates an event when an entitlement usage period is reset.');
+export const notificationRuleInvoiceCreated = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z
+        .literal('invoice.created')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('A rule that generates an event when an invoice is created.');
+export const notificationRuleInvoiceUpdated = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z
+        .literal('invoice.updated')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('A rule that generates an event when an invoice is updated.');
+export const notificationRuleEntitlementResetRequest = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    type: z
+        .literal('entitlements.reset')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    features: z
+        .array(featureReference)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('Request body for an entitlement reset rule.');
+export const notificationRuleInvoiceCreatedRequest = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    type: z
+        .literal('invoice.created')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('Request body for an invoice created rule.');
+export const notificationRuleInvoiceUpdatedRequest = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    type: z
+        .literal('invoice.updated')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('Request body for an invoice updated rule.');
+export const notificationEventInvoiceData = z
+    .object({
+    invoice: notificationEventInvoiceReference,
+    customerId: ulid.optional(),
+    currency: currencyCode,
+    status: z
+        .string()
+        .describe('The status of the invoice at the time the event was generated.'),
+    total: numeric,
+})
+    .describe('The invoice an invoice notification event refers to.');
 export const listEventsParamsFilter = z
     .object({
     id: stringFieldFilter.optional(),
@@ -3191,6 +3457,31 @@ export const listNotificationChannelsParamsFilter = z
     updatedAt: dateTimeFieldFilter.optional(),
 })
     .describe('Filter options for listing notification channels.');
+export const listNotificationRulesParamsFilter = z
+    .object({
+    id: ulidFieldFilter.optional(),
+    name: stringFieldFilter.optional(),
+    type: stringFieldFilterExact.optional(),
+    disabled: booleanFieldFilter.optional(),
+    createdAt: dateTimeFieldFilter.optional(),
+    updatedAt: dateTimeFieldFilter.optional(),
+    channelId: ulidFieldFilter.optional(),
+})
+    .describe('Filter options for listing notification rules.');
+export const listNotificationEventsParamsFilter = z
+    .object({
+    id: ulidFieldFilter.optional(),
+    type: stringFieldFilterExact.optional(),
+    createdAt: dateTimeFieldFilter.optional(),
+    ruleId: ulidFieldFilter.optional(),
+    channelId: ulidFieldFilter.optional(),
+    deliveryStatus: stringFieldFilterExact.optional(),
+    subjectKey: stringFieldFilterExact.optional(),
+    subjectId: ulidFieldFilter.optional(),
+    featureKey: stringFieldFilterExact.optional(),
+    featureId: ulidFieldFilter.optional(),
+})
+    .describe('Filter options for listing notification events.');
 export const resourceFilters = z
     .object({
     name: stringFieldFilter.optional(),
@@ -3613,6 +3904,7 @@ export const entitlementGrant = z
     .object({
     id: ulid,
     entitlementId: ulid,
+    customerId: ulid.optional(),
     amount: numeric,
     priority: z
         .number()
@@ -3885,6 +4177,86 @@ export const notificationChannelPagePaginatedResponse = z
     meta: paginatedMeta,
 })
     .describe('Page paginated response.');
+export const notificationRuleBalanceThreshold = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z
+        .literal('entitlements.balance.threshold')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    thresholds: z
+        .array(notificationBalanceThreshold)
+        .min(1)
+        .max(10)
+        .describe('The thresholds that generate an event when crossed.'),
+    features: z
+        .array(featureReference)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('A rule that generates an event when an entitlement balance crosses one of its thresholds.');
+export const notificationRuleBalanceThresholdRequest = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labels.optional(),
+    type: z
+        .literal('entitlements.balance.threshold')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReference)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    thresholds: z
+        .array(notificationBalanceThreshold)
+        .min(1)
+        .max(10)
+        .describe('The thresholds that generate an event when crossed.'),
+    features: z
+        .array(featureReference)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('Request body for a balance threshold rule.');
+export const notificationEventDeliveryStatus = z
+    .object({
+    channelId: ulid,
+    state: notificationEventDeliveryState,
+    reason: z
+        .string()
+        .describe('The reason for the last state change. Empty for successful deliveries.'),
+    updatedAt: dateTime,
+    nextAttempt: dateTime.optional(),
+    attempts: z
+        .array(notificationEventDeliveryAttempt)
+        .describe('The delivery attempts made so far, most recent first.'),
+})
+    .describe('The delivery status of a notification event for one channel of the generating rule.');
 export const customerData = z
     .object({
     billingProfile: profileReference.optional(),
@@ -3928,6 +4300,29 @@ export const listCustomerEntitlementAccessResponseData = z
         .describe('The list of entitlement access results.'),
 })
     .describe('List customer entitlement access response data.');
+export const notificationEventBalanceThresholdData = z
+    .object({
+    entitlementId: ulid,
+    feature: notificationEventFeatureReference,
+    subjectKey: z
+        .string()
+        .describe('The key of the subject the entitlement belongs to.'),
+    customerId: ulid.optional(),
+    value: entitlementValueResult,
+    threshold: notificationBalanceThreshold,
+})
+    .describe('The entities and threshold a balance threshold event refers to.');
+export const notificationEventEntitlementData = z
+    .object({
+    entitlementId: ulid,
+    feature: notificationEventFeatureReference,
+    subjectKey: z
+        .string()
+        .describe('The key of the subject the entitlement belongs to.'),
+    customerId: ulid.optional(),
+    value: entitlementValueResult,
+})
+    .describe('The entitlement, feature, and subject an entitlement notification event refers to.');
 export const priceGraduated = z
     .object({
     type: z.literal('graduated').describe('The type of the price.'),
@@ -4061,6 +4456,22 @@ export const planAddonPagePaginatedResponse = z
     meta: paginatedMeta,
 })
     .describe('Page paginated response.');
+export const notificationEventInvoiceCreatedPayload = z
+    .object({
+    id: ulid,
+    type: z.literal('invoice.created').describe('The type of the event.'),
+    timestamp: dateTime,
+    data: notificationEventInvoiceData,
+})
+    .describe('An invoice created notification event payload.');
+export const notificationEventInvoiceUpdatedPayload = z
+    .object({
+    id: ulid,
+    type: z.literal('invoice.updated').describe('The type of the event.'),
+    timestamp: dateTime,
+    data: notificationEventInvoiceData,
+})
+    .describe('An invoice updated notification event payload.');
 export const ingestedEventPaginatedResponse = z
     .object({
     data: z.array(ingestedEvent),
@@ -4284,6 +4695,10 @@ export const appStripe = z
     type: z.literal('stripe').describe('The app type.'),
     definition: appCatalogItem,
     status: appStatus,
+    actions: z
+        .array(appAction)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     accountId: z
         .string()
         .describe('The Stripe account ID associated with the connected Stripe account.'),
@@ -4315,6 +4730,10 @@ export const appSandbox = z
     type: z.literal('sandbox').describe('The app type.'),
     definition: appCatalogItem,
     status: appStatus,
+    actions: z
+        .array(appAction)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
 })
     .describe('Sandbox app can be used for testing billing features.');
 export const appExternalInvoicing = z
@@ -4337,6 +4756,10 @@ export const appExternalInvoicing = z
     type: z.literal('external_invoicing').describe('The app type.'),
     definition: appCatalogItem,
     status: appStatus,
+    actions: z
+        .array(appAction)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     enableDraftSyncHook: z
         .boolean()
         .describe('Enable draft synchronization hook. When enabled, invoices will pause at the draft state and wait for the integration to call the draft synchronized endpoint before progressing to the issuing state. This allows the external system to validate and prepare the invoice data. When disabled, invoices automatically progress through the draft state based on the configured workflow timing.'),
@@ -4371,6 +4794,10 @@ export const installedAppStripe = z
     type: z.literal('stripe').describe('The app type.'),
     definition: appCatalogItem,
     status: appStatus,
+    actions: z
+        .array(appAction)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     accountId: z
         .string()
         .describe('The Stripe account ID associated with the connected Stripe account.'),
@@ -4405,6 +4832,10 @@ export const installedAppSandbox = z
     type: z.literal('sandbox').describe('The app type.'),
     definition: appCatalogItem,
     status: appStatus,
+    actions: z
+        .array(appAction)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     defaultForCapabilityTypes: z
         .array(appCapabilityType)
         .describe('Default capabilities of the installed app.'),
@@ -4430,6 +4861,10 @@ export const installedAppExternalInvoicing = z
     type: z.literal('external_invoicing').describe('The app type.'),
     definition: appCatalogItem,
     status: appStatus,
+    actions: z
+        .array(appAction)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     enableDraftSyncHook: z
         .boolean()
         .describe('Enable draft synchronization hook. When enabled, invoices will pause at the draft state and wait for the integration to call the draft synchronized endpoint before progressing to the issuing state. This allows the external system to validate and prepare the invoice data. When disabled, invoices automatically progress through the draft state based on the configured workflow timing.'),
@@ -4488,6 +4923,40 @@ export const entitlementAccessQueryResult = z
     updatedAt: dateTime,
 })
     .describe('Access evaluation result for a single resolved customer.');
+export const notificationRule = z
+    .discriminatedUnion('type', [
+    notificationRuleBalanceThreshold,
+    notificationRuleEntitlementReset,
+    notificationRuleInvoiceCreated,
+    notificationRuleInvoiceUpdated,
+])
+    .describe('A notification rule selects the type of event to generate, the conditions specific to that type, and the channels to deliver the events to.');
+export const notificationRuleRequest = z
+    .discriminatedUnion('type', [
+    notificationRuleBalanceThresholdRequest,
+    notificationRuleEntitlementResetRequest,
+    notificationRuleInvoiceCreatedRequest,
+    notificationRuleInvoiceUpdatedRequest,
+])
+    .describe("Request body for creating or updating a notification rule. Updates replace the rule's mutable state: omitting `disabled`, `labels`, or `features` resets them to their defaults. The `type` must match the existing rule on update.");
+export const notificationEventBalanceThresholdPayload = z
+    .object({
+    id: ulid,
+    type: z
+        .literal('entitlements.balance.threshold')
+        .describe('The type of the event.'),
+    timestamp: dateTime,
+    data: notificationEventBalanceThresholdData,
+})
+    .describe('A balance threshold notification event payload.');
+export const notificationEventResetPayload = z
+    .object({
+    id: ulid,
+    type: z.literal('entitlements.reset').describe('The type of the event.'),
+    timestamp: dateTime,
+    data: notificationEventEntitlementData,
+})
+    .describe('An entitlement reset notification event payload.');
 export const price = z
     .discriminatedUnion('type', [
     priceFree,
@@ -4755,6 +5224,20 @@ export const entitlementAccessQueryResponse = z
     meta: cursorMeta,
 })
     .describe('Response of the entitlement access query.');
+export const notificationRulePagePaginatedResponse = z
+    .object({
+    data: z.array(notificationRule),
+    meta: paginatedMeta,
+})
+    .describe('Page paginated response.');
+export const notificationEventPayload = z
+    .discriminatedUnion('type', [
+    notificationEventBalanceThresholdPayload,
+    notificationEventResetPayload,
+    notificationEventInvoiceCreatedPayload,
+    notificationEventInvoiceUpdatedPayload,
+])
+    .describe('The payload delivered to the channels, discriminated by the event type.');
 export const rateCard = z
     .object({
     name: z
@@ -4894,6 +5377,18 @@ export const profileApps = z
     payment: app,
 })
     .describe('Applications used by a billing profile.');
+export const notificationEvent = z
+    .object({
+    id: ulid,
+    type: notificationEventType,
+    createdAt: dateTime,
+    rule: notificationRuleReference,
+    deliveryStatus: z
+        .array(notificationEventDeliveryStatus)
+        .describe('The delivery status of the event, one entry per channel of the rule.'),
+    payload: notificationEventPayload,
+})
+    .describe('A notification event records that a notification rule fired and tracks the delivery of its payload to each channel of the rule. Events are created by the system and cannot be modified.');
 export const subscriptionItem = z
     .object({
     id: ulid,
@@ -5156,6 +5651,12 @@ export const chargeRealization = z
         .describe('The detailed (rated) lines produced by the realization run. Requires the `realization.detailed_lines` expand.'),
 })
     .describe("A realization run of a charge. `totals` and `detailed_lines` are only populated with the `realization.totals` and `realization.detailed_lines` expands, respectively, since computing them requires re-deriving the run's rated breakdown. `invoice` is an ID reference unless the `realization.invoice` expand is used, which resolves it to the invoice header of the run's booked line: the invoice entity without its `lines` and without the `customer` snapshot (the charge itself already identifies the customer).");
+export const notificationEventPagePaginatedResponse = z
+    .object({
+    data: z.array(notificationEvent),
+    meta: paginatedMeta,
+})
+    .describe('Page paginated response.');
 export const subscriptionPhase = z
     .object({
     id: ulid,
@@ -6207,6 +6708,11 @@ export const updateAppPathParams = z.object({
 });
 export const updateAppBody = updateAppRequest;
 export const updateAppResponse = app;
+export const executeAppActionPathParams = z.object({
+    appId: ulid,
+});
+export const executeAppActionBody = appActionRequest;
+export const executeAppActionResponse = app;
 export const listAppCatalogQueryParams = z.object({
     page: z
         .object({
@@ -6667,17 +7173,81 @@ export const getNotificationChannelResponse = notificationChannel;
 export const updateNotificationChannelPathParams = z.object({
     notificationChannelId: ulid,
 });
-export const updateNotificationChannelBody = updateNotificationChannelRequest;
+export const updateNotificationChannelBody = updateBillingNotificationChannelRequest;
 export const updateNotificationChannelResponse = notificationChannel;
 export const deleteNotificationChannelPathParams = z.object({
     notificationChannelId: ulid,
 });
-export const labelsWire = z
-    .record(z.string(), z.string())
-    .describe('Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\\_".');
-export const currencyCodeWire = z
-    .string()
-    .min(3)
+export const listNotificationRulesQueryParams = z.object({
+    page: z
+        .object({
+        size: z.coerce
+            .number()
+            .int()
+            .optional()
+            .describe('The number of items to include per page.'),
+        number: z.coerce.number().int().optional().describe('The page number.'),
+    })
+        .optional()
+        .describe('Determines which page of the collection to retrieve.'),
+    sort: sortQuery.optional(),
+    filter: listNotificationRulesParamsFilter.optional(),
+});
+export const listNotificationRulesResponse = z.object({
+    data: z.array(notificationRule),
+    meta: paginatedMeta,
+});
+export const createNotificationRuleBody = notificationRuleRequest;
+export const createNotificationRuleResponse = notificationRule;
+export const getNotificationRulePathParams = z.object({
+    notificationRuleId: ulid,
+});
+export const getNotificationRuleResponse = notificationRule;
+export const updateNotificationRulePathParams = z.object({
+    notificationRuleId: ulid,
+});
+export const updateNotificationRuleBody = notificationRuleRequest;
+export const updateNotificationRuleResponse = notificationRule;
+export const deleteNotificationRulePathParams = z.object({
+    notificationRuleId: ulid,
+});
+export const testNotificationRulePathParams = z.object({
+    notificationRuleId: ulid,
+});
+export const testNotificationRuleResponse = notificationEvent;
+export const listNotificationEventsQueryParams = z.object({
+    page: z
+        .object({
+        size: z.coerce
+            .number()
+            .int()
+            .optional()
+            .describe('The number of items to include per page.'),
+        number: z.coerce.number().int().optional().describe('The page number.'),
+    })
+        .optional()
+        .describe('Determines which page of the collection to retrieve.'),
+    sort: sortQuery.optional(),
+    filter: listNotificationEventsParamsFilter.optional(),
+});
+export const listNotificationEventsResponse = z.object({
+    data: z.array(notificationEvent),
+    meta: paginatedMeta,
+});
+export const getNotificationEventPathParams = z.object({
+    notificationEventId: ulid,
+});
+export const getNotificationEventResponse = notificationEvent;
+export const resendNotificationEventPathParams = z.object({
+    notificationEventId: ulid,
+});
+export const resendNotificationEventBody = resendBillingNotificationEventRequest;
+export const labelsWire = z
+    .record(z.string(), z.string())
+    .describe('Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\\_".');
+export const currencyCodeWire = z
+    .string()
+    .min(3)
     .max(3)
     .regex(new RegExp('^[A-Z]{3}$'))
     .describe('Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.');
@@ -7099,7 +7669,7 @@ export const createVersionFilterWire = z
         .lte(2147483647)
         .optional()
         .describe('Match this exact version.'),
-    in: z
+    oeq: z
         .array(z.number().int().gte(-2147483648).lte(2147483647))
         .min(1)
         .max(100)
@@ -7133,7 +7703,7 @@ export const versionFilterWire = z
         .lte(2147483647)
         .optional()
         .describe('Match this exact version.'),
-    in: z
+    oeq: z
         .array(z.number().int().gte(-2147483648).lte(2147483647))
         .min(1)
         .max(100)
@@ -7391,9 +7961,19 @@ export const appInstallMethodsWire = z
 export const appStatusWire = z
     .enum(['ready', 'unauthorized'])
     .describe('Connection status of an installed app.');
+export const appActionTypeWire = z
+    .enum(['reconcile_webhook_events'])
+    .describe('App action type.');
 export const updateLabelsWire = z
     .record(z.string(), z.string())
     .describe('Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\\_".');
+export const appReconcileWebhookEventsActionRequestWire = z
+    .strictObject({
+    action_type: z
+        .literal('reconcile_webhook_events')
+        .describe('The action to execute.'),
+})
+    .describe("Request to reconcile the app's webhook events with the latest supported event set.");
 export const installAppStripeWithApiKeyWire = z
     .strictObject({
     type: z.literal('stripe').describe('Type of the app.'),
@@ -7419,9 +7999,9 @@ export const installAppExternalInvoicingWire = z
     name: z.string().describe('Name of the app.'),
     create_billing_profile: z
         .boolean()
-        .describe('If true, a billing profile will be created for the app. The Stripe app will be also set as the default billing profile if the current default is a Sandbox app.'),
+        .describe('If true, creates the Auto Collection preset with an OpenMeter supplier in the US (postal code 94114), without replacing the default profile.'),
 })
-    .describe('Base model for installing an app from the catalog.');
+    .describe('Model for installing an External Invoicing app from the catalog.');
 export const workflowCollectionAlignmentSubscriptionWire = z
     .strictObject({
     type: z.literal('subscription').describe('The type of alignment.'),
@@ -7571,6 +8151,43 @@ export const booleanFieldFilterWire = z
 export const notificationChannelTypeWire = z
     .enum(['webhook'])
     .describe('The type of a notification channel. Currently the only supported channel type is `webhook`; the domain model anticipates additional channel types (e.g. email, Slack) in the future, so this is modeled as an enum rather than a boolean/constant even though it has a single member today.');
+export const notificationBalanceThresholdTypeWire = z
+    .enum(['balance_value', 'usage_percentage', 'usage_value'])
+    .describe('What a balance threshold is measured against.');
+export const notificationEventTypeWire = z
+    .enum([
+    'entitlements.balance.threshold',
+    'entitlements.reset',
+    'invoice.created',
+    'invoice.updated',
+])
+    .describe('The type of a notification event. It determines which payload variant the event carries.');
+export const notificationEventDeliveryStateWire = z
+    .enum(['success', 'failed', 'sending', 'pending', 'resending'])
+    .describe('The delivery state of a notification event for a single channel.');
+export const notificationEventDeliveryAttemptResponseWire = z
+    .strictObject({
+    status_code: z
+        .number()
+        .int()
+        .gte(-2147483648)
+        .lte(2147483647)
+        .optional()
+        .describe('The HTTP status code returned by the recipient. Absent when no response was received.'),
+    body: z
+        .string()
+        .describe('The response body returned by the recipient. Empty when no body was received.'),
+    duration_ms: z.coerce
+        .bigint()
+        .gte(-9223372036854775808n)
+        .lte(9223372036854775807n)
+        .describe('How long the delivery attempt took, in milliseconds.'),
+    url: z
+        .string()
+        .optional()
+        .describe('The URL the event was delivered to. Only set for webhook channels.'),
+})
+    .describe('The response the recipient returned for a delivery attempt. For webhook channels this is the HTTP response.');
 export const queryFilterIntegerWire = z
     .strictObject({
     eq: z
@@ -8283,6 +8900,31 @@ export const updateResourceReferenceWire = z
     id: ulidWire,
 })
     .describe('TaxCode reference.');
+export const notificationChannelReferenceWire = z
+    .strictObject({
+    id: ulidWire,
+})
+    .describe('NotificationChannel reference.');
+export const notificationEventFeatureReferenceWire = z
+    .strictObject({
+    id: ulidWire,
+    key: z.string().describe('The immutable key of the feature.'),
+})
+    .describe('A reference to the feature of an entitlement notification event.');
+export const notificationEventInvoiceReferenceWire = z
+    .strictObject({
+    id: ulidWire,
+    number: z.string().describe('The human-readable invoice number.'),
+})
+    .describe('A reference to the invoice of an invoice notification event.');
+export const resendBillingNotificationEventRequestWire = z
+    .strictObject({
+    channels: z
+        .array(ulidWire)
+        .optional()
+        .describe('The channels to resend the event to. When omitted or empty, the event is resent to every enabled channel of the rule. Channels not targeted by the rule or disabled are rejected.'),
+})
+    .describe('Request body for resending a notification event.');
 export const billingCustomerReferenceWire = z
     .strictObject({
     id: ulidWire,
@@ -9125,6 +9767,14 @@ export const appCapabilityWire = z
     description: z.string().describe('Description of the capability.'),
 })
     .describe('App capability describes a function that an App can perform.');
+export const appActionWire = z
+    .strictObject({
+    type: appActionTypeWire,
+    description: z
+        .string()
+        .describe('Human readable explanation of why the action is needed.'),
+})
+    .describe('An action the operator should take on an installed app.');
 export const updateAppStripeRequestWire = z
     .strictObject({
     name: z
@@ -9183,6 +9833,11 @@ export const updateAppExternalInvoicingRequestWire = z
         .describe('Enable issuing synchronization hook. When enabled, invoices will pause at the issuing state and wait for the integration to call the issuing synchronized endpoint before progressing to the issued state. This ensures the external invoicing system has successfully created and finalized the invoice before it is marked as issued. When disabled, invoices automatically progress through the issuing state and are immediately marked as issued.'),
 })
     .describe('AppExternalInvoicing update request.');
+export const appActionRequestWire = z
+    .discriminatedUnion('action_type', [
+    appReconcileWebhookEventsActionRequestWire,
+])
+    .describe('Request to execute an operator action on an installed app.');
 export const installAppRequestWire = z
     .discriminatedUnion('type', [
     installAppStripeWithApiKeyWire,
@@ -9344,7 +9999,7 @@ export const createNotificationChannelRequestWire = z
         .describe('Secret used to sign outgoing webhook payloads so recipients can verify their authenticity. If omitted on create, a secret is generated automatically by the delivery provider. This is a sensitive credential returned in responses (unlike most secrets) specifically so clients can retrieve a server-generated value and verify webhook signatures; handle it with the same care as any other credential.'),
 })
     .describe('NotificationChannel create request.');
-export const updateNotificationChannelRequestWire = z
+export const updateBillingNotificationChannelRequestWire = z
     .strictObject({
     name: z
         .string()
@@ -9370,6 +10025,26 @@ export const updateNotificationChannelRequestWire = z
         .describe('Secret used to sign outgoing webhook payloads so recipients can verify their authenticity. If omitted on create, a secret is generated automatically by the delivery provider. This is a sensitive credential returned in responses (unlike most secrets) specifically so clients can retrieve a server-generated value and verify webhook signatures; handle it with the same care as any other credential.'),
 })
     .describe("Request body for updating a notification channel. Updates replace the channel's mutable state rather than merging it: `type`, `name`, and `url` must always be provided, and omitting `disabled`, `labels`, or `custom_headers` resets them to their defaults (enabled, no labels, no custom headers). `signing_secret` is the one exception: omitting it keeps the channel's current signing secret instead of clearing the credential.");
+export const notificationBalanceThresholdWire = z
+    .strictObject({
+    type: notificationBalanceThresholdTypeWire,
+    value: z.number().describe('The threshold value.'),
+})
+    .describe('A balance threshold of a notification rule. Crossing it generates an `entitlements.balance.threshold` event.');
+export const notificationRuleReferenceWire = z
+    .strictObject({
+    id: ulidWire,
+    type: notificationEventTypeWire,
+    name: z.string().describe('The user-provided name of the rule.'),
+})
+    .describe('A reference to the notification rule that generated an event.');
+export const notificationEventDeliveryAttemptWire = z
+    .strictObject({
+    state: notificationEventDeliveryStateWire,
+    response: notificationEventDeliveryAttemptResponseWire,
+    timestamp: dateTimeWire,
+})
+    .describe('A single delivery attempt to a channel.');
 export const appCustomerDataWire = z
     .strictObject({
     stripe: appCustomerDataStripeWire
@@ -9781,6 +10456,163 @@ export const updateTaxCodeConfigWire = z
     code: updateResourceReferenceWire.optional(),
 })
     .describe('Tax configuration for a billable resource. Applies a tax code and tax behavior to the resulting invoice line items. When not set, the applicable default is used: the billing profile default tax configuration, then the organization default tax code.');
+export const notificationRuleEntitlementResetWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z
+        .literal('entitlements.reset')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    features: z
+        .array(featureReferenceWire)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('A rule that generates an event when an entitlement usage period is reset.');
+export const notificationRuleInvoiceCreatedWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z
+        .literal('invoice.created')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('A rule that generates an event when an invoice is created.');
+export const notificationRuleInvoiceUpdatedWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z
+        .literal('invoice.updated')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('A rule that generates an event when an invoice is updated.');
+export const notificationRuleEntitlementResetRequestWire = z
+    .strictObject({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    type: z
+        .literal('entitlements.reset')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    features: z
+        .array(featureReferenceWire)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('Request body for an entitlement reset rule.');
+export const notificationRuleInvoiceCreatedRequestWire = z
+    .strictObject({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    type: z
+        .literal('invoice.created')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('Request body for an invoice created rule.');
+export const notificationRuleInvoiceUpdatedRequestWire = z
+    .strictObject({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    type: z
+        .literal('invoice.updated')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+})
+    .describe('Request body for an invoice updated rule.');
+export const notificationEventInvoiceDataWire = z
+    .strictObject({
+    invoice: notificationEventInvoiceReferenceWire,
+    customer_id: ulidWire.optional(),
+    currency: currencyCodeWire,
+    status: z
+        .string()
+        .describe('The status of the invoice at the time the event was generated.'),
+    total: numericWire,
+})
+    .describe('The invoice an invoice notification event refers to.');
 export const listEventsParamsFilterWire = z
     .strictObject({
     id: stringFieldFilterWire.optional(),
@@ -9831,6 +10663,31 @@ export const listNotificationChannelsParamsFilterWire = z
     updated_at: dateTimeFieldFilterWire.optional(),
 })
     .describe('Filter options for listing notification channels.');
+export const listNotificationRulesParamsFilterWire = z
+    .strictObject({
+    id: ulidFieldFilterWire.optional(),
+    name: stringFieldFilterWire.optional(),
+    type: stringFieldFilterExactWire.optional(),
+    disabled: booleanFieldFilterWire.optional(),
+    created_at: dateTimeFieldFilterWire.optional(),
+    updated_at: dateTimeFieldFilterWire.optional(),
+    channel_id: ulidFieldFilterWire.optional(),
+})
+    .describe('Filter options for listing notification rules.');
+export const listNotificationEventsParamsFilterWire = z
+    .strictObject({
+    id: ulidFieldFilterWire.optional(),
+    type: stringFieldFilterExactWire.optional(),
+    created_at: dateTimeFieldFilterWire.optional(),
+    rule_id: ulidFieldFilterWire.optional(),
+    channel_id: ulidFieldFilterWire.optional(),
+    delivery_status: stringFieldFilterExactWire.optional(),
+    subject_key: stringFieldFilterExactWire.optional(),
+    subject_id: ulidFieldFilterWire.optional(),
+    feature_key: stringFieldFilterExactWire.optional(),
+    feature_id: ulidFieldFilterWire.optional(),
+})
+    .describe('Filter options for listing notification events.');
 export const resourceFiltersWire = z
     .strictObject({
     name: stringFieldFilterWire.optional(),
@@ -10250,6 +11107,7 @@ export const entitlementGrantWire = z
     .strictObject({
     id: ulidWire,
     entitlement_id: ulidWire,
+    customer_id: ulidWire.optional(),
     amount: numericWire,
     priority: z
         .number()
@@ -10524,6 +11382,84 @@ export const notificationChannelPagePaginatedResponseWire = z
     meta: paginatedMetaWire,
 })
     .describe('Page paginated response.');
+export const notificationRuleBalanceThresholdWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z
+        .literal('entitlements.balance.threshold')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    thresholds: z
+        .array(notificationBalanceThresholdWire)
+        .min(1)
+        .max(10)
+        .describe('The thresholds that generate an event when crossed.'),
+    features: z
+        .array(featureReferenceWire)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('A rule that generates an event when an entitlement balance crosses one of its thresholds.');
+export const notificationRuleBalanceThresholdRequestWire = z
+    .strictObject({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    labels: labelsWire.optional(),
+    type: z
+        .literal('entitlements.balance.threshold')
+        .describe('The type of event the rule generates. Immutable after creation.'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the rule is disabled. Disabled rules do not generate events.'),
+    channels: z
+        .array(notificationChannelReferenceWire)
+        .max(5)
+        .describe('The channels the rule delivers its events to. At least one and at most five channels are required. Responses omit channels that have since been disabled or deleted.'),
+    thresholds: z
+        .array(notificationBalanceThresholdWire)
+        .min(1)
+        .max(10)
+        .describe('The thresholds that generate an event when crossed.'),
+    features: z
+        .array(featureReferenceWire)
+        .optional()
+        .describe('The features the rule applies to. When omitted, the rule applies to every feature.'),
+})
+    .describe('Request body for a balance threshold rule.');
+export const notificationEventDeliveryStatusWire = z
+    .strictObject({
+    channel_id: ulidWire,
+    state: notificationEventDeliveryStateWire,
+    reason: z
+        .string()
+        .describe('The reason for the last state change. Empty for successful deliveries.'),
+    updated_at: dateTimeWire,
+    next_attempt: dateTimeWire.optional(),
+    attempts: z
+        .array(notificationEventDeliveryAttemptWire)
+        .describe('The delivery attempts made so far, most recent first.'),
+})
+    .describe('The delivery status of a notification event for one channel of the generating rule.');
 export const customerDataWire = z
     .strictObject({
     billing_profile: profileReferenceWire.optional(),
@@ -10567,6 +11503,29 @@ export const listCustomerEntitlementAccessResponseDataWire = z
         .describe('The list of entitlement access results.'),
 })
     .describe('List customer entitlement access response data.');
+export const notificationEventBalanceThresholdDataWire = z
+    .strictObject({
+    entitlement_id: ulidWire,
+    feature: notificationEventFeatureReferenceWire,
+    subject_key: z
+        .string()
+        .describe('The key of the subject the entitlement belongs to.'),
+    customer_id: ulidWire.optional(),
+    value: entitlementValueResultWire,
+    threshold: notificationBalanceThresholdWire,
+})
+    .describe('The entities and threshold a balance threshold event refers to.');
+export const notificationEventEntitlementDataWire = z
+    .strictObject({
+    entitlement_id: ulidWire,
+    feature: notificationEventFeatureReferenceWire,
+    subject_key: z
+        .string()
+        .describe('The key of the subject the entitlement belongs to.'),
+    customer_id: ulidWire.optional(),
+    value: entitlementValueResultWire,
+})
+    .describe('The entitlement, feature, and subject an entitlement notification event refers to.');
 export const priceGraduatedWire = z
     .strictObject({
     type: z.literal('graduated').describe('The type of the price.'),
@@ -10699,6 +11658,22 @@ export const planAddonPagePaginatedResponseWire = z
     meta: paginatedMetaWire,
 })
     .describe('Page paginated response.');
+export const notificationEventInvoiceCreatedPayloadWire = z
+    .strictObject({
+    id: ulidWire,
+    type: z.literal('invoice.created').describe('The type of the event.'),
+    timestamp: dateTimeWire,
+    data: notificationEventInvoiceDataWire,
+})
+    .describe('An invoice created notification event payload.');
+export const notificationEventInvoiceUpdatedPayloadWire = z
+    .strictObject({
+    id: ulidWire,
+    type: z.literal('invoice.updated').describe('The type of the event.'),
+    timestamp: dateTimeWire,
+    data: notificationEventInvoiceDataWire,
+})
+    .describe('An invoice updated notification event payload.');
 export const ingestedEventPaginatedResponseWire = z
     .strictObject({
     data: z.array(ingestedEventWire),
@@ -10916,6 +11891,10 @@ export const appStripeWire = z
     type: z.literal('stripe').describe('The app type.'),
     definition: appCatalogItemWire,
     status: appStatusWire,
+    actions: z
+        .array(appActionWire)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     account_id: z
         .string()
         .describe('The Stripe account ID associated with the connected Stripe account.'),
@@ -10947,6 +11926,10 @@ export const appSandboxWire = z
     type: z.literal('sandbox').describe('The app type.'),
     definition: appCatalogItemWire,
     status: appStatusWire,
+    actions: z
+        .array(appActionWire)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
 })
     .describe('Sandbox app can be used for testing billing features.');
 export const appExternalInvoicingWire = z
@@ -10969,6 +11952,10 @@ export const appExternalInvoicingWire = z
     type: z.literal('external_invoicing').describe('The app type.'),
     definition: appCatalogItemWire,
     status: appStatusWire,
+    actions: z
+        .array(appActionWire)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     enable_draft_sync_hook: z
         .boolean()
         .describe('Enable draft synchronization hook. When enabled, invoices will pause at the draft state and wait for the integration to call the draft synchronized endpoint before progressing to the issuing state. This allows the external system to validate and prepare the invoice data. When disabled, invoices automatically progress through the draft state based on the configured workflow timing.'),
@@ -11003,6 +11990,10 @@ export const installedAppStripeWire = z
     type: z.literal('stripe').describe('The app type.'),
     definition: appCatalogItemWire,
     status: appStatusWire,
+    actions: z
+        .array(appActionWire)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     account_id: z
         .string()
         .describe('The Stripe account ID associated with the connected Stripe account.'),
@@ -11037,6 +12028,10 @@ export const installedAppSandboxWire = z
     type: z.literal('sandbox').describe('The app type.'),
     definition: appCatalogItemWire,
     status: appStatusWire,
+    actions: z
+        .array(appActionWire)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     default_for_capability_types: z
         .array(appCapabilityTypeWire)
         .describe('Default capabilities of the installed app.'),
@@ -11062,6 +12057,10 @@ export const installedAppExternalInvoicingWire = z
     type: z.literal('external_invoicing').describe('The app type.'),
     definition: appCatalogItemWire,
     status: appStatusWire,
+    actions: z
+        .array(appActionWire)
+        .optional()
+        .describe('Actions the operator should take to bring the app up to date. Omitted when no action is required.'),
     enable_draft_sync_hook: z
         .boolean()
         .describe('Enable draft synchronization hook. When enabled, invoices will pause at the draft state and wait for the integration to call the draft synchronized endpoint before progressing to the issuing state. This allows the external system to validate and prepare the invoice data. When disabled, invoices automatically progress through the draft state based on the configured workflow timing.'),
@@ -11120,6 +12119,40 @@ export const entitlementAccessQueryResultWire = z
     updated_at: dateTimeWire,
 })
     .describe('Access evaluation result for a single resolved customer.');
+export const notificationRuleWire = z
+    .discriminatedUnion('type', [
+    notificationRuleBalanceThresholdWire,
+    notificationRuleEntitlementResetWire,
+    notificationRuleInvoiceCreatedWire,
+    notificationRuleInvoiceUpdatedWire,
+])
+    .describe('A notification rule selects the type of event to generate, the conditions specific to that type, and the channels to deliver the events to.');
+export const notificationRuleRequestWire = z
+    .discriminatedUnion('type', [
+    notificationRuleBalanceThresholdRequestWire,
+    notificationRuleEntitlementResetRequestWire,
+    notificationRuleInvoiceCreatedRequestWire,
+    notificationRuleInvoiceUpdatedRequestWire,
+])
+    .describe("Request body for creating or updating a notification rule. Updates replace the rule's mutable state: omitting `disabled`, `labels`, or `features` resets them to their defaults. The `type` must match the existing rule on update.");
+export const notificationEventBalanceThresholdPayloadWire = z
+    .strictObject({
+    id: ulidWire,
+    type: z
+        .literal('entitlements.balance.threshold')
+        .describe('The type of the event.'),
+    timestamp: dateTimeWire,
+    data: notificationEventBalanceThresholdDataWire,
+})
+    .describe('A balance threshold notification event payload.');
+export const notificationEventResetPayloadWire = z
+    .strictObject({
+    id: ulidWire,
+    type: z.literal('entitlements.reset').describe('The type of the event.'),
+    timestamp: dateTimeWire,
+    data: notificationEventEntitlementDataWire,
+})
+    .describe('An entitlement reset notification event payload.');
 export const priceWire = z
     .discriminatedUnion('type', [
     priceFreeWire,
@@ -11390,6 +12423,20 @@ export const entitlementAccessQueryResponseWire = z
     meta: cursorMetaWire,
 })
     .describe('Response of the entitlement access query.');
+export const notificationRulePagePaginatedResponseWire = z
+    .strictObject({
+    data: z.array(notificationRuleWire),
+    meta: paginatedMetaWire,
+})
+    .describe('Page paginated response.');
+export const notificationEventPayloadWire = z
+    .discriminatedUnion('type', [
+    notificationEventBalanceThresholdPayloadWire,
+    notificationEventResetPayloadWire,
+    notificationEventInvoiceCreatedPayloadWire,
+    notificationEventInvoiceUpdatedPayloadWire,
+])
+    .describe('The payload delivered to the channels, discriminated by the event type.');
 export const rateCardWire = z
     .strictObject({
     name: z
@@ -11529,6 +12576,18 @@ export const profileAppsWire = z
     payment: appWire,
 })
     .describe('Applications used by a billing profile.');
+export const notificationEventWire = z
+    .strictObject({
+    id: ulidWire,
+    type: notificationEventTypeWire,
+    created_at: dateTimeWire,
+    rule: notificationRuleReferenceWire,
+    delivery_status: z
+        .array(notificationEventDeliveryStatusWire)
+        .describe('The delivery status of the event, one entry per channel of the rule.'),
+    payload: notificationEventPayloadWire,
+})
+    .describe('A notification event records that a notification rule fired and tracks the delivery of its payload to each channel of the rule. Events are created by the system and cannot be modified.');
 export const subscriptionItemWire = z
     .strictObject({
     id: ulidWire,
@@ -11790,6 +12849,12 @@ export const chargeRealizationWire = z
         .describe('The detailed (rated) lines produced by the realization run. Requires the `realization.detailed_lines` expand.'),
 })
     .describe("A realization run of a charge. `totals` and `detailed_lines` are only populated with the `realization.totals` and `realization.detailed_lines` expands, respectively, since computing them requires re-deriving the run's rated breakdown. `invoice` is an ID reference unless the `realization.invoice` expand is used, which resolves it to the invoice header of the run's booked line: the invoice entity without its `lines` and without the `customer` snapshot (the charge itself already identifies the customer).");
+export const notificationEventPagePaginatedResponseWire = z
+    .strictObject({
+    data: z.array(notificationEventWire),
+    meta: paginatedMetaWire,
+})
+    .describe('Page paginated response.');
 export const subscriptionPhaseWire = z
     .strictObject({
     id: ulidWire,
@@ -12871,6 +13936,11 @@ export const updateAppPathParamsWire = z.object({
 });
 export const updateAppBodyWire = updateAppRequestWire;
 export const updateAppResponseWire = appWire;
+export const executeAppActionPathParamsWire = z.object({
+    appId: ulidWire,
+});
+export const executeAppActionBodyWire = appActionRequestWire;
+export const executeAppActionResponseWire = appWire;
 export const listAppCatalogQueryParamsWire = z.object({
     page: z
         .strictObject({
@@ -13361,8 +14431,78 @@ export const getNotificationChannelResponseWire = notificationChannelWire;
 export const updateNotificationChannelPathParamsWire = z.object({
     notificationChannelId: ulidWire,
 });
-export const updateNotificationChannelBodyWire = updateNotificationChannelRequestWire;
+export const updateNotificationChannelBodyWire = updateBillingNotificationChannelRequestWire;
 export const updateNotificationChannelResponseWire = notificationChannelWire;
 export const deleteNotificationChannelPathParamsWire = z.object({
     notificationChannelId: ulidWire,
 });
+export const listNotificationRulesQueryParamsWire = z.object({
+    page: z
+        .strictObject({
+        size: z.coerce
+            .number()
+            .int()
+            .optional()
+            .describe('The number of items to include per page.'),
+        number: z.coerce.number().int().optional().describe('The page number.'),
+    })
+        .optional()
+        .describe('Determines which page of the collection to retrieve.'),
+    sort: z
+        .string()
+        .optional()
+        .describe('Sort notification rules returned in the response. Supported sort attributes are: - `id` (default) - `type` - `created_at` - `updated_at` The `asc` suffix is optional as the default sort order is ascending. The `desc` suffix is used to specify a descending order.'),
+    filter: listNotificationRulesParamsFilterWire.optional(),
+});
+export const listNotificationRulesResponseWire = z.strictObject({
+    data: z.array(notificationRuleWire),
+    meta: paginatedMetaWire,
+});
+export const createNotificationRuleBodyWire = notificationRuleRequestWire;
+export const createNotificationRuleResponseWire = notificationRuleWire;
+export const getNotificationRulePathParamsWire = z.object({
+    notificationRuleId: ulidWire,
+});
+export const getNotificationRuleResponseWire = notificationRuleWire;
+export const updateNotificationRulePathParamsWire = z.object({
+    notificationRuleId: ulidWire,
+});
+export const updateNotificationRuleBodyWire = notificationRuleRequestWire;
+export const updateNotificationRuleResponseWire = notificationRuleWire;
+export const deleteNotificationRulePathParamsWire = z.object({
+    notificationRuleId: ulidWire,
+});
+export const testNotificationRulePathParamsWire = z.object({
+    notificationRuleId: ulidWire,
+});
+export const testNotificationRuleResponseWire = notificationEventWire;
+export const listNotificationEventsQueryParamsWire = z.object({
+    page: z
+        .strictObject({
+        size: z.coerce
+            .number()
+            .int()
+            .optional()
+            .describe('The number of items to include per page.'),
+        number: z.coerce.number().int().optional().describe('The page number.'),
+    })
+        .optional()
+        .describe('Determines which page of the collection to retrieve.'),
+    sort: z
+        .string()
+        .optional()
+        .describe('Sort notification events returned in the response. Supported sort attributes are: - `created_at` (default) - `id` - `type` The `asc` suffix is optional as the default sort order is ascending. The `desc` suffix is used to specify a descending order. Without a `sort` parameter, events are returned newest first.'),
+    filter: listNotificationEventsParamsFilterWire.optional(),
+});
+export const listNotificationEventsResponseWire = z.strictObject({
+    data: z.array(notificationEventWire),
+    meta: paginatedMetaWire,
+});
+export const getNotificationEventPathParamsWire = z.object({
+    notificationEventId: ulidWire,
+});
+export const getNotificationEventResponseWire = notificationEventWire;
+export const resendNotificationEventPathParamsWire = z.object({
+    notificationEventId: ulidWire,
+});
+export const resendNotificationEventBodyWire = resendBillingNotificationEventRequestWire;