@typeship-ax/mcp 0.8.0 → 0.9.1

package/dist/resources/projects.js

@@ -1,7 +1,7 @@
 // typeship — projects resource.
 // Generated by typeship — https://typeship.dev — do not edit by hand.
 import { paginate } from "../core/pagination.js";
-import { BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PaymentRequiredError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
+import { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PaymentRequiredError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
 export class ProjectsResource {
     _core;
     constructor(_core) {
@@ -17,6 +17,7 @@ export class ProjectsResource {
         return paginate(this._core, {
             method: "GET",
             path: "/projects",
+            security: [{ "apiKey": [] }],
             query: {
                 limit: params?.limit,
                 cursor: params?.cursor,
@@ -54,6 +55,7 @@ export class ProjectsResource {
         return this._core.request({
             method: "POST",
             path: "/projects",
+            security: [{ "apiKey": [] }],
             headers: {
                 "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
             },
@@ -75,12 +77,15 @@ 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(projectId, options) {
         return this._core.request({
             method: "GET",
             path: `/projects/${encodeURIComponent(String(projectId))}`,
+            security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
@@ -100,6 +105,7 @@ export class ProjectsResource {
         return this._core.request({
             method: "DELETE",
             path: `/projects/${encodeURIComponent(String(projectId))}`,
+            security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
@@ -119,6 +125,7 @@ export class ProjectsResource {
         return this._core.request({
             method: "PATCH",
             path: `/projects/${encodeURIComponent(String(projectId))}`,
+            security: [{ "apiKey": [] }],
             body,
             errors: {
                 "400": BadRequestError,
@@ -126,8 +133,10 @@ export class ProjectsResource {
                 "402": PaymentRequiredError,
                 "403": ForbiddenError,
                 "404": NotFoundError,
+                "409": ConflictError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "502": BadGatewayError,
             },
             schemaKey: "projects.update",
             options,
@@ -146,6 +155,7 @@ export class ProjectsResource {
         return this._core.request({
             method: "GET",
             path: `/projects/${encodeURIComponent(String(projectId))}/diagnostics`,
+            security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
@@ -163,19 +173,27 @@ 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, options) {
+    async refreshDiagnostics(projectId, params, options) {
         return this._core.request({
             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,
         });
@@ -186,21 +204,29 @@ 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, body, options) {
+    async remediateDiagnostics(projectId, body, params, options) {
         return this._core.request({
             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,
         });
@@ -217,6 +243,7 @@ export class ProjectsResource {
         return this._core.request({
             method: "GET",
             path: `/projects/${encodeURIComponent(String(projectId))}/integration-health`,
+            security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
@@ -238,6 +265,7 @@ export class ProjectsResource {
         return paginate(this._core, {
             method: "GET",
             path: `/projects/${encodeURIComponent(String(projectId))}/generations`,
+            security: [{ "apiKey": [] }],
             query: {
                 limit: params?.limit,
                 cursor: params?.cursor,
@@ -272,21 +300,29 @@ 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, options) {
+    async generate(projectId, params, options) {
         return this._core.request({
             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,
         });

package/dist/resources/targets.d.ts

@@ -1,6 +1,6 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import { PagePromise } from "../core/pagination.js";
-import { TransportError, UnexpectedApiError, ValidationError, BadRequestError, ConflictError, ForbiddenError, NotFoundError, RateLimitedError, UnauthorizedError, UnprocessableEntityError } from "../errors.js";
+import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadRequestError, ConflictError, ForbiddenError, NotFoundError, RateLimitedError, UnauthorizedError, UnprocessableEntityError } from "../errors.js";
 import type { DeletedTargetRead, ProjectId, TargetFields, TargetId, TargetRead, TargetReleaseId, TargetReleaseRead, TargetReleaseResponseRead, TargetResponseRead, TargetUpdateRequest } from "../types.js";
 export declare class TargetsResource {
     private readonly _core;
@@ -17,9 +17,11 @@ export declare class TargetsResource {
      *
      * Several Targets may use the same generator with distinct configuration, Deliveries, and release
      * streams.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/targets`
      */
-    create(projectId: ProjectId, body: TargetFields, options?: RequestOptions): Promise<ApiResult<TargetResponseRead, TargetsCreateError>>;
+    create(projectId: ProjectId, body: TargetFields, params?: TargetsCreateParams, options?: RequestOptions): Promise<ApiResult<TargetResponseRead, TargetsCreateError>>;
     /**
      * Retrieve a Target
      * `GET /targets/{target_id}`
@@ -61,15 +63,24 @@ export interface TargetsListParams {
     cursor?: string;
 }
 /** Every error `list` can produce, as a discriminated union. */
-export type TargetsListError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | TransportError | ValidationError;
+export type TargetsListError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export interface TargetsCreateParams {
+    /**
+     * 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 `create` can produce, as a discriminated union. */
-export type TargetsCreateError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | UnexpectedApiError | TransportError | ValidationError;
+export type TargetsCreateError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 /** Every error `retrieve` can produce, as a discriminated union. */
-export type TargetsRetrieveError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | TransportError | ValidationError;
+export type TargetsRetrieveError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 /** Every error `delete` can produce, as a discriminated union. */
-export type TargetsDeleteError = UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | RateLimitedError | UnexpectedApiError | TransportError | ValidationError;
+export type TargetsDeleteError = UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 /** Every error `update` can produce, as a discriminated union. */
-export type TargetsUpdateError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | UnexpectedApiError | TransportError | ValidationError;
+export type TargetsUpdateError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 export interface TargetsListReleasesParams {
     /** Maximum number of resources to return. */
     limit?: number;
@@ -80,7 +91,7 @@ export interface TargetsListReleasesParams {
     cursor?: string;
 }
 /** Every error `listReleases` can produce, as a discriminated union. */
-export type TargetsListReleasesError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | TransportError | ValidationError;
+export type TargetsListReleasesError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 /** Every error `retrieveRelease` can produce, as a discriminated union. */
-export type TargetsRetrieveReleaseError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | TransportError | ValidationError;
+export type TargetsRetrieveReleaseError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 //# sourceMappingURL=targets.d.ts.map

package/dist/resources/targets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/resources/targets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/resources/targets.ts"],"names":[],"mappings":"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"}

package/dist/resources/targets.js

@@ -17,6 +17,7 @@ export class TargetsResource {
         return paginate(this._core, {
             method: "GET",
             path: `/projects/${encodeURIComponent(String(projectId))}/targets`,
+            security: [{ "apiKey": [] }],
             query: {
                 limit: params?.limit,
                 cursor: params?.cursor,
@@ -45,12 +46,18 @@ export class TargetsResource {
      *
      * Several Targets may use the same generator with distinct configuration, Deliveries, and release
      * streams.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/targets`
      */
-    async create(projectId, body, options) {
+    async create(projectId, body, params, options) {
         return this._core.request({
             method: "POST",
             path: `/projects/${encodeURIComponent(String(projectId))}/targets`,
+            security: [{ "apiKey": [] }],
+            headers: {
+                "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+            },
             body,
             errors: {
                 "400": BadRequestError,
@@ -61,6 +68,7 @@ export class TargetsResource {
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
             },
+            idempotencyKey: "Idempotency-Key",
             schemaKey: "targets.create",
             options,
         });
@@ -73,6 +81,7 @@ export class TargetsResource {
         return this._core.request({
             method: "GET",
             path: `/targets/${encodeURIComponent(String(targetId))}`,
+            security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
@@ -95,6 +104,7 @@ export class TargetsResource {
         return this._core.request({
             method: "DELETE",
             path: `/targets/${encodeURIComponent(String(targetId))}`,
+            security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
@@ -115,6 +125,7 @@ export class TargetsResource {
         return this._core.request({
             method: "PATCH",
             path: `/targets/${encodeURIComponent(String(targetId))}`,
+            security: [{ "apiKey": [] }],
             body,
             errors: {
                 "400": BadRequestError,
@@ -139,6 +150,7 @@ export class TargetsResource {
         return paginate(this._core, {
             method: "GET",
             path: `/targets/${encodeURIComponent(String(targetId))}/releases`,
+            security: [{ "apiKey": [] }],
             query: {
                 limit: params?.limit,
                 cursor: params?.cursor,
@@ -170,6 +182,7 @@ export class TargetsResource {
         return this._core.request({
             method: "GET",
             path: `/target_releases/${encodeURIComponent(String(targetReleaseId))}`,
+            security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CA+BpE,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA0GxC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CA+BpE,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA0HxC,CAAC"}

package/dist/schemas.js

@@ -42,11 +42,15 @@ export const DEFS = {
     "req:UrlDefinitionInput": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "pattern": "^https?://" }, "headers": { "type": "object" } }, "required": ["url"] },
     "req:InlineDefinitionInput": { "type": "object", "additionalProperties": false, "properties": { "inline": { "type": "string" } }, "required": ["inline"] },
     "req:GeneratorKind": { "type": "string", "enum": ["typescript-sdk", "python-sdk", "go-sdk", "cli", "mcp"] },
-    "req:Config": { "type": "object", "additionalProperties": false, "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "req:RetryTuning" }, "pagination": { "type": "object" }, "graphql": { "$ref": "req:GraphqlSettings" }, "cli": { "$ref": "req:CliBehavior" }, "mcp": { "$ref": "req:McpBehavior" }, "package": { "$ref": "req:PackageBehavior" }, "docs_url": { "type": ["string", "null"] }, "docs_index_url": { "type": ["string", "null"] } } },
+    "req:Config": { "type": "object", "additionalProperties": false, "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "req:RetryTuning" }, "pagination": { "type": "object" }, "graphql": { "$ref": "req:GraphqlSettings" }, "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"] } } },
     "req:RetryTuning": { "type": "object", "additionalProperties": false, "properties": { "max_retries": { "type": "integer", "minimum": 0, "maximum": 10 }, "statuses": { "type": "array", "maxItems": 20, "items": { "type": "integer" } }, "initial_delay_ms": { "type": "integer", "minimum": 1 }, "max_delay_ms": { "type": "integer", "minimum": 1 }, "retry_non_idempotent": { "type": "boolean" }, "disabled": { "type": "boolean" }, "operations": { "type": "object" } } },
     "req: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", "enum": ["bearer", "basic", "api_key", "none"] }, "api_key_header": { "type": "string" }, "title": { "type": "string", "maxLength": 80 }, "scalars": { "type": "object" } } },
-    "req:CliBehavior": { "type": "object", "additionalProperties": false, "properties": { "command_name": { "type": ["string", "null"] }, "whoami_operation": { "type": ["string", "null"] }, "oauth_client_id": { "type": ["string", "null"] }, "oauth_scopes": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "oauth_audience": { "type": ["string", "null"] }, "update_notice": { "type": "boolean" }, "support_url": { "type": ["string", "null"] }, "auth_url": { "type": ["string", "null"] }, "mcp_url": { "type": ["string", "null"] }, "skills_repo": { "type": ["string", "null"] } } },
-    "req:McpBehavior": { "type": "object", "additionalProperties": false, "properties": { "registry_name": { "type": ["string", "null"] }, "tool_mode": { "type": "string", "enum": ["auto", "operations", "meta"] }, "instructions": { "type": ["string", "null"], "maxLength": 2000 }, "tool_descriptions": { "type": "object" } } },
+    "req:AuthenticationConfig": { "type": "object", "additionalProperties": false, "properties": { "oauth_server": { "anyOf": [{ "$ref": "req:OAuthServer" }, { "type": "null" }] }, "oauth_applications": { "type": ["object", "null"] }, "oauth_application": { "type": ["string", "null"], "maxLength": 64, "pattern": "^[a-z][a-z0-9_-]{0,63}$" }, "identity_verification": { "anyOf": [{ "$ref": "req:IdentityVerification" }, { "type": "null" }] }, "approval_url": { "type": ["string", "null"] }, "environments": { "type": ["object", "null"] } } },
+    "req:OAuthServer": { "type": "object", "additionalProperties": false, "properties": { "issuer": { "type": ["string", "null"] }, "discovery_url": { "type": ["string", "null"] }, "authorization_url": { "type": ["string", "null"] }, "token_url": { "type": ["string", "null"] }, "device_authorization_url": { "type": ["string", "null"] }, "scopes": { "type": ["array", "null"], "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500, "pattern": "^\\S+$" } }, "audience": { "type": ["string", "null"] }, "resource": { "type": ["string", "null"] } } },
+    "req:IdentityVerification": { "type": "object", "additionalProperties": false, "properties": { "operation": { "type": "string", "maxLength": 2000, "pattern": "^[\\w$]+\\.[\\w$]+$" }, "subject_field": { "type": "string", "maxLength": 512 }, "account_field": { "type": "string", "maxLength": 512 }, "organization_field": { "type": "string", "maxLength": 512 } } },
+    "req:CliBehavior": { "type": "object", "additionalProperties": false, "properties": { "command_name": { "type": ["string", "null"] }, "update_notice": { "type": "boolean" }, "support_url": { "type": ["string", "null"] }, "mcp_url": { "type": ["string", "null"] }, "skills_repo": { "type": ["string", "null"] } } },
+    "req:McpBehavior": { "type": "object", "additionalProperties": false, "properties": { "registry_name": { "type": ["string", "null"] }, "access": { "type": "object", "additionalProperties": false, "properties": { "issuer": { "type": "string" }, "resource": { "type": "string" }, "jwks_url": { "type": "string" }, "scopes": { "type": "array", "maxItems": 20, "items": { "type": "string" } } }, "required": ["issuer", "resource"] }, "tool_mode": { "type": "string", "enum": ["auto", "operations", "meta"] }, "instructions": { "type": ["string", "null"], "maxLength": 2000 }, "tool_descriptions": { "type": "object" }, "reference_resolvers": { "type": "object" } } },
+    "req:ReadmeBehavior": { "type": "object", "additionalProperties": false, "properties": { "quickstart_operation": { "type": ["string", "null"], "maxLength": 500 } } },
     "req: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:GenerationResult": { "type": "object", "properties": { "files": { "type": "array", "items": { "$ref": "res:GeneratedFile" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "meta": { "$ref": "res:GenerationMeta" }, "limits": { "$ref": "res:GenerationLimits" }, "claim": { "anyOf": [{ "type": "null" }, { "type": "object", "properties": { "url": { "type": "string" }, "expires_at": { "type": "string" } }, "required": ["url", "expires_at"] }] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["files", "warnings", "meta", "request_id"] },
     "res:GeneratedFile": { "type": "object", "properties": { "path": { "type": "string" }, "content": { "type": "string" } }, "required": ["path", "content"] },
@@ -69,24 +73,23 @@ export const DEFS = {
     "req:DefinitionPatch": { "type": "object", "additionalProperties": false, "properties": { "op": { "type": "string", "enum": ["set", "append", "remove", "rename"] }, "path": { "type": "string" }, "value": {}, "to": { "type": ["string", "null"] }, "reason": { "type": ["string", "null"] } }, "required": ["op", "path"] },
     "req:DiagnosticPolicy": { "type": "object", "additionalProperties": false, "properties": { "fail_on": { "type": "string", "enum": ["never", "error", "warning"] }, "only_new": { "type": "boolean" }, "suppressions": { "type": "array", "maxItems": 100, "items": { "$ref": "req:DiagnosticSuppression" } } }, "required": ["fail_on", "only_new", "suppressions"] },
     "req: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"] },
-    "req:InitialTargetFields": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "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:ProjectConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "items": { "$ref": "req:DeliveryInput" } } }, "required": ["name", "generator"] },
-    "req:ProjectConfig": { "type": "object", "additionalProperties": false, "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "req:RetryTuning" }, "pagination": { "type": "object" }, "cli": { "$ref": "req:CliBehavior" }, "mcp": { "$ref": "req:McpBehavior" }, "package": { "$ref": "req:PackageBehavior" }, "docs_url": { "type": ["string", "null"] }, "docs_index_url": { "type": ["string", "null"] } } },
+    "req:InitialTargetFields": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "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", "generator"] },
+    "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:HostedMcpDeliveryInput": { "type": "object", "additionalProperties": false, "properties": { "kind": { "type": "string", "const": "hosted_mcp" } }, "required": ["kind"] },
-    "res:Project": { "type": "object", "additionalProperties": false, "properties": { "id": { "$ref": "res:ProjectId" }, "object": { "type": "string" }, "name": { "type": "string", "maxLength": 80 }, "definition_id": { "$ref": "res:DefinitionId" }, "targets": { "type": "array", "items": { "$ref": "res:Target" } }, "deliveries": { "type": "array", "items": { "$ref": "res:Delivery" } }, "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", "targets", "deliveries", "auto_generate", "relay_enabled", "config", "created_at", "updated_at", "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:ProjectConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "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:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
-    "res:ProjectConfig": { "type": "object", "additionalProperties": false, "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "res:RetryTuning" }, "pagination": { "type": "object" }, "cli": { "$ref": "res:CliBehavior" }, "mcp": { "$ref": "res:McpBehavior" }, "package": { "$ref": "res:PackageBehavior" }, "docs_url": { "type": ["string", "null"] }, "docs_index_url": { "type": ["string", "null"] } } },
+    "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"] },
+    "res:ProjectConfig": { "type": "object", "additionalProperties": false, "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "res:RetryTuning" }, "pagination": { "type": "object" }, "auth": { "$ref": "res:AuthenticationConfig" }, "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:RetryTuning": { "type": "object", "additionalProperties": false, "properties": { "max_retries": { "type": "integer", "minimum": 0, "maximum": 10 }, "statuses": { "type": "array", "maxItems": 20, "items": { "type": "integer" } }, "initial_delay_ms": { "type": "integer", "minimum": 1 }, "max_delay_ms": { "type": "integer", "minimum": 1 }, "retry_non_idempotent": { "type": "boolean" }, "disabled": { "type": "boolean" }, "operations": { "type": "object" } } },
-    "res:CliBehavior": { "type": "object", "additionalProperties": false, "properties": { "command_name": { "type": ["string", "null"] }, "whoami_operation": { "type": ["string", "null"] }, "oauth_client_id": { "type": ["string", "null"] }, "oauth_scopes": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "oauth_audience": { "type": ["string", "null"] }, "update_notice": { "type": "boolean" }, "support_url": { "type": ["string", "null"] }, "auth_url": { "type": ["string", "null"] }, "mcp_url": { "type": ["string", "null"] }, "skills_repo": { "type": ["string", "null"] } } },
-    "res:McpBehavior": { "type": "object", "additionalProperties": false, "properties": { "registry_name": { "type": ["string", "null"] }, "tool_mode": { "type": "string" }, "instructions": { "type": ["string", "null"], "maxLength": 2000 }, "tool_descriptions": { "type": "object" } } },
+    "res:AuthenticationConfig": { "type": "object", "additionalProperties": false, "properties": { "oauth_server": { "anyOf": [{ "$ref": "res:OAuthServer" }, { "type": "null" }] }, "oauth_applications": { "type": ["object", "null"] }, "oauth_application": { "type": ["string", "null"], "maxLength": 64, "pattern": "^[a-z][a-z0-9_-]{0,63}$" }, "identity_verification": { "anyOf": [{ "$ref": "res:IdentityVerification" }, { "type": "null" }] }, "approval_url": { "type": ["string", "null"] }, "environments": { "type": ["object", "null"] } } },
+    "res:OAuthServer": { "type": "object", "additionalProperties": false, "properties": { "issuer": { "type": ["string", "null"] }, "discovery_url": { "type": ["string", "null"] }, "authorization_url": { "type": ["string", "null"] }, "token_url": { "type": ["string", "null"] }, "device_authorization_url": { "type": ["string", "null"] }, "scopes": { "type": ["array", "null"], "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500, "pattern": "^\\S+$" } }, "audience": { "type": ["string", "null"] }, "resource": { "type": ["string", "null"] } } },
+    "res:IdentityVerification": { "type": "object", "additionalProperties": false, "properties": { "operation": { "type": "string", "maxLength": 2000, "pattern": "^[\\w$]+\\.[\\w$]+$" }, "subject_field": { "type": "string", "maxLength": 512 }, "account_field": { "type": "string", "maxLength": 512 }, "organization_field": { "type": "string", "maxLength": 512 } } },
+    "res:CliBehavior": { "type": "object", "additionalProperties": false, "properties": { "command_name": { "type": ["string", "null"] }, "update_notice": { "type": "boolean" }, "support_url": { "type": ["string", "null"] }, "mcp_url": { "type": ["string", "null"] }, "skills_repo": { "type": ["string", "null"] } } },
+    "res:McpBehavior": { "type": "object", "additionalProperties": false, "properties": { "registry_name": { "type": ["string", "null"] }, "access": { "type": "object", "additionalProperties": false, "properties": { "issuer": { "type": "string" }, "resource": { "type": "string" }, "jwks_url": { "type": "string" }, "scopes": { "type": "array", "maxItems": 20, "items": { "type": "string" } } }, "required": ["issuer", "resource"] }, "tool_mode": { "type": "string" }, "instructions": { "type": ["string", "null"], "maxLength": 2000 }, "tool_descriptions": { "type": "object" }, "reference_resolvers": { "type": "object" } } },
+    "res:ReadmeBehavior": { "type": "object", "additionalProperties": false, "properties": { "quickstart_operation": { "type": ["string", "null"], "maxLength": 500 } } },
     "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: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:DeliveryId": { "type": "string", "pattern": "^dlv_[a-z0-9]{16}$" },
-    "res:RepositoryReference": { "type": "object", "additionalProperties": false, "properties": { "provider": { "type": "string" }, "identifier": { "type": "string", "maxLength": 512 } }, "required": ["provider", "identifier"] },
-    "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"] },
     "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"] },
@@ -104,13 +107,17 @@ export const DEFS = {
     "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"] },
     "res:RepositoryIntegrationHealth": { "type": "object", "additionalProperties": false, "properties": { "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "status": { "type": "string" }, "repositories": { "type": "array", "items": { "$ref": "res:RepositoryHealth" } }, "required_checks": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "array", "items": { "type": "string" } }, "destination": { "type": "array", "items": { "type": "string" } } }, "required": ["source", "destination"] }, "last_event": { "anyOf": [{ "$ref": "res:RepositoryEventHealth" }, { "type": "null" }] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "project_id", "status", "repositories", "required_checks", "last_event", "request_id"] },
     "res:RepositoryHealth": { "type": "object", "additionalProperties": false, "properties": { "repository": { "$ref": "res:RepositoryReference" }, "roles": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string" }, "default_branch": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } }, "breaking_acknowledgement": { "type": ["boolean", "null"] }, "definition": { "type": "string" }, "issues": { "type": "array", "items": { "$ref": "res:RepositoryHealthIssue" } } }, "required": ["repository", "roles", "status", "issues"] },
+    "res:RepositoryReference": { "type": "object", "additionalProperties": false, "properties": { "provider": { "type": "string" }, "identifier": { "type": "string", "maxLength": 512 } }, "required": ["provider", "identifier"] },
     "res:RepositoryHealthIssue": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"] },
     "res:RepositoryEventHealth": { "type": "object", "additionalProperties": false, "properties": { "provider": { "type": "string" }, "id": { "type": "string" }, "event": { "type": "string" }, "status": { "type": "string" }, "error": { "type": ["string", "null"] }, "created_at": { "type": "string" } }, "required": ["provider", "id", "event", "status", "error", "created_at"] },
-    "res:GenerationList": { "type": "object", "additionalProperties": false, "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:Generation" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
-    "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": { "type": "string" }, "trigger": { "type": "string" }, "target_id": { "anyOf": [{ "$ref": "res:TargetId" }, { "type": "null" }] }, "generator": { "$ref": "res:GeneratorKind" }, "provenance": { "type": "object", "additionalProperties": false, "properties": { "generator_edition": { "type": "string" }, "engine_build": { "type": "string" }, "resolved_config": { "type": ["object", "null"] }, "config_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }, "surface_plan": { "type": ["object", "null"] }, "surface_plan_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }, "entitlement_cap": { "type": ["integer", "null"], "minimum": 1 }, "package_version": { "type": ["string", "null"] } }, "required": ["generator_edition", "engine_build", "resolved_config", "config_hash", "surface_plan", "surface_plan_hash", "entitlement_cap", "package_version"] }, "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"] },
+    "res:GenerationList": { "type": "object", "additionalProperties": false, "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:GenerationSummary" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res:GenerationSummary": { "type": "object", "additionalProperties": false, "properties": { "id": { "$ref": "res:GenerationId" }, "object": { "type": "string" }, "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" } }, "error": { "type": ["string", "null"] }, "created_at": { "type": "string" } }, "required": ["id", "object", "project_id", "definition_revision_id", "status", "trigger", "target_id", "generator", "provenance", "meta", "warnings", "error", "created_at"] },
     "res:GenerationId": { "type": "string", "pattern": "^gen_[a-z0-9]{16}$" },
-    "res:FileStub": { "type": "object", "properties": { "path": { "type": "string" }, "bytes": { "type": "integer" } }, "required": ["path", "bytes"] },
-    "res:GenerationBatch": { "type": "object", "additionalProperties": false, "properties": { "data": { "type": "array", "items": { "anyOf": [{ "$ref": "res:Generation" }, { "$ref": "res:GenerationFailure" }] } }, "request_id": { "$ref": "res:RequestId" } }, "required": ["data", "request_id"] },
+    "res:GenerationStatus": { "type": "string" },
+    "res:GenerationTrigger": { "type": "string" },
+    "res:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
+    "res:GenerationProvenance": { "type": "object", "additionalProperties": false, "properties": { "generator_edition": { "type": "string" }, "engine_build": { "type": "string" }, "resolved_config": { "type": ["object", "null"] }, "config_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }, "surface_plan": { "type": ["object", "null"] }, "surface_plan_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }, "entitlement_cap": { "type": ["integer", "null"], "minimum": 1 }, "package_version": { "type": ["string", "null"] } }, "required": ["generator_edition", "engine_build", "resolved_config", "config_hash", "surface_plan", "surface_plan_hash", "entitlement_cap", "package_version"] },
+    "res:GenerationBatch": { "type": "object", "additionalProperties": false, "properties": { "data": { "type": "array", "items": { "anyOf": [{ "$ref": "res:GenerationSummary" }, { "$ref": "res:GenerationFailure" }] } }, "request_id": { "$ref": "res:RequestId" } }, "required": ["data", "request_id"] },
     "res:GenerationFailure": { "type": "object", "additionalProperties": false, "properties": { "target_id": { "$ref": "res:TargetId" }, "generator": { "$ref": "res:GeneratorKind" }, "status": { "type": "string" }, "error": { "type": "string" } }, "required": ["target_id", "generator", "status", "error"] },
     "res:Definition": { "type": "object", "additionalProperties": false, "properties": { "id": { "$ref": "res:DefinitionId" }, "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "source": { "$ref": "res:DefinitionSource" }, "format": { "type": ["string", "null"] }, "patches": { "type": "array", "items": { "$ref": "res:DefinitionPatch" } }, "graphql": { "anyOf": [{ "$ref": "res:GraphqlSettings" }, { "type": "null" }] }, "diagnostic_policy": { "$ref": "res:DiagnosticPolicy" }, "latest_revision_id": { "anyOf": [{ "$ref": "res:DefinitionRevisionId" }, { "type": "null" }] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "project_id", "source", "format", "patches", "graphql", "diagnostic_policy", "latest_revision_id", "created_at", "updated_at", "request_id"] },
     "res:DefinitionSource": { "anyOf": [{ "$ref": "res:UrlDefinitionSource" }, { "$ref": "res:RepositoryDefinitionSource" }, { "type": "object" }] },
@@ -119,17 +126,26 @@ export const DEFS = {
     "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"] },
-    "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:ProjectConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "items": { "$ref": "req:DeliveryInput" } } }, "required": ["name", "definition_id", "generator"] },
+    "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: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: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"] },
     "req:DefinitionId": { "type": "string", "pattern": "^def_[a-z0-9]{16}$" },
     "res:TargetResponse": { "allOf": [{ "$ref": "res:Target" }, { "$ref": "res:ResponseMetadata" }] },
     "res:ResponseMetadata": { "type": "object", "properties": { "request_id": { "$ref": "res:RequestId" } }, "required": ["request_id"] },
     "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:ProjectConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "items": { "$ref": "req:DeliveryInput" } } } },
+    "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:TargetReleaseId": { "type": "string", "pattern": "^rel_[a-z0-9]{16}$" },
     "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"] },
+    "res:FileStub": { "type": "object", "properties": { "path": { "type": "string" }, "bytes": { "type": "integer" } }, "required": ["path", "bytes"] },
     "res:DefinitionRevisionList": { "type": "object", "additionalProperties": false, "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:DefinitionRevision" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
     "res:DefinitionRevision": { "type": "object", "additionalProperties": false, "properties": { "id": { "$ref": "res:DefinitionRevisionId" }, "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "definition_id": { "$ref": "res:DefinitionId" }, "format": { "type": "string" }, "document_count": { "type": "integer", "minimum": 1 }, "documents": { "type": "array", "items": { "$ref": "res:DefinitionDocument" } }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 0 }, "source": { "anyOf": [{ "$ref": "res:DefinitionRevisionSource" }, { "type": "null" }] }, "created_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "project_id", "definition_id", "format", "document_count", "sha256", "size_bytes", "source", "created_at"] },
     "res:DefinitionDocument": { "type": "object", "additionalProperties": false, "properties": { "id": { "$ref": "res:DefinitionDocumentId" }, "role": { "type": "string" }, "coordinate": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 0 } }, "required": ["id", "role", "coordinate", "sha256", "size_bytes"] },