@typeship-ax/cli 0.22.0 → 0.24.0

package/dist/types.d.ts

@@ -1,3 +1,15 @@
+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;
 /** Unique identifier for a generation. */
@@ -20,7 +32,6 @@ export type DeliveryId = string;
 /** Unique identifier for a Draft. */
 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
@@ -58,7 +69,10 @@ export interface UrlSpecInputRead {
     url: string;
 }
 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;
 }
 /** A Spec for one-shot generation, provided as exactly one URL or inline entrypoint. */
@@ -312,6 +326,8 @@ export interface SpecRevisionFileListRead {
     request_id: RequestId;
 }
 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[];
@@ -330,6 +346,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[];
@@ -388,11 +406,6 @@ export interface UrlSpecSourceWrite {
     type: "url";
     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 declare const RepositoryProvider: {
     readonly GITHUB: "github";
@@ -400,15 +413,6 @@ export declare const RepositoryProvider: {
 export type RepositoryProvider = (typeof RepositoryProvider)[keyof typeof RepositoryProvider];
 /** 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;
@@ -428,7 +432,7 @@ export interface RepositorySpecSource {
 }
 /** Response shape for RepositorySpecSource. */
 export interface RepositorySpecSourceRead {
-    type: "repository" | (string & {});
+    type: "repository";
     repository: RepositorySpecSourceSettingsRead;
 }
 /** The single source of truth for where a Project's Spec lives. */
@@ -436,9 +440,7 @@ export type SpecSource = UrlSpecSource | RepositorySpecSource;
 /** Request shape for SpecSource. */
 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 {
     /**
      * URL of an OpenAPI document, GraphQL SDL file, or GraphQL endpoint.
@@ -467,7 +469,7 @@ export interface UrlSpecSourceInput {
 }
 /** Response shape for UrlSpecSourceInput. */
 export interface UrlSpecSourceInputRead {
-    type: "url" | (string & {});
+    type: "url";
     url: UrlSpecSourceSettingsInputRead;
 }
 export interface RepositorySpecSourceSettingsInput {
@@ -489,14 +491,12 @@ export interface RepositorySpecSourceInput {
 }
 /** Response shape for RepositorySpecSourceInput. */
 export interface RepositorySpecSourceInputRead {
-    type: "repository" | (string & {});
+    type: "repository";
     repository: RepositorySpecSourceSettingsInputRead;
 }
 export type SpecSourceInput = UrlSpecSourceInput | RepositorySpecSourceInput;
 /** Response shape for SpecSourceInput. */
-export type SpecSourceInputRead = UrlSpecSourceInputRead | RepositorySpecSourceInputRead | Record<string, unknown> & {
-    type?: string;
-};
+export type SpecSourceInputRead = UrlSpecSourceInputRead | RepositorySpecSourceInputRead | UnknownVariant<"type">;
 /**
  * A fix applied to the resolved Spec before generation. Paths are JSON
  * Pointers into the document. A patch whose target no longer exists is
@@ -533,8 +533,26 @@ export interface SpecPatchRead {
     to?: string | null;
     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. */
@@ -583,13 +601,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. */
@@ -604,7 +623,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;
     /**
@@ -619,13 +641,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. */
@@ -640,7 +663,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;
     /**
@@ -778,21 +804,61 @@ export interface RepositoryDeliveryInput {
 }
 /** Response shape for RepositoryDeliveryInput. */
 export interface RepositoryDeliveryInputRead {
-    type: "repository" | (string & {});
+    type: "repository";
     repository: RepositoryDeliverySettingsInputRead;
 }
 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;
-};
+export type DeliveryInputRead = RepositoryDeliveryInputRead | 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;
     identifier: RepositoryIdentifier;
@@ -846,7 +912,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.
@@ -915,7 +981,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.
@@ -929,9 +995,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;
  * hosted_mcp is present for a hosted_mcp Delivery.
@@ -1013,7 +1077,6 @@ export interface TargetChecksRead {
 export interface TargetCreateRequest {
     project_id: ProjectId;
     name: string;
-    spec_id: SpecId;
     type: GeneratorKind;
     /** Default: "active" */
     status?: "active" | "disabled";
@@ -1031,7 +1094,6 @@ export interface TargetCreateRequest {
 export interface TargetCreateRequestRead {
     project_id: ProjectId;
     name: string;
-    spec_id: SpecId;
     type: GeneratorKind | (string & {});
     /** Default: "active" */
     status?: ("active" | "disabled") | (string & {});
@@ -1086,14 +1148,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. */
 export interface TargetUpdateRequestRead {
@@ -1106,14 +1160,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[];
 }
 /**
  * All Targets follow reviewed SemVer. Before 1.0.0, breaking changes require a minor version; the
@@ -1234,21 +1280,6 @@ export interface DeliveryListRead {
     next_cursor: string | null;
     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[];
@@ -1296,7 +1327,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;
     /**
@@ -1326,9 +1358,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;
 }
 /** Response shape for Release. */
@@ -1341,7 +1383,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;
     /**
@@ -1371,9 +1414,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;
 }
 export type ReleaseResponse = Release & ResponseMetadata;
@@ -1394,12 +1447,20 @@ export interface ReleaseListRead {
     next_cursor: string | null;
     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;
@@ -1421,11 +1482,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;
@@ -1445,18 +1513,15 @@ export interface PublicationRead {
     /** Format: date-time */
     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 declare const DraftStatus: {
-    readonly NONE: "none";
+    readonly IDLE: "idle";
     readonly WORKING: "working";
     readonly ACTION_REQUIRED: "action_required";
     readonly READY: "ready";
@@ -1465,8 +1530,8 @@ export declare const DraftStatus: {
 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 declare const DraftActionReason: {
     readonly CONFLICT: "conflict";
@@ -1491,64 +1556,49 @@ export interface DraftHistoryRecovery {
     /** Existing Draft branch that stays available after recovery opens a new Draft. */
     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;
 }
 /**
  * One reviewed package change for a Target. A Target has one open Draft, named by its draft_id;
@@ -1567,16 +1617,23 @@ 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. */
@@ -1624,16 +1681,23 @@ 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. */
@@ -1840,7 +1904,7 @@ export interface Project {
      * Format: date-time
      */
     updated_at: string;
-    request_id: RequestId;
+    request_id?: RequestId;
 }
 /** Request shape for Project. */
 export interface ProjectWrite {
@@ -1856,7 +1920,7 @@ export interface ProjectWrite {
      * settings remain Spec-owned.
      */
     config: ProjectConfigResponse | null;
-    request_id: RequestId;
+    request_id?: RequestId;
 }
 /** Response shape for Project. */
 export interface ProjectRead {
@@ -1881,35 +1945,13 @@ export interface ProjectRead {
      * Format: date-time
      */
     updated_at: string;
-    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;
-}
-/** 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_id?: RequestId;
 }
+export type ProjectResponse = Project & ResponseMetadata;
+/** Request shape for ProjectResponse. */
+export type ProjectResponseWrite = ProjectWrite & ResponseMetadata;
+/** Response shape for ProjectResponse. */
+export type ProjectResponseRead = ProjectRead & ResponseMetadata;
 export interface CreateProjectRequest {
     name: string;
     spec: SpecFields;
@@ -2127,6 +2169,24 @@ 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 {
     oauth_application?: string | null;
@@ -2338,6 +2398,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. */
@@ -2365,6 +2432,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
@@ -2398,6 +2475,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
@@ -2436,6 +2523,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
@@ -2468,6 +2565,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
@@ -2504,6 +2611,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
@@ -2536,6 +2653,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
@@ -2579,14 +2706,16 @@ 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;
     /**
@@ -2599,6 +2728,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. */
 export interface GraphqlSettingsRead {
@@ -2619,14 +2762,16 @@ 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;
     /**
@@ -2639,6 +2784,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;
 }
 /**
  * Retry behavior. Top-level fields adjust every operation; operations maps operationId or "METHOD
@@ -2683,17 +2842,6 @@ export interface PaginationRuleRead {
     offset_param?: string;
     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.
@@ -2800,49 +2948,27 @@ export interface GenerationRead {
     /** Format: date-time */
     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. */
 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;
 }
 export interface ApiKey {
@@ -2851,7 +2977,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 */
@@ -2870,7 +3000,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 */
@@ -2892,14 +3026,6 @@ export interface UrlSpecRevisionSource {
         url: string;
     };
 }
-/** Response shape for UrlSpecRevisionSource. */
-export interface UrlSpecRevisionSourceRead {
-    type: "url" | (string & {});
-    url: {
-        /** Format: uri */
-        url: string;
-    };
-}
 export interface RepositorySpecRevisionSource {
     type: "repository";
     repository: {
@@ -2915,7 +3041,7 @@ export interface RepositorySpecRevisionSource {
 }
 /** Response shape for RepositorySpecRevisionSource. */
 export interface RepositorySpecRevisionSourceRead {
-    type: "repository" | (string & {});
+    type: "repository";
     repository: {
         provider: RepositoryProvider | (string & {});
         identifier: RepositoryIdentifier;
@@ -2929,9 +3055,7 @@ export interface RepositorySpecRevisionSourceRead {
 }
 export type SpecRevisionSource = UrlSpecRevisionSource | RepositorySpecRevisionSource;
 /** Response shape for SpecRevisionSource. */
-export type SpecRevisionSourceRead = UrlSpecRevisionSourceRead | RepositorySpecRevisionSourceRead | Record<string, unknown> & {
-    type?: string;
-};
+export type SpecRevisionSourceRead = UrlSpecRevisionSource | RepositorySpecRevisionSourceRead | UnknownVariant<"type">;
 export interface SpecRevision {
     id: SpecRevisionId;
     object: "spec_revision";
@@ -2990,7 +3114,17 @@ export type SpecRevisionResponse = SpecRevision & ResponseMetadata;
 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. */
@@ -3000,7 +3134,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. */
@@ -3009,7 +3143,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. */
@@ -3019,7 +3153,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. */
@@ -3029,7 +3163,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. */
@@ -3119,6 +3253,13 @@ export type ErrorType = (typeof ErrorType)[keyof typeof ErrorType];
 /** Stable programmatic identifier. Do not branch on message. */
 export declare const ErrorCode: {
     readonly INPUT_INVALID: "input_invalid";
+    readonly INPUT_MISSING: "input_missing";
+    readonly INPUT_TYPE_INVALID: "input_type_invalid";
+    readonly INPUT_FORMAT_INVALID: "input_format_invalid";
+    readonly INPUT_TOO_LONG: "input_too_long";
+    readonly INPUT_TOO_SHORT: "input_too_short";
+    readonly INPUT_DUPLICATE: "input_duplicate";
+    readonly INPUT_UNKNOWN: "input_unknown";
     readonly QUERY_PARAM_INVALID: "query_param_invalid";
     readonly CURSOR_INVALID: "cursor_invalid";
     readonly METHOD_NOT_ALLOWED: "method_not_allowed";
@@ -3133,7 +3274,8 @@ export declare const ErrorCode: {
     readonly INSUFFICIENT_SCOPE: "insufficient_scope";
     readonly ROLE_INSUFFICIENT: "role_insufficient";
     readonly RATE_LIMIT_EXCEEDED: "rate_limit_exceeded";
-    readonly PLAN_LIMIT_REACHED: "plan_limit_reached";
+    readonly FEATURE_NOT_AVAILABLE: "feature_not_available";
+    readonly QUOTA_EXCEEDED: "quota_exceeded";
     readonly SPEC_INVALID: "spec_invalid";
     readonly SPEC_TOO_LARGE: "spec_too_large";
     readonly SPEC_UNREACHABLE: "spec_unreachable";
@@ -3156,8 +3298,11 @@ export declare const ErrorCode: {
     readonly PUBLICATION_RECOVERY_UNAVAILABLE: "publication_recovery_unavailable";
     readonly PUBLICATION_FAILED: "publication_failed";
     readonly DELIVERY_CONFLICT: "delivery_conflict";
+    readonly DELIVERY_EXISTS: "delivery_exists";
     readonly RESOURCE_HAS_DEPENDENCIES: "resource_has_dependencies";
     readonly CUSTOMIZATION_CONFLICT: "customization_conflict";
+    readonly CHECKS_FAILED: "checks_failed";
+    readonly DRAFT_TITLE_INVALID: "draft_title_invalid";
     readonly HISTORY_RECOVERY_REQUIRED: "history_recovery_required";
     readonly CHECKS_UNAVAILABLE: "checks_unavailable";
     readonly DEPENDENCY_MISSING: "dependency_missing";
@@ -3480,6 +3625,24 @@ 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 {
     oauth_application?: string | null;
@@ -3691,6 +3854,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. */
@@ -3705,77 +3875,6 @@ export interface PackageBehaviorResponse {
     /** Go identifier when the destination repository name is unsuitable. */
     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
@@ -3789,6 +3888,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
@@ -3821,6 +3930,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
@@ -3857,6 +3976,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
@@ -3889,6 +4018,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
@@ -3932,14 +4071,16 @@ 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;
     /**
@@ -3952,6 +4093,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. */
 export interface GraphqlSettingsResponseRead {
@@ -3972,14 +4127,16 @@ 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;
     /**
@@ -3992,6 +4149,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;
 }
 /**
  * Retry behavior. Top-level fields adjust every operation; operations maps operationId or "METHOD
@@ -4052,18 +4223,6 @@ export declare const GitFileMode: {
     readonly V_120000: "120000";
 };
 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 declare const DraftFileSide: {
-    readonly BASE: "base";
-    readonly YOURS: "yours";
-    readonly GENERATED: "generated";
-};
-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.
@@ -4272,4 +4431,5 @@ export interface DraftRecoverRequest {
     /** The Draft's history_recovery.head_sha; null when the Draft branch is absent. */
     expected_head_sha: string | null;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map