@typeship-ax/mcp 0.21.0 → 0.23.0

package/src/types.ts

@@ -1,5 +1,16 @@
-// typeship — API types.
-// Generated by typeship — https://typeship.dev
+// Typeship — API types.
+// Generated by Typeship — https://typeship.dev
+
+declare const unknownVariantTag: unique symbol;
+/**
+ * A tag value the server added after this SDK was generated. It is a string
+ * at runtime; read it with `String(tag)`.
+ */
+export interface UnknownVariantTag extends String {
+  readonly [unknownVariantTag]: true;
+}
+/** A union member the server added after this SDK was generated, with every field as received. */
+export type UnknownVariant<Tag extends string> = { [K in Tag]: UnknownVariantTag } & Record<string, unknown>;
 
 /** Unique identifier for a project. */
 export type ProjectId = string;
@@ -34,8 +45,6 @@ export type DraftId = string;
 
 export type ReleaseId = string;
 
-export type PublicationId = string;
-
 /**
  * Generator implementation selected by a Target. This is configuration, not identity; several
  * Targets may use the same generator. cli is the TypeScript CLI; go_cli is the native Go CLI, a
@@ -76,7 +85,10 @@ export interface UrlSpecInputRead {
 }
 
 export interface InlineSpecInput {
-  /** Raw Spec text (OpenAPI JSON/YAML or GraphQL SDL). Up to 10MB. */
+  /**
+   * Raw Spec text (OpenAPI JSON/YAML or GraphQL SDL). Up to 4 MB, because the request body carries
+   * it; send Specs up to 10 MB with `url`.
+   */
   inline: string;
 }
 
@@ -352,6 +364,8 @@ export interface SpecRevisionFileListRead {
 }
 
 export interface GenerationResult {
+  /** One generated package. It has no ID: download it with download.url before download.expires_at. */
+  object: "package";
   files: GeneratedFile[];
   download?: GenerationDownload;
   warnings: GenerationWarning[];
@@ -372,6 +386,8 @@ export interface GenerationResult {
 
 /** Response shape for GenerationResult. */
 export interface GenerationResultRead {
+  /** One generated package. It has no ID: download it with download.url before download.expires_at. */
+  object: "package" | (string & {});
   files: GeneratedFileRead[];
   download?: GenerationDownload;
   warnings: GenerationWarning[];
@@ -437,12 +453,6 @@ export interface UrlSpecSourceWrite {
   url: UrlSpecSourceSettingsWrite;
 }
 
-/** Response shape for UrlSpecSource. */
-export interface UrlSpecSourceRead {
-  type: "url" | (string & {});
-  url: UrlSpecSourceSettings;
-}
-
 /** GitHub is the only launch provider; the field is stable for future adapters. */
 export const RepositoryProvider = {
   GITHUB: "github",
@@ -452,17 +462,6 @@ export type RepositoryProvider = (typeof RepositoryProvider)[keyof typeof Reposi
 /** Provider-native repository identity, opaque outside its adapter. */
 export type RepositoryIdentifier = string;
 
-export interface RepositoryReference {
-  provider: RepositoryProvider;
-  identifier: RepositoryIdentifier;
-}
-
-/** Response shape for RepositoryReference. */
-export interface RepositoryReferenceRead {
-  provider: RepositoryProvider | (string & {});
-  identifier: RepositoryIdentifier;
-}
-
 export interface RepositorySpecSourceSettings {
   provider: RepositoryProvider;
   identifier: RepositoryIdentifier;
@@ -485,7 +484,7 @@ export interface RepositorySpecSource {
 
 /** Response shape for RepositorySpecSource. */
 export interface RepositorySpecSourceRead {
-  type: "repository" | (string & {});
+  type: "repository";
   repository: RepositorySpecSourceSettingsRead;
 }
 
@@ -496,9 +495,7 @@ export type SpecSource = UrlSpecSource | RepositorySpecSource;
 export type SpecSourceWrite = UrlSpecSourceWrite | RepositorySpecSource;
 
 /** Response shape for SpecSource. */
-export type SpecSourceRead = UrlSpecSourceRead
-  | RepositorySpecSourceRead
-  | Record<string, unknown> & { type?: string };
+export type SpecSourceRead = UrlSpecSource | RepositorySpecSourceRead | UnknownVariant<"type">;
 
 export interface UrlSpecSourceSettingsInput {
   /**
@@ -531,7 +528,7 @@ export interface UrlSpecSourceInput {
 
 /** Response shape for UrlSpecSourceInput. */
 export interface UrlSpecSourceInputRead {
-  type: "url" | (string & {});
+  type: "url";
   url: UrlSpecSourceSettingsInputRead;
 }
 
@@ -557,7 +554,7 @@ export interface RepositorySpecSourceInput {
 
 /** Response shape for RepositorySpecSourceInput. */
 export interface RepositorySpecSourceInputRead {
-  type: "repository" | (string & {});
+  type: "repository";
   repository: RepositorySpecSourceSettingsInputRead;
 }
 
@@ -566,7 +563,7 @@ export type SpecSourceInput = UrlSpecSourceInput | RepositorySpecSourceInput;
 /** Response shape for SpecSourceInput. */
 export type SpecSourceInputRead = UrlSpecSourceInputRead
   | RepositorySpecSourceInputRead
-  | Record<string, unknown> & { type?: string };
+  | UnknownVariant<"type">;
 
 /**
  * A fix applied to the resolved Spec before generation. Paths are JSON
@@ -606,8 +603,26 @@ export interface SpecPatchRead {
   reason?: string | null;
 }
 
-/** One exact place where a Diagnostic rule found evidence. */
+/**
+ * One exact place where a Diagnostic rule found evidence, with its own state under the Spec's
+ * Diagnostic policy.
+ */
 export interface DiagnosticLocation {
+  /**
+   * Whether this location fails the Spec's Diagnostic policy. Fix these locations to pass the
+   * policy.
+   */
+  blocking: boolean;
+  /**
+   * Whether this location is new since baseline_spec_revision_id in the Diagnostic summary. Always
+   * true when there is no baseline.
+   */
+  introduced: boolean;
+  /**
+   * Whether a reviewed exception in the Spec's Diagnostic policy covers this location, by its path
+   * or for the whole rule. Suppressed locations never block.
+   */
+  suppressed: boolean;
   /** Source file path from the Spec Revision when the finding maps to a captured file. */
   file_path?: string;
   /** The captured source file, present with file_path. Read it with getFile. */
@@ -659,13 +674,14 @@ export interface Diagnostic {
   id: string;
   object: "diagnostic";
   /**
-   * Whether this Diagnostic fails the Spec's Diagnostic policy. Suppressed occurrences and, when
-   * only_new is set, occurrences present in the baseline never block.
+   * Whether any location fails the Spec's Diagnostic policy. Each location's blocking field names
+   * which ones. Suppressed locations and, when only_new is set, locations present in the baseline
+   * never block.
    */
   blocking: boolean;
   /**
-   * Whether any occurrence is new since baseline_spec_revision_id in the Diagnostic summary. Always
-   * true when there is no baseline.
+   * Whether any location is new since baseline_spec_revision_id in the Diagnostic summary. Each
+   * location's introduced field names which ones. Always true when there is no baseline.
    */
   introduced: boolean;
   /** Whether the rule reports invalid behavior, material risk, or an improvement. */
@@ -680,7 +696,10 @@ export interface Diagnostic {
   surfaces: Array<"api" | "sdk" | "cli" | "mcp">;
   /** Whether remediation requires intent that the Spec cannot prove. */
   owner_decision_required: boolean;
-  /** All affected coordinates, kept under one grouped diagnostic. */
+  /**
+   * The affected coordinates, kept under one grouped Diagnostic. With a filter, only the matching
+   * locations.
+   */
   locations: DiagnosticLocation[];
   fix?: DiagnosticFix;
   /**
@@ -696,13 +715,14 @@ export interface DiagnosticRead {
   id: string;
   object: "diagnostic" | (string & {});
   /**
-   * Whether this Diagnostic fails the Spec's Diagnostic policy. Suppressed occurrences and, when
-   * only_new is set, occurrences present in the baseline never block.
+   * Whether any location fails the Spec's Diagnostic policy. Each location's blocking field names
+   * which ones. Suppressed locations and, when only_new is set, locations present in the baseline
+   * never block.
    */
   blocking: boolean;
   /**
-   * Whether any occurrence is new since baseline_spec_revision_id in the Diagnostic summary. Always
-   * true when there is no baseline.
+   * Whether any location is new since baseline_spec_revision_id in the Diagnostic summary. Each
+   * location's introduced field names which ones. Always true when there is no baseline.
    */
   introduced: boolean;
   /** Whether the rule reports invalid behavior, material risk, or an improvement. */
@@ -717,7 +737,10 @@ export interface DiagnosticRead {
   surfaces: Array<("api" | "sdk" | "cli" | "mcp") | (string & {})>;
   /** Whether remediation requires intent that the Spec cannot prove. */
   owner_decision_required: boolean;
-  /** All affected coordinates, kept under one grouped diagnostic. */
+  /**
+   * The affected coordinates, kept under one grouped Diagnostic. With a filter, only the matching
+   * locations.
+   */
   locations: DiagnosticLocation[];
   fix?: DiagnosticFixRead;
   /**
@@ -878,7 +901,7 @@ export interface RepositoryDeliveryInput {
 
 /** Response shape for RepositoryDeliveryInput. */
 export interface RepositoryDeliveryInputRead {
-  type: "repository" | (string & {});
+  type: "repository";
   repository: RepositoryDeliverySettingsInputRead;
 }
 
@@ -886,17 +909,69 @@ export interface HostedMcpDeliveryInput {
   type: "hosted_mcp";
 }
 
-/** Response shape for HostedMcpDeliveryInput. */
-export interface HostedMcpDeliveryInputRead {
-  type: "hosted_mcp" | (string & {});
-}
-
 export type DeliveryInput = RepositoryDeliveryInput | HostedMcpDeliveryInput;
 
 /** Response shape for DeliveryInput. */
 export type DeliveryInputRead = RepositoryDeliveryInputRead
-  | HostedMcpDeliveryInputRead
-  | Record<string, unknown> & { type?: string };
+  | HostedMcpDeliveryInput
+  | UnknownVariant<"type">;
+
+export interface RepositoryDeliveryCreateRequest {
+  target_id: TargetId;
+  type: "repository";
+  repository: RepositoryDeliverySettingsInput;
+}
+
+/** Response shape for RepositoryDeliveryCreateRequest. */
+export interface RepositoryDeliveryCreateRequestRead {
+  target_id: TargetId;
+  type: "repository";
+  repository: RepositoryDeliverySettingsInputRead;
+}
+
+export interface HostedMcpDeliveryCreateRequest {
+  target_id: TargetId;
+  type: "hosted_mcp";
+}
+
+export type DeliveryCreateRequest = RepositoryDeliveryCreateRequest | HostedMcpDeliveryCreateRequest;
+
+/** Response shape for DeliveryCreateRequest. */
+export type DeliveryCreateRequestRead = RepositoryDeliveryCreateRequestRead
+  | HostedMcpDeliveryCreateRequest
+  | UnknownVariant<"type">;
+
+export interface DeliveryUpdateRequest {
+  /**
+   * Replaces the complete repository settings, so omitted optional settings reset to their
+   * defaults. Only repository Deliveries have settings to update.
+   */
+  repository: RepositoryDeliverySettingsInput;
+}
+
+/** Response shape for DeliveryUpdateRequest. */
+export interface DeliveryUpdateRequestRead {
+  /**
+   * Replaces the complete repository settings, so omitted optional settings reset to their
+   * defaults. Only repository Deliveries have settings to update.
+   */
+  repository: RepositoryDeliverySettingsInputRead;
+}
+
+export interface DeletedDelivery {
+  id: DeliveryId;
+  object: "delivery";
+  deleted: true;
+  request_id: RequestId;
+}
+
+/** Response shape for DeletedDelivery. */
+export interface DeletedDeliveryRead {
+  id: DeliveryId;
+  object: "delivery" | (string & {});
+  deleted: true;
+  request_id: RequestId;
+}
 
 export interface RepositoryDeliverySettings {
   provider: RepositoryProvider;
@@ -955,7 +1030,7 @@ export interface RepositoryDeliveryRead {
   id: DeliveryId;
   object: "delivery" | (string & {});
   target_id: TargetId;
-  type: "repository" | (string & {});
+  type: "repository";
   /**
    * active: the repository accepts generated changes. action_required: inspect issues for the
    * correction. disabled: the Target is disabled and receives no changes.
@@ -1042,7 +1117,7 @@ export interface HostedMcpDeliveryRead {
   id: DeliveryId;
   object: "delivery" | (string & {});
   target_id: TargetId;
-  type: "hosted_mcp" | (string & {});
+  type: "hosted_mcp";
   /**
    * active: the endpoint serves the Target's latest accepted package. disabled: the Target is
    * disabled and the endpoint is paused.
@@ -1058,9 +1133,7 @@ export interface HostedMcpDeliveryRead {
 export type Delivery = RepositoryDelivery | HostedMcpDelivery;
 
 /** Response shape for Delivery. */
-export type DeliveryRead = RepositoryDeliveryRead
-  | HostedMcpDeliveryRead
-  | Record<string, unknown> & { type?: string };
+export type DeliveryRead = RepositoryDeliveryRead | HostedMcpDeliveryRead | UnknownVariant<"type">;
 
 /**
  * repository is present for a repository Delivery, with issues, required_checks, and last_event;
@@ -1149,7 +1222,6 @@ export interface TargetChecksRead {
 export interface TargetCreateRequest {
   project_id: ProjectId;
   name: string;
-  spec_id: SpecId;
   type: GeneratorKind;
   /** Default: "active" */
   status?: "active" | "disabled";
@@ -1168,7 +1240,6 @@ export interface TargetCreateRequest {
 export interface TargetCreateRequestRead {
   project_id: ProjectId;
   name: string;
-  spec_id: SpecId;
   type: GeneratorKind | (string & {});
   /** Default: "active" */
   status?: ("active" | "disabled") | (string & {});
@@ -1226,14 +1297,6 @@ export interface TargetUpdateRequest {
    * inheritance. Effective values merge over Project.config; GraphQL settings belong to the Spec.
    */
   config?: TargetConfig | null;
-  /**
-   * Replaces the Delivery set; include each kind you want to keep. Retained kinds preserve their
-   * ID, creation time, and hosted URL. Each supplied Delivery replaces its configuration, so
-   * omitted optional settings reset to their defaults. Omit deliveries to keep the existing set, or
-   * send [] to remove all Deliveries. Removing and later recreating a kind allocates a new ID and,
-   * for hosted_mcp, a new URL.
-   */
-  deliveries?: DeliveryInput[];
 }
 
 /** Response shape for TargetUpdateRequest. */
@@ -1247,14 +1310,6 @@ export interface TargetUpdateRequestRead {
    * inheritance. Effective values merge over Project.config; GraphQL settings belong to the Spec.
    */
   config?: TargetConfigRead | null;
-  /**
-   * Replaces the Delivery set; include each kind you want to keep. Retained kinds preserve their
-   * ID, creation time, and hosted URL. Each supplied Delivery replaces its configuration, so
-   * omitted optional settings reset to their defaults. Omit deliveries to keep the existing set, or
-   * send [] to remove all Deliveries. Removing and later recreating a kind allocates a new ID and,
-   * for hosted_mcp, a new URL.
-   */
-  deliveries?: DeliveryInputRead[];
 }
 
 /**
@@ -1384,23 +1439,6 @@ export interface DeliveryListRead {
   request_id: RequestId;
 }
 
-export interface PublicationList {
-  object: ListObject;
-  data: Publication[];
-  has_more: boolean;
-  next_cursor: string | null;
-  request_id: RequestId;
-}
-
-/** Response shape for PublicationList. */
-export interface PublicationListRead {
-  object: ListObject;
-  data: PublicationRead[];
-  has_more: boolean;
-  next_cursor: string | null;
-  request_id: RequestId;
-}
-
 export interface DraftList {
   object: ListObject;
   data: Draft[];
@@ -1453,7 +1491,8 @@ export interface Release {
   origin: "typeship" | "imported";
   /** Immutable package version released from this Target. */
   version: string;
-  channel: "stable" | "prerelease";
+  /** The Target's release_channel when this version was released. */
+  release_channel: "stable" | "prerelease";
   repository: RepositoryReferenceResponse | null;
   spec_revision_id: SpecRevisionId | null;
   /**
@@ -1484,9 +1523,19 @@ export interface Release {
     imported_at: string | null;
   }
     | null;
+  /**
+   * One entry per destination Typeship has attempted to publish. Empty when publishing is off for
+   * the Target's repository Delivery.
+   */
   publications: Publication[];
   /** Format: date-time */
   created_at: string;
+  /**
+   * When a Publication of this release last changed. The version, commit, and checks never change
+   * after the release is created.
+   * Format: date-time
+   */
+  updated_at: string;
   request_id?: RequestId;
 }
 
@@ -1500,7 +1549,8 @@ export interface ReleaseRead {
   origin: ("typeship" | "imported") | (string & {});
   /** Immutable package version released from this Target. */
   version: string;
-  channel: ("stable" | "prerelease") | (string & {});
+  /** The Target's release_channel when this version was released. */
+  release_channel: ("stable" | "prerelease") | (string & {});
   repository: RepositoryReferenceResponseRead | null;
   spec_revision_id: SpecRevisionId | null;
   /**
@@ -1531,9 +1581,19 @@ export interface ReleaseRead {
     imported_at: string | null;
   }
     | null;
+  /**
+   * One entry per destination Typeship has attempted to publish. Empty when publishing is off for
+   * the Target's repository Delivery.
+   */
   publications: PublicationRead[];
   /** Format: date-time */
   created_at: string;
+  /**
+   * When a Publication of this release last changed. The version, commit, and checks never change
+   * after the release is created.
+   * Format: date-time
+   */
+  updated_at: string;
   request_id?: RequestId;
 }
 
@@ -1559,12 +1619,20 @@ export interface ReleaseListRead {
   request_id: RequestId;
 }
 
+/** One destination's publishing progress for its Release. It has no ID; read it on the Release. */
 export interface Publication {
-  id: PublicationId;
-  object: "publication";
-  release_id: ReleaseId;
-  destination: "github" | "npm" | "pypi" | "go" | "mcp";
-  status: "pending" | "publishing" | "published" | "failed" | "disabled";
+  /**
+   * Where the release is published. github is the repository's GitHub Release; the others are
+   * package registries.
+   */
+  type: "github" | "npm" | "pypi" | "go" | "mcp";
+  /**
+   * queued: the repository workflow has not started this destination; get the Publication or its
+   * Release again. running: the workflow is publishing; get it again. completed: the package is
+   * published at registry_url. failed: read errors, correct the cause, then retry the Release.
+   * Lifecycle events are publication.running, publication.completed, and publication.failed.
+   */
+  status: "queued" | "running" | "completed" | "failed";
   attempt: number;
   /** Format: uri */
   run_url: string | null;
@@ -1587,11 +1655,18 @@ export interface Publication {
 
 /** Response shape for Publication. */
 export interface PublicationRead {
-  id: PublicationId;
-  object: "publication" | (string & {});
-  release_id: ReleaseId;
-  destination: ("github" | "npm" | "pypi" | "go" | "mcp") | (string & {});
-  status: ("pending" | "publishing" | "published" | "failed" | "disabled") | (string & {});
+  /**
+   * Where the release is published. github is the repository's GitHub Release; the others are
+   * package registries.
+   */
+  type: ("github" | "npm" | "pypi" | "go" | "mcp") | (string & {});
+  /**
+   * queued: the repository workflow has not started this destination; get the Publication or its
+   * Release again. running: the workflow is publishing; get it again. completed: the package is
+   * published at registry_url. failed: read errors, correct the cause, then retry the Release.
+   * Lifecycle events are publication.running, publication.completed, and publication.failed.
+   */
+  status: ("queued" | "running" | "completed" | "failed") | (string & {});
   attempt: number;
   /** Format: uri */
   run_url: string | null;
@@ -1612,20 +1687,15 @@ export interface PublicationRead {
   updated_at: string;
 }
 
-export type PublicationResponse = Publication & ResponseMetadata;
-
-/** Response shape for PublicationResponse. */
-export type PublicationResponseRead = PublicationRead & ResponseMetadata;
-
 /**
- * none: the open Draft has no pending change; generate the Target to start one. working: Typeship
+ * idle: the open Draft has no pending change; generate the Target to start one. working: Typeship
  * is generating, carrying repository edits forward, applying decisions, or checking the Draft;
  * retrieve it again. action_required: use the typed reason to find the customer's next action.
  * ready: required checks passed on head_sha; merge the pull request. merged: the pull request
  * merged and the Draft is final; retrieve the Target for the draft_id of its next Draft.
  */
 export const DraftStatus = {
-  NONE: "none",
+  IDLE: "idle",
   WORKING: "working",
   ACTION_REQUIRED: "action_required",
   READY: "ready",
@@ -1635,8 +1705,8 @@ export type DraftStatus = (typeof DraftStatus)[keyof typeof DraftStatus];
 
 /**
  * conflict: resolve the listed files. checks_failed: correct failed package checks. review_failed:
- * correct the Draft title, version, or other readiness finding. checks_unavailable: restore a
- * required check. history_rewritten: review the affected files and approve recovery.
+ * correct the Draft title or version. checks_unavailable: restore a required check.
+ * history_rewritten: review the affected files and approve recovery.
  */
 export const DraftActionReason = {
   CONFLICT: "conflict",
@@ -1664,65 +1734,52 @@ export interface DraftHistoryRecovery {
   preserved_branch: string | null;
 }
 
-/**
- * Readiness decision for the Draft's head_sha. Null readiness on the Draft means no Draft has been
- * generated.
- */
-export interface DraftReadiness {
+/** Comparison of the Draft's head_sha with the latest release. */
+export interface DraftCompatibility {
+  /** API surface comparison. unknown means analysis is unavailable. */
+  api: "compatible" | "breaking" | "unknown";
   /**
-   * success means required checks passed; failure means the Draft needs correction or review; error
-   * means assessment could not finish; pending means checks have not finished.
+   * Package and supported SDK source comparison. unknown means analysis is incomplete or
+   * unavailable.
    */
-  status: "success" | "failure" | "error" | "pending";
-  /** Human-readable explanation of the current decision. Do not parse it for control flow. */
-  description: string;
-  /** API surface comparison against the latest release. unknown means analysis is unavailable. */
-  compatibility_api: "compatible" | "breaking" | "unknown";
+  package: "compatible" | "breaking" | "unknown";
+}
+
+/** Response shape for DraftCompatibility. */
+export interface DraftCompatibilityRead {
+  /** API surface comparison. unknown means analysis is unavailable. */
+  api: ("compatible" | "breaking" | "unknown") | (string & {});
   /**
-   * Package and supported SDK source comparison against the latest release. unknown means analysis
-   * is incomplete or unavailable.
+   * Package and supported SDK source comparison. unknown means analysis is incomplete or
+   * unavailable.
    */
-  compatibility_package: "compatible" | "breaking" | "unknown";
-  /** Whether the version satisfies the assessed change. Null when no verdict is available. */
-  version_correct: boolean | null;
+  package: ("compatible" | "breaking" | "unknown") | (string & {});
+}
+
+/** How version_next relates to the assessed change. */
+export interface DraftVersion {
   /**
    * Minimum assessed version bump. Approval never waives an insufficient bump. Null when no bump
    * has been determined.
    */
   bump_required: "major" | "minor" | "patch" | null;
+  /** Whether version_next satisfies the assessed change. Null when no verdict is available. */
+  correct: boolean | null;
   /** Latest release version used for the comparison. Null before the first release. */
-  version_previous: string | null;
-  /** Draft title error that must be corrected before release. Null when none is recorded. */
-  title_error: string | null;
+  previous: string | null;
 }
 
-/** Response shape for DraftReadiness. */
-export interface DraftReadinessRead {
-  /**
-   * success means required checks passed; failure means the Draft needs correction or review; error
-   * means assessment could not finish; pending means checks have not finished.
-   */
-  status: ("success" | "failure" | "error" | "pending") | (string & {});
-  /** Human-readable explanation of the current decision. Do not parse it for control flow. */
-  description: string;
-  /** API surface comparison against the latest release. unknown means analysis is unavailable. */
-  compatibility_api: ("compatible" | "breaking" | "unknown") | (string & {});
-  /**
-   * Package and supported SDK source comparison against the latest release. unknown means analysis
-   * is incomplete or unavailable.
-   */
-  compatibility_package: ("compatible" | "breaking" | "unknown") | (string & {});
-  /** Whether the version satisfies the assessed change. Null when no verdict is available. */
-  version_correct: boolean | null;
+/** Response shape for DraftVersion. */
+export interface DraftVersionRead {
   /**
    * Minimum assessed version bump. Approval never waives an insufficient bump. Null when no bump
    * has been determined.
    */
   bump_required: ("major" | "minor" | "patch" | null) | (string & {}) | null;
+  /** Whether version_next satisfies the assessed change. Null when no verdict is available. */
+  correct: boolean | null;
   /** Latest release version used for the comparison. Null before the first release. */
-  version_previous: string | null;
-  /** Draft title error that must be corrected before release. Null when none is recorded. */
-  title_error: string | null;
+  previous: string | null;
 }
 
 /**
@@ -1742,17 +1799,24 @@ export interface Draft {
   version_next: string | null;
   /** Where version_next was selected; null once the Draft merged. */
   version_source: "automatic" | "console" | "api" | "github" | null;
-  readiness: DraftReadiness | null;
+  /** Null until the Draft has a generated change, and on a merged Draft. */
+  compatibility: DraftCompatibility | null;
+  /** Null until the Draft has a generated change, and on a merged Draft. */
+  version: DraftVersion | null;
+  /**
+   * What blocks the Draft, one entry per finding, each with a code and suggested_action. Empty
+   * unless status is action_required.
+   */
+  errors: ErrorDetail[];
   changes: {
     /** Cumulative changelog against the latest release. */
     changelog?: string | null;
     breaking_count?: number | null;
-    version_previous?: string | null;
   }
     | null;
   /**
-   * Draft commit that readiness, checks, and conflicts describe. Send it as expected_head_sha when
-   * resolving or discarding.
+   * Draft commit that compatibility, version, checks, and conflicts describe. Send it as
+   * expected_head_sha when resolving or discarding.
    */
   head_sha: string | null;
   /** The Draft pull request in the destination repository, or null before one is opened. */
@@ -1801,17 +1865,24 @@ export interface DraftRead {
   version_next: string | null;
   /** Where version_next was selected; null once the Draft merged. */
   version_source: ("automatic" | "console" | "api" | "github" | null) | (string & {}) | null;
-  readiness: DraftReadinessRead | null;
+  /** Null until the Draft has a generated change, and on a merged Draft. */
+  compatibility: DraftCompatibilityRead | null;
+  /** Null until the Draft has a generated change, and on a merged Draft. */
+  version: DraftVersionRead | null;
+  /**
+   * What blocks the Draft, one entry per finding, each with a code and suggested_action. Empty
+   * unless status is action_required.
+   */
+  errors: ErrorDetailRead[];
   changes: {
     /** Cumulative changelog against the latest release. */
     changelog?: string | null;
     breaking_count?: number | null;
-    version_previous?: string | null;
   }
     | null;
   /**
-   * Draft commit that readiness, checks, and conflicts describe. Send it as expected_head_sha when
-   * resolving or discarding.
+   * Draft commit that compatibility, version, checks, and conflicts describe. Send it as
+   * expected_head_sha when resolving or discarding.
    */
   head_sha: string | null;
   /** The Draft pull request in the destination repository, or null before one is opened. */
@@ -2034,7 +2105,7 @@ export interface Project {
    * Format: date-time
    */
   updated_at: string;
-  request_id: RequestId;
+  request_id?: RequestId;
 }
 
 /** Request shape for Project. */
@@ -2051,7 +2122,7 @@ export interface ProjectWrite {
    * settings remain Spec-owned.
    */
   config: ProjectConfigResponse | null;
-  request_id: RequestId;
+  request_id?: RequestId;
 }
 
 /** Response shape for Project. */
@@ -2077,37 +2148,16 @@ export interface ProjectRead {
    * Format: date-time
    */
   updated_at: string;
-  request_id: RequestId;
+  request_id?: RequestId;
 }
 
-/**
- * Lean Project identity returned by collection endpoints. Retrieve the Project for shared
- * configuration and list its Targets for the complete canonical child collection.
- */
-export interface ProjectSummary {
-  id: ProjectId;
-  object: "project";
-  name: string;
-  spec_id: SpecId;
-  auto_generate: boolean;
-  /** Format: date-time */
-  created_at: string;
-  /** Format: date-time */
-  updated_at: string;
-}
+export type ProjectResponse = Project & ResponseMetadata;
 
-/** Response shape for ProjectSummary. */
-export interface ProjectSummaryRead {
-  id: ProjectId;
-  object: "project" | (string & {});
-  name: string;
-  spec_id: SpecId;
-  auto_generate: boolean;
-  /** Format: date-time */
-  created_at: string;
-  /** Format: date-time */
-  updated_at: string;
-}
+/** Request shape for ProjectResponse. */
+export type ProjectResponseWrite = ProjectWrite & ResponseMetadata;
+
+/** Response shape for ProjectResponse. */
+export type ProjectResponseRead = ProjectRead & ResponseMetadata;
 
 export interface CreateProjectRequest {
   name: string;
@@ -2340,6 +2390,25 @@ export interface AuthenticationConfig {
   approval_url?: string | null;
   /** Authentication selections keyed by generated API environment name. */
   environments?: Record<string, AuthenticationEnvironment> | null;
+  /**
+   * Environment variables the generated CLI, MCP server, and SDK environment fallbacks read, keyed
+   * by security scheme name. A string names the token or key variable; a Basic scheme takes {
+   * username, password }. Wins over the scheme's x-typeship-env extension. Without either, names
+   * derive from the package and scheme.
+   */
+  credential_variables?: Record<string, string | {
+    username: string;
+    password: string;
+  }>
+    | null;
+  /**
+   * Whether a parameter carries the operation's credential, keyed by operationId, "METHOD /path",
+   * or "*" for every operation, then by the parameter's wire name. true leaves the parameter out of
+   * generated signatures, CLI flags, and MCP tool input, because the configured credential already
+   * reaches the API; false keeps it. Wins over the parameter's x-typeship-credential extension and
+   * the generator's inference.
+   */
+  credential_parameters?: Record<string, Record<string, boolean>> | null;
 }
 
 export interface TargetAuthenticationEnvironment {
@@ -2561,6 +2630,13 @@ export interface ReadmeBehavior {
  * destination.
  */
 export interface PackageBehavior {
+  /**
+   * The API's name as generated READMEs, AGENTS.md, package descriptions, and help text show it,
+   * such as "Parcel" for a Spec titled "Parcel - Public API". Display only: package, client, and
+   * command names still come from the Spec. Defaults to the Spec title with common noise removed
+   * ("Parcel - API" shows as Parcel).
+   */
+  title?: string | null;
   /** Homepage written into registry metadata. */
   homepage?: string | null;
   /** SPDX identifier written into registry metadata. Defaults to info.license. */
@@ -2589,6 +2665,16 @@ export interface Config {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuning;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -2623,6 +2709,16 @@ export interface ConfigRead {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuning;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -2662,6 +2758,16 @@ export interface ProjectConfig {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuning;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -2695,6 +2801,16 @@ export interface ProjectConfigRead {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuning;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -2732,6 +2848,16 @@ export interface TargetConfig {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuning;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -2765,6 +2891,16 @@ export interface TargetConfigRead {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuning;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -2809,14 +2945,21 @@ export interface GraphqlSettings {
   }>;
   /**
    * How requests authenticate. bearer sends Authorization: Bearer; basic is for key-pair APIs
-   * (public key as username, private key as password); api_key sends a header named by
-   * api_key_header; none generates no auth option.
+   * (public key as username, private key as password); basic_api_key sends one API key as the
+   * Basic-auth username with an empty password; api_key sends a header named by api_key_header;
+   * api_key_or_bearer sends a key in api_key_header (Authorization for a raw key) and also accepts
+   * an OAuth access token as Authorization: Bearer; none generates no auth option.
    * Default: "bearer"
    */
-  auth?: "bearer" | "basic" | "api_key" | "none";
+  auth?: "bearer"
+    | "basic"
+    | "basic_api_key"
+    | "api_key"
+    | "api_key_or_bearer"
+    | "none";
   /**
-   * Header carrying the key when auth is api_key. Required for that mode; Typeship does not invent
-   * a vendor-specific header name.
+   * Header carrying the key when auth is api_key or api_key_or_bearer. Required for those modes;
+   * Typeship does not invent a vendor-specific header name.
    */
   api_key_header?: string;
   /**
@@ -2829,6 +2972,20 @@ export interface GraphqlSettings {
    * generate as the language's untyped JSON value and produce a warning. Unmatched keys warn.
    */
   scalars?: Record<string, "string" | "integer" | "number" | "boolean" | "json">;
+  /**
+   * Object types that report a failure when an operation's union or interface result resolves to
+   * them (errors returned as data). Replaces the default, which is every member whose name ends in
+   * Error when the result can also be something else. An empty array treats no result as a failure.
+   * Names that are not object types in the schema produce a generation warning.
+   */
+  error_types?: string[];
+  /**
+   * Page size a paginated connection call sends as first when the caller passes neither first nor
+   * last. Relay servers such as GitHub reject a connection query without one. Ignored for a
+   * connection whose first argument has a schema default.
+   * Default: 100
+   */
+  page_size?: number;
 }
 
 /** Response shape for GraphqlSettings. */
@@ -2850,14 +3007,21 @@ export interface GraphqlSettingsRead {
   }>;
   /**
    * How requests authenticate. bearer sends Authorization: Bearer; basic is for key-pair APIs
-   * (public key as username, private key as password); api_key sends a header named by
-   * api_key_header; none generates no auth option.
+   * (public key as username, private key as password); basic_api_key sends one API key as the
+   * Basic-auth username with an empty password; api_key sends a header named by api_key_header;
+   * api_key_or_bearer sends a key in api_key_header (Authorization for a raw key) and also accepts
+   * an OAuth access token as Authorization: Bearer; none generates no auth option.
    * Default: "bearer"
    */
-  auth?: ("bearer" | "basic" | "api_key" | "none") | (string & {});
+  auth?: ("bearer"
+    | "basic"
+    | "basic_api_key"
+    | "api_key"
+    | "api_key_or_bearer"
+    | "none") | (string & {});
   /**
-   * Header carrying the key when auth is api_key. Required for that mode; Typeship does not invent
-   * a vendor-specific header name.
+   * Header carrying the key when auth is api_key or api_key_or_bearer. Required for those modes;
+   * Typeship does not invent a vendor-specific header name.
    */
   api_key_header?: string;
   /**
@@ -2870,6 +3034,20 @@ export interface GraphqlSettingsRead {
    * generate as the language's untyped JSON value and produce a warning. Unmatched keys warn.
    */
   scalars?: Record<string, ("string" | "integer" | "number" | "boolean" | "json") | (string & {})>;
+  /**
+   * Object types that report a failure when an operation's union or interface result resolves to
+   * them (errors returned as data). Replaces the default, which is every member whose name ends in
+   * Error when the result can also be something else. An empty array treats no result as a failure.
+   * Names that are not object types in the schema produce a generation warning.
+   */
+  error_types?: string[];
+  /**
+   * Page size a paginated connection call sends as first when the caller passes neither first nor
+   * last. Relay servers such as GitHub reject a connection query without one. Ignored for a
+   * connection whose first argument has a schema default.
+   * Default: 100
+   */
+  page_size?: number;
 }
 
 /**
@@ -2918,19 +3096,6 @@ export interface PaginationRuleRead {
   limit_param?: string;
 }
 
-export interface FileStub {
-  path: string;
-  bytes: number;
-  mode: "100644" | "100755";
-}
-
-/** Response shape for FileStub. */
-export interface FileStubRead {
-  path: string;
-  bytes: number;
-  mode: ("100644" | "100755") | (string & {});
-}
-
 /**
  * A Generation moves from queued to running, then completes when its files are saved or fails.
  * Delivery and Draft status are separate.
@@ -3042,15 +3207,6 @@ export interface GenerationRead {
   updated_at: string;
 }
 
-/** Generation metadata returned by collection endpoints. */
-export type GenerationSummary = Generation;
-
-/** Request shape for GenerationSummary. */
-export type GenerationSummaryWrite = GenerationWrite;
-
-/** Response shape for GenerationSummary. */
-export type GenerationSummaryRead = GenerationRead;
-
 export type GenerationResponse = Generation & ResponseMetadata;
 
 /** Request shape for GenerationResponse. */
@@ -3059,42 +3215,24 @@ export type GenerationResponseWrite = GenerationWrite & ResponseMetadata;
 /** Response shape for GenerationResponse. */
 export type GenerationResponseRead = GenerationRead & ResponseMetadata;
 
-/** A selected target that did not generate in a multi-target run. */
-export interface GenerationFailure {
-  target_id: TargetId;
-  type: GeneratorKind;
-  status: "failed";
-  /** Recorded failures. Empty when this resource has no recorded failure. */
-  errors: DomainError[];
-}
-
-/** Response shape for GenerationFailure. */
-export interface GenerationFailureRead {
-  target_id: TargetId;
-  type: GeneratorKind | (string & {});
-  status: "failed" | (string & {});
-  /** Recorded failures. Empty when this resource has no recorded failure. */
-  errors: DomainErrorRead[];
-}
-
 /**
  * One Generation per selected Target. Retrieve each Generation for current status and generated
  * files.
  */
 export interface GenerationBatch {
-  data: GenerationSummary[];
+  data: Generation[];
   request_id: RequestId;
 }
 
 /** Request shape for GenerationBatch. */
 export interface GenerationBatchWrite {
-  data: GenerationSummaryWrite[];
+  data: GenerationWrite[];
   request_id: RequestId;
 }
 
 /** Response shape for GenerationBatch. */
 export interface GenerationBatchRead {
-  data: GenerationSummaryRead[];
+  data: GenerationRead[];
   request_id: RequestId;
 }
 
@@ -3104,7 +3242,11 @@ export interface ApiKey {
   name: string;
   /** Last four characters of the secret; the secret itself is never stored. */
   last4: string;
-  revoked: boolean;
+  /**
+   * active: the key authenticates requests. revoked: it no longer does and cannot be restored;
+   * create a new key in the Console or with typeship login.
+   */
+  status: "active" | "revoked";
   /** Format: date-time */
   last_used_at: string | null;
   /** Format: date-time */
@@ -3124,7 +3266,11 @@ export interface ApiKeyRead {
   name: string;
   /** Last four characters of the secret; the secret itself is never stored. */
   last4: string;
-  revoked: boolean;
+  /**
+   * active: the key authenticates requests. revoked: it no longer does and cannot be restored;
+   * create a new key in the Console or with typeship login.
+   */
+  status: ("active" | "revoked") | (string & {});
   /** Format: date-time */
   last_used_at: string | null;
   /** Format: date-time */
@@ -3150,15 +3296,6 @@ export interface UrlSpecRevisionSource {
   };
 }
 
-/** Response shape for UrlSpecRevisionSource. */
-export interface UrlSpecRevisionSourceRead {
-  type: "url" | (string & {});
-  url: {
-    /** Format: uri */
-    url: string;
-  };
-}
-
 export interface RepositorySpecRevisionSource {
   type: "repository";
   repository: {
@@ -3175,7 +3312,7 @@ export interface RepositorySpecRevisionSource {
 
 /** Response shape for RepositorySpecRevisionSource. */
 export interface RepositorySpecRevisionSourceRead {
-  type: "repository" | (string & {});
+  type: "repository";
   repository: {
     provider: RepositoryProvider | (string & {});
     identifier: RepositoryIdentifier;
@@ -3191,9 +3328,9 @@ export interface RepositorySpecRevisionSourceRead {
 export type SpecRevisionSource = UrlSpecRevisionSource | RepositorySpecRevisionSource;
 
 /** Response shape for SpecRevisionSource. */
-export type SpecRevisionSourceRead = UrlSpecRevisionSourceRead
+export type SpecRevisionSourceRead = UrlSpecRevisionSource
   | RepositorySpecRevisionSourceRead
-  | Record<string, unknown> & { type?: string };
+  | UnknownVariant<"type">;
 
 export interface SpecRevision {
   id: SpecRevisionId;
@@ -3257,7 +3394,18 @@ export type SpecRevisionResponseRead = SpecRevisionRead & ResponseMetadata;
 
 export interface ProjectList {
   object: ListObject;
-  data: ProjectSummary[];
+  data: Project[];
+  /** Whether another page is available after this one. */
+  has_more: boolean;
+  /** Pass this value as cursor to retrieve the next page; null on the last page. */
+  next_cursor: string | null;
+  request_id: RequestId;
+}
+
+/** Request shape for ProjectList. */
+export interface ProjectListWrite {
+  object: ListObject;
+  data: ProjectWrite[];
   /** Whether another page is available after this one. */
   has_more: boolean;
   /** Pass this value as cursor to retrieve the next page; null on the last page. */
@@ -3268,7 +3416,7 @@ export interface ProjectList {
 /** Response shape for ProjectList. */
 export interface ProjectListRead {
   object: ListObject;
-  data: ProjectSummaryRead[];
+  data: ProjectRead[];
   /** Whether another page is available after this one. */
   has_more: boolean;
   /** Pass this value as cursor to retrieve the next page; null on the last page. */
@@ -3278,7 +3426,7 @@ export interface ProjectListRead {
 
 export interface GenerationList {
   object: ListObject;
-  data: GenerationSummary[];
+  data: Generation[];
   /** Whether another page is available after this one. */
   has_more: boolean;
   /** Pass this value as cursor to retrieve the next page; null on the last page. */
@@ -3289,7 +3437,7 @@ export interface GenerationList {
 /** Request shape for GenerationList. */
 export interface GenerationListWrite {
   object: ListObject;
-  data: GenerationSummaryWrite[];
+  data: GenerationWrite[];
   /** Whether another page is available after this one. */
   has_more: boolean;
   /** Pass this value as cursor to retrieve the next page; null on the last page. */
@@ -3300,7 +3448,7 @@ export interface GenerationListWrite {
 /** Response shape for GenerationList. */
 export interface GenerationListRead {
   object: ListObject;
-  data: GenerationSummaryRead[];
+  data: GenerationRead[];
   /** Whether another page is available after this one. */
   has_more: boolean;
   /** Pass this value as cursor to retrieve the next page; null on the last page. */
@@ -3400,6 +3548,13 @@ export type ErrorType = (typeof ErrorType)[keyof typeof ErrorType];
 /** Stable programmatic identifier. Do not branch on message. */
 export const ErrorCode = {
   INPUT_INVALID: "input_invalid",
+  INPUT_MISSING: "input_missing",
+  INPUT_TYPE_INVALID: "input_type_invalid",
+  INPUT_FORMAT_INVALID: "input_format_invalid",
+  INPUT_TOO_LONG: "input_too_long",
+  INPUT_TOO_SHORT: "input_too_short",
+  INPUT_DUPLICATE: "input_duplicate",
+  INPUT_UNKNOWN: "input_unknown",
   QUERY_PARAM_INVALID: "query_param_invalid",
   CURSOR_INVALID: "cursor_invalid",
   METHOD_NOT_ALLOWED: "method_not_allowed",
@@ -3414,7 +3569,8 @@ export const ErrorCode = {
   INSUFFICIENT_SCOPE: "insufficient_scope",
   ROLE_INSUFFICIENT: "role_insufficient",
   RATE_LIMIT_EXCEEDED: "rate_limit_exceeded",
-  PLAN_LIMIT_REACHED: "plan_limit_reached",
+  FEATURE_NOT_AVAILABLE: "feature_not_available",
+  QUOTA_EXCEEDED: "quota_exceeded",
   SPEC_INVALID: "spec_invalid",
   SPEC_TOO_LARGE: "spec_too_large",
   SPEC_UNREACHABLE: "spec_unreachable",
@@ -3437,8 +3593,11 @@ export const ErrorCode = {
   PUBLICATION_RECOVERY_UNAVAILABLE: "publication_recovery_unavailable",
   PUBLICATION_FAILED: "publication_failed",
   DELIVERY_CONFLICT: "delivery_conflict",
+  DELIVERY_EXISTS: "delivery_exists",
   RESOURCE_HAS_DEPENDENCIES: "resource_has_dependencies",
   CUSTOMIZATION_CONFLICT: "customization_conflict",
+  CHECKS_FAILED: "checks_failed",
+  DRAFT_TITLE_INVALID: "draft_title_invalid",
   HISTORY_RECOVERY_REQUIRED: "history_recovery_required",
   CHECKS_UNAVAILABLE: "checks_unavailable",
   DEPENDENCY_MISSING: "dependency_missing",
@@ -3780,6 +3939,25 @@ export interface AuthenticationConfigResponse {
   approval_url?: string | null;
   /** Authentication selections keyed by generated API environment name. */
   environments?: Record<string, AuthenticationEnvironmentResponse> | null;
+  /**
+   * Environment variables the generated CLI, MCP server, and SDK environment fallbacks read, keyed
+   * by security scheme name. A string names the token or key variable; a Basic scheme takes {
+   * username, password }. Wins over the scheme's x-typeship-env extension. Without either, names
+   * derive from the package and scheme.
+   */
+  credential_variables?: Record<string, string | {
+    username: string;
+    password: string;
+  }>
+    | null;
+  /**
+   * Whether a parameter carries the operation's credential, keyed by operationId, "METHOD /path",
+   * or "*" for every operation, then by the parameter's wire name. true leaves the parameter out of
+   * generated signatures, CLI flags, and MCP tool input, because the configured credential already
+   * reaches the API; false keeps it. Wins over the parameter's x-typeship-credential extension and
+   * the generator's inference.
+   */
+  credential_parameters?: Record<string, Record<string, boolean>> | null;
 }
 
 export interface TargetAuthenticationEnvironmentResponse {
@@ -4001,6 +4179,13 @@ export interface ReadmeBehaviorResponse {
  * destination.
  */
 export interface PackageBehaviorResponse {
+  /**
+   * The API's name as generated READMEs, AGENTS.md, package descriptions, and help text show it,
+   * such as "Parcel" for a Spec titled "Parcel - Public API". Display only: package, client, and
+   * command names still come from the Spec. Defaults to the Spec title with common noise removed
+   * ("Parcel - API" shows as Parcel).
+   */
+  title?: string | null;
   /** Homepage written into registry metadata. */
   homepage?: string | null;
   /** SPDX identifier written into registry metadata. Defaults to info.license. */
@@ -4016,79 +4201,6 @@ export interface PackageBehaviorResponse {
   go_package_name?: string | null;
 }
 
-/**
- * Everything Typeship needs beyond the Spec, in one object: generation customization (globals,
- * retries, pagination, readme) and how the generated tooling behaves (cli, mcp, package, docs_url).
- * Plain configuration. Typeship never requires vendor extensions inside the Spec itself. One-shot
- * generation also accepts GraphQL settings here; stored projects keep those settings on their Spec.
- */
-export interface ConfigResponse {
-  /**
-   * Wire names of query/header parameters that become settable once on the generated client and
-   * auto-apply to every operation that accepts them; per-call values win. Names that match nothing
-   * are reported as generation warnings.
-   */
-  globals?: string[];
-  retries?: RetryTuningResponse;
-  /**
-   * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
-   * reported as generation warnings.
-   */
-  pagination?: Record<string, PaginationRuleResponse | boolean>;
-  graphql?: GraphqlSettingsResponse;
-  auth?: AuthenticationConfigResponse;
-  cli?: CliBehaviorResponse;
-  mcp?: McpBehaviorResponse;
-  readme?: ReadmeBehaviorResponse;
-  package?: PackageBehaviorResponse;
-  /**
-   * The API's documentation site. Read through its llms.txt by the generated CLI's docs command,
-   * the MCP server's docs tools, and the package's AGENTS.md. Defaults to the Spec's externalDocs
-   * URL.
-   * Format: uri
-   */
-  docs_url?: string | null;
-  /**
-   * Exact llms.txt URL when the documentation site does not publish it at docs_url + /llms.txt.
-   * Format: uri
-   */
-  docs_index_url?: string | null;
-}
-
-/** Response shape for ConfigResponse. */
-export interface ConfigResponseRead {
-  /**
-   * Wire names of query/header parameters that become settable once on the generated client and
-   * auto-apply to every operation that accepts them; per-call values win. Names that match nothing
-   * are reported as generation warnings.
-   */
-  globals?: string[];
-  retries?: RetryTuningResponse;
-  /**
-   * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
-   * reported as generation warnings.
-   */
-  pagination?: Record<string, PaginationRuleResponseRead | boolean>;
-  graphql?: GraphqlSettingsResponseRead;
-  auth?: AuthenticationConfigResponse;
-  cli?: CliBehaviorResponse;
-  mcp?: McpBehaviorResponseRead;
-  readme?: ReadmeBehaviorResponse;
-  package?: PackageBehaviorResponse;
-  /**
-   * The API's documentation site. Read through its llms.txt by the generated CLI's docs command,
-   * the MCP server's docs tools, and the package's AGENTS.md. Defaults to the Spec's externalDocs
-   * URL.
-   * Format: uri
-   */
-  docs_url?: string | null;
-  /**
-   * Exact llms.txt URL when the documentation site does not publish it at docs_url + /llms.txt.
-   * Format: uri
-   */
-  docs_index_url?: string | null;
-}
-
 /**
  * Shared generated-client and tooling behavior for a stored Project. Every Target inherits these
  * defaults. Target.config is merged over them for one Target; top-level values replace defaults
@@ -4102,6 +4214,16 @@ export interface ProjectConfigResponse {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuningResponse;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -4135,6 +4257,16 @@ export interface ProjectConfigResponseRead {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuningResponse;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -4172,6 +4304,16 @@ export interface TargetConfigResponse {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuningResponse;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -4205,6 +4347,16 @@ export interface TargetConfigResponseRead {
    * are reported as generation warnings.
    */
   globals?: string[];
+  /**
+   * Generate only matching operations: tag names, or path globs such as `/zones/**` (`*` is one
+   * path segment, `**` any number), optionally after an HTTP method (`DELETE /zones/*`). Applied
+   * before the Spec size limit, with components nothing references any more removed, so a one-shot
+   * run can generate part of a Spec up to 64 MB. Selectors that match nothing are reported as
+   * generation warnings.
+   */
+  include?: string[];
+  /** Leave out matching operations (tag names or path globs, as for `include`). Wins over `include`. */
+  exclude?: string[];
   retries?: RetryTuningResponse;
   /**
    * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
@@ -4249,14 +4401,21 @@ export interface GraphqlSettingsResponse {
   }>;
   /**
    * How requests authenticate. bearer sends Authorization: Bearer; basic is for key-pair APIs
-   * (public key as username, private key as password); api_key sends a header named by
-   * api_key_header; none generates no auth option.
+   * (public key as username, private key as password); basic_api_key sends one API key as the
+   * Basic-auth username with an empty password; api_key sends a header named by api_key_header;
+   * api_key_or_bearer sends a key in api_key_header (Authorization for a raw key) and also accepts
+   * an OAuth access token as Authorization: Bearer; none generates no auth option.
    * Default: "bearer"
    */
-  auth?: "bearer" | "basic" | "api_key" | "none";
+  auth?: "bearer"
+    | "basic"
+    | "basic_api_key"
+    | "api_key"
+    | "api_key_or_bearer"
+    | "none";
   /**
-   * Header carrying the key when auth is api_key. Required for that mode; Typeship does not invent
-   * a vendor-specific header name.
+   * Header carrying the key when auth is api_key or api_key_or_bearer. Required for those modes;
+   * Typeship does not invent a vendor-specific header name.
    */
   api_key_header?: string;
   /**
@@ -4269,6 +4428,20 @@ export interface GraphqlSettingsResponse {
    * generate as the language's untyped JSON value and produce a warning. Unmatched keys warn.
    */
   scalars?: Record<string, "string" | "integer" | "number" | "boolean" | "json">;
+  /**
+   * Object types that report a failure when an operation's union or interface result resolves to
+   * them (errors returned as data). Replaces the default, which is every member whose name ends in
+   * Error when the result can also be something else. An empty array treats no result as a failure.
+   * Names that are not object types in the schema produce a generation warning.
+   */
+  error_types?: string[];
+  /**
+   * Page size a paginated connection call sends as first when the caller passes neither first nor
+   * last. Relay servers such as GitHub reject a connection query without one. Ignored for a
+   * connection whose first argument has a schema default.
+   * Default: 100
+   */
+  page_size?: number;
 }
 
 /** Response shape for GraphqlSettingsResponse. */
@@ -4290,14 +4463,21 @@ export interface GraphqlSettingsResponseRead {
   }>;
   /**
    * How requests authenticate. bearer sends Authorization: Bearer; basic is for key-pair APIs
-   * (public key as username, private key as password); api_key sends a header named by
-   * api_key_header; none generates no auth option.
+   * (public key as username, private key as password); basic_api_key sends one API key as the
+   * Basic-auth username with an empty password; api_key sends a header named by api_key_header;
+   * api_key_or_bearer sends a key in api_key_header (Authorization for a raw key) and also accepts
+   * an OAuth access token as Authorization: Bearer; none generates no auth option.
    * Default: "bearer"
    */
-  auth?: ("bearer" | "basic" | "api_key" | "none") | (string & {});
+  auth?: ("bearer"
+    | "basic"
+    | "basic_api_key"
+    | "api_key"
+    | "api_key_or_bearer"
+    | "none") | (string & {});
   /**
-   * Header carrying the key when auth is api_key. Required for that mode; Typeship does not invent
-   * a vendor-specific header name.
+   * Header carrying the key when auth is api_key or api_key_or_bearer. Required for those modes;
+   * Typeship does not invent a vendor-specific header name.
    */
   api_key_header?: string;
   /**
@@ -4310,6 +4490,20 @@ export interface GraphqlSettingsResponseRead {
    * generate as the language's untyped JSON value and produce a warning. Unmatched keys warn.
    */
   scalars?: Record<string, ("string" | "integer" | "number" | "boolean" | "json") | (string & {})>;
+  /**
+   * Object types that report a failure when an operation's union or interface result resolves to
+   * them (errors returned as data). Replaces the default, which is every member whose name ends in
+   * Error when the result can also be something else. An empty array treats no result as a failure.
+   * Names that are not object types in the schema produce a generation warning.
+   */
+  error_types?: string[];
+  /**
+   * Page size a paginated connection call sends as first when the caller passes neither first nor
+   * last. Relay servers such as GitHub reject a connection query without one. Ignored for a
+   * connection whose first argument has a schema default.
+   * Default: 100
+   */
+  page_size?: number;
 }
 
 /**
@@ -4377,19 +4571,6 @@ export const GitFileMode = {
 } as const;
 export type GitFileMode = (typeof GitFileMode)[keyof typeof GitFileMode];
 
-/**
- * One side of a Draft file comparison: base is the last merged version, yours is your repository
- * edit, and generated is the new version Typeship proposes for this conflict stage. The conflict
- * source identifies whether that version comes from a Generation, the default branch, or a saved
- * Draft. Missing sides represent deleted or absent files.
- */
-export const DraftFileSide = {
-  BASE: "base",
-  YOURS: "yours",
-  GENERATED: "generated",
-} as const;
-export type DraftFileSide = (typeof DraftFileSide)[keyof typeof DraftFileSide];
-
 /**
  * File IDs for each side of a conflict or history comparison. null means the file is absent on that
  * side.