@typeship-ax/mcp 0.10.0 → 0.20.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 (107) hide show
  1. package/AGENTS.md +11 -5
  2. package/README.md +16 -5
  3. package/api.json +8824 -3777
  4. package/api.md +8359 -3987
  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 +29 -16
  8. package/dist/core/http.d.ts.map +1 -1
  9. package/dist/core/http.js +108 -25
  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 +20 -13
  14. package/dist/errors.d.ts.map +1 -1
  15. package/dist/errors.js +29 -20
  16. package/dist/index.d.ts +37 -19
  17. package/dist/index.d.ts.map +1 -1
  18. package/dist/index.js +42 -18
  19. package/dist/mcp-protocol.d.ts +10 -6
  20. package/dist/mcp-protocol.d.ts.map +1 -1
  21. package/dist/mcp-protocol.js +110 -39
  22. package/dist/mcp.d.ts.map +1 -1
  23. package/dist/mcp.js +38 -18
  24. package/dist/ops.d.ts +5 -1
  25. package/dist/ops.d.ts.map +1 -1
  26. package/dist/ops.js +42 -35
  27. package/dist/resources/api-keys.d.ts +44 -18
  28. package/dist/resources/api-keys.d.ts.map +1 -1
  29. package/dist/resources/api-keys.js +46 -14
  30. package/dist/resources/deliveries.d.ts +46 -0
  31. package/dist/resources/deliveries.d.ts.map +1 -0
  32. package/dist/resources/deliveries.js +70 -0
  33. package/dist/resources/drafts.d.ts +155 -0
  34. package/dist/resources/drafts.d.ts.map +1 -0
  35. package/dist/resources/drafts.js +230 -0
  36. package/dist/resources/files.d.ts +23 -0
  37. package/dist/resources/files.d.ts.map +1 -0
  38. package/dist/resources/files.js +38 -0
  39. package/dist/resources/generate.d.ts +49 -20
  40. package/dist/resources/generate.d.ts.map +1 -1
  41. package/dist/resources/generate.js +56 -14
  42. package/dist/resources/generations.d.ts +70 -18
  43. package/dist/resources/generations.d.ts.map +1 -1
  44. package/dist/resources/generations.js +84 -16
  45. package/dist/resources/organization.d.ts +18 -0
  46. package/dist/resources/organization.d.ts.map +1 -0
  47. package/dist/resources/organization.js +32 -0
  48. package/dist/resources/projects.d.ts +87 -124
  49. package/dist/resources/projects.d.ts.map +1 -1
  50. package/dist/resources/projects.js +70 -173
  51. package/dist/resources/publications.d.ts +46 -0
  52. package/dist/resources/publications.d.ts.map +1 -0
  53. package/dist/resources/publications.js +70 -0
  54. package/dist/resources/releases.d.ts +66 -0
  55. package/dist/resources/releases.d.ts.map +1 -0
  56. package/dist/resources/releases.js +101 -0
  57. package/dist/resources/spec-revisions.d.ts +85 -0
  58. package/dist/resources/spec-revisions.d.ts.map +1 -0
  59. package/dist/resources/spec-revisions.js +116 -0
  60. package/dist/resources/specs.d.ts +72 -0
  61. package/dist/resources/specs.d.ts.map +1 -0
  62. package/dist/resources/specs.js +107 -0
  63. package/dist/resources/targets.d.ts +85 -105
  64. package/dist/resources/targets.d.ts.map +1 -1
  65. package/dist/resources/targets.js +70 -163
  66. package/dist/schemas.d.ts.map +1 -1
  67. package/dist/schemas.js +175 -129
  68. package/dist/types.d.ts +2626 -1141
  69. package/dist/types.d.ts.map +1 -1
  70. package/dist/types.js +90 -11
  71. package/package.json +3 -3
  72. package/server.json +3 -3
  73. package/src/api-identity.ts +6 -2
  74. package/src/core/http.ts +106 -30
  75. package/src/core/pagination.ts +13 -23
  76. package/src/errors.ts +30 -20
  77. package/src/index.ts +46 -24
  78. package/src/mcp-protocol.ts +95 -38
  79. package/src/mcp.ts +34 -16
  80. package/src/ops.ts +47 -36
  81. package/src/resources/api-keys.ts +87 -19
  82. package/src/resources/deliveries.ts +139 -0
  83. package/src/resources/drafts.ts +422 -0
  84. package/src/resources/files.ts +68 -0
  85. package/src/resources/generate.ts +81 -19
  86. package/src/resources/generations.ts +167 -29
  87. package/src/resources/organization.ts +53 -0
  88. package/src/resources/projects.ts +129 -322
  89. package/src/resources/publications.ts +139 -0
  90. package/src/resources/releases.ts +199 -0
  91. package/src/resources/spec-revisions.ts +237 -0
  92. package/src/resources/specs.ts +200 -0
  93. package/src/resources/targets.ts +135 -304
  94. package/src/schemas.ts +175 -129
  95. package/src/types.ts +2793 -1177
  96. package/dist/resources/account.d.ts +0 -18
  97. package/dist/resources/account.d.ts.map +0 -1
  98. package/dist/resources/account.js +0 -27
  99. package/dist/resources/definition-revisions.d.ts +0 -58
  100. package/dist/resources/definition-revisions.d.ts.map +0 -1
  101. package/dist/resources/definition-revisions.js +0 -114
  102. package/dist/resources/definitions.d.ts +0 -35
  103. package/dist/resources/definitions.d.ts.map +0 -1
  104. package/dist/resources/definitions.js +0 -60
  105. package/src/resources/account.ts +0 -46
  106. package/src/resources/definition-revisions.ts +0 -207
  107. package/src/resources/definitions.ts +0 -122
package/src/schemas.ts CHANGED
@@ -7,170 +7,216 @@
7
7
 
8
8
  export const SCHEMAS: Record<string, { req?: unknown; res?: unknown }> = {
9
9
  "generate.run": {"req":{"$ref":"req:GenerateRequest"},"res":{"$ref":"res:GenerationResult"}},
10
+ "generate.downloadPackage": {"res":{"type":"string"}},
10
11
  "projects.list": {"res":{"$ref":"res:ProjectList"}},
11
12
  "projects.create": {"req":{"$ref":"req:CreateProjectRequest"},"res":{"$ref":"res:Project"}},
12
- "projects.retrieve": {"res":{"$ref":"res:Project"}},
13
+ "projects.get": {"res":{"$ref":"res:Project"}},
13
14
  "projects.delete": {"res":{"$ref":"res:DeletedProject"}},
14
15
  "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
- "projects.generate": {"res":{"$ref":"res:GenerationBatch"}},
21
- "definitions.retrieve": {"res":{"$ref":"res:Definition"}},
22
- "definitions.update": {"req":{"$ref":"req:DefinitionUpdateRequest"},"res":{"$ref":"res:Definition"}},
16
+ "projects.generate": {"req":{"$ref":"req:GenerateProjectRequest"},"res":{"$ref":"res:GenerationBatch"}},
17
+ "specs.get": {"res":{"$ref":"res:Spec"}},
18
+ "specs.update": {"req":{"$ref":"req:SpecUpdateRequest"},"res":{"$ref":"res:Spec"}},
19
+ "specs.refresh": {"res":{"$ref":"res:Spec"}},
20
+ "specRevisions.list": {"res":{"$ref":"res:SpecRevisionList"}},
21
+ "specRevisions.get": {"res":{"$ref":"res:SpecRevisionResponse"}},
22
+ "specRevisions.listFiles": {"res":{"$ref":"res:SpecRevisionFileList"}},
23
23
  "targets.list": {"res":{"$ref":"res:TargetList"}},
24
- "targets.create": {"req":{"$ref":"req:TargetFields"},"res":{"$ref":"res:TargetResponse"}},
25
- "targets.retrieve": {"res":{"$ref":"res:TargetResponse"}},
24
+ "targets.create": {"req":{"$ref":"req:TargetCreateRequest"},"res":{"$ref":"res:TargetResponse"}},
25
+ "targets.get": {"res":{"$ref":"res:TargetResponse"}},
26
26
  "targets.delete": {"res":{"$ref":"res:DeletedTarget"}},
27
27
  "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
- "generations.retrieve": {"res":{"$ref":"res:GenerationResponse"}},
35
- "generations.retrieveFile": {"res":{"type":"string"}},
36
- "definitionRevisions.list": {"res":{"$ref":"res:DefinitionRevisionList"}},
37
- "definitionRevisions.retrieve": {"res":{"$ref":"res:DefinitionRevisionResponse"}},
38
- "definitionRevisions.retrieveContent": {"res":{"type":"string"}},
39
- "definitionRevisions.retrieveDocumentContent": {"res":{"type":"string"}},
40
- "account.retrieve": {"res":{"$ref":"res:Account"}},
28
+ "targets.adopt": {"req":{"$ref":"req:TargetAdoption"},"res":{"$ref":"res:ReleaseResponse"}},
29
+ "drafts.list": {"res":{"$ref":"res:DraftList"}},
30
+ "drafts.get": {"res":{"$ref":"res:DraftResponse"}},
31
+ "drafts.update": {"req":{"$ref":"req:DraftUpdateRequest"},"res":{"$ref":"res:DraftResponse"}},
32
+ "drafts.listFiles": {"res":{"$ref":"res:DraftFileList"}},
33
+ "drafts.resolve": {"req":{"$ref":"req:DraftResolveRequest"},"res":{"$ref":"res:DraftResponse"}},
34
+ "drafts.recover": {"req":{"$ref":"req:DraftRecoverRequest"},"res":{"$ref":"res:DraftResponse"}},
35
+ "releases.list": {"res":{"$ref":"res:ReleaseList"}},
36
+ "releases.get": {"res":{"$ref":"res:ReleaseResponse"}},
37
+ "releases.republish": {"res":{"$ref":"res:ReleaseResponse"}},
38
+ "deliveries.list": {"res":{"$ref":"res:DeliveryList"}},
39
+ "deliveries.get": {"res":{"$ref":"res:DeliveryResponse"}},
40
+ "publications.list": {"res":{"$ref":"res:PublicationList"}},
41
+ "publications.get": {"res":{"$ref":"res:PublicationResponse"}},
42
+ "generations.list": {"res":{"$ref":"res:GenerationList"}},
43
+ "generations.get": {"res":{"$ref":"res:GenerationResponse"}},
44
+ "generations.listFiles": {"res":{"$ref":"res:FileList"}},
45
+ "files.get": {"res":{"$ref":"res:FileResponse"}},
46
+ "organization.get": {"res":{"$ref":"res:Organization"}},
41
47
  "apiKeys.list": {"res":{"$ref":"res:ApiKeyList"}},
48
+ "apiKeys.get": {"res":{"$ref":"res:ApiKeyResponse"}},
42
49
  "apiKeys.revoke": {"res":{"$ref":"res:ApiKeyResponse"}},
43
50
  };
44
51
 
45
52
  export const DEFS: Record<string, unknown> = {
46
- "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"},"config":{"$ref":"req:Config"}},"required":["definition","target"]},
47
- "req:DefinitionInput": {"anyOf":[{"$ref":"req:UrlDefinitionInput"},{"$ref":"req:InlineDefinitionInput"}]},
48
- "req:UrlDefinitionInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","pattern":"^https?://"},"headers":{"type":"object"}},"required":["url"]},
49
- "req:InlineDefinitionInput": {"type":"object","additionalProperties":false,"properties":{"inline":{"type":"string"}},"required":["inline"]},
50
- "req:GeneratorKind": {"type":"string","enum":["typescript-sdk","python-sdk","go-sdk","cli","mcp"]},
53
+ "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"]},
54
+ "req:SpecInput": {"anyOf":[{"$ref":"req:UrlSpecInput"},{"$ref":"req:InlineSpecInput"}]},
55
+ "req:UrlSpecInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","pattern":"^https?://"},"headers":{"type":"object"}},"required":["url"]},
56
+ "req:InlineSpecInput": {"type":"object","additionalProperties":false,"properties":{"inline":{"type":"string"}},"required":["inline"]},
57
+ "req:GeneratorKind": {"type":"string","enum":["cli","go_cli","mcp","typescript_sdk","python_sdk","go_sdk"]},
58
+ "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"]},
51
59
  "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"]}}},
52
60
  "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"}}},
53
61
  "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"}}},
54
62
  "req:AuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_server":{"anyOf":[{"$ref":"req:OAuthServer"},{"type":"null"}]},"oauth_applications":{"type":["object","null"]},"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"identity_verification":{"anyOf":[{"$ref":"req:IdentityVerification"},{"type":"null"}]},"approval_url":{"type":["string","null"]},"environments":{"type":["object","null"]}}},
55
63
  "req:OAuthServer": {"type":"object","additionalProperties":false,"properties":{"issuer":{"type":["string","null"]},"discovery_url":{"type":["string","null"]},"authorization_url":{"type":["string","null"]},"token_url":{"type":["string","null"]},"device_authorization_url":{"type":["string","null"]},"scopes":{"type":["array","null"],"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":500,"pattern":"^\\S+$"}},"audience":{"type":["string","null"]},"resource":{"type":["string","null"]}}},
56
- "req:IdentityVerification": {"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","maxLength":2000,"pattern":"^[\\w$]+\\.[\\w$]+$"},"subject_field":{"type":"string","maxLength":512},"account_field":{"type":"string","maxLength":512},"organization_field":{"type":"string","maxLength":512}}},
57
- "req:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
64
+ "req:IdentityVerification": {"allOf":[{"type":"object","additionalProperties":false,"properties":{"operation":{"type":["string","null"],"maxLength":2000,"pattern":"^[\\w$]+\\.[\\w$]+$"},"subject_field":{"type":["string","null"],"maxLength":512,"pattern":"^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$"},"account_field":{"type":["string","null"],"maxLength":512,"pattern":"^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$"},"organization_field":{"type":["string","null"],"maxLength":512,"pattern":"^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$"}}},{"anyOf":[{"properties":{"subject_field":{"type":"string"}},"required":["subject_field"],"type":"object"},{"properties":{"account_field":{"type":"string"}},"required":["account_field"],"type":"object"},{"properties":{"organization_field":{"type":"string"}},"required":["organization_field"],"type":"object"}]}]},
65
+ "req:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"changelog_url":{"type":["string","null"]},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
58
66
  "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"}}},
59
67
  "req:ReadmeBehavior": {"type":"object","additionalProperties":false,"properties":{"quickstart_operation":{"type":["string","null"],"maxLength":500}}},
60
68
  "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"]}}},
61
- "res:GenerationResult": {"type":"object","properties":{"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"warnings":{"type":"array","items":{"type":"string"}},"meta":{"$ref":"res:GenerationMeta"},"limits":{"$ref":"res:GenerationLimits"},"claim":{"anyOf":[{"type":"null"},{"type":"object","properties":{"url":{"type":"string"},"expires_at":{"type":"string"}},"required":["url","expires_at"]}]},"request_id":{"$ref":"res:RequestId"}},"required":["files","warnings","meta","request_id"]},
62
- "res:GeneratedFile": {"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]},
63
- "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"}},"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"},"pr_error":{"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"},"file_count":{"type":"integer"},"total_lines":{"type":"integer"},"diagnostics":{"type":"object","additionalProperties":false,"properties":{"format":{"type":"string"},"summary":{"$ref":"res:DiagnosticSummary"}},"required":["format","summary"]}},"required":["title","api_version","version","oas_version","artifact_name","client_name","generators"]},
64
- "res:GeneratorKind": {"type":"string"},
65
- "res:DiagnosticSummary": {"type":"object","additionalProperties":false,"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"]},
66
- "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"]},
69
+ "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"]},
70
+ "res:GeneratedFile": {"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"},"mode":{"type":"string"}},"required":["path","content"]},
71
+ "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"]},
72
+ "res:GenerationWarning": {"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"operation":{"type":"string"}},"required":["code","message"]},
73
+ "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"]},
67
74
  "res:RequestId": {"type":"string","pattern":"^req_[a-z0-9]{16}$"},
68
- "res:ProjectList": {"type":"object","additionalProperties":false,"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"]},
75
+ "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"]},
69
76
  "res:ListObject": {"type":"string"},
70
- "res:ProjectSummary": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"definition_id":{"$ref":"res:DefinitionId"},"auto_generate":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","name","definition_id","auto_generate","created_at","updated_at"]},
77
+ "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"]},
71
78
  "res:ProjectId": {"type":"string","pattern":"^prj_[a-z0-9]{16}$"},
72
- "res:DefinitionId": {"type":"string","pattern":"^def_[a-z0-9]{16}$"},
73
- "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"]},
74
- "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"]},
75
- "req:DefinitionSourceInput": {"anyOf":[{"$ref":"req:UrlDefinitionSourceInput"},{"$ref":"req:RepositoryDefinitionSourceInput"}]},
76
- "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"]},
77
- "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"]},
78
- "req:RepositoryReference": {"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string","enum":["github"]},"identifier":{"type":"string","maxLength":512}},"required":["provider","identifier"]},
79
- "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"]},
79
+ "res:SpecId": {"type":"string","pattern":"^spec_[a-z0-9]{16}$"},
80
+ "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"]},
81
+ "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"]},
82
+ "req:SpecSourceInput": {"anyOf":[{"$ref":"req:UrlSpecSourceInput"},{"$ref":"req:RepositorySpecSourceInput"}]},
83
+ "req:UrlSpecSourceInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"url"},"url":{"$ref":"req:UrlSpecSourceSettingsInput"}},"required":["type","url"]},
84
+ "req:UrlSpecSourceSettingsInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers":{"anyOf":[{"type":"object"},{"type":"null"}]}},"required":["url"]},
85
+ "req:RepositorySpecSourceInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositorySpecSourceSettingsInput"}},"required":["type","repository"]},
86
+ "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"]},
87
+ "req:RepositoryProvider": {"type":"string","enum":["github"]},
88
+ "req:RepositoryIdentifier": {"type":"string","maxLength":512},
89
+ "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"]},
80
90
  "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"]},
81
91
  "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"]},
82
- "req:InitialTargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","generator"]},
83
- "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: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
+ "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:TargetCliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
84
95
  "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"]}}},
96
+ "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"}}},
85
97
  "req:DeliveryInput": {"anyOf":[{"$ref":"req:RepositoryDeliveryInput"},{"$ref":"req:HostedMcpDeliveryInput"}]},
86
- "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"]},
87
- "req:HostedMcpDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"hosted_mcp"}},"required":["kind"]},
98
+ "req:RepositoryDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositoryDeliverySettingsInput"}},"required":["type","repository"]},
99
+ "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"]},
100
+ "req:HostedMcpDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"hosted_mcp"}},"required":["type"]},
88
101
  "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"]}}},
89
- "res:Project": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"definition_id":{"$ref":"res:DefinitionId"},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"res:ProjectConfig"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","definition_id","auto_generate","relay_enabled","config","created_at","updated_at","request_id"]},
90
- "res:ProjectConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"res:AuthenticationConfig"},"cli":{"$ref":"res:CliBehavior"},"mcp":{"$ref":"res:McpBehavior"},"readme":{"$ref":"res:ReadmeBehavior"},"package":{"$ref":"res:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
91
- "res:RetryTuning": {"type":"object","additionalProperties":false,"properties":{"max_retries":{"type":"integer","minimum":0,"maximum":10},"statuses":{"type":"array","maxItems":20,"items":{"type":"integer"}},"initial_delay_ms":{"type":"integer","minimum":1},"max_delay_ms":{"type":"integer","minimum":1},"retry_non_idempotent":{"type":"boolean"},"disabled":{"type":"boolean"},"operations":{"type":"object"}}},
92
- "res:AuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_server":{"anyOf":[{"$ref":"res:OAuthServer"},{"type":"null"}]},"oauth_applications":{"type":["object","null"]},"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"identity_verification":{"anyOf":[{"$ref":"res:IdentityVerification"},{"type":"null"}]},"approval_url":{"type":["string","null"]},"environments":{"type":["object","null"]}}},
93
- "res:OAuthServer": {"type":"object","additionalProperties":false,"properties":{"issuer":{"type":["string","null"]},"discovery_url":{"type":["string","null"]},"authorization_url":{"type":["string","null"]},"token_url":{"type":["string","null"]},"device_authorization_url":{"type":["string","null"]},"scopes":{"type":["array","null"],"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":500,"pattern":"^\\S+$"}},"audience":{"type":["string","null"]},"resource":{"type":["string","null"]}}},
94
- "res:IdentityVerification": {"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","maxLength":2000,"pattern":"^[\\w$]+\\.[\\w$]+$"},"subject_field":{"type":"string","maxLength":512},"account_field":{"type":"string","maxLength":512},"organization_field":{"type":"string","maxLength":512}}},
95
- "res:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
96
- "res:McpBehavior": {"type":"object","additionalProperties":false,"properties":{"registry_name":{"type":["string","null"]},"access":{"type":"object","additionalProperties":false,"properties":{"issuer":{"type":"string"},"resource":{"type":"string"},"jwks_url":{"type":"string"},"scopes":{"type":"array","maxItems":20,"items":{"type":"string"}}},"required":["issuer","resource"]},"tool_mode":{"type":"string"},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"},"reference_resolvers":{"type":"object"}}},
97
- "res:ReadmeBehavior": {"type":"object","additionalProperties":false,"properties":{"quickstart_operation":{"type":["string","null"],"maxLength":500}}},
98
- "res:PackageBehavior": {"type":"object","additionalProperties":false,"properties":{"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"go_package_name":{"type":["string","null"]}}},
99
- "res:DeletedProject": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
100
- "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"}]}}},
101
- "res:DiagnosticReport": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"format":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"$ref":"res:DefinitionRevisionId"},"source_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"analyzed_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"patch_diagnostics":{"type":"array","items":{"type":"string"}},"summary":{"$ref":"res:DiagnosticSummary"},"diagnostics":{"type":"array","items":{"$ref":"res:Diagnostic"}},"policy":{"$ref":"res:DiagnosticPolicy"},"evaluation":{"$ref":"res:DiagnosticEvaluation"},"quality_signals":{"$ref":"res:DiagnosticQualitySignals"},"delta":{"$ref":"res:DiagnosticDelta"},"request_id":{"$ref":"res:RequestId"}},"required":["object","format","project_id","definition_revision_id","source_sha256","analyzed_sha256","patch_diagnostics","summary","diagnostics","policy","evaluation","quality_signals","delta","request_id"]},
102
- "res:DefinitionRevisionId": {"type":"string","pattern":"^drev_[a-z0-9]{16}$"},
103
- "res:Diagnostic": {"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"severity":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"impact":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"evidence_basis":{"type":"string"},"owner_decision_required":{"type":"boolean"},"surface_impact":{"type":"string"},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}},"fix":{"$ref":"res:DiagnosticFix"},"authoring_brief":{"type":"string"}},"required":["id","severity","category","title","description","impact","surfaces","evidence_basis","owner_decision_required","locations","authoring_brief"]},
104
- "res:DiagnosticLocation": {"type":"object","additionalProperties":false,"properties":{"document":{"type":"string"},"path":{"type":"string"},"operation":{"type":"string"},"evidence":{"type":"string"}},"required":["path"]},
105
- "res:DiagnosticFix": {"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"kind":{"type":"string"},"patches":{"type":"array","items":{"$ref":"res:DefinitionPatch"}},"instructions":{"type":"string"}},"required":["title","kind"]},
106
- "res:DefinitionPatch": {"type":"object","additionalProperties":false,"properties":{"op":{"type":"string"},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
107
- "res:DiagnosticPolicy": {"type":"object","additionalProperties":false,"properties":{"fail_on":{"type":"string"},"only_new":{"type":"boolean"},"suppressions":{"type":"array","maxItems":100,"items":{"$ref":"res:DiagnosticSuppression"}}},"required":["fail_on","only_new","suppressions"]},
108
- "res:DiagnosticSuppression": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string","maxLength":160},"path":{"type":"string","maxLength":4096},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["rule_id","reason"]},
109
- "res:DiagnosticEvaluation": {"type":"object","additionalProperties":false,"properties":{"state":{"type":"string"},"blocking":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"considered_occurrences":{"type":"integer","minimum":0},"suppressed_occurrences":{"type":"integer","minimum":0}},"required":["state","blocking","considered_occurrences","suppressed_occurrences"]},
110
- "res:DiagnosticReference": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string"},"severity":{"type":"string"},"title":{"type":"string"},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}}},"required":["rule_id","severity","title","locations"]},
111
- "res:DiagnosticQualitySignals": {"type":"object","additionalProperties":false,"properties":{"suppressed_by_rule":{"type":"array","items":{"$ref":"res:DiagnosticSuppressionSignal"}},"stale_suppressions":{"type":"array","items":{"$ref":"res:DiagnosticSuppression"}}},"required":["suppressed_by_rule","stale_suppressions"]},
112
- "res:DiagnosticSuppressionSignal": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string"},"active_occurrences":{"type":"integer","minimum":0},"suppressed_occurrences":{"type":"integer","minimum":1}},"required":["rule_id","active_occurrences","suppressed_occurrences"]},
113
- "res:DiagnosticDelta": {"type":"object","additionalProperties":false,"properties":{"added":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"resolved":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"baseline_definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]}},"required":["added","resolved","baseline_definition_revision_id"]},
114
- "req:DiagnosticRemediationRequest": {"type":"object","additionalProperties":false,"properties":{"diagnostic_ids":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string"}}},"required":["diagnostic_ids"]},
115
- "res:DiagnosticRemediation": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"kind":{"type":"string"},"patches_applied":{"type":"integer","minimum":0},"review_url":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","kind","patches_applied","request_id"]},
116
- "res:RepositoryIntegrationHealth": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"status":{"type":"string"},"repositories":{"type":"array","items":{"$ref":"res:RepositoryHealth"}},"required_checks":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"array","items":{"type":"string"}},"destination":{"type":"array","items":{"type":"string"}}},"required":["source","destination"]},"last_event":{"anyOf":[{"$ref":"res:RepositoryEventHealth"},{"type":"null"}]},"request_id":{"$ref":"res:RequestId"}},"required":["object","project_id","status","repositories","required_checks","last_event","request_id"]},
117
- "res:RepositoryHealth": {"type":"object","additionalProperties":false,"properties":{"repository":{"$ref":"res:RepositoryReference"},"roles":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"default_branch":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"breaking_acknowledgement":{"type":["boolean","null"]},"definition":{"type":"string"},"issues":{"type":"array","items":{"$ref":"res:RepositoryHealthIssue"}}},"required":["repository","roles","status","issues"]},
118
- "res:RepositoryReference": {"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string"},"identifier":{"type":"string","maxLength":512}},"required":["provider","identifier"]},
119
- "res:RepositoryHealthIssue": {"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},
120
- "res:RepositoryEventHealth": {"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string"},"id":{"type":"string"},"event":{"type":"string"},"status":{"type":"string"},"error":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["provider","id","event","status","error","created_at"]},
121
- "res:GenerationList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:GenerationSummary"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
122
- "res:GenerationSummary": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"$ref":"res:GenerationProvenance"},"meta":{"anyOf":[{"$ref":"res:GenerationMeta"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","meta","warnings","error","created_at"]},
102
+ "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"]},
103
+ "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"]}}},
104
+ "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"}}},
105
+ "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"]}}},
106
+ "res:OAuthServerResponse": {"type":"object","properties":{"issuer":{"type":["string","null"]},"discovery_url":{"type":["string","null"]},"authorization_url":{"type":["string","null"]},"token_url":{"type":["string","null"]},"device_authorization_url":{"type":["string","null"]},"scopes":{"type":["array","null"],"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":500,"pattern":"^\\S+$"}},"audience":{"type":["string","null"]},"resource":{"type":["string","null"]}}},
107
+ "res:IdentityVerificationResponse": {"allOf":[{"type":"object","properties":{"operation":{"type":["string","null"],"maxLength":2000,"pattern":"^[\\w$]+\\.[\\w$]+$"},"subject_field":{"type":["string","null"],"maxLength":512,"pattern":"^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$"},"account_field":{"type":["string","null"],"maxLength":512,"pattern":"^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$"},"organization_field":{"type":["string","null"],"maxLength":512,"pattern":"^/(?:[^~\\x00-\\x1f\\x7f]|~[01])*$"}}},{"anyOf":[{"properties":{"subject_field":{"type":"string"}},"required":["subject_field"],"type":"object"},{"properties":{"account_field":{"type":"string"}},"required":["account_field"],"type":"object"},{"properties":{"organization_field":{"type":"string"}},"required":["organization_field"],"type":"object"}]}]},
108
+ "res:CliBehaviorResponse": {"type":"object","properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"changelog_url":{"type":["string","null"]},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
109
+ "res:McpBehaviorResponse": {"type":"object","properties":{"registry_name":{"type":["string","null"]},"access":{"type":"object","properties":{"issuer":{"type":"string"},"resource":{"type":"string"},"jwks_url":{"type":"string"},"scopes":{"type":"array","maxItems":20,"items":{"type":"string"}}},"required":["issuer","resource"]},"tool_mode":{"type":"string"},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"},"reference_resolvers":{"type":"object"}}},
110
+ "res:ReadmeBehaviorResponse": {"type":"object","properties":{"quickstart_operation":{"type":["string","null"],"maxLength":500}}},
111
+ "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"]}}},
112
+ "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"]},
113
+ "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"}]}}},
114
+ "req:GenerateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"target_id":{"$ref":"req:TargetId"}}},
115
+ "req:TargetId": {"type":"string","pattern":"^tgt_[a-z0-9]{16}$"},
116
+ "res:GenerationBatch": {"type":"object","properties":{"data":{"type":"array","items":{"$ref":"res:GenerationSummary"}},"request_id":{"$ref":"res:RequestId"}},"required":["data","request_id"]},
117
+ "res:GenerationSummary": {"allOf":[{"$ref":"res:Generation"}]},
118
+ "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"]},
123
119
  "res:GenerationId": {"type":"string","pattern":"^gen_[a-z0-9]{16}$"},
120
+ "res:SpecRevisionId": {"type":"string","pattern":"^srev_[a-z0-9]{16}$"},
124
121
  "res:GenerationStatus": {"type":"string"},
125
122
  "res:GenerationTrigger": {"type":"string"},
126
123
  "res:TargetId": {"type":"string","pattern":"^tgt_[a-z0-9]{16}$"},
127
- "res:GenerationProvenance": {"type":"object","additionalProperties":false,"properties":{"generator_edition":{"type":"string"},"engine_build":{"type":"string"},"resolved_config":{"type":["object","null"]},"config_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"surface_plan":{"type":["object","null"]},"surface_plan_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"entitlement_cap":{"type":["integer","null"],"minimum":1},"package_version":{"type":["string","null"]}},"required":["generator_edition","engine_build","resolved_config","config_hash","surface_plan","surface_plan_hash","entitlement_cap","package_version"]},
128
- "res:GenerationBatch": {"type":"object","additionalProperties":false,"properties":{"data":{"type":"array","items":{"anyOf":[{"$ref":"res:GenerationSummary"},{"$ref":"res:GenerationFailure"}]}},"request_id":{"$ref":"res:RequestId"}},"required":["data","request_id"]},
129
- "res:GenerationFailure": {"type":"object","additionalProperties":false,"properties":{"target_id":{"$ref":"res:TargetId"},"generator":{"$ref":"res:GeneratorKind"},"status":{"type":"string"},"error":{"type":"string"}},"required":["target_id","generator","status","error"]},
130
- "res:Definition": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DefinitionId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"source":{"$ref":"res:DefinitionSource"},"format":{"type":["string","null"]},"patches":{"type":"array","items":{"$ref":"res:DefinitionPatch"}},"graphql":{"anyOf":[{"$ref":"res:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"res:DiagnosticPolicy"},"latest_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","source","format","patches","graphql","diagnostic_policy","latest_revision_id","created_at","updated_at","request_id"]},
131
- "res:DefinitionSource": {"anyOf":[{"$ref":"res:UrlDefinitionSource"},{"$ref":"res:RepositoryDefinitionSource"},{"type":"object"}]},
132
- "res:UrlDefinitionSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string"},"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers_configured":{"type":"boolean"}},"required":["kind","url","headers_configured"]},
133
- "res:RepositoryDefinitionSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string"},"repository":{"$ref":"res:RepositoryReference"},"path":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^(?!/)(?!.*\\.\\.).+$"}},"required":["kind","repository","path"]},
134
- "res:GraphqlSettings": {"type":"object","additionalProperties":false,"properties":{"endpoint":{"type":"string"},"environments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"auth":{"type":"string"},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
135
- "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"}}},
136
- "res:TargetList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Target"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
137
- "res:Target": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"name":{"type":"string"},"generator":{"$ref":"res:GeneratorKind"},"state":{"type":"string"},"edition":{"type":"string"},"release_channel":{"type":"string"},"version_policy":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"pre1_breaking":{"type":"string"}},"required":["mode","pre1_breaking"]},"current_version":{"type":["string","null"]},"proposed_version":{"type":["string","null"]},"proposed_version_source":{"type":["string","null"]},"proposed_version_actor":{"type":["string","null"]},"release_revision":{"type":"integer","minimum":0},"config":{"anyOf":[{"$ref":"res:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"res:Delivery"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","name","generator","state","edition","release_channel","version_policy","current_version","proposed_version","proposed_version_source","proposed_version_actor","release_revision","config","deliveries","created_at","updated_at"]},
138
- "res:TargetConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"res:TargetAuthenticationConfig"},"cli":{"$ref":"res:CliBehavior"},"mcp":{"$ref":"res:McpBehavior"},"readme":{"$ref":"res:ReadmeBehavior"},"package":{"$ref":"res:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
139
- "res:TargetAuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
140
- "res:Delivery": {"anyOf":[{"$ref":"res:RepositoryDelivery"},{"$ref":"res:HostedMcpDelivery"},{"type":"object"}]},
141
- "res:RepositoryDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"repository":{"$ref":"res:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","repository","directory","package_name","module_path","publish_on_merge","created_at","updated_at"]},
124
+ "res:GeneratorKind": {"type":"string"},
125
+ "res:DomainError": {"allOf":[{"$ref":"res:ErrorDetail"},{"type":"object","properties":{"phase":{"$ref":"res:FailurePhase"}},"required":["phase"]}]},
126
+ "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"]},
127
+ "res:ErrorType": {"type":"string"},
128
+ "res:ErrorCode": {"type":"string"},
129
+ "res:FailurePhase": {"type":"string"},
130
+ "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"]},
131
+ "res:SpecSource": {"anyOf":[{"$ref":"res:UrlSpecSource"},{"$ref":"res:RepositorySpecSource"}],"responseDiscriminator":{"propertyName":"type","mapping":{"url":{"$ref":"res:UrlSpecSource"},"repository":{"$ref":"res:RepositorySpecSource"}}}},
132
+ "res:UrlSpecSource": {"type":"object","properties":{"type":{"type":"string"},"url":{"$ref":"res:UrlSpecSourceSettings"}},"required":["type","url"]},
133
+ "res:UrlSpecSourceSettings": {"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers_configured":{"type":"boolean"}},"required":["url","headers_configured"]},
134
+ "res:RepositorySpecSource": {"type":"object","properties":{"type":{"type":"string"},"repository":{"$ref":"res:RepositorySpecSourceSettings"}},"required":["type","repository"]},
135
+ "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"]},
136
+ "res:RepositoryProvider": {"type":"string"},
137
+ "res:RepositoryIdentifier": {"type":"string","maxLength":512},
138
+ "res:SpecPatchResponse": {"type":"object","properties":{"op":{"type":"string"},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
139
+ "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"}}},
140
+ "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"]},
141
+ "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"]},
142
+ "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"}}},
143
+ "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"]},
144
+ "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"]},
145
+ "res:SpecRevisionSource": {"anyOf":[{"$ref":"res:UrlSpecRevisionSource"},{"$ref":"res:RepositorySpecRevisionSource"}],"responseDiscriminator":{"propertyName":"type","mapping":{"url":{"$ref":"res:UrlSpecRevisionSource"},"repository":{"$ref":"res:RepositorySpecRevisionSource"}}}},
146
+ "res:UrlSpecRevisionSource": {"type":"object","properties":{"type":{"type":"string"},"url":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}},"required":["type","url"]},
147
+ "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"]},
148
+ "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"]},
149
+ "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"]},
150
+ "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"]},
151
+ "res:FileId": {"type":"string","pattern":"^file_[a-z0-9]{16}$"},
152
+ "res:DiagnosticFix": {"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"patches":{"type":"array","items":{"$ref":"res:SpecPatchResponse"}},"instructions":{"type":"string"}},"required":["title","type"]},
153
+ "res:DiagnosticWarning": {"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},
154
+ "res:SpecRevisionResponse": {"allOf":[{"$ref":"res:SpecRevision"},{"$ref":"res:ResponseMetadata"}]},
155
+ "res:ResponseMetadata": {"type":"object","properties":{"request_id":{"$ref":"res:RequestId"}},"required":["request_id"]},
156
+ "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"]},
157
+ "res:SpecRevisionFile": {"allOf":[{"$ref":"res:File"},{"type":"object","properties":{"role":{"type":"string"}},"required":["role"]}]},
158
+ "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"]},
159
+ "res:GitFileMode": {"type":"string"},
160
+ "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"]},
161
+ "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"]},
162
+ "res:TargetDependency": {"type":"object","properties":{"type":{"type":"string"},"target_id":{"$ref":"res:TargetId"}},"required":["type","target_id"]},
163
+ "res:DraftId": {"type":"string","pattern":"^drf_[a-z0-9]{16}$"},
164
+ "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"]}}}},
165
+ "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"]}}},
166
+ "res:TargetAuthenticationConfigResponse": {"type":"object","properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
167
+ "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"}}},
168
+ "res:Delivery": {"anyOf":[{"$ref":"res:RepositoryDelivery"},{"$ref":"res:HostedMcpDelivery"}],"responseDiscriminator":{"propertyName":"type","mapping":{"repository":{"$ref":"res:RepositoryDelivery"},"hosted_mcp":{"$ref":"res:HostedMcpDelivery"}}}},
169
+ "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"]},
142
170
  "res:DeliveryId": {"type":"string","pattern":"^dlv_[a-z0-9]{16}$"},
143
- "res:HostedMcpDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"url":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","url","created_at","updated_at"]},
144
- "req:TargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"definition_id":{"$ref":"req:DefinitionId"},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","definition_id","generator"]},
145
- "req:DefinitionId": {"type":"string","pattern":"^def_[a-z0-9]{16}$"},
171
+ "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"]},
172
+ "res:RepositoryDeliveryIssue": {"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},
173
+ "res:RepositoryDeliveryEvent": {"type":"object","properties":{"event":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string"}},"required":["event","status","created_at"]},
174
+ "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"]},
175
+ "res:HostedMcpDeliverySettings": {"type":"object","properties":{"url":{"type":["string","null"]}},"required":["url"]},
176
+ "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"]},
177
+ "req:ProjectId": {"type":"string","pattern":"^prj_[a-z0-9]{16}$"},
178
+ "req:SpecId": {"type":"string","pattern":"^spec_[a-z0-9]{16}$"},
146
179
  "res:TargetResponse": {"allOf":[{"$ref":"res:Target"},{"$ref":"res:ResponseMetadata"}]},
147
- "res:ResponseMetadata": {"type":"object","properties":{"request_id":{"$ref":"res:RequestId"}},"required":["request_id"]},
148
- "res:DeletedTarget": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
149
- "req:TargetUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}}},
150
- "res:TargetReleaseList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:TargetRelease"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
151
- "res:TargetRelease": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetReleaseId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"generation_id":{"anyOf":[{"$ref":"res:GenerationId"},{"type":"null"}]},"origin":{"type":"string"},"version":{"type":"string"},"channel":{"type":"string"},"provider":{"type":"string"},"repository":{"anyOf":[{"$ref":"res:RepositoryReference"},{"type":"null"}]},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"delivery_revision":{"type":"string"},"import_provenance":{"type":["object","null"],"additionalProperties":false,"properties":{"tag":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"imported_at":{"type":["string","null"]}},"required":["tag","registry_url","artifact_digest","imported_at"]},"publications":{"type":"array","items":{"$ref":"res:Publication"}},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","generation_id","version","channel","origin","provider","repository","definition_revision_id","delivery_revision","import_provenance","publications","created_at"]},
152
- "res:TargetReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
153
- "res:Publication": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:PublicationId"},"object":{"type":"string"},"target_release_id":{"$ref":"res:TargetReleaseId"},"destination":{"type":"string"},"state":{"type":"string"},"attempt":{"type":"integer","minimum":0},"run_url":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"error":{"type":["string","null"]},"started_at":{"type":["string","null"]},"finished_at":{"type":["string","null"]},"updated_at":{"type":"string"}},"required":["id","object","target_release_id","destination","state","attempt","run_url","registry_url","artifact_digest","error","started_at","finished_at","updated_at"]},
154
- "res:PublicationId": {"type":"string","pattern":"^pub_[a-z0-9]{16}$"},
155
- "res:TargetDraftResponse": {"allOf":[{"$ref":"res:TargetDraft"},{"$ref":"res:ResponseMetadata"}]},
156
- "res:TargetDraft": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"revision":{"type":"integer","minimum":0},"current_version":{"type":["string","null"]},"version":{"type":["string","null"]},"selection":{"$ref":"res:TargetDraftSelection"},"readiness":{"type":["object","null"]},"changes":{"type":["object","null"],"additionalProperties":false,"properties":{"changelog":{"type":["string","null"]},"breaking_count":{"type":["integer","null"],"minimum":0},"previous_version":{"type":["string","null"]}}},"head_revision":{"type":["string","null"]},"pull_request_url":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","target_id","revision","current_version","version","selection","readiness","changes","head_revision","pull_request_url"]},
157
- "res:TargetDraftSelection": {"anyOf":[{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"}},"required":["mode"]},{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"version":{"type":"string"},"source":{"type":["string","null"]},"actor":{"type":["string","null"]}},"required":["mode","version","source","actor"]}]},
158
- "req:TargetDraftUpdate": {"type":"object","additionalProperties":false,"properties":{"version":{"type":["string","null"]},"expected_revision":{"type":"integer","minimum":0}},"required":["version"]},
180
+ "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"]},
181
+ "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"}}}},
159
182
  "req:TargetAdoption": {"type":"object","additionalProperties":false,"properties":{"version":{"type":"string"},"tag":{"type":"string","minLength":1,"maxLength":255}},"required":["version","tag"]},
160
- "res:TargetReleaseResponse": {"allOf":[{"$ref":"res:TargetRelease"},{"$ref":"res:ResponseMetadata"}]},
183
+ "res:ReleaseResponse": {"allOf":[{"$ref":"res:Release"},{"$ref":"res:ResponseMetadata"}]},
184
+ "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"]},
185
+ "res:ReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
186
+ "res:RepositoryReferenceResponse": {"type":"object","properties":{"provider":{"$ref":"res:RepositoryProvider"},"identifier":{"$ref":"res:RepositoryIdentifier"}},"required":["provider","identifier"]},
187
+ "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"]},
188
+ "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"]},
189
+ "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"]},
190
+ "res:PublicationId": {"type":"string","pattern":"^pub_[a-z0-9]{16}$"},
191
+ "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"]},
192
+ "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"]},
193
+ "res:DraftStatus": {"type":"string"},
194
+ "res:DraftActionReason": {"type":"string"},
195
+ "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"]},
196
+ "res:DraftConflicts": {"type":"object","properties":{"total":{"type":"integer","minimum":1},"decided":{"type":"integer","minimum":0}},"required":["total","decided"]},
197
+ "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"]},
198
+ "res:DraftResponse": {"allOf":[{"$ref":"res:Draft"},{"$ref":"res:ResponseMetadata"}]},
199
+ "req:DraftUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"version_next":{"type":["string","null"]}},"required":["version_next"]},
200
+ "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"]},
201
+ "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"]},
202
+ "res:DraftFileConflict": {"type":"object","properties":{"type":{"type":"string"},"source":{"type":"string"},"decision":{"type":["string","null"]}},"required":["type","source","decision"]},
203
+ "res:DraftFileHistory": {"type":"object","properties":{"change":{"type":["string","null"]},"draft_differs":{"type":"boolean"}},"required":["change","draft_differs"]},
204
+ "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"]},
205
+ "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"]},
206
+ "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"]}]},
207
+ "req:GitFileMode": {"type":"string","enum":["100644","100755","120000"]},
208
+ "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"]},
209
+ "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"]},
210
+ "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"]},
211
+ "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"]},
212
+ "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"]},
213
+ "res:PublicationResponse": {"allOf":[{"$ref":"res:Publication"},{"$ref":"res:ResponseMetadata"}]},
214
+ "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"]},
161
215
  "res:GenerationResponse": {"allOf":[{"$ref":"res:Generation"},{"$ref":"res:ResponseMetadata"}]},
162
- "res:Generation": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"files_omitted":{"type":"boolean"},"files_index":{"type":"array","items":{"$ref":"res:FileStub"}},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"$ref":"res:GenerationProvenance"},"meta":{"anyOf":[{"$ref":"res:GenerationMeta"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"error":{"type":["string","null"]},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","meta","warnings","error","created_at"]},
163
- "res:FileStub": {"type":"object","properties":{"path":{"type":"string"},"bytes":{"type":"integer"}},"required":["path","bytes"]},
164
- "res:DefinitionRevisionList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:DefinitionRevision"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
165
- "res:DefinitionRevision": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DefinitionRevisionId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"format":{"type":"string"},"document_count":{"type":"integer","minimum":1},"documents":{"type":"array","items":{"$ref":"res:DefinitionDocument"}},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0},"source":{"anyOf":[{"$ref":"res:DefinitionRevisionSource"},{"type":"null"}]},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","format","document_count","sha256","size_bytes","source","created_at"]},
166
- "res:DefinitionDocument": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DefinitionDocumentId"},"role":{"type":"string"},"coordinate":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0}},"required":["id","role","coordinate","sha256","size_bytes"]},
167
- "res:DefinitionDocumentId": {"type":"string","pattern":"^doc_[a-z0-9]{16}$"},
168
- "res:DefinitionRevisionSource": {"anyOf":[{"$ref":"res:UrlDefinitionRevisionSource"},{"$ref":"res:RepositoryDefinitionRevisionSource"},{"type":"object"}]},
169
- "res:UrlDefinitionRevisionSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string"},"url":{"type":"string"}},"required":["kind","url"]},
170
- "res:RepositoryDefinitionRevisionSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string"},"repository":{"$ref":"res:RepositoryReference"},"path":{"type":"string"},"ref":{"type":["string","null"]},"commit_sha":{"type":["string","null"]}},"required":["kind","repository","path"]},
171
- "res:DefinitionRevisionResponse": {"allOf":[{"$ref":"res:DefinitionRevision"},{"$ref":"res:ResponseMetadata"}]},
172
- "res:Account": {"type":"object","additionalProperties":false,"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"]},
173
- "res:ApiKeyList": {"type":"object","additionalProperties":false,"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"]},
174
- "res:ApiKey": {"type":"object","additionalProperties":false,"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"]},
216
+ "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"]},
217
+ "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"}]},
218
+ "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"]},
219
+ "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"]},
220
+ "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"]},
175
221
  "res:ApiKeyResponse": {"allOf":[{"$ref":"res:ApiKey"},{"$ref":"res:ResponseMetadata"}]},
176
222
  };