@typeship-ax/mcp 0.20.0 → 0.21.0

package/api.md

@@ -1,6 +1,6 @@
 # typeship — MCP reference
 
-API version 1.0.0. Package version 0.20.0. Generated by typeship.
+API version 1.0.0. Package version 0.21.0. Generated by typeship.
 
 This package exposes `search_docs`, `read_docs`, and `execute`. Find an operation, read its input schema, then pass its name and arguments to `execute`. The operation names below are not directly callable tools in this mode. Destructive operations require `confirm: true`.
 
@@ -132,7 +132,7 @@ Input schema:
           "type": "string"
         },
         "spec_digest": {
-          "description": "SHA-256 hex digest of the Spec the SDK was generated from. Must match the resolved Spec, or the request fails with spec_error.",
+          "description": "SHA-256 hex digest of the Spec the SDK was generated from. Must match the resolved Spec, or the request fails with spec_invalid.",
           "pattern": "^[a-f0-9]{64}$",
           "type": "string"
         },
@@ -1073,14 +1073,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "fields": {
       "type": "array",
@@ -2380,7 +2380,7 @@ Delete a project
 
 Safety: **destructive** · Authentication: **required**
 
-A `502` response means the Project was not deleted because its release pull requests could not be retired. Retry deletion to finish retiring the remaining reviews. Repeating a completed deletion returns `404`.
+A `502 repository_unavailable` means the Project was not deleted because its release pull requests could not be retired. Retry deletion to finish retiring the remaining reviews. Repeating a completed deletion returns `404`.
 See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag and If-Match.
 
 Input schema:
@@ -2479,7 +2479,7 @@ With auto_generate enabled, changing shared config queues a Generation for each
 Omitting If-Match applies the update to the current resource; with If-Match, a stale ETag returns 412 precondition_failed without saving.
 
 A `409 target_busy` means a Target is publishing. Retrieve the Project, wait for publishing to finish, reconcile your update, and retry.
-A `502` response means the Project was saved, but an obsolete release pull request could not be retired. Retrieve the Project and retry the same update to finish retiring reviews if that update is still desired.
+A `502 follow_up_failed` means the Project was saved, but an obsolete release pull request could not be retired. Retrieve the Project and retry the same update to finish retiring reviews if that update is still desired.
 See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag and If-Match.
 
 Input schema:
@@ -3019,7 +3019,7 @@ Start generation for active Targets
 
 Safety: **write** · Authentication: **required**
 
-Queues one Generation per active Target and returns their IDs. Retrieve each Generation until its status moves from `queued` to `running` and then `completed` or `failed`. `completed` means generated files are saved; check Delivery and Draft status separately for repository delivery and pull requests. A Target already queued or running is returned without starting another Generation. A matching Idempotency-Key replay returns the same Generations with their current statuses.
+Queues one Generation per active Target and returns their IDs. Retrieve each Generation until its status moves from `queued` to `running` and then `completed` or `failed`. `completed` means generated files are saved; check Delivery and Draft status separately for repository delivery and pull requests. A Target already queued or running is returned without starting another Generation. A `409 targets_inactive` means the Project has no active Target to generate. A matching Idempotency-Key replay returns the same Generations with their current statuses.
 
 If the package already matches a destination and no Draft is open, delivery creates no commit, branch, or pull request. An existing Draft stays open. Automatic generation uses the same workflow.
 
@@ -4242,7 +4242,7 @@ Refresh a Spec from its configured source
 
 Safety: **write** · Authentication: **required**
 
-Fetches the configured source now and creates a new Spec Revision only when its content changes. Diagnostics then reads that revision. If automatic generation is enabled, refresh queues generation for active Targets even when the source is unchanged.
+Fetches the configured source now and creates a new Spec Revision only when its content changes. Diagnostics then reads that revision. If automatic generation is enabled, refresh queues generation for active Targets even when the source is unchanged. A `502 follow_up_failed` means the new Spec Revision was recorded but generation could not be queued.
 
 Input schema:
 
@@ -4604,14 +4604,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "spec_id": {
       "description": "Unique identifier for a project's logical API Spec.",
@@ -5291,14 +5291,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "fields": {
       "type": "array",
@@ -5447,14 +5447,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "project_id": {
       "description": "Unique identifier for a project. Accepts an ID or an exact name (resolved via projects_list). IDs come from projects_list.",
@@ -6992,7 +6992,7 @@ Omitting If-Match applies the update to the current resource; with If-Match, a s
 Select the next version through PATCH /drafts/{draft_id} on the Target's draft_id.
 
 A `409 target_busy` means the Target is publishing; wait for it to finish. A `409 delivery_conflict` means another Target owns the requested repository tree; retrieve both Targets, choose a free destination, and retry.
-A `502` response means the update was saved, but retiring an obsolete review or regenerating the Target failed. Retrieve the Target and follow the error's retryable and suggested_action fields.
+A `502 follow_up_failed` means the update was saved, but retiring an obsolete review or regenerating the Target failed. Retrieve the Target and follow the error's retryable and suggested_action fields.
 See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag and If-Match.
 
 Input schema:
@@ -8202,14 +8202,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "target_id": {
       "description": "Stable identifier for one configured generated product. Accepts an ID or an exact name (resolved via targets_list). IDs come from targets_list.",
@@ -9572,14 +9572,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "fields": {
       "type": "array",
@@ -10849,14 +10849,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "target_id": {
       "description": "Stable identifier for one configured generated product. Accepts an ID or an exact name (resolved via targets_list). IDs come from targets_list.",
@@ -11659,7 +11659,7 @@ Safety: **write** · Authentication: **required**
 
 Retries publishing the specified release through its repository workflow. Uses that release's version and accepted commit, even if a newer Draft or release exists.
 
-A `502` response means the repository publishing workflow could not be dispatched.
+A `502 repository_unavailable` means the repository publishing workflow could not be dispatched, and nothing was changed.
 
 Input schema:
 
@@ -12075,14 +12075,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "target_id": {
       "description": "Stable identifier for one configured generated product. Accepts an ID or an exact name (resolved via targets_list). IDs come from targets_list.",
@@ -12323,7 +12323,7 @@ Get a Delivery
 
 Safety: **read** · Authentication: **required**
 
-Returns the configured repository or hosted MCP Delivery for a Target. A Delivery in another organization returns 404 not_found.
+Returns the configured repository or hosted MCP Delivery for a Target. A Delivery in another organization returns 404 resource_not_found.
 
 Input schema:
 
@@ -12563,14 +12563,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "release_id": {
       "examples": [
@@ -12681,36 +12681,48 @@ Output schema:
               "properties": {
                 "type": {
                   "enum": [
-                    "request_error",
-                    "authentication_error",
-                    "authorization_error",
-                    "plan_error",
-                    "source_error",
-                    "rate_limit_error",
-                    "api_error"
+                    "request",
+                    "auth",
+                    "idempotency",
+                    "rate_limit",
+                    "organization",
+                    "source",
+                    "api"
                   ],
-                  "description": "Stable category for deciding how to handle the error.",
+                  "description": "Who can resolve the error. request: change the request. auth: fix the credential or its grant. idempotency: change or wait on the Idempotency-Key. rate_limit: wait before retrying. organization: the organization's plan must change. source: a system you own failed, such as the Spec URL, repository, or package registry. api: Typeship failed.",
                   "type": "string"
                 },
                 "code": {
                   "enum": [
-                    "invalid_request",
+                    "input_invalid",
+                    "query_param_invalid",
+                    "cursor_invalid",
+                    "method_not_allowed",
+                    "resource_not_found",
+                    "idempotency_key_invalid",
                     "idempotency_key_reused",
-                    "unauthorized",
+                    "idempotency_key_in_use",
+                    "auth_required",
+                    "api_key_invalid",
+                    "token_invalid",
                     "organization_required",
                     "insufficient_scope",
-                    "forbidden",
-                    "not_found",
-                    "method_not_allowed",
-                    "spec_error",
-                    "fetch_error",
+                    "role_insufficient",
+                    "rate_limit_exceeded",
+                    "plan_limit_reached",
+                    "spec_invalid",
+                    "spec_too_large",
+                    "spec_unreachable",
                     "repository_provider_unsupported",
+                    "repository_disconnected",
+                    "repository_unavailable",
                     "target_busy",
+                    "targets_inactive",
                     "no_draft",
                     "draft_merged",
                     "resource_changed",
-                    "invalid_version",
                     "precondition_failed",
+                    "version_invalid",
                     "version_occupied",
                     "version_too_low",
                     "target_already_released",
@@ -12718,15 +12730,12 @@ Output schema:
                     "publication_disabled",
                     "publication_not_retryable",
                     "publication_recovery_unavailable",
-                    "publication_dispatch_failed",
-                    "repository_disconnected",
-                    "regeneration_failed",
+                    "publication_failed",
                     "delivery_conflict",
                     "resource_has_dependencies",
-                    "plan_limit_reached",
-                    "payload_too_large",
-                    "rate_limited",
-                    "internal_error",
+                    "customization_conflict",
+                    "history_recovery_required",
+                    "checks_unavailable",
                     "dependency_missing",
                     "dependency_not_found",
                     "dependency_self",
@@ -12738,10 +12747,9 @@ Output schema:
                     "dependency_module_path_missing",
                     "dependency_unreleased",
                     "dependency_revision_mismatch",
-                    "publication_failed",
-                    "customization_conflict",
-                    "history_recovery_required",
-                    "checks_unavailable"
+                    "regeneration_failed",
+                    "follow_up_failed",
+                    "api_error"
                   ],
                   "description": "Stable programmatic identifier. Do not branch on message.",
                   "type": "string"
@@ -12861,7 +12869,7 @@ Get publishing status
 
 Safety: **read** · Authentication: **required**
 
-Returns the registry publishing status for a release. A status in another organization returns 404 not_found.
+Returns the registry publishing status for a release. A status in another organization returns 404 resource_not_found.
 
 Input schema:
 
@@ -12977,36 +12985,48 @@ Output schema:
         "properties": {
           "type": {
             "enum": [
-              "request_error",
-              "authentication_error",
-              "authorization_error",
-              "plan_error",
-              "source_error",
-              "rate_limit_error",
-              "api_error"
+              "request",
+              "auth",
+              "idempotency",
+              "rate_limit",
+              "organization",
+              "source",
+              "api"
             ],
-            "description": "Stable category for deciding how to handle the error.",
+            "description": "Who can resolve the error. request: change the request. auth: fix the credential or its grant. idempotency: change or wait on the Idempotency-Key. rate_limit: wait before retrying. organization: the organization's plan must change. source: a system you own failed, such as the Spec URL, repository, or package registry. api: Typeship failed.",
             "type": "string"
           },
           "code": {
             "enum": [
-              "invalid_request",
+              "input_invalid",
+              "query_param_invalid",
+              "cursor_invalid",
+              "method_not_allowed",
+              "resource_not_found",
+              "idempotency_key_invalid",
               "idempotency_key_reused",
-              "unauthorized",
+              "idempotency_key_in_use",
+              "auth_required",
+              "api_key_invalid",
+              "token_invalid",
               "organization_required",
               "insufficient_scope",
-              "forbidden",
-              "not_found",
-              "method_not_allowed",
-              "spec_error",
-              "fetch_error",
+              "role_insufficient",
+              "rate_limit_exceeded",
+              "plan_limit_reached",
+              "spec_invalid",
+              "spec_too_large",
+              "spec_unreachable",
               "repository_provider_unsupported",
+              "repository_disconnected",
+              "repository_unavailable",
               "target_busy",
+              "targets_inactive",
               "no_draft",
               "draft_merged",
               "resource_changed",
-              "invalid_version",
               "precondition_failed",
+              "version_invalid",
               "version_occupied",
               "version_too_low",
               "target_already_released",
@@ -13014,15 +13034,12 @@ Output schema:
               "publication_disabled",
               "publication_not_retryable",
               "publication_recovery_unavailable",
-              "publication_dispatch_failed",
-              "repository_disconnected",
-              "regeneration_failed",
+              "publication_failed",
               "delivery_conflict",
               "resource_has_dependencies",
-              "plan_limit_reached",
-              "payload_too_large",
-              "rate_limited",
-              "internal_error",
+              "customization_conflict",
+              "history_recovery_required",
+              "checks_unavailable",
               "dependency_missing",
               "dependency_not_found",
               "dependency_self",
@@ -13034,10 +13051,9 @@ Output schema:
               "dependency_module_path_missing",
               "dependency_unreleased",
               "dependency_revision_mismatch",
-              "publication_failed",
-              "customization_conflict",
-              "history_recovery_required",
-              "checks_unavailable"
+              "regeneration_failed",
+              "follow_up_failed",
+              "api_error"
             ],
             "description": "Stable programmatic identifier. Do not branch on message.",
             "type": "string"
@@ -13159,14 +13175,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "project_id": {
       "description": "Unique identifier for a project. Accepts an ID or an exact name (resolved via projects_list). IDs come from projects_list.",
@@ -13400,36 +13416,48 @@ Output schema:
               "properties": {
                 "type": {
                   "enum": [
-                    "request_error",
-                    "authentication_error",
-                    "authorization_error",
-                    "plan_error",
-                    "source_error",
-                    "rate_limit_error",
-                    "api_error"
+                    "request",
+                    "auth",
+                    "idempotency",
+                    "rate_limit",
+                    "organization",
+                    "source",
+                    "api"
                   ],
-                  "description": "Stable category for deciding how to handle the error.",
+                  "description": "Who can resolve the error.",
                   "type": "string"
                 },
                 "code": {
                   "enum": [
-                    "invalid_request",
+                    "input_invalid",
+                    "query_param_invalid",
+                    "cursor_invalid",
+                    "method_not_allowed",
+                    "resource_not_found",
+                    "idempotency_key_invalid",
                     "idempotency_key_reused",
-                    "unauthorized",
+                    "idempotency_key_in_use",
+                    "auth_required",
+                    "api_key_invalid",
+                    "token_invalid",
                     "organization_required",
                     "insufficient_scope",
-                    "forbidden",
-                    "not_found",
-                    "method_not_allowed",
-                    "spec_error",
-                    "fetch_error",
+                    "role_insufficient",
+                    "rate_limit_exceeded",
+                    "plan_limit_reached",
+                    "spec_invalid",
+                    "spec_too_large",
+                    "spec_unreachable",
                     "repository_provider_unsupported",
+                    "repository_disconnected",
+                    "repository_unavailable",
                     "target_busy",
+                    "targets_inactive",
                     "no_draft",
                     "draft_merged",
                     "resource_changed",
-                    "invalid_version",
                     "precondition_failed",
+                    "version_invalid",
                     "version_occupied",
                     "version_too_low",
                     "target_already_released",
@@ -13437,15 +13465,12 @@ Output schema:
                     "publication_disabled",
                     "publication_not_retryable",
                     "publication_recovery_unavailable",
-                    "publication_dispatch_failed",
-                    "repository_disconnected",
-                    "regeneration_failed",
+                    "publication_failed",
                     "delivery_conflict",
                     "resource_has_dependencies",
-                    "plan_limit_reached",
-                    "payload_too_large",
-                    "rate_limited",
-                    "internal_error",
+                    "customization_conflict",
+                    "history_recovery_required",
+                    "checks_unavailable",
                     "dependency_missing",
                     "dependency_not_found",
                     "dependency_self",
@@ -13457,10 +13482,9 @@ Output schema:
                     "dependency_module_path_missing",
                     "dependency_unreleased",
                     "dependency_revision_mismatch",
-                    "publication_failed",
-                    "customization_conflict",
-                    "history_recovery_required",
-                    "checks_unavailable"
+                    "regeneration_failed",
+                    "follow_up_failed",
+                    "api_error"
                   ],
                   "description": "Stable programmatic identifier.",
                   "type": "string"
@@ -13790,36 +13814,48 @@ Output schema:
         "properties": {
           "type": {
             "enum": [
-              "request_error",
-              "authentication_error",
-              "authorization_error",
-              "plan_error",
-              "source_error",
-              "rate_limit_error",
-              "api_error"
+              "request",
+              "auth",
+              "idempotency",
+              "rate_limit",
+              "organization",
+              "source",
+              "api"
             ],
-            "description": "Stable category for deciding how to handle the error.",
+            "description": "Who can resolve the error.",
             "type": "string"
           },
           "code": {
             "enum": [
-              "invalid_request",
+              "input_invalid",
+              "query_param_invalid",
+              "cursor_invalid",
+              "method_not_allowed",
+              "resource_not_found",
+              "idempotency_key_invalid",
               "idempotency_key_reused",
-              "unauthorized",
+              "idempotency_key_in_use",
+              "auth_required",
+              "api_key_invalid",
+              "token_invalid",
               "organization_required",
               "insufficient_scope",
-              "forbidden",
-              "not_found",
-              "method_not_allowed",
-              "spec_error",
-              "fetch_error",
+              "role_insufficient",
+              "rate_limit_exceeded",
+              "plan_limit_reached",
+              "spec_invalid",
+              "spec_too_large",
+              "spec_unreachable",
               "repository_provider_unsupported",
+              "repository_disconnected",
+              "repository_unavailable",
               "target_busy",
+              "targets_inactive",
               "no_draft",
               "draft_merged",
               "resource_changed",
-              "invalid_version",
               "precondition_failed",
+              "version_invalid",
               "version_occupied",
               "version_too_low",
               "target_already_released",
@@ -13827,15 +13863,12 @@ Output schema:
               "publication_disabled",
               "publication_not_retryable",
               "publication_recovery_unavailable",
-              "publication_dispatch_failed",
-              "repository_disconnected",
-              "regeneration_failed",
+              "publication_failed",
               "delivery_conflict",
               "resource_has_dependencies",
-              "plan_limit_reached",
-              "payload_too_large",
-              "rate_limited",
-              "internal_error",
+              "customization_conflict",
+              "history_recovery_required",
+              "checks_unavailable",
               "dependency_missing",
               "dependency_not_found",
               "dependency_self",
@@ -13847,10 +13880,9 @@ Output schema:
               "dependency_module_path_missing",
               "dependency_unreleased",
               "dependency_revision_mismatch",
-              "publication_failed",
-              "customization_conflict",
-              "history_recovery_required",
-              "checks_unavailable"
+              "regeneration_failed",
+              "follow_up_failed",
+              "api_error"
             ],
             "description": "Stable programmatic identifier.",
             "type": "string"
@@ -13966,14 +13998,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "fields": {
       "type": "array",
@@ -14353,14 +14385,14 @@ Input schema:
       "minimum": 1,
       "maximum": 100,
       "type": "integer",
-      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400. Default: 20."
+      "description": "Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 input_invalid. List query parameters must appear only once; repeated or unrecognized parameters return 400 query_param_invalid. Default: 20."
     },
     "cursor": {
       "minLength": 1,
       "maxLength": 2048,
       "pattern": "^[A-Za-z0-9_-]+$",
       "type": "string",
-      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests."
+      "description": "Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty or malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may change between requests."
     },
     "fields": {
       "type": "array",