@typeship-ax/mcp 0.8.0 → 0.9.1

package/src/resources/account.ts

@@ -3,6 +3,7 @@
 
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
@@ -25,6 +26,7 @@ export class AccountResource {
     return this._core.request<AccountRead, AccountRetrieveError>({
       method: "GET",
       path: "/me",
+      security: [{"apiKey":[]}],
       errors: { "401": UnauthorizedError, "403": ForbiddenError, "429": RateLimitedError },
       idempotent: true,
       schemaKey: "account.retrieve",
@@ -39,5 +41,6 @@ export type AccountRetrieveError =
   | ForbiddenError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;

package/src/resources/api-keys.ts

@@ -4,6 +4,7 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import { paginate, PagePromise } from "../core/pagination.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
@@ -37,6 +38,7 @@ export class ApiKeysResource {
     return paginate<ApiKeyRead, ApiKeysListError>(this._core, {
       method: "GET",
       path: "/api_keys",
+      security: [{"apiKey":[]}],
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
@@ -76,6 +78,7 @@ export class ApiKeysResource {
     return this._core.request<ApiKeyResponseRead, ApiKeysRevokeError>({
       method: "DELETE",
       path: `/api_keys/${encodeURIComponent(String(apiKeyId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -106,6 +109,7 @@ export type ApiKeysListError =
   | ForbiddenError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -116,5 +120,6 @@ export type ApiKeysRevokeError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;

package/src/resources/definition-revisions.ts

@@ -4,6 +4,7 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import { paginate, PagePromise } from "../core/pagination.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
@@ -45,6 +46,7 @@ export class DefinitionRevisionsResource {
     return paginate<DefinitionRevisionRead, DefinitionRevisionsListError>(this._core, {
       method: "GET",
       path: `/definitions/${encodeURIComponent(String(definitionId))}/revisions`,
+      security: [{"apiKey":[]}],
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
@@ -83,6 +85,7 @@ export class DefinitionRevisionsResource {
     return this._core.request<DefinitionRevisionResponseRead, DefinitionRevisionsRetrieveError>({
       method: "GET",
       path: `/definition_revisions/${encodeURIComponent(String(definitionRevisionId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -109,6 +112,7 @@ export class DefinitionRevisionsResource {
     return this._core.request<string, DefinitionRevisionsRetrieveContentError>({
       method: "GET",
       path: `/definition_revisions/${encodeURIComponent(String(definitionRevisionId))}/content`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -133,6 +137,7 @@ export class DefinitionRevisionsResource {
     return this._core.request<string, DefinitionRevisionsRetrieveDocumentContentError>({
       method: "GET",
       path: `/definition_revisions/${encodeURIComponent(String(definitionRevisionId))}/documents/${encodeURIComponent(String(documentId))}/content`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -164,6 +169,7 @@ export type DefinitionRevisionsListError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -174,6 +180,7 @@ export type DefinitionRevisionsRetrieveError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -184,6 +191,7 @@ export type DefinitionRevisionsRetrieveContentError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -194,5 +202,6 @@ export type DefinitionRevisionsRetrieveDocumentContentError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;

package/src/resources/definitions.ts

@@ -3,10 +3,12 @@
 
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
   BadRequestError,
+  ConflictError,
   ForbiddenError,
   NotFoundError,
   RateLimitedError,
@@ -33,6 +35,7 @@ export class DefinitionsResource {
     return this._core.request<DefinitionRead, DefinitionsRetrieveError>({
       method: "GET",
       path: `/definitions/${encodeURIComponent(String(definitionId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -49,25 +52,34 @@ export class DefinitionsResource {
    * Update and resolve a Definition
    *
    * Resolves the complete document graph and records a new immutable revision before saving.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `PATCH /definitions/{definition_id}`
    */
   async update(
     definitionId: DefinitionId,
     body: DefinitionUpdateRequest,
+    params?: DefinitionsUpdateParams,
     options?: RequestOptions,
   ): Promise<ApiResult<DefinitionRead, DefinitionsUpdateError>> {
     return this._core.request<DefinitionRead, DefinitionsUpdateError>({
       method: "PATCH",
       path: `/definitions/${encodeURIComponent(String(definitionId))}`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
       body,
       errors: {
         "400": BadRequestError,
         "401": UnauthorizedError,
         "403": ForbiddenError,
         "404": NotFoundError,
+        "409": ConflictError,
         "422": UnprocessableEntityError,
         "429": RateLimitedError,
       },
+      idempotencyKey: "Idempotency-Key",
       schemaKey: "definitions.update",
       options,
     });
@@ -81,17 +93,30 @@ export type DefinitionsRetrieveError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
+export interface DefinitionsUpdateParams {
+  /**
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
+   * operation; account-less generation uses a hashed network identity. Retrying the same method,
+   * path, query, and JSON body replays the original response. Reusing the key with changed intent
+   * returns 409. After expiry the key starts a new write.
+   */
+  idempotencyKey?: string;
+}
+
 /** Every error `update` can produce, as a discriminated union. */
 export type DefinitionsUpdateError =
   | BadRequestError
   | UnauthorizedError
   | ForbiddenError
   | NotFoundError
+  | ConflictError
   | UnprocessableEntityError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;

package/src/resources/generate.ts

@@ -3,11 +3,13 @@
 
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
   ApiResponseError,
   BadRequestError,
+  ConflictError,
   ForbiddenError,
   PayloadTooLargeError,
   RateLimitedError,
@@ -30,40 +32,61 @@ export class GenerateResource {
    * the first 25 operations and
    * paid plans generate the complete Definition. A present but invalid key is a
    * 401, not a downgrade to anonymous.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /generate`
    */
   async run(
     body: GenerateRequest,
+    params?: GenerateRunParams,
     options?: RequestOptions,
   ): Promise<ApiResult<GenerationResultRead, GenerateRunError>> {
     return this._core.request<GenerationResultRead, GenerateRunError>({
       method: "POST",
       path: "/generate",
+      security: [{},{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
       body,
       errors: {
         "400": BadRequestError,
         "401": UnauthorizedError,
         "403": ForbiddenError,
+        "409": ConflictError,
         "413": PayloadTooLargeError,
         "422": UnprocessableEntityError,
         "429": RateLimitedError,
         default: ApiResponseError,
       },
+      idempotencyKey: "Idempotency-Key",
       schemaKey: "generate.run",
       options,
     });
   }
 }
 
+export interface GenerateRunParams {
+  /**
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
+   * operation; account-less generation uses a hashed network identity. Retrying the same method,
+   * path, query, and JSON body replays the original response. Reusing the key with changed intent
+   * returns 409. After expiry the key starts a new write.
+   */
+  idempotencyKey?: string;
+}
+
 /** Every error `run` can produce, as a discriminated union. */
 export type GenerateRunError =
   | BadRequestError
   | UnauthorizedError
   | ForbiddenError
+  | ConflictError
   | PayloadTooLargeError
   | UnprocessableEntityError
   | RateLimitedError
   | ApiResponseError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;

package/src/resources/generations.ts

@@ -3,6 +3,7 @@
 
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
@@ -29,6 +30,7 @@ export class GenerationsResource {
     return this._core.request<GenerationResponseRead, GenerationsRetrieveError>({
       method: "GET",
       path: `/generations/${encodeURIComponent(String(generationId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -56,6 +58,7 @@ export class GenerationsResource {
     return this._core.request<string, GenerationsRetrieveFileError>({
       method: "GET",
       path: `/generations/${encodeURIComponent(String(generationId))}/file`,
+      security: [{"apiKey":[]}],
       query: {
         path: params.path,
       },
@@ -80,6 +83,7 @@ export type GenerationsRetrieveError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -96,5 +100,6 @@ export type GenerationsRetrieveFileError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;

package/src/resources/projects.ts

@@ -4,9 +4,11 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import { paginate, PagePromise } from "../core/pagination.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
+  BadGatewayError,
   BadRequestError,
   ConflictError,
   ForbiddenError,
@@ -26,12 +28,12 @@ import type {
   DiagnosticRemediationRequest,
   DiagnosticReport,
   DiagnosticReportRead,
-  Generation,
   GenerationBatch,
   GenerationBatchRead,
   GenerationList,
   GenerationListRead,
-  GenerationRead,
+  GenerationSummary,
+  GenerationSummaryRead,
   Project,
   ProjectId,
   ProjectList,
@@ -60,6 +62,7 @@ export class ProjectsResource {
     return paginate<ProjectSummaryRead, ProjectsListError>(this._core, {
       method: "GET",
       path: "/projects",
+      security: [{"apiKey":[]}],
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
@@ -102,6 +105,7 @@ export class ProjectsResource {
     return this._core.request<ProjectRead, ProjectsCreateError>({
       method: "POST",
       path: "/projects",
+      security: [{"apiKey":[]}],
       headers: {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
@@ -124,6 +128,8 @@ export class ProjectsResource {
 
   /**
    * Retrieve a project
+   *
+   * Returns Project-owned fields only. List Targets separately for Target and Delivery data.
    * `GET /projects/{project_id}`
    */
   async retrieve(
@@ -133,6 +139,7 @@ export class ProjectsResource {
     return this._core.request<ProjectRead, ProjectsRetrieveError>({
       method: "GET",
       path: `/projects/${encodeURIComponent(String(projectId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -156,6 +163,7 @@ export class ProjectsResource {
     return this._core.request<DeletedProjectRead, ProjectsDeleteError>({
       method: "DELETE",
       path: `/projects/${encodeURIComponent(String(projectId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -180,6 +188,7 @@ export class ProjectsResource {
     return this._core.request<ProjectRead, ProjectsUpdateError>({
       method: "PATCH",
       path: `/projects/${encodeURIComponent(String(projectId))}`,
+      security: [{"apiKey":[]}],
       body,
       errors: {
         "400": BadRequestError,
@@ -187,8 +196,10 @@ export class ProjectsResource {
         "402": PaymentRequiredError,
         "403": ForbiddenError,
         "404": NotFoundError,
+        "409": ConflictError,
         "422": UnprocessableEntityError,
         "429": RateLimitedError,
+        "502": BadGatewayError,
       },
       schemaKey: "projects.update",
       options,
@@ -211,6 +222,7 @@ export class ProjectsResource {
     return this._core.request<DiagnosticReportRead, ProjectsRetrieveDiagnosticsError>({
       method: "GET",
       path: `/projects/${encodeURIComponent(String(projectId))}/diagnostics`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -229,22 +241,31 @@ export class ProjectsResource {
    * Fetches the complete configured source, records a new immutable revision only when content
    * changed, and returns its Diagnostics. This does not generate targets or consume a metered
    * generation.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /projects/{project_id}/diagnostics`
    */
   async refreshDiagnostics(
     projectId: ProjectId,
+    params?: ProjectsRefreshDiagnosticsParams,
     options?: RequestOptions,
   ): Promise<ApiResult<DiagnosticReportRead, ProjectsRefreshDiagnosticsError>> {
     return this._core.request<DiagnosticReportRead, ProjectsRefreshDiagnosticsError>({
       method: "POST",
       path: `/projects/${encodeURIComponent(String(projectId))}/diagnostics`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
         "404": NotFoundError,
+        "409": ConflictError,
         "422": UnprocessableEntityError,
         "429": RateLimitedError,
       },
+      idempotencyKey: "Idempotency-Key",
       schemaKey: "projects.refreshDiagnostics",
       options,
     });
@@ -256,25 +277,34 @@ export class ProjectsResource {
    * Applies only deterministic patches. Repository sources receive an updateable source pull
    * request; URL sources receive project overlays. Diagnostics that require API-owner intent return
    * 422 and include an authoring_brief in the Diagnostic instead.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /projects/{project_id}/diagnostics/remediations`
    */
   async remediateDiagnostics(
     projectId: ProjectId,
     body: DiagnosticRemediationRequest,
+    params?: ProjectsRemediateDiagnosticsParams,
     options?: RequestOptions,
   ): Promise<ApiResult<DiagnosticRemediationRead, ProjectsRemediateDiagnosticsError>> {
     return this._core.request<DiagnosticRemediationRead, ProjectsRemediateDiagnosticsError>({
       method: "POST",
       path: `/projects/${encodeURIComponent(String(projectId))}/diagnostics/remediations`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
       body,
       errors: {
         "400": BadRequestError,
         "401": UnauthorizedError,
         "403": ForbiddenError,
         "404": NotFoundError,
+        "409": ConflictError,
         "422": UnprocessableEntityError,
         "429": RateLimitedError,
       },
+      idempotencyKey: "Idempotency-Key",
       schemaKey: "projects.remediateDiagnostics",
       options,
     });
@@ -295,6 +325,7 @@ export class ProjectsResource {
     return this._core.request<RepositoryIntegrationHealthRead, ProjectsRetrieveIntegrationHealthError>({
       method: "GET",
       path: `/projects/${encodeURIComponent(String(projectId))}/integration-health`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -317,10 +348,11 @@ export class ProjectsResource {
     projectId: ProjectId,
     params?: ProjectsListGenerationsParams,
     options?: RequestOptions,
-  ): PagePromise<GenerationRead, ProjectsListGenerationsError> {
-    return paginate<GenerationRead, ProjectsListGenerationsError>(this._core, {
+  ): PagePromise<GenerationSummaryRead, ProjectsListGenerationsError> {
+    return paginate<GenerationSummaryRead, ProjectsListGenerationsError>(this._core, {
       method: "GET",
       path: `/projects/${encodeURIComponent(String(projectId))}/generations`,
+      security: [{"apiKey":[]}],
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
@@ -356,24 +388,33 @@ export class ProjectsResource {
    * commit, branch, or pull request is created and that generation reports
    * `pr_status: no_changes`. This is the same pipeline automatic
    * regeneration runs after a source change.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /projects/{project_id}/generations`
    */
   async generate(
     projectId: ProjectId,
+    params?: ProjectsGenerateParams,
     options?: RequestOptions,
   ): Promise<ApiResult<GenerationBatchRead, ProjectsGenerateError>> {
     return this._core.request<GenerationBatchRead, ProjectsGenerateError>({
       method: "POST",
       path: `/projects/${encodeURIComponent(String(projectId))}/generations`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
       errors: {
         "401": UnauthorizedError,
         "402": PaymentRequiredError,
         "403": ForbiddenError,
         "404": NotFoundError,
+        "409": ConflictError,
         "422": UnprocessableEntityError,
         "429": RateLimitedError,
         "500": InternalServerError,
       },
+      idempotencyKey: "Idempotency-Key",
       schemaKey: "projects.generate",
       options,
     });
@@ -397,14 +438,16 @@ export type ProjectsListError =
   | ForbiddenError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
 export interface ProjectsCreateParams {
   /**
-   * Uniquely identifies this creation attempt. Retrying the same request with the same key returns
-   * the original response instead of creating another project. Reusing a key with different
-   * parameters returns 409.
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
+   * operation; account-less generation uses a hashed network identity. Retrying the same method,
+   * path, query, and JSON body replays the original response. Reusing the key with changed intent
+   * returns 409. After expiry the key starts a new write.
    */
   idempotencyKey?: string;
 }
@@ -420,6 +463,7 @@ export type ProjectsCreateError =
   | RateLimitedError
   | InternalServerError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -430,6 +474,7 @@ export type ProjectsRetrieveError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -440,6 +485,7 @@ export type ProjectsDeleteError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -450,9 +496,12 @@ export type ProjectsUpdateError =
   | PaymentRequiredError
   | ForbiddenError
   | NotFoundError
+  | ConflictError
   | UnprocessableEntityError
   | RateLimitedError
+  | BadGatewayError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -463,29 +512,54 @@ export type ProjectsRetrieveDiagnosticsError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
+export interface ProjectsRefreshDiagnosticsParams {
+  /**
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
+   * operation; account-less generation uses a hashed network identity. Retrying the same method,
+   * path, query, and JSON body replays the original response. Reusing the key with changed intent
+   * returns 409. After expiry the key starts a new write.
+   */
+  idempotencyKey?: string;
+}
+
 /** Every error `refreshDiagnostics` can produce, as a discriminated union. */
 export type ProjectsRefreshDiagnosticsError =
   | UnauthorizedError
   | ForbiddenError
   | NotFoundError
+  | ConflictError
   | UnprocessableEntityError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
+export interface ProjectsRemediateDiagnosticsParams {
+  /**
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
+   * operation; account-less generation uses a hashed network identity. Retrying the same method,
+   * path, query, and JSON body replays the original response. Reusing the key with changed intent
+   * returns 409. After expiry the key starts a new write.
+   */
+  idempotencyKey?: string;
+}
+
 /** Every error `remediateDiagnostics` can produce, as a discriminated union. */
 export type ProjectsRemediateDiagnosticsError =
   | BadRequestError
   | UnauthorizedError
   | ForbiddenError
   | NotFoundError
+  | ConflictError
   | UnprocessableEntityError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -496,6 +570,7 @@ export type ProjectsRetrieveIntegrationHealthError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -519,18 +594,31 @@ export type ProjectsListGenerationsError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
+export interface ProjectsGenerateParams {
+  /**
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
+   * operation; account-less generation uses a hashed network identity. Retrying the same method,
+   * path, query, and JSON body replays the original response. Reusing the key with changed intent
+   * returns 409. After expiry the key starts a new write.
+   */
+  idempotencyKey?: string;
+}
+
 /** Every error `generate` can produce, as a discriminated union. */
 export type ProjectsGenerateError =
   | UnauthorizedError
   | PaymentRequiredError
   | ForbiddenError
   | NotFoundError
+  | ConflictError
   | UnprocessableEntityError
   | RateLimitedError
   | InternalServerError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;