@typeship-ax/cli 0.20.0 → 0.21.1

package/dist/schemas.js

@@ -9,54 +9,51 @@ export const SCHEMAS = {
     "generate.downloadPackage": { "res": { "type": "string" }, "params": { "query.token": { "type": "string", "minLength": 43, "maxLength": 43, "pattern": "^[A-Za-z0-9_-]{43}$" } } },
     "projects.list": { "res": { "$ref": "res:ProjectList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
     "projects.create": { "req": { "$ref": "req:CreateProjectRequest" }, "res": { "$ref": "res:Project" }, "params": { "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "projects.retrieve": { "res": { "$ref": "res:Project" }, "params": { "path.project_id": { "$ref": "req:ProjectId" } } },
+    "projects.get": { "res": { "$ref": "res:Project" }, "params": { "path.project_id": { "$ref": "req:ProjectId" } } },
     "projects.delete": { "res": { "$ref": "res:DeletedProject" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 } } },
     "projects.update": { "req": { "$ref": "req:UpdateProjectRequest" }, "res": { "$ref": "res:Project" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 } } },
-    "projects.retrieveDiagnostics": { "res": { "$ref": "res:DiagnosticReport" }, "params": { "path.project_id": { "$ref": "req:ProjectId" } } },
-    "projects.refreshDiagnostics": { "res": { "$ref": "res:DiagnosticReport" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "projects.remediateDiagnostics": { "req": { "$ref": "req:DiagnosticRemediationRequest" }, "res": { "$ref": "res:DiagnosticRemediation" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "projects.retrieveIntegrationHealth": { "res": { "$ref": "res:RepositoryIntegrationHealth" }, "params": { "path.project_id": { "$ref": "req:ProjectId" } } },
-    "projects.listGenerations": { "res": { "$ref": "res:GenerationList" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.target_id": { "$ref": "req:TargetId" } } },
     "projects.generate": { "req": { "$ref": "req:GenerateProjectRequest" }, "res": { "$ref": "res:GenerationBatch" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "definitions.retrieve": { "res": { "$ref": "res:Definition" }, "params": { "path.definition_id": { "$ref": "req:DefinitionId" } } },
-    "definitions.update": { "req": { "$ref": "req:DefinitionUpdateRequest" }, "res": { "$ref": "res:Definition" }, "params": { "path.definition_id": { "$ref": "req:DefinitionId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "targets.list": { "res": { "$ref": "res:TargetList" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
-    "targets.create": { "req": { "$ref": "req:TargetFields" }, "res": { "$ref": "res:TargetResponse" }, "params": { "path.project_id": { "$ref": "req:ProjectId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "targets.retrieve": { "res": { "$ref": "res:TargetResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" } } },
+    "specs.get": { "res": { "$ref": "res:Spec" }, "params": { "path.spec_id": { "$ref": "req:SpecId" } } },
+    "specs.update": { "req": { "$ref": "req:SpecUpdateRequest" }, "res": { "$ref": "res:Spec" }, "params": { "path.spec_id": { "$ref": "req:SpecId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
+    "specs.refresh": { "res": { "$ref": "res:Spec" }, "params": { "path.spec_id": { "$ref": "req:SpecId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
+    "specRevisions.list": { "res": { "$ref": "res:SpecRevisionList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.spec_id": { "$ref": "req:SpecId" } } },
+    "specRevisions.get": { "res": { "$ref": "res:SpecRevisionResponse" }, "params": { "path.spec_revision_id": { "$ref": "req:SpecRevisionId" }, "query.include": { "type": "string", "enum": ["diagnostics"] } } },
+    "specRevisions.listFiles": { "res": { "$ref": "res:SpecRevisionFileList" }, "params": { "path.spec_revision_id": { "$ref": "req:SpecRevisionId" }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
+    "targets.list": { "res": { "$ref": "res:TargetList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.project_id": { "$ref": "req:ProjectId" } } },
+    "targets.create": { "req": { "$ref": "req:TargetCreateRequest" }, "res": { "$ref": "res:TargetResponse" }, "params": { "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
+    "targets.get": { "res": { "$ref": "res:TargetResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" } } },
     "targets.delete": { "res": { "$ref": "res:DeletedTarget" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 } } },
     "targets.update": { "req": { "$ref": "req:TargetUpdateRequest" }, "res": { "$ref": "res:TargetResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 } } },
-    "targets.listReleases": { "res": { "$ref": "res:TargetReleaseList" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
-    "targets.retrieveDraft": { "res": { "$ref": "res:TargetDraftResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" } } },
-    "targets.updateDraft": { "req": { "$ref": "req:TargetDraftUpdate" }, "res": { "$ref": "res:TargetDraftResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 } } },
-    "targets.adoptRelease": { "req": { "$ref": "req:TargetAdoption" }, "res": { "$ref": "res:TargetReleaseResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "targets.retrieveRelease": { "res": { "$ref": "res:TargetReleaseResponse" }, "params": { "path.target_release_id": { "$ref": "req:TargetReleaseId" } } },
-    "targets.republishRelease": { "res": { "$ref": "res:TargetReleaseResponse" }, "params": { "path.target_release_id": { "$ref": "req:TargetReleaseId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
-    "targets.listDraftFiles": { "res": { "$ref": "res:DraftFileList" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "query.filter": { "type": "string", "enum": ["conflicted", "customized", "history"] }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
-    "targets.retrieveDraftFileContent": { "res": { "$ref": "res:DraftFileContentResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "query.path": { "type": "string", "minLength": 1 }, "query.side": { "$ref": "req:DraftFileSide" }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
-    "targets.resolveDraftConflicts": { "req": { "$ref": "req:ResolveDraftConflicts" }, "res": { "$ref": "res:DraftConflictResolutionResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" } } },
-    "targets.discardDraftCustomizations": { "req": { "$ref": "req:DiscardDraftCustomizations" }, "res": { "$ref": "res:DraftCustomizationDiscardResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" } } },
-    "targets.recoverDraftHistory": { "req": { "$ref": "req:RecoverDraftHistory" }, "res": { "$ref": "res:DraftHistoryRecoveryResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" } } },
-    "targets.retrieveDelivery": { "res": { "$ref": "res:DeliveryResponse" }, "params": { "path.delivery_id": { "$ref": "req:DeliveryId" } } },
-    "targets.retrievePublication": { "res": { "$ref": "res:PublicationResponse" }, "params": { "path.publication_id": { "$ref": "req:PublicationId" } } },
-    "generations.retrieve": { "res": { "$ref": "res:GenerationResponse" }, "params": { "path.generation_id": { "$ref": "req:GenerationId" } } },
-    "generations.retrieveFile": { "res": { "type": "string" }, "params": { "path.generation_id": { "$ref": "req:GenerationId" }, "query.path": { "type": "string" } } },
-    "definitionRevisions.list": { "res": { "$ref": "res:DefinitionRevisionList" }, "params": { "path.definition_id": { "$ref": "req:DefinitionId" }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
-    "definitionRevisions.retrieve": { "res": { "$ref": "res:DefinitionRevisionResponse" }, "params": { "path.definition_revision_id": { "$ref": "req:DefinitionRevisionId" } } },
-    "definitionRevisions.retrieveContent": { "res": { "type": "string" }, "params": { "path.definition_revision_id": { "$ref": "req:DefinitionRevisionId" } } },
-    "definitionRevisions.retrieveDocumentContent": { "res": { "type": "string" }, "params": { "path.definition_revision_id": { "$ref": "req:DefinitionRevisionId" }, "path.document_id": { "$ref": "req:DefinitionDocumentId" } } },
-    "definitionRevisions.retrieveDocument": { "res": { "$ref": "res:DefinitionDocumentResponse" }, "params": { "path.definition_document_id": { "$ref": "req:DefinitionDocumentId" } } },
-    "account.retrieve": { "res": { "$ref": "res:Account" } },
+    "targets.adopt": { "req": { "$ref": "req:TargetAdoption" }, "res": { "$ref": "res:ReleaseResponse" }, "params": { "path.target_id": { "$ref": "req:TargetId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
+    "drafts.list": { "res": { "$ref": "res:DraftList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.target_id": { "$ref": "req:TargetId" }, "query.status": { "$ref": "req:DraftStatus" } } },
+    "drafts.get": { "res": { "$ref": "res:DraftResponse" }, "params": { "path.draft_id": { "$ref": "req:DraftId" } } },
+    "drafts.update": { "req": { "$ref": "req:DraftUpdateRequest" }, "res": { "$ref": "res:DraftResponse" }, "params": { "path.draft_id": { "$ref": "req:DraftId" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 } } },
+    "drafts.listFiles": { "res": { "$ref": "res:DraftFileList" }, "params": { "path.draft_id": { "$ref": "req:DraftId" }, "query.filter": { "type": "string", "enum": ["conflicted", "customized", "history"] }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
+    "drafts.resolve": { "req": { "$ref": "req:DraftResolveRequest" }, "res": { "$ref": "res:DraftResponse" }, "params": { "path.draft_id": { "$ref": "req:DraftId" } } },
+    "drafts.recover": { "req": { "$ref": "req:DraftRecoverRequest" }, "res": { "$ref": "res:DraftResponse" }, "params": { "path.draft_id": { "$ref": "req:DraftId" } } },
+    "releases.list": { "res": { "$ref": "res:ReleaseList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.target_id": { "$ref": "req:TargetId" } } },
+    "releases.get": { "res": { "$ref": "res:ReleaseResponse" }, "params": { "path.release_id": { "$ref": "req:ReleaseId" } } },
+    "releases.republish": { "res": { "$ref": "res:ReleaseResponse" }, "params": { "path.release_id": { "$ref": "req:ReleaseId" }, "header.Idempotency-Key": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[!-~]+$" } } },
+    "deliveries.list": { "res": { "$ref": "res:DeliveryList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.target_id": { "$ref": "req:TargetId" } } },
+    "deliveries.get": { "res": { "$ref": "res:DeliveryResponse" }, "params": { "path.delivery_id": { "$ref": "req:DeliveryId" } } },
+    "publications.list": { "res": { "$ref": "res:PublicationList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.release_id": { "$ref": "req:ReleaseId" } } },
+    "publications.get": { "res": { "$ref": "res:PublicationResponse" }, "params": { "path.publication_id": { "$ref": "req:PublicationId" } } },
+    "generations.list": { "res": { "$ref": "res:GenerationList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }, "query.project_id": { "$ref": "req:ProjectId" }, "query.target_id": { "$ref": "req:TargetId" }, "query.status": { "$ref": "req:GenerationStatus" } } },
+    "generations.get": { "res": { "$ref": "res:GenerationResponse" }, "params": { "path.generation_id": { "$ref": "req:GenerationId" } } },
+    "generations.listFiles": { "res": { "$ref": "res:FileList" }, "params": { "path.generation_id": { "$ref": "req:GenerationId" }, "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
+    "files.get": { "res": { "$ref": "res:FileResponse" }, "params": { "path.file_id": { "$ref": "req:FileId" }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
+    "organization.get": { "res": { "$ref": "res:Organization" } },
     "apiKeys.list": { "res": { "$ref": "res:ApiKeyList" }, "params": { "query.limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query.cursor": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" } } },
-    "apiKeys.retrieve": { "res": { "$ref": "res:ApiKeyResponse" }, "params": { "path.api_key_id": { "type": "string" } } },
+    "apiKeys.get": { "res": { "$ref": "res:ApiKeyResponse" }, "params": { "path.api_key_id": { "type": "string" } } },
     "apiKeys.revoke": { "res": { "$ref": "res:ApiKeyResponse" }, "params": { "path.api_key_id": { "type": "string" }, "header.If-Match": { "type": "string", "minLength": 1, "maxLength": 1024 } } },
 };
 export const DEFS = {
-    "req:GenerateRequest": { "type": "object", "additionalProperties": false, "properties": { "definition": { "$ref": "req:DefinitionInput" }, "target": { "type": "object", "additionalProperties": false, "properties": { "generator": { "$ref": "req:GeneratorKind" } }, "required": ["generator"] }, "package_name": { "type": "string" }, "module_path": { "type": "string" }, "go_sdk": { "$ref": "req:GoSdkDescriptor" }, "config": { "$ref": "req:Config" } }, "required": ["definition", "target"] },
-    "req:DefinitionInput": { "anyOf": [{ "$ref": "req:UrlDefinitionInput" }, { "$ref": "req:InlineDefinitionInput" }] },
-    "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", "go-cli", "mcp"] },
-    "req:GoSdkDescriptor": { "type": "object", "additionalProperties": false, "properties": { "module_path": { "type": "string" }, "version": { "type": "string" }, "definition_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "edition": { "type": "string" }, "package_name": { "type": "string" } }, "required": ["module_path", "version", "definition_digest", "edition"] },
+    "req:GenerateRequest": { "type": "object", "additionalProperties": false, "properties": { "spec": { "$ref": "req:SpecInput" }, "target": { "type": "object", "additionalProperties": false, "properties": { "type": { "$ref": "req:GeneratorKind" } }, "required": ["type"] }, "package_name": { "type": "string" }, "module_path": { "type": "string" }, "go_sdk": { "$ref": "req:GoSdkDescriptor" }, "config": { "$ref": "req:Config" } }, "required": ["spec", "target"] },
+    "req:SpecInput": { "anyOf": [{ "$ref": "req:UrlSpecInput" }, { "$ref": "req:InlineSpecInput" }] },
+    "req:UrlSpecInput": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "pattern": "^https?://" }, "headers": { "type": "object" } }, "required": ["url"] },
+    "req:InlineSpecInput": { "type": "object", "additionalProperties": false, "properties": { "inline": { "type": "string" } }, "required": ["inline"] },
+    "req:GeneratorKind": { "type": "string", "enum": ["cli", "go_cli", "mcp", "typescript_sdk", "python_sdk", "go_sdk"] },
+    "req:GoSdkDescriptor": { "type": "object", "additionalProperties": false, "properties": { "module_path": { "type": "string" }, "version": { "type": "string" }, "spec_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "package_name": { "type": "string" } }, "required": ["module_path", "version", "spec_digest"] },
     "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" } } },
@@ -67,37 +64,40 @@ export const DEFS = {
     "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" } }, "download": { "$ref": "res:GenerationDownload" }, "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:GenerationResult": { "type": "object", "properties": { "files": { "type": "array", "items": { "$ref": "res:GeneratedFile" } }, "download": { "$ref": "res:GenerationDownload" }, "warnings": { "type": "array", "items": { "$ref": "res:GenerationWarning" } }, "coverage": { "$ref": "res:GenerationCoverage" }, "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", "coverage", "request_id"] },
     "res:GeneratedFile": { "type": "object", "properties": { "path": { "type": "string" }, "content": { "type": "string" }, "mode": { "type": "string" } }, "required": ["path", "content"] },
     "res:GenerationDownload": { "type": "object", "properties": { "url": { "type": "string" }, "expires_at": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 0 }, "file_count": { "type": "integer", "minimum": 0 } }, "required": ["url", "expires_at", "sha256", "size_bytes", "file_count"] },
-    "res:GenerationMeta": { "type": "object", "properties": { "title": { "type": "string" }, "api_version": { "type": "string" }, "version": { "type": "string" }, "spec_format": { "type": "string" }, "oas_version": { "type": "string" }, "converted": { "type": "boolean" }, "artifact_name": { "type": "string" }, "client_name": { "type": "string" }, "generators": { "type": "array", "items": { "$ref": "res:GeneratorKind" } }, "go_sdk": { "type": "object", "properties": { "module_path": { "type": "string" }, "version": { "type": "string" }, "package_name": { "type": "string" } }, "required": ["module_path", "version"] }, "resource_count": { "type": "integer" }, "operation_count": { "type": "integer" }, "schema_count": { "type": "integer" }, "paginated_operation_count": { "type": "integer" }, "omitted_operation_count": { "type": "integer" }, "omitted_operations": { "type": "array", "items": { "type": "string" } }, "pr_url": { "type": ["string", "null"] }, "pr_number": { "type": ["integer", "null"] }, "pr_status": { "type": "string" }, "changelog": { "type": "string" }, "breaking_count": { "type": "integer" }, "baseline": { "type": "string" }, "api_compatibility": { "type": "string" }, "package_compatibility": { "type": "string" }, "version_correct": { "type": ["boolean", "null"] }, "release_readiness": { "type": "string" }, "release_readiness_note": { "type": "string" }, "previous_version": { "type": "string" }, "customer_change_count": { "type": "integer", "minimum": 0 }, "integration_state": { "type": "string" }, "published_compatibility": { "type": "string" }, "published_version": { "type": "string" }, "file_count": { "type": "integer" }, "total_lines": { "type": "integer" }, "diagnostics": { "type": "object", "properties": { "format": { "type": "string" }, "summary": { "$ref": "res:DiagnosticSummary" } }, "required": ["format", "summary"] } }, "required": ["title", "api_version", "version", "oas_version", "artifact_name", "client_name", "generators"] },
-    "res:GeneratorKind": { "type": "string" },
-    "res:DiagnosticSummary": { "type": "object", "properties": { "diagnostics": { "type": "integer", "minimum": 0 }, "occurrences": { "type": "integer", "minimum": 0 }, "errors": { "type": "integer", "minimum": 0 }, "warnings": { "type": "integer", "minimum": 0 }, "suggestions": { "type": "integer", "minimum": 0 }, "auto_fixable": { "type": "integer", "minimum": 0 } }, "required": ["diagnostics", "occurrences", "errors", "warnings", "suggestions", "auto_fixable"] },
-    "res:GenerationLimits": { "type": "object", "properties": { "max_operations": { "type": "integer" }, "generated_operations": { "type": "integer" }, "omitted_operations": { "type": "integer" }, "total_operations": { "type": "integer" }, "reason": { "type": "string" }, "signup_url": { "type": "string" }, "upgrade_url": { "type": "string" } }, "required": ["max_operations", "generated_operations", "omitted_operations", "total_operations", "reason", "upgrade_url"] },
+    "res:GenerationWarning": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "operation": { "type": "string" } }, "required": ["code", "message"] },
+    "res:GenerationCoverage": { "type": "object", "properties": { "generated": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "omitted_operations": { "type": "array", "items": { "type": "string" } }, "reason": { "type": "string" }, "signup_url": { "type": "string" }, "upgrade_url": { "type": "string" } }, "required": ["generated", "omitted", "total", "omitted_operations"] },
     "res:RequestId": { "type": "string", "pattern": "^req_[a-z0-9]{16}$" },
     "res:ProjectList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:ProjectSummary" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
     "res:ListObject": { "type": "string" },
-    "res:ProjectSummary": { "type": "object", "properties": { "id": { "$ref": "res:ProjectId" }, "object": { "type": "string" }, "name": { "type": "string", "maxLength": 80 }, "definition_id": { "$ref": "res:DefinitionId" }, "auto_generate": { "type": "boolean" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": ["id", "object", "name", "definition_id", "auto_generate", "created_at", "updated_at"] },
+    "res:ProjectSummary": { "type": "object", "properties": { "id": { "$ref": "res:ProjectId" }, "object": { "type": "string" }, "name": { "type": "string", "maxLength": 80 }, "spec_id": { "$ref": "res:SpecId" }, "auto_generate": { "type": "boolean" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": ["id", "object", "name", "spec_id", "auto_generate", "created_at", "updated_at"] },
     "res:ProjectId": { "type": "string", "pattern": "^prj_[a-z0-9]{16}$" },
-    "res:DefinitionId": { "type": "string", "pattern": "^def_[a-z0-9]{16}$" },
-    "req:CreateProjectRequest": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "definition": { "$ref": "req:DefinitionFields" }, "targets": { "type": "array", "minItems": 1, "items": { "$ref": "req:InitialTargetFields" } }, "auto_generate": { "type": "boolean" }, "relay_enabled": { "type": "boolean" }, "config": { "anyOf": [{ "$ref": "req:ProjectConfig" }, { "type": "null" }] } }, "required": ["name", "definition", "targets"] },
-    "req:DefinitionFields": { "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" } }, "required": ["source"] },
-    "req:DefinitionSourceInput": { "anyOf": [{ "$ref": "req:UrlDefinitionSourceInput" }, { "$ref": "req:RepositoryDefinitionSourceInput" }] },
-    "req:UrlDefinitionSourceInput": { "type": "object", "additionalProperties": false, "properties": { "kind": { "type": "string", "const": "url" }, "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://" }, "headers": { "anyOf": [{ "type": "object" }, { "type": "null" }] } }, "required": ["kind", "url"] },
-    "req:RepositoryDefinitionSourceInput": { "type": "object", "additionalProperties": false, "properties": { "kind": { "type": "string", "const": "repository" }, "repository": { "$ref": "req:RepositoryReference" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*\\.\\.).+$" } }, "required": ["kind", "repository", "path"] },
-    "req:RepositoryReference": { "type": "object", "additionalProperties": false, "properties": { "provider": { "type": "string", "enum": ["github"] }, "identifier": { "type": "string", "maxLength": 512 } }, "required": ["provider", "identifier"] },
-    "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"] },
+    "res:SpecId": { "type": "string", "pattern": "^spec_[a-z0-9]{16}$" },
+    "req:CreateProjectRequest": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "spec": { "$ref": "req:SpecFields" }, "targets": { "type": "array", "minItems": 1, "items": { "$ref": "req:InitialTargetFields" } }, "auto_generate": { "type": "boolean" }, "config": { "anyOf": [{ "$ref": "req:ProjectConfig" }, { "type": "null" }] } }, "required": ["name", "spec", "targets"] },
+    "req:SpecFields": { "type": "object", "additionalProperties": false, "properties": { "source": { "$ref": "req:SpecSourceInput" }, "patches": { "type": "array", "maxItems": 50, "items": { "$ref": "req:SpecPatch" } }, "graphql": { "anyOf": [{ "$ref": "req:GraphqlSettings" }, { "type": "null" }] }, "diagnostic_policy": { "$ref": "req:DiagnosticPolicy" } }, "required": ["source"] },
+    "req:SpecSourceInput": { "anyOf": [{ "$ref": "req:UrlSpecSourceInput" }, { "$ref": "req:RepositorySpecSourceInput" }] },
+    "req:UrlSpecSourceInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "url" }, "url": { "$ref": "req:UrlSpecSourceSettingsInput" } }, "required": ["type", "url"] },
+    "req:UrlSpecSourceSettingsInput": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://" }, "headers": { "anyOf": [{ "type": "object" }, { "type": "null" }] } }, "required": ["url"] },
+    "req:RepositorySpecSourceInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "repository" }, "repository": { "$ref": "req:RepositorySpecSourceSettingsInput" } }, "required": ["type", "repository"] },
+    "req:RepositorySpecSourceSettingsInput": { "type": "object", "additionalProperties": false, "properties": { "provider": { "$ref": "req:RepositoryProvider" }, "identifier": { "$ref": "req:RepositoryIdentifier" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*\\.\\.).+$" } }, "required": ["provider", "identifier", "path"] },
+    "req:RepositoryProvider": { "type": "string", "enum": ["github"] },
+    "req:RepositoryIdentifier": { "type": "string", "maxLength": 512 },
+    "req:SpecPatch": { "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"] }, "checks": { "$ref": "req:TargetChecks" }, "config": { "anyOf": [{ "$ref": "req:TargetConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "maxItems": 2, "items": { "$ref": "req:DeliveryInput" } } }, "required": ["name", "generator"] },
+    "req:InitialTargetFields": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "type": { "$ref": "req:GeneratorKind" }, "status": { "type": "string", "enum": ["active", "disabled"] }, "release_channel": { "type": "string", "enum": ["stable", "prerelease"] }, "checks": { "$ref": "req:TargetChecks" }, "config": { "anyOf": [{ "$ref": "req:TargetConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "maxItems": 2, "items": { "$ref": "req:DeliveryInput" } } }, "required": ["name", "type"] },
     "req:TargetChecks": { "type": "object", "additionalProperties": false, "properties": { "generated": { "type": "array", "items": { "type": "string", "enum": ["build", "package", "public_entrypoint"] } }, "repository_required": { "type": "array", "maxItems": 50, "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "customer": { "type": "array", "maxItems": 20, "items": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "command": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": ["name", "command"] } } } },
-    "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: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:TargetCliBehavior" }, "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:TargetCliBehavior": { "type": "object", "additionalProperties": false, "properties": { "command_name": { "type": ["string", "null"] }, "update_notice": { "type": "boolean" }, "changelog_url": { "type": ["string", "null"] }, "support_url": { "type": ["string", "null"] }, "mcp_url": { "type": ["string", "null"] }, "skills_repo": { "type": ["string", "null"] }, "relay": { "type": "boolean" } } },
     "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"] }, "publish_on_merge": { "type": "boolean" } }, "required": ["kind", "repository"] },
-    "req:HostedMcpDeliveryInput": { "type": "object", "additionalProperties": false, "properties": { "kind": { "type": "string", "const": "hosted_mcp" } }, "required": ["kind"] },
+    "req:RepositoryDeliveryInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "repository" }, "repository": { "$ref": "req:RepositoryDeliverySettingsInput" } }, "required": ["type", "repository"] },
+    "req:RepositoryDeliverySettingsInput": { "type": "object", "additionalProperties": false, "properties": { "provider": { "$ref": "req:RepositoryProvider" }, "identifier": { "$ref": "req:RepositoryIdentifier" }, "directory": { "type": ["string", "null"] }, "package_name": { "type": ["string", "null"] }, "module_path": { "type": ["string", "null"] }, "publish_on_merge": { "type": "boolean" } }, "required": ["provider", "identifier"] },
+    "req:HostedMcpDeliveryInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "hosted_mcp" } }, "required": ["type"] },
     "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", "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:ProjectConfigResponse" }, { "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:Project": { "type": "object", "properties": { "id": { "$ref": "res:ProjectId" }, "object": { "type": "string" }, "name": { "type": "string", "maxLength": 80 }, "spec_id": { "$ref": "res:SpecId" }, "auto_generate": { "type": "boolean" }, "config": { "anyOf": [{ "$ref": "res:ProjectConfigResponse" }, { "type": "null" }] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "name", "spec_id", "auto_generate", "config", "created_at", "updated_at", "request_id"] },
     "res:ProjectConfigResponse": { "type": "object", "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "res:RetryTuningResponse" }, "pagination": { "type": "object" }, "auth": { "$ref": "res:AuthenticationConfigResponse" }, "cli": { "$ref": "res:CliBehaviorResponse" }, "mcp": { "$ref": "res:McpBehaviorResponse" }, "readme": { "$ref": "res:ReadmeBehaviorResponse" }, "package": { "$ref": "res:PackageBehaviorResponse" }, "docs_url": { "type": ["string", "null"] }, "docs_index_url": { "type": ["string", "null"] } } },
     "res:RetryTuningResponse": { "type": "object", "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:AuthenticationConfigResponse": { "type": "object", "properties": { "oauth_server": { "anyOf": [{ "$ref": "res:OAuthServerResponse" }, { "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:IdentityVerificationResponse" }, { "type": "null" }] }, "approval_url": { "type": ["string", "null"] }, "environments": { "type": ["object", "null"] } } },
@@ -109,126 +109,121 @@ export const DEFS = {
     "res:PackageBehaviorResponse": { "type": "object", "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"] } } },
     "req:ProjectId": { "type": "string", "pattern": "^prj_[a-z0-9]{16}$" },
     "res:DeletedProject": { "type": "object", "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", "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:DiagnosticPolicyResponse" }, "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", "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", "properties": { "document": { "type": "string" }, "path": { "type": "string" }, "operation": { "type": "string" }, "evidence": { "type": "string" } }, "required": ["path"] },
-    "res:DiagnosticFix": { "type": "object", "properties": { "title": { "type": "string" }, "kind": { "type": "string" }, "patches": { "type": "array", "items": { "$ref": "res:DefinitionPatchResponse" } }, "instructions": { "type": "string" } }, "required": ["title", "kind"] },
-    "res:DefinitionPatchResponse": { "type": "object", "properties": { "op": { "type": "string" }, "path": { "type": "string" }, "value": {}, "to": { "type": ["string", "null"] }, "reason": { "type": ["string", "null"] } }, "required": ["op", "path"] },
-    "res:DiagnosticPolicyResponse": { "type": "object", "properties": { "fail_on": { "type": "string" }, "only_new": { "type": "boolean" }, "suppressions": { "type": "array", "maxItems": 100, "items": { "$ref": "res:DiagnosticSuppressionResponse" } } }, "required": ["fail_on", "only_new", "suppressions"] },
-    "res:DiagnosticSuppressionResponse": { "type": "object", "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", "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", "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", "properties": { "suppressed_by_rule": { "type": "array", "items": { "$ref": "res:DiagnosticSuppressionSignal" } }, "stale_suppressions": { "type": "array", "items": { "$ref": "res:DiagnosticSuppressionResponse" } } }, "required": ["suppressed_by_rule", "stale_suppressions"] },
-    "res:DiagnosticSuppressionSignal": { "type": "object", "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", "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", "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", "properties": { "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "status": { "type": "string" }, "repositories": { "type": "array", "items": { "$ref": "res:RepositoryHealth" } }, "required_checks": { "type": "object", "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", "properties": { "repository": { "$ref": "res:RepositoryReferenceResponse" }, "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:RepositoryReferenceResponse": { "type": "object", "properties": { "provider": { "type": "string" }, "identifier": { "type": "string", "maxLength": 512 } }, "required": ["provider", "identifier"] },
-    "res:RepositoryHealthIssue": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"] },
-    "res:RepositoryEventHealth": { "type": "object", "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", "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", "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" } }, "errors": { "type": "array", "items": { "$ref": "res:DomainError" } }, "created_at": { "type": "string" } }, "required": ["id", "object", "project_id", "definition_revision_id", "status", "trigger", "target_id", "generator", "provenance", "meta", "warnings", "errors", "created_at"] },
+    "req:UpdateProjectRequest": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "auto_generate": { "type": "boolean" }, "config": { "anyOf": [{ "$ref": "req:ProjectConfig" }, { "type": "null" }] } } },
+    "req:GenerateProjectRequest": { "type": "object", "additionalProperties": false, "properties": { "target_id": { "$ref": "req:TargetId" } } },
+    "req:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
+    "res:GenerationBatch": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "res:GenerationSummary" } }, "request_id": { "$ref": "res:RequestId" } }, "required": ["data", "request_id"] },
+    "res:GenerationSummary": { "allOf": [{ "$ref": "res:Generation" }] },
+    "res:Generation": { "type": "object", "properties": { "id": { "$ref": "res:GenerationId" }, "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "spec_revision_id": { "anyOf": [{ "$ref": "res:SpecRevisionId" }, { "type": "null" }] }, "status": { "$ref": "res:GenerationStatus" }, "trigger": { "$ref": "res:GenerationTrigger" }, "target_id": { "anyOf": [{ "$ref": "res:TargetId" }, { "type": "null" }] }, "type": { "$ref": "res:GeneratorKind" }, "name": { "type": ["string", "null"] }, "version": { "type": ["string", "null"] }, "warnings": { "type": "array", "items": { "$ref": "res:GenerationWarning" } }, "coverage": { "anyOf": [{ "$ref": "res:GenerationCoverage" }, { "type": "null" }] }, "file_count": { "type": "integer", "minimum": 0 }, "errors": { "type": "array", "items": { "$ref": "res:DomainError" } }, "runtime_ms": { "type": ["integer", "null"], "minimum": 0 }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": ["id", "object", "project_id", "spec_revision_id", "status", "trigger", "target_id", "type", "name", "version", "warnings", "coverage", "file_count", "errors", "runtime_ms", "created_at", "updated_at"] },
     "res:GenerationId": { "type": "string", "pattern": "^gen_[a-z0-9]{16}$" },
+    "res:SpecRevisionId": { "type": "string", "pattern": "^srev_[a-z0-9]{16}$" },
     "res:GenerationStatus": { "type": "string" },
     "res:GenerationTrigger": { "type": "string" },
     "res:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
-    "res:GenerationProvenance": { "type": "object", "properties": { "generator_edition": { "type": "string" }, "resolved_config": { "anyOf": [{ "$ref": "res:ConfigResponse" }, { "type": "null" }] }, "package_version": { "type": ["string", "null"] } }, "required": ["generator_edition", "resolved_config", "package_version"] },
-    "res:ConfigResponse": { "type": "object", "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "res:RetryTuningResponse" }, "pagination": { "type": "object" }, "graphql": { "$ref": "res:GraphqlSettingsResponse" }, "auth": { "$ref": "res:AuthenticationConfigResponse" }, "cli": { "$ref": "res:CliBehaviorResponse" }, "mcp": { "$ref": "res:McpBehaviorResponse" }, "readme": { "$ref": "res:ReadmeBehaviorResponse" }, "package": { "$ref": "res:PackageBehaviorResponse" }, "docs_url": { "type": ["string", "null"] }, "docs_index_url": { "type": ["string", "null"] } } },
-    "res:GraphqlSettingsResponse": { "type": "object", "properties": { "endpoint": { "type": "string" }, "environments": { "type": "array", "maxItems": 10, "items": { "type": "object", "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" } } },
+    "res:GeneratorKind": { "type": "string" },
     "res:DomainError": { "allOf": [{ "$ref": "res:ErrorDetail" }, { "type": "object", "properties": { "phase": { "$ref": "res:FailurePhase" } }, "required": ["phase"] }] },
     "res:ErrorDetail": { "type": "object", "properties": { "type": { "$ref": "res:ErrorType" }, "code": { "$ref": "res:ErrorCode" }, "phase": { "$ref": "res:FailurePhase" }, "target_id": { "$ref": "res:TargetId" }, "field": { "type": "string" }, "in": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" }, "suggested_action": { "type": "string" }, "docs_url": { "type": "string" } }, "required": ["type", "code", "message", "retryable", "suggested_action", "docs_url"] },
     "res:ErrorType": { "type": "string" },
     "res:ErrorCode": { "type": "string" },
     "res:FailurePhase": { "type": "string" },
-    "req:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
-    "req:GenerateProjectRequest": { "type": "object", "additionalProperties": false, "properties": { "target_id": { "$ref": "req:TargetId" } } },
-    "res:GenerationBatch": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "res:GenerationSummary" } }, "request_id": { "$ref": "res:RequestId" } }, "required": ["data", "request_id"] },
-    "res:Definition": { "type": "object", "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:DefinitionPatchResponse" } }, "graphql": { "anyOf": [{ "$ref": "res:GraphqlSettingsResponse" }, { "type": "null" }] }, "diagnostic_policy": { "$ref": "res:DiagnosticPolicyResponse" }, "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" }], "responseDiscriminator": { "propertyName": "kind", "mapping": { "url": { "$ref": "res:UrlDefinitionSource" }, "repository": { "$ref": "res:RepositoryDefinitionSource" } } } },
-    "res:UrlDefinitionSource": { "type": "object", "properties": { "kind": { "type": "string" }, "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://" }, "headers_configured": { "type": "boolean" } }, "required": ["kind", "url", "headers_configured"] },
-    "res:RepositoryDefinitionSource": { "type": "object", "properties": { "kind": { "type": "string" }, "repository": { "$ref": "res:RepositoryReferenceResponse" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*\\.\\.).+$" } }, "required": ["kind", "repository", "path"] },
-    "req:DefinitionId": { "type": "string", "pattern": "^def_[a-z0-9]{16}$" },
-    "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:Spec": { "type": "object", "properties": { "id": { "$ref": "res:SpecId" }, "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "source": { "$ref": "res:SpecSource" }, "format": { "type": ["string", "null"] }, "patches": { "type": "array", "items": { "$ref": "res:SpecPatchResponse" } }, "graphql": { "anyOf": [{ "$ref": "res:GraphqlSettingsResponse" }, { "type": "null" }] }, "diagnostic_policy": { "$ref": "res:DiagnosticPolicyResponse" }, "revision_latest_id": { "anyOf": [{ "$ref": "res:SpecRevisionId" }, { "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", "revision_latest_id", "created_at", "updated_at", "request_id"] },
+    "res:SpecSource": { "anyOf": [{ "$ref": "res:UrlSpecSource" }, { "$ref": "res:RepositorySpecSource" }], "responseDiscriminator": { "propertyName": "type", "mapping": { "url": { "$ref": "res:UrlSpecSource" }, "repository": { "$ref": "res:RepositorySpecSource" } } } },
+    "res:UrlSpecSource": { "type": "object", "properties": { "type": { "type": "string" }, "url": { "$ref": "res:UrlSpecSourceSettings" } }, "required": ["type", "url"] },
+    "res:UrlSpecSourceSettings": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://" }, "headers_configured": { "type": "boolean" } }, "required": ["url", "headers_configured"] },
+    "res:RepositorySpecSource": { "type": "object", "properties": { "type": { "type": "string" }, "repository": { "$ref": "res:RepositorySpecSourceSettings" } }, "required": ["type", "repository"] },
+    "res:RepositorySpecSourceSettings": { "type": "object", "properties": { "provider": { "$ref": "res:RepositoryProvider" }, "identifier": { "$ref": "res:RepositoryIdentifier" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*\\.\\.).+$" } }, "required": ["provider", "identifier", "path"] },
+    "res:RepositoryProvider": { "type": "string" },
+    "res:RepositoryIdentifier": { "type": "string", "maxLength": 512 },
+    "res:SpecPatchResponse": { "type": "object", "properties": { "op": { "type": "string" }, "path": { "type": "string" }, "value": {}, "to": { "type": ["string", "null"] }, "reason": { "type": ["string", "null"] } }, "required": ["op", "path"] },
+    "res:GraphqlSettingsResponse": { "type": "object", "properties": { "endpoint": { "type": "string" }, "environments": { "type": "array", "maxItems": 10, "items": { "type": "object", "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" } } },
+    "res:DiagnosticPolicyResponse": { "type": "object", "properties": { "fail_on": { "type": "string" }, "only_new": { "type": "boolean" }, "suppressions": { "type": "array", "maxItems": 100, "items": { "$ref": "res:DiagnosticSuppressionResponse" } } }, "required": ["fail_on", "only_new", "suppressions"] },
+    "res:DiagnosticSuppressionResponse": { "type": "object", "properties": { "rule_id": { "type": "string", "maxLength": 160 }, "path": { "type": "string", "maxLength": 4096 }, "reason": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": ["rule_id", "reason"] },
+    "req:SpecId": { "type": "string", "pattern": "^spec_[a-z0-9]{16}$" },
+    "req:SpecUpdateRequest": { "type": "object", "additionalProperties": false, "properties": { "source": { "$ref": "req:SpecSourceInput" }, "patches": { "type": "array", "maxItems": 50, "items": { "$ref": "req:SpecPatch" } }, "graphql": { "anyOf": [{ "$ref": "req:GraphqlSettings" }, { "type": "null" }] }, "diagnostic_policy": { "$ref": "req:DiagnosticPolicy" } } },
+    "res:SpecRevisionList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:SpecRevision" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res:SpecRevision": { "type": "object", "properties": { "id": { "$ref": "res:SpecRevisionId" }, "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "spec_id": { "$ref": "res:SpecId" }, "format": { "type": "string" }, "file_count": { "type": "integer", "minimum": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 0 }, "source": { "anyOf": [{ "$ref": "res:SpecRevisionSource" }, { "type": "null" }] }, "diagnostic_summary": { "$ref": "res:DiagnosticSummary" }, "diagnostics": { "type": "array", "items": { "$ref": "res:Diagnostic" } }, "patch_diagnostics": { "type": "array", "items": { "$ref": "res:DiagnosticWarning" } }, "created_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "project_id", "spec_id", "format", "file_count", "sha256", "size_bytes", "source", "created_at"] },
+    "res:SpecRevisionSource": { "anyOf": [{ "$ref": "res:UrlSpecRevisionSource" }, { "$ref": "res:RepositorySpecRevisionSource" }], "responseDiscriminator": { "propertyName": "type", "mapping": { "url": { "$ref": "res:UrlSpecRevisionSource" }, "repository": { "$ref": "res:RepositorySpecRevisionSource" } } } },
+    "res:UrlSpecRevisionSource": { "type": "object", "properties": { "type": { "type": "string" }, "url": { "type": "object", "properties": { "url": { "type": "string" } }, "required": ["url"] } }, "required": ["type", "url"] },
+    "res:RepositorySpecRevisionSource": { "type": "object", "properties": { "type": { "type": "string" }, "repository": { "type": "object", "properties": { "provider": { "$ref": "res:RepositoryProvider" }, "identifier": { "$ref": "res:RepositoryIdentifier" }, "path": { "type": "string" }, "ref": { "type": ["string", "null"] }, "commit_sha": { "type": ["string", "null"] } }, "required": ["provider", "identifier", "path"] } }, "required": ["type", "repository"] },
+    "res:DiagnosticSummary": { "type": "object", "properties": { "status": { "type": "string" }, "error_count": { "type": "integer", "minimum": 0 }, "warning_count": { "type": "integer", "minimum": 0 }, "suggestion_count": { "type": "integer", "minimum": 0 }, "blocking_count": { "type": "integer", "minimum": 0 }, "baseline_spec_revision_id": { "anyOf": [{ "$ref": "res:SpecRevisionId" }, { "type": "null" }] } }, "required": ["status", "error_count", "warning_count", "suggestion_count", "blocking_count", "baseline_spec_revision_id"] },
+    "res:Diagnostic": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "blocking": { "type": "boolean" }, "introduced": { "type": "boolean" }, "severity": { "type": "string" }, "category": { "type": "string" }, "title": { "type": "string" }, "message": { "type": "string" }, "surfaces": { "type": "array", "items": { "type": "string" } }, "owner_decision_required": { "type": "boolean" }, "locations": { "type": "array", "minItems": 1, "items": { "$ref": "res:DiagnosticLocation" } }, "fix": { "$ref": "res:DiagnosticFix" }, "authoring_brief": { "type": "string" } }, "required": ["id", "object", "severity", "category", "title", "message", "surfaces", "owner_decision_required", "blocking", "introduced", "locations", "authoring_brief"] },
+    "res:DiagnosticLocation": { "type": "object", "properties": { "file_path": { "type": "string" }, "file_id": { "$ref": "res:FileId" }, "path": { "type": "string" }, "operation": { "type": "string" }, "evidence": { "type": "string" } }, "required": ["path"] },
+    "res:FileId": { "type": "string", "pattern": "^file_[a-z0-9]{16}$" },
+    "res:DiagnosticFix": { "type": "object", "properties": { "title": { "type": "string" }, "type": { "type": "string" }, "patches": { "type": "array", "items": { "$ref": "res:SpecPatchResponse" } }, "instructions": { "type": "string" } }, "required": ["title", "type"] },
+    "res:DiagnosticWarning": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"] },
+    "res:SpecRevisionResponse": { "allOf": [{ "$ref": "res:SpecRevision" }, { "$ref": "res:ResponseMetadata" }] },
+    "res:ResponseMetadata": { "type": "object", "properties": { "request_id": { "$ref": "res:RequestId" } }, "required": ["request_id"] },
+    "req:SpecRevisionId": { "type": "string", "pattern": "^srev_[a-z0-9]{16}$" },
+    "res:SpecRevisionFileList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:SpecRevisionFile" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res:SpecRevisionFile": { "allOf": [{ "$ref": "res:File" }, { "type": "object", "properties": { "role": { "type": "string" } }, "required": ["role"] }] },
+    "res:File": { "type": "object", "properties": { "id": { "$ref": "res:FileId" }, "object": { "type": "string" }, "path": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "encoding": { "type": "string" }, "mode": { "anyOf": [{ "$ref": "res:GitFileMode" }, { "type": "null" }] }, "created_at": { "type": "string" } }, "required": ["id", "object", "path", "size_bytes", "sha256", "encoding", "mode", "created_at"] },
+    "res:GitFileMode": { "type": "string" },
     "res:TargetList": { "type": "object", "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", "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" }, "dependency": { "anyOf": [{ "$ref": "res:TargetDependency" }, { "type": "null" }] }, "state": { "type": "string" }, "edition": { "type": "string" }, "release_channel": { "type": "string" }, "version_policy": { "type": "object", "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"] }, "checks": { "$ref": "res:TargetChecksResponse" }, "config": { "anyOf": [{ "$ref": "res:TargetConfigResponse" }, { "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", "dependency", "state", "edition", "release_channel", "version_policy", "current_version", "proposed_version", "proposed_version_source", "checks", "config", "deliveries", "created_at", "updated_at"] },
-    "res:TargetDependency": { "type": "object", "properties": { "kind": { "type": "string" }, "target_id": { "$ref": "res:TargetId" } }, "required": ["kind", "target_id"] },
+    "res:Target": { "type": "object", "properties": { "id": { "$ref": "res:TargetId" }, "object": { "type": "string" }, "project_id": { "$ref": "res:ProjectId" }, "spec_id": { "$ref": "res:SpecId" }, "name": { "type": "string" }, "type": { "$ref": "res:GeneratorKind" }, "dependency": { "anyOf": [{ "$ref": "res:TargetDependency" }, { "type": "null" }] }, "status": { "type": "string" }, "release_channel": { "type": "string" }, "version_current": { "type": ["string", "null"] }, "draft_id": { "$ref": "res:DraftId" }, "checks": { "$ref": "res:TargetChecksResponse" }, "config": { "anyOf": [{ "$ref": "res:TargetConfigResponse" }, { "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", "spec_id", "name", "type", "dependency", "status", "release_channel", "version_current", "draft_id", "checks", "config", "deliveries", "created_at", "updated_at"] },
+    "res:TargetDependency": { "type": "object", "properties": { "type": { "type": "string" }, "target_id": { "$ref": "res:TargetId" } }, "required": ["type", "target_id"] },
+    "res:DraftId": { "type": "string", "pattern": "^drf_[a-z0-9]{16}$" },
     "res:TargetChecksResponse": { "type": "object", "properties": { "generated": { "type": "array", "items": { "type": "string" } }, "repository_required": { "type": "array", "maxItems": 50, "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "customer": { "type": "array", "maxItems": 20, "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "command": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": ["name", "command"] } } } },
-    "res:TargetConfigResponse": { "type": "object", "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "res:RetryTuningResponse" }, "pagination": { "type": "object" }, "auth": { "$ref": "res:TargetAuthenticationConfigResponse" }, "cli": { "$ref": "res:CliBehaviorResponse" }, "mcp": { "$ref": "res:McpBehaviorResponse" }, "readme": { "$ref": "res:ReadmeBehaviorResponse" }, "package": { "$ref": "res:PackageBehaviorResponse" }, "docs_url": { "type": ["string", "null"] }, "docs_index_url": { "type": ["string", "null"] } } },
+    "res:TargetConfigResponse": { "type": "object", "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "retries": { "$ref": "res:RetryTuningResponse" }, "pagination": { "type": "object" }, "auth": { "$ref": "res:TargetAuthenticationConfigResponse" }, "cli": { "$ref": "res:TargetCliBehaviorResponse" }, "mcp": { "$ref": "res:McpBehaviorResponse" }, "readme": { "$ref": "res:ReadmeBehaviorResponse" }, "package": { "$ref": "res:PackageBehaviorResponse" }, "docs_url": { "type": ["string", "null"] }, "docs_index_url": { "type": ["string", "null"] } } },
     "res:TargetAuthenticationConfigResponse": { "type": "object", "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" }], "responseDiscriminator": { "propertyName": "kind", "mapping": { "repository": { "$ref": "res:RepositoryDelivery" }, "hosted_mcp": { "$ref": "res:HostedMcpDelivery" } } } },
-    "res:RepositoryDelivery": { "type": "object", "properties": { "id": { "$ref": "res:DeliveryId" }, "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "kind": { "type": "string" }, "state": { "type": "string" }, "repository": { "$ref": "res:RepositoryReferenceResponse" }, "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:TargetCliBehaviorResponse": { "type": "object", "properties": { "command_name": { "type": ["string", "null"] }, "update_notice": { "type": "boolean" }, "changelog_url": { "type": ["string", "null"] }, "support_url": { "type": ["string", "null"] }, "mcp_url": { "type": ["string", "null"] }, "skills_repo": { "type": ["string", "null"] }, "relay": { "type": "boolean" } } },
+    "res:Delivery": { "anyOf": [{ "$ref": "res:RepositoryDelivery" }, { "$ref": "res:HostedMcpDelivery" }], "responseDiscriminator": { "propertyName": "type", "mapping": { "repository": { "$ref": "res:RepositoryDelivery" }, "hosted_mcp": { "$ref": "res:HostedMcpDelivery" } } } },
+    "res:RepositoryDelivery": { "type": "object", "properties": { "id": { "$ref": "res:DeliveryId" }, "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "type": { "type": "string" }, "status": { "type": "string" }, "repository": { "$ref": "res:RepositoryDeliverySettings" }, "issues": { "type": "array", "items": { "$ref": "res:RepositoryDeliveryIssue" } }, "required_checks": { "type": "array", "items": { "type": "string" } }, "last_event": { "anyOf": [{ "$ref": "res:RepositoryDeliveryEvent" }, { "type": "null" }] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": ["id", "object", "target_id", "type", "status", "repository", "issues", "required_checks", "last_event", "created_at", "updated_at"] },
     "res:DeliveryId": { "type": "string", "pattern": "^dlv_[a-z0-9]{16}$" },
-    "res:HostedMcpDelivery": { "type": "object", "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"] }, "checks": { "$ref": "req:TargetChecks" }, "config": { "anyOf": [{ "$ref": "req:TargetConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "maxItems": 2, "items": { "$ref": "req:DeliveryInput" } } }, "required": ["name", "definition_id", "generator"] },
+    "res:RepositoryDeliverySettings": { "type": "object", "properties": { "provider": { "$ref": "res:RepositoryProvider" }, "identifier": { "$ref": "res:RepositoryIdentifier" }, "directory": { "type": ["string", "null"] }, "package_name": { "type": ["string", "null"] }, "module_path": { "type": ["string", "null"] }, "publish_on_merge": { "type": "boolean" } }, "required": ["provider", "identifier", "directory", "package_name", "module_path", "publish_on_merge"] },
+    "res:RepositoryDeliveryIssue": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"] },
+    "res:RepositoryDeliveryEvent": { "type": "object", "properties": { "event": { "type": "string" }, "status": { "type": "string" }, "created_at": { "type": "string" } }, "required": ["event", "status", "created_at"] },
+    "res:HostedMcpDelivery": { "type": "object", "properties": { "id": { "$ref": "res:DeliveryId" }, "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "type": { "type": "string" }, "status": { "type": "string" }, "hosted_mcp": { "$ref": "res:HostedMcpDeliverySettings" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": ["id", "object", "target_id", "type", "status", "hosted_mcp", "created_at", "updated_at"] },
+    "res:HostedMcpDeliverySettings": { "type": "object", "properties": { "url": { "type": ["string", "null"] } }, "required": ["url"] },
+    "req:TargetCreateRequest": { "type": "object", "additionalProperties": false, "properties": { "project_id": { "$ref": "req:ProjectId" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "spec_id": { "$ref": "req:SpecId" }, "type": { "$ref": "req:GeneratorKind" }, "status": { "type": "string", "enum": ["active", "disabled"] }, "release_channel": { "type": "string", "enum": ["stable", "prerelease"] }, "checks": { "$ref": "req:TargetChecks" }, "config": { "anyOf": [{ "$ref": "req:TargetConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "maxItems": 2, "items": { "$ref": "req:DeliveryInput" } } }, "required": ["project_id", "name", "spec_id", "type"] },
     "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", "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"] }, "checks": { "$ref": "req:TargetChecks" }, "config": { "anyOf": [{ "$ref": "req:TargetConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "maxItems": 2, "items": { "$ref": "req:DeliveryInput" } } } },
-    "res:TargetReleaseList": { "type": "object", "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", "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:RepositoryReferenceResponse" }, { "type": "null" }] }, "definition_revision_id": { "anyOf": [{ "$ref": "res:DefinitionRevisionId" }, { "type": "null" }] }, "delivery_revision": { "type": "string" }, "source_digest": { "type": ["string", "null"] }, "checks": { "type": "array", "items": { "$ref": "res:PackageCheck" } }, "accepted_risks": { "type": "array", "items": { "$ref": "res:AcceptedCompatibilityRisk" } }, "import_provenance": { "type": ["object", "null"], "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", "source_digest", "checks", "accepted_risks", "import_provenance", "publications", "created_at"] },
-    "res:TargetReleaseId": { "type": "string", "pattern": "^rel_[a-z0-9]{16}$" },
-    "res:PackageCheck": { "type": "object", "properties": { "name": { "type": "string" }, "source": { "type": "string" }, "required": { "type": "boolean" }, "state": { "type": "string" }, "reason": { "type": "string" }, "revision": { "type": "string" }, "url": { "type": ["string", "null"] }, "observed_at": { "type": ["string", "null"] } }, "required": ["name", "source", "required", "state", "reason", "revision", "url", "observed_at"] },
-    "res:AcceptedCompatibilityRisk": { "type": "object", "properties": { "comparison": { "type": "string" }, "reason": { "type": "string" }, "approved_by": { "type": "string" }, "approved_revision": { "type": "string" }, "approved_at": { "type": "string" } }, "required": ["comparison", "reason", "approved_by", "approved_revision", "approved_at"] },
-    "res:Publication": { "type": "object", "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"] }, "errors": { "type": "array", "items": { "$ref": "res:DomainError" } }, "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", "errors", "started_at", "finished_at", "updated_at"] },
+    "req:TargetUpdateRequest": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "status": { "type": "string", "enum": ["active", "disabled"] }, "release_channel": { "type": "string", "enum": ["stable", "prerelease"] }, "checks": { "$ref": "req:TargetChecks" }, "config": { "anyOf": [{ "$ref": "req:TargetConfig" }, { "type": "null" }] }, "deliveries": { "type": "array", "maxItems": 2, "items": { "$ref": "req:DeliveryInput" } } } },
+    "req:TargetAdoption": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": "string" }, "tag": { "type": "string", "minLength": 1, "maxLength": 255 } }, "required": ["version", "tag"] },
+    "res:ReleaseResponse": { "allOf": [{ "$ref": "res:Release" }, { "$ref": "res:ResponseMetadata" }] },
+    "res:Release": { "type": "object", "properties": { "id": { "$ref": "res:ReleaseId" }, "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" }, "repository": { "anyOf": [{ "$ref": "res:RepositoryReferenceResponse" }, { "type": "null" }] }, "spec_revision_id": { "anyOf": [{ "$ref": "res:SpecRevisionId" }, { "type": "null" }] }, "commit_sha": { "type": "string", "pattern": "^[0-9a-fA-F]{40}$" }, "checks": { "type": "array", "items": { "$ref": "res:PackageCheck" } }, "approvals": { "type": "array", "items": { "$ref": "res:CompatibilityApproval" } }, "import_provenance": { "type": ["object", "null"], "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", "repository", "spec_revision_id", "commit_sha", "checks", "approvals", "import_provenance", "publications", "created_at"] },
+    "res:ReleaseId": { "type": "string", "pattern": "^rel_[a-z0-9]{16}$" },
+    "res:RepositoryReferenceResponse": { "type": "object", "properties": { "provider": { "$ref": "res:RepositoryProvider" }, "identifier": { "$ref": "res:RepositoryIdentifier" } }, "required": ["provider", "identifier"] },
+    "res:PackageCheck": { "type": "object", "properties": { "name": { "type": "string" }, "source": { "type": "string" }, "required": { "type": "boolean" }, "status": { "type": "string" }, "reason": { "type": "string" }, "commit_sha": { "type": "string" }, "url": { "type": ["string", "null"] }, "observed_at": { "type": ["string", "null"] } }, "required": ["name", "source", "required", "status", "reason", "commit_sha", "url", "observed_at"] },
+    "res:CompatibilityApproval": { "type": "object", "properties": { "source": { "type": "string" }, "reason": { "type": "string" }, "approved_by": { "type": "string" }, "approved_sha": { "type": "string" }, "approved_at": { "type": "string" } }, "required": ["source", "reason", "approved_by", "approved_sha", "approved_at"] },
+    "res:Publication": { "type": "object", "properties": { "id": { "$ref": "res:PublicationId" }, "object": { "type": "string" }, "release_id": { "$ref": "res:ReleaseId" }, "destination": { "type": "string" }, "status": { "type": "string" }, "attempt": { "type": "integer", "minimum": 0 }, "run_url": { "type": ["string", "null"] }, "registry_url": { "type": ["string", "null"] }, "artifact_digest": { "type": ["string", "null"] }, "errors": { "type": "array", "items": { "$ref": "res:DomainError" } }, "started_at": { "type": ["string", "null"] }, "finished_at": { "type": ["string", "null"] }, "runtime_ms": { "type": ["integer", "null"], "minimum": 0 }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": ["id", "object", "release_id", "destination", "status", "attempt", "run_url", "registry_url", "artifact_digest", "errors", "started_at", "finished_at", "runtime_ms", "created_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", "properties": { "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "project_id": { "$ref": "res:ProjectId" }, "status": { "$ref": "res:DraftStatus" }, "current_version": { "type": ["string", "null"] }, "version": { "type": ["string", "null"] }, "selection": { "$ref": "res:TargetDraftSelection" }, "readiness": { "anyOf": [{ "$ref": "res:TargetDraftReadiness" }, { "type": "null" }] }, "changes": { "type": ["object", "null"], "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"] }, "generation_id": { "anyOf": [{ "$ref": "res:GenerationId" }, { "type": "null" }] }, "conflicts": { "anyOf": [{ "$ref": "res:TargetDraftConflicts" }, { "type": "null" }] }, "customized_files": { "type": ["integer", "null"], "minimum": 0 }, "history_recovery": { "anyOf": [{ "$ref": "res:TargetDraftHistoryRecovery" }, { "type": "null" }] }, "request_id": { "$ref": "res:RequestId" }, "checks": { "type": "array", "items": { "$ref": "res:PackageCheck" } } }, "required": ["object", "target_id", "project_id", "status", "current_version", "version", "selection", "readiness", "checks", "changes", "head_revision", "pull_request_url", "generation_id", "conflicts", "customized_files", "history_recovery"] },
+    "res:DraftList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:Draft" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res:Draft": { "type": "object", "properties": { "id": { "$ref": "res:DraftId" }, "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "project_id": { "$ref": "res:ProjectId" }, "status": { "$ref": "res:DraftStatus" }, "reason": { "$ref": "res:DraftActionReason" }, "version_next": { "type": ["string", "null"] }, "version_source": { "type": ["string", "null"] }, "readiness": { "anyOf": [{ "$ref": "res:DraftReadiness" }, { "type": "null" }] }, "changes": { "type": ["object", "null"], "properties": { "changelog": { "type": ["string", "null"] }, "breaking_count": { "type": ["integer", "null"], "minimum": 0 }, "version_previous": { "type": ["string", "null"] } } }, "head_sha": { "type": ["string", "null"] }, "pull_request": { "anyOf": [{ "type": "object", "properties": { "url": { "type": "string" }, "number": { "type": "integer", "minimum": 1 } }, "required": ["url", "number"] }, { "type": "null" }] }, "generation_id": { "anyOf": [{ "$ref": "res:GenerationId" }, { "type": "null" }] }, "release_id": { "anyOf": [{ "$ref": "res:ReleaseId" }, { "type": "null" }] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "conflicts": { "anyOf": [{ "$ref": "res:DraftConflicts" }, { "type": "null" }] }, "customized_files": { "type": ["integer", "null"], "minimum": 0 }, "history_recovery": { "anyOf": [{ "$ref": "res:DraftHistoryRecovery" }, { "type": "null" }] }, "request_id": { "$ref": "res:RequestId" }, "checks": { "type": "array", "items": { "$ref": "res:PackageCheck" } } }, "required": ["id", "object", "target_id", "project_id", "status", "version_next", "version_source", "readiness", "checks", "changes", "head_sha", "pull_request", "generation_id", "release_id", "conflicts", "customized_files", "history_recovery", "created_at", "updated_at"] },
     "res:DraftStatus": { "type": "string" },
-    "res:TargetDraftSelection": { "anyOf": [{ "type": "object", "properties": { "mode": { "type": "string" } }, "required": ["mode"] }, { "type": "object", "properties": { "mode": { "type": "string" }, "version": { "type": "string" }, "source": { "type": ["string", "null"] } }, "required": ["mode", "version", "source"] }] },
-    "res:TargetDraftReadiness": { "type": "object", "properties": { "state": { "type": "string" }, "description": { "type": "string" }, "api_compatibility": { "type": "string" }, "package_compatibility": { "type": "string" }, "version_correct": { "type": ["boolean", "null"] }, "required_bump": { "type": ["string", "null"] }, "previous_version": { "type": ["string", "null"] }, "title_error": { "type": ["string", "null"] } }, "required": ["state", "description", "api_compatibility", "package_compatibility", "version_correct", "required_bump", "previous_version", "title_error"] },
-    "res:TargetDraftConflicts": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 1 }, "decided": { "type": "integer", "minimum": 0 } }, "required": ["total", "decided"] },
-    "res:TargetDraftHistoryRecovery": { "type": "object", "properties": { "default_revision": { "type": "string" }, "head_revision": { "type": ["string", "null"] }, "preserved_branch": { "type": ["string", "null"] } }, "required": ["default_revision", "head_revision", "preserved_branch"] },
-    "req:TargetDraftUpdate": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": ["string", "null"] } }, "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" }] },
-    "req:TargetReleaseId": { "type": "string", "pattern": "^rel_[a-z0-9]{16}$" },
+    "res:DraftActionReason": { "type": "string" },
+    "res:DraftReadiness": { "type": "object", "properties": { "status": { "type": "string" }, "description": { "type": "string" }, "compatibility_api": { "type": "string" }, "compatibility_package": { "type": "string" }, "version_correct": { "type": ["boolean", "null"] }, "bump_required": { "type": ["string", "null"] }, "version_previous": { "type": ["string", "null"] }, "title_error": { "type": ["string", "null"] } }, "required": ["status", "description", "compatibility_api", "compatibility_package", "version_correct", "bump_required", "version_previous", "title_error"] },
+    "res:DraftConflicts": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 1 }, "decided": { "type": "integer", "minimum": 0 } }, "required": ["total", "decided"] },
+    "res:DraftHistoryRecovery": { "type": "object", "properties": { "default_sha": { "type": "string" }, "head_sha": { "type": ["string", "null"] }, "preserved_branch": { "type": ["string", "null"] } }, "required": ["default_sha", "head_sha", "preserved_branch"] },
+    "req:DraftStatus": { "type": "string", "enum": ["none", "working", "action_required", "ready", "merged"] },
+    "res:DraftResponse": { "allOf": [{ "$ref": "res:Draft" }, { "$ref": "res:ResponseMetadata" }] },
+    "req:DraftId": { "type": "string", "pattern": "^drf_[a-z0-9]{16}$" },
+    "req:DraftUpdateRequest": { "type": "object", "additionalProperties": false, "properties": { "version_next": { "type": ["string", "null"] } }, "required": ["version_next"] },
     "res:DraftFileList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:DraftFile" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
-    "res:DraftFile": { "type": "object", "properties": { "object": { "type": "string" }, "path": { "type": "string" }, "customization": { "type": ["string", "null"] }, "conflict": { "anyOf": [{ "$ref": "res:DraftFileConflict" }, { "type": "null" }] }, "history": { "anyOf": [{ "$ref": "res:DraftFileHistory" }, { "type": "null" }] }, "sides": { "type": "array", "items": { "$ref": "res:DraftFileSideSummary" } } }, "required": ["object", "path", "customization", "conflict", "history", "sides"] },
-    "res:DraftFileConflict": { "type": "object", "properties": { "kind": { "type": "string" }, "source": { "type": "string" }, "decision": { "type": ["string", "null"] } }, "required": ["kind", "source", "decision"] },
+    "res:DraftFile": { "type": "object", "properties": { "object": { "type": "string" }, "path": { "type": "string" }, "customization": { "type": ["string", "null"] }, "conflict": { "anyOf": [{ "$ref": "res:DraftFileConflict" }, { "type": "null" }] }, "history": { "anyOf": [{ "$ref": "res:DraftFileHistory" }, { "type": "null" }] }, "sides": { "anyOf": [{ "$ref": "res:DraftFileSides" }, { "type": "null" }] } }, "required": ["object", "path", "customization", "conflict", "history", "sides"] },
+    "res:DraftFileConflict": { "type": "object", "properties": { "type": { "type": "string" }, "source": { "type": "string" }, "decision": { "type": ["string", "null"] } }, "required": ["type", "source", "decision"] },
     "res:DraftFileHistory": { "type": "object", "properties": { "change": { "type": ["string", "null"] }, "draft_differs": { "type": "boolean" } }, "required": ["change", "draft_differs"] },
-    "res:DraftFileSideSummary": { "type": "object", "properties": { "side": { "$ref": "res:DraftFileSide" }, "mode": { "$ref": "res:GitFileMode" }, "size_bytes": { "type": "integer", "minimum": 0 }, "encoding": { "type": "string" } }, "required": ["side", "mode", "size_bytes", "encoding"] },
-    "res:DraftFileSide": { "type": "string" },
-    "res:GitFileMode": { "type": "string" },
-    "res:DraftFileContentResponse": { "allOf": [{ "$ref": "res:DraftFileContent" }, { "$ref": "res:ResponseMetadata" }] },
-    "res:DraftFileContent": { "type": "object", "properties": { "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "path": { "type": "string" }, "side": { "$ref": "res:DraftFileSide" }, "encoding": { "type": "string" }, "content": { "type": "string" }, "mode": { "$ref": "res:GitFileMode" }, "size_bytes": { "type": "integer", "minimum": 0 }, "offset": { "type": "integer", "minimum": 0 }, "next_cursor": { "type": ["string", "null"] } }, "required": ["object", "target_id", "path", "side", "encoding", "content", "mode", "size_bytes", "offset", "next_cursor"] },
-    "req:DraftFileSide": { "type": "string", "enum": ["base", "repository", "incoming", "accepted", "default", "draft"] },
-    "req:ResolveDraftConflicts": { "type": "object", "additionalProperties": false, "properties": { "expected_head_revision": { "type": "string", "pattern": "^[0-9a-fA-F]{40}$" }, "resolutions": { "type": "array", "minItems": 1, "maxItems": 1000, "items": { "$ref": "req:DraftConflictDecision" } }, "dry_run": { "type": "boolean" } }, "required": ["expected_head_revision", "resolutions"] },
-    "req:DraftConflictDecision": { "anyOf": [{ "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "enum": ["repository", "incoming"] } }, "required": ["path", "keep"] }, { "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "const": "content" }, "content": { "type": "string" }, "mode": { "$ref": "req:GitFileMode" } }, "required": ["path", "keep", "content", "mode"] }, { "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "const": "content" }, "content_base64": { "type": "string" }, "mode": { "$ref": "req:GitFileMode" } }, "required": ["path", "keep", "content_base64", "mode"] }, { "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "const": "content" }, "content": { "type": "null" } }, "required": ["path", "keep", "content"] }] },
+    "res:DraftFileSides": { "type": "object", "properties": { "base": { "anyOf": [{ "$ref": "res:FileId" }, { "type": "null" }] }, "yours": { "anyOf": [{ "$ref": "res:FileId" }, { "type": "null" }] }, "generated": { "anyOf": [{ "$ref": "res:FileId" }, { "type": "null" }] } }, "required": ["base", "yours", "generated"] },
+    "req:DraftResolveRequest": { "type": "object", "additionalProperties": false, "properties": { "expected_head_sha": { "type": "string", "pattern": "^[0-9a-fA-F]{40}$" }, "resolutions": { "type": "array", "minItems": 1, "maxItems": 1000, "items": { "$ref": "req:DraftConflictDecision" } } }, "required": ["expected_head_sha", "resolutions"] },
+    "req:DraftConflictDecision": { "anyOf": [{ "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "enum": ["yours", "generated"] } }, "required": ["path", "keep"] }, { "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "const": "content" }, "content": { "type": "string" }, "mode": { "$ref": "req:GitFileMode" } }, "required": ["path", "keep", "content", "mode"] }, { "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "const": "content" }, "content_base64": { "type": "string" }, "mode": { "$ref": "req:GitFileMode" } }, "required": ["path", "keep", "content_base64", "mode"] }, { "type": "object", "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "keep": { "type": "string", "const": "content" }, "content": { "type": "null" } }, "required": ["path", "keep", "content"] }] },
     "req:GitFileMode": { "type": "string", "enum": ["100644", "100755", "120000"] },
-    "res:DraftConflictResolutionResponse": { "allOf": [{ "$ref": "res:DraftConflictResolution" }, { "$ref": "res:ResponseMetadata" }] },
-    "res:DraftConflictResolution": { "type": "object", "properties": { "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "head_revision": { "type": "string" }, "status": { "type": "string" }, "files": { "type": "array", "maxItems": 1000, "items": { "$ref": "res:DraftPlannedFile" } }, "remaining_conflicts": { "type": "integer", "minimum": 0 } }, "required": ["object", "target_id", "head_revision", "status", "files", "remaining_conflicts"] },
-    "res:DraftPlannedFile": { "type": "object", "properties": { "path": { "type": "string" }, "action": { "type": "string" }, "mode": { "anyOf": [{ "$ref": "res:GitFileMode" }, { "type": "null" }] }, "size_bytes": { "type": ["integer", "null"], "minimum": 0 } }, "required": ["path", "action", "mode", "size_bytes"] },
-    "req:DiscardDraftCustomizations": { "type": "object", "additionalProperties": false, "properties": { "expected_head_revision": { "type": "string", "pattern": "^[0-9a-fA-F]{40}$" }, "paths": { "type": "array", "minItems": 1, "maxItems": 1000, "items": { "type": "string", "minLength": 1 } }, "dry_run": { "type": "boolean" } }, "required": ["expected_head_revision", "paths"] },
-    "res:DraftCustomizationDiscardResponse": { "allOf": [{ "$ref": "res:DraftCustomizationDiscard" }, { "$ref": "res:ResponseMetadata" }] },
-    "res:DraftCustomizationDiscard": { "type": "object", "properties": { "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "head_revision": { "type": "string" }, "status": { "type": "string" }, "files": { "type": "array", "maxItems": 1000, "items": { "$ref": "res:DraftPlannedFile" } } }, "required": ["object", "target_id", "head_revision", "status", "files"] },
-    "req:RecoverDraftHistory": { "type": "object", "additionalProperties": false, "properties": { "expected_default_revision": { "type": "string", "pattern": "^[a-fA-F0-9]{40}$" }, "expected_head_revision": { "type": ["string", "null"], "pattern": "^[a-fA-F0-9]{40}$" } }, "required": ["expected_default_revision", "expected_head_revision"] },
-    "res:DraftHistoryRecoveryResponse": { "allOf": [{ "$ref": "res:DraftHistoryRecovery" }, { "$ref": "res:ResponseMetadata" }] },
-    "res:DraftHistoryRecovery": { "type": "object", "properties": { "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "status": { "type": "string" }, "default_revision": { "type": "string" }, "head_revision": { "type": ["string", "null"] }, "preserved_branch": { "type": ["string", "null"] } }, "required": ["object", "target_id", "status", "default_revision", "head_revision", "preserved_branch"] },
-    "res:DeliveryResponse": { "type": "object", "properties": { "id": { "$ref": "res:DeliveryId" }, "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "kind": { "type": "string" }, "state": { "type": "string" }, "repository": { "$ref": "res:RepositoryReferenceResponse" }, "directory": { "type": ["string", "null"] }, "package_name": { "type": ["string", "null"] }, "module_path": { "type": ["string", "null"] }, "publish_on_merge": { "type": "boolean" }, "url": { "type": ["string", "null"] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "target_id", "kind", "state", "created_at", "updated_at", "request_id"] },
+    "req:DraftRecoverRequest": { "type": "object", "additionalProperties": false, "properties": { "expected_default_sha": { "type": "string", "pattern": "^[a-fA-F0-9]{40}$" }, "expected_head_sha": { "type": ["string", "null"], "pattern": "^[a-fA-F0-9]{40}$" } }, "required": ["expected_default_sha", "expected_head_sha"] },
+    "res:ReleaseList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:Release" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "req:ReleaseId": { "type": "string", "pattern": "^rel_[a-z0-9]{16}$" },
+    "res:DeliveryList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:Delivery" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res:DeliveryResponse": { "type": "object", "properties": { "id": { "$ref": "res:DeliveryId" }, "object": { "type": "string" }, "target_id": { "$ref": "res:TargetId" }, "type": { "type": "string" }, "status": { "type": "string" }, "repository": { "$ref": "res:RepositoryDeliverySettings" }, "issues": { "type": "array", "items": { "$ref": "res:RepositoryDeliveryIssue" } }, "required_checks": { "type": "array", "items": { "type": "string" } }, "last_event": { "anyOf": [{ "$ref": "res:RepositoryDeliveryEvent" }, { "type": "null" }] }, "hosted_mcp": { "$ref": "res:HostedMcpDeliverySettings" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "target_id", "type", "status", "created_at", "updated_at", "request_id"] },
     "req:DeliveryId": { "type": "string", "pattern": "^dlv_[a-z0-9]{16}$" },
-    "res:PublicationResponse": { "allOf": [{ "$ref": "res:Publication" }, { "type": "object", "properties": { "created_at": { "type": "string" } }, "required": ["created_at"] }, { "$ref": "res:ResponseMetadata" }] },
+    "res:PublicationList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:Publication" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res:PublicationResponse": { "allOf": [{ "$ref": "res:Publication" }, { "$ref": "res:ResponseMetadata" }] },
     "req:PublicationId": { "type": "string", "pattern": "^pub_[a-z0-9]{16}$" },
+    "res:GenerationList": { "type": "object", "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"] },
+    "req:GenerationStatus": { "type": "string", "enum": ["queued", "running", "completed", "failed"] },
     "res:GenerationResponse": { "allOf": [{ "$ref": "res:Generation" }, { "$ref": "res:ResponseMetadata" }] },
-    "res:Generation": { "type": "object", "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" } }, "errors": { "type": "array", "items": { "$ref": "res:DomainError" } }, "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", "errors", "created_at"] },
-    "res:FileStub": { "type": "object", "properties": { "path": { "type": "string" }, "bytes": { "type": "integer" }, "mode": { "type": "string" } }, "required": ["path", "bytes", "mode"] },
     "req:GenerationId": { "type": "string", "pattern": "^gen_[a-z0-9]{16}$" },
-    "res:DefinitionRevisionList": { "type": "object", "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", "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", "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"] },
-    "res:DefinitionDocumentId": { "type": "string", "pattern": "^doc_[a-z0-9]{16}$" },
-    "res:DefinitionRevisionSource": { "anyOf": [{ "$ref": "res:UrlDefinitionRevisionSource" }, { "$ref": "res:RepositoryDefinitionRevisionSource" }], "responseDiscriminator": { "propertyName": "kind", "mapping": { "url": { "$ref": "res:UrlDefinitionRevisionSource" }, "repository": { "$ref": "res:RepositoryDefinitionRevisionSource" } } } },
-    "res:UrlDefinitionRevisionSource": { "type": "object", "properties": { "kind": { "type": "string" }, "url": { "type": "string" } }, "required": ["kind", "url"] },
-    "res:RepositoryDefinitionRevisionSource": { "type": "object", "properties": { "kind": { "type": "string" }, "repository": { "$ref": "res:RepositoryReferenceResponse" }, "path": { "type": "string" }, "ref": { "type": ["string", "null"] }, "commit_sha": { "type": ["string", "null"] } }, "required": ["kind", "repository", "path"] },
-    "res:DefinitionRevisionResponse": { "allOf": [{ "$ref": "res:DefinitionRevision" }, { "$ref": "res:ResponseMetadata" }] },
-    "req:DefinitionRevisionId": { "type": "string", "pattern": "^drev_[a-z0-9]{16}$" },
-    "req:DefinitionDocumentId": { "type": "string", "pattern": "^doc_[a-z0-9]{16}$" },
-    "res:DefinitionDocumentResponse": { "type": "object", "properties": { "id": { "$ref": "res:DefinitionDocumentId" }, "object": { "type": "string" }, "definition_revision_id": { "$ref": "res:DefinitionRevisionId" }, "role": { "type": "string" }, "coordinate": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "definition_revision_id", "role", "coordinate", "sha256", "size_bytes", "created_at", "request_id"] },
-    "res:Account": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^org_[A-Za-z0-9]+$" }, "object": { "type": "string" }, "name": { "type": "string" }, "plan": { "type": "string" }, "created_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "name", "plan", "created_at", "request_id"] },
+    "res:FileList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:File" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res:FileResponse": { "allOf": [{ "$ref": "res:File" }, { "type": "object", "properties": { "content": { "type": "string" }, "offset": { "type": "integer", "minimum": 0 }, "next_cursor": { "type": ["string", "null"] } }, "required": ["content", "offset", "next_cursor"] }, { "$ref": "res:ResponseMetadata" }] },
+    "req:FileId": { "type": "string", "pattern": "^file_[a-z0-9]{16}$" },
+    "res:Organization": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "name": { "type": "string" }, "plan": { "type": "string" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "name", "plan", "created_at", "updated_at", "request_id"] },
     "res:ApiKeyList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:ApiKey" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
-    "res:ApiKey": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "name": { "type": "string" }, "last4": { "type": "string" }, "revoked": { "type": "boolean" }, "last_used_at": { "type": ["string", "null"] }, "created_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "name", "last4", "revoked", "last_used_at", "created_at"] },
+    "res:ApiKey": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "name": { "type": "string" }, "last4": { "type": "string" }, "revoked": { "type": "boolean" }, "last_used_at": { "type": ["string", "null"] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "name", "last4", "revoked", "last_used_at", "created_at", "updated_at"] },
     "res:ApiKeyResponse": { "allOf": [{ "$ref": "res:ApiKey" }, { "$ref": "res:ResponseMetadata" }] },
 };