@typeship-ax/mcp 0.10.0 → 0.20.0

package/dist/types.d.ts

@@ -2,12 +2,10 @@
 export type ProjectId = string;
 /** Unique identifier for a generation. */
 export type GenerationId = string;
-/** Unique identifier for a project's logical API Definition. */
-export type DefinitionId = string;
-/** Unique identifier for a source document captured in a Definition Revision. */
-export type DefinitionDocumentId = string;
-/** Unique identifier for an immutable resolved Definition Revision. */
-export type DefinitionRevisionId = string;
+/** Unique identifier for a project's logical API Spec. */
+export type SpecId = string;
+/** Unique identifier for an immutable resolved Spec Revision. */
+export type SpecRevisionId = string;
 /** Server-generated identifier used to correlate this response with Typeship logs. */
 export type RequestId = string;
 /** Request-level metadata present at the top level of every JSON response. */
@@ -19,21 +17,25 @@ export type ListObject = "list";
 /** Stable identifier for one configured generated product. */
 export type TargetId = string;
 export type DeliveryId = string;
-export type TargetReleaseId = 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.
+ * Targets may use the same generator. cli is the TypeScript CLI; go_cli is the native Go CLI, a
+ * distinct product that imports one exact paired Go SDK module rather than a client of its own.
  */
 export declare const GeneratorKind: {
-    readonly TYPESCRIPT_SDK: "typescript-sdk";
-    readonly PYTHON_SDK: "python-sdk";
-    readonly GO_SDK: "go-sdk";
     readonly CLI: "cli";
+    readonly GO_CLI: "go_cli";
     readonly MCP: "mcp";
+    readonly TYPESCRIPT_SDK: "typescript_sdk";
+    readonly PYTHON_SDK: "python_sdk";
+    readonly GO_SDK: "go_sdk";
 };
 export type GeneratorKind = (typeof GeneratorKind)[keyof typeof GeneratorKind];
-export interface UrlDefinitionInput {
+export interface UrlSpecInput {
     /**
      * URL of an OpenAPI document, a GraphQL SDL file, or a GraphQL
      * endpoint (introspected automatically). Fetched server-side.
@@ -42,12 +44,12 @@ export interface UrlDefinitionInput {
     url: string;
     /**
      * Request headers for a protected URL. Sent on the document GET and GraphQL introspection POST,
-     * never returned or retained by stateless generation.
+     * never returned or retained by one-shot generation.
      */
     headers?: Record<string, string>;
 }
-/** Response shape for UrlDefinitionInput. */
-export interface UrlDefinitionInputRead {
+/** Response shape for UrlSpecInput. */
+export interface UrlSpecInputRead {
     /**
      * URL of an OpenAPI document, a GraphQL SDL file, or a GraphQL
      * endpoint (introspected automatically). Fetched server-side.
@@ -55,19 +57,47 @@ export interface UrlDefinitionInputRead {
      */
     url: string;
 }
-export interface InlineDefinitionInput {
-    /** Raw Definition text (OpenAPI JSON/YAML or GraphQL SDL). Up to 10MB. */
+export interface InlineSpecInput {
+    /** Raw Spec text (OpenAPI JSON/YAML or GraphQL SDL). Up to 10MB. */
     inline: string;
 }
-/** A Definition for stateless generation, provided as exactly one URL or inline entrypoint. */
-export type DefinitionInput = UrlDefinitionInput | InlineDefinitionInput;
-/** Response shape for DefinitionInput. */
-export type DefinitionInputRead = UrlDefinitionInputRead | InlineDefinitionInput;
+/** A Spec for one-shot generation, provided as exactly one URL or inline entrypoint. */
+export type SpecInput = UrlSpecInput | InlineSpecInput;
+/** Response shape for SpecInput. */
+export type SpecInputRead = UrlSpecInputRead | InlineSpecInput;
+/**
+ * The exact paired Go SDK a go_cli generation is built on. Required when target.type is go_cli and
+ * rejected otherwise. The descriptor is closed and immutable, because a CLI that pins a range or a
+ * branch pins nothing.
+ */
+export interface GoSdkDescriptor {
+    /**
+     * Go module path of the SDK the CLI imports, for example github.com/acme/payments-go. Must be a
+     * valid Go module path.
+     */
+    module_path: string;
+    /**
+     * Exact SDK module version the CLI requires: v-prefixed SemVer such as v1.2.3, or an immutable Go
+     * pseudo-version naming a commit such as v0.0.0-20240824120000-abcdef123456. Ranges, branches,
+     * and "latest" are rejected.
+     */
+    version: string;
+    /**
+     * SHA-256 hex digest of the Spec the SDK was generated from. Must match the resolved Spec, or the
+     * request fails with spec_error.
+     */
+    spec_digest: string;
+    /**
+     * Go package identifier of the SDK, when the module path's last element does not imply it.
+     * Optional.
+     */
+    package_name?: string;
+}
 export interface GenerateRequest {
-    definition: DefinitionInput;
-    /** Stateless generator descriptor; no persisted Target is created. */
+    spec: SpecInput;
+    /** One-shot generator descriptor; no persisted Target is created. */
     target: {
-        generator: GeneratorKind;
+        type: GeneratorKind;
     };
     /**
      * npm package or Python distribution override. Valid only for the TypeScript and Python SDK
@@ -75,18 +105,19 @@ export interface GenerateRequest {
      */
     package_name?: string;
     /**
-     * Go module path override. Valid only for the Go SDK. Linked projects derive this from the Go
-     * destination repository by default.
+     * Go module path override for the generated artifact's own module. Valid only for the Go SDK and
+     * Go CLI Targets. Projects derive this from the Go destination repository by default.
      */
     module_path?: string;
+    go_sdk?: GoSdkDescriptor;
     config?: Config;
 }
 /** Response shape for GenerateRequest. */
 export interface GenerateRequestRead {
-    definition: DefinitionInputRead;
-    /** Stateless generator descriptor; no persisted Target is created. */
+    spec: SpecInputRead;
+    /** One-shot generator descriptor; no persisted Target is created. */
     target: {
-        generator: GeneratorKind | (string & {});
+        type: GeneratorKind | (string & {});
     };
     /**
      * npm package or Python distribution override. Valid only for the TypeScript and Python SDK
@@ -94,195 +125,201 @@ export interface GenerateRequestRead {
      */
     package_name?: string;
     /**
-     * Go module path override. Valid only for the Go SDK. Linked projects derive this from the Go
-     * destination repository by default.
+     * Go module path override for the generated artifact's own module. Valid only for the Go SDK and
+     * Go CLI Targets. Projects derive this from the Go destination repository by default.
      */
     module_path?: string;
+    go_sdk?: GoSdkDescriptor;
     config?: ConfigRead;
 }
 export interface GeneratedFile {
     /** Repo-relative path inside the generated package. */
     path: string;
     content: string;
+    /**
+     * Exact Git file mode. Omitted one-shot outputs are regular files.
+     * Default: "100644"
+     */
+    mode?: "100644" | "100755";
 }
-export interface GenerationMeta {
-    title: string;
-    /** Version declared by the customer's API Definition. It never controls package releases. */
-    api_version: string;
-    /** Package version selected by the Target's release stream for this generation. */
-    version: string;
-    spec_format?: "openapi" | "graphql";
-    /** Detected OpenAPI version, "2.0", "3.0", or "3.1". */
-    oas_version: string;
-    /** True when the input was Swagger 2.0 and was converted. */
-    converted?: boolean;
-    /** Ecosystem-neutral identity of the generated artifact. */
-    artifact_name: string;
-    client_name: string;
-    /**
-     * Generator implementations present in this artifact. Persisted Target identity is reported on
-     * Generation.
-     */
-    generators: GeneratorKind[];
-    resource_count?: number;
-    operation_count?: number;
-    schema_count?: number;
-    paginated_operation_count?: number;
-    /** Operations beyond the plan's endpoint allowance, not generated. */
-    omitted_operation_count?: number;
-    /** METHOD/path identities of operations omitted by the generation cap. */
-    omitted_operations?: string[];
-    /** Pull request opened by this regeneration, when one was. */
-    pr_url?: string | null;
-    pr_number?: number | null;
-    /**
-     * Whether a destination pull request opened, was unnecessary because the generated tree already
-     * matched, or could not be opened.
-     */
-    pr_status?: "opened" | "no_changes" | "blocked";
-    /**
-     * Why the configured destination pull request was not opened. Generation itself still succeeded;
-     * fix this action and regenerate.
-     */
-    pr_error?: string;
-    /**
-     * Markdown changelog entry for this regeneration, from the API surface diff. Absent on a first
-     * generation or when nothing changed.
-     */
-    changelog?: string;
-    /**
-     * Breaking changes in the diff; removed methods and fields, changed types, inputs that became
-     * required.
-     */
-    breaking_count?: number;
-    /**
-     * What the diff was measured against; "destination" means the .typeship/surface.json merged in
-     * the destination repository.
-     */
-    baseline?: "destination" | "none";
-    /** Objective compatibility of the generated API surface against the merged destination baseline. */
-    api_compatibility?: "compatible" | "breaking" | "unknown";
-    /**
-     * Objective compatibility of public package entry points and selected targets against the merged
-     * destination baseline.
-     */
-    package_compatibility?: "compatible" | "breaking" | "unknown";
-    /**
-     * Whether the generated package version satisfies the cumulative change. Null when there is no
-     * prior version or analysis is unavailable.
-     */
-    version_correct?: boolean | null;
-    /**
-     * The destination pull request's combined readiness decision for the exact bot-generated head.
-     * Compatibility and version correctness remain separate fields above.
-     */
-    release_readiness?: "success" | "failure" | "error";
-    /** The release-readiness decision in one line, as the commit status describes it. */
-    release_readiness_note?: string;
-    /** The package version the destination had before this regeneration. */
-    previous_version?: string;
-    file_count?: number;
-    total_lines?: number;
-    /** Deterministic Diagnostic summary for the exact Definition Revision consumed. */
-    diagnostics?: {
-        format: "openapi" | "graphql";
-        summary: DiagnosticSummary;
-    };
+/** Response shape for GeneratedFile. */
+export interface GeneratedFileRead {
+    /** Repo-relative path inside the generated package. */
+    path: string;
+    content: string;
+    /**
+     * Exact Git file mode. Omitted one-shot outputs are regular files.
+     * Default: "100644"
+     */
+    mode?: ("100644" | "100755") | (string & {});
 }
-/** Response shape for GenerationMeta. */
-export interface GenerationMetaRead {
-    title: string;
-    /** Version declared by the customer's API Definition. It never controls package releases. */
-    api_version: string;
-    /** Package version selected by the Target's release stream for this generation. */
-    version: string;
-    spec_format?: ("openapi" | "graphql") | (string & {});
-    /** Detected OpenAPI version, "2.0", "3.0", or "3.1". */
-    oas_version: string;
-    /** True when the input was Swagger 2.0 and was converted. */
-    converted?: boolean;
-    /** Ecosystem-neutral identity of the generated artifact. */
-    artifact_name: string;
-    client_name: string;
-    /**
-     * Generator implementations present in this artifact. Persisted Target identity is reported on
-     * Generation.
-     */
-    generators: Array<GeneratorKind | (string & {})>;
-    resource_count?: number;
-    operation_count?: number;
-    schema_count?: number;
-    paginated_operation_count?: number;
-    /** Operations beyond the plan's endpoint allowance, not generated. */
-    omitted_operation_count?: number;
-    /** METHOD/path identities of operations omitted by the generation cap. */
-    omitted_operations?: string[];
-    /** Pull request opened by this regeneration, when one was. */
-    pr_url?: string | null;
-    pr_number?: number | null;
-    /**
-     * Whether a destination pull request opened, was unnecessary because the generated tree already
-     * matched, or could not be opened.
-     */
-    pr_status?: ("opened" | "no_changes" | "blocked") | (string & {});
-    /**
-     * Why the configured destination pull request was not opened. Generation itself still succeeded;
-     * fix this action and regenerate.
-     */
-    pr_error?: string;
-    /**
-     * Markdown changelog entry for this regeneration, from the API surface diff. Absent on a first
-     * generation or when nothing changed.
-     */
-    changelog?: string;
-    /**
-     * Breaking changes in the diff; removed methods and fields, changed types, inputs that became
-     * required.
-     */
-    breaking_count?: number;
-    /**
-     * What the diff was measured against; "destination" means the .typeship/surface.json merged in
-     * the destination repository.
-     */
-    baseline?: ("destination" | "none") | (string & {});
-    /** Objective compatibility of the generated API surface against the merged destination baseline. */
-    api_compatibility?: ("compatible" | "breaking" | "unknown") | (string & {});
-    /**
-     * Objective compatibility of public package entry points and selected targets against the merged
-     * destination baseline.
-     */
-    package_compatibility?: ("compatible" | "breaking" | "unknown") | (string & {});
-    /**
-     * Whether the generated package version satisfies the cumulative change. Null when there is no
-     * prior version or analysis is unavailable.
-     */
-    version_correct?: boolean | null;
-    /**
-     * The destination pull request's combined readiness decision for the exact bot-generated head.
-     * Compatibility and version correctness remain separate fields above.
-     */
-    release_readiness?: ("success" | "failure" | "error") | (string & {});
-    /** The release-readiness decision in one line, as the commit status describes it. */
-    release_readiness_note?: string;
-    /** The package version the destination had before this regeneration. */
-    previous_version?: string;
-    file_count?: number;
-    total_lines?: number;
-    /** Deterministic Diagnostic summary for the exact Definition Revision consumed. */
-    diagnostics?: {
-        format: ("openapi" | "graphql") | (string & {});
-        summary: DiagnosticSummary;
-    };
+export interface GenerationWarning {
+    /** Stable machine-readable warning code. */
+    code: string;
+    /** Human-readable explanation. */
+    message: string;
+    /** METHOD/path of the affected operation, when applicable. */
+    operation?: string;
+}
+export interface GenerationCoverage {
+    generated: number;
+    omitted: number;
+    total: number;
+    /** METHOD/path identities of operations omitted from the package. */
+    omitted_operations: string[];
+    /** Present when a plan or anonymous limit omitted operations. */
+    reason?: "anonymous" | "free_plan";
+    /**
+     * Sign-up link for anonymous capped runs.
+     * Format: uri
+     */
+    signup_url?: string;
+    /**
+     * Upgrade link for capped signed-in runs.
+     * Format: uri
+     */
+    upgrade_url?: string;
+}
+/** Response shape for GenerationCoverage. */
+export interface GenerationCoverageRead {
+    generated: number;
+    omitted: number;
+    total: number;
+    /** METHOD/path identities of operations omitted from the package. */
+    omitted_operations: string[];
+    /** Present when a plan or anonymous limit omitted operations. */
+    reason?: ("anonymous" | "free_plan") | (string & {});
+    /**
+     * Sign-up link for anonymous capped runs.
+     * Format: uri
+     */
+    signup_url?: string;
+    /**
+     * Upgrade link for capped signed-in runs.
+     * Format: uri
+     */
+    upgrade_url?: string;
+}
+/**
+ * Unique identifier for one immutable file snapshot. An ID always returns the same bytes: a Spec
+ * Revision, a Generation, and each Draft side name their own file IDs, and a new Draft commit gets
+ * new IDs.
+ */
+export type FileId = string;
+export interface FileModel {
+    id: FileId;
+    object: "file";
+    /** Path within the Spec Revision, Generation package, or Target package. */
+    path: string;
+    size_bytes: number;
+    /** Digest of the complete file. */
+    sha256: string;
+    /** utf8: content is text. base64: content is base64-encoded binary bytes. */
+    encoding: "utf8" | "base64";
+    /** Git file mode for package files; null for Spec source files. */
+    mode: GitFileMode | null;
+    /**
+     * When Typeship first issued this file ID.
+     * Format: date-time
+     */
+    created_at: string;
+}
+/** Response shape for FileModel. */
+export interface FileModelRead {
+    id: FileId;
+    object: "file" | (string & {});
+    /** Path within the Spec Revision, Generation package, or Target package. */
+    path: string;
+    size_bytes: number;
+    /** Digest of the complete file. */
+    sha256: string;
+    /** utf8: content is text. base64: content is base64-encoded binary bytes. */
+    encoding: ("utf8" | "base64") | (string & {});
+    /** Git file mode for package files; null for Spec source files. */
+    mode: GitFileMode | (string & {}) | null;
+    /**
+     * When Typeship first issued this file ID.
+     * Format: date-time
+     */
+    created_at: string;
+}
+export type FileResponse = FileModel & {
+    /**
+     * At most 24 KiB of the file starting at offset, encoded as encoding says. Text chunks never
+     * split a character; concatenate chunks in order.
+     */
+    content: string;
+    /** Byte offset of this chunk in the file. */
+    offset: number;
+    /** Pass as cursor to read the next chunk; null at the end of the file. */
+    next_cursor: string | null;
+} & ResponseMetadata;
+/** Response shape for FileResponse. */
+export type FileResponseRead = FileModelRead & {
+    /**
+     * At most 24 KiB of the file starting at offset, encoded as encoding says. Text chunks never
+     * split a character; concatenate chunks in order.
+     */
+    content: string;
+    /** Byte offset of this chunk in the file. */
+    offset: number;
+    /** Pass as cursor to read the next chunk; null at the end of the file. */
+    next_cursor: string | null;
+} & ResponseMetadata;
+export interface FileList {
+    object: ListObject;
+    data: FileModel[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
+/** Response shape for FileList. */
+export interface FileListRead {
+    object: ListObject;
+    data: FileModelRead[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
+export type SpecRevisionFile = FileModel & {
+    /**
+     * entrypoint and reference: captured source files. resolved: the single normalized document
+     * Typeship generated from.
+     */
+    role: "entrypoint" | "reference" | "resolved";
+};
+/** Response shape for SpecRevisionFile. */
+export type SpecRevisionFileRead = FileModelRead & {
+    /**
+     * entrypoint and reference: captured source files. resolved: the single normalized document
+     * Typeship generated from.
+     */
+    role: ("entrypoint" | "reference" | "resolved") | (string & {});
+};
+export interface SpecRevisionFileList {
+    object: ListObject;
+    data: SpecRevisionFile[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
+/** Response shape for SpecRevisionFileList. */
+export interface SpecRevisionFileListRead {
+    object: ListObject;
+    data: SpecRevisionFileRead[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
 }
 export interface GenerationResult {
     files: GeneratedFile[];
-    warnings: string[];
-    meta: GenerationMeta;
-    limits?: GenerationLimits;
+    download?: GenerationDownload;
+    warnings: GenerationWarning[];
+    coverage: GenerationCoverage;
     /**
      * Anonymous, URL-sourced generations only. A link a signed-in person can open to turn this run
-     * into a project in their organization (same Definition, Target, and config). Lasts seven days.
-     * Null for inline Definitions; absent on keyed calls.
+     * into a project in their organization (same Spec, Target, and config). Lasts seven days. Null
+     * for inline Specs; absent on keyed calls.
      */
     claim?: null | {
         url: string;
@@ -293,14 +330,14 @@ export interface GenerationResult {
 }
 /** Response shape for GenerationResult. */
 export interface GenerationResultRead {
-    files: GeneratedFile[];
-    warnings: string[];
-    meta: GenerationMetaRead;
-    limits?: GenerationLimitsRead;
+    files: GeneratedFileRead[];
+    download?: GenerationDownload;
+    warnings: GenerationWarning[];
+    coverage: GenerationCoverageRead;
     /**
      * Anonymous, URL-sourced generations only. A link a signed-in person can open to turn this run
-     * into a project in their organization (same Definition, Target, and config). Lasts seven days.
-     * Null for inline Definitions; absent on keyed calls.
+     * into a project in their organization (same Spec, Target, and config). Lasts seven days. Null
+     * for inline Specs; absent on keyed calls.
      */
     claim?: null | {
         url: string;
@@ -310,42 +347,22 @@ export interface GenerationResultRead {
     request_id: RequestId;
 }
 /**
- * Present when the generation was capped: by the free plan, or because the call was anonymous.
- * Absent on uncapped generations.
+ * Complete package ZIP from this exact result. Present on requests with Idempotency-Key, including
+ * automatic CLI, MCP, and SDK keys. Download before expires_at, verify sha256, and extract into an
+ * empty directory. Anyone with this URL can download the package; keep it private. Reading does not
+ * generate again or extend the 24-hour replay window.
  */
-export interface GenerationLimits {
-    /** How many operations this generation was allowed to include. */
-    max_operations: number;
-    /** How many operations are present in the generated package. */
-    generated_operations: number;
-    /** How many operations in the Definition were left out. */
-    omitted_operations: number;
-    /** How many operations Typeship found in the complete Definition. */
-    total_operations: number;
-    reason: "anonymous" | "free_plan";
-    /** Anonymous calls only. Where to create an account. */
-    signup_url?: string;
-    /** Where the cap is lifted. */
-    upgrade_url: string;
-}
-/** Response shape for GenerationLimits. */
-export interface GenerationLimitsRead {
-    /** How many operations this generation was allowed to include. */
-    max_operations: number;
-    /** How many operations are present in the generated package. */
-    generated_operations: number;
-    /** How many operations in the Definition were left out. */
-    omitted_operations: number;
-    /** How many operations Typeship found in the complete Definition. */
-    total_operations: number;
-    reason: ("anonymous" | "free_plan") | (string & {});
-    /** Anonymous calls only. Where to create an account. */
-    signup_url?: string;
-    /** Where the cap is lifted. */
-    upgrade_url: string;
+export interface GenerationDownload {
+    /** Format: uri */
+    url: string;
+    /** Format: date-time */
+    expires_at: string;
+    /** SHA-256 of the downloaded ZIP bytes. */
+    sha256: string;
+    size_bytes: number;
+    file_count: number;
 }
-export interface UrlDefinitionSource {
-    kind: "url";
+export interface UrlSpecSourceSettings {
     /**
      * URL fetched for every generation.
      * Format: uri
@@ -354,62 +371,75 @@ export interface UrlDefinitionSource {
     /** Whether Typeship has stored write-only request headers for this URL. */
     headers_configured: boolean;
 }
-/** Request shape for UrlDefinitionSource. */
-export interface UrlDefinitionSourceWrite {
-    kind: "url";
+/** Request shape for UrlSpecSourceSettings. */
+export interface UrlSpecSourceSettingsWrite {
     /**
      * URL fetched for every generation.
      * Format: uri
      */
     url: string;
 }
-/** Response shape for UrlDefinitionSource. */
-export interface UrlDefinitionSourceRead {
-    kind: "url" | (string & {});
-    /**
-     * URL fetched for every generation.
-     * Format: uri
-     */
-    url: string;
-    /** Whether Typeship has stored write-only request headers for this URL. */
-    headers_configured: boolean;
+export interface UrlSpecSource {
+    type: "url";
+    url: UrlSpecSourceSettings;
+}
+/** Request shape for UrlSpecSource. */
+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";
+};
+export type RepositoryProvider = (typeof RepositoryProvider)[keyof typeof RepositoryProvider];
+/** Provider-native repository identity, opaque outside its adapter. */
+export type RepositoryIdentifier = string;
 export interface RepositoryReference {
-    /** GitHub is the only launch provider; the field is stable for future adapters. */
-    provider: "github";
-    /** Provider-native repository identity, opaque outside its adapter. */
-    identifier: string;
+    provider: RepositoryProvider;
+    identifier: RepositoryIdentifier;
 }
 /** Response shape for RepositoryReference. */
 export interface RepositoryReferenceRead {
-    /** GitHub is the only launch provider; the field is stable for future adapters. */
-    provider: "github" | (string & {});
-    /** Provider-native repository identity, opaque outside its adapter. */
-    identifier: string;
-}
-export interface RepositoryDefinitionSource {
-    kind: "repository";
-    repository: RepositoryReference;
-    /** Repository-relative Definition entrypoint. */
+    provider: RepositoryProvider | (string & {});
+    identifier: RepositoryIdentifier;
+}
+export interface RepositorySpecSourceSettings {
+    provider: RepositoryProvider;
+    identifier: RepositoryIdentifier;
+    /** Repository-relative Spec entrypoint. */
     path: string;
 }
-/** Response shape for RepositoryDefinitionSource. */
-export interface RepositoryDefinitionSourceRead {
-    kind: "repository" | (string & {});
-    repository: RepositoryReferenceRead;
-    /** Repository-relative Definition entrypoint. */
+/** Response shape for RepositorySpecSourceSettings. */
+export interface RepositorySpecSourceSettingsRead {
+    provider: RepositoryProvider | (string & {});
+    identifier: RepositoryIdentifier;
+    /** Repository-relative Spec entrypoint. */
     path: string;
 }
-/** The single source of truth for where a Project's Definition lives. */
-export type DefinitionSource = UrlDefinitionSource | RepositoryDefinitionSource;
-/** Request shape for DefinitionSource. */
-export type DefinitionSourceWrite = UrlDefinitionSourceWrite | RepositoryDefinitionSource;
-/** Response shape for DefinitionSource. */
-export type DefinitionSourceRead = UrlDefinitionSourceRead | RepositoryDefinitionSourceRead | Record<string, unknown> & {
-    kind?: string;
+export interface RepositorySpecSource {
+    type: "repository";
+    repository: RepositorySpecSourceSettings;
+}
+/** Response shape for RepositorySpecSource. */
+export interface RepositorySpecSourceRead {
+    type: "repository" | (string & {});
+    repository: RepositorySpecSourceSettingsRead;
+}
+/** The single source of truth for where a Project's Spec lives. */
+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 interface UrlDefinitionSourceInput {
-    kind: "url";
+export interface UrlSpecSourceSettingsInput {
     /**
      * URL of an OpenAPI document, GraphQL SDL file, or GraphQL endpoint.
      * Format: uri
@@ -423,39 +453,56 @@ export interface UrlDefinitionSourceInput {
      */
     headers?: Record<string, string> | null;
 }
-/** Response shape for UrlDefinitionSourceInput. */
-export interface UrlDefinitionSourceInputRead {
-    kind: "url" | (string & {});
+/** Response shape for UrlSpecSourceSettingsInput. */
+export interface UrlSpecSourceSettingsInputRead {
     /**
      * URL of an OpenAPI document, GraphQL SDL file, or GraphQL endpoint.
      * Format: uri
      */
     url: string;
 }
-export interface RepositoryDefinitionSourceInput {
-    kind: "repository";
-    repository: RepositoryReference;
-    /** Repository-relative Definition entrypoint. */
+export interface UrlSpecSourceInput {
+    type: "url";
+    url: UrlSpecSourceSettingsInput;
+}
+/** Response shape for UrlSpecSourceInput. */
+export interface UrlSpecSourceInputRead {
+    type: "url" | (string & {});
+    url: UrlSpecSourceSettingsInputRead;
+}
+export interface RepositorySpecSourceSettingsInput {
+    provider: RepositoryProvider;
+    identifier: RepositoryIdentifier;
+    /** Repository-relative Spec entrypoint. */
     path: string;
 }
-/** Response shape for RepositoryDefinitionSourceInput. */
-export interface RepositoryDefinitionSourceInputRead {
-    kind: "repository" | (string & {});
-    repository: RepositoryReferenceRead;
-    /** Repository-relative Definition entrypoint. */
+/** Response shape for RepositorySpecSourceSettingsInput. */
+export interface RepositorySpecSourceSettingsInputRead {
+    provider: RepositoryProvider | (string & {});
+    identifier: RepositoryIdentifier;
+    /** Repository-relative Spec entrypoint. */
     path: string;
 }
-export type DefinitionSourceInput = UrlDefinitionSourceInput | RepositoryDefinitionSourceInput;
-/** Response shape for DefinitionSourceInput. */
-export type DefinitionSourceInputRead = UrlDefinitionSourceInputRead | RepositoryDefinitionSourceInputRead | Record<string, unknown> & {
-    kind?: string;
+export interface RepositorySpecSourceInput {
+    type: "repository";
+    repository: RepositorySpecSourceSettingsInput;
+}
+/** Response shape for RepositorySpecSourceInput. */
+export interface RepositorySpecSourceInputRead {
+    type: "repository" | (string & {});
+    repository: RepositorySpecSourceSettingsInputRead;
+}
+export type SpecSourceInput = UrlSpecSourceInput | RepositorySpecSourceInput;
+/** Response shape for SpecSourceInput. */
+export type SpecSourceInputRead = UrlSpecSourceInputRead | RepositorySpecSourceInputRead | Record<string, unknown> & {
+    type?: string;
 };
 /**
- * A fix applied to the resolved Definition before generation. Paths are JSON
+ * A fix applied to the resolved Spec before generation. Paths are JSON
  * Pointers into the document. A patch whose target no longer exists is
  * skipped and reported as a warning on the generation, never silently.
  */
-export interface DefinitionPatch {
+export interface SpecPatch {
     op: "set" | "append" | "remove" | "rename";
     /**
      * JSON-Pointer-style path. Pattern segments enable bulk fixes:
@@ -470,8 +517,8 @@ export interface DefinitionPatch {
     to?: string | null;
     reason?: string | null;
 }
-/** Response shape for DefinitionPatch. */
-export interface DefinitionPatchRead {
+/** Response shape for SpecPatch. */
+export interface SpecPatchRead {
     op: ("set" | "append" | "remove" | "rename") | (string & {});
     /**
      * JSON-Pointer-style path. Pattern segments enable bulk fixes:
@@ -488,8 +535,10 @@ export interface DefinitionPatchRead {
 }
 /** One exact place where a Diagnostic rule found evidence. */
 export interface DiagnosticLocation {
-    /** Source document coordinate when the Definition contains multiple files. */
-    document?: string;
+    /** 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. */
+    file_id?: FileId;
     /** JSON Pointer for OpenAPI, or schema coordinate for GraphQL. */
     path: string;
     /** Human-readable operation coordinate when the location belongs to an operation. */
@@ -505,9 +554,9 @@ export interface DiagnosticFix {
      * spec_patch is an exact OpenAPI edit Typeship can derive; source_edit requires author intent or
      * a lossless GraphQL source edit.
      */
-    kind: "spec_patch" | "source_edit";
-    /** Exact patches when kind is spec_patch. */
-    patches?: DefinitionPatch[];
+    type: "spec_patch" | "source_edit";
+    /** Exact patches when type is spec_patch. */
+    patches?: SpecPatchResponse[];
     /** Source-level guidance when an exact patch would invent intent. */
     instructions?: string;
 }
@@ -519,37 +568,42 @@ export interface DiagnosticFixRead {
      * spec_patch is an exact OpenAPI edit Typeship can derive; source_edit requires author intent or
      * a lossless GraphQL source edit.
      */
-    kind: ("spec_patch" | "source_edit") | (string & {});
-    /** Exact patches when kind is spec_patch. */
-    patches?: DefinitionPatchRead[];
+    type: ("spec_patch" | "source_edit") | (string & {});
+    /** Exact patches when type is spec_patch. */
+    patches?: SpecPatchResponseRead[];
     /** Source-level guidance when an exact patch would invent intent. */
     instructions?: string;
 }
-/** Every occurrence of one stable Diagnostic rule, grouped into one decision. */
+/**
+ * Every occurrence of one Diagnostic rule in a Spec Revision, grouped into one decision.
+ * Diagnostics are evaluated when read, using the Spec's current patches and Diagnostic policy.
+ */
 export interface Diagnostic {
-    /** Stable rule identifier for automation and suppressions. */
+    /** Stable rule identifier, unique within a Spec Revision. Suppressions name it as rule_id. */
     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.
+     */
+    blocking: boolean;
+    /**
+     * Whether any occurrence is new since baseline_spec_revision_id in the Diagnostic summary. Always
+     * true when there is no baseline.
+     */
+    introduced: boolean;
     /** Whether the rule reports invalid behavior, material risk, or an improvement. */
     severity: "error" | "warning" | "suggestion";
     /** Product dimension affected by the diagnostic. */
     category: "correctness" | "sdk_ergonomics" | "agent_usability" | "safety";
     /** Concise statement of the root cause. */
     title: string;
-    /** What the API author should change. */
-    description: string;
-    /** Why consumers of generated SDK, CLI, or MCP surfaces care. */
-    impact: string;
+    /** One explanation of the finding and why it matters. */
+    message: string;
     /** Public surfaces affected by the root cause. */
     surfaces: Array<"api" | "sdk" | "cli" | "mcp">;
-    /**
-     * Whether the finding is provable from the Definition, a conservative review suggestion, or a
-     * documented Typeship implementation limitation.
-     */
-    evidence_basis: "contract" | "heuristic" | "implementation";
-    /** Whether remediation requires intent that the Definition cannot prove. */
+    /** Whether remediation requires intent that the Spec cannot prove. */
     owner_decision_required: boolean;
-    /** Concrete generated SDK, CLI, or MCP naming effect when Typeship can state it. */
-    surface_impact?: string;
     /** All affected coordinates, kept under one grouped diagnostic. */
     locations: DiagnosticLocation[];
     fix?: DiagnosticFix;
@@ -561,29 +615,31 @@ export interface Diagnostic {
 }
 /** Response shape for Diagnostic. */
 export interface DiagnosticRead {
-    /** Stable rule identifier for automation and suppressions. */
+    /** Stable rule identifier, unique within a Spec Revision. Suppressions name it as rule_id. */
     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.
+     */
+    blocking: boolean;
+    /**
+     * Whether any occurrence is new since baseline_spec_revision_id in the Diagnostic summary. Always
+     * true when there is no baseline.
+     */
+    introduced: boolean;
     /** Whether the rule reports invalid behavior, material risk, or an improvement. */
     severity: ("error" | "warning" | "suggestion") | (string & {});
     /** Product dimension affected by the diagnostic. */
     category: ("correctness" | "sdk_ergonomics" | "agent_usability" | "safety") | (string & {});
     /** Concise statement of the root cause. */
     title: string;
-    /** What the API author should change. */
-    description: string;
-    /** Why consumers of generated SDK, CLI, or MCP surfaces care. */
-    impact: string;
+    /** One explanation of the finding and why it matters. */
+    message: string;
     /** Public surfaces affected by the root cause. */
     surfaces: Array<("api" | "sdk" | "cli" | "mcp") | (string & {})>;
-    /**
-     * Whether the finding is provable from the Definition, a conservative review suggestion, or a
-     * documented Typeship implementation limitation.
-     */
-    evidence_basis: ("contract" | "heuristic" | "implementation") | (string & {});
-    /** Whether remediation requires intent that the Definition cannot prove. */
+    /** Whether remediation requires intent that the Spec cannot prove. */
     owner_decision_required: boolean;
-    /** Concrete generated SDK, CLI, or MCP naming effect when Typeship can state it. */
-    surface_impact?: string;
     /** All affected coordinates, kept under one grouped diagnostic. */
     locations: DiagnosticLocation[];
     fix?: DiagnosticFixRead;
@@ -593,20 +649,50 @@ export interface DiagnosticRead {
      */
     authoring_brief: string;
 }
-/** Counts distinguish decisions from the number of affected schema locations. */
+/**
+ * Counts of grouped Diagnostics, one per rule. Retrieve the revision with include=diagnostics for
+ * each Diagnostic.
+ */
 export interface DiagnosticSummary {
-    /** Number of grouped rule diagnostics. */
-    diagnostics: number;
-    /** Total affected locations across all diagnostics. */
-    occurrences: number;
-    /** Grouped correctness errors. */
-    errors: number;
-    /** Grouped material risks. */
-    warnings: number;
-    /** Grouped improvements. */
-    suggestions: number;
-    /** Diagnostics with exact reviewable Definition patches. */
-    auto_fixable: number;
+    /**
+     * passed: no Diagnostic fails the Spec's Diagnostic policy. blocked: at least one does; retrieve
+     * with include=diagnostics and fix those marked blocking.
+     */
+    status: "passed" | "blocked";
+    /** Diagnostics reporting invalid behavior. */
+    error_count: number;
+    /** Diagnostics reporting material risk. */
+    warning_count: number;
+    /** Diagnostics suggesting an improvement. */
+    suggestion_count: number;
+    /** Diagnostics that fail the Spec's Diagnostic policy. */
+    blocking_count: number;
+    /**
+     * The previous revision of this Spec that introduced Diagnostics are compared with, or null for
+     * the first revision.
+     */
+    baseline_spec_revision_id: SpecRevisionId | null;
+}
+/** Response shape for DiagnosticSummary. */
+export interface DiagnosticSummaryRead {
+    /**
+     * passed: no Diagnostic fails the Spec's Diagnostic policy. blocked: at least one does; retrieve
+     * with include=diagnostics and fix those marked blocking.
+     */
+    status: ("passed" | "blocked") | (string & {});
+    /** Diagnostics reporting invalid behavior. */
+    error_count: number;
+    /** Diagnostics reporting material risk. */
+    warning_count: number;
+    /** Diagnostics suggesting an improvement. */
+    suggestion_count: number;
+    /** Diagnostics that fail the Spec's Diagnostic policy. */
+    blocking_count: number;
+    /**
+     * The previous revision of this Spec that introduced Diagnostics are compared with, or null for
+     * the first revision.
+     */
+    baseline_spec_revision_id: SpecRevisionId | null;
 }
 export interface DiagnosticSuppression {
     rule_id: string;
@@ -648,141 +734,22 @@ export interface DiagnosticPolicyRead {
     /** Default: [] */
     suppressions: DiagnosticSuppression[];
 }
-export interface DiagnosticEvaluation {
-    state: "pass" | "fail";
-    blocking: DiagnosticReference[];
-    considered_occurrences: number;
-    suppressed_occurrences: number;
-}
-/** Response shape for DiagnosticEvaluation. */
-export interface DiagnosticEvaluationRead {
-    state: ("pass" | "fail") | (string & {});
-    blocking: DiagnosticReferenceRead[];
-    considered_occurrences: number;
-    suppressed_occurrences: number;
-}
-/** Current-revision suppression usage for one stable Diagnostic rule. */
-export interface DiagnosticSuppressionSignal {
-    rule_id: string;
-    /** Current occurrences of this rule that are not suppressed. */
-    active_occurrences: number;
-    suppressed_occurrences: number;
-}
-/**
- * Current-revision signals for tuning Diagnostics policy. These counts do not claim that a
- * suppression is a false positive or that runtime behavior has been verified.
- */
-export interface DiagnosticQualitySignals {
-    suppressed_by_rule: DiagnosticSuppressionSignal[];
-    /** Reviewed exceptions whose rule or exact path no longer matches this revision. */
-    stale_suppressions: DiagnosticSuppression[];
-}
-/** Compact rule and location reference; full guidance appears once in diagnostics. */
-export interface DiagnosticReference {
-    rule_id: string;
-    severity: "error" | "warning" | "suggestion";
-    title: string;
-    locations: DiagnosticLocation[];
-}
-/** Response shape for DiagnosticReference. */
-export interface DiagnosticReferenceRead {
-    rule_id: string;
-    severity: ("error" | "warning" | "suggestion") | (string & {});
-    title: string;
-    locations: DiagnosticLocation[];
-}
-export interface DiagnosticDelta {
-    added: DiagnosticReference[];
-    resolved: DiagnosticReference[];
-    baseline_definition_revision_id: DefinitionRevisionId | null;
-}
-/** Response shape for DiagnosticDelta. */
-export interface DiagnosticDeltaRead {
-    added: DiagnosticReferenceRead[];
-    resolved: DiagnosticReferenceRead[];
-    baseline_definition_revision_id: DefinitionRevisionId | null;
-}
-/**
- * Deterministic Diagnostics for one immutable Definition Revision after existing patches. No
- * model-generated facts or silent edits.
- */
-export interface DiagnosticReport {
-    object: "diagnostic_report";
-    /** Contract format Typeship analyzed. */
-    format: "openapi" | "graphql";
-    project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId;
-    /** SHA-256 digest of the immutable raw source revision. */
-    source_sha256: string;
-    /** SHA-256 digest after applying the Definition's current patches. */
-    analyzed_sha256: string;
-    /** Loud misses or conflicts from the Definition's existing patches. */
-    patch_diagnostics: string[];
-    summary: DiagnosticSummary;
-    /** Stable grouped diagnostics, ordered by severity and rule identifier. */
-    diagnostics: Diagnostic[];
-    policy: DiagnosticPolicy;
-    evaluation: DiagnosticEvaluation;
-    quality_signals: DiagnosticQualitySignals;
-    delta: DiagnosticDelta;
-    request_id: RequestId;
-}
-/** Response shape for DiagnosticReport. */
-export interface DiagnosticReportRead {
-    object: "diagnostic_report" | (string & {});
-    /** Contract format Typeship analyzed. */
-    format: ("openapi" | "graphql") | (string & {});
-    project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId;
-    /** SHA-256 digest of the immutable raw source revision. */
-    source_sha256: string;
-    /** SHA-256 digest after applying the Definition's current patches. */
-    analyzed_sha256: string;
-    /** Loud misses or conflicts from the Definition's existing patches. */
-    patch_diagnostics: string[];
-    summary: DiagnosticSummary;
-    /** Stable grouped diagnostics, ordered by severity and rule identifier. */
-    diagnostics: DiagnosticRead[];
-    policy: DiagnosticPolicyRead;
-    evaluation: DiagnosticEvaluationRead;
-    quality_signals: DiagnosticQualitySignals;
-    delta: DiagnosticDeltaRead;
-    request_id: RequestId;
-}
-export interface DiagnosticRemediationRequest {
-    /** Stable IDs of current diagnostics whose exact patches should be reviewed and applied. */
-    diagnostic_ids: string[];
-}
-export interface DiagnosticRemediation {
-    object: "diagnostic_remediation";
-    kind: "overlay" | "source_review";
-    patches_applied: number;
-    /**
-     * Source pull request for repository projects; absent for URL overlays.
-     * Format: uri
-     */
-    review_url?: string | null;
-    request_id: RequestId;
+export interface DiagnosticWarning {
+    code: "unsupported_format" | "invalid_document" | "invalid_patch" | "no_match" | "append_target_type" | "rename_target_type" | "rename_conflict";
+    message: string;
 }
-/** Response shape for DiagnosticRemediation. */
-export interface DiagnosticRemediationRead {
-    object: "diagnostic_remediation" | (string & {});
-    kind: ("overlay" | "source_review") | (string & {});
-    patches_applied: number;
-    /**
-     * Source pull request for repository projects; absent for URL overlays.
-     * Format: uri
-     */
-    review_url?: string | null;
-    request_id: RequestId;
+/** Response shape for DiagnosticWarning. */
+export interface DiagnosticWarningRead {
+    code: ("unsupported_format" | "invalid_document" | "invalid_patch" | "no_match" | "append_target_type" | "rename_target_type" | "rename_conflict") | (string & {});
+    message: string;
 }
-export interface RepositoryDeliveryInput {
-    kind: "repository";
-    repository: RepositoryReference;
+export interface RepositoryDeliverySettingsInput {
+    provider: RepositoryProvider;
+    identifier: RepositoryIdentifier;
     directory?: string | null;
     /** npm or Python registry identity where applicable. */
     package_name?: string | null;
-    /** Explicit Go module path where applicable. */
+    /** Go module identity for the Go SDK or Go CLI Target where applicable. */
     module_path?: string | null;
     /**
      * Commit repository-owned registry automation and report publication after the Draft merges.
@@ -790,14 +757,14 @@ export interface RepositoryDeliveryInput {
      */
     publish_on_merge?: boolean;
 }
-/** Response shape for RepositoryDeliveryInput. */
-export interface RepositoryDeliveryInputRead {
-    kind: "repository" | (string & {});
-    repository: RepositoryReferenceRead;
+/** Response shape for RepositoryDeliverySettingsInput. */
+export interface RepositoryDeliverySettingsInputRead {
+    provider: RepositoryProvider | (string & {});
+    identifier: RepositoryIdentifier;
     directory?: string | null;
     /** npm or Python registry identity where applicable. */
     package_name?: string | null;
-    /** Explicit Go module path where applicable. */
+    /** Go module identity for the Go SDK or Go CLI Target where applicable. */
     module_path?: string | null;
     /**
      * Commit repository-owned registry automation and report publication after the Draft merges.
@@ -805,29 +772,70 @@ export interface RepositoryDeliveryInputRead {
      */
     publish_on_merge?: boolean;
 }
+export interface RepositoryDeliveryInput {
+    type: "repository";
+    repository: RepositoryDeliverySettingsInput;
+}
+/** Response shape for RepositoryDeliveryInput. */
+export interface RepositoryDeliveryInputRead {
+    type: "repository" | (string & {});
+    repository: RepositoryDeliverySettingsInputRead;
+}
 export interface HostedMcpDeliveryInput {
-    kind: "hosted_mcp";
+    type: "hosted_mcp";
 }
 /** Response shape for HostedMcpDeliveryInput. */
 export interface HostedMcpDeliveryInputRead {
-    kind: "hosted_mcp" | (string & {});
+    type: "hosted_mcp" | (string & {});
 }
 export type DeliveryInput = RepositoryDeliveryInput | HostedMcpDeliveryInput;
 /** Response shape for DeliveryInput. */
 export type DeliveryInputRead = RepositoryDeliveryInputRead | HostedMcpDeliveryInputRead | Record<string, unknown> & {
-    kind?: string;
+    type?: string;
 };
-export interface RepositoryDelivery {
-    id: DeliveryId;
-    object: "delivery";
-    target_id: TargetId;
-    kind: "repository";
-    state: "active" | "disabled";
-    repository: RepositoryReference;
+export interface RepositoryDeliverySettings {
+    provider: RepositoryProvider;
+    identifier: RepositoryIdentifier;
+    directory: string | null;
+    package_name: string | null;
+    module_path: string | null;
+    publish_on_merge: boolean;
+}
+/** Response shape for RepositoryDeliverySettings. */
+export interface RepositoryDeliverySettingsRead {
+    provider: RepositoryProvider | (string & {});
+    identifier: RepositoryIdentifier;
     directory: string | null;
     package_name: string | null;
     module_path: string | null;
     publish_on_merge: boolean;
+}
+export interface HostedMcpDeliverySettings {
+    /**
+     * Hosted MCP endpoint for this Target, or null while it is being provisioned.
+     * Format: uri
+     */
+    url: string | null;
+}
+export interface RepositoryDelivery {
+    id: DeliveryId;
+    object: "delivery";
+    target_id: TargetId;
+    type: "repository";
+    /**
+     * active: the repository accepts generated changes. action_required: inspect issues for the
+     * correction. disabled: the Target is disabled and receives no changes.
+     */
+    status: "active" | "action_required" | "disabled";
+    repository: RepositoryDeliverySettings;
+    issues: RepositoryDeliveryIssue[];
+    /** Repository check names Typeship expects before accepting a Draft. */
+    required_checks: string[];
+    /**
+     * Last observed repository event relevant to this Delivery, if available. A failed event adds an
+     * actionable issue.
+     */
+    last_event: RepositoryDeliveryEvent | null;
     /** Format: date-time */
     created_at: string;
     /** Format: date-time */
@@ -838,26 +846,65 @@ export interface RepositoryDeliveryRead {
     id: DeliveryId;
     object: "delivery" | (string & {});
     target_id: TargetId;
-    kind: "repository" | (string & {});
-    state: ("active" | "disabled") | (string & {});
-    repository: RepositoryReferenceRead;
-    directory: string | null;
-    package_name: string | null;
-    module_path: string | null;
-    publish_on_merge: boolean;
+    type: "repository" | (string & {});
+    /**
+     * active: the repository accepts generated changes. action_required: inspect issues for the
+     * correction. disabled: the Target is disabled and receives no changes.
+     */
+    status: ("active" | "action_required" | "disabled") | (string & {});
+    repository: RepositoryDeliverySettingsRead;
+    issues: RepositoryDeliveryIssueRead[];
+    /** Repository check names Typeship expects before accepting a Draft. */
+    required_checks: string[];
+    /**
+     * Last observed repository event relevant to this Delivery, if available. A failed event adds an
+     * actionable issue.
+     */
+    last_event: RepositoryDeliveryEventRead | null;
     /** Format: date-time */
     created_at: string;
     /** Format: date-time */
     updated_at: string;
 }
+export interface RepositoryDeliveryIssue {
+    code: "app_not_installed" | "repository_unreachable" | "contents_write_missing" | "pull_request_missing" | "approval_label_missing" | "check_missing" | "event_failed";
+    /** Specific customer action or repository setting to inspect. */
+    message: string;
+}
+/** Response shape for RepositoryDeliveryIssue. */
+export interface RepositoryDeliveryIssueRead {
+    code: ("app_not_installed" | "repository_unreachable" | "contents_write_missing" | "pull_request_missing" | "approval_label_missing" | "check_missing" | "event_failed") | (string & {});
+    /** Specific customer action or repository setting to inspect. */
+    message: string;
+}
+export interface RepositoryDeliveryEvent {
+    /** Repository event type. */
+    event: string;
+    /** superseded: a newer event for the same repository replaced this one before it finished. */
+    status: "queued" | "running" | "completed" | "failed" | "superseded";
+    /** Format: date-time */
+    created_at: string;
+}
+/** Response shape for RepositoryDeliveryEvent. */
+export interface RepositoryDeliveryEventRead {
+    /** Repository event type. */
+    event: string;
+    /** superseded: a newer event for the same repository replaced this one before it finished. */
+    status: ("queued" | "running" | "completed" | "failed" | "superseded") | (string & {});
+    /** Format: date-time */
+    created_at: string;
+}
 export interface HostedMcpDelivery {
     id: DeliveryId;
     object: "delivery";
     target_id: TargetId;
-    kind: "hosted_mcp";
-    state: "active" | "disabled";
-    /** Format: uri */
-    url: string | null;
+    type: "hosted_mcp";
+    /**
+     * active: the endpoint serves the Target's latest accepted package. disabled: the Target is
+     * disabled and the endpoint is paused.
+     */
+    status: "active" | "disabled";
+    hosted_mcp: HostedMcpDeliverySettings;
     /** Format: date-time */
     created_at: string;
     /** Format: date-time */
@@ -868,10 +915,13 @@ export interface HostedMcpDeliveryRead {
     id: DeliveryId;
     object: "delivery" | (string & {});
     target_id: TargetId;
-    kind: "hosted_mcp" | (string & {});
-    state: ("active" | "disabled") | (string & {});
-    /** Format: uri */
-    url: string | null;
+    type: "hosted_mcp" | (string & {});
+    /**
+     * active: the endpoint serves the Target's latest accepted package. disabled: the Target is
+     * disabled and the endpoint is paused.
+     */
+    status: ("active" | "disabled") | (string & {});
+    hosted_mcp: HostedMcpDeliverySettings;
     /** Format: date-time */
     created_at: string;
     /** Format: date-time */
@@ -880,60 +930,132 @@ export interface HostedMcpDeliveryRead {
 export type Delivery = RepositoryDelivery | HostedMcpDelivery;
 /** Response shape for Delivery. */
 export type DeliveryRead = RepositoryDeliveryRead | HostedMcpDeliveryRead | Record<string, unknown> & {
-    kind?: string;
+    type?: string;
 };
-export interface TargetFields {
-    name: string;
-    definition_id: DefinitionId;
-    generator: GeneratorKind;
-    /** Default: "active" */
-    state?: "active" | "disabled";
-    /** Default: "2026-08-24" */
-    edition?: string;
-    /** Default: "stable" */
-    release_channel?: "stable" | "prerelease";
-    /** Optional larger or prerelease SemVer for the next reviewed release. */
-    proposed_version?: string | null;
-    /**
-     * Target-specific overrides merged over Project.config. GraphQL settings are rejected here and
-     * belong to the Definition.
-     */
-    config?: TargetConfig | null;
-    deliveries?: DeliveryInput[];
-}
-/** Response shape for TargetFields. */
-export interface TargetFieldsRead {
-    name: string;
-    definition_id: DefinitionId;
-    generator: GeneratorKind | (string & {});
+/**
+ * repository is present for a repository Delivery, with issues, required_checks, and last_event;
+ * hosted_mcp is present for a hosted_mcp Delivery.
+ */
+export interface DeliveryResponse {
+    id: DeliveryId;
+    object: "delivery";
+    target_id: TargetId;
+    type: "repository" | "hosted_mcp";
+    status: "active" | "action_required" | "disabled";
+    repository?: RepositoryDeliverySettings;
+    issues?: RepositoryDeliveryIssue[];
+    required_checks?: string[];
+    last_event?: RepositoryDeliveryEvent | null;
+    hosted_mcp?: HostedMcpDeliverySettings;
+    /** Format: date-time */
+    created_at: string;
+    /** Format: date-time */
+    updated_at: string;
+    request_id: RequestId;
+}
+/** Response shape for DeliveryResponse. */
+export interface DeliveryResponseRead {
+    id: DeliveryId;
+    object: "delivery" | (string & {});
+    target_id: TargetId;
+    type: ("repository" | "hosted_mcp") | (string & {});
+    status: ("active" | "action_required" | "disabled") | (string & {});
+    repository?: RepositoryDeliverySettingsRead;
+    issues?: RepositoryDeliveryIssueRead[];
+    required_checks?: string[];
+    last_event?: RepositoryDeliveryEventRead | null;
+    hosted_mcp?: HostedMcpDeliverySettings;
+    /** Format: date-time */
+    created_at: string;
+    /** Format: date-time */
+    updated_at: string;
+    request_id: RequestId;
+}
+/**
+ * One Target generated from a sibling Target. A go_cli Target carries type go_sdk_module, naming
+ * the Go SDK Target it is generated against.
+ */
+export interface TargetDependency {
+    type: "go_sdk_module";
+    target_id: TargetId;
+}
+/** Response shape for TargetDependency. */
+export interface TargetDependencyRead {
+    type: "go_sdk_module" | (string & {});
+    target_id: TargetId;
+}
+/**
+ * Required checks run against the code in the Draft. Generated checks and customer commands share
+ * one reproducible workflow; repository_required names existing repository checks. Supplying checks
+ * replaces all settings. Omitted generated restores build, package, and public_entrypoint; omitted
+ * repository_required and customer restore empty lists. An empty object restores these defaults. An
+ * empty array clears the corresponding list.
+ */
+export interface TargetChecks {
+    /** Default: ["build","package","public_entrypoint"] */
+    generated?: Array<"build" | "package" | "public_entrypoint">;
+    repository_required?: string[];
+    customer?: Array<{
+        name: string;
+        command: string;
+    }>;
+}
+/** Response shape for TargetChecks. */
+export interface TargetChecksRead {
+    /** Default: ["build","package","public_entrypoint"] */
+    generated?: Array<("build" | "package" | "public_entrypoint") | (string & {})>;
+    repository_required?: string[];
+    customer?: Array<{
+        name: string;
+        command: string;
+    }>;
+}
+export interface TargetCreateRequest {
+    project_id: ProjectId;
+    name: string;
+    spec_id: SpecId;
+    type: GeneratorKind;
+    /** Default: "active" */
+    status?: "active" | "disabled";
+    /** Default: "stable" */
+    release_channel?: "stable" | "prerelease";
+    checks?: TargetChecks;
+    /**
+     * Target-specific overrides merged over Project.config. GraphQL settings are rejected here and
+     * belong to the Spec.
+     */
+    config?: TargetConfig | null;
+    deliveries?: DeliveryInput[];
+}
+/** Response shape for TargetCreateRequest. */
+export interface TargetCreateRequestRead {
+    project_id: ProjectId;
+    name: string;
+    spec_id: SpecId;
+    type: GeneratorKind | (string & {});
     /** Default: "active" */
-    state?: ("active" | "disabled") | (string & {});
-    /** Default: "2026-08-24" */
-    edition?: string;
+    status?: ("active" | "disabled") | (string & {});
     /** Default: "stable" */
     release_channel?: ("stable" | "prerelease") | (string & {});
-    /** Optional larger or prerelease SemVer for the next reviewed release. */
-    proposed_version?: string | null;
+    checks?: TargetChecksRead;
     /**
      * Target-specific overrides merged over Project.config. GraphQL settings are rejected here and
-     * belong to the Definition.
+     * belong to the Spec.
      */
     config?: TargetConfigRead | null;
     deliveries?: DeliveryInputRead[];
 }
 export interface InitialTargetFields {
     name: string;
-    generator: GeneratorKind;
+    type: GeneratorKind;
     /** Default: "active" */
-    state?: "active" | "disabled";
-    /** Default: "2026-08-24" */
-    edition?: string;
+    status?: "active" | "disabled";
     /** Default: "stable" */
     release_channel?: "stable" | "prerelease";
-    proposed_version?: string | null;
+    checks?: TargetChecks;
     /**
      * Target-specific overrides merged over Project.config. GraphQL settings are rejected here and
-     * belong to the Definition.
+     * belong to the Spec.
      */
     config?: TargetConfig | null;
     deliveries?: DeliveryInput[];
@@ -941,78 +1063,113 @@ export interface InitialTargetFields {
 /** Response shape for InitialTargetFields. */
 export interface InitialTargetFieldsRead {
     name: string;
-    generator: GeneratorKind | (string & {});
+    type: GeneratorKind | (string & {});
     /** Default: "active" */
-    state?: ("active" | "disabled") | (string & {});
-    /** Default: "2026-08-24" */
-    edition?: string;
+    status?: ("active" | "disabled") | (string & {});
     /** Default: "stable" */
     release_channel?: ("stable" | "prerelease") | (string & {});
-    proposed_version?: string | null;
+    checks?: TargetChecksRead;
     /**
      * Target-specific overrides merged over Project.config. GraphQL settings are rejected here and
-     * belong to the Definition.
+     * belong to the Spec.
      */
     config?: TargetConfigRead | null;
     deliveries?: DeliveryInputRead[];
 }
 export interface TargetUpdateRequest {
     name?: string;
-    state?: "active" | "disabled";
-    edition?: string;
+    status?: "active" | "disabled";
     release_channel?: "stable" | "prerelease";
-    proposed_version?: string | null;
+    checks?: TargetChecks;
     /**
-     * Target-specific overrides merged over Project.config. GraphQL settings are rejected here and
-     * belong to the Definition.
+     * Replaces the complete stored override object. Send null or an empty object to resume Project
+     * 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 {
     name?: string;
-    state?: ("active" | "disabled") | (string & {});
-    edition?: string;
+    status?: ("active" | "disabled") | (string & {});
     release_channel?: ("stable" | "prerelease") | (string & {});
-    proposed_version?: string | null;
+    checks?: TargetChecksRead;
     /**
-     * Target-specific overrides merged over Project.config. GraphQL settings are rejected here and
-     * belong to the Definition.
+     * Replaces the complete stored override object. Send null or an empty object to resume Project
+     * 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
+ * policy is fixed rather than configurable.
+ */
 export interface Target {
     id: TargetId;
     object: "target";
     project_id: ProjectId;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     name: string;
-    generator: GeneratorKind;
-    state: "active" | "disabled";
-    edition: string;
+    type: GeneratorKind;
+    /**
+     * Present only on a go_cli Target, naming the sibling Go SDK Target the CLI is generated against.
+     * Every other Target type reports null.
+     */
+    dependency: TargetDependency | null;
+    status: "active" | "disabled";
     release_channel: "stable" | "prerelease";
-    version_policy: {
-        mode: "reviewed_semver";
-        pre1_breaking: "minor";
-    };
     /**
-     * Deprecated projection of the newest immutable Target Release; null until a release becomes
-     * Current.
-     * @deprecated
+     * Read-only version of the Target's latest release, or null before its first release. Publishing
+     * status is separate; inspect the release for its results.
+     */
+    version_current: string | null;
+    /** The Target's open Draft. After a merge it names the next Draft. */
+    draft_id: DraftId;
+    checks: TargetChecksResponse;
+    /**
+     * Target-specific overrides merged over Project.config. GraphQL settings are Spec-owned and never
+     * appear here.
      */
-    current_version: string | null;
-    proposed_version: string | null;
-    proposed_version_source: "console" | "api" | "github" | null;
-    proposed_version_actor: string | null;
-    /** Optimistic concurrency revision for Draft selections. */
-    release_revision: number;
+    config: TargetConfigResponse | null;
+    /** At most one repository and one hosted MCP Delivery. */
+    deliveries: Delivery[];
+    /** Format: date-time */
+    created_at: string;
+    /** Format: date-time */
+    updated_at: string;
+    request_id?: RequestId;
+}
+/** Request shape for Target. */
+export interface TargetWrite {
+    id: TargetId;
+    object: "target";
+    project_id: ProjectId;
+    spec_id: SpecId;
+    name: string;
+    type: GeneratorKind;
+    status: "active" | "disabled";
+    release_channel: "stable" | "prerelease";
+    checks: TargetChecksResponse;
     /**
-     * Target-specific overrides merged over Project.config. GraphQL settings are Definition-owned and
-     * never appear here.
+     * Target-specific overrides merged over Project.config. GraphQL settings are Spec-owned and never
+     * appear here.
      */
-    config: TargetConfig | null;
+    config: TargetConfigResponse | null;
     /** At most one repository and one hosted MCP Delivery. */
     deliveries: Delivery[];
     /** Format: date-time */
@@ -1026,32 +1183,29 @@ export interface TargetRead {
     id: TargetId;
     object: "target" | (string & {});
     project_id: ProjectId;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     name: string;
-    generator: GeneratorKind | (string & {});
-    state: ("active" | "disabled") | (string & {});
-    edition: string;
+    type: GeneratorKind | (string & {});
+    /**
+     * Present only on a go_cli Target, naming the sibling Go SDK Target the CLI is generated against.
+     * Every other Target type reports null.
+     */
+    dependency: TargetDependencyRead | null;
+    status: ("active" | "disabled") | (string & {});
     release_channel: ("stable" | "prerelease") | (string & {});
-    version_policy: {
-        mode: "reviewed_semver" | (string & {});
-        pre1_breaking: "minor" | (string & {});
-    };
     /**
-     * Deprecated projection of the newest immutable Target Release; null until a release becomes
-     * Current.
-     * @deprecated
+     * Read-only version of the Target's latest release, or null before its first release. Publishing
+     * status is separate; inspect the release for its results.
      */
-    current_version: string | null;
-    proposed_version: string | null;
-    proposed_version_source: ("console" | "api" | "github" | null) | (string & {}) | null;
-    proposed_version_actor: string | null;
-    /** Optimistic concurrency revision for Draft selections. */
-    release_revision: number;
+    version_current: string | null;
+    /** The Target's open Draft. After a merge it names the next Draft. */
+    draft_id: DraftId;
+    checks: TargetChecksResponseRead;
     /**
-     * Target-specific overrides merged over Project.config. GraphQL settings are Definition-owned and
-     * never appear here.
+     * Target-specific overrides merged over Project.config. GraphQL settings are Spec-owned and never
+     * appear here.
      */
-    config: TargetConfigRead | null;
+    config: TargetConfigResponseRead | null;
     /** At most one repository and one hosted MCP Delivery. */
     deliveries: DeliveryRead[];
     /** Format: date-time */
@@ -1061,8 +1215,55 @@ export interface TargetRead {
     request_id?: RequestId;
 }
 export type TargetResponse = Target & ResponseMetadata;
+/** Request shape for TargetResponse. */
+export type TargetResponseWrite = TargetWrite & ResponseMetadata;
 /** Response shape for TargetResponse. */
 export type TargetResponseRead = TargetRead & ResponseMetadata;
+export interface DeliveryList {
+    object: ListObject;
+    data: Delivery[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
+/** Response shape for DeliveryList. */
+export interface DeliveryListRead {
+    object: ListObject;
+    data: DeliveryRead[];
+    has_more: boolean;
+    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[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
+/** Response shape for DraftList. */
+export interface DraftListRead {
+    object: ListObject;
+    data: DraftRead[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
 export interface TargetList {
     object: ListObject;
     data: Target[];
@@ -1070,6 +1271,14 @@ export interface TargetList {
     next_cursor: string | null;
     request_id: RequestId;
 }
+/** Request shape for TargetList. */
+export interface TargetListWrite {
+    object: ListObject;
+    data: TargetWrite[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
 /** Response shape for TargetList. */
 export interface TargetListRead {
     object: ListObject;
@@ -1078,9 +1287,9 @@ export interface TargetListRead {
     next_cursor: string | null;
     request_id: RequestId;
 }
-export interface TargetRelease {
-    id: TargetReleaseId;
-    object: "target_release";
+export interface Release {
+    id: ReleaseId;
+    object: "release";
     target_id: TargetId;
     /** Null only for a verified release imported during package adoption. */
     generation_id: GenerationId | null;
@@ -1088,18 +1297,33 @@ export interface TargetRelease {
     /** Immutable package version released from this Target. */
     version: string;
     channel: "stable" | "prerelease";
-    /** Delivery provider that accepted the release. */
-    provider: string;
-    repository: RepositoryReference | null;
-    definition_revision_id: DefinitionRevisionId | null;
-    /** Immutable provider-native revision that was merged or published. */
-    delivery_revision: string;
+    repository: RepositoryReferenceResponse | null;
+    spec_revision_id: SpecRevisionId | null;
+    /**
+     * Git commit containing the accepted package. Compare it with the Delivery repository history or
+     * checked-out commit.
+     */
+    commit_sha: string;
+    checks: PackageCheck[];
+    approvals: CompatibilityApproval[];
+    /**
+     * For an adopted Release, compare the tag and registry URL with the published package and its
+     * artifact digest. Null for a Release created by Typeship.
+     */
     import_provenance: {
+        /** Git tag to compare with the repository release, if available. */
         tag: string | null;
-        /** Format: uri */
+        /**
+         * Published package page to inspect, if available.
+         * Format: uri
+         */
         registry_url: string | null;
+        /** Published artifact digest to compare with registry metadata, if available. */
         artifact_digest: string | null;
-        /** Format: date-time */
+        /**
+         * When Typeship recorded the adopted package.
+         * Format: date-time
+         */
         imported_at: string | null;
     } | null;
     publications: Publication[];
@@ -1107,10 +1331,10 @@ export interface TargetRelease {
     created_at: string;
     request_id?: RequestId;
 }
-/** Response shape for TargetRelease. */
-export interface TargetReleaseRead {
-    id: TargetReleaseId;
-    object: "target_release" | (string & {});
+/** Response shape for Release. */
+export interface ReleaseRead {
+    id: ReleaseId;
+    object: "release" | (string & {});
     target_id: TargetId;
     /** Null only for a verified release imported during package adoption. */
     generation_id: GenerationId | null;
@@ -1118,18 +1342,33 @@ export interface TargetReleaseRead {
     /** Immutable package version released from this Target. */
     version: string;
     channel: ("stable" | "prerelease") | (string & {});
-    /** Delivery provider that accepted the release. */
-    provider: string;
-    repository: RepositoryReferenceRead | null;
-    definition_revision_id: DefinitionRevisionId | null;
-    /** Immutable provider-native revision that was merged or published. */
-    delivery_revision: string;
+    repository: RepositoryReferenceResponseRead | null;
+    spec_revision_id: SpecRevisionId | null;
+    /**
+     * Git commit containing the accepted package. Compare it with the Delivery repository history or
+     * checked-out commit.
+     */
+    commit_sha: string;
+    checks: PackageCheckRead[];
+    approvals: CompatibilityApprovalRead[];
+    /**
+     * For an adopted Release, compare the tag and registry URL with the published package and its
+     * artifact digest. Null for a Release created by Typeship.
+     */
     import_provenance: {
+        /** Git tag to compare with the repository release, if available. */
         tag: string | null;
-        /** Format: uri */
+        /**
+         * Published package page to inspect, if available.
+         * Format: uri
+         */
         registry_url: string | null;
+        /** Published artifact digest to compare with registry metadata, if available. */
         artifact_digest: string | null;
-        /** Format: date-time */
+        /**
+         * When Typeship recorded the adopted package.
+         * Format: date-time
+         */
         imported_at: string | null;
     } | null;
     publications: PublicationRead[];
@@ -1137,20 +1376,20 @@ export interface TargetReleaseRead {
     created_at: string;
     request_id?: RequestId;
 }
-export type TargetReleaseResponse = TargetRelease & ResponseMetadata;
-/** Response shape for TargetReleaseResponse. */
-export type TargetReleaseResponseRead = TargetReleaseRead & ResponseMetadata;
-export interface TargetReleaseList {
+export type ReleaseResponse = Release & ResponseMetadata;
+/** Response shape for ReleaseResponse. */
+export type ReleaseResponseRead = ReleaseRead & ResponseMetadata;
+export interface ReleaseList {
     object: ListObject;
-    data: TargetRelease[];
+    data: Release[];
     has_more: boolean;
     next_cursor: string | null;
     request_id: RequestId;
 }
-/** Response shape for TargetReleaseList. */
-export interface TargetReleaseListRead {
+/** Response shape for ReleaseList. */
+export interface ReleaseListRead {
     object: ListObject;
-    data: TargetReleaseRead[];
+    data: ReleaseRead[];
     has_more: boolean;
     next_cursor: string | null;
     request_id: RequestId;
@@ -1158,20 +1397,25 @@ export interface TargetReleaseListRead {
 export interface Publication {
     id: PublicationId;
     object: "publication";
-    target_release_id: TargetReleaseId;
+    release_id: ReleaseId;
     destination: "github" | "npm" | "pypi" | "go" | "mcp";
-    state: "pending" | "publishing" | "published" | "failed";
+    status: "pending" | "publishing" | "published" | "failed" | "disabled";
     attempt: number;
     /** Format: uri */
     run_url: string | null;
     /** Format: uri */
     registry_url: string | null;
     artifact_digest: string | null;
-    error: string | null;
+    /** Recorded failures. Empty when this resource has no recorded failure. */
+    errors: DomainError[];
     /** Format: date-time */
     started_at: string | null;
     /** Format: date-time */
     finished_at: string | null;
+    /** Milliseconds from started_at to finished_at; null until the attempt finishes. */
+    runtime_ms: number | null;
+    /** Format: date-time */
+    created_at: string;
     /** Format: date-time */
     updated_at: string;
 }
@@ -1179,281 +1423,416 @@ export interface Publication {
 export interface PublicationRead {
     id: PublicationId;
     object: "publication" | (string & {});
-    target_release_id: TargetReleaseId;
+    release_id: ReleaseId;
     destination: ("github" | "npm" | "pypi" | "go" | "mcp") | (string & {});
-    state: ("pending" | "publishing" | "published" | "failed") | (string & {});
+    status: ("pending" | "publishing" | "published" | "failed" | "disabled") | (string & {});
     attempt: number;
     /** Format: uri */
     run_url: string | null;
     /** Format: uri */
     registry_url: string | null;
     artifact_digest: string | null;
-    error: string | null;
+    /** Recorded failures. Empty when this resource has no recorded failure. */
+    errors: DomainErrorRead[];
     /** Format: date-time */
     started_at: string | null;
     /** Format: date-time */
     finished_at: string | null;
+    /** Milliseconds from started_at to finished_at; null until the attempt finishes. */
+    runtime_ms: number | null;
+    /** Format: date-time */
+    created_at: string;
     /** Format: date-time */
     updated_at: string;
 }
-export type TargetDraftSelection = {
-    mode: "automatic";
-} | {
-    mode: "exact";
-    version: string;
-    source: "console" | "api" | "github" | null;
-    actor: string | null;
+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
+ * 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 WORKING: "working";
+    readonly ACTION_REQUIRED: "action_required";
+    readonly READY: "ready";
+    readonly MERGED: "merged";
 };
-/** Response shape for TargetDraftSelection. */
-export type TargetDraftSelectionRead = {
-    mode: "automatic" | (string & {});
-} | {
-    mode: "exact" | (string & {});
-    version: string;
-    source: ("console" | "api" | "github" | null) | (string & {}) | null;
-    actor: string | null;
+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.
+ */
+export declare const DraftActionReason: {
+    readonly CONFLICT: "conflict";
+    readonly CHECKS_FAILED: "checks_failed";
+    readonly REVIEW_FAILED: "review_failed";
+    readonly CHECKS_UNAVAILABLE: "checks_unavailable";
+    readonly HISTORY_REWRITTEN: "history_rewritten";
 };
-export interface TargetDraft {
-    object: "target_draft";
+export type DraftActionReason = (typeof DraftActionReason)[keyof typeof DraftActionReason];
+export interface DraftConflicts {
+    /** Conflicts in the current merge stage. */
+    total: number;
+    /** Conflicts with a saved decision for head_sha. */
+    decided: number;
+}
+/** The approval inputs for a default-branch history rewrite. */
+export interface DraftHistoryRecovery {
+    /** Rewritten default-branch commit. Send it as expected_default_sha. */
+    default_sha: string;
+    /** Draft commit Typeship last observed. Send it as expected_head_sha. */
+    head_sha: string | null;
+    /** 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 {
+    /**
+     * 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";
+    /** 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 and supported SDK source comparison against the latest release. 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;
+    /**
+     * Minimum assessed version bump. Approval never waives an insufficient bump. Null when no bump
+     * has been determined.
+     */
+    bump_required: "major" | "minor" | "patch" | 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;
+}
+/** 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;
+    /**
+     * 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;
+    /** 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;
+}
+/**
+ * One reviewed package change for a Target. A Target has one open Draft, named by its draft_id;
+ * when the pull request merges, the Draft becomes merged and final, and the Target opens a new
+ * Draft with a new ID.
+ */
+export interface Draft {
+    id: DraftId;
+    object: "draft";
     target_id: TargetId;
-    revision: number;
-    current_version: string | null;
-    version: string | null;
-    selection: TargetDraftSelection;
-    readiness: Record<string, unknown> | null;
+    project_id: ProjectId;
+    status: DraftStatus;
+    /** Present and required when status is action_required; absent otherwise. */
+    reason?: DraftActionReason;
+    /** Next version for this Draft, or null before a version is selected. */
+    version_next: string | null;
+    /** Where version_next was selected; null once the Draft merged. */
+    version_source: "automatic" | "console" | "api" | "github" | null;
+    readiness: DraftReadiness | null;
     changes: {
-        /** Cumulative changelog against Current. */
+        /** Cumulative changelog against the latest release. */
         changelog?: string | null;
         breaking_count?: number | null;
-        previous_version?: string | null;
+        version_previous?: string | null;
     } | null;
-    head_revision: string | null;
-    /** Format: uri */
-    pull_request_url: string | null;
+    /**
+     * Draft commit that readiness, 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. */
+    pull_request: {
+        /** Format: uri */
+        url: string;
+        number: number;
+    } | null;
+    /** Generation whose package this Draft contains. */
+    generation_id: GenerationId | null;
+    /**
+     * Release this Draft created when it merged; null while open, or when a merge changed only tests
+     * or checks.
+     */
+    release_id: ReleaseId | null;
+    /**
+     * When the Draft opened.
+     * Format: date-time
+     */
+    created_at: string;
+    /** Format: date-time */
+    updated_at: string;
+    /** Conflict counts for the current merge stage; null when the Draft has no conflicts. */
+    conflicts: DraftConflicts | null;
+    /**
+     * Files where the Draft differs from the last accepted package; null until the Draft is
+     * integrated.
+     */
+    customized_files: number | null;
+    /** Present only while status is action_required and reason is history_rewritten. */
+    history_recovery: DraftHistoryRecovery | null;
     request_id?: RequestId;
+    checks: PackageCheck[];
 }
-/** Response shape for TargetDraft. */
-export interface TargetDraftRead {
-    object: "target_draft" | (string & {});
+/** Response shape for Draft. */
+export interface DraftRead {
+    id: DraftId;
+    object: "draft" | (string & {});
     target_id: TargetId;
-    revision: number;
-    current_version: string | null;
-    version: string | null;
-    selection: TargetDraftSelectionRead;
-    readiness: Record<string, unknown> | null;
+    project_id: ProjectId;
+    status: DraftStatus | (string & {});
+    /** Present and required when status is action_required; absent otherwise. */
+    reason?: DraftActionReason | (string & {});
+    /** Next version for this Draft, or null before a version is selected. */
+    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;
     changes: {
-        /** Cumulative changelog against Current. */
+        /** Cumulative changelog against the latest release. */
         changelog?: string | null;
         breaking_count?: number | null;
-        previous_version?: string | null;
+        version_previous?: string | null;
     } | null;
-    head_revision: string | null;
-    /** Format: uri */
-    pull_request_url: string | null;
+    /**
+     * Draft commit that readiness, 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. */
+    pull_request: {
+        /** Format: uri */
+        url: string;
+        number: number;
+    } | null;
+    /** Generation whose package this Draft contains. */
+    generation_id: GenerationId | null;
+    /**
+     * Release this Draft created when it merged; null while open, or when a merge changed only tests
+     * or checks.
+     */
+    release_id: ReleaseId | null;
+    /**
+     * When the Draft opened.
+     * Format: date-time
+     */
+    created_at: string;
+    /** Format: date-time */
+    updated_at: string;
+    /** Conflict counts for the current merge stage; null when the Draft has no conflicts. */
+    conflicts: DraftConflicts | null;
+    /**
+     * Files where the Draft differs from the last accepted package; null until the Draft is
+     * integrated.
+     */
+    customized_files: number | null;
+    /** Present only while status is action_required and reason is history_rewritten. */
+    history_recovery: DraftHistoryRecovery | null;
     request_id?: RequestId;
+    checks: PackageCheckRead[];
 }
-export type TargetDraftResponse = TargetDraft & ResponseMetadata;
-/** Response shape for TargetDraftResponse. */
-export type TargetDraftResponseRead = TargetDraftRead & ResponseMetadata;
-export interface TargetDraftUpdate {
+export type DraftResponse = Draft & ResponseMetadata;
+/** Response shape for DraftResponse. */
+export type DraftResponseRead = DraftRead & ResponseMetadata;
+export interface DraftUpdateRequest {
     /** Exact SemVer, or null to return to automatic selection. */
-    version: string | null;
-    expected_revision?: number;
-}
-export interface TargetAdoption {
-    /** Exact already-published package version to make Current. */
-    version: string;
-    /** Immutable repository tag containing the matching package source. */
-    tag: string;
-}
-export interface RepositoryHealthIssue {
-    code: "connection_missing" | "definition_unreadable" | "contents_write_missing" | "review_write_missing" | "breaking_acknowledgement_missing" | "provider_unavailable";
-    message: string;
+    version_next: string | null;
 }
-/** Response shape for RepositoryHealthIssue. */
-export interface RepositoryHealthIssueRead {
-    code: ("connection_missing" | "definition_unreadable" | "contents_write_missing" | "review_write_missing" | "breaking_acknowledgement_missing" | "provider_unavailable") | (string & {});
-    message: string;
+export interface PackageCheck {
+    name: string;
+    source: "typeship" | "customer" | "repository" | "compatibility";
+    required: boolean;
+    status: "pending" | "passed" | "failed" | "not_assessed";
+    reason: string;
+    commit_sha: string;
+    /** Format: uri */
+    url: string | null;
+    /** Format: date-time */
+    observed_at: string | null;
 }
-export interface RepositoryHealth {
-    repository: RepositoryReference;
-    roles: Array<"source" | "destination">;
-    status: "ready" | "action_required";
-    default_branch?: string;
-    capabilities?: string[];
-    /**
-     * Whether a source repository has the optional typeship:breaking-approved policy label. Null when
-     * the repository is not a source or labels could not be read.
-     */
-    breaking_acknowledgement?: boolean | null;
-    definition?: "readable" | "missing";
-    issues: RepositoryHealthIssue[];
-}
-/** Response shape for RepositoryHealth. */
-export interface RepositoryHealthRead {
-    repository: RepositoryReferenceRead;
-    roles: Array<("source" | "destination") | (string & {})>;
-    status: ("ready" | "action_required") | (string & {});
-    default_branch?: string;
-    capabilities?: string[];
-    /**
-     * Whether a source repository has the optional typeship:breaking-approved policy label. Null when
-     * the repository is not a source or labels could not be read.
-     */
-    breaking_acknowledgement?: boolean | null;
-    definition?: ("readable" | "missing") | (string & {});
-    issues: RepositoryHealthIssueRead[];
-}
-export interface RepositoryEventHealth {
-    provider: string;
-    id: string;
-    event: string;
-    status: "queued" | "processing" | "succeeded" | "failed" | "superseded";
-    error: string | null;
+/** Response shape for PackageCheck. */
+export interface PackageCheckRead {
+    name: string;
+    source: ("typeship" | "customer" | "repository" | "compatibility") | (string & {});
+    required: boolean;
+    status: ("pending" | "passed" | "failed" | "not_assessed") | (string & {});
+    reason: string;
+    commit_sha: string;
+    /** Format: uri */
+    url: string | null;
     /** Format: date-time */
-    created_at: string;
+    observed_at: string | null;
 }
-/** Response shape for RepositoryEventHealth. */
-export interface RepositoryEventHealthRead {
-    provider: string;
-    id: string;
-    event: string;
-    status: ("queued" | "processing" | "succeeded" | "failed" | "superseded") | (string & {});
-    error: string | null;
+export interface CompatibilityApproval {
+    source: "source_pr" | "draft_pr";
+    reason: string;
+    approved_by: string;
+    approved_sha: string;
     /** Format: date-time */
-    created_at: string;
+    approved_at: string;
 }
-export interface RepositoryIntegrationHealth {
-    object: "repository_integration_health";
-    project_id: ProjectId;
-    status: "ready" | "action_required";
-    repositories: RepositoryHealth[];
-    required_checks: {
-        source: string[];
-        destination: string[];
-    };
-    last_event: RepositoryEventHealth | null;
-    request_id: RequestId;
+/** Response shape for CompatibilityApproval. */
+export interface CompatibilityApprovalRead {
+    source: ("source_pr" | "draft_pr") | (string & {});
+    reason: string;
+    approved_by: string;
+    approved_sha: string;
+    /** Format: date-time */
+    approved_at: string;
 }
-/** Response shape for RepositoryIntegrationHealth. */
-export interface RepositoryIntegrationHealthRead {
-    object: "repository_integration_health" | (string & {});
-    project_id: ProjectId;
-    status: ("ready" | "action_required") | (string & {});
-    repositories: RepositoryHealthRead[];
-    required_checks: {
-        source: string[];
-        destination: string[];
-    };
-    last_event: RepositoryEventHealthRead | null;
-    request_id: RequestId;
+export interface TargetAdoption {
+    /** Exact already-published package version to make the latest release. */
+    version: string;
+    /** Immutable repository tag containing the matching package source. */
+    tag: string;
 }
-export interface DefinitionFields {
-    source: DefinitionSourceInput;
+export interface SpecFields {
+    source: SpecSourceInput;
     /** Default: [] */
-    patches?: DefinitionPatch[];
+    patches?: SpecPatch[];
     /** GraphQL-only endpoint, auth, environment, title, and scalar settings. */
     graphql?: GraphqlSettings | null;
     diagnostic_policy?: DiagnosticPolicy;
 }
-/** Response shape for DefinitionFields. */
-export interface DefinitionFieldsRead {
-    source: DefinitionSourceInputRead;
+/** Response shape for SpecFields. */
+export interface SpecFieldsRead {
+    source: SpecSourceInputRead;
     /** Default: [] */
-    patches?: DefinitionPatchRead[];
+    patches?: SpecPatchRead[];
     /** GraphQL-only endpoint, auth, environment, title, and scalar settings. */
     graphql?: GraphqlSettingsRead | null;
     diagnostic_policy?: DiagnosticPolicyRead;
 }
-export interface Definition {
-    id: DefinitionId;
-    object: "definition";
+export interface Spec {
+    id: SpecId;
+    object: "spec";
     project_id: ProjectId;
-    source: DefinitionSource;
+    source: SpecSource;
     format: "openapi" | "graphql" | null;
-    patches: DefinitionPatch[];
-    graphql: GraphqlSettings | null;
-    diagnostic_policy: DiagnosticPolicy;
-    latest_revision_id: DefinitionRevisionId | null;
+    patches: SpecPatchResponse[];
+    graphql: GraphqlSettingsResponse | null;
+    diagnostic_policy: DiagnosticPolicyResponse;
+    revision_latest_id: SpecRevisionId | null;
     /** Format: date-time */
     created_at: string;
     /** Format: date-time */
     updated_at: string;
     request_id: RequestId;
 }
-/** Request shape for Definition. */
-export interface DefinitionWrite {
-    id: DefinitionId;
-    object: "definition";
+/** Request shape for Spec. */
+export interface SpecWrite {
+    id: SpecId;
+    object: "spec";
     project_id: ProjectId;
-    source: DefinitionSourceWrite;
+    source: SpecSourceWrite;
     format: "openapi" | "graphql" | null;
-    patches: DefinitionPatch[];
-    graphql: GraphqlSettings | null;
-    diagnostic_policy: DiagnosticPolicy;
-    latest_revision_id: DefinitionRevisionId | null;
+    patches: SpecPatchResponse[];
+    graphql: GraphqlSettingsResponse | null;
+    diagnostic_policy: DiagnosticPolicyResponse;
+    revision_latest_id: SpecRevisionId | null;
     /** Format: date-time */
     created_at: string;
     /** Format: date-time */
     updated_at: string;
     request_id: RequestId;
 }
-/** Response shape for Definition. */
-export interface DefinitionRead {
-    id: DefinitionId;
-    object: "definition" | (string & {});
+/** Response shape for Spec. */
+export interface SpecRead {
+    id: SpecId;
+    object: "spec" | (string & {});
     project_id: ProjectId;
-    source: DefinitionSourceRead;
+    source: SpecSourceRead;
     format: ("openapi" | "graphql" | null) | (string & {}) | null;
-    patches: DefinitionPatchRead[];
-    graphql: GraphqlSettingsRead | null;
-    diagnostic_policy: DiagnosticPolicyRead;
-    latest_revision_id: DefinitionRevisionId | null;
+    patches: SpecPatchResponseRead[];
+    graphql: GraphqlSettingsResponseRead | null;
+    diagnostic_policy: DiagnosticPolicyResponseRead;
+    revision_latest_id: SpecRevisionId | null;
     /** Format: date-time */
     created_at: string;
     /** Format: date-time */
     updated_at: string;
     request_id: RequestId;
 }
-export interface DefinitionUpdateRequest {
-    source?: DefinitionSourceInput;
-    patches?: DefinitionPatch[];
+/**
+ * Omitted fields remain unchanged. Supplied objects and arrays replace the whole field. URL source
+ * headers are preserved when the URL is unchanged and headers are omitted; null or empty headers
+ * clear them.
+ */
+export interface SpecUpdateRequest {
+    source?: SpecSourceInput;
+    /** Replace all patches in order. An empty array removes every patch; null is invalid. */
+    patches?: SpecPatch[];
+    /** Replace all GraphQL settings. Null or an empty object clears them. */
     graphql?: GraphqlSettings | null;
+    /** Replace the complete policy and suppression list. Null and an empty object are invalid. */
     diagnostic_policy?: DiagnosticPolicy;
 }
-/** Response shape for DefinitionUpdateRequest. */
-export interface DefinitionUpdateRequestRead {
-    source?: DefinitionSourceInputRead;
-    patches?: DefinitionPatchRead[];
+/** Response shape for SpecUpdateRequest. */
+export interface SpecUpdateRequestRead {
+    source?: SpecSourceInputRead;
+    /** Replace all patches in order. An empty array removes every patch; null is invalid. */
+    patches?: SpecPatchRead[];
+    /** Replace all GraphQL settings. Null or an empty object clears them. */
     graphql?: GraphqlSettingsRead | null;
+    /** Replace the complete policy and suppression list. Null and an empty object are invalid. */
     diagnostic_policy?: DiagnosticPolicyRead;
 }
 /**
- * Project-owned identity, Definition reference, generation controls, and shared configuration.
- * Targets and Deliveries are available only through their canonical Target endpoints.
+ * Project-owned identity, Spec reference, generation controls, and shared configuration. Targets
+ * and Deliveries are available only through their canonical Target endpoints.
  */
 export interface Project {
     id: ProjectId;
     object: "project";
     name: string;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     /**
-     * Regenerate when the Definition changes: on every push to the default branch for a repository
-     * source, every 30 minutes for a URL source. Off by default: the first generation is always one
-     * you asked for. Off means only "generate now" and POST /projects/{project_id}/generations
-     * regenerate.
+     * Regenerate when the Spec or saved configuration changes. Enabled by default for new Projects.
+     * Set false to generate only when requested.
      */
     auto_generate: boolean;
-    /**
-     * Whether the webhook relay is on, letting the generated CLI's webhooks listen command mint relay
-     * sessions. Requires the cli target and Pro; turning the target off turns this off.
-     */
-    relay_enabled: boolean;
     /**
      * Shared defaults inherited by every Target. A Target's config overrides these defaults; GraphQL
-     * settings remain Definition-owned.
+     * settings remain Spec-owned.
      */
-    config: ProjectConfig | null;
+    config: ProjectConfigResponse | null;
     /** Format: date-time */
     created_at: string;
     /**
@@ -1466,24 +1845,17 @@ export interface Project {
 /** Request shape for Project. */
 export interface ProjectWrite {
     name: string;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     /**
-     * Regenerate when the Definition changes: on every push to the default branch for a repository
-     * source, every 30 minutes for a URL source. Off by default: the first generation is always one
-     * you asked for. Off means only "generate now" and POST /projects/{project_id}/generations
-     * regenerate.
+     * Regenerate when the Spec or saved configuration changes. Enabled by default for new Projects.
+     * Set false to generate only when requested.
      */
     auto_generate: boolean;
-    /**
-     * Whether the webhook relay is on, letting the generated CLI's webhooks listen command mint relay
-     * sessions. Requires the cli target and Pro; turning the target off turns this off.
-     */
-    relay_enabled: boolean;
     /**
      * Shared defaults inherited by every Target. A Target's config overrides these defaults; GraphQL
-     * settings remain Definition-owned.
+     * settings remain Spec-owned.
      */
-    config: ProjectConfig | null;
+    config: ProjectConfigResponse | null;
     request_id: RequestId;
 }
 /** Response shape for Project. */
@@ -1491,24 +1863,17 @@ export interface ProjectRead {
     id: ProjectId;
     object: "project" | (string & {});
     name: string;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     /**
-     * Regenerate when the Definition changes: on every push to the default branch for a repository
-     * source, every 30 minutes for a URL source. Off by default: the first generation is always one
-     * you asked for. Off means only "generate now" and POST /projects/{project_id}/generations
-     * regenerate.
+     * Regenerate when the Spec or saved configuration changes. Enabled by default for new Projects.
+     * Set false to generate only when requested.
      */
     auto_generate: boolean;
-    /**
-     * Whether the webhook relay is on, letting the generated CLI's webhooks listen command mint relay
-     * sessions. Requires the cli target and Pro; turning the target off turns this off.
-     */
-    relay_enabled: boolean;
     /**
      * Shared defaults inherited by every Target. A Target's config overrides these defaults; GraphQL
-     * settings remain Definition-owned.
+     * settings remain Spec-owned.
      */
-    config: ProjectConfigRead | null;
+    config: ProjectConfigResponseRead | null;
     /** Format: date-time */
     created_at: string;
     /**
@@ -1526,7 +1891,7 @@ export interface ProjectSummary {
     id: ProjectId;
     object: "project";
     name: string;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     auto_generate: boolean;
     /** Format: date-time */
     created_at: string;
@@ -1538,7 +1903,7 @@ export interface ProjectSummaryRead {
     id: ProjectId;
     object: "project" | (string & {});
     name: string;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     auto_generate: boolean;
     /** Format: date-time */
     created_at: string;
@@ -1547,52 +1912,42 @@ export interface ProjectSummaryRead {
 }
 export interface CreateProjectRequest {
     name: string;
-    definition: DefinitionFields;
+    spec: SpecFields;
     /**
      * Initial first-class Targets. More than one may use the same generator with different identities
      * or Deliveries.
      */
     targets: InitialTargetFields[];
     /**
-     * Whether Typeship should regenerate automatically when the source changes.
-     * Default: false
+     * Whether Typeship should regenerate automatically when the source or saved configuration
+     * changes.
+     * Default: true
      */
     auto_generate?: boolean;
-    /**
-     * Enable webhook relay sessions. Requires the CLI target and Pro.
-     * Default: false
-     */
-    relay_enabled?: boolean;
-    /** Shared defaults inherited by every Target. GraphQL settings belong in definition.graphql. */
+    /** Shared defaults inherited by every Target. GraphQL settings belong in spec.graphql. */
     config?: ProjectConfig | null;
 }
 /** Response shape for CreateProjectRequest. */
 export interface CreateProjectRequestRead {
     name: string;
-    definition: DefinitionFieldsRead;
+    spec: SpecFieldsRead;
     /**
      * Initial first-class Targets. More than one may use the same generator with different identities
      * or Deliveries.
      */
     targets: InitialTargetFieldsRead[];
     /**
-     * Whether Typeship should regenerate automatically when the source changes.
-     * Default: false
+     * Whether Typeship should regenerate automatically when the source or saved configuration
+     * changes.
+     * Default: true
      */
     auto_generate?: boolean;
-    /**
-     * Enable webhook relay sessions. Requires the CLI target and Pro.
-     * Default: false
-     */
-    relay_enabled?: boolean;
-    /** Shared defaults inherited by every Target. GraphQL settings belong in definition.graphql. */
+    /** Shared defaults inherited by every Target. GraphQL settings belong in spec.graphql. */
     config?: ProjectConfigRead | null;
 }
 export interface UpdateProjectRequest {
     name?: string;
     auto_generate?: boolean;
-    /** Enable webhook relay sessions. Requires the CLI target and Pro. */
-    relay_enabled?: boolean;
     /** Replaces the Project's shared Target defaults. Send null to clear them. */
     config?: ProjectConfig | null;
 }
@@ -1600,8 +1955,6 @@ export interface UpdateProjectRequest {
 export interface UpdateProjectRequestRead {
     name?: string;
     auto_generate?: boolean;
-    /** Enable webhook relay sessions. Requires the CLI target and Pro. */
-    relay_enabled?: boolean;
     /** Replaces the Project's shared Target defaults. Send null to clear them. */
     config?: ProjectConfigRead | null;
 }
@@ -1609,25 +1962,43 @@ export interface UpdateProjectRequestRead {
  * The organization an API key belongs to. Members share its projects, keys, and plan; sign-in
  * identity is not part of the API.
  */
-export interface Account {
+export interface Organization {
+    /** Opaque, output-only organization identifier. Copy it unchanged; its format is not a contract. */
     id: string;
-    object: "account";
+    object: "organization";
+    /** The organization's display name. */
+    name: string;
+    plan: "free" | "pro" | "enterprise";
+    /** Format: date-time */
+    created_at: string;
+    /** Format: date-time */
+    updated_at: string;
+    request_id: RequestId;
+}
+/** Request shape for Organization. */
+export interface OrganizationWrite {
+    object: "organization";
     /** The organization's display name. */
     name: string;
     plan: "free" | "pro" | "enterprise";
     /** Format: date-time */
     created_at: string;
+    /** Format: date-time */
+    updated_at: string;
     request_id: RequestId;
 }
-/** Response shape for Account. */
-export interface AccountRead {
+/** Response shape for Organization. */
+export interface OrganizationRead {
+    /** Opaque, output-only organization identifier. Copy it unchanged; its format is not a contract. */
     id: string;
-    object: "account" | (string & {});
+    object: "organization" | (string & {});
     /** The organization's display name. */
     name: string;
     plan: ("free" | "pro" | "enterprise") | (string & {});
     /** Format: date-time */
     created_at: string;
+    /** Format: date-time */
+    updated_at: string;
     request_id: RequestId;
 }
 /**
@@ -1708,19 +2079,26 @@ export interface OAuthApplicationRead {
 }
 /**
  * Authenticated identity read used to verify a login before it is saved. Operation is auto-detected
- * when omitted. Requests must include at least one of subject_field, account_field, or
- * organization_field.
+ * when omitted or null. At least one of subject_field, account_field, or organization_field must be
+ * a non-null JSON Pointer. Null clears an individual mapping while another remains. Set
+ * identity_verification itself to null to remove the whole policy.
  */
-export interface IdentityVerification {
+export type IdentityVerification = {
     /** resource.method of a safe identity read with no required arguments. */
-    operation?: string;
+    operation?: string | null;
     /** JSON Pointer to the stable caller ID in the identity response. */
-    subject_field?: string;
+    subject_field?: string | null;
     /** JSON Pointer to the customer account ID. */
-    account_field?: string;
+    account_field?: string | null;
     /** JSON Pointer to the customer organization ID. */
-    organization_field?: string;
-}
+    organization_field?: string | null;
+} & ({
+    subject_field: string;
+} | {
+    account_field: string;
+} | {
+    organization_field: string;
+});
 /** OAuth application and request-value overrides for one named API environment. */
 export interface AuthenticationEnvironment {
     oauth_application?: string | null;
@@ -1731,7 +2109,7 @@ export interface AuthenticationEnvironment {
 }
 /**
  * Public authentication defaults for generated clients and tools. Stored Projects own the OAuth
- * server, application catalog, and identity policy; stateless generation accepts the same shape for
+ * server, application catalog, and identity policy; one-shot generation accepts the same shape for
  * one run. Runtime credentials and client secrets are never accepted.
  */
 export interface AuthenticationConfig {
@@ -1772,6 +2150,40 @@ export interface CliBehavior {
      * code phones nobody unless this is enabled.
      */
     update_notice?: boolean;
+    /**
+     * Public HTTP(S) URL read by the optional changelog command in generated CLIs. Supports UTF-8
+     * Markdown, plain text, and static HTML; embedded credentials are not allowed. Omit or clear to
+     * disable, then regenerate.
+     */
+    changelog_url?: string | null;
+    /**
+     * Where the generated CLI's feedback command sends users. GitHub issues/new URLs get a prefilled
+     * title and environment details.
+     */
+    support_url?: string | null;
+    /**
+     * Hosted MCP endpoint installed by the generated CLI instead of launching the package's local
+     * stdio server.
+     */
+    mcp_url?: string | null;
+    /** GitHub owner/name of the skills package the generated CLI offers to install during init. */
+    skills_repo?: string | null;
+}
+/** How the generated CLI behaves. Part of Config. */
+export interface TargetCliBehavior {
+    /** Command users run, independent of how the CLI is distributed. */
+    command_name?: string | null;
+    /**
+     * Opt in to a once-a-day registry check that prints an upgrade hint. Off by default; generated
+     * code phones nobody unless this is enabled.
+     */
+    update_notice?: boolean;
+    /**
+     * Public HTTP(S) URL read by the optional changelog command in generated CLIs. Supports UTF-8
+     * Markdown, plain text, and static HTML; embedded credentials are not allowed. Omit or clear to
+     * disable, then regenerate.
+     */
+    changelog_url?: string | null;
     /**
      * Where the generated CLI's feedback command sends users. GitHub issues/new URLs get a prefilled
      * title and environment details.
@@ -1784,6 +2196,11 @@ export interface CliBehavior {
     mcp_url?: string | null;
     /** GitHub owner/name of the skills package the generated CLI offers to install during init. */
     skills_repo?: string | null;
+    /**
+     * Enable webhook relay sessions for this CLI Target. Requires Pro. Turning it off prevents new
+     * sessions.
+     */
+    relay?: boolean;
 }
 /** How generated MCP servers and the Typeship-hosted endpoint behave. Part of Config. */
 export interface McpBehavior {
@@ -1936,11 +2353,10 @@ export interface PackageBehavior {
     go_package_name?: string | null;
 }
 /**
- * Everything Typeship needs beyond the Definition, 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 Definition
- * itself. Stateless generation also accepts GraphQL settings here; stored projects keep those
- * settings on their Definition.
+ * 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 Config {
     /**
@@ -1963,8 +2379,9 @@ export interface Config {
     package?: PackageBehavior;
     /**
      * 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 Definition's
-     * externalDocs URL.
+     * 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;
     /**
@@ -1995,8 +2412,9 @@ export interface ConfigRead {
     package?: PackageBehavior;
     /**
      * 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 Definition's
-     * externalDocs URL.
+     * 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;
     /**
@@ -2009,7 +2427,7 @@ export interface ConfigRead {
  * 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
  * while cli, mcp, auth, readme, and package merge by field. GraphQL-only source settings live on
- * the Project's Definition and are rejected in both stored config scopes.
+ * the Project's Spec and are rejected in both stored config scopes.
  */
 export interface ProjectConfig {
     /**
@@ -2031,8 +2449,9 @@ export interface ProjectConfig {
     package?: PackageBehavior;
     /**
      * 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 Definition's
-     * externalDocs URL.
+     * 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;
     /**
@@ -2062,8 +2481,9 @@ export interface ProjectConfigRead {
     package?: PackageBehavior;
     /**
      * 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 Definition's
-     * externalDocs URL.
+     * 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;
     /**
@@ -2078,32 +2498,66 @@ export interface ProjectConfigRead {
  * Self-hosted MCP access may be overridden for a Target-specific deployment.
  */
 export interface TargetConfig {
+    /**
+     * 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?: RetryTuning;
+    /**
+     * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
+     * reported as generation warnings.
+     */
     pagination?: Record<string, PaginationRule | boolean>;
     auth?: TargetAuthenticationConfig;
-    cli?: CliBehavior;
+    cli?: TargetCliBehavior;
     mcp?: McpBehavior;
     readme?: ReadmeBehavior;
     package?: PackageBehavior;
-    /** Format: uri */
+    /**
+     * 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;
-    /** Format: uri */
+    /**
+     * 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 TargetConfig. */
 export interface TargetConfigRead {
+    /**
+     * 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?: RetryTuning;
+    /**
+     * Per-operation pagination control, keyed by operationId or "METHOD /path". Unmatched keys are
+     * reported as generation warnings.
+     */
     pagination?: Record<string, PaginationRuleRead | boolean>;
     auth?: TargetAuthenticationConfig;
-    cli?: CliBehavior;
+    cli?: TargetCliBehavior;
     mcp?: McpBehaviorRead;
     readme?: ReadmeBehavior;
     package?: PackageBehavior;
-    /** Format: uri */
+    /**
+     * 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;
-    /** Format: uri */
+    /**
+     * Exact llms.txt URL when the documentation site does not publish it at docs_url + /llms.txt.
+     * Format: uri
+     */
     docs_index_url?: string | null;
 }
 /** What a GraphQL schema cannot say about itself. Ignored for OpenAPI specs. */
@@ -2204,7 +2658,7 @@ export interface RetryTuning {
 }
 export interface PaginationRule {
     /** Default: "cursor" */
-    style?: "cursor" | "cursorFromLastId" | "page" | "offset";
+    style?: "cursor" | "cursor_from_last_id" | "page" | "offset";
     /** Response field holding the item array. */
     items_field: string;
     cursor_param?: string;
@@ -2218,7 +2672,7 @@ export interface PaginationRule {
 /** Response shape for PaginationRule. */
 export interface PaginationRuleRead {
     /** Default: "cursor" */
-    style?: ("cursor" | "cursorFromLastId" | "page" | "offset") | (string & {});
+    style?: ("cursor" | "cursor_from_last_id" | "page" | "offset") | (string & {});
     /** Response field holding the item array. */
     items_field: string;
     cursor_param?: string;
@@ -2232,183 +2686,126 @@ export interface PaginationRuleRead {
 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.
+ */
 export declare const GenerationStatus: {
-    readonly SUCCEEDED: "succeeded";
+    readonly QUEUED: "queued";
+    readonly RUNNING: "running";
+    readonly COMPLETED: "completed";
     readonly FAILED: "failed";
 };
 export type GenerationStatus = (typeof GenerationStatus)[keyof typeof GenerationStatus];
 export declare const GenerationTrigger: {
     readonly MANUAL: "manual";
-    readonly WEBHOOK: "webhook";
-    readonly POLL: "poll";
+    readonly SPEC_CHANGED: "spec_changed";
+    readonly CONFIG_CHANGED: "config_changed";
     readonly PREVIEW: "preview";
 };
 export type GenerationTrigger = (typeof GenerationTrigger)[keyof typeof GenerationTrigger];
-export interface GenerationProvenance {
-    /** Pinned generator contract edition. */
-    generator_edition: string;
-    /** Exact engine build identifier used for replay and support. */
-    engine_build: string;
-    /**
-     * Immutable effective Target configuration used by this run; source credentials are never
-     * included.
-     */
-    resolved_config: Record<string, unknown> | null;
-    config_hash: string | null;
-    /** Resolved generator and entitlement plan used to select the emitted public surface. */
-    surface_plan: Record<string, unknown> | null;
-    surface_plan_hash: string | null;
-    entitlement_cap: number | null;
-    package_version: string | null;
-}
 export interface Generation {
     id: GenerationId;
     object: "generation";
-    /**
-     * Present and true when the generated target was too large to inline; files_index lists paths,
-     * fetched one at a time via GET /generations/{generation_id}/file.
-     */
-    files_omitted?: boolean;
-    files_index?: FileStub[];
     project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId | null;
+    spec_revision_id: SpecRevisionId | null;
     status: GenerationStatus;
     trigger: GenerationTrigger;
-    /** Persisted Target identity. Null only for stateless generation. */
     target_id: TargetId | null;
-    /** Resolved generator implementation; provenance rather than resource identity. */
-    generator: GeneratorKind;
-    provenance: GenerationProvenance;
-    /** Null only for a failed or legacy generation that produced no metadata. */
-    meta: GenerationMeta | null;
-    warnings: string[];
-    /** Present on retrieve and create; omitted in lists. */
-    files?: GeneratedFile[];
-    error: string | null;
+    type: GeneratorKind;
+    /** Package name; null until known. */
+    name: string | null;
+    /** Package version; null until known. */
+    version: string | null;
+    warnings: GenerationWarning[];
+    /** Operation coverage; null until generation has finished. */
+    coverage: GenerationCoverage | null;
+    /** Generated package files. List them with listGenerationFiles. */
+    file_count: number;
+    errors: DomainError[];
+    /**
+     * Milliseconds from the start of the run until it completed or failed; null while queued or
+     * running.
+     */
+    runtime_ms: number | null;
     /** Format: date-time */
     created_at: string;
-    request_id?: RequestId;
+    /** Format: date-time */
+    updated_at: string;
 }
 /** Request shape for Generation. */
 export interface GenerationWrite {
     id: GenerationId;
-    /**
-     * Present and true when the generated target was too large to inline; files_index lists paths,
-     * fetched one at a time via GET /generations/{generation_id}/file.
-     */
-    files_omitted?: boolean;
-    files_index?: FileStub[];
     project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId | null;
+    spec_revision_id: SpecRevisionId | null;
     status: GenerationStatus;
     trigger: GenerationTrigger;
-    /** Persisted Target identity. Null only for stateless generation. */
     target_id: TargetId | null;
-    /** Resolved generator implementation; provenance rather than resource identity. */
-    generator: GeneratorKind;
-    provenance: GenerationProvenance;
-    /** Null only for a failed or legacy generation that produced no metadata. */
-    meta: GenerationMeta | null;
-    warnings: string[];
-    /** Present on retrieve and create; omitted in lists. */
-    files?: GeneratedFile[];
-    error: string | null;
+    type: GeneratorKind;
+    /** Package name; null until known. */
+    name: string | null;
+    /** Package version; null until known. */
+    version: string | null;
+    warnings: GenerationWarning[];
+    /** Operation coverage; null until generation has finished. */
+    coverage: GenerationCoverage | null;
+    /** Generated package files. List them with listGenerationFiles. */
+    file_count: number;
+    errors: DomainError[];
+    /**
+     * Milliseconds from the start of the run until it completed or failed; null while queued or
+     * running.
+     */
+    runtime_ms: number | null;
     /** Format: date-time */
     created_at: string;
-    request_id?: RequestId;
+    /** Format: date-time */
+    updated_at: string;
 }
 /** Response shape for Generation. */
 export interface GenerationRead {
     id: GenerationId;
     object: "generation" | (string & {});
-    /**
-     * Present and true when the generated target was too large to inline; files_index lists paths,
-     * fetched one at a time via GET /generations/{generation_id}/file.
-     */
-    files_omitted?: boolean;
-    files_index?: FileStub[];
     project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId | null;
+    spec_revision_id: SpecRevisionId | null;
     status: GenerationStatus | (string & {});
     trigger: GenerationTrigger | (string & {});
-    /** Persisted Target identity. Null only for stateless generation. */
     target_id: TargetId | null;
-    /** Resolved generator implementation; provenance rather than resource identity. */
-    generator: GeneratorKind | (string & {});
-    provenance: GenerationProvenance;
-    /** Null only for a failed or legacy generation that produced no metadata. */
-    meta: GenerationMetaRead | null;
-    warnings: string[];
-    /** Present on retrieve and create; omitted in lists. */
-    files?: GeneratedFile[];
-    error: string | null;
+    type: GeneratorKind | (string & {});
+    /** Package name; null until known. */
+    name: string | null;
+    /** Package version; null until known. */
+    version: string | null;
+    warnings: GenerationWarning[];
+    /** Operation coverage; null until generation has finished. */
+    coverage: GenerationCoverageRead | null;
+    /** Generated package files. List them with listGenerationFiles. */
+    file_count: number;
+    errors: DomainErrorRead[];
+    /**
+     * Milliseconds from the start of the run until it completed or failed; null while queued or
+     * running.
+     */
+    runtime_ms: number | null;
     /** Format: date-time */
     created_at: string;
-    request_id?: RequestId;
-}
-/**
- * Generation metadata returned by collection endpoints. Generated file contents and file indexes
- * are available only from retrieve and create operations.
- */
-export interface GenerationSummary {
-    id: GenerationId;
-    object: "generation";
-    project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId | null;
-    status: GenerationStatus;
-    trigger: GenerationTrigger;
-    /** Persisted Target identity. Null only for stateless generation. */
-    target_id: TargetId | null;
-    /** Resolved generator implementation; provenance rather than resource identity. */
-    generator: GeneratorKind;
-    provenance: GenerationProvenance;
-    /** Null only for a failed or legacy generation that produced no metadata. */
-    meta: GenerationMeta | null;
-    warnings: string[];
-    error: string | null;
     /** Format: date-time */
-    created_at: string;
+    updated_at: string;
 }
+/** Generation metadata returned by collection endpoints. */
+export type GenerationSummary = Generation;
 /** Request shape for GenerationSummary. */
-export interface GenerationSummaryWrite {
-    id: GenerationId;
-    project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId | null;
-    status: GenerationStatus;
-    trigger: GenerationTrigger;
-    /** Persisted Target identity. Null only for stateless generation. */
-    target_id: TargetId | null;
-    /** Resolved generator implementation; provenance rather than resource identity. */
-    generator: GeneratorKind;
-    provenance: GenerationProvenance;
-    /** Null only for a failed or legacy generation that produced no metadata. */
-    meta: GenerationMeta | null;
-    warnings: string[];
-    error: string | null;
-    /** Format: date-time */
-    created_at: string;
-}
+export type GenerationSummaryWrite = GenerationWrite;
 /** Response shape for GenerationSummary. */
-export interface GenerationSummaryRead {
-    id: GenerationId;
-    object: "generation" | (string & {});
-    project_id: ProjectId;
-    definition_revision_id: DefinitionRevisionId | null;
-    status: GenerationStatus | (string & {});
-    trigger: GenerationTrigger | (string & {});
-    /** Persisted Target identity. Null only for stateless generation. */
-    target_id: TargetId | null;
-    /** Resolved generator implementation; provenance rather than resource identity. */
-    generator: GeneratorKind | (string & {});
-    provenance: GenerationProvenance;
-    /** Null only for a failed or legacy generation that produced no metadata. */
-    meta: GenerationMetaRead | null;
-    warnings: string[];
-    error: string | null;
-    /** Format: date-time */
-    created_at: string;
-}
+export type GenerationSummaryRead = GenerationRead;
 export type GenerationResponse = Generation & ResponseMetadata;
 /** Request shape for GenerationResponse. */
 export type GenerationResponseWrite = GenerationWrite & ResponseMetadata;
@@ -2417,33 +2814,35 @@ export type GenerationResponseRead = GenerationRead & ResponseMetadata;
 /** A selected target that did not generate in a multi-target run. */
 export interface GenerationFailure {
     target_id: TargetId;
-    generator: GeneratorKind;
+    type: GeneratorKind;
     status: "failed";
-    error: string;
+    /** Recorded failures. Empty when this resource has no recorded failure. */
+    errors: DomainError[];
 }
 /** Response shape for GenerationFailure. */
 export interface GenerationFailureRead {
     target_id: TargetId;
-    generator: GeneratorKind | (string & {});
+    type: GeneratorKind | (string & {});
     status: "failed" | (string & {});
-    error: string;
+    /** Recorded failures. Empty when this resource has no recorded failure. */
+    errors: DomainErrorRead[];
 }
 /**
- * Metadata for each Target generation attempted by a Project run. Retrieve one Generation
- * separately for generated files.
+ * One Generation per selected Target. Retrieve each Generation for current status and generated
+ * files.
  */
 export interface GenerationBatch {
-    data: Array<GenerationSummary | GenerationFailure>;
+    data: GenerationSummary[];
     request_id: RequestId;
 }
 /** Request shape for GenerationBatch. */
 export interface GenerationBatchWrite {
-    data: Array<GenerationSummaryWrite | GenerationFailure>;
+    data: GenerationSummaryWrite[];
     request_id: RequestId;
 }
 /** Response shape for GenerationBatch. */
 export interface GenerationBatchRead {
-    data: Array<GenerationSummaryRead | GenerationFailureRead>;
+    data: GenerationSummaryRead[];
     request_id: RequestId;
 }
 export interface ApiKey {
@@ -2457,6 +2856,11 @@ export interface ApiKey {
     last_used_at: string | null;
     /** Format: date-time */
     created_at: string;
+    /**
+     * When the key last changed, such as its revocation.
+     * Format: date-time
+     */
+    updated_at: string;
     request_id?: RequestId;
 }
 /** Response shape for ApiKey. */
@@ -2471,107 +2875,119 @@ export interface ApiKeyRead {
     last_used_at: string | null;
     /** Format: date-time */
     created_at: string;
+    /**
+     * When the key last changed, such as its revocation.
+     * Format: date-time
+     */
+    updated_at: string;
     request_id?: RequestId;
 }
 export type ApiKeyResponse = ApiKey & ResponseMetadata;
 /** Response shape for ApiKeyResponse. */
 export type ApiKeyResponseRead = ApiKeyRead & ResponseMetadata;
-export interface UrlDefinitionRevisionSource {
-    kind: "url";
-    /** Format: uri */
-    url: string;
+export interface UrlSpecRevisionSource {
+    type: "url";
+    url: {
+        /** Format: uri */
+        url: string;
+    };
 }
-/** Response shape for UrlDefinitionRevisionSource. */
-export interface UrlDefinitionRevisionSourceRead {
-    kind: "url" | (string & {});
-    /** Format: uri */
-    url: string;
+/** Response shape for UrlSpecRevisionSource. */
+export interface UrlSpecRevisionSourceRead {
+    type: "url" | (string & {});
+    url: {
+        /** Format: uri */
+        url: string;
+    };
 }
-export interface RepositoryDefinitionRevisionSource {
-    kind: "repository";
-    repository: RepositoryReference;
-    /** Repository-relative Definition entrypoint path. */
-    path: string;
-    /** Git ref resolved for this revision, when recorded. */
-    ref?: string | null;
-    /** Exact Git commit consumed, when recorded. */
-    commit_sha?: string | null;
-}
-/** Response shape for RepositoryDefinitionRevisionSource. */
-export interface RepositoryDefinitionRevisionSourceRead {
-    kind: "repository" | (string & {});
-    repository: RepositoryReferenceRead;
-    /** Repository-relative Definition entrypoint path. */
-    path: string;
-    /** Git ref resolved for this revision, when recorded. */
-    ref?: string | null;
-    /** Exact Git commit consumed, when recorded. */
-    commit_sha?: string | null;
-}
-export type DefinitionRevisionSource = UrlDefinitionRevisionSource | RepositoryDefinitionRevisionSource;
-/** Response shape for DefinitionRevisionSource. */
-export type DefinitionRevisionSourceRead = UrlDefinitionRevisionSourceRead | RepositoryDefinitionRevisionSourceRead | Record<string, unknown> & {
-    kind?: string;
-};
-export interface DefinitionDocument {
-    id: DefinitionDocumentId;
-    role: "entrypoint" | "reference";
-    /** Repository-relative path or same-origin URL captured in this revision. */
-    coordinate: string;
-    sha256: string;
-    size_bytes: number;
+export interface RepositorySpecRevisionSource {
+    type: "repository";
+    repository: {
+        provider: RepositoryProvider;
+        identifier: RepositoryIdentifier;
+        /** Repository-relative Spec entrypoint path. */
+        path: string;
+        /** Git ref resolved for this revision, when recorded. */
+        ref?: string | null;
+        /** Exact Git commit consumed, when recorded. */
+        commit_sha?: string | null;
+    };
 }
-/** Response shape for DefinitionDocument. */
-export interface DefinitionDocumentRead {
-    id: DefinitionDocumentId;
-    role: ("entrypoint" | "reference") | (string & {});
-    /** Repository-relative path or same-origin URL captured in this revision. */
-    coordinate: string;
-    sha256: string;
-    size_bytes: number;
+/** Response shape for RepositorySpecRevisionSource. */
+export interface RepositorySpecRevisionSourceRead {
+    type: "repository" | (string & {});
+    repository: {
+        provider: RepositoryProvider | (string & {});
+        identifier: RepositoryIdentifier;
+        /** Repository-relative Spec entrypoint path. */
+        path: string;
+        /** Git ref resolved for this revision, when recorded. */
+        ref?: string | null;
+        /** Exact Git commit consumed, when recorded. */
+        commit_sha?: string | null;
+    };
 }
-export interface DefinitionRevision {
-    id: DefinitionRevisionId;
-    object: "definition_revision";
+export type SpecRevisionSource = UrlSpecRevisionSource | RepositorySpecRevisionSource;
+/** Response shape for SpecRevisionSource. */
+export type SpecRevisionSourceRead = UrlSpecRevisionSourceRead | RepositorySpecRevisionSourceRead | Record<string, unknown> & {
+    type?: string;
+};
+export interface SpecRevision {
+    id: SpecRevisionId;
+    object: "spec_revision";
     project_id: ProjectId;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     format: "openapi" | "graphql";
-    document_count: number;
-    /** Present on retrieve; list responses use document_count. */
-    documents?: DefinitionDocument[];
-    /** SHA-256 digest of every document coordinate, digest, and size in the resolved graph. */
+    file_count: number;
+    /** SHA-256 digest of every source file path, digest, and size in the resolved graph. */
     sha256: string;
-    /** Total bytes across all source documents. */
+    /** Total bytes across all source files. */
     size_bytes: number;
     /** Origin recorded when this immutable revision was created. */
-    source: DefinitionRevisionSource | null;
+    source: SpecRevisionSource | null;
+    /** Present on retrieve; list responses omit it. */
+    diagnostic_summary?: DiagnosticSummary;
+    /** Present only with include=diagnostics. Ordered by severity, then rule identifier. */
+    diagnostics?: Diagnostic[];
+    /**
+     * Present only with include=diagnostics. Coded misses or conflicts from applying the Spec's
+     * patches to this revision.
+     */
+    patch_diagnostics?: DiagnosticWarning[];
     /** Format: date-time */
     created_at: string;
     request_id?: RequestId;
 }
-/** Response shape for DefinitionRevision. */
-export interface DefinitionRevisionRead {
-    id: DefinitionRevisionId;
-    object: "definition_revision" | (string & {});
+/** Response shape for SpecRevision. */
+export interface SpecRevisionRead {
+    id: SpecRevisionId;
+    object: "spec_revision" | (string & {});
     project_id: ProjectId;
-    definition_id: DefinitionId;
+    spec_id: SpecId;
     format: ("openapi" | "graphql") | (string & {});
-    document_count: number;
-    /** Present on retrieve; list responses use document_count. */
-    documents?: DefinitionDocumentRead[];
-    /** SHA-256 digest of every document coordinate, digest, and size in the resolved graph. */
+    file_count: number;
+    /** SHA-256 digest of every source file path, digest, and size in the resolved graph. */
     sha256: string;
-    /** Total bytes across all source documents. */
+    /** Total bytes across all source files. */
     size_bytes: number;
     /** Origin recorded when this immutable revision was created. */
-    source: DefinitionRevisionSourceRead | null;
+    source: SpecRevisionSourceRead | null;
+    /** Present on retrieve; list responses omit it. */
+    diagnostic_summary?: DiagnosticSummaryRead;
+    /** Present only with include=diagnostics. Ordered by severity, then rule identifier. */
+    diagnostics?: DiagnosticRead[];
+    /**
+     * Present only with include=diagnostics. Coded misses or conflicts from applying the Spec's
+     * patches to this revision.
+     */
+    patch_diagnostics?: DiagnosticWarningRead[];
     /** Format: date-time */
     created_at: string;
     request_id?: RequestId;
 }
-export type DefinitionRevisionResponse = DefinitionRevision & ResponseMetadata;
-/** Response shape for DefinitionRevisionResponse. */
-export type DefinitionRevisionResponseRead = DefinitionRevisionRead & ResponseMetadata;
+export type SpecRevisionResponse = SpecRevision & ResponseMetadata;
+/** Response shape for SpecRevisionResponse. */
+export type SpecRevisionResponseRead = SpecRevisionRead & ResponseMetadata;
 export interface ProjectList {
     object: ListObject;
     data: ProjectSummary[];
@@ -2620,19 +3036,19 @@ export interface GenerationListRead {
     next_cursor: string | null;
     request_id: RequestId;
 }
-export interface DefinitionRevisionList {
+export interface SpecRevisionList {
     object: ListObject;
-    data: DefinitionRevision[];
+    data: SpecRevision[];
     /** 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;
 }
-/** Response shape for DefinitionRevisionList. */
-export interface DefinitionRevisionListRead {
+/** Response shape for SpecRevisionList. */
+export interface SpecRevisionListRead {
     object: ListObject;
-    data: DefinitionRevisionRead[];
+    data: SpecRevisionRead[];
     /** 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. */
@@ -2704,16 +3120,18 @@ export declare const ErrorCode: {
     readonly INSUFFICIENT_SCOPE: "insufficient_scope";
     readonly FORBIDDEN: "forbidden";
     readonly NOT_FOUND: "not_found";
+    readonly METHOD_NOT_ALLOWED: "method_not_allowed";
     readonly SPEC_ERROR: "spec_error";
     readonly FETCH_ERROR: "fetch_error";
     readonly REPOSITORY_PROVIDER_UNSUPPORTED: "repository_provider_unsupported";
-    readonly EDITION_UNAVAILABLE: "edition_unavailable";
     readonly TARGET_BUSY: "target_busy";
+    readonly NO_DRAFT: "no_draft";
+    readonly DRAFT_MERGED: "draft_merged";
+    readonly RESOURCE_CHANGED: "resource_changed";
     readonly INVALID_VERSION: "invalid_version";
-    readonly STALE_RELEASE_REVISION: "stale_release_revision";
+    readonly PRECONDITION_FAILED: "precondition_failed";
     readonly VERSION_OCCUPIED: "version_occupied";
     readonly VERSION_TOO_LOW: "version_too_low";
-    readonly RELEASE_ANALYSIS_STALE: "release_analysis_stale";
     readonly TARGET_ALREADY_RELEASED: "target_already_released";
     readonly ADOPTION_UNVERIFIED: "adoption_unverified";
     readonly PUBLICATION_DISABLED: "publication_disabled";
@@ -2728,16 +3146,47 @@ export declare const ErrorCode: {
     readonly PAYLOAD_TOO_LARGE: "payload_too_large";
     readonly RATE_LIMITED: "rate_limited";
     readonly INTERNAL_ERROR: "internal_error";
+    readonly DEPENDENCY_MISSING: "dependency_missing";
+    readonly DEPENDENCY_NOT_FOUND: "dependency_not_found";
+    readonly DEPENDENCY_SELF: "dependency_self";
+    readonly DEPENDENCY_CYCLE: "dependency_cycle";
+    readonly DEPENDENCY_CROSS_PROJECT: "dependency_cross_project";
+    readonly DEPENDENCY_CROSS_LINEAGE: "dependency_cross_lineage";
+    readonly DEPENDENCY_WRONG_GENERATOR: "dependency_wrong_generator";
+    readonly DEPENDENCY_DISABLED: "dependency_disabled";
+    readonly DEPENDENCY_MODULE_PATH_MISSING: "dependency_module_path_missing";
+    readonly DEPENDENCY_UNRELEASED: "dependency_unreleased";
+    readonly DEPENDENCY_REVISION_MISMATCH: "dependency_revision_mismatch";
+    readonly PUBLICATION_FAILED: "publication_failed";
+    readonly CUSTOMIZATION_CONFLICT: "customization_conflict";
+    readonly HISTORY_RECOVERY_REQUIRED: "history_recovery_required";
+    readonly CHECKS_UNAVAILABLE: "checks_unavailable";
 };
 export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
 export interface ErrorDetail {
     type: ErrorType;
     code: ErrorCode;
-    /** JSON Pointer to the invalid request field, when one field caused the error. */
+    phase?: FailurePhase;
+    /** The affected Target when an operation reports failures for multiple Targets. */
+    target_id?: TargetId;
+    /**
+     * JSON Pointer to the invalid field within the request part named by in. When in is omitted, the
+     * pointer refers to the request body. Header pointers use lowercase header names, such as
+     * /idempotency-key.
+     */
     field?: string;
+    /**
+     * Request part containing field. Query-parameter errors use query; header errors use header. Body
+     * errors use body or omit in.
+     */
+    in?: "body" | "query" | "header";
     /** Human-readable explanation. Its wording may change. */
     message: string;
-    /** Whether retrying later can succeed without changing the request. */
+    /**
+     * Whether another attempt can succeed without correcting the inputs. For a recorded failure,
+     * start generation or publishing again; retrieving the resource or replaying an idempotency key
+     * does not start another attempt.
+     */
     retryable: boolean;
     /** Stable, concise recovery instruction suitable for a person or agent. */
     suggested_action: string;
@@ -2751,11 +3200,27 @@ export interface ErrorDetail {
 export interface ErrorDetailRead {
     type: ErrorType | (string & {});
     code: ErrorCode | (string & {});
-    /** JSON Pointer to the invalid request field, when one field caused the error. */
+    phase?: FailurePhase | (string & {});
+    /** The affected Target when an operation reports failures for multiple Targets. */
+    target_id?: TargetId;
+    /**
+     * JSON Pointer to the invalid field within the request part named by in. When in is omitted, the
+     * pointer refers to the request body. Header pointers use lowercase header names, such as
+     * /idempotency-key.
+     */
     field?: string;
+    /**
+     * Request part containing field. Query-parameter errors use query; header errors use header. Body
+     * errors use body or omit in.
+     */
+    in?: ("body" | "query" | "header") | (string & {});
     /** Human-readable explanation. Its wording may change. */
     message: string;
-    /** Whether retrying later can succeed without changing the request. */
+    /**
+     * Whether another attempt can succeed without correcting the inputs. For a recorded failure,
+     * start generation or publishing again; retrieving the resource or replaying an idempotency key
+     * does not start another attempt.
+     */
     retryable: boolean;
     /** Stable, concise recovery instruction suitable for a person or agent. */
     suggested_action: string;
@@ -2765,13 +3230,1033 @@ export interface ErrorDetailRead {
      */
     docs_url: string;
 }
-export interface ErrorModel {
-    errors: ErrorDetail[];
-    request_id: RequestId;
+export interface RepositoryReferenceResponse {
+    provider: RepositoryProvider;
+    identifier: RepositoryIdentifier;
 }
-/** Response shape for ErrorModel. */
-export interface ErrorModelRead {
-    errors: ErrorDetailRead[];
-    request_id: RequestId;
+/** Response shape for RepositoryReferenceResponse. */
+export interface RepositoryReferenceResponseRead {
+    provider: RepositoryProvider | (string & {});
+    identifier: RepositoryIdentifier;
+}
+/**
+ * A fix applied to the resolved Spec before generation. Paths are JSON
+ * Pointers into the document. A patch whose target no longer exists is
+ * skipped and reported as a warning on the generation, never silently.
+ */
+export interface SpecPatchResponse {
+    op: "set" | "append" | "remove" | "rename";
+    /**
+     * JSON-Pointer-style path. Pattern segments enable bulk fixes:
+     * * (any child), ** (any depth), [key=value] (filter), e.g.
+     * /paths/**\/parameters/[name=account_id]/schema/type. Renaming a
+     * schema under /components/schemas also rewrites its $refs.
+     */
+    path: string;
+    /** set only; the replacement value. */
+    value?: unknown;
+    /** rename only; the new key name. */
+    to?: string | null;
+    reason?: string | null;
+}
+/** Response shape for SpecPatchResponse. */
+export interface SpecPatchResponseRead {
+    op: ("set" | "append" | "remove" | "rename") | (string & {});
+    /**
+     * JSON-Pointer-style path. Pattern segments enable bulk fixes:
+     * * (any child), ** (any depth), [key=value] (filter), e.g.
+     * /paths/**\/parameters/[name=account_id]/schema/type. Renaming a
+     * schema under /components/schemas also rewrites its $refs.
+     */
+    path: string;
+    /** set only; the replacement value. */
+    value?: unknown;
+    /** rename only; the new key name. */
+    to?: string | null;
+    reason?: string | null;
+}
+export interface DiagnosticSuppressionResponse {
+    rule_id: string;
+    /** Exact schema coordinate. Omit only to suppress every occurrence of the rule. */
+    path?: string;
+    /** The reviewed product decision behind this exception. */
+    reason: string;
+}
+/**
+ * Source pull-request enforcement threshold, new-versus-complete baseline, and explicitly reviewed
+ * rule or location exceptions.
+ */
+export interface DiagnosticPolicyResponse {
+    /**
+     * Severity threshold that fails the API change review check.
+     * Default: "error"
+     */
+    fail_on: "never" | "error" | "warning";
+    /**
+     * Enforce only occurrences introduced by the proposed source change.
+     * Default: true
+     */
+    only_new: boolean;
+    /** Default: [] */
+    suppressions: DiagnosticSuppressionResponse[];
+}
+/** Response shape for DiagnosticPolicyResponse. */
+export interface DiagnosticPolicyResponseRead {
+    /**
+     * Severity threshold that fails the API change review check.
+     * Default: "error"
+     */
+    fail_on: ("never" | "error" | "warning") | (string & {});
+    /**
+     * Enforce only occurrences introduced by the proposed source change.
+     * Default: true
+     */
+    only_new: boolean;
+    /** Default: [] */
+    suppressions: DiagnosticSuppressionResponse[];
+}
+/**
+ * Required checks run against the code in the Draft. Generated checks and customer commands share
+ * one reproducible workflow; repository_required names existing repository checks. Supplying checks
+ * replaces all settings. Omitted generated restores build, package, and public_entrypoint; omitted
+ * repository_required and customer restore empty lists. An empty object restores these defaults. An
+ * empty array clears the corresponding list.
+ */
+export interface TargetChecksResponse {
+    /** Default: ["build","package","public_entrypoint"] */
+    generated?: Array<"build" | "package" | "public_entrypoint">;
+    repository_required?: string[];
+    customer?: Array<{
+        name: string;
+        command: string;
+    }>;
+}
+/** Response shape for TargetChecksResponse. */
+export interface TargetChecksResponseRead {
+    /** Default: ["build","package","public_entrypoint"] */
+    generated?: Array<("build" | "package" | "public_entrypoint") | (string & {})>;
+    repository_required?: string[];
+    customer?: Array<{
+        name: string;
+        command: string;
+    }>;
+}
+/**
+ * Authorization-server metadata used by generated OAuth flows. Secrets and runtime credentials are
+ * never accepted here.
+ */
+export interface OAuthServerResponse {
+    /**
+     * Exact authorization-server issuer, including any tenant path.
+     * Format: uri
+     */
+    issuer?: string | null;
+    /**
+     * Exact metadata URL when it cannot be derived from the issuer.
+     * Format: uri
+     */
+    discovery_url?: string | null;
+    /**
+     * Authorization endpoint override.
+     * Format: uri
+     */
+    authorization_url?: string | null;
+    /**
+     * Token endpoint override.
+     * Format: uri
+     */
+    token_url?: string | null;
+    /**
+     * Device-authorization endpoint override.
+     * Format: uri
+     */
+    device_authorization_url?: string | null;
+    /** Default scopes requested during login. */
+    scopes?: string[] | null;
+    /** Default audience included in authorization and token requests. */
+    audience?: string | null;
+    /**
+     * Protected API resource included in authorization and token requests.
+     * Format: uri
+     */
+    resource?: string | null;
+}
+/**
+ * OAuth application available to generated products. Public clients support interactive login;
+ * confidential clients support runtime-supplied machine credentials. Client secrets are never
+ * stored.
+ */
+export interface OAuthApplicationResponse {
+    /** OAuth client identifier. */
+    client_id: string;
+    /** Interactive login method. Browser login uses Authorization Code with PKCE. */
+    login_method?: "browser" | "device" | null;
+    /** How a runtime-supplied client secret is sent for machine grants. */
+    client_auth_method?: "post" | "basic" | null;
+    /**
+     * Loopback callback URL for browser login.
+     * Format: uri
+     */
+    redirect_uri?: string | null;
+    /** Provider parameter used to request an organization during browser login. */
+    organization_parameter?: "organization" | "organization_id" | null;
+}
+/** Response shape for OAuthApplicationResponse. */
+export interface OAuthApplicationResponseRead {
+    /** OAuth client identifier. */
+    client_id: string;
+    /** Interactive login method. Browser login uses Authorization Code with PKCE. */
+    login_method?: ("browser" | "device" | null) | (string & {}) | null;
+    /** How a runtime-supplied client secret is sent for machine grants. */
+    client_auth_method?: ("post" | "basic" | null) | (string & {}) | null;
+    /**
+     * Loopback callback URL for browser login.
+     * Format: uri
+     */
+    redirect_uri?: string | null;
+    /** Provider parameter used to request an organization during browser login. */
+    organization_parameter?: ("organization" | "organization_id" | null) | (string & {}) | null;
+}
+/**
+ * Authenticated identity read used to verify a login before it is saved. Operation is auto-detected
+ * when omitted or null. At least one of subject_field, account_field, or organization_field must be
+ * a non-null JSON Pointer. Null clears an individual mapping while another remains. Set
+ * identity_verification itself to null to remove the whole policy.
+ */
+export type IdentityVerificationResponse = {
+    /** resource.method of a safe identity read with no required arguments. */
+    operation?: string | null;
+    /** JSON Pointer to the stable caller ID in the identity response. */
+    subject_field?: string | null;
+    /** JSON Pointer to the customer account ID. */
+    account_field?: string | null;
+    /** JSON Pointer to the customer organization ID. */
+    organization_field?: string | null;
+} & ({
+    subject_field: string;
+} | {
+    account_field: string;
+} | {
+    organization_field: string;
+});
+/** OAuth application and request-value overrides for one named API environment. */
+export interface AuthenticationEnvironmentResponse {
+    oauth_application?: string | null;
+    scopes?: string[] | null;
+    audience?: string | null;
+    /** Format: uri */
+    resource?: string | null;
+}
+/**
+ * Public authentication defaults for generated clients and tools. Stored Projects own the OAuth
+ * server, application catalog, and identity policy; one-shot generation accepts the same shape for
+ * one run. Runtime credentials and client secrets are never accepted.
+ */
+export interface AuthenticationConfigResponse {
+    oauth_server?: OAuthServerResponse | null;
+    /** OAuth applications keyed by a stable name. */
+    oauth_applications?: Record<string, OAuthApplicationResponse> | null;
+    /** Default OAuth application used by generated products. */
+    oauth_application?: string | null;
+    identity_verification?: IdentityVerificationResponse | null;
+    /**
+     * Base URL of a custom browser-approval backend implementing the start, status, and revoke
+     * contract. Used only when OAuth is not configured.
+     * Format: uri
+     */
+    approval_url?: string | null;
+    /** Authentication selections keyed by generated API environment name. */
+    environments?: Record<string, AuthenticationEnvironmentResponse> | null;
+}
+export interface TargetAuthenticationEnvironmentResponse {
+    oauth_application?: string | null;
+}
+/**
+ * Selects a Project OAuth application for one Target. OAuth server metadata, applications, and
+ * identity policy remain Project-owned.
+ */
+export interface TargetAuthenticationConfigResponse {
+    /** Project OAuth application to use. Omit to inherit the Project default. */
+    oauth_application?: string | null;
+    /** Project OAuth application selections keyed by API environment. */
+    environments?: Record<string, TargetAuthenticationEnvironmentResponse> | null;
+}
+/** How the generated CLI behaves. Part of Config. */
+export interface CliBehaviorResponse {
+    /** Command users run, independent of how the CLI is distributed. */
+    command_name?: string | null;
+    /**
+     * Opt in to a once-a-day registry check that prints an upgrade hint. Off by default; generated
+     * code phones nobody unless this is enabled.
+     */
+    update_notice?: boolean;
+    /**
+     * Public HTTP(S) URL read by the optional changelog command in generated CLIs. Supports UTF-8
+     * Markdown, plain text, and static HTML; embedded credentials are not allowed. Omit or clear to
+     * disable, then regenerate.
+     */
+    changelog_url?: string | null;
+    /**
+     * Where the generated CLI's feedback command sends users. GitHub issues/new URLs get a prefilled
+     * title and environment details.
+     */
+    support_url?: string | null;
+    /**
+     * Hosted MCP endpoint installed by the generated CLI instead of launching the package's local
+     * stdio server.
+     */
+    mcp_url?: string | null;
+    /** GitHub owner/name of the skills package the generated CLI offers to install during init. */
+    skills_repo?: string | null;
+}
+/** How the generated CLI behaves. Part of Config. */
+export interface TargetCliBehaviorResponse {
+    /** Command users run, independent of how the CLI is distributed. */
+    command_name?: string | null;
+    /**
+     * Opt in to a once-a-day registry check that prints an upgrade hint. Off by default; generated
+     * code phones nobody unless this is enabled.
+     */
+    update_notice?: boolean;
+    /**
+     * Public HTTP(S) URL read by the optional changelog command in generated CLIs. Supports UTF-8
+     * Markdown, plain text, and static HTML; embedded credentials are not allowed. Omit or clear to
+     * disable, then regenerate.
+     */
+    changelog_url?: string | null;
+    /**
+     * Where the generated CLI's feedback command sends users. GitHub issues/new URLs get a prefilled
+     * title and environment details.
+     */
+    support_url?: string | null;
+    /**
+     * Hosted MCP endpoint installed by the generated CLI instead of launching the package's local
+     * stdio server.
+     */
+    mcp_url?: string | null;
+    /** GitHub owner/name of the skills package the generated CLI offers to install during init. */
+    skills_repo?: string | null;
+    /**
+     * Enable webhook relay sessions for this CLI Target. Requires Pro. Turning it off prevents new
+     * sessions.
+     */
+    relay?: boolean;
+}
+/** How generated MCP servers and the Typeship-hosted endpoint behave. Part of Config. */
+export interface McpBehaviorResponse {
+    /** Stable official MCP registry name, independent of the server runtime. */
+    registry_name?: string | null;
+    /**
+     * Authorization for callers connecting to a generated MCP server deployed over HTTP. The hosting
+     * application resolves upstream API credentials separately at runtime. This setting does not
+     * apply to the Typeship-hosted endpoint.
+     */
+    access?: {
+        /**
+         * Exact issuer allowed to sign MCP connection tokens.
+         * Format: uri
+         */
+        issuer: string;
+        /**
+         * Canonical public URL of the self-hosted MCP endpoint that connection tokens must target.
+         * Format: uri
+         */
+        resource: string;
+        /**
+         * Public signing-key endpoint. Omit to discover it from the issuer.
+         * Format: uri
+         */
+        jwks_url?: string;
+        /** Minimum scopes required to connect to the self-hosted MCP server. */
+        scopes?: string[];
+    };
+    /**
+     * MCP tool shape. meta collapses per-operation tools into search_docs, read_docs, and execute so
+     * large APIs don't flood an agent's context window. Auto considers the serialized tool schemas,
+     * switching near 10k tokens or above 100 operations.
+     */
+    tool_mode?: "auto" | "operations" | "meta";
+    /**
+     * Guidance appended to the MCP server's instructions, which agents read once when they connect
+     * (server/discover): what to call first, conventions the spec does not state, what not to do.
+     * Carried by the package's server and the hosted endpoint alike.
+     */
+    instructions?: string | null;
+    /**
+     * Hand-written MCP tool descriptions keyed by operationId or "METHOD /path". Each replaces the
+     * text typeship derives for that operation (summary, first sentence, method and path, deprecation
+     * and auth notes). For flows the spec cannot describe, such as a multi-step upload. Keys that
+     * match no operation are reported as generation warnings.
+     */
+    tool_descriptions?: Record<string, string>;
+    /**
+     * Exact name-or-ID resolver overrides keyed first by the target operationId or "METHOD /path",
+     * then by its wire argument name. A resolver names one read collection operation plus 1-4 item
+     * fields to match case-insensitively; false opts that argument out of strict inference.
+     */
+    reference_resolvers?: Record<string, Record<string, false | {
+        /** OperationId, "METHOD /path", MCP tool name, or dotted resource.method of the list operation. */
+        via: string;
+        /** Item fields compared exactly and case-insensitively, such as name, slug, key, or email. */
+        match: string[];
+        /** Item field substituted into the requested argument. Defaults to id. */
+        id?: string;
+    }>>;
+}
+/** Response shape for McpBehaviorResponse. */
+export interface McpBehaviorResponseRead {
+    /** Stable official MCP registry name, independent of the server runtime. */
+    registry_name?: string | null;
+    /**
+     * Authorization for callers connecting to a generated MCP server deployed over HTTP. The hosting
+     * application resolves upstream API credentials separately at runtime. This setting does not
+     * apply to the Typeship-hosted endpoint.
+     */
+    access?: {
+        /**
+         * Exact issuer allowed to sign MCP connection tokens.
+         * Format: uri
+         */
+        issuer: string;
+        /**
+         * Canonical public URL of the self-hosted MCP endpoint that connection tokens must target.
+         * Format: uri
+         */
+        resource: string;
+        /**
+         * Public signing-key endpoint. Omit to discover it from the issuer.
+         * Format: uri
+         */
+        jwks_url?: string;
+        /** Minimum scopes required to connect to the self-hosted MCP server. */
+        scopes?: string[];
+    };
+    /**
+     * MCP tool shape. meta collapses per-operation tools into search_docs, read_docs, and execute so
+     * large APIs don't flood an agent's context window. Auto considers the serialized tool schemas,
+     * switching near 10k tokens or above 100 operations.
+     */
+    tool_mode?: ("auto" | "operations" | "meta") | (string & {});
+    /**
+     * Guidance appended to the MCP server's instructions, which agents read once when they connect
+     * (server/discover): what to call first, conventions the spec does not state, what not to do.
+     * Carried by the package's server and the hosted endpoint alike.
+     */
+    instructions?: string | null;
+    /**
+     * Hand-written MCP tool descriptions keyed by operationId or "METHOD /path". Each replaces the
+     * text typeship derives for that operation (summary, first sentence, method and path, deprecation
+     * and auth notes). For flows the spec cannot describe, such as a multi-step upload. Keys that
+     * match no operation are reported as generation warnings.
+     */
+    tool_descriptions?: Record<string, string>;
+    /**
+     * Exact name-or-ID resolver overrides keyed first by the target operationId or "METHOD /path",
+     * then by its wire argument name. A resolver names one read collection operation plus 1-4 item
+     * fields to match case-insensitively; false opts that argument out of strict inference.
+     */
+    reference_resolvers?: Record<string, Record<string, false | (string & {}) | {
+        /** OperationId, "METHOD /path", MCP tool name, or dotted resource.method of the list operation. */
+        via: string;
+        /** Item fields compared exactly and case-insensitively, such as name, slug, key, or email. */
+        match: string[];
+        /** Item field substituted into the requested argument. Defaults to id. */
+        id?: string;
+    }>>;
+}
+/** Generated README behavior. Part of Config. */
+export interface ReadmeBehaviorResponse {
+    /**
+     * operationId or "METHOD /path" to feature as the README's first API call. It must be present in
+     * the generated package and callable with no required input beyond path placeholders. Missing or
+     * unsuitable choices produce a warning and use the automatic example.
+     */
+    quickstart_operation?: string | null;
+}
+/**
+ * Published-package metadata the API spec does not own. Repository is derived from each
+ * destination.
+ */
+export interface PackageBehaviorResponse {
+    /** Homepage written into registry metadata. */
+    homepage?: string | null;
+    /** SPDX identifier written into registry metadata. Defaults to info.license. */
+    license?: string | null;
+    /**
+     * Exact LICENSE file contents. Supply this for licences the engine does not build in; MIT is
+     * built in when copyright is also set.
+     */
+    license_text?: string | null;
+    /** Copyright line used in generated license files. */
+    copyright?: string | null;
+    /** 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
+ * while cli, mcp, auth, readme, and package merge by field. GraphQL-only source settings live on
+ * the Project's Spec and are rejected in both stored config scopes.
+ */
+export interface ProjectConfigResponse {
+    /**
+     * 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>;
+    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 ProjectConfigResponse. */
+export interface ProjectConfigResponseRead {
+    /**
+     * 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>;
+    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;
+}
+/**
+ * Target-specific generation and delivery overrides. Authentication may only select a Project-owned
+ * OAuth application. OAuth server metadata, applications, and identity policy remain Project-owned.
+ * Self-hosted MCP access may be overridden for a Target-specific deployment.
+ */
+export interface TargetConfigResponse {
+    /**
+     * 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>;
+    auth?: TargetAuthenticationConfigResponse;
+    cli?: TargetCliBehaviorResponse;
+    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 TargetConfigResponse. */
+export interface TargetConfigResponseRead {
+    /**
+     * 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>;
+    auth?: TargetAuthenticationConfigResponse;
+    cli?: TargetCliBehaviorResponse;
+    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;
+}
+/** What a GraphQL schema cannot say about itself. Ignored for OpenAPI specs. */
+export interface GraphqlSettingsResponse {
+    /**
+     * The URL every request is POSTed to; the generated client's default baseUrl. Defaults to the URL
+     * the schema was fetched from. Without either, baseUrl is a required client option.
+     * Format: uri
+     */
+    endpoint?: string;
+    /**
+     * Named endpoints (sandbox, production). Each becomes a client environment; the first is the
+     * default unless endpoint is set.
+     */
+    environments?: Array<{
+        name: string;
+        /** Format: uri */
+        url: string;
+    }>;
+    /**
+     * 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.
+     * Default: "bearer"
+     */
+    auth?: "bearer" | "basic" | "api_key" | "none";
+    /**
+     * Header carrying the key when auth is api_key. Required for that mode; Typeship does not invent
+     * a vendor-specific header name.
+     */
+    api_key_header?: string;
+    /**
+     * The API's name; drives the package and client names ("Acme" gives acme and AcmeClient).
+     * Defaults to a name derived from the endpoint's host.
+     */
+    title?: string;
+    /**
+     * JSON representation of each custom scalar, keyed by GraphQL scalar name. Unmapped scalars
+     * generate as the language's untyped JSON value and produce a warning. Unmatched keys warn.
+     */
+    scalars?: Record<string, "string" | "integer" | "number" | "boolean" | "json">;
+}
+/** Response shape for GraphqlSettingsResponse. */
+export interface GraphqlSettingsResponseRead {
+    /**
+     * The URL every request is POSTed to; the generated client's default baseUrl. Defaults to the URL
+     * the schema was fetched from. Without either, baseUrl is a required client option.
+     * Format: uri
+     */
+    endpoint?: string;
+    /**
+     * Named endpoints (sandbox, production). Each becomes a client environment; the first is the
+     * default unless endpoint is set.
+     */
+    environments?: Array<{
+        name: string;
+        /** Format: uri */
+        url: string;
+    }>;
+    /**
+     * 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.
+     * Default: "bearer"
+     */
+    auth?: ("bearer" | "basic" | "api_key" | "none") | (string & {});
+    /**
+     * Header carrying the key when auth is api_key. Required for that mode; Typeship does not invent
+     * a vendor-specific header name.
+     */
+    api_key_header?: string;
+    /**
+     * The API's name; drives the package and client names ("Acme" gives acme and AcmeClient).
+     * Defaults to a name derived from the endpoint's host.
+     */
+    title?: string;
+    /**
+     * JSON representation of each custom scalar, keyed by GraphQL scalar name. Unmapped scalars
+     * generate as the language's untyped JSON value and produce a warning. Unmatched keys warn.
+     */
+    scalars?: Record<string, ("string" | "integer" | "number" | "boolean" | "json") | (string & {})>;
+}
+/**
+ * Retry behavior. Top-level fields adjust every operation; operations maps operationId or "METHOD
+ * /path" keys to per-operation overrides.
+ */
+export interface RetryTuningResponse {
+    max_retries?: number;
+    /** Replaces the default retryable set (408, 429, 500, 502, 503, 504). */
+    statuses?: number[];
+    initial_delay_ms?: number;
+    max_delay_ms?: number;
+    /** Also retry non-idempotent methods (POST/PATCH). */
+    retry_non_idempotent?: boolean;
+    /** Shorthand for max_retries 0. */
+    disabled?: boolean;
+    operations?: Record<string, RetryTuningResponse>;
+}
+export interface PaginationRuleResponse {
+    /** Default: "cursor" */
+    style?: "cursor" | "cursor_from_last_id" | "page" | "offset";
+    /** Response field holding the item array. */
+    items_field: string;
+    cursor_param?: string;
+    next_cursor_field?: string;
+    has_more_field?: string;
+    id_field?: string;
+    page_param?: string;
+    offset_param?: string;
+    limit_param?: string;
+}
+/** Response shape for PaginationRuleResponse. */
+export interface PaginationRuleResponseRead {
+    /** Default: "cursor" */
+    style?: ("cursor" | "cursor_from_last_id" | "page" | "offset") | (string & {});
+    /** Response field holding the item array. */
+    items_field: string;
+    cursor_param?: string;
+    next_cursor_field?: string;
+    has_more_field?: string;
+    id_field?: string;
+    page_param?: string;
+    offset_param?: string;
+    limit_param?: string;
+}
+export interface ErrorModel {
+    errors: ErrorDetail[];
+    request_id: RequestId;
+}
+/** Response shape for ErrorModel. */
+export interface ErrorModelRead {
+    errors: ErrorDetailRead[];
+    request_id: RequestId;
+}
+/** Git file mode. 100755 is executable; 120000 is a symbolic link whose content is its target. */
+export declare const GitFileMode: {
+    readonly V_100644: "100644";
+    readonly V_100755: "100755";
+    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.
+ */
+export interface DraftFileSides {
+    base: FileId | null;
+    yours: FileId | null;
+    generated: FileId | null;
+}
+export interface DraftFileConflict {
+    /**
+     * Why the Draft needs a decision. no_common_version: there is no last merged version to compare,
+     * such as the first Draft of an adopted package. file_ownership: generated output collides with a
+     * file you added. yours_deleted_generated_changed and generated_deleted_yours_changed: one side
+     * deleted a file the other changed. overlapping_text: both sides edited the same lines.
+     * too_large_to_merge: the file has too many changed lines to merge line by line. binary_changed
+     * and file_mode_changed: both sides changed binary content or the file mode.
+     */
+    type: "no_common_version" | "file_ownership" | "yours_deleted_generated_changed" | "generated_deleted_yours_changed" | "overlapping_text" | "too_large_to_merge" | "binary_changed" | "file_mode_changed";
+    /**
+     * Where the code in this Draft comes from: newly generated files, commits on the default branch,
+     * or edits from a Draft whose branch was rebased, reset, or deleted. Typeship may find another
+     * conflict after these decisions are applied.
+     */
+    source: "generation" | "default_branch" | "previous_draft";
+    /**
+     * Decision saved for this conflict on head_sha; null when none. Typeship continues when every
+     * conflict has a decision.
+     */
+    decision: "yours" | "generated" | "content" | null;
+}
+/** Response shape for DraftFileConflict. */
+export interface DraftFileConflictRead {
+    /**
+     * Why the Draft needs a decision. no_common_version: there is no last merged version to compare,
+     * such as the first Draft of an adopted package. file_ownership: generated output collides with a
+     * file you added. yours_deleted_generated_changed and generated_deleted_yours_changed: one side
+     * deleted a file the other changed. overlapping_text: both sides edited the same lines.
+     * too_large_to_merge: the file has too many changed lines to merge line by line. binary_changed
+     * and file_mode_changed: both sides changed binary content or the file mode.
+     */
+    type: ("no_common_version" | "file_ownership" | "yours_deleted_generated_changed" | "generated_deleted_yours_changed" | "overlapping_text" | "too_large_to_merge" | "binary_changed" | "file_mode_changed") | (string & {});
+    /**
+     * Where the code in this Draft comes from: newly generated files, commits on the default branch,
+     * or edits from a Draft whose branch was rebased, reset, or deleted. Typeship may find another
+     * conflict after these decisions are applied.
+     */
+    source: ("generation" | "default_branch" | "previous_draft") | (string & {});
+    /**
+     * Decision saved for this conflict on head_sha; null when none. Typeship continues when every
+     * conflict has a decision.
+     */
+    decision: ("yours" | "generated" | "content" | null) | (string & {}) | null;
+}
+export interface DraftFileHistory {
+    /**
+     * How the rewritten default branch differs from the last merged package; null when only the Draft
+     * differs.
+     */
+    change: "added" | "edited" | "deleted" | "mode_changed" | null;
+    /**
+     * The Draft branch has a different version than the rewritten default branch. Recovery carries
+     * the Draft version forward.
+     */
+    draft_differs: boolean;
+}
+/** Response shape for DraftFileHistory. */
+export interface DraftFileHistoryRead {
+    /**
+     * How the rewritten default branch differs from the last merged package; null when only the Draft
+     * differs.
+     */
+    change: ("added" | "edited" | "deleted" | "mode_changed" | null) | (string & {}) | null;
+    /**
+     * The Draft branch has a different version than the rewritten default branch. Recovery carries
+     * the Draft version forward.
+     */
+    draft_differs: boolean;
+}
+export interface DraftFile {
+    object: "draft_file";
+    /** Path relative to the Target's package directory. */
+    path: string;
+    /** How the Draft differs from the last merged package at this path; null when it does not. */
+    customization: "added" | "edited" | "deleted" | "mode_changed" | null;
+    conflict: DraftFileConflict | null;
+    history: DraftFileHistory | null;
+    /** File IDs to read with getFile for a conflict or history file; null for other customized files. */
+    sides: DraftFileSides | null;
+}
+/** Response shape for DraftFile. */
+export interface DraftFileRead {
+    object: "draft_file" | (string & {});
+    /** Path relative to the Target's package directory. */
+    path: string;
+    /** How the Draft differs from the last merged package at this path; null when it does not. */
+    customization: ("added" | "edited" | "deleted" | "mode_changed" | null) | (string & {}) | null;
+    conflict: DraftFileConflictRead | null;
+    history: DraftFileHistoryRead | null;
+    /** File IDs to read with getFile for a conflict or history file; null for other customized files. */
+    sides: DraftFileSides | null;
+}
+export interface DraftFileList {
+    object: ListObject;
+    data: DraftFile[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
+/** Response shape for DraftFileList. */
+export interface DraftFileListRead {
+    object: ListObject;
+    data: DraftFileRead[];
+    has_more: boolean;
+    next_cursor: string | null;
+    request_id: RequestId;
+}
+export type DraftConflictDecision = {
+    path: string;
+    /** Keep that version of the file exactly. Keeping an absent version deletes the path. */
+    keep: "yours" | "generated";
+} | {
+    path: string;
+    keep: "content";
+    /** Final file text, stored as UTF-8. An empty string creates an empty file. */
+    content: string;
+    mode: GitFileMode;
+} | {
+    path: string;
+    keep: "content";
+    /** Final file bytes as canonical base64, for binary files. */
+    content_base64: string;
+    mode: GitFileMode;
+} | {
+    path: string;
+    keep: "content";
+    /** Delete this file. */
+    content: null;
+};
+/** Response shape for DraftConflictDecision. */
+export type DraftConflictDecisionRead = {
+    path: string;
+    /** Keep that version of the file exactly. Keeping an absent version deletes the path. */
+    keep: ("yours" | "generated") | (string & {});
+} | {
+    path: string;
+    keep: "content" | (string & {});
+    /** Final file text, stored as UTF-8. An empty string creates an empty file. */
+    content: string;
+    mode: GitFileMode | (string & {});
+} | {
+    path: string;
+    keep: "content" | (string & {});
+    /** Final file bytes as canonical base64, for binary files. */
+    content_base64: string;
+    mode: GitFileMode | (string & {});
+} | {
+    path: string;
+    keep: "content" | (string & {});
+    /** Delete this file. */
+    content: null;
+};
+export interface DraftResolveRequest {
+    /** The Draft's head_sha. A newer Draft commit returns 409 resource_changed without saving. */
+    expected_head_sha: string;
+    /**
+     * Unique current conflict or customized paths. Choose generated to discard a customization,
+     * including a Draft-only file. Final file content must total at most 2 MiB. Decisions apply
+     * together or not at all.
+     */
+    resolutions: DraftConflictDecision[];
+}
+/** Response shape for DraftResolveRequest. */
+export interface DraftResolveRequestRead {
+    /** The Draft's head_sha. A newer Draft commit returns 409 resource_changed without saving. */
+    expected_head_sha: string;
+    /**
+     * Unique current conflict or customized paths. Choose generated to discard a customization,
+     * including a Draft-only file. Final file content must total at most 2 MiB. Decisions apply
+     * together or not at all.
+     */
+    resolutions: DraftConflictDecisionRead[];
+}
+export interface GenerateProjectRequest {
+    /** Generate only this active Target. Omit to generate all active Targets in the Project. */
+    target_id?: TargetId;
+}
+/** The stage that failed. A delivery failure does not change a completed Generation's status. */
+export declare const FailurePhase: {
+    readonly SPEC: "spec";
+    readonly GENERATION: "generation";
+    readonly DELIVERY: "delivery";
+    readonly PUBLICATION: "publication";
+};
+export type FailurePhase = (typeof FailurePhase)[keyof typeof FailurePhase];
+export type DomainError = ErrorDetail & {
+    phase: FailurePhase;
+};
+/** Response shape for DomainError. */
+export type DomainErrorRead = ErrorDetailRead & {
+    phase: FailurePhase | (string & {});
+};
+export interface DraftRecoverRequest {
+    /** The Draft's history_recovery.default_sha. */
+    expected_default_sha: string;
+    /** The Draft's history_recovery.head_sha; null when the Draft branch is absent. */
+    expected_head_sha: string | null;
 }
 //# sourceMappingURL=types.d.ts.map