@typeship-ax/mcp 0.9.1 → 0.10.0

package/src/resources/targets.ts

@@ -8,6 +8,7 @@ import {
   TransportError,
   UnexpectedApiError,
   ValidationError,
+  BadGatewayError,
   BadRequestError,
   ConflictError,
   ForbiddenError,
@@ -21,6 +22,10 @@ import type {
   DeletedTargetRead,
   ProjectId,
   Target,
+  TargetAdoption,
+  TargetDraftResponse,
+  TargetDraftResponseRead,
+  TargetDraftUpdate,
   TargetFields,
   TargetId,
   TargetList,
@@ -236,6 +241,103 @@ export class TargetsResource {
     });
   }
 
+  /**
+   * Retrieve a Target's rolling Draft release
+   *
+   * Returns Current, the cumulative Draft version and readiness, its exact head, and the optimistic
+   * release revision.
+   * `GET /targets/{target_id}/draft`
+   */
+  async retrieveDraft(
+    targetId: TargetId,
+    options?: RequestOptions,
+  ): Promise<ApiResult<TargetDraftResponseRead, TargetsRetrieveDraftError>> {
+    return this._core.request<TargetDraftResponseRead, TargetsRetrieveDraftError>({
+      method: "GET",
+      path: `/targets/${encodeURIComponent(String(targetId))}/draft`,
+      security: [{"apiKey":[]}],
+      errors: {
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+      },
+      idempotent: true,
+      schemaKey: "targets.retrieveDraft",
+      options,
+    });
+  }
+
+  /**
+   * Select an exact Draft version or return to automatic versioning
+   *
+   * Validates the selection against the cumulative required bump and regenerates the same rolling
+   * Draft pull request.
+   * `PATCH /targets/{target_id}/draft`
+   */
+  async updateDraft(
+    targetId: TargetId,
+    body: TargetDraftUpdate,
+    options?: RequestOptions,
+  ): Promise<ApiResult<TargetDraftResponseRead, TargetsUpdateDraftError>> {
+    return this._core.request<TargetDraftResponseRead, TargetsUpdateDraftError>({
+      method: "PATCH",
+      path: `/targets/${encodeURIComponent(String(targetId))}/draft`,
+      security: [{"apiKey":[]}],
+      body,
+      errors: {
+        "400": BadRequestError,
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "409": ConflictError,
+        "422": UnprocessableEntityError,
+        "429": RateLimitedError,
+      },
+      schemaKey: "targets.updateDraft",
+      options,
+    });
+  }
+
+  /**
+   * Adopt a verified existing package as Current
+   *
+   * Verifies the repository tag, package metadata, and registry artifact; records an Imported
+   * Current release; then opens the first Typeship Draft at the next major version because no
+   * trusted generated baseline exists yet.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+   * `POST /targets/{target_id}/adopt`
+   */
+  async adoptRelease(
+    targetId: TargetId,
+    body: TargetAdoption,
+    params?: TargetsAdoptReleaseParams,
+    options?: RequestOptions,
+  ): Promise<ApiResult<TargetReleaseResponseRead, TargetsAdoptReleaseError>> {
+    return this._core.request<TargetReleaseResponseRead, TargetsAdoptReleaseError>({
+      method: "POST",
+      path: `/targets/${encodeURIComponent(String(targetId))}/adopt`,
+      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: "targets.adoptRelease",
+      options,
+    });
+  }
+
   /**
    * Retrieve an immutable Target release
    * `GET /target_releases/{target_release_id}`
@@ -259,6 +361,41 @@ export class TargetsResource {
       options,
     });
   }
+
+  /**
+   * Retry publication of an exact Target release
+   *
+   * Dispatches the repository-owned republish workflow for this immutable version and accepted
+   * commit. It never selects the latest Draft or release.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+   * `POST /target_releases/{target_release_id}/republish`
+   */
+  async republishRelease(
+    targetReleaseId: TargetReleaseId,
+    params?: TargetsRepublishReleaseParams,
+    options?: RequestOptions,
+  ): Promise<ApiResult<TargetReleaseResponseRead, TargetsRepublishReleaseError>> {
+    return this._core.request<TargetReleaseResponseRead, TargetsRepublishReleaseError>({
+      method: "POST",
+      path: `/target_releases/${encodeURIComponent(String(targetReleaseId))}/republish`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
+      errors: {
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "409": ConflictError,
+        "429": RateLimitedError,
+        "502": BadGatewayError,
+      },
+      idempotencyKey: "Idempotency-Key",
+      schemaKey: "targets.republishRelease",
+      options,
+    });
+  }
 }
 
 export interface TargetsListParams {
@@ -366,6 +503,55 @@ export type TargetsListReleasesError =
   | TransportError
   | ValidationError;
 
+/** Every error `retrieveDraft` can produce, as a discriminated union. */
+export type TargetsRetrieveDraftError =
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+/** Every error `updateDraft` can produce, as a discriminated union. */
+export type TargetsUpdateDraftError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | ConflictError
+  | UnprocessableEntityError
+  | RateLimitedError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+export interface TargetsAdoptReleaseParams {
+  /**
+   * 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 `adoptRelease` can produce, as a discriminated union. */
+export type TargetsAdoptReleaseError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | ConflictError
+  | UnprocessableEntityError
+  | RateLimitedError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
 /** Every error `retrieveRelease` can produce, as a discriminated union. */
 export type TargetsRetrieveReleaseError =
   | UnauthorizedError
@@ -376,3 +562,26 @@ export type TargetsRetrieveReleaseError =
   | ResponseParseError
   | TransportError
   | ValidationError;
+
+export interface TargetsRepublishReleaseParams {
+  /**
+   * 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 `republishRelease` can produce, as a discriminated union. */
+export type TargetsRepublishReleaseError =
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | ConflictError
+  | RateLimitedError
+  | BadGatewayError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;

package/src/schemas.ts

@@ -26,7 +26,11 @@ export const SCHEMAS: Record<string, { req?: unknown; res?: unknown }> = {
   "targets.delete": {"res":{"$ref":"res:DeletedTarget"}},
   "targets.update": {"req":{"$ref":"req:TargetUpdateRequest"},"res":{"$ref":"res:TargetResponse"}},
   "targets.listReleases": {"res":{"$ref":"res:TargetReleaseList"}},
+  "targets.retrieveDraft": {"res":{"$ref":"res:TargetDraftResponse"}},
+  "targets.updateDraft": {"req":{"$ref":"req:TargetDraftUpdate"},"res":{"$ref":"res:TargetDraftResponse"}},
+  "targets.adoptRelease": {"req":{"$ref":"req:TargetAdoption"},"res":{"$ref":"res:TargetReleaseResponse"}},
   "targets.retrieveRelease": {"res":{"$ref":"res:TargetReleaseResponse"}},
+  "targets.republishRelease": {"res":{"$ref":"res:TargetReleaseResponse"}},
   "generations.retrieve": {"res":{"$ref":"res:GenerationResponse"}},
   "generations.retrieveFile": {"res":{"type":"string"}},
   "definitionRevisions.list": {"res":{"$ref":"res:DefinitionRevisionList"}},
@@ -79,7 +83,7 @@ export const DEFS: Record<string, unknown> = {
   "req:TargetConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"req:TargetAuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
   "req:TargetAuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
   "req:DeliveryInput": {"anyOf":[{"$ref":"req:RepositoryDeliveryInput"},{"$ref":"req:HostedMcpDeliveryInput"}]},
-  "req:RepositoryDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]}},"required":["kind","repository"]},
+  "req:RepositoryDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"}},"required":["kind","repository"]},
   "req:HostedMcpDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"hosted_mcp"}},"required":["kind"]},
   "req:ProjectConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"req:AuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
   "res:Project": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"definition_id":{"$ref":"res:DefinitionId"},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"res:ProjectConfig"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","definition_id","auto_generate","relay_enabled","config","created_at","updated_at","request_id"]},
@@ -94,9 +98,9 @@ export const DEFS: Record<string, unknown> = {
   "res:PackageBehavior": {"type":"object","additionalProperties":false,"properties":{"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"go_package_name":{"type":["string","null"]}}},
   "res:DeletedProject": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
   "req:UpdateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]}}},
-  "res:DiagnosticReport": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"format":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"$ref":"res:DefinitionRevisionId"},"source_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"analyzed_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"patch_diagnostics":{"type":"array","items":{"type":"string"}},"summary":{"$ref":"res:DiagnosticSummary"},"diagnostics":{"type":"array","items":{"$ref":"res:Diagnostic"}},"policy":{"$ref":"res:DiagnosticPolicy"},"evaluation":{"$ref":"res:DiagnosticEvaluation"},"delta":{"$ref":"res:DiagnosticDelta"},"request_id":{"$ref":"res:RequestId"}},"required":["object","format","project_id","definition_revision_id","source_sha256","analyzed_sha256","patch_diagnostics","summary","diagnostics","policy","evaluation","delta","request_id"]},
+  "res:DiagnosticReport": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"format":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"$ref":"res:DefinitionRevisionId"},"source_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"analyzed_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"patch_diagnostics":{"type":"array","items":{"type":"string"}},"summary":{"$ref":"res:DiagnosticSummary"},"diagnostics":{"type":"array","items":{"$ref":"res:Diagnostic"}},"policy":{"$ref":"res:DiagnosticPolicy"},"evaluation":{"$ref":"res:DiagnosticEvaluation"},"quality_signals":{"$ref":"res:DiagnosticQualitySignals"},"delta":{"$ref":"res:DiagnosticDelta"},"request_id":{"$ref":"res:RequestId"}},"required":["object","format","project_id","definition_revision_id","source_sha256","analyzed_sha256","patch_diagnostics","summary","diagnostics","policy","evaluation","quality_signals","delta","request_id"]},
   "res:DefinitionRevisionId": {"type":"string","pattern":"^drev_[a-z0-9]{16}$"},
-  "res:Diagnostic": {"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"severity":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"impact":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}},"fix":{"$ref":"res:DiagnosticFix"},"authoring_brief":{"type":"string"}},"required":["id","severity","category","title","description","impact","surfaces","locations","authoring_brief"]},
+  "res:Diagnostic": {"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"severity":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"impact":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"evidence_basis":{"type":"string"},"owner_decision_required":{"type":"boolean"},"surface_impact":{"type":"string"},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}},"fix":{"$ref":"res:DiagnosticFix"},"authoring_brief":{"type":"string"}},"required":["id","severity","category","title","description","impact","surfaces","evidence_basis","owner_decision_required","locations","authoring_brief"]},
   "res:DiagnosticLocation": {"type":"object","additionalProperties":false,"properties":{"document":{"type":"string"},"path":{"type":"string"},"operation":{"type":"string"},"evidence":{"type":"string"}},"required":["path"]},
   "res:DiagnosticFix": {"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"kind":{"type":"string"},"patches":{"type":"array","items":{"$ref":"res:DefinitionPatch"}},"instructions":{"type":"string"}},"required":["title","kind"]},
   "res:DefinitionPatch": {"type":"object","additionalProperties":false,"properties":{"op":{"type":"string"},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
@@ -104,6 +108,8 @@ export const DEFS: Record<string, unknown> = {
   "res:DiagnosticSuppression": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string","maxLength":160},"path":{"type":"string","maxLength":4096},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["rule_id","reason"]},
   "res:DiagnosticEvaluation": {"type":"object","additionalProperties":false,"properties":{"state":{"type":"string"},"blocking":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"considered_occurrences":{"type":"integer","minimum":0},"suppressed_occurrences":{"type":"integer","minimum":0}},"required":["state","blocking","considered_occurrences","suppressed_occurrences"]},
   "res:DiagnosticReference": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string"},"severity":{"type":"string"},"title":{"type":"string"},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}}},"required":["rule_id","severity","title","locations"]},
+  "res:DiagnosticQualitySignals": {"type":"object","additionalProperties":false,"properties":{"suppressed_by_rule":{"type":"array","items":{"$ref":"res:DiagnosticSuppressionSignal"}},"stale_suppressions":{"type":"array","items":{"$ref":"res:DiagnosticSuppression"}}},"required":["suppressed_by_rule","stale_suppressions"]},
+  "res:DiagnosticSuppressionSignal": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string"},"active_occurrences":{"type":"integer","minimum":0},"suppressed_occurrences":{"type":"integer","minimum":1}},"required":["rule_id","active_occurrences","suppressed_occurrences"]},
   "res:DiagnosticDelta": {"type":"object","additionalProperties":false,"properties":{"added":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"resolved":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"baseline_definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]}},"required":["added","resolved","baseline_definition_revision_id"]},
   "req:DiagnosticRemediationRequest": {"type":"object","additionalProperties":false,"properties":{"diagnostic_ids":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string"}}},"required":["diagnostic_ids"]},
   "res:DiagnosticRemediation": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"kind":{"type":"string"},"patches_applied":{"type":"integer","minimum":0},"review_url":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","kind","patches_applied","request_id"]},
@@ -128,11 +134,11 @@ export const DEFS: Record<string, unknown> = {
   "res:GraphqlSettings": {"type":"object","additionalProperties":false,"properties":{"endpoint":{"type":"string"},"environments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"auth":{"type":"string"},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
   "req:DefinitionUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"source":{"$ref":"req:DefinitionSourceInput"},"patches":{"type":"array","maxItems":50,"items":{"$ref":"req:DefinitionPatch"}},"graphql":{"anyOf":[{"$ref":"req:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"req:DiagnosticPolicy"}}},
   "res:TargetList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Target"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:Target": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"name":{"type":"string"},"generator":{"$ref":"res:GeneratorKind"},"state":{"type":"string"},"edition":{"type":"string"},"release_channel":{"type":"string"},"version_policy":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"pre1_breaking":{"type":"string"}},"required":["mode","pre1_breaking"]},"current_version":{"type":"string"},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"res:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"res:Delivery"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","name","generator","state","edition","release_channel","version_policy","current_version","proposed_version","config","deliveries","created_at","updated_at"]},
+  "res:Target": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"name":{"type":"string"},"generator":{"$ref":"res:GeneratorKind"},"state":{"type":"string"},"edition":{"type":"string"},"release_channel":{"type":"string"},"version_policy":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"pre1_breaking":{"type":"string"}},"required":["mode","pre1_breaking"]},"current_version":{"type":["string","null"]},"proposed_version":{"type":["string","null"]},"proposed_version_source":{"type":["string","null"]},"proposed_version_actor":{"type":["string","null"]},"release_revision":{"type":"integer","minimum":0},"config":{"anyOf":[{"$ref":"res:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"res:Delivery"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","name","generator","state","edition","release_channel","version_policy","current_version","proposed_version","proposed_version_source","proposed_version_actor","release_revision","config","deliveries","created_at","updated_at"]},
   "res:TargetConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"res:TargetAuthenticationConfig"},"cli":{"$ref":"res:CliBehavior"},"mcp":{"$ref":"res:McpBehavior"},"readme":{"$ref":"res:ReadmeBehavior"},"package":{"$ref":"res:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
   "res:TargetAuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
   "res:Delivery": {"anyOf":[{"$ref":"res:RepositoryDelivery"},{"$ref":"res:HostedMcpDelivery"},{"type":"object"}]},
-  "res:RepositoryDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"repository":{"$ref":"res:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","repository","directory","package_name","module_path","created_at","updated_at"]},
+  "res:RepositoryDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"repository":{"$ref":"res:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","repository","directory","package_name","module_path","publish_on_merge","created_at","updated_at"]},
   "res:DeliveryId": {"type":"string","pattern":"^dlv_[a-z0-9]{16}$"},
   "res:HostedMcpDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"url":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","url","created_at","updated_at"]},
   "req:TargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"definition_id":{"$ref":"req:DefinitionId"},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","definition_id","generator"]},
@@ -142,8 +148,15 @@ export const DEFS: Record<string, unknown> = {
   "res:DeletedTarget": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
   "req:TargetUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}}},
   "res:TargetReleaseList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:TargetRelease"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:TargetRelease": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetReleaseId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"generation_id":{"$ref":"res:GenerationId"},"version":{"type":"string"},"channel":{"type":"string"},"provider":{"type":"string"},"repository":{"anyOf":[{"$ref":"res:RepositoryReference"},{"type":"null"}]},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"delivery_revision":{"type":"string"},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","generation_id","version","channel","provider","repository","definition_revision_id","delivery_revision","created_at"]},
+  "res:TargetRelease": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetReleaseId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"generation_id":{"anyOf":[{"$ref":"res:GenerationId"},{"type":"null"}]},"origin":{"type":"string"},"version":{"type":"string"},"channel":{"type":"string"},"provider":{"type":"string"},"repository":{"anyOf":[{"$ref":"res:RepositoryReference"},{"type":"null"}]},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"delivery_revision":{"type":"string"},"import_provenance":{"type":["object","null"],"additionalProperties":false,"properties":{"tag":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"imported_at":{"type":["string","null"]}},"required":["tag","registry_url","artifact_digest","imported_at"]},"publications":{"type":"array","items":{"$ref":"res:Publication"}},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","generation_id","version","channel","origin","provider","repository","definition_revision_id","delivery_revision","import_provenance","publications","created_at"]},
   "res:TargetReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
+  "res:Publication": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:PublicationId"},"object":{"type":"string"},"target_release_id":{"$ref":"res:TargetReleaseId"},"destination":{"type":"string"},"state":{"type":"string"},"attempt":{"type":"integer","minimum":0},"run_url":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"error":{"type":["string","null"]},"started_at":{"type":["string","null"]},"finished_at":{"type":["string","null"]},"updated_at":{"type":"string"}},"required":["id","object","target_release_id","destination","state","attempt","run_url","registry_url","artifact_digest","error","started_at","finished_at","updated_at"]},
+  "res:PublicationId": {"type":"string","pattern":"^pub_[a-z0-9]{16}$"},
+  "res:TargetDraftResponse": {"allOf":[{"$ref":"res:TargetDraft"},{"$ref":"res:ResponseMetadata"}]},
+  "res:TargetDraft": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"revision":{"type":"integer","minimum":0},"current_version":{"type":["string","null"]},"version":{"type":["string","null"]},"selection":{"$ref":"res:TargetDraftSelection"},"readiness":{"type":["object","null"]},"changes":{"type":["object","null"],"additionalProperties":false,"properties":{"changelog":{"type":["string","null"]},"breaking_count":{"type":["integer","null"],"minimum":0},"previous_version":{"type":["string","null"]}}},"head_revision":{"type":["string","null"]},"pull_request_url":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","target_id","revision","current_version","version","selection","readiness","changes","head_revision","pull_request_url"]},
+  "res:TargetDraftSelection": {"anyOf":[{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"}},"required":["mode"]},{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"version":{"type":"string"},"source":{"type":["string","null"]},"actor":{"type":["string","null"]}},"required":["mode","version","source","actor"]}]},
+  "req:TargetDraftUpdate": {"type":"object","additionalProperties":false,"properties":{"version":{"type":["string","null"]},"expected_revision":{"type":"integer","minimum":0}},"required":["version"]},
+  "req:TargetAdoption": {"type":"object","additionalProperties":false,"properties":{"version":{"type":"string"},"tag":{"type":"string","minLength":1,"maxLength":255}},"required":["version","tag"]},
   "res:TargetReleaseResponse": {"allOf":[{"$ref":"res:TargetRelease"},{"$ref":"res:ResponseMetadata"}]},
   "res:GenerationResponse": {"allOf":[{"$ref":"res:Generation"},{"$ref":"res:ResponseMetadata"}]},
   "res:Generation": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"files_omitted":{"type":"boolean"},"files_index":{"type":"array","items":{"$ref":"res:FileStub"}},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"$ref":"res:GenerationProvenance"},"meta":{"anyOf":[{"$ref":"res:GenerationMeta"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"error":{"type":["string","null"]},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","meta","warnings","error","created_at"]},