@aventurevc/api-schemas 0.8.343 → 0.8.344
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -40,6 +40,7 @@ export declare const ProblemDetailSchema: z.ZodObject<{
|
|
|
40
40
|
billing_additional_usage_cap_reached: "billing_additional_usage_cap_reached";
|
|
41
41
|
billing_allowance_exhausted: "billing_allowance_exhausted";
|
|
42
42
|
billing_credit_checkout_closed: "billing_credit_checkout_closed";
|
|
43
|
+
billing_plan_change_required: "billing_plan_change_required";
|
|
43
44
|
callback_challenge_failed: "callback_challenge_failed";
|
|
44
45
|
callback_connection_refused: "callback_connection_refused";
|
|
45
46
|
callback_http_4xx: "callback_http_4xx";
|
|
@@ -19,7 +19,7 @@ export const ProblemDetailSchema = z.object({
|
|
|
19
19
|
/** Which monthly allowance a BILLING_ALLOWANCE refusal exhausted. */
|
|
20
20
|
allowanceType: ResearchAllowanceTypeSchema.nullish(),
|
|
21
21
|
circuitBreaker: z.string().nullish(),
|
|
22
|
-
/** Machine-readable secondary code on ProblemDetail.code. Agents should branch on this value when the HTTP status alone does not identify the recovery path. Many codes describe server-side conditions a caller cannot fix: surface
|
|
22
|
+
/** Machine-readable secondary code on ProblemDetail.code. Agents should branch on this value when the HTTP status alone does not identify the recovery path. Many codes describe server-side conditions a caller cannot fix: surface them and stop. */
|
|
23
23
|
code: z
|
|
24
24
|
.union([
|
|
25
25
|
z.enum([
|
|
@@ -31,25 +31,27 @@ export const ProblemDetailSchema = z.object({
|
|
|
31
31
|
"rateLimited",
|
|
32
32
|
/** Request was throttled. Agent action: wait at least retryAfterSeconds (also in the Retry-After header), then increase the delay exponentially on repeated 429s. When resetAt is present, wait until that time instead of retrying the exhausted monthly allowance. */
|
|
33
33
|
"rate_limited",
|
|
34
|
-
/** Caller is authenticated but the subscription on their account does not include this operation. Agent action: surface ProblemDetail.detail explaining the subscription requirement and stop
|
|
34
|
+
/** Caller is authenticated but the subscription on their account does not include this operation. Agent action: surface ProblemDetail.detail explaining the subscription requirement and stop; never retry until the account changes plan. */
|
|
35
35
|
"subscription_required",
|
|
36
|
-
/** Caller's subscription was canceled or its first payment expired unpaid, so it no longer includes this operation. Agent action: surface ProblemDetail.detail and stop; the account must subscribe again through the resolution's Checkout endpoint
|
|
36
|
+
/** Caller's subscription was canceled or its first payment expired unpaid, so it no longer includes this operation. Agent action: surface ProblemDetail.detail and stop; the account must subscribe again through the resolution's Checkout endpoint. */
|
|
37
37
|
"subscription_canceled",
|
|
38
|
-
/** Caller's subscription has a failed or unfinished payment, so it
|
|
38
|
+
/** Caller's subscription has a failed or unfinished payment, so it excludes this operation. Agent action: surface ProblemDetail.detail and stop; the account must update its payment method through the resolution's Billing Portal endpoint. */
|
|
39
39
|
"subscription_past_due",
|
|
40
40
|
/** Caller's subscription is paused, so it does not include this operation. Agent action: surface ProblemDetail.detail and stop; the account must add a payment method through the resolution's Billing Portal endpoint, then resume with PATCH /v1/billing/subscription and paused false. */
|
|
41
41
|
"subscription_paused",
|
|
42
|
-
/** The caller's metered allowance for this operation is spent for the current period. Agent action: stop and report ProblemDetail.allowanceType, limit, used, remaining, and resetAt
|
|
42
|
+
/** The caller's metered allowance for this operation is spent for the current period. Agent action: stop and report ProblemDetail.allowanceType, limit, used, remaining, and resetAt, when the meter refills (typically weeks away). Do not retry inside the period even though the status is 429. */
|
|
43
43
|
"billing_allowance_exhausted",
|
|
44
44
|
/** 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. */
|
|
45
45
|
"billing_additional_usage_cap_reached",
|
|
46
46
|
/** 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. */
|
|
47
47
|
"billing_credit_checkout_closed",
|
|
48
|
+
/** Checkout refused: the account already has a continuing Stripe subscription. Agent action: change its plan with POST /v1/billing/plan-changes; never retry Checkout. */
|
|
49
|
+
"billing_plan_change_required",
|
|
48
50
|
/** 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. */
|
|
49
51
|
"account_exists",
|
|
50
52
|
/** 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. */
|
|
51
53
|
"origin_detail_capacity",
|
|
52
|
-
/** Detail-origin cold-miss scheduler rejected work because this instance is shutting down for a redeploy. Agent action: retry shortly; the platform routes the retry to a healthy instance. This is deploy-window noise, not
|
|
54
|
+
/** Detail-origin cold-miss scheduler rejected work because this instance is shutting down for a redeploy. Agent action: retry shortly; the platform routes the retry to a healthy instance. This is deploy-window noise, not backend saturation. */
|
|
53
55
|
"origin_detail_shutdown",
|
|
54
56
|
/** A read overran its database query budget and was shed before answering, so the identical request can be replayed. Agent action: retry after a short backoff; the shed is expected and files no incident. */
|
|
55
57
|
"query_deadline_shed",
|