@typeship-ax/mcp 0.21.0 → 0.23.0

package/dist/schemas.js

@@ -1,17 +1,15 @@
-// typeship — schema tables for optional runtime validation.
-// Generated by typeship — https://typeship.dev
+// Typeship — schema tables for optional runtime validation.
+// Generated by Typeship — https://typeship.dev
 // Consumed by core/http.ts when the client's validate option is enabled;
 // carries no code, only data derived from the spec. Named components are
 // deduplicated into DEFS and referenced by "req:Name", "res:Name", or
 // "gql-res:Name" keys. GraphQL response definitions permit partial selections.
 export const SCHEMAS = {
-    "generate.run": { "req": { "$ref": "req:GenerateRequest" }, "res": { "$ref": "res:GenerationResult" } },
-    "generate.downloadPackage": { "res": { "type": "string" } },
+    "projects.create": { "req": { "$ref": "req:CreateProjectRequest" }, "res": { "$ref": "res:ProjectResponse" } },
     "projects.list": { "res": { "$ref": "res:ProjectList" } },
-    "projects.create": { "req": { "$ref": "req:CreateProjectRequest" }, "res": { "$ref": "res:Project" } },
-    "projects.get": { "res": { "$ref": "res:Project" } },
+    "projects.get": { "res": { "$ref": "res:ProjectResponse" } },
+    "projects.update": { "req": { "$ref": "req:UpdateProjectRequest" }, "res": { "$ref": "res:ProjectResponse" } },
     "projects.delete": { "res": { "$ref": "res:DeletedProject" } },
-    "projects.update": { "req": { "$ref": "req:UpdateProjectRequest" }, "res": { "$ref": "res:Project" } },
     "projects.generate": { "req": { "$ref": "req:GenerateProjectRequest" }, "res": { "$ref": "res:GenerationBatch" } },
     "specs.get": { "res": { "$ref": "res:Spec" } },
     "specs.update": { "req": { "$ref": "req:SpecUpdateRequest" }, "res": { "$ref": "res:Spec" } },
@@ -19,12 +17,20 @@ export const SCHEMAS = {
     "specRevisions.list": { "res": { "$ref": "res:SpecRevisionList" } },
     "specRevisions.get": { "res": { "$ref": "res:SpecRevisionResponse" } },
     "specRevisions.listFiles": { "res": { "$ref": "res:SpecRevisionFileList" } },
-    "targets.list": { "res": { "$ref": "res:TargetList" } },
     "targets.create": { "req": { "$ref": "req:TargetCreateRequest" }, "res": { "$ref": "res:TargetResponse" } },
+    "targets.list": { "res": { "$ref": "res:TargetList" } },
     "targets.get": { "res": { "$ref": "res:TargetResponse" } },
-    "targets.delete": { "res": { "$ref": "res:DeletedTarget" } },
     "targets.update": { "req": { "$ref": "req:TargetUpdateRequest" }, "res": { "$ref": "res:TargetResponse" } },
+    "targets.delete": { "res": { "$ref": "res:DeletedTarget" } },
     "targets.adopt": { "req": { "$ref": "req:TargetAdoption" }, "res": { "$ref": "res:ReleaseResponse" } },
+    "deliveries.create": { "req": { "$ref": "req:DeliveryCreateRequest" }, "res": { "$ref": "res:DeliveryResponse" } },
+    "deliveries.list": { "res": { "$ref": "res:DeliveryList" } },
+    "deliveries.get": { "res": { "$ref": "res:DeliveryResponse" } },
+    "deliveries.update": { "req": { "$ref": "req:DeliveryUpdateRequest" }, "res": { "$ref": "res:DeliveryResponse" } },
+    "deliveries.delete": { "res": { "$ref": "res:DeletedDelivery" } },
+    "generations.get": { "res": { "$ref": "res:GenerationResponse" } },
+    "generations.list": { "res": { "$ref": "res:GenerationList" } },
+    "generations.listFiles": { "res": { "$ref": "res:FileList" } },
     "drafts.list": { "res": { "$ref": "res:DraftList" } },
     "drafts.get": { "res": { "$ref": "res:DraftResponse" } },
     "drafts.update": { "req": { "$ref": "req:DraftUpdateRequest" }, "res": { "$ref": "res:DraftResponse" } },
@@ -33,48 +39,16 @@ export const SCHEMAS = {
     "drafts.recover": { "req": { "$ref": "req:DraftRecoverRequest" }, "res": { "$ref": "res:DraftResponse" } },
     "releases.list": { "res": { "$ref": "res:ReleaseList" } },
     "releases.get": { "res": { "$ref": "res:ReleaseResponse" } },
-    "releases.republish": { "res": { "$ref": "res:ReleaseResponse" } },
-    "deliveries.list": { "res": { "$ref": "res:DeliveryList" } },
-    "deliveries.get": { "res": { "$ref": "res:DeliveryResponse" } },
-    "publications.list": { "res": { "$ref": "res:PublicationList" } },
-    "publications.get": { "res": { "$ref": "res:PublicationResponse" } },
-    "generations.list": { "res": { "$ref": "res:GenerationList" } },
-    "generations.get": { "res": { "$ref": "res:GenerationResponse" } },
-    "generations.listFiles": { "res": { "$ref": "res:FileList" } },
+    "releases.retry": { "res": { "$ref": "res:ReleaseResponse" } },
     "files.get": { "res": { "$ref": "res:FileResponse" } },
+    "packages.generate": { "req": { "$ref": "req:GenerateRequest" }, "res": { "$ref": "res:GenerationResult" } },
+    "packages.download": { "res": { "type": "string" } },
     "organization.get": { "res": { "$ref": "res:Organization" } },
     "apiKeys.list": { "res": { "$ref": "res:ApiKeyList" } },
     "apiKeys.get": { "res": { "$ref": "res:ApiKeyResponse" } },
     "apiKeys.revoke": { "res": { "$ref": "res:ApiKeyResponse" } },
 };
 export const DEFS = {
-    "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" } } },
-    "req:AuthenticationConfig": { "type": "object", "additionalProperties": false, "properties": { "oauth_server": { "anyOf": [{ "$ref": "req:OAuthServer" }, { "type": "null" }] }, "oauth_applications": { "type": ["object", "null"] }, "oauth_application": { "type": ["string", "null"], "maxLength": 64, "pattern": "^[a-z][a-z0-9_-]{0,63}$" }, "identity_verification": { "anyOf": [{ "$ref": "req:IdentityVerification" }, { "type": "null" }] }, "approval_url": { "type": ["string", "null"] }, "environments": { "type": ["object", "null"] } } },
-    "req:OAuthServer": { "type": "object", "additionalProperties": false, "properties": { "issuer": { "type": ["string", "null"] }, "discovery_url": { "type": ["string", "null"] }, "authorization_url": { "type": ["string", "null"] }, "token_url": { "type": ["string", "null"] }, "device_authorization_url": { "type": ["string", "null"] }, "scopes": { "type": ["array", "null"], "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500, "pattern": "^\\S+$" } }, "audience": { "type": ["string", "null"] }, "resource": { "type": ["string", "null"] } } },
-    "req:IdentityVerification": { "allOf": [{ "type": "object", "additionalProperties": false, "properties": { "operation": { "type": ["string", "null"], "maxLength": 2000, "pattern": "^[\\w$]+\\.[\\w$]+$" }, "subject_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" }, "account_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" }, "organization_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" } } }, { "anyOf": [{ "properties": { "subject_field": { "type": "string" } }, "required": ["subject_field"], "type": "object" }, { "properties": { "account_field": { "type": "string" } }, "required": ["account_field"], "type": "object" }, { "properties": { "organization_field": { "type": "string" } }, "required": ["organization_field"], "type": "object" }] }] },
-    "req:CliBehavior": { "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"] } } },
-    "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": { "$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: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 }, "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: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" }] },
@@ -85,34 +59,50 @@ export const DEFS = {
     "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: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", "basic_api_key", "api_key", "api_key_or_bearer", "none"] }, "api_key_header": { "type": "string" }, "title": { "type": "string", "maxLength": 80 }, "scalars": { "type": "object" }, "error_types": { "type": "array", "maxItems": 100, "items": { "type": "string", "pattern": "^[_A-Za-z][_0-9A-Za-z]*$" } }, "page_size": { "type": "integer", "minimum": 1, "maximum": 1000 } } },
     "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 }, "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:GeneratorKind": { "type": "string", "enum": ["cli", "go_cli", "mcp", "typescript_sdk", "python_sdk", "go_sdk"] },
     "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: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:TargetConfig": { "type": "object", "additionalProperties": false, "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "include": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "exclude": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "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: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: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: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": { "title": { "type": ["string", "null"], "maxLength": 100 }, "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:DeliveryInput": { "anyOf": [{ "$ref": "req:RepositoryDeliveryInput" }, { "$ref": "req:HostedMcpDeliveryInput" }] },
     "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 }, "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"] } } },
+    "req:ProjectConfig": { "type": "object", "additionalProperties": false, "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "include": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "exclude": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "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"] } } },
+    "req:AuthenticationConfig": { "type": "object", "additionalProperties": false, "properties": { "oauth_server": { "anyOf": [{ "$ref": "req:OAuthServer" }, { "type": "null" }] }, "oauth_applications": { "type": ["object", "null"] }, "oauth_application": { "type": ["string", "null"], "maxLength": 64, "pattern": "^[a-z][a-z0-9_-]{0,63}$" }, "identity_verification": { "anyOf": [{ "$ref": "req:IdentityVerification" }, { "type": "null" }] }, "approval_url": { "type": ["string", "null"] }, "environments": { "type": ["object", "null"] }, "credential_variables": { "type": ["object", "null"] }, "credential_parameters": { "type": ["object", "null"] } } },
+    "req:OAuthServer": { "type": "object", "additionalProperties": false, "properties": { "issuer": { "type": ["string", "null"] }, "discovery_url": { "type": ["string", "null"] }, "authorization_url": { "type": ["string", "null"] }, "token_url": { "type": ["string", "null"] }, "device_authorization_url": { "type": ["string", "null"] }, "scopes": { "type": ["array", "null"], "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500, "pattern": "^\\S+$" } }, "audience": { "type": ["string", "null"] }, "resource": { "type": ["string", "null"] } } },
+    "req:IdentityVerification": { "allOf": [{ "type": "object", "additionalProperties": false, "properties": { "operation": { "type": ["string", "null"], "maxLength": 2000, "pattern": "^[\\w$]+\\.[\\w$]+$" }, "subject_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" }, "account_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" }, "organization_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" } } }, { "anyOf": [{ "properties": { "subject_field": { "type": "string" } }, "required": ["subject_field"], "type": "object" }, { "properties": { "account_field": { "type": "string" } }, "required": ["account_field"], "type": "object" }, { "properties": { "organization_field": { "type": "string" } }, "required": ["organization_field"], "type": "object" }] }] },
+    "req:CliBehavior": { "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"] } } },
+    "res:ProjectResponse": { "allOf": [{ "$ref": "res:Project" }, { "$ref": "res:ResponseMetadata" }] },
+    "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"] },
+    "res:ProjectId": { "type": "string", "pattern": "^prj_[a-z0-9]{16}$" },
+    "res:SpecId": { "type": "string", "pattern": "^spec_[a-z0-9]{16}$" },
+    "res:ProjectConfigResponse": { "type": "object", "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "include": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "exclude": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "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"] } } },
+    "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"] }, "credential_variables": { "type": ["object", "null"] }, "credential_parameters": { "type": ["object", "null"] } } },
     "res:OAuthServerResponse": { "type": "object", "properties": { "issuer": { "type": ["string", "null"] }, "discovery_url": { "type": ["string", "null"] }, "authorization_url": { "type": ["string", "null"] }, "token_url": { "type": ["string", "null"] }, "device_authorization_url": { "type": ["string", "null"] }, "scopes": { "type": ["array", "null"], "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500, "pattern": "^\\S+$" } }, "audience": { "type": ["string", "null"] }, "resource": { "type": ["string", "null"] } } },
     "res:IdentityVerificationResponse": { "allOf": [{ "type": "object", "properties": { "operation": { "type": ["string", "null"], "maxLength": 2000, "pattern": "^[\\w$]+\\.[\\w$]+$" }, "subject_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" }, "account_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" }, "organization_field": { "type": ["string", "null"], "maxLength": 512, "pattern": "^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$" } } }, { "anyOf": [{ "properties": { "subject_field": { "type": "string" } }, "required": ["subject_field"], "type": "object" }, { "properties": { "account_field": { "type": "string" } }, "required": ["account_field"], "type": "object" }, { "properties": { "organization_field": { "type": "string" } }, "required": ["organization_field"], "type": "object" }] }] },
     "res:CliBehaviorResponse": { "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"] } } },
     "res:McpBehaviorResponse": { "type": "object", "properties": { "registry_name": { "type": ["string", "null"] }, "access": { "type": "object", "properties": { "issuer": { "type": "string" }, "resource": { "type": "string" }, "jwks_url": { "type": "string" }, "scopes": { "type": "array", "maxItems": 20, "items": { "type": "string" } } }, "required": ["issuer", "resource"] }, "tool_mode": { "type": "string" }, "instructions": { "type": ["string", "null"], "maxLength": 2000 }, "tool_descriptions": { "type": "object" }, "reference_resolvers": { "type": "object" } } },
     "res:ReadmeBehaviorResponse": { "type": "object", "properties": { "quickstart_operation": { "type": ["string", "null"], "maxLength": 500 } } },
-    "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"] } } },
-    "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"] },
+    "res:PackageBehaviorResponse": { "type": "object", "properties": { "title": { "type": ["string", "null"], "maxLength": 100 }, "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:RequestId": { "type": "string", "pattern": "^req_[a-z0-9]{16}$" },
+    "res:ResponseMetadata": { "type": "object", "properties": { "request_id": { "$ref": "res:RequestId" } }, "required": ["request_id"] },
+    "res:ProjectList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:Project" } }, "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" },
     "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" }] } } },
+    "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: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:GenerationBatch": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "res:Generation" } }, "request_id": { "$ref": "res:RequestId" } }, "required": ["data", "request_id"] },
     "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}$" },
@@ -120,6 +110,8 @@ export const DEFS = {
     "res:GenerationTrigger": { "type": "string" },
     "res:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
     "res:GeneratorKind": { "type": "string" },
+    "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: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" },
@@ -134,7 +126,7 @@ export const DEFS = {
     "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: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" }, "error_types": { "type": "array", "maxItems": 100, "items": { "type": "string", "pattern": "^[_A-Za-z][_0-9A-Za-z]*$" } }, "page_size": { "type": "integer", "minimum": 1, "maximum": 1000 } } },
     "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: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" } } },
@@ -145,22 +137,23 @@ export const DEFS = {
     "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:DiagnosticLocation": { "type": "object", "properties": { "blocking": { "type": "boolean" }, "introduced": { "type": "boolean" }, "suppressed": { "type": "boolean" }, "file_path": { "type": "string" }, "file_id": { "$ref": "res:FileId" }, "path": { "type": "string" }, "operation": { "type": "string" }, "evidence": { "type": "string" } }, "required": ["path", "blocking", "introduced", "suppressed"] },
     "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"] },
     "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"] },
+    "req:TargetCreateRequest": { "type": "object", "additionalProperties": false, "properties": { "project_id": { "$ref": "req:ProjectId" }, "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": ["project_id", "name", "type"] },
+    "req:ProjectId": { "type": "string", "pattern": "^prj_[a-z0-9]{16}$" },
+    "res:TargetResponse": { "allOf": [{ "$ref": "res:Target" }, { "$ref": "res:ResponseMetadata" }] },
     "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: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:TargetConfigResponse": { "type": "object", "properties": { "globals": { "type": "array", "maxItems": 20, "items": { "type": "string" } }, "include": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "exclude": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "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: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" } } } },
@@ -171,26 +164,33 @@ export const DEFS = {
     "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"] },
-    "req:ProjectId": { "type": "string", "pattern": "^prj_[a-z0-9]{16}$" },
-    "req:SpecId": { "type": "string", "pattern": "^spec_[a-z0-9]{16}$" },
-    "res:TargetResponse": { "allOf": [{ "$ref": "res:Target" }, { "$ref": "res:ResponseMetadata" }] },
+    "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"] },
+    "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" }] } } },
     "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 }, "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: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" }, "release_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" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "target_id", "generation_id", "version", "release_channel", "origin", "repository", "spec_revision_id", "commit_sha", "checks", "approvals", "import_provenance", "publications", "created_at", "updated_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:Publication": { "type": "object", "properties": { "type": { "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": ["type", "status", "attempt", "run_url", "registry_url", "artifact_digest", "errors", "started_at", "finished_at", "runtime_ms", "created_at", "updated_at"] },
+    "req:DeliveryCreateRequest": { "anyOf": [{ "$ref": "req:RepositoryDeliveryCreateRequest" }, { "$ref": "req:HostedMcpDeliveryCreateRequest" }] },
+    "req:RepositoryDeliveryCreateRequest": { "type": "object", "additionalProperties": false, "properties": { "target_id": { "$ref": "req:TargetId" }, "type": { "type": "string", "const": "repository" }, "repository": { "$ref": "req:RepositoryDeliverySettingsInput" } }, "required": ["target_id", "type", "repository"] },
+    "req:HostedMcpDeliveryCreateRequest": { "type": "object", "additionalProperties": false, "properties": { "target_id": { "$ref": "req:TargetId" }, "type": { "type": "string", "const": "hosted_mcp" } }, "required": ["target_id", "type"] },
+    "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"] },
+    "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"] },
+    "req:DeliveryUpdateRequest": { "type": "object", "additionalProperties": false, "properties": { "repository": { "$ref": "req:RepositoryDeliverySettingsInput" } }, "required": ["repository"] },
+    "res:DeletedDelivery": { "type": "object", "properties": { "id": { "$ref": "res:DeliveryId" }, "object": { "type": "string" }, "deleted": { "type": "boolean" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "deleted", "request_id"] },
+    "res:GenerationResponse": { "allOf": [{ "$ref": "res:Generation" }, { "$ref": "res:ResponseMetadata" }] },
+    "res:GenerationList": { "type": "object", "properties": { "object": { "$ref": "res:ListObject" }, "data": { "type": "array", "items": { "$ref": "res:Generation" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": ["string", "null"] }, "request_id": { "$ref": "res:RequestId" } }, "required": ["object", "data", "has_more", "next_cursor", "request_id"] },
+    "res: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: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: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"] }, "compatibility": { "anyOf": [{ "$ref": "res:DraftCompatibility" }, { "type": "null" }] }, "version": { "anyOf": [{ "$ref": "res:DraftVersion" }, { "type": "null" }] }, "errors": { "type": "array", "items": { "$ref": "res:ErrorDetail" } }, "changes": { "type": ["object", "null"], "properties": { "changelog": { "type": ["string", "null"] }, "breaking_count": { "type": ["integer", "null"], "minimum": 0 } } }, "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", "compatibility", "version", "errors", "checks", "changes", "head_sha", "pull_request", "generation_id", "release_id", "conflicts", "customized_files", "history_recovery", "created_at", "updated_at"] },
     "res:DraftStatus": { "type": "string" },
     "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:DraftCompatibility": { "type": "object", "properties": { "api": { "type": "string" }, "package": { "type": "string" } }, "required": ["api", "package"] },
+    "res:DraftVersion": { "type": "object", "properties": { "bump_required": { "type": ["string", "null"] }, "correct": { "type": ["boolean", "null"] }, "previous": { "type": ["string", "null"] } }, "required": ["bump_required", "correct", "previous"] },
     "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"] },
     "res:DraftResponse": { "allOf": [{ "$ref": "res:Draft" }, { "$ref": "res:ResponseMetadata" }] },
@@ -205,16 +205,18 @@ export const DEFS = {
     "req:GitFileMode": { "type": "string", "enum": ["100644", "100755", "120000"] },
     "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"] },
-    "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"] },
-    "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" }] },
-    "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:GenerationResponse": { "allOf": [{ "$ref": "res:Generation" }, { "$ref": "res:ResponseMetadata" }] },
-    "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: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: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" } }, "include": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "exclude": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "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"] } } },
+    "res:GenerationResult": { "type": "object", "properties": { "object": { "type": "string" }, "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": ["object", "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: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" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "name", "last4", "revoked", "last_used_at", "created_at", "updated_at"] },
+    "res:ApiKey": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "name": { "type": "string" }, "last4": { "type": "string" }, "status": { "type": "string" }, "last_used_at": { "type": ["string", "null"] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "$ref": "res:RequestId" } }, "required": ["id", "object", "name", "last4", "status", "last_used_at", "created_at", "updated_at"] },
     "res:ApiKeyResponse": { "allOf": [{ "$ref": "res:ApiKey" }, { "$ref": "res:ResponseMetadata" }] },
 };

package/dist/search.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Operation search shared by the generated CLI (`docs search`) and MCP
+ * server (`search_docs`). Generated by Typeship — https://typeship.dev
+ *
+ * Agents describe a task ("assign issue", "list calls"), not an operation
+ * name, so ranking works on stems, weighs rare words over common ones
+ * (IDF), and reads the verb of the query against what each operation does:
+ * its HTTP method and whether its path names one item or a collection, or
+ * its GraphQL root field. GraphQL mutations are also indexed by their input
+ * fields, so "assign issue" finds issueUpdate through assigneeId.
+ * Deterministic and dependency-free.
+ */
+/** The parts of an operation search reads. The CLI and MCP operation
+ * specs both satisfy it. */
+export interface SearchableOperation {
+    tool: string;
+    resource?: string;
+    method?: string;
+    httpMethod: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    paginated?: boolean;
+    deprecated?: boolean;
+    graphql?: {
+        kind: string;
+        field?: string;
+    };
+    params: readonly {
+        name: string;
+        enum?: readonly string[];
+        description?: string;
+    }[];
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+/** Reference matches per search page. */
+export declare const SEARCH_PAGE_SIZE = 10;
+/** A light English stemmer: plurals, -ing/-ed, a few derivational
+ * suffixes, a trailing e. It only has to map a word and its common
+ * variants to one stem ("assignee", "assigned", "assigns" to "assign";
+ * "moderate", "moderations" to "moder"). */
+export declare function stem(word: string): string;
+export interface RankedOperation<T> {
+    op: T;
+    score: number;
+}
+/**
+ * Operations for a free-text query, best first. Weak matches (under a
+ * fifth of the best score, or matching only the query's verb) are left
+ * out, and deprecated operations follow every current one.
+ */
+export declare function rankOperations<T extends SearchableOperation>(ops: readonly T[], query: string): RankedOperation<T>[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;4BAC4B;AAC5B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAqDnC;;;4CAG4C;AAC5C,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BzC;AAoPD,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC;IACN,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,mBAAmB,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CA+DpH"}