@typeship-ax/mcp 0.19.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/AGENTS.md +3 -3
  2. package/README.md +1 -1
  3. package/api.json +7519 -6363
  4. package/api.md +8015 -6765
  5. package/dist/api-identity.d.ts.map +1 -1
  6. package/dist/api-identity.js +6 -1
  7. package/dist/core/http.d.ts +26 -14
  8. package/dist/core/http.d.ts.map +1 -1
  9. package/dist/core/http.js +90 -19
  10. package/dist/core/pagination.d.ts +8 -8
  11. package/dist/core/pagination.d.ts.map +1 -1
  12. package/dist/core/pagination.js +7 -16
  13. package/dist/errors.d.ts +4 -4
  14. package/dist/errors.d.ts.map +1 -1
  15. package/dist/errors.js +7 -7
  16. package/dist/index.d.ts +33 -19
  17. package/dist/index.d.ts.map +1 -1
  18. package/dist/index.js +37 -17
  19. package/dist/mcp-protocol.js +2 -2
  20. package/dist/mcp.d.ts.map +1 -1
  21. package/dist/mcp.js +6 -5
  22. package/dist/ops.d.ts +1 -1
  23. package/dist/ops.d.ts.map +1 -1
  24. package/dist/ops.js +40 -43
  25. package/dist/resources/api-keys.d.ts +16 -15
  26. package/dist/resources/api-keys.d.ts.map +1 -1
  27. package/dist/resources/api-keys.js +6 -6
  28. package/dist/resources/deliveries.d.ts +47 -0
  29. package/dist/resources/deliveries.d.ts.map +1 -0
  30. package/dist/resources/deliveries.js +70 -0
  31. package/dist/resources/drafts.d.ts +157 -0
  32. package/dist/resources/drafts.d.ts.map +1 -0
  33. package/dist/resources/drafts.js +230 -0
  34. package/dist/resources/files.d.ts +23 -0
  35. package/dist/resources/files.d.ts.map +1 -0
  36. package/dist/resources/files.js +38 -0
  37. package/dist/resources/generate.d.ts +14 -14
  38. package/dist/resources/generate.d.ts.map +1 -1
  39. package/dist/resources/generate.js +7 -7
  40. package/dist/resources/generations.d.ts +67 -21
  41. package/dist/resources/generations.d.ts.map +1 -1
  42. package/dist/resources/generations.js +67 -20
  43. package/dist/resources/organization.d.ts +18 -0
  44. package/dist/resources/organization.d.ts.map +1 -0
  45. package/dist/resources/{account.js → organization.js} +10 -10
  46. package/dist/resources/projects.d.ts +50 -139
  47. package/dist/resources/projects.d.ts.map +1 -1
  48. package/dist/resources/projects.js +29 -179
  49. package/dist/resources/publications.d.ts +47 -0
  50. package/dist/resources/publications.d.ts.map +1 -0
  51. package/dist/resources/publications.js +70 -0
  52. package/dist/resources/releases.d.ts +68 -0
  53. package/dist/resources/releases.d.ts.map +1 -0
  54. package/dist/resources/releases.js +102 -0
  55. package/dist/resources/spec-revisions.d.ts +87 -0
  56. package/dist/resources/spec-revisions.d.ts.map +1 -0
  57. package/dist/resources/spec-revisions.js +116 -0
  58. package/dist/resources/specs.d.ts +73 -0
  59. package/dist/resources/specs.d.ts.map +1 -0
  60. package/dist/resources/specs.js +108 -0
  61. package/dist/resources/targets.d.ts +48 -267
  62. package/dist/resources/targets.d.ts.map +1 -1
  63. package/dist/resources/targets.js +28 -407
  64. package/dist/schemas.d.ts.map +1 -1
  65. package/dist/schemas.js +143 -149
  66. package/dist/types.d.ts +1320 -1637
  67. package/dist/types.d.ts.map +1 -1
  68. package/dist/types.js +84 -76
  69. package/package.json +1 -1
  70. package/server.json +2 -2
  71. package/src/api-identity.ts +6 -2
  72. package/src/core/http.ts +89 -24
  73. package/src/core/pagination.ts +13 -23
  74. package/src/errors.ts +7 -7
  75. package/src/index.ts +41 -23
  76. package/src/mcp-protocol.ts +2 -2
  77. package/src/mcp.ts +7 -6
  78. package/src/ops.ts +41 -44
  79. package/src/resources/api-keys.ts +19 -21
  80. package/src/resources/deliveries.ts +140 -0
  81. package/src/resources/drafts.ts +424 -0
  82. package/src/resources/files.ts +68 -0
  83. package/src/resources/generate.ts +16 -19
  84. package/src/resources/generations.ts +148 -35
  85. package/src/resources/{account.ts → organization.ts} +14 -14
  86. package/src/resources/projects.ts +56 -350
  87. package/src/resources/publications.ts +140 -0
  88. package/src/resources/releases.ts +201 -0
  89. package/src/resources/spec-revisions.ts +239 -0
  90. package/src/resources/specs.ts +201 -0
  91. package/src/resources/targets.ts +63 -765
  92. package/src/schemas.ts +143 -149
  93. package/src/types.ts +1418 -1740
  94. package/dist/resources/account.d.ts +0 -18
  95. package/dist/resources/account.d.ts.map +0 -1
  96. package/dist/resources/definition-revisions.d.ts +0 -75
  97. package/dist/resources/definition-revisions.d.ts.map +0 -1
  98. package/dist/resources/definition-revisions.js +0 -142
  99. package/dist/resources/definitions.d.ts +0 -50
  100. package/dist/resources/definitions.d.ts.map +0 -1
  101. package/dist/resources/definitions.js +0 -73
  102. package/src/resources/definition-revisions.ts +0 -265
  103. package/src/resources/definitions.ts +0 -146
package/dist/schemas.js CHANGED
@@ -9,54 +9,51 @@ export const SCHEMAS = {
9
9
  "generate.downloadPackage": { "res": { "type": "string" } },
10
10
  "projects.list": { "res": { "$ref": "res:ProjectList" } },
11
11
  "projects.create": { "req": { "$ref": "req:CreateProjectRequest" }, "res": { "$ref": "res:Project" } },
12
- "projects.retrieve": { "res": { "$ref": "res:Project" } },
12
+ "projects.get": { "res": { "$ref": "res:Project" } },
13
13
  "projects.delete": { "res": { "$ref": "res:DeletedProject" } },
14
14
  "projects.update": { "req": { "$ref": "req:UpdateProjectRequest" }, "res": { "$ref": "res:Project" } },
15
- "projects.retrieveDiagnostics": { "res": { "$ref": "res:DiagnosticReport" } },
16
- "projects.refreshDiagnostics": { "res": { "$ref": "res:DiagnosticReport" } },
17
- "projects.remediateDiagnostics": { "req": { "$ref": "req:DiagnosticRemediationRequest" }, "res": { "$ref": "res:DiagnosticRemediation" } },
18
- "projects.retrieveIntegrationHealth": { "res": { "$ref": "res:RepositoryIntegrationHealth" } },
19
- "projects.listGenerations": { "res": { "$ref": "res:GenerationList" } },
20
15
  "projects.generate": { "req": { "$ref": "req:GenerateProjectRequest" }, "res": { "$ref": "res:GenerationBatch" } },
21
- "definitions.retrieve": { "res": { "$ref": "res:Definition" } },
22
- "definitions.update": { "req": { "$ref": "req:DefinitionUpdateRequest" }, "res": { "$ref": "res:Definition" } },
16
+ "specs.get": { "res": { "$ref": "res:Spec" } },
17
+ "specs.update": { "req": { "$ref": "req:SpecUpdateRequest" }, "res": { "$ref": "res:Spec" } },
18
+ "specs.refresh": { "res": { "$ref": "res:Spec" } },
19
+ "specRevisions.list": { "res": { "$ref": "res:SpecRevisionList" } },
20
+ "specRevisions.get": { "res": { "$ref": "res:SpecRevisionResponse" } },
21
+ "specRevisions.listFiles": { "res": { "$ref": "res:SpecRevisionFileList" } },
23
22
  "targets.list": { "res": { "$ref": "res:TargetList" } },
24
- "targets.create": { "req": { "$ref": "req:TargetFields" }, "res": { "$ref": "res:TargetResponse" } },
25
- "targets.retrieve": { "res": { "$ref": "res:TargetResponse" } },
23
+ "targets.create": { "req": { "$ref": "req:TargetCreateRequest" }, "res": { "$ref": "res:TargetResponse" } },
24
+ "targets.get": { "res": { "$ref": "res:TargetResponse" } },
26
25
  "targets.delete": { "res": { "$ref": "res:DeletedTarget" } },
27
26
  "targets.update": { "req": { "$ref": "req:TargetUpdateRequest" }, "res": { "$ref": "res:TargetResponse" } },
28
- "targets.listReleases": { "res": { "$ref": "res:TargetReleaseList" } },
29
- "targets.retrieveDraft": { "res": { "$ref": "res:TargetDraftResponse" } },
30
- "targets.updateDraft": { "req": { "$ref": "req:TargetDraftUpdate" }, "res": { "$ref": "res:TargetDraftResponse" } },
31
- "targets.adoptRelease": { "req": { "$ref": "req:TargetAdoption" }, "res": { "$ref": "res:TargetReleaseResponse" } },
32
- "targets.retrieveRelease": { "res": { "$ref": "res:TargetReleaseResponse" } },
33
- "targets.republishRelease": { "res": { "$ref": "res:TargetReleaseResponse" } },
34
- "targets.listDraftFiles": { "res": { "$ref": "res:DraftFileList" } },
35
- "targets.retrieveDraftFileContent": { "res": { "$ref": "res:DraftFileContentResponse" } },
36
- "targets.resolveDraftConflicts": { "req": { "$ref": "req:ResolveDraftConflicts" }, "res": { "$ref": "res:DraftConflictResolutionResponse" } },
37
- "targets.discardDraftCustomizations": { "req": { "$ref": "req:DiscardDraftCustomizations" }, "res": { "$ref": "res:DraftCustomizationDiscardResponse" } },
38
- "targets.recoverDraftHistory": { "req": { "$ref": "req:RecoverDraftHistory" }, "res": { "$ref": "res:DraftHistoryRecoveryResponse" } },
39
- "targets.retrieveDelivery": { "res": { "$ref": "res:DeliveryResponse" } },
40
- "targets.retrievePublication": { "res": { "$ref": "res:PublicationResponse" } },
41
- "generations.retrieve": { "res": { "$ref": "res:GenerationResponse" } },
42
- "generations.retrieveFile": { "res": { "type": "string" } },
43
- "definitionRevisions.list": { "res": { "$ref": "res:DefinitionRevisionList" } },
44
- "definitionRevisions.retrieve": { "res": { "$ref": "res:DefinitionRevisionResponse" } },
45
- "definitionRevisions.retrieveContent": { "res": { "type": "string" } },
46
- "definitionRevisions.retrieveDocumentContent": { "res": { "type": "string" } },
47
- "definitionRevisions.retrieveDocument": { "res": { "$ref": "res:DefinitionDocumentResponse" } },
48
- "account.retrieve": { "res": { "$ref": "res:Account" } },
27
+ "targets.adopt": { "req": { "$ref": "req:TargetAdoption" }, "res": { "$ref": "res:ReleaseResponse" } },
28
+ "drafts.list": { "res": { "$ref": "res:DraftList" } },
29
+ "drafts.get": { "res": { "$ref": "res:DraftResponse" } },
30
+ "drafts.update": { "req": { "$ref": "req:DraftUpdateRequest" }, "res": { "$ref": "res:DraftResponse" } },
31
+ "drafts.listFiles": { "res": { "$ref": "res:DraftFileList" } },
32
+ "drafts.resolve": { "req": { "$ref": "req:DraftResolveRequest" }, "res": { "$ref": "res:DraftResponse" } },
33
+ "drafts.recover": { "req": { "$ref": "req:DraftRecoverRequest" }, "res": { "$ref": "res:DraftResponse" } },
34
+ "releases.list": { "res": { "$ref": "res:ReleaseList" } },
35
+ "releases.get": { "res": { "$ref": "res:ReleaseResponse" } },
36
+ "releases.republish": { "res": { "$ref": "res:ReleaseResponse" } },
37
+ "deliveries.list": { "res": { "$ref": "res:DeliveryList" } },
38
+ "deliveries.get": { "res": { "$ref": "res:DeliveryResponse" } },
39
+ "publications.list": { "res": { "$ref": "res:PublicationList" } },
40
+ "publications.get": { "res": { "$ref": "res:PublicationResponse" } },
41
+ "generations.list": { "res": { "$ref": "res:GenerationList" } },
42
+ "generations.get": { "res": { "$ref": "res:GenerationResponse" } },
43
+ "generations.listFiles": { "res": { "$ref": "res:FileList" } },
44
+ "files.get": { "res": { "$ref": "res:FileResponse" } },
45
+ "organization.get": { "res": { "$ref": "res:Organization" } },
49
46
  "apiKeys.list": { "res": { "$ref": "res:ApiKeyList" } },
50
- "apiKeys.retrieve": { "res": { "$ref": "res:ApiKeyResponse" } },
47
+ "apiKeys.get": { "res": { "$ref": "res:ApiKeyResponse" } },
51
48
  "apiKeys.revoke": { "res": { "$ref": "res:ApiKeyResponse" } },
52
49
  };
53
50
  export const DEFS = {
54
- "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"] },
55
- "req:DefinitionInput": { "anyOf": [{ "$ref": "req:UrlDefinitionInput" }, { "$ref": "req:InlineDefinitionInput" }] },
56
- "req:UrlDefinitionInput": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "pattern": "^https?://" }, "headers": { "type": "object" } }, "required": ["url"] },
57
- "req:InlineDefinitionInput": { "type": "object", "additionalProperties": false, "properties": { "inline": { "type": "string" } }, "required": ["inline"] },
58
- "req:GeneratorKind": { "type": "string", "enum": ["typescript-sdk", "python-sdk", "go-sdk", "cli", "go-cli", "mcp"] },
59
- "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"] },
51
+ "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"] },
52
+ "req:SpecInput": { "anyOf": [{ "$ref": "req:UrlSpecInput" }, { "$ref": "req:InlineSpecInput" }] },
53
+ "req:UrlSpecInput": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "pattern": "^https?://" }, "headers": { "type": "object" } }, "required": ["url"] },
54
+ "req:InlineSpecInput": { "type": "object", "additionalProperties": false, "properties": { "inline": { "type": "string" } }, "required": ["inline"] },
55
+ "req:GeneratorKind": { "type": "string", "enum": ["cli", "go_cli", "mcp", "typescript_sdk", "python_sdk", "go_sdk"] },
56
+ "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"] },
60
57
  "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"] } } },
61
58
  "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" } } },
62
59
  "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 = {
67
64
  "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" } } },
68
65
  "req:ReadmeBehavior": { "type": "object", "additionalProperties": false, "properties": { "quickstart_operation": { "type": ["string", "null"], "maxLength": 500 } } },
69
66
  "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"] } } },
70
- "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"] },
67
+ "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"] },
71
68
  "res:GeneratedFile": { "type": "object", "properties": { "path": { "type": "string" }, "content": { "type": "string" }, "mode": { "type": "string" } }, "required": ["path", "content"] },
72
69
  "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"] },
73
- "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"] },
74
- "res:GeneratorKind": { "type": "string" },
75
- "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"] },
76
- "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"] },
70
+ "res:GenerationWarning": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "operation": { "type": "string" } }, "required": ["code", "message"] },
71
+ "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"] },
77
72
  "res:RequestId": { "type": "string", "pattern": "^req_[a-z0-9]{16}$" },
78
73
  "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"] },
79
74
  "res:ListObject": { "type": "string" },
80
- "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"] },
75
+ "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"] },
81
76
  "res:ProjectId": { "type": "string", "pattern": "^prj_[a-z0-9]{16}$" },
82
- "res:DefinitionId": { "type": "string", "pattern": "^def_[a-z0-9]{16}$" },
83
- "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"] },
84
- "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"] },
85
- "req:DefinitionSourceInput": { "anyOf": [{ "$ref": "req:UrlDefinitionSourceInput" }, { "$ref": "req:RepositoryDefinitionSourceInput" }] },
86
- "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"] },
87
- "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"] },
88
- "req:RepositoryReference": { "type": "object", "additionalProperties": false, "properties": { "provider": { "type": "string", "enum": ["github"] }, "identifier": { "type": "string", "maxLength": 512 } }, "required": ["provider", "identifier"] },
89
- "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"] },
77
+ "res:SpecId": { "type": "string", "pattern": "^spec_[a-z0-9]{16}$" },
78
+ "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"] },
79
+ "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"] },
80
+ "req:SpecSourceInput": { "anyOf": [{ "$ref": "req:UrlSpecSourceInput" }, { "$ref": "req:RepositorySpecSourceInput" }] },
81
+ "req:UrlSpecSourceInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "url" }, "url": { "$ref": "req:UrlSpecSourceSettingsInput" } }, "required": ["type", "url"] },
82
+ "req:UrlSpecSourceSettingsInput": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://" }, "headers": { "anyOf": [{ "type": "object" }, { "type": "null" }] } }, "required": ["url"] },
83
+ "req:RepositorySpecSourceInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "repository" }, "repository": { "$ref": "req:RepositorySpecSourceSettingsInput" } }, "required": ["type", "repository"] },
84
+ "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"] },
85
+ "req:RepositoryProvider": { "type": "string", "enum": ["github"] },
86
+ "req:RepositoryIdentifier": { "type": "string", "maxLength": 512 },
87
+ "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"] },
90
88
  "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"] },
91
89
  "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"] },
92
- "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"] },
90
+ "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"] },
93
91
  "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"] } } } },
94
- "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"] } } },
92
+ "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"] } } },
95
93
  "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"] } } },
94
+ "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" } } },
96
95
  "req:DeliveryInput": { "anyOf": [{ "$ref": "req:RepositoryDeliveryInput" }, { "$ref": "req:HostedMcpDeliveryInput" }] },
97
- "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"] },
98
- "req:HostedMcpDeliveryInput": { "type": "object", "additionalProperties": false, "properties": { "kind": { "type": "string", "const": "hosted_mcp" } }, "required": ["kind"] },
96
+ "req:RepositoryDeliveryInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "repository" }, "repository": { "$ref": "req:RepositoryDeliverySettingsInput" } }, "required": ["type", "repository"] },
97
+ "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"] },
98
+ "req:HostedMcpDeliveryInput": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string", "const": "hosted_mcp" } }, "required": ["type"] },
99
99
  "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"] } } },
100
- "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"] },
100
+ "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"] },
101
101
  "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"] } } },
102
102
  "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" } } },
103
103
  "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"] } } },
@@ -108,119 +108,113 @@ export const DEFS = {
108
108
  "res:ReadmeBehaviorResponse": { "type": "object", "properties": { "quickstart_operation": { "type": ["string", "null"], "maxLength": 500 } } },
109
109
  "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"] } } },
110
110
  "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"] },
111
- "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" }] } } },
112
- "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"] },
113
- "res:DefinitionRevisionId": { "type": "string", "pattern": "^drev_[a-z0-9]{16}$" },
114
- "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"] },
115
- "res:DiagnosticLocation": { "type": "object", "properties": { "document": { "type": "string" }, "path": { "type": "string" }, "operation": { "type": "string" }, "evidence": { "type": "string" } }, "required": ["path"] },
116
- "res:DiagnosticFix": { "type": "object", "properties": { "title": { "type": "string" }, "kind": { "type": "string" }, "patches": { "type": "array", "items": { "$ref": "res:DefinitionPatchResponse" } }, "instructions": { "type": "string" } }, "required": ["title", "kind"] },
117
- "res:DefinitionPatchResponse": { "type": "object", "properties": { "op": { "type": "string" }, "path": { "type": "string" }, "value": {}, "to": { "type": ["string", "null"] }, "reason": { "type": ["string", "null"] } }, "required": ["op", "path"] },
118
- "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"] },
119
- "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"] },
120
- "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"] },
121
- "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"] },
122
- "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"] },
123
- "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"] },
124
- "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"] },
125
- "req:DiagnosticRemediationRequest": { "type": "object", "additionalProperties": false, "properties": { "diagnostic_ids": { "type": "array", "minItems": 1, "maxItems": 50, "items": { "type": "string" } } }, "required": ["diagnostic_ids"] },
126
- "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"] },
127
- "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"] },
128
- "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"] },
129
- "res:RepositoryReferenceResponse": { "type": "object", "properties": { "provider": { "type": "string" }, "identifier": { "type": "string", "maxLength": 512 } }, "required": ["provider", "identifier"] },
130
- "res:RepositoryHealthIssue": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"] },
131
- "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"] },
132
- "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"] },
133
- "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"] },
111
+ "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" }] } } },
112
+ "req:GenerateProjectRequest": { "type": "object", "additionalProperties": false, "properties": { "target_id": { "$ref": "req:TargetId" } } },
113
+ "req:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
114
+ "res:GenerationBatch": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "res:GenerationSummary" } }, "request_id": { "$ref": "res:RequestId" } }, "required": ["data", "request_id"] },
115
+ "res:GenerationSummary": { "allOf": [{ "$ref": "res:Generation" }] },
116
+ "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"] },
134
117
  "res:GenerationId": { "type": "string", "pattern": "^gen_[a-z0-9]{16}$" },
118
+ "res:SpecRevisionId": { "type": "string", "pattern": "^srev_[a-z0-9]{16}$" },
135
119
  "res:GenerationStatus": { "type": "string" },
136
120
  "res:GenerationTrigger": { "type": "string" },
137
121
  "res:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
138
- "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"] },
139
- "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"] } } },
140
- "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" } } },
122
+ "res:GeneratorKind": { "type": "string" },
141
123
  "res:DomainError": { "allOf": [{ "$ref": "res:ErrorDetail" }, { "type": "object", "properties": { "phase": { "$ref": "res:FailurePhase" } }, "required": ["phase"] }] },
142
124
  "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"] },
143
125
  "res:ErrorType": { "type": "string" },
144
126
  "res:ErrorCode": { "type": "string" },
145
127
  "res:FailurePhase": { "type": "string" },
146
- "req:GenerateProjectRequest": { "type": "object", "additionalProperties": false, "properties": { "target_id": { "$ref": "req:TargetId" } } },
147
- "req:TargetId": { "type": "string", "pattern": "^tgt_[a-z0-9]{16}$" },
148
- "res:GenerationBatch": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "res:GenerationSummary" } }, "request_id": { "$ref": "res:RequestId" } }, "required": ["data", "request_id"] },
149
- "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"] },
150
- "res:DefinitionSource": { "anyOf": [{ "$ref": "res:UrlDefinitionSource" }, { "$ref": "res:RepositoryDefinitionSource" }], "responseDiscriminator": { "propertyName": "kind", "mapping": { "url": { "$ref": "res:UrlDefinitionSource" }, "repository": { "$ref": "res:RepositoryDefinitionSource" } } } },
151
- "res:UrlDefinitionSource": { "type": "object", "properties": { "kind": { "type": "string" }, "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://" }, "headers_configured": { "type": "boolean" } }, "required": ["kind", "url", "headers_configured"] },
152
- "res:RepositoryDefinitionSource": { "type": "object", "properties": { "kind": { "type": "string" }, "repository": { "$ref": "res:RepositoryReferenceResponse" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*\\.\\.).+$" } }, "required": ["kind", "repository", "path"] },
153
- "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" } } },
128
+ "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"] },
129
+ "res:SpecSource": { "anyOf": [{ "$ref": "res:UrlSpecSource" }, { "$ref": "res:RepositorySpecSource" }], "responseDiscriminator": { "propertyName": "type", "mapping": { "url": { "$ref": "res:UrlSpecSource" }, "repository": { "$ref": "res:RepositorySpecSource" } } } },
130
+ "res:UrlSpecSource": { "type": "object", "properties": { "type": { "type": "string" }, "url": { "$ref": "res:UrlSpecSourceSettings" } }, "required": ["type", "url"] },
131
+ "res:UrlSpecSourceSettings": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://" }, "headers_configured": { "type": "boolean" } }, "required": ["url", "headers_configured"] },
132
+ "res:RepositorySpecSource": { "type": "object", "properties": { "type": { "type": "string" }, "repository": { "$ref": "res:RepositorySpecSourceSettings" } }, "required": ["type", "repository"] },
133
+ "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"] },
134
+ "res:RepositoryProvider": { "type": "string" },
135
+ "res:RepositoryIdentifier": { "type": "string", "maxLength": 512 },
136
+ "res:SpecPatchResponse": { "type": "object", "properties": { "op": { "type": "string" }, "path": { "type": "string" }, "value": {}, "to": { "type": ["string", "null"] }, "reason": { "type": ["string", "null"] } }, "required": ["op", "path"] },
137
+ "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" } } },
138
+ "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"] },
139
+ "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"] },
140
+ "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" } } },
141
+ "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"] },
142
+ "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"] },
143
+ "res:SpecRevisionSource": { "anyOf": [{ "$ref": "res:UrlSpecRevisionSource" }, { "$ref": "res:RepositorySpecRevisionSource" }], "responseDiscriminator": { "propertyName": "type", "mapping": { "url": { "$ref": "res:UrlSpecRevisionSource" }, "repository": { "$ref": "res:RepositorySpecRevisionSource" } } } },
144
+ "res:UrlSpecRevisionSource": { "type": "object", "properties": { "type": { "type": "string" }, "url": { "type": "object", "properties": { "url": { "type": "string" } }, "required": ["url"] } }, "required": ["type", "url"] },
145
+ "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"] },
146
+ "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"] },
147
+ "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"] },
148
+ "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"] },
149
+ "res:FileId": { "type": "string", "pattern": "^file_[a-z0-9]{16}$" },
150
+ "res:DiagnosticFix": { "type": "object", "properties": { "title": { "type": "string" }, "type": { "type": "string" }, "patches": { "type": "array", "items": { "$ref": "res:SpecPatchResponse" } }, "instructions": { "type": "string" } }, "required": ["title", "type"] },
151
+ "res:DiagnosticWarning": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"] },
152
+ "res:SpecRevisionResponse": { "allOf": [{ "$ref": "res:SpecRevision" }, { "$ref": "res:ResponseMetadata" }] },
153
+ "res:ResponseMetadata": { "type": "object", "properties": { "request_id": { "$ref": "res:RequestId" } }, "required": ["request_id"] },
154
+ "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"] },
155
+ "res:SpecRevisionFile": { "allOf": [{ "$ref": "res:File" }, { "type": "object", "properties": { "role": { "type": "string" } }, "required": ["role"] }] },
156
+ "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"] },
157
+ "res:GitFileMode": { "type": "string" },
154
158
  "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"] },
155
- "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"] },
156
- "res:TargetDependency": { "type": "object", "properties": { "kind": { "type": "string" }, "target_id": { "$ref": "res:TargetId" } }, "required": ["kind", "target_id"] },
159
+ "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"] },
160
+ "res:TargetDependency": { "type": "object", "properties": { "type": { "type": "string" }, "target_id": { "$ref": "res:TargetId" } }, "required": ["type", "target_id"] },
161
+ "res:DraftId": { "type": "string", "pattern": "^drf_[a-z0-9]{16}$" },
157
162
  "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"] } } } },
158
- "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"] } } },
163
+ "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"] } } },
159
164
  "res:TargetAuthenticationConfigResponse": { "type": "object", "properties": { "oauth_application": { "type": ["string", "null"], "maxLength": 64, "pattern": "^[a-z][a-z0-9_-]{0,63}$" }, "environments": { "type": ["object", "null"] } } },
160
- "res:Delivery": { "anyOf": [{ "$ref": "res:RepositoryDelivery" }, { "$ref": "res:HostedMcpDelivery" }], "responseDiscriminator": { "propertyName": "kind", "mapping": { "repository": { "$ref": "res:RepositoryDelivery" }, "hosted_mcp": { "$ref": "res:HostedMcpDelivery" } } } },
161
- "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"] },
165
+ "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" } } },
166
+ "res:Delivery": { "anyOf": [{ "$ref": "res:RepositoryDelivery" }, { "$ref": "res:HostedMcpDelivery" }], "responseDiscriminator": { "propertyName": "type", "mapping": { "repository": { "$ref": "res:RepositoryDelivery" }, "hosted_mcp": { "$ref": "res:HostedMcpDelivery" } } } },
167
+ "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"] },
162
168
  "res:DeliveryId": { "type": "string", "pattern": "^dlv_[a-z0-9]{16}$" },
163
- "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"] },
164
- "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"] },
165
- "req:DefinitionId": { "type": "string", "pattern": "^def_[a-z0-9]{16}$" },
169
+ "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"] },
170
+ "res:RepositoryDeliveryIssue": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"] },
171
+ "res:RepositoryDeliveryEvent": { "type": "object", "properties": { "event": { "type": "string" }, "status": { "type": "string" }, "created_at": { "type": "string" } }, "required": ["event", "status", "created_at"] },
172
+ "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"] },
173
+ "res:HostedMcpDeliverySettings": { "type": "object", "properties": { "url": { "type": ["string", "null"] } }, "required": ["url"] },
174
+ "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"] },
175
+ "req:ProjectId": { "type": "string", "pattern": "^prj_[a-z0-9]{16}$" },
176
+ "req:SpecId": { "type": "string", "pattern": "^spec_[a-z0-9]{16}$" },
166
177
  "res:TargetResponse": { "allOf": [{ "$ref": "res:Target" }, { "$ref": "res:ResponseMetadata" }] },
167
- "res:ResponseMetadata": { "type": "object", "properties": { "request_id": { "$ref": "res:RequestId" } }, "required": ["request_id"] },
168
178
  "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"] },
169
- "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" } } } },
170
- "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"] },
171
- "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"] },
172
- "res:TargetReleaseId": { "type": "string", "pattern": "^rel_[a-z0-9]{16}$" },
173
- "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"] },
174
- "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"] },
175
- "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"] },
179
+ "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" } } } },
180
+ "req:TargetAdoption": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": "string" }, "tag": { "type": "string", "minLength": 1, "maxLength": 255 } }, "required": ["version", "tag"] },
181
+ "res:ReleaseResponse": { "allOf": [{ "$ref": "res:Release" }, { "$ref": "res:ResponseMetadata" }] },
182
+ "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"] },
183
+ "res:ReleaseId": { "type": "string", "pattern": "^rel_[a-z0-9]{16}$" },
184
+ "res:RepositoryReferenceResponse": { "type": "object", "properties": { "provider": { "$ref": "res:RepositoryProvider" }, "identifier": { "$ref": "res:RepositoryIdentifier" } }, "required": ["provider", "identifier"] },
185
+ "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"] },
186
+ "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"] },
187
+ "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"] },
176
188
  "res:PublicationId": { "type": "string", "pattern": "^pub_[a-z0-9]{16}$" },
177
- "res:TargetDraftResponse": { "allOf": [{ "$ref": "res:TargetDraft" }, { "$ref": "res:ResponseMetadata" }] },
178
- "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"] },
189
+ "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"] },
190
+ "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"] },
179
191
  "res:DraftStatus": { "type": "string" },
180
- "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"] }] },
181
- "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"] },
182
- "res:TargetDraftConflicts": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 1 }, "decided": { "type": "integer", "minimum": 0 } }, "required": ["total", "decided"] },
183
- "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"] },
184
- "req:TargetDraftUpdate": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": ["string", "null"] } }, "required": ["version"] },
185
- "req:TargetAdoption": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": "string" }, "tag": { "type": "string", "minLength": 1, "maxLength": 255 } }, "required": ["version", "tag"] },
186
- "res:TargetReleaseResponse": { "allOf": [{ "$ref": "res:TargetRelease" }, { "$ref": "res:ResponseMetadata" }] },
192
+ "res:DraftActionReason": { "type": "string" },
193
+ "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"] },
194
+ "res:DraftConflicts": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 1 }, "decided": { "type": "integer", "minimum": 0 } }, "required": ["total", "decided"] },
195
+ "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"] },
196
+ "res:DraftResponse": { "allOf": [{ "$ref": "res:Draft" }, { "$ref": "res:ResponseMetadata" }] },
197
+ "req:DraftUpdateRequest": { "type": "object", "additionalProperties": false, "properties": { "version_next": { "type": ["string", "null"] } }, "required": ["version_next"] },
187
198
  "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"] },
188
- "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"] },
189
- "res:DraftFileConflict": { "type": "object", "properties": { "kind": { "type": "string" }, "source": { "type": "string" }, "decision": { "type": ["string", "null"] } }, "required": ["kind", "source", "decision"] },
199
+ "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"] },
200
+ "res:DraftFileConflict": { "type": "object", "properties": { "type": { "type": "string" }, "source": { "type": "string" }, "decision": { "type": ["string", "null"] } }, "required": ["type", "source", "decision"] },
190
201
  "res:DraftFileHistory": { "type": "object", "properties": { "change": { "type": ["string", "null"] }, "draft_differs": { "type": "boolean" } }, "required": ["change", "draft_differs"] },
191
- "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"] },
192
- "res:DraftFileSide": { "type": "string" },
193
- "res:GitFileMode": { "type": "string" },
194
- "res:DraftFileContentResponse": { "allOf": [{ "$ref": "res:DraftFileContent" }, { "$ref": "res:ResponseMetadata" }] },
195
- "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"] },
196
- "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"] },
197
- "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"] }] },
202
+ "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"] },
203
+ "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"] },
204
+ "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"] }] },
198
205
  "req:GitFileMode": { "type": "string", "enum": ["100644", "100755", "120000"] },
199
- "res:DraftConflictResolutionResponse": { "allOf": [{ "$ref": "res:DraftConflictResolution" }, { "$ref": "res:ResponseMetadata" }] },
200
- "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"] },
201
- "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"] },
202
- "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"] },
203
- "res:DraftCustomizationDiscardResponse": { "allOf": [{ "$ref": "res:DraftCustomizationDiscard" }, { "$ref": "res:ResponseMetadata" }] },
204
- "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"] },
205
- "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"] },
206
- "res:DraftHistoryRecoveryResponse": { "allOf": [{ "$ref": "res:DraftHistoryRecovery" }, { "$ref": "res:ResponseMetadata" }] },
207
- "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"] },
208
- "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"] },
209
- "res:PublicationResponse": { "allOf": [{ "$ref": "res:Publication" }, { "type": "object", "properties": { "created_at": { "type": "string" } }, "required": ["created_at"] }, { "$ref": "res:ResponseMetadata" }] },
206
+ "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"] },
207
+ "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"] },
208
+ "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"] },
209
+ "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"] },
210
+ "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"] },
211
+ "res:PublicationResponse": { "allOf": [{ "$ref": "res:Publication" }, { "$ref": "res:ResponseMetadata" }] },
212
+ "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"] },
210
213
  "res:GenerationResponse": { "allOf": [{ "$ref": "res:Generation" }, { "$ref": "res:ResponseMetadata" }] },
211
- "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"] },
212
- "res:FileStub": { "type": "object", "properties": { "path": { "type": "string" }, "bytes": { "type": "integer" }, "mode": { "type": "string" } }, "required": ["path", "bytes", "mode"] },
213
- "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"] },
214
- "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"] },
215
- "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"] },
216
- "res:DefinitionDocumentId": { "type": "string", "pattern": "^doc_[a-z0-9]{16}$" },
217
- "res:DefinitionRevisionSource": { "anyOf": [{ "$ref": "res:UrlDefinitionRevisionSource" }, { "$ref": "res:RepositoryDefinitionRevisionSource" }], "responseDiscriminator": { "propertyName": "kind", "mapping": { "url": { "$ref": "res:UrlDefinitionRevisionSource" }, "repository": { "$ref": "res:RepositoryDefinitionRevisionSource" } } } },
218
- "res:UrlDefinitionRevisionSource": { "type": "object", "properties": { "kind": { "type": "string" }, "url": { "type": "string" } }, "required": ["kind", "url"] },
219
- "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"] },
220
- "res:DefinitionRevisionResponse": { "allOf": [{ "$ref": "res:DefinitionRevision" }, { "$ref": "res:ResponseMetadata" }] },
221
- "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"] },
222
- "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"] },
214
+ "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"] },
215
+ "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" }] },
216
+ "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"] },
223
217
  "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"] },
224
- "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"] },
218
+ "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"] },
225
219
  "res:ApiKeyResponse": { "allOf": [{ "$ref": "res:ApiKey" }, { "$ref": "res:ResponseMetadata" }] },
226
220
  };