@opensoha/contracts 0.1.4

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 (328) hide show
  1. package/COMPATIBILITY.md +306 -0
  2. package/LICENSE +201 -0
  3. package/README.md +224 -0
  4. package/agent/agent-checkpoint.schema.json +19 -0
  5. package/agent/agent-observation.schema.json +20 -0
  6. package/agent/agent-protocol.schema.json +717 -0
  7. package/agent/agent-provider-definition.schema.json +44 -0
  8. package/agent/agent-provider-registry.schema.json +25 -0
  9. package/agent/agent-provider-runtime-event.schema.json +26 -0
  10. package/agent/agent-run-step.schema.json +24 -0
  11. package/agent/conformance-run.schema.json +19 -0
  12. package/agent/environment-lease.schema.json +31 -0
  13. package/agent/environment-snapshot.schema.json +26 -0
  14. package/agent/environment-template.schema.json +19 -0
  15. package/agent/fleet-target.schema.json +15 -0
  16. package/agent/multi-agent-plan.schema.json +18 -0
  17. package/agent/provider-rollout.schema.json +19 -0
  18. package/apiresponse/response.go +25 -0
  19. package/apiresponse/response_test.go +27 -0
  20. package/auth/token-claims.schema.json +78 -0
  21. package/capabilities/cluster-capability-matrix.schema.json +87 -0
  22. package/compat/json-schema-ecosystem-0.1.0.json +59 -0
  23. package/compat/openapi-0.1.0.snapshot.json +5076 -0
  24. package/compat/openapi-loose-boundaries-0.1.0.json +769 -0
  25. package/connectors/connector-event-envelope.schema.json +64 -0
  26. package/evaluation/evaluation-dataset.schema.json +28 -0
  27. package/evaluation/evaluation-result.schema.json +18 -0
  28. package/evaluation/evaluation-run.schema.json +19 -0
  29. package/evaluation/executor-profile.schema.json +18 -0
  30. package/evaluation/feedback-sample.schema.json +20 -0
  31. package/evaluation/gate-decision.schema.json +20 -0
  32. package/evaluation/gate-policy.schema.json +18 -0
  33. package/evaluation/replay-plan.schema.json +17 -0
  34. package/evaluation/sample-attempt.schema.json +22 -0
  35. package/events/event-envelope.schema.json +58 -0
  36. package/examples/agent-profile/k8s-sre-readonly.json +16 -0
  37. package/examples/cluster-capability-matrix/runtime-parity.json +40 -0
  38. package/examples/connector-event-envelope/feishu-message.json +19 -0
  39. package/examples/gateway-capability-baseline/minimal.json +61 -0
  40. package/examples/gateway-manifest/minimal.json +72 -0
  41. package/examples/governance/approval-request.json +35 -0
  42. package/examples/governance/audit-log.json +14 -0
  43. package/examples/marketplace-catalog/default.json +75 -0
  44. package/examples/mcp-preset/k8s-readonly.json +20 -0
  45. package/examples/openapi/agent-run-tool-call-request.json +11 -0
  46. package/examples/openapi/agent-tool-call-result-envelope.json +19 -0
  47. package/examples/openapi/cloud-extension-point-list-envelope.json +15 -0
  48. package/examples/openapi/directory-runtime-status-envelope.json +31 -0
  49. package/examples/openapi/gateway-manifest-envelope.json +53 -0
  50. package/examples/openapi/tool-invocation-request.json +14 -0
  51. package/examples/openapi/tool-invocation-result-envelope.json +23 -0
  52. package/examples/plugin-manifest/compute-provider.json +27 -0
  53. package/examples/plugin-manifest/connector.json +76 -0
  54. package/examples/plugin-manifest/skill-pack.json +47 -0
  55. package/examples/runner-operation-lifecycle/late-callback.json +27 -0
  56. package/examples/skill-manifest/k8s-sre.json +22 -0
  57. package/examples/token-claims/service-account.json +15 -0
  58. package/fixtures/json-schema/agent-checkpoint/invalid/raw-state.json +1 -0
  59. package/fixtures/json-schema/agent-checkpoint/valid/minimal.json +1 -0
  60. package/fixtures/json-schema/agent-observation/invalid/extra-secret.json +1 -0
  61. package/fixtures/json-schema/agent-observation/valid/tool.json +1 -0
  62. package/fixtures/json-schema/agent-profile/invalid/missing-scope.json +15 -0
  63. package/fixtures/json-schema/agent-profile/valid/k8s-sre-readonly.json +35 -0
  64. package/fixtures/json-schema/agent-protocol/invalid/missing-agent-id.json +3 -0
  65. package/fixtures/json-schema/agent-protocol/valid/agent-run-callback-legacy.json +9 -0
  66. package/fixtures/json-schema/agent-protocol/valid/agent-run-callback-with-events.json +39 -0
  67. package/fixtures/json-schema/agent-protocol/valid/execution-task-claim.json +5 -0
  68. package/fixtures/json-schema/agent-provider-definition/invalid/missing-command.json +1 -0
  69. package/fixtures/json-schema/agent-provider-definition/valid/cli.json +1 -0
  70. package/fixtures/json-schema/agent-provider-registry/invalid/zero-revision.json +1 -0
  71. package/fixtures/json-schema/agent-provider-registry/valid/minimal.json +1 -0
  72. package/fixtures/json-schema/agent-provider-runtime-event/invalid/health-without-provider.json +1 -0
  73. package/fixtures/json-schema/agent-provider-runtime-event/valid/ack.json +1 -0
  74. package/fixtures/json-schema/agent-run-step/invalid/unknown-state.json +1 -0
  75. package/fixtures/json-schema/agent-run-step/valid/running.json +1 -0
  76. package/fixtures/json-schema/approval-request/invalid/missing-status.json +12 -0
  77. package/fixtures/json-schema/approval-request/valid/high-risk-tool.json +56 -0
  78. package/fixtures/json-schema/audit-log/invalid/extra-field.json +10 -0
  79. package/fixtures/json-schema/audit-log/valid/tool-denied.json +23 -0
  80. package/fixtures/json-schema/cluster-capability-matrix/invalid/missing-agent-support.json +16 -0
  81. package/fixtures/json-schema/cluster-capability-matrix/invalid/partial-without-reason.json +18 -0
  82. package/fixtures/json-schema/cluster-capability-matrix/valid/runtime-parity.json +59 -0
  83. package/fixtures/json-schema/conformance-run/invalid/missing.json +1 -0
  84. package/fixtures/json-schema/conformance-run/valid/passed.json +1 -0
  85. package/fixtures/json-schema/connector-checkpoint/invalid/missing.json +1 -0
  86. package/fixtures/json-schema/connector-checkpoint/valid/http.json +1 -0
  87. package/fixtures/json-schema/connector-definition/invalid/missing.json +1 -0
  88. package/fixtures/json-schema/connector-definition/valid/http.json +1 -0
  89. package/fixtures/json-schema/connector-event-envelope/invalid/missing-payload.json +11 -0
  90. package/fixtures/json-schema/connector-event-envelope/invalid/unknown-top-level-field.json +13 -0
  91. package/fixtures/json-schema/connector-event-envelope/valid/feishu-message.json +19 -0
  92. package/fixtures/json-schema/context-envelope/invalid/envelope.json +1 -0
  93. package/fixtures/json-schema/context-envelope/valid/envelope.json +1 -0
  94. package/fixtures/json-schema/environment-lease/invalid/unbounded.json +1 -0
  95. package/fixtures/json-schema/environment-lease/valid/observe.json +1 -0
  96. package/fixtures/json-schema/environment-snapshot/invalid/negative-usage.json +1 -0
  97. package/fixtures/json-schema/environment-snapshot/valid/active.json +1 -0
  98. package/fixtures/json-schema/environment-template/invalid/missing.json +1 -0
  99. package/fixtures/json-schema/environment-template/valid/container.json +1 -0
  100. package/fixtures/json-schema/evaluation-dataset/invalid/no-samples.json +1 -0
  101. package/fixtures/json-schema/evaluation-dataset/valid/minimal.json +1 -0
  102. package/fixtures/json-schema/evaluation-result/invalid/bad-score.json +1 -0
  103. package/fixtures/json-schema/evaluation-result/valid/passed.json +1 -0
  104. package/fixtures/json-schema/evaluation-run/invalid/no-candidate.json +1 -0
  105. package/fixtures/json-schema/evaluation-run/valid/running.json +1 -0
  106. package/fixtures/json-schema/event-envelope/invalid/bad-severity.json +7 -0
  107. package/fixtures/json-schema/event-envelope/valid/minimal.json +14 -0
  108. package/fixtures/json-schema/executor-profile/invalid/missing.json +1 -0
  109. package/fixtures/json-schema/executor-profile/valid/readonly.json +1 -0
  110. package/fixtures/json-schema/feedback-sample/invalid/missing.json +1 -0
  111. package/fixtures/json-schema/feedback-sample/valid/pending.json +1 -0
  112. package/fixtures/json-schema/fleet-target/invalid/missing.json +1 -0
  113. package/fixtures/json-schema/fleet-target/valid/linux.json +1 -0
  114. package/fixtures/json-schema/gate-decision/invalid/missing.json +1 -0
  115. package/fixtures/json-schema/gate-decision/valid/pass.json +1 -0
  116. package/fixtures/json-schema/gate-policy/invalid/missing.json +1 -0
  117. package/fixtures/json-schema/gate-policy/valid/release.json +1 -0
  118. package/fixtures/json-schema/gateway-capability-baseline/invalid/missing-owner.json +32 -0
  119. package/fixtures/json-schema/gateway-capability-baseline/valid/minimal.json +61 -0
  120. package/fixtures/json-schema/gateway-manifest/invalid/bad-risk-level.json +37 -0
  121. package/fixtures/json-schema/gateway-manifest/valid/minimal.json +48 -0
  122. package/fixtures/json-schema/graph-revision/invalid/missing.json +1 -0
  123. package/fixtures/json-schema/graph-revision/valid/active.json +1 -0
  124. package/fixtures/json-schema/index-publish/invalid/missing.json +1 -0
  125. package/fixtures/json-schema/index-publish/valid/publish.json +1 -0
  126. package/fixtures/json-schema/ingestion-job/invalid/missing.json +1 -0
  127. package/fixtures/json-schema/ingestion-job/valid/queued.json +1 -0
  128. package/fixtures/json-schema/ingestion-stage/invalid/missing.json +1 -0
  129. package/fixtures/json-schema/ingestion-stage/valid/succeeded.json +1 -0
  130. package/fixtures/json-schema/knowledge-base/invalid/base.json +1 -0
  131. package/fixtures/json-schema/knowledge-base/valid/base.json +1 -0
  132. package/fixtures/json-schema/knowledge-search/invalid/search.json +1 -0
  133. package/fixtures/json-schema/knowledge-search/valid/search.json +1 -0
  134. package/fixtures/json-schema/knowledge-source/invalid/source.json +1 -0
  135. package/fixtures/json-schema/knowledge-source/valid/source.json +1 -0
  136. package/fixtures/json-schema/marketplace-catalog/invalid/missing-source.json +5 -0
  137. package/fixtures/json-schema/marketplace-catalog/valid/minimal.json +44 -0
  138. package/fixtures/json-schema/mcp-preset/invalid/bad-risk-level.json +20 -0
  139. package/fixtures/json-schema/mcp-preset/valid/k8s-readonly.json +40 -0
  140. package/fixtures/json-schema/memory-policy/invalid/missing.json +1 -0
  141. package/fixtures/json-schema/memory-policy/valid/explicit.json +1 -0
  142. package/fixtures/json-schema/memory-record/invalid/missing.json +1 -0
  143. package/fixtures/json-schema/memory-record/valid/explicit.json +1 -0
  144. package/fixtures/json-schema/multi-agent-plan/invalid/missing.json +1 -0
  145. package/fixtures/json-schema/multi-agent-plan/valid/running.json +1 -0
  146. package/fixtures/json-schema/observability-log-query-v1/invalid/missing-query.json +6 -0
  147. package/fixtures/json-schema/observability-log-query-v1/valid/request.json +15 -0
  148. package/fixtures/json-schema/observability-log-query-v1/valid/response.json +13 -0
  149. package/fixtures/json-schema/plugin-manifest/invalid/bad-type.json +7 -0
  150. package/fixtures/json-schema/plugin-manifest/invalid/logs-query-without-action.json +28 -0
  151. package/fixtures/json-schema/plugin-manifest/invalid/manifest-only-observability-provider.json +26 -0
  152. package/fixtures/json-schema/plugin-manifest/invalid/manifest-only-read-provider.json +23 -0
  153. package/fixtures/json-schema/plugin-manifest/invalid/write-provider-without-actions.json +23 -0
  154. package/fixtures/json-schema/plugin-manifest/valid/compute-provider.json +25 -0
  155. package/fixtures/json-schema/plugin-manifest/valid/minimal.json +14 -0
  156. package/fixtures/json-schema/plugin-manifest/valid/observability-provider.json +29 -0
  157. package/fixtures/json-schema/project-manifest/invalid/inline-secret.json +14 -0
  158. package/fixtures/json-schema/project-manifest/valid/demo.json +21 -0
  159. package/fixtures/json-schema/provider-rollout/invalid/missing.json +1 -0
  160. package/fixtures/json-schema/provider-rollout/valid/canary.json +1 -0
  161. package/fixtures/json-schema/replay-plan/invalid/missing.json +1 -0
  162. package/fixtures/json-schema/replay-plan/valid/readonly.json +1 -0
  163. package/fixtures/json-schema/retrieval-trace/invalid/missing.json +1 -0
  164. package/fixtures/json-schema/retrieval-trace/valid/grounded.json +1 -0
  165. package/fixtures/json-schema/runner-operation-lifecycle/invalid/bad-state.json +7 -0
  166. package/fixtures/json-schema/runner-operation-lifecycle/invalid/missing-runner-id.json +6 -0
  167. package/fixtures/json-schema/runner-operation-lifecycle/valid/final-failed.json +27 -0
  168. package/fixtures/json-schema/runner-operation-lifecycle/valid/heartbeat.json +19 -0
  169. package/fixtures/json-schema/sample-attempt/invalid/missing.json +1 -0
  170. package/fixtures/json-schema/sample-attempt/valid/completed.json +1 -0
  171. package/fixtures/json-schema/skill-manifest/invalid/bad-id.json +5 -0
  172. package/fixtures/json-schema/skill-manifest/valid/minimal.json +8 -0
  173. package/fixtures/json-schema/token-claims/invalid/bad-token-kind.json +9 -0
  174. package/fixtures/json-schema/token-claims/valid/service-account.json +15 -0
  175. package/fixtures/openapi/AIGatewayManifestEnvelope/invalid/bad-date.json +28 -0
  176. package/fixtures/openapi/AIGatewayManifestEnvelope/valid/minimal.json +31 -0
  177. package/fixtures/openapi/AgentProviderRegistryAcknowledgement/invalid/missing-targeted.json +7 -0
  178. package/fixtures/openapi/AgentProviderRegistryAcknowledgement/valid/rollout.json +17 -0
  179. package/fixtures/openapi/AgentRunCallbackRequest/invalid/missing-agent-id.json +6 -0
  180. package/fixtures/openapi/AgentRunCallbackRequest/valid/succeeded.json +10 -0
  181. package/fixtures/openapi/AgentRunCallbackRequest/valid/with-events.json +39 -0
  182. package/fixtures/openapi/AuthResultEnvelope/invalid/missing-tokens.json +13 -0
  183. package/fixtures/openapi/AuthResultEnvelope/valid/session.json +20 -0
  184. package/fixtures/openapi/CloudExtensionPointListEnvelope/invalid/missing-exclusions.json +11 -0
  185. package/fixtures/openapi/CloudExtensionPointListEnvelope/valid/managed-fleet.json +19 -0
  186. package/fixtures/openapi/ComputeAccessSourceListEnvelope/invalid/bad-source-type.json +15 -0
  187. package/fixtures/openapi/ComputeAccessSourceListEnvelope/valid/mixed.json +19 -0
  188. package/fixtures/openapi/ComputeOverviewEnvelope/invalid/bad-section-status.json +9 -0
  189. package/fixtures/openapi/ComputeOverviewEnvelope/valid/partial.json +33 -0
  190. package/fixtures/openapi/ComputeProviderListEnvelope/invalid/bad-domain.json +23 -0
  191. package/fixtures/openapi/ComputeProviderListEnvelope/valid/builtin.json +30 -0
  192. package/fixtures/openapi/ComputeResourceRelationListEnvelope/invalid/bad-relation.json +29 -0
  193. package/fixtures/openapi/ComputeResourceRelationListEnvelope/valid/vm-runtime.json +33 -0
  194. package/fixtures/openapi/ComputeTaskListEnvelope/invalid/missing-source-id.json +19 -0
  195. package/fixtures/openapi/ComputeTaskListEnvelope/valid/running.json +30 -0
  196. package/fixtures/openapi/DeliveryDraftInput/invalid/missing-application-key.json +9 -0
  197. package/fixtures/openapi/DeliveryDraftInput/valid/ai-service.json +25 -0
  198. package/fixtures/openapi/DirectoryEventListEnvelope/invalid/unknown-status.json +13 -0
  199. package/fixtures/openapi/DirectoryEventListEnvelope/valid/failed.json +16 -0
  200. package/fixtures/openapi/DirectoryPersonLifecycle/invalid/unknown-employment-status.json +5 -0
  201. package/fixtures/openapi/DirectoryPersonLifecycle/valid/departed.json +6 -0
  202. package/fixtures/openapi/DirectoryRuntimeStatusEnvelope/invalid/negative-event-count.json +11 -0
  203. package/fixtures/openapi/DirectoryRuntimeStatusEnvelope/valid/verified.json +14 -0
  204. package/fixtures/openapi/DockerContainerStartInput/invalid/missing-image.json +8 -0
  205. package/fixtures/openapi/DockerContainerStartInput/valid/git-dockerfile.json +22 -0
  206. package/fixtures/openapi/DockerOperationCallbackRequest/invalid/logs-not-array.json +7 -0
  207. package/fixtures/openapi/DockerOperationCallbackRequest/valid/succeeded.json +9 -0
  208. package/fixtures/openapi/ErrorEnvelope/invalid/extra-field.json +7 -0
  209. package/fixtures/openapi/ErrorEnvelope/valid/error.json +7 -0
  210. package/fixtures/openapi/EvaluationGateRequest/invalid/missing-candidate.json +4 -0
  211. package/fixtures/openapi/EvaluationGateRequest/valid/candidate.json +5 -0
  212. package/fixtures/openapi/ExecutionCallbackRequest/invalid/extra-field.json +6 -0
  213. package/fixtures/openapi/ExecutionCallbackRequest/valid/succeeded.json +7 -0
  214. package/fixtures/openapi/GovernanceStatusEnvelope/invalid/window-hours-string.json +81 -0
  215. package/fixtures/openapi/GovernanceStatusEnvelope/valid/minimal.json +81 -0
  216. package/fixtures/openapi/IdentityErrorEnvelope/invalid/raw-assertion.json +7 -0
  217. package/fixtures/openapi/IdentityErrorEnvelope/valid/invalid-signature.json +7 -0
  218. package/fixtures/openapi/IdentityOutpostClaimRequest/invalid/missing-protocol-version.json +4 -0
  219. package/fixtures/openapi/IdentityOutpostClaimRequest/valid/current-version.json +5 -0
  220. package/fixtures/openapi/IdentityRuntimeCapabilityEnvelope/invalid/missing-runtime-state.json +17 -0
  221. package/fixtures/openapi/IdentityRuntimeCapabilityEnvelope/valid/available.json +17 -0
  222. package/fixtures/openapi/KnowledgeIngestionJobInput/invalid/missing-source.json +1 -0
  223. package/fixtures/openapi/KnowledgeIngestionJobInput/valid/source.json +3 -0
  224. package/fixtures/openapi/KubernetesResourceAgentCreateRequest/invalid/unresolved-target.json +18 -0
  225. package/fixtures/openapi/KubernetesResourceAgentCreateRequest/valid/resolved-target.json +25 -0
  226. package/fixtures/openapi/KubernetesResourceCreateRequest/invalid/unknown-source.json +5 -0
  227. package/fixtures/openapi/KubernetesResourceCreateRequest/valid/global-multi-document.json +5 -0
  228. package/fixtures/openapi/KubernetesResourceCreateResultEnvelope/invalid/bad-document-index.json +21 -0
  229. package/fixtures/openapi/KubernetesResourceCreateResultEnvelope/valid/partial.json +62 -0
  230. package/fixtures/openapi/KubernetesResourceCreateScopeDecisionEnvelope/invalid/missing-capability.json +12 -0
  231. package/fixtures/openapi/KubernetesResourceCreateScopeDecisionEnvelope/valid/allowed.json +17 -0
  232. package/fixtures/openapi/KubernetesResourcePreflightEnvelope/invalid/warning-without-message.json +32 -0
  233. package/fixtures/openapi/KubernetesResourcePreflightEnvelope/valid/mixed-diagnostics.json +83 -0
  234. package/fixtures/openapi/LogPage/invalid/missing-entry-source.json +12 -0
  235. package/fixtures/openapi/LogPage/valid/partial-runtime.json +42 -0
  236. package/fixtures/openapi/LogQuery/invalid/missing-selector.json +3 -0
  237. package/fixtures/openapi/LogQuery/invalid/unknown-source-mode.json +6 -0
  238. package/fixtures/openapi/LogQuery/valid/docker-project.json +12 -0
  239. package/fixtures/openapi/LogQuery/valid/runtime-workload.json +21 -0
  240. package/fixtures/openapi/LogStreamEvent/invalid/missing-entry.json +3 -0
  241. package/fixtures/openapi/LogStreamEvent/invalid/unknown-event-type.json +3 -0
  242. package/fixtures/openapi/LogStreamEvent/valid/live-entry.json +16 -0
  243. package/fixtures/openapi/MCPCapabilityListEnvelope/invalid/missing-scopes.json +9 -0
  244. package/fixtures/openapi/MCPCapabilityListEnvelope/valid/minimal.json +10 -0
  245. package/fixtures/openapi/MFAAdminResetRequest/invalid/missing-reason.json +3 -0
  246. package/fixtures/openapi/MFAAdminResetRequest/valid/security-incident.json +4 -0
  247. package/fixtures/openapi/MFAWebAuthnRequestOptionsEnvelope/invalid/missing-challenge-id.json +9 -0
  248. package/fixtures/openapi/MFAWebAuthnRequestOptionsEnvelope/valid/step-up.json +11 -0
  249. package/fixtures/openapi/ManifestDeploymentEnvelope/invalid/bad-condition-status.json +33 -0
  250. package/fixtures/openapi/ManifestDeploymentEnvelope/valid/converged.json +36 -0
  251. package/fixtures/openapi/ManifestSourceUpdateInput/invalid/unknown-mode.json +6 -0
  252. package/fixtures/openapi/ManifestSourceUpdateInput/valid/soha-managed.json +6 -0
  253. package/fixtures/openapi/ObservabilityDataSource/valid/healthy.json +33 -0
  254. package/fixtures/openapi/ObservabilityDataSourceInput/invalid/secret-in-config.json +9 -0
  255. package/fixtures/openapi/ObservabilityDataSourceInput/valid/loki.json +33 -0
  256. package/fixtures/openapi/ObservabilityDataSourceInput/valid/provider.json +21 -0
  257. package/fixtures/openapi/PasswordLoginRequest/invalid/extra-field.json +5 -0
  258. package/fixtures/openapi/PasswordLoginRequest/valid/password-login.json +4 -0
  259. package/fixtures/openapi/PersonalAccessTokenInput/invalid/extra-field.json +6 -0
  260. package/fixtures/openapi/PersonalAccessTokenInput/valid/create.json +9 -0
  261. package/fixtures/openapi/PluginManifest/invalid/bad-type.json +7 -0
  262. package/fixtures/openapi/PluginManifest/valid/skill-pack.json +12 -0
  263. package/fixtures/openapi/RepositoryInput/invalid/embedded-token.json +8 -0
  264. package/fixtures/openapi/RepositoryInput/valid/gitlab.json +11 -0
  265. package/fixtures/openapi/RuntimeConfigChangeRequest/invalid/missing-version.json +8 -0
  266. package/fixtures/openapi/RuntimeConfigChangeRequest/valid/feature-flags.json +14 -0
  267. package/fixtures/openapi/RuntimeConfigSnapshotEnvelope/invalid/editable-secret.json +17 -0
  268. package/fixtures/openapi/RuntimeConfigSnapshotEnvelope/invalid/exposed-default-secret.json +18 -0
  269. package/fixtures/openapi/RuntimeConfigSnapshotEnvelope/invalid/exposed-effective-secret.json +18 -0
  270. package/fixtures/openapi/RuntimeConfigSnapshotEnvelope/valid/effective.json +34 -0
  271. package/fixtures/openapi/SAMLMetadataInput/invalid/unknown-source.json +4 -0
  272. package/fixtures/openapi/SAMLMetadataInput/valid/xml.json +4 -0
  273. package/fixtures/openapi/SecretCreateRequest/invalid/missing-value.json +5 -0
  274. package/fixtures/openapi/SecretCreateRequest/valid/create.json +13 -0
  275. package/fixtures/openapi/SecretLeaseRedemptionEnvelope/invalid/invalid-alias.json +9 -0
  276. package/fixtures/openapi/SecretLeaseRedemptionEnvelope/valid/redeem.json +9 -0
  277. package/fixtures/openapi/SecretMetadataEnvelope/invalid/plaintext-value.json +15 -0
  278. package/fixtures/openapi/SecretMetadataEnvelope/valid/metadata.json +20 -0
  279. package/fixtures/openapi/SecretRotateRequest/invalid/empty-value.json +3 -0
  280. package/fixtures/openapi/SecretRotateRequest/valid/rotate.json +3 -0
  281. package/fixtures/openapi/ServiceAccountInput/invalid/missing-status.json +4 -0
  282. package/fixtures/openapi/ServiceAccountInput/valid/create.json +8 -0
  283. package/fixtures/openapi/WorkbenchStreamEvent/invalid/extra-field.json +11 -0
  284. package/fixtures/openapi/WorkbenchStreamEvent/invalid/missing-server-fields.json +5 -0
  285. package/fixtures/openapi/WorkbenchStreamEvent/valid/message-done.json +13 -0
  286. package/gen/go/sohaapi/client.go +989 -0
  287. package/gen/go/sohaapi/client_test.go +2127 -0
  288. package/gen/go/sohaapi/types.go +21450 -0
  289. package/gen/ts/sohaapi/index.ts +22869 -0
  290. package/go.mod +18 -0
  291. package/go.sum +46 -0
  292. package/governance/approval-request.schema.json +187 -0
  293. package/governance/audit-log.schema.json +37 -0
  294. package/helmrelease/release.go +108 -0
  295. package/helmrelease/release_test.go +9 -0
  296. package/knowledge/connector-checkpoint.schema.json +16 -0
  297. package/knowledge/connector-definition.schema.json +18 -0
  298. package/knowledge/context-envelope.schema.json +32 -0
  299. package/knowledge/graph-revision.schema.json +21 -0
  300. package/knowledge/index-publish.schema.json +17 -0
  301. package/knowledge/ingestion-job.schema.json +22 -0
  302. package/knowledge/ingestion-stage.schema.json +19 -0
  303. package/knowledge/knowledge-base.schema.json +48 -0
  304. package/knowledge/knowledge-search.schema.json +21 -0
  305. package/knowledge/knowledge-source.schema.json +28 -0
  306. package/knowledge/retrieval-trace.schema.json +21 -0
  307. package/mcp/gateway-capability-baseline.schema.json +290 -0
  308. package/mcp/gateway-manifest.schema.json +210 -0
  309. package/memory/memory-policy.schema.json +19 -0
  310. package/memory/memory-record.schema.json +25 -0
  311. package/openapi/soha-api.json +42282 -0
  312. package/openapi/soha-api.yaml +21748 -0
  313. package/openapi/spec_generated.go +23 -0
  314. package/openapi/spec_test.go +38 -0
  315. package/package.json +122 -0
  316. package/plugins/marketplace-catalog.schema.json +120 -0
  317. package/plugins/observability-log-query-v1.schema.json +88 -0
  318. package/plugins/plugin-manifest.schema.json +498 -0
  319. package/presets/mcp-preset.schema.json +142 -0
  320. package/profiles/agent-profile.schema.json +154 -0
  321. package/resource/crd_definition.go +10 -0
  322. package/resource/gateway_details_test.go +55 -0
  323. package/resource/models.go +1587 -0
  324. package/resource/models_test.go +72 -0
  325. package/runner/operation-lifecycle.schema.json +112 -0
  326. package/skills/skill-manifest.schema.json +64 -0
  327. package/streamlimit/limited_buffer.go +58 -0
  328. package/streamlimit/limited_buffer_test.go +38 -0
@@ -0,0 +1,64 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://contracts.opensoha.dev/connectors/connector-event-envelope.schema.json",
4
+ "title": "OpenSoha Connector Event Batch Envelope",
5
+ "description": "Batch wrapper posted by connector runtimes to the OpenSoha core connector event sink.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["connectorId", "events"],
9
+ "properties": {
10
+ "connectorId": {
11
+ "type": "string",
12
+ "minLength": 1,
13
+ "pattern": "^[a-z][a-z0-9-]*$",
14
+ "description": "Connector runtime ID that produced the batch."
15
+ },
16
+ "events": {
17
+ "type": "array",
18
+ "minItems": 1,
19
+ "items": {
20
+ "$ref": "#/$defs/ConnectorEvent"
21
+ },
22
+ "description": "Connector events normalized by the runtime."
23
+ }
24
+ },
25
+ "$defs": {
26
+ "ConnectorEvent": {
27
+ "type": "object",
28
+ "additionalProperties": false,
29
+ "required": ["id", "type", "source", "occurredAt", "payload"],
30
+ "properties": {
31
+ "id": {
32
+ "type": "string",
33
+ "minLength": 1,
34
+ "description": "Provider event ID when available, otherwise a deterministic idempotency key generated by the connector."
35
+ },
36
+ "type": {
37
+ "type": "string",
38
+ "minLength": 1,
39
+ "description": "Provider event type normalized into the connector manifest event namespace, for example im.message.receive_v1."
40
+ },
41
+ "source": {
42
+ "type": "string",
43
+ "pattern": "^[a-z][a-z0-9-]*$",
44
+ "description": "Connector ID that produced the event."
45
+ },
46
+ "occurredAt": {
47
+ "type": "string",
48
+ "format": "date-time",
49
+ "description": "Provider event timestamp in RFC 3339 date-time format, or runtime receipt time when the provider timestamp is unavailable."
50
+ },
51
+ "subject": {
52
+ "type": "string",
53
+ "minLength": 1,
54
+ "description": "Optional provider resource identifier used by Soha for routing, correlation, or audit display."
55
+ },
56
+ "payload": {
57
+ "type": "object",
58
+ "additionalProperties": true,
59
+ "description": "Provider-specific normalized payload. Connectors must keep secrets and raw credentials out of this object."
60
+ }
61
+ }
62
+ }
63
+ }
64
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation-dataset.schema.json",
4
+ "title": "Evaluation Dataset",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "name", "version", "samples", "createdAt"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-dataset/v1" },
10
+ "id": { "type": "string", "pattern": "^[a-z][a-z0-9._-]{1,127}$" },
11
+ "name": { "type": "string", "minLength": 1, "maxLength": 160 },
12
+ "version": { "type": "string", "minLength": 1, "maxLength": 64 },
13
+ "samples": {
14
+ "type": "array", "minItems": 1, "maxItems": 10000,
15
+ "items": {
16
+ "type": "object", "additionalProperties": false, "required": ["id", "input"],
17
+ "properties": {
18
+ "id": { "type": "string", "minLength": 1, "maxLength": 128 },
19
+ "input": { "type": "string", "minLength": 1, "maxLength": 65536 },
20
+ "expectedSources": { "type": "array", "maxItems": 256, "items": { "type": "string", "maxLength": 512 } },
21
+ "expectedFacts": { "type": "array", "maxItems": 256, "items": { "type": "string", "maxLength": 4096 } },
22
+ "forbiddenActions": { "type": "array", "maxItems": 128, "items": { "type": "string", "maxLength": 256 } }
23
+ }
24
+ }
25
+ },
26
+ "createdAt": { "type": "string", "format": "date-time" }
27
+ }
28
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation-result.schema.json",
4
+ "title": "Evaluation Result",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "sampleId", "scores", "passed"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-result/v1" },
10
+ "sampleId": { "type": "string", "minLength": 1, "maxLength": 128 },
11
+ "retrievedSources": { "type": "array", "maxItems": 512, "items": { "type": "string", "maxLength": 512 } },
12
+ "producedFacts": { "type": "array", "maxItems": 512, "items": { "type": "string", "maxLength": 4096 } },
13
+ "actions": { "type": "array", "maxItems": 256, "items": { "type": "string", "maxLength": 256 } },
14
+ "scores": { "type": "object", "maxProperties": 128, "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 } },
15
+ "passed": { "type": "boolean" },
16
+ "failureReasons": { "type": "array", "maxItems": 128, "items": { "type": "string", "maxLength": 256 } }
17
+ }
18
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation-run.schema.json",
4
+ "title": "Evaluation Run",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "datasetId", "datasetVersion", "candidateRefs", "status", "startedAt"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-run/v1" },
10
+ "id": { "type": "string", "minLength": 1, "maxLength": 128 },
11
+ "datasetId": { "type": "string", "minLength": 1, "maxLength": 128 },
12
+ "datasetVersion": { "type": "string", "minLength": 1, "maxLength": 64 },
13
+ "candidateRefs": { "type": "object", "minProperties": 1, "maxProperties": 32, "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 512 } },
14
+ "status": { "enum": ["queued", "running", "completed", "failed", "cancelled"] },
15
+ "startedAt": { "type": "string", "format": "date-time" },
16
+ "completedAt": { "type": "string", "format": "date-time" },
17
+ "aggregateScores": { "type": "object", "maxProperties": 128, "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 } }
18
+ }
19
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation/executor-profile.schema.json",
4
+ "title": "Evaluation Executor Profile",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "environmentPolicy", "isolationMode", "timeoutSeconds", "enabled"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-executor-profile/v1" },
10
+ "id": { "type": "string", "minLength": 1 },
11
+ "environmentPolicy": { "type": "string", "minLength": 1 },
12
+ "toolSnapshotRef": { "type": "string" },
13
+ "isolationMode": { "enum": ["read-only", "disposable-write"] },
14
+ "timeoutSeconds": { "type": "integer", "minimum": 1, "maximum": 1800 },
15
+ "maxCost": { "type": "number", "minimum": 0 },
16
+ "enabled": { "type": "boolean" }
17
+ }
18
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation/feedback-sample.schema.json",
4
+ "title": "Curated Evaluation Feedback Sample",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "traceRef", "scopeHash", "redactedInput", "redactedOutput", "licenseRef", "decision", "createdAt"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-feedback-sample/v1" },
10
+ "id": { "type": "string", "minLength": 1 },
11
+ "traceRef": { "type": "string", "minLength": 1 },
12
+ "scopeHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
13
+ "redactedInput": { "type": "string", "maxLength": 32000 },
14
+ "redactedOutput": { "type": "string", "maxLength": 32000 },
15
+ "licenseRef": { "type": "string", "minLength": 1 },
16
+ "decision": { "enum": ["pending", "accepted", "rejected", "deleted"] },
17
+ "datasetRef": { "type": "string" },
18
+ "createdAt": { "type": "string", "format": "date-time" }
19
+ }
20
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation/gate-decision.schema.json",
4
+ "title": "Evaluation Gate Decision",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "policyId", "policyVersion", "baselineRunId", "candidateRunId", "decision", "reasons", "evidenceRefs", "evaluatedAt"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-gate-decision/v1" },
10
+ "id": { "type": "string", "minLength": 1 },
11
+ "policyId": { "type": "string", "minLength": 1 },
12
+ "policyVersion": { "type": "string", "minLength": 1 },
13
+ "baselineRunId": { "type": "string" },
14
+ "candidateRunId": { "type": "string" },
15
+ "decision": { "enum": ["pass", "warn", "block", "error"] },
16
+ "reasons": { "type": "array", "maxItems": 128, "items": { "type": "object" } },
17
+ "evidenceRefs": { "type": "array", "maxItems": 128, "items": { "type": "string" } },
18
+ "evaluatedAt": { "type": "string", "format": "date-time" }
19
+ }
20
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation/gate-policy.schema.json",
4
+ "title": "Evaluation Gate Policy",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "version", "minimumScores", "enabled"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-gate-policy/v1" },
10
+ "id": { "type": "string", "minLength": 1 },
11
+ "version": { "type": "string", "minLength": 1 },
12
+ "minimumScores": { "type": "object", "minProperties": 1, "maxProperties": 128, "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 } },
13
+ "maximumRegression": { "type": "object", "maxProperties": 128, "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 } },
14
+ "maximumCost": { "type": "number", "minimum": 0 },
15
+ "maximumLatencyMs": { "type": "integer", "minimum": 0 },
16
+ "enabled": { "type": "boolean" }
17
+ }
18
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation/replay-plan.schema.json",
4
+ "title": "Evaluation Replay Plan",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "sourceTraceRefs", "candidateRefs", "executorProfileId", "readOnly", "createdAt"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-replay-plan/v1" },
10
+ "id": { "type": "string", "minLength": 1 },
11
+ "sourceTraceRefs": { "type": "array", "minItems": 1, "maxItems": 500, "uniqueItems": true, "items": { "type": "string" } },
12
+ "candidateRefs": { "type": "object", "minProperties": 1, "maxProperties": 32, "additionalProperties": { "type": "string" } },
13
+ "executorProfileId": { "type": "string", "minLength": 1 },
14
+ "readOnly": { "type": "boolean" },
15
+ "createdAt": { "type": "string", "format": "date-time" }
16
+ }
17
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://opensoha.dev/schemas/evaluation/sample-attempt.schema.json",
4
+ "title": "Evaluation Sample Attempt",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "runId", "sampleId", "attempt", "candidateRefs", "status", "latencyMillis", "completedAt"],
8
+ "properties": {
9
+ "schemaVersion": { "const": "opensoha.dev/evaluation-sample-attempt/v1" },
10
+ "runId": { "type": "string", "minLength": 1 },
11
+ "sampleId": { "type": "string", "minLength": 1 },
12
+ "attempt": { "type": "integer", "minimum": 1, "maximum": 10 },
13
+ "candidateRefs": { "type": "object", "minProperties": 1, "maxProperties": 32, "additionalProperties": { "type": "string" } },
14
+ "traceRef": { "type": "string" },
15
+ "scores": { "type": "object", "maxProperties": 128, "additionalProperties": { "type": "number" } },
16
+ "usage": { "type": "object", "maxProperties": 32, "additionalProperties": { "type": "number", "minimum": 0 } },
17
+ "latencyMillis": { "type": "integer", "minimum": 0 },
18
+ "status": { "enum": ["completed", "failed", "cancelled"] },
19
+ "errorCode": { "type": "string" },
20
+ "completedAt": { "type": "string", "format": "date-time" }
21
+ }
22
+ }
@@ -0,0 +1,58 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://contracts.opensoha.dev/events/event-envelope.schema.json",
4
+ "title": "Soha Event Envelope",
5
+ "description": "Shared event envelope for audit, operational, integration, and future MCP invocation events.",
6
+ "type": "object",
7
+ "required": ["id", "source", "category", "severity", "summary"],
8
+ "properties": {
9
+ "id": { "type": "string", "minLength": 1 },
10
+ "tenantId": {
11
+ "type": "string",
12
+ "default": "default"
13
+ },
14
+ "workspaceId": {
15
+ "type": "string",
16
+ "default": "default"
17
+ },
18
+ "source": { "type": "string", "minLength": 1 },
19
+ "category": { "type": "string", "minLength": 1 },
20
+ "eventType": { "type": "string" },
21
+ "severity": {
22
+ "type": "string",
23
+ "enum": ["debug", "info", "notice", "warning", "error", "critical"]
24
+ },
25
+ "clusterId": { "type": "string" },
26
+ "namespace": { "type": "string" },
27
+ "subject": {
28
+ "type": "object",
29
+ "properties": {
30
+ "kind": { "type": "string" },
31
+ "id": { "type": "string" },
32
+ "name": { "type": "string" },
33
+ "scope": {
34
+ "type": "object",
35
+ "additionalProperties": true
36
+ }
37
+ },
38
+ "additionalProperties": false
39
+ },
40
+ "actor": {
41
+ "type": "object",
42
+ "properties": {
43
+ "type": { "type": "string" },
44
+ "id": { "type": "string" },
45
+ "name": { "type": "string" }
46
+ },
47
+ "additionalProperties": false
48
+ },
49
+ "summary": { "type": "string", "minLength": 1 },
50
+ "timestamp": { "type": "string", "format": "date-time" },
51
+ "payload": {
52
+ "type": "object",
53
+ "additionalProperties": true
54
+ }
55
+ },
56
+ "additionalProperties": false
57
+ }
58
+
@@ -0,0 +1,16 @@
1
+ {
2
+ "schemaVersion": "opensoha.dev/agent-profile/v1",
3
+ "id": "k8s-sre-readonly",
4
+ "name": "K8s SRE Readonly",
5
+ "version": "0.1.0",
6
+ "description": "Agent runtime profile for read-only Kubernetes root-cause diagnosis through Soha Gateway.",
7
+ "mode": "platform_resource_diagnosis",
8
+ "providerKind": "soha-agent-runtime",
9
+ "skillRefs": ["k8s-sre"],
10
+ "mcpPresetRefs": ["k8s-readonly"],
11
+ "capabilityRefs": ["platform_resource_diagnosis"],
12
+ "platformCapabilityRefs": ["cluster.inventory", "workload.read", "network.inventory", "storage.inventory", "pod.logs", "metrics"],
13
+ "requiredScopes": ["cluster", "namespace"],
14
+ "enabledToolRefs": ["k8s.pods.list", "k8s.pods.logs", "k8s.pods.describe"],
15
+ "guardrails": ["read_only", "no_direct_cluster_access", "no_secret_output", "require_cluster_namespace_scope"]
16
+ }
@@ -0,0 +1,40 @@
1
+ {
2
+ "generatedAt": "2026-06-12T02:00:00Z",
3
+ "capabilitySetVersion": "2026.06",
4
+ "items": [
5
+ {
6
+ "key": "kubernetes.yaml.apply",
7
+ "label": "Apply Kubernetes YAML",
8
+ "category": "yaml",
9
+ "riskLevel": "mutate",
10
+ "requiresApproval": true,
11
+ "direct": {
12
+ "status": "available",
13
+ "requiredScopes": ["cluster:write", "kubernetes:apply"]
14
+ },
15
+ "agent": {
16
+ "status": "available",
17
+ "requiredAgentVersion": "0.1.0",
18
+ "requiredScopes": ["agent:kubernetes:apply"]
19
+ }
20
+ },
21
+ {
22
+ "key": "kubernetes.port-forward",
23
+ "label": "Port Forward",
24
+ "category": "port-forward",
25
+ "riskLevel": "execute",
26
+ "requiresApproval": true,
27
+ "direct": {
28
+ "status": "available",
29
+ "requiredScopes": ["cluster:port-forward"]
30
+ },
31
+ "agent": {
32
+ "status": "partial",
33
+ "reason": "Agent supports single-port forwarding while multi-port sessions remain direct-only.",
34
+ "diagnostic": "agent_port_forward_partial",
35
+ "requiredAgentVersion": "0.1.0",
36
+ "requiredScopes": ["agent:port-forward"]
37
+ }
38
+ }
39
+ ]
40
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "connectorId": "feishu",
3
+ "events": [
4
+ {
5
+ "id": "feishu-msg-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
6
+ "type": "im.message.receive_v1",
7
+ "source": "feishu",
8
+ "occurredAt": "2026-06-11T08:30:00Z",
9
+ "subject": "chat:oc_1234567890",
10
+ "payload": {
11
+ "messageId": "om_1234567890",
12
+ "chatId": "oc_1234567890",
13
+ "senderId": "ou_1234567890",
14
+ "messageType": "text",
15
+ "text": "deploy status?"
16
+ }
17
+ }
18
+ ]
19
+ }
@@ -0,0 +1,61 @@
1
+ {
2
+ "schemaVersion": "opensoha.dev/gateway-capability-catalog/v1",
3
+ "version": "0.1.0",
4
+ "source": {
5
+ "repository": "github.com/opensoha/soha",
6
+ "path": "internal/application/aigateway/catalog.go",
7
+ "syncStrategy": "stable-runtime entries are checked against runtime Gateway catalog output before release."
8
+ },
9
+ "plannedSkills": ["gateway-governance"],
10
+ "tools": [
11
+ {
12
+ "name": "delivery.execution_logs.list",
13
+ "title": "List Execution Logs",
14
+ "domain": "delivery",
15
+ "owningWorkbench": "delivery",
16
+ "owningService": "internal/application/delivery.Service",
17
+ "action": "logs",
18
+ "riskLevel": "read",
19
+ "permissionKeys": ["ai.gateway.invoke", "delivery.execution-tasks.view"],
20
+ "requiredScopes": ["application", "environment", "executionTask"],
21
+ "mcpAdapterId": "delivery.v1",
22
+ "mcpToolName": "delivery.execution_logs.list",
23
+ "requiresApproval": false,
24
+ "status": "stable-runtime",
25
+ "skillRefs": ["delivery-tester"],
26
+ "resourceRefs": ["soha://delivery/execution-tasks"],
27
+ "promptRefs": ["soha.delivery.plan_release"],
28
+ "audit": {
29
+ "resourceKind": "AIGatewayTool",
30
+ "relatedIds": ["taskId"]
31
+ },
32
+ "redaction": ["logs"],
33
+ "moduleId": "delivery",
34
+ "routeEvidence": ["registerDeliveryRoutes", "registerAIGatewayRoutes"]
35
+ }
36
+ ],
37
+ "resources": [
38
+ {
39
+ "name": "soha://delivery/execution-tasks",
40
+ "description": "Durable delivery execution tasks, callbacks, artifacts, and logs.",
41
+ "permissionKeys": ["ai.gateway.invoke", "delivery.execution-tasks.view"],
42
+ "requiredScopes": ["application", "environment"],
43
+ "status": "stable-runtime",
44
+ "skillRefs": ["delivery-tester"],
45
+ "toolRefs": ["delivery.execution_logs.list"],
46
+ "promptRefs": ["soha.delivery.plan_release"]
47
+ }
48
+ ],
49
+ "prompts": [
50
+ {
51
+ "name": "soha.delivery.plan_release",
52
+ "description": "Build a release or rollback plan from delivery evidence.",
53
+ "permissionKeys": ["ai.gateway.invoke", "delivery.applications.view"],
54
+ "requiredScopes": ["application", "environment"],
55
+ "status": "stable-runtime",
56
+ "skillRefs": ["delivery-tester"],
57
+ "toolRefs": ["delivery.execution_logs.list"],
58
+ "resourceRefs": ["soha://delivery/execution-tasks"]
59
+ }
60
+ ]
61
+ }
@@ -0,0 +1,72 @@
1
+ {
2
+ "name": "soha-ai-gateway",
3
+ "version": "0.1.0",
4
+ "generatedAt": "2026-06-09T12:00:00Z",
5
+ "principal": {
6
+ "userId": "u-1",
7
+ "userName": "admin",
8
+ "email": "admin@example.com",
9
+ "roles": ["platform-admin"],
10
+ "teams": [],
11
+ "projects": [],
12
+ "tags": [],
13
+ "permissionKeys": ["ai.gateway.tools.read", "k8s.pods.read"]
14
+ },
15
+ "caller": {
16
+ "identityMode": "user",
17
+ "source": "cli"
18
+ },
19
+ "permissionKeys": ["ai.gateway.tools.read", "k8s.pods.read"],
20
+ "tools": [
21
+ {
22
+ "name": "k8s.list_pods",
23
+ "title": "List pods",
24
+ "description": "List Kubernetes pods in a namespace.",
25
+ "domain": "kubernetes",
26
+ "action": "read",
27
+ "riskLevel": "read",
28
+ "permissionKeys": ["k8s.pods.read"],
29
+ "requiredScopes": ["cluster", "namespace"],
30
+ "mcpAdapterId": "builtin.kubernetes",
31
+ "mcpToolName": "k8s.pods.list",
32
+ "requiresApproval": false,
33
+ "inputSchema": {
34
+ "type": "object",
35
+ "required": ["namespace"],
36
+ "properties": {
37
+ "namespace": { "type": "string" }
38
+ },
39
+ "additionalProperties": false
40
+ },
41
+ "outputSchema": {
42
+ "type": "object",
43
+ "properties": {
44
+ "items": {
45
+ "type": "array",
46
+ "items": { "type": "object" }
47
+ }
48
+ }
49
+ }
50
+ }
51
+ ],
52
+ "resources": [],
53
+ "prompts": [],
54
+ "skills": [
55
+ {
56
+ "id": "k8s-sre",
57
+ "name": "Kubernetes SRE",
58
+ "category": "ai-gateway",
59
+ "description": "Read-only cluster diagnosis skill.",
60
+ "capabilityRefs": ["k8s.list_pods"],
61
+ "permissionKeys": ["k8s.pods.read"],
62
+ "requiredScopes": ["cluster", "namespace"]
63
+ }
64
+ ],
65
+ "summary": {
66
+ "toolCount": 1,
67
+ "resourceCount": 0,
68
+ "promptCount": 0,
69
+ "skillCount": 1,
70
+ "deniedCount": 0
71
+ }
72
+ }
@@ -0,0 +1,35 @@
1
+ {
2
+ "id": "approval-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
3
+ "status": "approved",
4
+ "strategy": "role_quorum",
5
+ "actorType": "user",
6
+ "actorId": "user-123",
7
+ "actorName": "Ada",
8
+ "toolName": "k8s.deployments.restart",
9
+ "riskLevel": "high",
10
+ "requiresApproval": true,
11
+ "approvalTrace": {
12
+ "approvalMode": "role_quorum",
13
+ "approvedCount": 1,
14
+ "requiredApprovals": 1,
15
+ "satisfiedRequirements": ["role:sre"],
16
+ "decisions": [
17
+ {
18
+ "userId": "user-456",
19
+ "userName": "Grace",
20
+ "roles": ["sre"],
21
+ "result": "approved",
22
+ "stageIndex": 0,
23
+ "stageName": "platform-sre",
24
+ "decidedAt": "2026-06-12T02:35:00Z"
25
+ }
26
+ ]
27
+ },
28
+ "summary": "Restart checkout-api deployment in payments namespace.",
29
+ "requestId": "req-approval-123",
30
+ "decidedBy": "user-456",
31
+ "decidedByName": "Grace",
32
+ "decidedAt": "2026-06-12T02:35:00Z",
33
+ "createdAt": "2026-06-12T02:30:00Z",
34
+ "updatedAt": "2026-06-12T02:35:00Z"
35
+ }
@@ -0,0 +1,14 @@
1
+ {
2
+ "id": "audit-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
3
+ "actorType": "user",
4
+ "actorId": "user-123",
5
+ "actorName": "Ada",
6
+ "skillId": "k8s-sre",
7
+ "toolName": "k8s.deployments.restart",
8
+ "riskLevel": "high",
9
+ "action": "tool.invoke",
10
+ "result": "denied",
11
+ "summary": "High-risk deployment restart was denied because approval is required.",
12
+ "requestId": "req-audit-123",
13
+ "createdAt": "2026-06-12T02:31:00Z"
14
+ }