@typeship-ax/mcp 0.20.0 → 0.21.0

package/src/resources/api-keys.ts

@@ -132,15 +132,16 @@ export interface ApiKeysListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
 }

package/src/resources/deliveries.ts

@@ -72,7 +72,7 @@ export class DeliveriesResource {
    * Get a Delivery
    *
    * Returns the configured repository or hosted MCP Delivery for a Target. A Delivery in another
-   * organization returns 404 not_found.
+   * organization returns 404 resource_not_found.
    * `GET /deliveries/{delivery_id}`
    */
   async get(deliveryId: DeliveryId, options?: RequestOptions): Promise<DeliveryResponseRead> {
@@ -98,15 +98,16 @@ export interface DeliveriesListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
   /** Only Deliveries of this Target. */

package/src/resources/drafts.ts

@@ -288,15 +288,16 @@ export interface DraftsListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
   /** Only Drafts of this Target. */
@@ -366,15 +367,16 @@ export interface DraftsListFilesParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
 }

package/src/resources/generations.ts

@@ -168,15 +168,16 @@ export interface GenerationsListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
   /** Only Generations in this Project. */
@@ -216,15 +217,16 @@ export interface GenerationsListFilesParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
 }

package/src/resources/projects.ts

@@ -148,9 +148,9 @@ export class ProjectsResource {
   /**
    * Delete a project
    *
-   * 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.
    * `DELETE /projects/{project_id}`
@@ -195,9 +195,9 @@ export class ProjectsResource {
    *
    * 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.
    * `PATCH /projects/{project_id}`
@@ -241,8 +241,8 @@ export class ProjectsResource {
    * 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.
+   * 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
@@ -289,15 +289,16 @@ export interface ProjectsListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
 }

package/src/resources/publications.ts

@@ -72,7 +72,7 @@ export class PublicationsResource {
    * Get publishing status
    *
    * Returns the registry publishing status for a release. A status in another organization returns
-   * 404 not_found.
+   * 404 resource_not_found.
    * `GET /publications/{publication_id}`
    */
   async get(publicationId: PublicationId, options?: RequestOptions): Promise<PublicationResponseRead> {
@@ -98,15 +98,16 @@ export interface PublicationsListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
   /** Only publications of this release. */

package/src/resources/releases.ts

@@ -95,7 +95,8 @@ export class ReleasesResource {
    * 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.
    *
    * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /releases/{release_id}/republish`
@@ -133,15 +134,16 @@ export interface ReleasesListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
   /** Only releases of this Target. */

package/src/resources/spec-revisions.ts

@@ -157,15 +157,16 @@ export interface SpecRevisionsListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
   /** Only revisions of this Spec. */
@@ -210,15 +211,16 @@ export interface SpecRevisionsListFilesParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
 }

package/src/resources/specs.ts

@@ -98,7 +98,8 @@ export class SpecsResource {
    *
    * 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.
+   * 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.
    *
    * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /specs/{spec_id}/refresh`

package/src/resources/targets.ts

@@ -191,9 +191,9 @@ export class TargetsResource {
    * 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.
    * `PATCH /targets/{target_id}`
@@ -275,15 +275,16 @@ export interface TargetsListParams {
   /**
    * 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.
+   * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+   * return 400 query_param_invalid.
    */
   limit?: number;
   /**
    * 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.
+   * 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.
    */
   cursor?: string;
   /** Only Targets in this Project. */

package/src/types.ts

@@ -105,7 +105,7 @@ export interface GoSdkDescriptor {
   version: string;
   /**
    * SHA-256 hex digest of the Spec the SDK was generated from. Must match the resolved Spec, or the
-   * request fails with spec_error.
+   * request fails with spec_invalid.
    */
   spec_digest: string;
   /**
@@ -3380,37 +3380,54 @@ export interface DeletedTargetRead {
   request_id: RequestId;
 }
 
-/** Stable category for deciding how to handle the error. */
+/**
+ * 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.
+ */
 export const ErrorType = {
-  REQUEST_ERROR: "request_error",
-  AUTHENTICATION_ERROR: "authentication_error",
-  AUTHORIZATION_ERROR: "authorization_error",
-  PLAN_ERROR: "plan_error",
-  SOURCE_ERROR: "source_error",
-  RATE_LIMIT_ERROR: "rate_limit_error",
-  API_ERROR: "api_error",
+  REQUEST: "request",
+  AUTH: "auth",
+  IDEMPOTENCY: "idempotency",
+  RATE_LIMIT: "rate_limit",
+  ORGANIZATION: "organization",
+  SOURCE: "source",
+  API: "api",
 } as const;
 export type ErrorType = (typeof ErrorType)[keyof typeof ErrorType];
 
 /** Stable programmatic identifier. Do not branch on message. */
 export const ErrorCode = {
-  INVALID_REQUEST: "invalid_request",
+  INPUT_INVALID: "input_invalid",
+  QUERY_PARAM_INVALID: "query_param_invalid",
+  CURSOR_INVALID: "cursor_invalid",
+  METHOD_NOT_ALLOWED: "method_not_allowed",
+  RESOURCE_NOT_FOUND: "resource_not_found",
+  IDEMPOTENCY_KEY_INVALID: "idempotency_key_invalid",
   IDEMPOTENCY_KEY_REUSED: "idempotency_key_reused",
-  UNAUTHORIZED: "unauthorized",
+  IDEMPOTENCY_KEY_IN_USE: "idempotency_key_in_use",
+  AUTH_REQUIRED: "auth_required",
+  API_KEY_INVALID: "api_key_invalid",
+  TOKEN_INVALID: "token_invalid",
   ORGANIZATION_REQUIRED: "organization_required",
   INSUFFICIENT_SCOPE: "insufficient_scope",
-  FORBIDDEN: "forbidden",
-  NOT_FOUND: "not_found",
-  METHOD_NOT_ALLOWED: "method_not_allowed",
-  SPEC_ERROR: "spec_error",
-  FETCH_ERROR: "fetch_error",
+  ROLE_INSUFFICIENT: "role_insufficient",
+  RATE_LIMIT_EXCEEDED: "rate_limit_exceeded",
+  PLAN_LIMIT_REACHED: "plan_limit_reached",
+  SPEC_INVALID: "spec_invalid",
+  SPEC_TOO_LARGE: "spec_too_large",
+  SPEC_UNREACHABLE: "spec_unreachable",
   REPOSITORY_PROVIDER_UNSUPPORTED: "repository_provider_unsupported",
+  REPOSITORY_DISCONNECTED: "repository_disconnected",
+  REPOSITORY_UNAVAILABLE: "repository_unavailable",
   TARGET_BUSY: "target_busy",
+  TARGETS_INACTIVE: "targets_inactive",
   NO_DRAFT: "no_draft",
   DRAFT_MERGED: "draft_merged",
   RESOURCE_CHANGED: "resource_changed",
-  INVALID_VERSION: "invalid_version",
   PRECONDITION_FAILED: "precondition_failed",
+  VERSION_INVALID: "version_invalid",
   VERSION_OCCUPIED: "version_occupied",
   VERSION_TOO_LOW: "version_too_low",
   TARGET_ALREADY_RELEASED: "target_already_released",
@@ -3418,15 +3435,12 @@ export const ErrorCode = {
   PUBLICATION_DISABLED: "publication_disabled",
   PUBLICATION_NOT_RETRYABLE: "publication_not_retryable",
   PUBLICATION_RECOVERY_UNAVAILABLE: "publication_recovery_unavailable",
-  PUBLICATION_DISPATCH_FAILED: "publication_dispatch_failed",
-  REPOSITORY_DISCONNECTED: "repository_disconnected",
-  REGENERATION_FAILED: "regeneration_failed",
+  PUBLICATION_FAILED: "publication_failed",
   DELIVERY_CONFLICT: "delivery_conflict",
   RESOURCE_HAS_DEPENDENCIES: "resource_has_dependencies",
-  PLAN_LIMIT_REACHED: "plan_limit_reached",
-  PAYLOAD_TOO_LARGE: "payload_too_large",
-  RATE_LIMITED: "rate_limited",
-  INTERNAL_ERROR: "internal_error",
+  CUSTOMIZATION_CONFLICT: "customization_conflict",
+  HISTORY_RECOVERY_REQUIRED: "history_recovery_required",
+  CHECKS_UNAVAILABLE: "checks_unavailable",
   DEPENDENCY_MISSING: "dependency_missing",
   DEPENDENCY_NOT_FOUND: "dependency_not_found",
   DEPENDENCY_SELF: "dependency_self",
@@ -3438,10 +3452,9 @@ export const ErrorCode = {
   DEPENDENCY_MODULE_PATH_MISSING: "dependency_module_path_missing",
   DEPENDENCY_UNRELEASED: "dependency_unreleased",
   DEPENDENCY_REVISION_MISMATCH: "dependency_revision_mismatch",
-  PUBLICATION_FAILED: "publication_failed",
-  CUSTOMIZATION_CONFLICT: "customization_conflict",
-  HISTORY_RECOVERY_REQUIRED: "history_recovery_required",
-  CHECKS_UNAVAILABLE: "checks_unavailable",
+  REGENERATION_FAILED: "regeneration_failed",
+  FOLLOW_UP_FAILED: "follow_up_failed",
+  API_ERROR: "api_error",
 } as const;
 export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];