@bluefly/openstandardagents 0.1.9 → 0.2.5-RC

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 (1074) hide show
  1. package/.cursorrules +84 -0
  2. package/.devfile.yaml +87 -0
  3. package/.env.example +25 -3
  4. package/.eslintrc.cjs +43 -0
  5. package/.github/PULL_REQUEST_TEMPLATE.md +39 -0
  6. package/.github/dependabot.yml +58 -0
  7. package/.github/workflows/ci.yml +154 -0
  8. package/.github/workflows/codeql.yml +41 -0
  9. package/.github/workflows/dependabot-auto-merge.yml +28 -0
  10. package/.github/workflows/release.yml +103 -0
  11. package/.kiro/specs/agent-buildkit-templates/design.md +495 -0
  12. package/.kiro/specs/agent-buildkit-templates/requirements.md +165 -0
  13. package/.kiro/specs/kiro-ide-supercharger/README.md +202 -0
  14. package/.kiro/specs/kiro-ide-supercharger/design.md +1005 -0
  15. package/.kiro/specs/kiro-ide-supercharger/requirements.md +141 -0
  16. package/.kiro/specs/kiro-ide-supercharger/tasks.md +507 -0
  17. package/.kiro/specs/website-design-audit/design.md +679 -0
  18. package/.kiro/specs/website-design-audit/requirements.md +199 -0
  19. package/.prettierignore +7 -0
  20. package/.prettierrc.json +10 -0
  21. package/.redocly.yaml +8 -62
  22. package/.releaserc.json +85 -0
  23. package/.version.json +6 -0
  24. package/CHANGELOG.md +196 -0
  25. package/CONTRIBUTING.md +267 -0
  26. package/LICENSE +190 -0
  27. package/README.md +253 -454
  28. package/bin/ossa +29 -0
  29. package/bin/ossa-validate-all +55 -0
  30. package/bin/ossa-version +23 -0
  31. package/bin/validate-ossa-0.2.2.ts +244 -0
  32. package/bin/validate-ossa-0.2.4.ts +244 -0
  33. package/bin/validate-ossa-0.2.5-RC.ts +244 -0
  34. package/bin/validate-ossa.ts +273 -0
  35. package/dist/di-container.d.ts +1 -1
  36. package/dist/di-container.d.ts.map +1 -1
  37. package/dist/di-container.js +0 -3
  38. package/dist/di-container.js.map +1 -1
  39. package/dist/index.d.ts +9 -27
  40. package/dist/index.d.ts.map +1 -1
  41. package/dist/index.js +13 -33
  42. package/dist/index.js.map +1 -1
  43. package/dist/repositories/schema.repository.d.ts +16 -1
  44. package/dist/repositories/schema.repository.d.ts.map +1 -1
  45. package/dist/repositories/schema.repository.js +94 -17
  46. package/dist/repositories/schema.repository.js.map +1 -1
  47. package/dist/services/generation.service.d.ts +7 -5
  48. package/dist/services/generation.service.d.ts.map +1 -1
  49. package/dist/services/generation.service.js +93 -45
  50. package/dist/services/generation.service.js.map +1 -1
  51. package/dist/services/gitlab-agent.service.d.ts.map +1 -1
  52. package/dist/services/gitlab-agent.service.js +12 -8
  53. package/dist/services/gitlab-agent.service.js.map +1 -1
  54. package/dist/services/migration.service.d.ts +3 -3
  55. package/dist/services/migration.service.d.ts.map +1 -1
  56. package/dist/services/migration.service.js +108 -61
  57. package/dist/services/migration.service.js.map +1 -1
  58. package/dist/services/release-automation/base-crud.service.d.ts +93 -0
  59. package/dist/services/release-automation/base-crud.service.d.ts.map +1 -0
  60. package/dist/services/release-automation/base-crud.service.js +68 -0
  61. package/dist/services/release-automation/base-crud.service.js.map +1 -0
  62. package/dist/services/release-automation/index.d.ts +12 -0
  63. package/dist/services/release-automation/index.d.ts.map +1 -0
  64. package/dist/services/release-automation/index.js +12 -0
  65. package/dist/services/release-automation/index.js.map +1 -0
  66. package/dist/services/release-automation/merge-request.service.d.ts +119 -0
  67. package/dist/services/release-automation/merge-request.service.d.ts.map +1 -0
  68. package/dist/services/release-automation/merge-request.service.js +212 -0
  69. package/dist/services/release-automation/merge-request.service.js.map +1 -0
  70. package/dist/services/release-automation/milestone.service.d.ts +104 -0
  71. package/dist/services/release-automation/milestone.service.d.ts.map +1 -0
  72. package/dist/services/release-automation/milestone.service.js +207 -0
  73. package/dist/services/release-automation/milestone.service.js.map +1 -0
  74. package/dist/services/release-automation/release.service.d.ts +118 -0
  75. package/dist/services/release-automation/release.service.d.ts.map +1 -0
  76. package/dist/services/release-automation/release.service.js +207 -0
  77. package/dist/services/release-automation/release.service.js.map +1 -0
  78. package/dist/services/release-automation/schemas/release.schema.d.ts +299 -0
  79. package/dist/services/release-automation/schemas/release.schema.d.ts.map +1 -0
  80. package/dist/services/release-automation/schemas/release.schema.js +269 -0
  81. package/dist/services/release-automation/schemas/release.schema.js.map +1 -0
  82. package/dist/services/release-automation/tag.service.d.ts +99 -0
  83. package/dist/services/release-automation/tag.service.d.ts.map +1 -0
  84. package/dist/services/release-automation/tag.service.js +180 -0
  85. package/dist/services/release-automation/tag.service.js.map +1 -0
  86. package/dist/services/release-automation/webhook.service.d.ts +37 -0
  87. package/dist/services/release-automation/webhook.service.d.ts.map +1 -0
  88. package/dist/services/release-automation/webhook.service.js +173 -0
  89. package/dist/services/release-automation/webhook.service.js.map +1 -0
  90. package/dist/services/runtime/openai.adapter.d.ts.map +1 -1
  91. package/dist/services/runtime/openai.adapter.js.map +1 -1
  92. package/dist/services/validation.service.d.ts.map +1 -1
  93. package/dist/services/validation.service.js +24 -11
  94. package/dist/services/validation.service.js.map +1 -1
  95. package/dist/services/validators/anthropic.validator.d.ts +2 -2
  96. package/dist/services/validators/anthropic.validator.d.ts.map +1 -1
  97. package/dist/services/validators/anthropic.validator.js +14 -9
  98. package/dist/services/validators/anthropic.validator.js.map +1 -1
  99. package/dist/services/validators/autogen.validator.d.ts +2 -2
  100. package/dist/services/validators/autogen.validator.d.ts.map +1 -1
  101. package/dist/services/validators/autogen.validator.js +18 -15
  102. package/dist/services/validators/autogen.validator.js.map +1 -1
  103. package/dist/services/validators/crewai.validator.d.ts +2 -2
  104. package/dist/services/validators/crewai.validator.d.ts.map +1 -1
  105. package/dist/services/validators/crewai.validator.js +18 -17
  106. package/dist/services/validators/crewai.validator.js.map +1 -1
  107. package/dist/services/validators/cursor.validator.d.ts +2 -2
  108. package/dist/services/validators/cursor.validator.d.ts.map +1 -1
  109. package/dist/services/validators/cursor.validator.js +15 -11
  110. package/dist/services/validators/cursor.validator.js.map +1 -1
  111. package/dist/services/validators/langchain.validator.d.ts +2 -2
  112. package/dist/services/validators/langchain.validator.d.ts.map +1 -1
  113. package/dist/services/validators/langchain.validator.js +14 -11
  114. package/dist/services/validators/langchain.validator.js.map +1 -1
  115. package/dist/services/validators/langflow.validator.d.ts +2 -2
  116. package/dist/services/validators/langflow.validator.d.ts.map +1 -1
  117. package/dist/services/validators/langflow.validator.js +14 -9
  118. package/dist/services/validators/langflow.validator.js.map +1 -1
  119. package/dist/services/validators/langgraph.validator.d.ts +2 -2
  120. package/dist/services/validators/langgraph.validator.d.ts.map +1 -1
  121. package/dist/services/validators/langgraph.validator.js +23 -18
  122. package/dist/services/validators/langgraph.validator.js.map +1 -1
  123. package/dist/services/validators/llamaindex.validator.d.ts +2 -2
  124. package/dist/services/validators/llamaindex.validator.d.ts.map +1 -1
  125. package/dist/services/validators/llamaindex.validator.js +19 -16
  126. package/dist/services/validators/llamaindex.validator.js.map +1 -1
  127. package/dist/services/validators/openai.validator.d.ts +2 -2
  128. package/dist/services/validators/openai.validator.d.ts.map +1 -1
  129. package/dist/services/validators/openai.validator.js +20 -16
  130. package/dist/services/validators/openai.validator.js.map +1 -1
  131. package/dist/services/validators/vercel-ai.validator.d.ts +2 -2
  132. package/dist/services/validators/vercel-ai.validator.d.ts.map +1 -1
  133. package/dist/services/validators/vercel-ai.validator.js +16 -15
  134. package/dist/services/validators/vercel-ai.validator.js.map +1 -1
  135. package/dist/spec/v0.2.3/CHANGELOG.md +176 -0
  136. package/dist/spec/v0.2.3/README.md +4 -4
  137. package/dist/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +7 -7
  138. package/dist/spec/v0.2.4/CHANGELOG.md +403 -0
  139. package/dist/spec/v0.2.4/migrations/v0.2.3-to-v0.2.4.md +599 -0
  140. package/dist/spec/v0.2.4/ossa-0.2.4-dev.schema.json +1696 -0
  141. package/dist/spec/v0.2.4/ossa-0.2.4.schema.json +1819 -0
  142. package/dist/spec/v0.2.5/CHANGELOG.md +401 -0
  143. package/dist/spec/v0.2.5/README.md +72 -0
  144. package/dist/spec/v0.2.5/migrations/v0.2.3-to-v0.2.4.md +599 -0
  145. package/dist/spec/v0.2.5/ossa-0.2.5.schema.json +1696 -0
  146. package/dist/spec/v0.2.5/ossa-0.2.5.yaml +581 -0
  147. package/dist/spec/v0.2.5-RC/CHANGELOG.md +401 -0
  148. package/dist/spec/v0.2.5-RC/README.md +72 -0
  149. package/dist/spec/v0.2.5-RC/migrations/v0.2.3-to-v0.2.4.md +599 -0
  150. package/dist/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json +1696 -0
  151. package/dist/spec/v0.2.5-RC/ossa-0.2.5-RC.yaml +581 -0
  152. package/dist/types/index.d.ts +164 -260
  153. package/dist/types/index.d.ts.map +1 -1
  154. package/dist/types/index.js +3 -65
  155. package/dist/types/index.js.map +1 -1
  156. package/docs/issue-19-completion-summary.md +648 -0
  157. package/docs/issue-19-validation.md +351 -0
  158. package/examples/adk-integration/code-review-workflow.yml +136 -0
  159. package/examples/adk-integration/customer-support.yml +263 -0
  160. package/examples/adk-integration/data-pipeline.yml +173 -0
  161. package/examples/advanced/patterns/compliance-context-production.json +53 -0
  162. package/examples/advanced/patterns/model-router.ts +274 -0
  163. package/examples/advanced/patterns/smart-model-routing.ts +248 -0
  164. package/examples/advanced/workflows/hybrid-model-strategy.yaml +232 -0
  165. package/examples/agent-manifests/critics/critic-agent.yaml +149 -0
  166. package/examples/agent-manifests/governors/governor-agent.yaml +128 -0
  167. package/examples/agent-manifests/integrators/integrator-agent.yaml +103 -0
  168. package/examples/agent-manifests/judges/judge-agent.yaml +153 -0
  169. package/examples/agent-manifests/monitors/monitor-agent.yaml +122 -0
  170. package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml +247 -0
  171. package/examples/agent-manifests/sample-compliant-agent.yaml +147 -0
  172. package/examples/agent-manifests/workers/worker-agent.yaml +82 -0
  173. package/examples/anthropic/claude-assistant.ossa.json +45 -0
  174. package/examples/architecture/model-configuration/ollama-integration.ts +110 -0
  175. package/examples/autogen/multi-agent.ossa.json +37 -0
  176. package/examples/bridge-configurations.yaml +346 -0
  177. package/examples/bridges/Dockerfile.production +87 -0
  178. package/examples/bridges/__pycache__/aiflow-bridge-enhanced.cpython-313.pyc +0 -0
  179. package/examples/bridges/__pycache__/aiflow-phoenix-tracing.cpython-313.pyc +0 -0
  180. package/examples/bridges/__pycache__/test_aiflow_integration.cpython-313.pyc +0 -0
  181. package/examples/bridges/aiflow-bridge-enhanced.py +462 -0
  182. package/examples/bridges/aiflow-bridge-example.yml +310 -0
  183. package/examples/bridges/aiflow-phoenix-tracing.py +310 -0
  184. package/examples/bridges/aiflow-registration-api.openapi.yml +439 -0
  185. package/examples/bridges/k8s/configmap.yaml +121 -0
  186. package/examples/bridges/k8s/deployment-simple.yaml +34 -0
  187. package/examples/bridges/k8s/deployment.yaml +275 -0
  188. package/examples/bridges/k8s/hpa.yaml +126 -0
  189. package/examples/bridges/k8s/ingress.yaml +155 -0
  190. package/examples/bridges/kagent-bridge-example.yml +94 -0
  191. package/examples/bridges/load-tests/Dockerfile +28 -0
  192. package/examples/bridges/load-tests/k6-load-test.js +302 -0
  193. package/examples/bridges/load-tests/requirements.txt +20 -0
  194. package/examples/bridges/loadtest/k6-scenarios.js +270 -0
  195. package/examples/bridges/phase4/SLO-SLA.yaml +249 -0
  196. package/examples/bridges/phase4/chaos-tests.yaml +226 -0
  197. package/examples/bridges/requirements.txt +24 -0
  198. package/examples/bridges/test_aiflow_integration.py +341 -0
  199. package/examples/common_npm/agent-router.ossa.yaml +182 -0
  200. package/examples/common_npm/agent-router.v0.2.2.ossa.yaml +60 -0
  201. package/examples/compliance-agent.yml +155 -0
  202. package/examples/crewai/research-team.ossa.json +36 -0
  203. package/examples/cursor/code-review-agent.ossa.json +47 -0
  204. package/examples/drupal/gitlab-ml-recommender.ossa.yaml +609 -0
  205. package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml +68 -0
  206. package/examples/enterprise/agent.yml +452 -0
  207. package/examples/extensions/drupal-v1.yml +266 -0
  208. package/examples/extensions/kagent-v1.yml +167 -0
  209. package/examples/getting-started/hello-world-complete.ossa.yaml +266 -0
  210. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +376 -0
  211. package/examples/kagent/README.md +31 -0
  212. package/examples/kagent/compliance-validator.ossa.yaml +111 -0
  213. package/examples/kagent/cost-optimizer.ossa.yaml +93 -0
  214. package/examples/kagent/documentation-agent.ossa.yaml +91 -0
  215. package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml +269 -0
  216. package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml +106 -0
  217. package/examples/kagent/k8s-troubleshooter.ossa.yaml +257 -0
  218. package/examples/kagent/security-scanner.ossa.yaml +140 -0
  219. package/examples/langchain/chain-agent.ossa.json +42 -0
  220. package/examples/langflow/workflow-agent.ossa.json +39 -0
  221. package/examples/langgraph/state-machine-agent.ossa.json +59 -0
  222. package/examples/llamaindex/rag-agent.ossa.json +41 -0
  223. package/examples/migration-guides/from-langchain-to-ossa.yaml +309 -0
  224. package/examples/minimal/agent.yml +152 -0
  225. package/examples/minimal/openapi.yaml +95 -0
  226. package/examples/openai/basic-agent.ossa.yaml +61 -0
  227. package/examples/openai/multi-tool-agent.ossa.json +165 -0
  228. package/examples/openai/swarm-agent.ossa.json +59 -0
  229. package/examples/openapi-extensions/README.md +87 -0
  230. package/examples/openapi-extensions/minimal-agent-api.openapi.yml +288 -0
  231. package/examples/openapi-extensions/orchestrator-agent-api.openapi.yml +633 -0
  232. package/examples/openapi-extensions/worker-agent-api.openapi.yml +533 -0
  233. package/examples/production/agent.yml +713 -0
  234. package/examples/production/document-analyzer-openai.yml +134 -0
  235. package/examples/quickstart/support-agent.ossa.yaml +59 -0
  236. package/examples/service-registry-usage.ts +423 -0
  237. package/examples/spec-examples/audit-agent.yml +147 -0
  238. package/examples/spec-examples/chat-agent.yml +189 -0
  239. package/examples/spec-examples/compliance-agent.yml +204 -0
  240. package/examples/spec-examples/data-processing-agent.yml +132 -0
  241. package/examples/spec-examples/development-agent.yml +138 -0
  242. package/examples/spec-examples/edge-agent.yml +101 -0
  243. package/examples/spec-examples/integration-agent.yml +129 -0
  244. package/examples/spec-examples/monitoring-agent.yml +130 -0
  245. package/examples/spec-examples/serverless-agent.yml +82 -0
  246. package/examples/spec-examples/workflow-agent.yml +223 -0
  247. package/examples/templates/ossa-compliance.yaml +56 -0
  248. package/examples/typescript/advanced/demo-registry.ts +168 -0
  249. package/examples/typescript/mcpb-agent-example.ts +358 -0
  250. package/examples/vercel/edge-agent.ossa.json +43 -0
  251. package/infrastructure/docker-compose.yml +33 -0
  252. package/infrastructure/gitlab-agent/rbac.yaml +126 -0
  253. package/infrastructure/gitlab-agent/values.yaml +150 -0
  254. package/infrastructure/k8s/monitoring/00-namespace.yaml +7 -0
  255. package/infrastructure/k8s/monitoring/01-prometheus.yaml +142 -0
  256. package/infrastructure/k8s/monitoring/02-grafana.yaml +63 -0
  257. package/infrastructure/k8s/monitoring/03-lightweight.yaml +121 -0
  258. package/infrastructure/k8s/monitoring/README.md +73 -0
  259. package/infrastructure/k8s/monitoring/deploy.sh +38 -0
  260. package/openapi/CHANGELOG.md +21 -0
  261. package/openapi/README.md +46 -0
  262. package/openapi/core/ossa-core-api.openapi.yaml +1503 -0
  263. package/openapi/core/ossa-registry-api.openapi.yaml +980 -0
  264. package/openapi/core/ossa-registry.openapi.yaml +855 -0
  265. package/openapi/core/unified-agent-gateway.openapi.yaml +833 -0
  266. package/openapi/reference-implementations/aiflow-bridge-api.openapi.yaml +136 -0
  267. package/openapi/reference-implementations/compliance-agent-api.openapi.yaml +192 -0
  268. package/openapi/reference-implementations/crewai-agent-api.openapi.yaml +149 -0
  269. package/openapi/reference-implementations/critic-agent-api.openapi.yaml +151 -0
  270. package/openapi/reference-implementations/document-analyzer-api.openapi.yaml +217 -0
  271. package/openapi/reference-implementations/drupal-agent-api.openapi.yaml +348 -0
  272. package/openapi/reference-implementations/getting-started-hello-world-api.openapi.yaml +149 -0
  273. package/openapi/reference-implementations/gitlab-ml-recommender-api.openapi.yaml +151 -0
  274. package/openapi/reference-implementations/governor-agent-api.openapi.yaml +193 -0
  275. package/openapi/reference-implementations/helm-generator.openapi.yaml +389 -0
  276. package/openapi/reference-implementations/integrator-agent-api.openapi.yaml +165 -0
  277. package/openapi/reference-implementations/judge-agent-api.openapi.yaml +148 -0
  278. package/openapi/reference-implementations/k8s-troubleshooter-api.openapi.yaml +167 -0
  279. package/openapi/reference-implementations/langchain-agent-api.openapi.yaml +171 -0
  280. package/openapi/reference-implementations/monitor-agent-api.openapi.yaml +171 -0
  281. package/openapi/reference-implementations/orchestrator-agent-api.openapi.yaml +242 -0
  282. package/openapi/reference-implementations/quickstart-support-agent-api.openapi.yaml +187 -0
  283. package/openapi/reference-implementations/self-evolving-ecosystem.openapi.yaml +1530 -0
  284. package/openapi/reference-implementations/worker-agent-api.openapi.yaml +208 -0
  285. package/openapi/reference-implementations/workflow-orchestrator-api.openapi.yaml +193 -0
  286. package/package.json +120 -83
  287. package/release.config.js +79 -0
  288. package/scripts/bump-version.ts +57 -0
  289. package/scripts/enhanced-version-manager.ts +257 -0
  290. package/scripts/gen-types.ts +51 -0
  291. package/scripts/gen-zod.ts +51 -0
  292. package/scripts/lib/exec.ts +37 -0
  293. package/scripts/lib/file-ops.ts +58 -0
  294. package/scripts/lib/version.ts +83 -0
  295. package/scripts/process-doc-templates.ts +37 -0
  296. package/scripts/schemas/package.schema.ts +75 -0
  297. package/scripts/setup-branch-protection.sh +33 -0
  298. package/scripts/sync-version.ts +39 -0
  299. package/scripts/sync-versions.ts +488 -0
  300. package/scripts/validate-schema.ts +49 -0
  301. package/spec/v0.1.9/agent-autonomous-extensions.json +234 -0
  302. package/spec/v0.1.9/ecosystem-compliance.json +235 -0
  303. package/spec/v0.1.9/ossa-v0.1.9.schema.json +695 -0
  304. package/spec/v0.1.9/reasoning-compliance.json +654 -0
  305. package/spec/v0.2.2/kagent-enhancements.json +395 -0
  306. package/spec/v0.2.2/ossa-0.2.2.schema.json +906 -0
  307. package/spec/v0.2.2/ossa-0.2.2.yaml +448 -0
  308. package/spec/v0.2.2/ossa-reasoning-compliance-1.0.schema.json +424 -0
  309. package/spec/v0.2.3/CHANGELOG.md +176 -0
  310. package/spec/v0.2.3/README.md +154 -0
  311. package/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +343 -0
  312. package/spec/v0.2.3/ossa-0.2.3.schema.json +1397 -0
  313. package/spec/v0.2.3/ossa-0.2.3.yaml +448 -0
  314. package/spec/v0.2.4/CHANGELOG.md +403 -0
  315. package/spec/v0.2.4/migrations/v0.2.3-to-v0.2.4.md +599 -0
  316. package/spec/v0.2.4/ossa-0.2.4-dev.schema.json +1696 -0
  317. package/spec/v0.2.4/ossa-0.2.4.schema.json +170 -68
  318. package/spec/v0.2.5/CHANGELOG.md +401 -0
  319. package/spec/v0.2.5/README.md +72 -0
  320. package/spec/v0.2.5/migrations/v0.2.3-to-v0.2.4.md +599 -0
  321. package/spec/v0.2.5/ossa-0.2.5.schema.json +1696 -0
  322. package/spec/v0.2.5/ossa-0.2.5.yaml +581 -0
  323. package/spec/v0.2.5-RC/CHANGELOG.md +401 -0
  324. package/spec/v0.2.5-RC/README.md +72 -0
  325. package/spec/v0.2.5-RC/migrations/v0.2.3-to-v0.2.4.md +599 -0
  326. package/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json +1696 -0
  327. package/spec/v0.2.5-RC/ossa-0.2.5-RC.yaml +581 -0
  328. package/test-results.xml +1 -0
  329. package/website/.lighthouserc.ts +24 -0
  330. package/website/.prettierrc +10 -0
  331. package/website/Dockerfile +30 -0
  332. package/website/app/about/page.tsx +295 -0
  333. package/website/app/blog/[slug]/page.tsx +208 -0
  334. package/website/app/blog/page.tsx +249 -0
  335. package/website/app/design-guide/page.tsx +511 -0
  336. package/website/app/docs/[[...slug]]/page.tsx +847 -0
  337. package/website/app/docs/core-concepts/project-structure/page.tsx +349 -0
  338. package/website/app/ecosystem/page.tsx +375 -0
  339. package/website/app/examples/page.tsx +133 -0
  340. package/website/app/globals.scss +135 -0
  341. package/website/app/layout.tsx +106 -0
  342. package/website/app/license/page.tsx +183 -0
  343. package/website/app/not-found.tsx +18 -0
  344. package/website/app/page.tsx +474 -0
  345. package/website/app/playground/page.tsx +487 -0
  346. package/website/app/robots.ts +19 -0
  347. package/website/app/rss.xml/route.ts +74 -0
  348. package/website/app/schema/page.tsx +1001 -0
  349. package/website/app/sitemap.ts +56 -0
  350. package/website/app/specification/page.tsx +287 -0
  351. package/website/components/InstallCommand.tsx +96 -0
  352. package/website/components/Logo.tsx +97 -0
  353. package/website/components/StructuredData.tsx +65 -0
  354. package/website/components/docs/DocsSearch.tsx +104 -0
  355. package/website/components/docs/DocsSidebar.tsx +155 -0
  356. package/website/components/docs/MarkdownContent.tsx +401 -0
  357. package/website/components/docs/VersionSelector.tsx +105 -0
  358. package/website/components/examples/ExamplesViewer.tsx +293 -0
  359. package/website/components/layout/Footer.tsx +116 -0
  360. package/website/components/layout/Header.tsx +168 -0
  361. package/website/components/schema/SchemaComponentsAccordion.tsx +84 -0
  362. package/website/components/schema/SchemaExplorer.tsx +213 -0
  363. package/website/content/blog/OpenAPI-AI-Agents-Standard.md +285 -0
  364. package/website/content/blog/Why-Formal-Standards-Matter-Now.md +198 -0
  365. package/website/content/blog/gitlab-kubernetes-agent-ecosystem.md +286 -0
  366. package/website/content/blog/introducing-ossa-framework.md +328 -0
  367. package/website/content/blog/ossa-production-results.md +279 -0
  368. package/website/content/blog/welcome-to-ossa.md +43 -0
  369. package/website/content/blog/why-ai-agents-need-open-standard.md +98 -0
  370. package/website/content/docs/00-HOME.md +153 -0
  371. package/website/content/docs/AIFlow-Framework-Integration-with-OSSA.md +107 -0
  372. package/website/content/docs/Examples.md +71 -0
  373. package/website/content/docs/OpenAPI-Extensions.md +934 -0
  374. package/website/content/docs/adapters/openai-adapter.md +693 -0
  375. package/website/content/docs/architecture/execution-flow.md +335 -0
  376. package/website/content/docs/architecture/multi-agent-systems.md +737 -0
  377. package/website/content/docs/architecture/overview.md +121 -0
  378. package/website/content/docs/architecture/stack-integration.md +461 -0
  379. package/website/content/docs/changelog.md +246 -0
  380. package/website/content/docs/contributing.md +599 -0
  381. package/website/content/docs/core-concepts/Project-Structure.md +348 -0
  382. package/website/content/docs/ecosystem/framework-support.md +819 -0
  383. package/website/content/docs/ecosystem/overview.md +366 -0
  384. package/website/content/docs/examples/AIFlow-Framework-Integration-with-OSSA.md +107 -0
  385. package/website/content/docs/examples/Migration-Guides.md +214 -0
  386. package/website/content/docs/for-audiences/Architects.md +224 -0
  387. package/website/content/docs/for-audiences/Developers.md +220 -0
  388. package/website/content/docs/for-audiences/Enterprises.md +256 -0
  389. package/website/content/docs/for-audiences/Students-Researchers.md +122 -0
  390. package/website/content/docs/getting-started/5-Minute-Overview.md +85 -0
  391. package/website/content/docs/getting-started/First-Agent.md +196 -0
  392. package/website/content/docs/getting-started/Hello-World.md +184 -0
  393. package/website/content/docs/getting-started/Installation.md +155 -0
  394. package/website/content/docs/getting-started/index.md +92 -0
  395. package/website/content/docs/getting-started/running-agents.md +309 -0
  396. package/website/content/docs/getting-started.md +91 -0
  397. package/website/content/docs/integrations/aiflow.md +104 -0
  398. package/website/content/docs/integrations/drupal.md +105 -0
  399. package/website/content/docs/migration-guides/00-INDEX.md +76 -0
  400. package/website/content/docs/migration-guides/README.md +133 -0
  401. package/website/content/docs/migration-guides/agent-schema-comparison.md +232 -0
  402. package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +1750 -0
  403. package/website/content/docs/migration-guides/crewai-to-ossa.md +274 -0
  404. package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +2017 -0
  405. package/website/content/docs/migration-guides/general-agent-schema.yml +247 -0
  406. package/website/content/docs/migration-guides/index.md +133 -0
  407. package/website/content/docs/migration-guides/langchain-to-ossa.md +1714 -0
  408. package/website/content/docs/migration-guides/langflow-to-ossa.md +2075 -0
  409. package/website/content/docs/migration-guides/migration-manifest.json +64 -0
  410. package/website/content/docs/migration-guides/openai-to-ossa.md +1202 -0
  411. package/website/content/docs/openapi-extensions/examples.md +550 -0
  412. package/website/content/docs/openapi-extensions/index.md +551 -0
  413. package/website/content/docs/openapi-extensions/operation-extensions.md +457 -0
  414. package/website/content/docs/openapi-extensions/root-extensions.md +410 -0
  415. package/website/content/docs/ossa-compliant-badge.md +251 -0
  416. package/website/content/docs/pre-release/index.md +175 -0
  417. package/website/content/docs/quick-reference.md +17 -0
  418. package/website/content/docs/readme.md +35 -0
  419. package/website/content/docs/schema-reference/agent-spec.md +406 -0
  420. package/website/content/docs/schema-reference/autonomy.md +568 -0
  421. package/website/content/docs/schema-reference/constraints.md +543 -0
  422. package/website/content/docs/schema-reference/index.md +176 -0
  423. package/website/content/docs/schema-reference/llm-config.md +445 -0
  424. package/website/content/docs/schema-reference/observability.md +654 -0
  425. package/website/content/docs/schema-reference/ossa-manifest.md +309 -0
  426. package/website/content/docs/schema-reference/taxonomy.md +509 -0
  427. package/website/content/docs/schema-reference/tools.md +628 -0
  428. package/website/content/docs/templates/blog-post.md +43 -0
  429. package/website/content/docs/use-cases/00-index.md +395 -0
  430. package/website/content/docs/use-cases/cicd-code-review.md +1236 -0
  431. package/website/content/docs/use-cases/customer-support.md +1234 -0
  432. package/website/content/docs/use-cases/enterprise-compliance.md +1208 -0
  433. package/website/content/docs/use-cases/research-multi-agent.md +1161 -0
  434. package/website/content/docs/versioning.md +288 -0
  435. package/website/lib/version.ts +35 -0
  436. package/website/lib/versions.json +18 -17
  437. package/website/next.config.ts +18 -0
  438. package/website/nginx.conf +32 -0
  439. package/website/package-lock.json +9679 -0
  440. package/website/package.json +59 -0
  441. package/website/postcss.config.mjs +9 -0
  442. package/website/scripts/fetch-versions.js +166 -0
  443. package/website/scripts/generate-examples-index.js +163 -0
  444. package/website/scripts/merge-docs-to-wiki.ts +207 -0
  445. package/website/scripts/sync-version.js +72 -0
  446. package/website/scripts/sync-wiki.ts +322 -0
  447. package/website/scripts/upload-wiki.ts +199 -0
  448. package/website/styles/_variables.scss +36 -0
  449. package/website/tailwind.config.ts +136 -0
  450. package/.buildkit/agent-first-policy.sh +0 -65
  451. package/.buildkit/branching-workflow.json +0 -41
  452. package/.buildkit/hooks.yaml +0 -23
  453. package/.buildkit/install-buildkit-setup.cjs +0 -483
  454. package/.cursor/plans/ossa-comprehensive-enhancement-issue-audit-plan.plan.md +0 -735
  455. package/.cursor/plans/ossa-enterprise-transformation-plan-0ccaf09b.plan.md +0 -373
  456. package/.cursor/plans/ossa-milestone-organization-and-v0-2-4-release-6dafa4ec.plan.md +0 -214
  457. package/.cursor/rules/problems.json +0 -483
  458. package/.cursor/settings.json +0 -29
  459. package/.cursor/worktrees.json +0 -95
  460. package/.env.local +0 -31
  461. package/.github/ISSUE_TEMPLATE/README.md +0 -33
  462. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -61
  463. package/.github/ISSUE_TEMPLATE/config.yml +0 -12
  464. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -75
  465. package/.github/wiki_templates/home.md +0 -39
  466. package/.gitignore.bak +0 -489
  467. package/.gitlab-ci-trigger +0 -1
  468. package/.husky/pre-commit +0 -31
  469. package/.lintstagedrc.json +0 -16
  470. package/.vscode/extensions.json +0 -6
  471. package/.vscode/settings.json +0 -3
  472. package/AUDIT_FIXES.md +0 -139
  473. package/AUDIT_REPORT.md +0 -308
  474. package/BUILDKIT_INTEGRATION.md +0 -146
  475. package/Dockerfile +0 -35
  476. package/dist/adk/adapters/index.d.ts +0 -64
  477. package/dist/adk/adapters/index.d.ts.map +0 -1
  478. package/dist/adk/adapters/index.js +0 -257
  479. package/dist/adk/adapters/index.js.map +0 -1
  480. package/dist/adk/agents/custom-agent.d.ts +0 -55
  481. package/dist/adk/agents/custom-agent.d.ts.map +0 -1
  482. package/dist/adk/agents/custom-agent.js +0 -167
  483. package/dist/adk/agents/custom-agent.js.map +0 -1
  484. package/dist/adk/agents/index.d.ts +0 -64
  485. package/dist/adk/agents/index.d.ts.map +0 -1
  486. package/dist/adk/agents/index.js +0 -125
  487. package/dist/adk/agents/index.js.map +0 -1
  488. package/dist/adk/agents/llm-agent.d.ts +0 -27
  489. package/dist/adk/agents/llm-agent.d.ts.map +0 -1
  490. package/dist/adk/agents/llm-agent.js +0 -63
  491. package/dist/adk/agents/llm-agent.js.map +0 -1
  492. package/dist/adk/agents/workflow-agent.d.ts +0 -42
  493. package/dist/adk/agents/workflow-agent.d.ts.map +0 -1
  494. package/dist/adk/agents/workflow-agent.js +0 -144
  495. package/dist/adk/agents/workflow-agent.js.map +0 -1
  496. package/dist/adk/index.d.ts +0 -10
  497. package/dist/adk/index.d.ts.map +0 -1
  498. package/dist/adk/index.js +0 -10
  499. package/dist/adk/index.js.map +0 -1
  500. package/dist/adk/orchestration/index.d.ts +0 -63
  501. package/dist/adk/orchestration/index.d.ts.map +0 -1
  502. package/dist/adk/orchestration/index.js +0 -264
  503. package/dist/adk/orchestration/index.js.map +0 -1
  504. package/dist/adk/state/index.d.ts +0 -73
  505. package/dist/adk/state/index.d.ts.map +0 -1
  506. package/dist/adk/state/index.js +0 -177
  507. package/dist/adk/state/index.js.map +0 -1
  508. package/dist/adk/tools/index.d.ts +0 -65
  509. package/dist/adk/tools/index.d.ts.map +0 -1
  510. package/dist/adk/tools/index.js +0 -252
  511. package/dist/adk/tools/index.js.map +0 -1
  512. package/dist/cli/agent-deployment.d.ts +0 -34
  513. package/dist/cli/agent-deployment.d.ts.map +0 -1
  514. package/dist/cli/agent-deployment.js +0 -396
  515. package/dist/cli/agent-deployment.js.map +0 -1
  516. package/dist/cli/commands/discover.command.d.ts +0 -7
  517. package/dist/cli/commands/discover.command.d.ts.map +0 -1
  518. package/dist/cli/commands/discover.command.js +0 -80
  519. package/dist/cli/commands/discover.command.js.map +0 -1
  520. package/dist/cli/commands/export.command.d.ts +0 -7
  521. package/dist/cli/commands/export.command.d.ts.map +0 -1
  522. package/dist/cli/commands/export.command.js +0 -56
  523. package/dist/cli/commands/export.command.js.map +0 -1
  524. package/dist/cli/commands/generate.command.d.ts +0 -7
  525. package/dist/cli/commands/generate.command.d.ts.map +0 -1
  526. package/dist/cli/commands/generate.command.js +0 -66
  527. package/dist/cli/commands/generate.command.js.map +0 -1
  528. package/dist/cli/commands/gitlab-agent.command.d.ts +0 -8
  529. package/dist/cli/commands/gitlab-agent.command.d.ts.map +0 -1
  530. package/dist/cli/commands/gitlab-agent.command.js +0 -201
  531. package/dist/cli/commands/gitlab-agent.command.js.map +0 -1
  532. package/dist/cli/commands/import.command.d.ts +0 -7
  533. package/dist/cli/commands/import.command.d.ts.map +0 -1
  534. package/dist/cli/commands/import.command.js +0 -36
  535. package/dist/cli/commands/import.command.js.map +0 -1
  536. package/dist/cli/commands/init.command.d.ts +0 -7
  537. package/dist/cli/commands/init.command.d.ts.map +0 -1
  538. package/dist/cli/commands/init.command.js +0 -146
  539. package/dist/cli/commands/init.command.js.map +0 -1
  540. package/dist/cli/commands/migrate.command.d.ts +0 -7
  541. package/dist/cli/commands/migrate.command.d.ts.map +0 -1
  542. package/dist/cli/commands/migrate.command.js +0 -110
  543. package/dist/cli/commands/migrate.command.js.map +0 -1
  544. package/dist/cli/commands/ossa.d.ts +0 -9
  545. package/dist/cli/commands/ossa.d.ts.map +0 -1
  546. package/dist/cli/commands/ossa.js +0 -234
  547. package/dist/cli/commands/ossa.js.map +0 -1
  548. package/dist/cli/commands/run.command.d.ts +0 -7
  549. package/dist/cli/commands/run.command.d.ts.map +0 -1
  550. package/dist/cli/commands/run.command.js +0 -114
  551. package/dist/cli/commands/run.command.js.map +0 -1
  552. package/dist/cli/commands/schema.command.d.ts +0 -7
  553. package/dist/cli/commands/schema.command.d.ts.map +0 -1
  554. package/dist/cli/commands/schema.command.js +0 -72
  555. package/dist/cli/commands/schema.command.js.map +0 -1
  556. package/dist/cli/commands/validate.command.d.ts +0 -7
  557. package/dist/cli/commands/validate.command.d.ts.map +0 -1
  558. package/dist/cli/commands/validate.command.js +0 -125
  559. package/dist/cli/commands/validate.command.js.map +0 -1
  560. package/dist/cli/commands/worktree.d.ts +0 -7
  561. package/dist/cli/commands/worktree.d.ts.map +0 -1
  562. package/dist/cli/commands/worktree.js +0 -509
  563. package/dist/cli/commands/worktree.js.map +0 -1
  564. package/dist/cli/index.d.ts +0 -7
  565. package/dist/cli/index.d.ts.map +0 -1
  566. package/dist/cli/index.js +0 -50
  567. package/dist/cli/index.js.map +0 -1
  568. package/dist/cli/ossa-cli.d.ts +0 -52
  569. package/dist/cli/ossa-cli.d.ts.map +0 -1
  570. package/dist/cli/ossa-cli.js +0 -1061
  571. package/dist/cli/ossa-cli.js.map +0 -1
  572. package/dist/core/index.d.ts +0 -31
  573. package/dist/core/index.d.ts.map +0 -1
  574. package/dist/core/index.js +0 -37
  575. package/dist/core/index.js.map +0 -1
  576. package/dist/core/mcp-server-implementation.d.ts +0 -39
  577. package/dist/core/mcp-server-implementation.d.ts.map +0 -1
  578. package/dist/core/mcp-server-implementation.js +0 -1262
  579. package/dist/core/mcp-server-implementation.js.map +0 -1
  580. package/dist/core/orchestrator/index.d.ts +0 -156
  581. package/dist/core/orchestrator/index.d.ts.map +0 -1
  582. package/dist/core/orchestrator/index.js +0 -446
  583. package/dist/core/orchestrator/index.js.map +0 -1
  584. package/dist/core/orchestrator/ossa-orchestrator.d.ts +0 -106
  585. package/dist/core/orchestrator/ossa-orchestrator.d.ts.map +0 -1
  586. package/dist/core/orchestrator/ossa-orchestrator.js +0 -396
  587. package/dist/core/orchestrator/ossa-orchestrator.js.map +0 -1
  588. package/dist/protocols/acap.d.ts +0 -61
  589. package/dist/protocols/acap.d.ts.map +0 -1
  590. package/dist/protocols/acap.js +0 -92
  591. package/dist/protocols/acap.js.map +0 -1
  592. package/dist/protocols/index.d.ts +0 -8
  593. package/dist/protocols/index.d.ts.map +0 -1
  594. package/dist/protocols/index.js +0 -8
  595. package/dist/protocols/index.js.map +0 -1
  596. package/dist/protocols/rasp.d.ts +0 -58
  597. package/dist/protocols/rasp.d.ts.map +0 -1
  598. package/dist/protocols/rasp.js +0 -212
  599. package/dist/protocols/rasp.js.map +0 -1
  600. package/dist/server/simple-app.d.ts +0 -18
  601. package/dist/server/simple-app.d.ts.map +0 -1
  602. package/dist/server/simple-app.js +0 -155
  603. package/dist/server/simple-app.js.map +0 -1
  604. package/dist/server/types/agent.d.ts +0 -498
  605. package/dist/server/types/agent.d.ts.map +0 -1
  606. package/dist/server/types/agent.js +0 -37
  607. package/dist/server/types/agent.js.map +0 -1
  608. package/dist/server/types/server.d.ts +0 -370
  609. package/dist/server/types/server.d.ts.map +0 -1
  610. package/dist/server/types/server.js +0 -68
  611. package/dist/server/types/server.js.map +0 -1
  612. package/dist/services/discovery.service.d.ts +0 -78
  613. package/dist/services/discovery.service.d.ts.map +0 -1
  614. package/dist/services/discovery.service.js +0 -212
  615. package/dist/services/discovery.service.js.map +0 -1
  616. package/dist/services/orchestration/worktree-orchestrator.d.ts +0 -146
  617. package/dist/services/orchestration/worktree-orchestrator.d.ts.map +0 -1
  618. package/dist/services/orchestration/worktree-orchestrator.js +0 -591
  619. package/dist/services/orchestration/worktree-orchestrator.js.map +0 -1
  620. package/dist/services/worktree/branching-strategy.d.ts +0 -17
  621. package/dist/services/worktree/branching-strategy.d.ts.map +0 -1
  622. package/dist/services/worktree/branching-strategy.js +0 -66
  623. package/dist/services/worktree/branching-strategy.js.map +0 -1
  624. package/dist/services/worktree/git-worktree-manager.d.ts +0 -32
  625. package/dist/services/worktree/git-worktree-manager.d.ts.map +0 -1
  626. package/dist/services/worktree/git-worktree-manager.js +0 -61
  627. package/dist/services/worktree/git-worktree-manager.js.map +0 -1
  628. package/dist/spec/v0.2.4-dev/README.md +0 -61
  629. package/dist/spec/v0.2.4-dev/RELEASE-PROCESS.md +0 -130
  630. package/dist/spec/v0.2.4-dev/migrations/v0.2.3-to-v0.2.4.md +0 -599
  631. package/dist/spec/v0.2.4-dev/openapi/CHANGELOG-0.2.4.md +0 -177
  632. package/dist/spec/v0.2.4-dev/openapi/README-0.2.4.md +0 -51
  633. package/dist/spec/v0.2.4-dev/openapi/VERIFICATION-0.2.4.md +0 -147
  634. package/dist/spec/v0.2.4-dev/ossa-0.2.4-dev.schema.json +0 -1717
  635. package/dist/spec/v0.2.5-dev/migrations/v0.2.4-to-v0.2.5.md +0 -317
  636. package/dist/spec/v0.2.5-dev/ossa-0.2.5-dev.schema.json +0 -1732
  637. package/dist/spec/v0.2.5-dev/ossa-0.2.5-dev.yaml +0 -409
  638. package/dist/specification/validator.d.ts +0 -82
  639. package/dist/specification/validator.d.ts.map +0 -1
  640. package/dist/specification/validator.js +0 -562
  641. package/dist/specification/validator.js.map +0 -1
  642. package/dist/types/acdl-api.d.ts +0 -335
  643. package/dist/types/acdl-api.d.ts.map +0 -1
  644. package/dist/types/acdl-api.js +0 -6
  645. package/dist/types/acdl-api.js.map +0 -1
  646. package/dist/types/agents/index.d.ts +0 -53
  647. package/dist/types/agents/index.d.ts.map +0 -1
  648. package/dist/types/agents/index.js +0 -5
  649. package/dist/types/agents/index.js.map +0 -1
  650. package/dist/types/api.d.ts +0 -225
  651. package/dist/types/api.d.ts.map +0 -1
  652. package/dist/types/api.js +0 -6
  653. package/dist/types/api.js.map +0 -1
  654. package/dist/types/architecture/index.d.ts +0 -530
  655. package/dist/types/architecture/index.d.ts.map +0 -1
  656. package/dist/types/architecture/index.js +0 -258
  657. package/dist/types/architecture/index.js.map +0 -1
  658. package/dist/types/policies/index.d.ts +0 -35
  659. package/dist/types/policies/index.d.ts.map +0 -1
  660. package/dist/types/policies/index.js +0 -5
  661. package/dist/types/policies/index.js.map +0 -1
  662. package/dist/types/workflows/index.d.ts +0 -40
  663. package/dist/types/workflows/index.d.ts.map +0 -1
  664. package/dist/types/workflows/index.js +0 -5
  665. package/dist/types/workflows/index.js.map +0 -1
  666. package/dist/utils/version-resolver.d.ts +0 -28
  667. package/dist/utils/version-resolver.d.ts.map +0 -1
  668. package/dist/utils/version-resolver.js +0 -110
  669. package/dist/utils/version-resolver.js.map +0 -1
  670. package/docker-compose.yml +0 -160
  671. package/public/api-docs.html +0 -206
  672. package/public/assets/favicon.svg +0 -8
  673. package/public/assets/script.js +0 -279
  674. package/public/assets/style.css +0 -632
  675. package/public/index.html +0 -307
  676. package/public/redocly-config.yaml +0 -80
  677. package/public/src/api/acdl-specification.yml +0 -531
  678. package/public/src/api/clean-architecture.openapi.yml +0 -1435
  679. package/public/src/api/context7-mcp.openapi.yml +0 -313
  680. package/public/src/api/magic-mcp.openapi.yml +0 -647
  681. package/public/src/api/mcp-infrastructure.openapi.yml +0 -904
  682. package/public/src/api/orchestration.openapi.yml +0 -444
  683. package/public/src/api/ossa-complete.openapi.yml +0 -2250
  684. package/public/src/api/project-discovery.openapi.yml +0 -1293
  685. package/public/src/api/rebuild-audit.openapi.yml +0 -800
  686. package/public/src/api/specification.openapi.yml +0 -498
  687. package/public/src/api/voice-agent-specification.yml +0 -640
  688. package/public/src/api/web-eval-mcp.openapi.yml +0 -426
  689. package/pyrightconfig.json +0 -13
  690. package/redocly.yaml +0 -56
  691. package/specs/README.md +0 -31
  692. package/specs/acdl-specification.yml +0 -531
  693. package/specs/clean-architecture.openapi.yml +0 -1435
  694. package/specs/context7-mcp.openapi.yml +0 -313
  695. package/specs/magic-mcp.openapi.yml +0 -647
  696. package/specs/mcp-infrastructure.openapi.yml +0 -904
  697. package/specs/orchestration.openapi.yml +0 -444
  698. package/specs/ossa-complete.openapi.yml +0 -2250
  699. package/specs/project-discovery.openapi.yml +0 -1293
  700. package/specs/rebuild-audit.openapi.yml +0 -800
  701. package/specs/specification.openapi.yml +0 -498
  702. package/specs/test-api.openapi.yml +0 -20
  703. package/specs/voice-agent-specification.yml +0 -640
  704. package/specs/web-eval-mcp.openapi.yml +0 -426
  705. package/src/adk/adapters/index.ts +0 -310
  706. package/src/adk/agents/custom-agent.ts +0 -206
  707. package/src/adk/agents/index.ts +0 -158
  708. package/src/adk/agents/llm-agent.ts +0 -76
  709. package/src/adk/agents/workflow-agent.ts +0 -191
  710. package/src/adk/index.ts +0 -10
  711. package/src/adk/orchestration/index.ts +0 -352
  712. package/src/adk/state/index.ts +0 -217
  713. package/src/adk/tools/index.ts +0 -291
  714. package/src/api/acdl-specification.yml +0 -531
  715. package/src/api/agent-manifest.schema.json +0 -859
  716. package/src/api/agent-worktree-schema.json +0 -320
  717. package/src/api/clean-architecture.openapi.yml +0 -1435
  718. package/src/api/context7-mcp.openapi.yml +0 -313
  719. package/src/api/magic-mcp.openapi.yml +0 -647
  720. package/src/api/mcp-infrastructure.openapi.yml +0 -904
  721. package/src/api/openapi.redoc.config.json +0 -6
  722. package/src/api/orchestration.openapi.yml +0 -444
  723. package/src/api/ossa-complete.openapi.yml +0 -2250
  724. package/src/api/project-discovery.openapi.yml +0 -1293
  725. package/src/api/rebuild-audit.openapi.yml +0 -800
  726. package/src/api/specification.openapi.yml +0 -498
  727. package/src/api/test-api.openapi.yml +0 -20
  728. package/src/api/voice-agent-specification.yml +0 -640
  729. package/src/api/web-eval-mcp.openapi.yml +0 -426
  730. package/src/api/workflow.schema.json +0 -524
  731. package/src/cli/agent-deployment.ts +0 -452
  732. package/src/cli/commands/ossa.ts +0 -272
  733. package/src/cli/commands/worktree.ts +0 -603
  734. package/src/cli/ossa-cli.ts +0 -1176
  735. package/src/core/index.ts +0 -42
  736. package/src/core/mcp-server-implementation.ts +0 -1409
  737. package/src/core/orchestrator/index.ts +0 -611
  738. package/src/core/orchestrator/ossa-orchestrator.ts +0 -504
  739. package/src/mcp/simple-server.ts +0 -322
  740. package/src/protocols/acap.ts +0 -146
  741. package/src/protocols/index.ts +0 -8
  742. package/src/protocols/rasp.ts +0 -263
  743. package/src/server/app.ts +0 -472
  744. package/src/server/middleware/agentAccess.ts +0 -10
  745. package/src/server/middleware/asyncHandler.ts +0 -10
  746. package/src/server/middleware/auth.ts +0 -10
  747. package/src/server/middleware/errorHandler.ts +0 -9
  748. package/src/server/middleware/logging.ts +0 -10
  749. package/src/server/middleware/metrics.ts +0 -10
  750. package/src/server/middleware/validation.ts +0 -10
  751. package/src/server/routes/agents.ts +0 -632
  752. package/src/server/routes/monitoring.ts +0 -13
  753. package/src/server/routes/orchestration.ts +0 -13
  754. package/src/server/routes/specifications.ts +0 -13
  755. package/src/server/services/AgentService.ts +0 -46
  756. package/src/server/services/ExecutionService.ts +0 -51
  757. package/src/server/services/SpecificationService.ts +0 -22
  758. package/src/server/services/WebhookService.ts +0 -24
  759. package/src/server/simple-app.ts +0 -174
  760. package/src/server/types/agent.ts +0 -612
  761. package/src/server/types/server.ts +0 -465
  762. package/src/services/orchestration/worktree-orchestrator.ts +0 -779
  763. package/src/services/worktree/branching-strategy.ts +0 -76
  764. package/src/services/worktree/git-worktree-manager.ts +0 -86
  765. package/website/.next/BUILD_ID +0 -1
  766. package/website/.next/app-build-manifest.json +0 -151
  767. package/website/.next/app-path-routes-manifest.json +0 -19
  768. package/website/.next/build-manifest.json +0 -33
  769. package/website/.next/cache/.previewinfo +0 -1
  770. package/website/.next/cache/.rscinfo +0 -1
  771. package/website/.next/cache/.tsbuildinfo +0 -1
  772. package/website/.next/cache/fetch-cache/920aec34c288eefa97c5efba3baf95a846a0beb0c48a5064980a2c24b83e941c +0 -1
  773. package/website/.next/cache/fetch-cache/c2ad7a72b43463a0daaa85ca926a8af38defd17ecb64f1fdd2dd4fe2293e8b26 +0 -1
  774. package/website/.next/cache/fetch-cache/d10eb963d5980c8a50ee9ed24472339ee6da054ead33e00676e61e8b8e62cc83 +0 -1
  775. package/website/.next/cache/fetch-cache/f243d84640477f3205b74a85013018acd63b692144675630a74d1af8a3e9eab5 +0 -1
  776. package/website/.next/cache/webpack/client-production/0.pack +0 -0
  777. package/website/.next/cache/webpack/client-production/1.pack +0 -0
  778. package/website/.next/cache/webpack/client-production/10.pack +0 -0
  779. package/website/.next/cache/webpack/client-production/11.pack +0 -0
  780. package/website/.next/cache/webpack/client-production/12.pack +0 -0
  781. package/website/.next/cache/webpack/client-production/13.pack +0 -0
  782. package/website/.next/cache/webpack/client-production/14.pack +0 -0
  783. package/website/.next/cache/webpack/client-production/15.pack +0 -0
  784. package/website/.next/cache/webpack/client-production/16.pack +0 -0
  785. package/website/.next/cache/webpack/client-production/17.pack +0 -0
  786. package/website/.next/cache/webpack/client-production/18.pack +0 -0
  787. package/website/.next/cache/webpack/client-production/2.pack +0 -0
  788. package/website/.next/cache/webpack/client-production/3.pack +0 -0
  789. package/website/.next/cache/webpack/client-production/4.pack +0 -0
  790. package/website/.next/cache/webpack/client-production/5.pack +0 -0
  791. package/website/.next/cache/webpack/client-production/6.pack +0 -0
  792. package/website/.next/cache/webpack/client-production/7.pack +0 -0
  793. package/website/.next/cache/webpack/client-production/8.pack +0 -0
  794. package/website/.next/cache/webpack/client-production/9.pack +0 -0
  795. package/website/.next/cache/webpack/client-production/index.pack +0 -0
  796. package/website/.next/cache/webpack/client-production/index.pack.old +0 -0
  797. package/website/.next/cache/webpack/edge-server-production/0.pack +0 -0
  798. package/website/.next/cache/webpack/edge-server-production/index.pack +0 -0
  799. package/website/.next/cache/webpack/server-production/0.pack +0 -0
  800. package/website/.next/cache/webpack/server-production/1.pack +0 -0
  801. package/website/.next/cache/webpack/server-production/10.pack +0 -0
  802. package/website/.next/cache/webpack/server-production/11.pack +0 -0
  803. package/website/.next/cache/webpack/server-production/12.pack +0 -0
  804. package/website/.next/cache/webpack/server-production/2.pack +0 -0
  805. package/website/.next/cache/webpack/server-production/3.pack +0 -0
  806. package/website/.next/cache/webpack/server-production/4.pack +0 -0
  807. package/website/.next/cache/webpack/server-production/5.pack +0 -0
  808. package/website/.next/cache/webpack/server-production/6.pack +0 -0
  809. package/website/.next/cache/webpack/server-production/7.pack +0 -0
  810. package/website/.next/cache/webpack/server-production/8.pack +0 -0
  811. package/website/.next/cache/webpack/server-production/9.pack +0 -0
  812. package/website/.next/cache/webpack/server-production/index.pack +0 -0
  813. package/website/.next/cache/webpack/server-production/index.pack.old +0 -0
  814. package/website/.next/diagnostics/build-diagnostics.json +0 -6
  815. package/website/.next/diagnostics/framework.json +0 -1
  816. package/website/.next/export-detail.json +0 -5
  817. package/website/.next/export-marker.json +0 -6
  818. package/website/.next/images-manifest.json +0 -57
  819. package/website/.next/next-minimal-server.js.nft.json +0 -1
  820. package/website/.next/next-server.js.nft.json +0 -1
  821. package/website/.next/package.json +0 -1
  822. package/website/.next/prerender-manifest.json +0 -2143
  823. package/website/.next/react-loadable-manifest.json +0 -1898
  824. package/website/.next/required-server-files.json +0 -320
  825. package/website/.next/routes-manifest.json +0 -161
  826. package/website/.next/server/app/_not-found/page.js +0 -2
  827. package/website/.next/server/app/_not-found/page.js.nft.json +0 -1
  828. package/website/.next/server/app/_not-found/page_client-reference-manifest.js +0 -1
  829. package/website/.next/server/app/_not-found.html +0 -1
  830. package/website/.next/server/app/_not-found.meta +0 -8
  831. package/website/.next/server/app/_not-found.rsc +0 -23
  832. package/website/.next/server/app/about/page.js +0 -2
  833. package/website/.next/server/app/about/page.js.nft.json +0 -1
  834. package/website/.next/server/app/about/page_client-reference-manifest.js +0 -1
  835. package/website/.next/server/app/about.html +0 -1
  836. package/website/.next/server/app/about.meta +0 -7
  837. package/website/.next/server/app/about.rsc +0 -40
  838. package/website/.next/server/app/blog/OpenAPI-AI-Agents-Standard.html +0 -217
  839. package/website/.next/server/app/blog/OpenAPI-AI-Agents-Standard.meta +0 -7
  840. package/website/.next/server/app/blog/OpenAPI-AI-Agents-Standard.rsc +0 -308
  841. package/website/.next/server/app/blog/Why-Formal-Standards-Matter-Now.html +0 -180
  842. package/website/.next/server/app/blog/Why-Formal-Standards-Matter-Now.meta +0 -7
  843. package/website/.next/server/app/blog/Why-Formal-Standards-Matter-Now.rsc +0 -232
  844. package/website/.next/server/app/blog/[slug]/page.js +0 -2
  845. package/website/.next/server/app/blog/[slug]/page.js.nft.json +0 -1
  846. package/website/.next/server/app/blog/[slug]/page_client-reference-manifest.js +0 -1
  847. package/website/.next/server/app/blog/introducing-ossa-framework.html +0 -263
  848. package/website/.next/server/app/blog/introducing-ossa-framework.meta +0 -7
  849. package/website/.next/server/app/blog/introducing-ossa-framework.rsc +0 -351
  850. package/website/.next/server/app/blog/ossa-production-results.html +0 -198
  851. package/website/.next/server/app/blog/ossa-production-results.meta +0 -7
  852. package/website/.next/server/app/blog/ossa-production-results.rsc +0 -302
  853. package/website/.next/server/app/blog/page.js +0 -2
  854. package/website/.next/server/app/blog/page.js.nft.json +0 -1
  855. package/website/.next/server/app/blog/page_client-reference-manifest.js +0 -1
  856. package/website/.next/server/app/blog/welcome-to-ossa.html +0 -22
  857. package/website/.next/server/app/blog/welcome-to-ossa.meta +0 -7
  858. package/website/.next/server/app/blog/welcome-to-ossa.rsc +0 -31
  859. package/website/.next/server/app/blog/why-ai-agents-need-open-standard.html +0 -63
  860. package/website/.next/server/app/blog/why-ai-agents-need-open-standard.meta +0 -7
  861. package/website/.next/server/app/blog/why-ai-agents-need-open-standard.rsc +0 -121
  862. package/website/.next/server/app/blog.html +0 -1
  863. package/website/.next/server/app/blog.meta +0 -7
  864. package/website/.next/server/app/blog.rsc +0 -35
  865. package/website/.next/server/app/design-guide/page.js +0 -12
  866. package/website/.next/server/app/design-guide/page.js.nft.json +0 -1
  867. package/website/.next/server/app/design-guide/page_client-reference-manifest.js +0 -1
  868. package/website/.next/server/app/design-guide.html +0 -11
  869. package/website/.next/server/app/design-guide.meta +0 -7
  870. package/website/.next/server/app/design-guide.rsc +0 -41
  871. package/website/.next/server/app/docs.html +0 -1
  872. package/website/.next/server/app/docs.meta +0 -7
  873. package/website/.next/server/app/docs.rsc +0 -42
  874. package/website/.next/server/app/ecosystem/page.js +0 -2
  875. package/website/.next/server/app/ecosystem/page.js.nft.json +0 -1
  876. package/website/.next/server/app/ecosystem/page_client-reference-manifest.js +0 -1
  877. package/website/.next/server/app/ecosystem.html +0 -1
  878. package/website/.next/server/app/ecosystem.meta +0 -7
  879. package/website/.next/server/app/ecosystem.rsc +0 -40
  880. package/website/.next/server/app/examples.html +0 -1
  881. package/website/.next/server/app/examples.meta +0 -7
  882. package/website/.next/server/app/examples.rsc +0 -14559
  883. package/website/.next/server/app/index.html +0 -3
  884. package/website/.next/server/app/index.meta +0 -7
  885. package/website/.next/server/app/index.rsc +0 -40
  886. package/website/.next/server/app/license/page.js +0 -2
  887. package/website/.next/server/app/license/page.js.nft.json +0 -1
  888. package/website/.next/server/app/license/page_client-reference-manifest.js +0 -1
  889. package/website/.next/server/app/license.html +0 -191
  890. package/website/.next/server/app/license.meta +0 -7
  891. package/website/.next/server/app/license.rsc +0 -222
  892. package/website/.next/server/app/page.js +0 -4
  893. package/website/.next/server/app/page.js.nft.json +0 -1
  894. package/website/.next/server/app/page_client-reference-manifest.js +0 -1
  895. package/website/.next/server/app/playground/page.js +0 -111
  896. package/website/.next/server/app/playground/page.js.nft.json +0 -1
  897. package/website/.next/server/app/playground/page_client-reference-manifest.js +0 -1
  898. package/website/.next/server/app/playground.html +0 -1
  899. package/website/.next/server/app/playground.meta +0 -7
  900. package/website/.next/server/app/playground.rsc +0 -30
  901. package/website/.next/server/app/robots.txt/route.js +0 -1
  902. package/website/.next/server/app/robots.txt/route.js.nft.json +0 -1
  903. package/website/.next/server/app/robots.txt/route_client-reference-manifest.js +0 -1
  904. package/website/.next/server/app/robots.txt.body +0 -6
  905. package/website/.next/server/app/robots.txt.meta +0 -1
  906. package/website/.next/server/app/rss.xml/route.js +0 -18
  907. package/website/.next/server/app/rss.xml/route.js.nft.json +0 -1
  908. package/website/.next/server/app/rss.xml/route_client-reference-manifest.js +0 -1
  909. package/website/.next/server/app/rss.xml.body +0 -11
  910. package/website/.next/server/app/rss.xml.meta +0 -1
  911. package/website/.next/server/app/schema/page.js +0 -76
  912. package/website/.next/server/app/schema/page.js.nft.json +0 -1
  913. package/website/.next/server/app/schema/page_client-reference-manifest.js +0 -1
  914. package/website/.next/server/app/schema.html +0 -1
  915. package/website/.next/server/app/schema.meta +0 -7
  916. package/website/.next/server/app/schema.rsc +0 -26
  917. package/website/.next/server/app/sitemap.xml/route.js +0 -1
  918. package/website/.next/server/app/sitemap.xml/route.js.nft.json +0 -1
  919. package/website/.next/server/app/sitemap.xml/route_client-reference-manifest.js +0 -1
  920. package/website/.next/server/app/sitemap.xml.body +0 -39
  921. package/website/.next/server/app/sitemap.xml.meta +0 -1
  922. package/website/.next/server/app/specification/page.js +0 -10
  923. package/website/.next/server/app/specification/page.js.nft.json +0 -1
  924. package/website/.next/server/app/specification/page_client-reference-manifest.js +0 -1
  925. package/website/.next/server/app/specification.html +0 -9
  926. package/website/.next/server/app/specification.meta +0 -7
  927. package/website/.next/server/app/specification.rsc +0 -32
  928. package/website/.next/server/app-paths-manifest.json +0 -19
  929. package/website/.next/server/chunks/18.js +0 -1
  930. package/website/.next/server/chunks/227.js +0 -9
  931. package/website/.next/server/chunks/339.js +0 -25
  932. package/website/.next/server/chunks/49.js +0 -1
  933. package/website/.next/server/chunks/51.js +0 -1
  934. package/website/.next/server/chunks/57.js +0 -1
  935. package/website/.next/server/chunks/579.js +0 -16
  936. package/website/.next/server/chunks/611.js +0 -6
  937. package/website/.next/server/chunks/873.js +0 -22
  938. package/website/.next/server/chunks/900.js +0 -1
  939. package/website/.next/server/chunks/97.js +0 -1
  940. package/website/.next/server/functions-config-manifest.json +0 -4
  941. package/website/.next/server/interception-route-rewrite-manifest.js +0 -1
  942. package/website/.next/server/middleware-build-manifest.js +0 -1
  943. package/website/.next/server/middleware-manifest.json +0 -6
  944. package/website/.next/server/middleware-react-loadable-manifest.js +0 -1
  945. package/website/.next/server/next-font-manifest.js +0 -1
  946. package/website/.next/server/next-font-manifest.json +0 -1
  947. package/website/.next/server/pages/404.html +0 -1
  948. package/website/.next/server/pages/500.html +0 -1
  949. package/website/.next/server/pages/_app.js +0 -1
  950. package/website/.next/server/pages/_app.js.nft.json +0 -1
  951. package/website/.next/server/pages/_document.js +0 -1
  952. package/website/.next/server/pages/_document.js.nft.json +0 -1
  953. package/website/.next/server/pages/_error.js +0 -19
  954. package/website/.next/server/pages/_error.js.nft.json +0 -1
  955. package/website/.next/server/pages-manifest.json +0 -6
  956. package/website/.next/server/server-reference-manifest.js +0 -1
  957. package/website/.next/server/server-reference-manifest.json +0 -1
  958. package/website/.next/server/webpack-runtime.js +0 -1
  959. package/website/.next/static/IDhDQiozPwOaA3PpMqvTE/_buildManifest.js +0 -1
  960. package/website/.next/static/IDhDQiozPwOaA3PpMqvTE/_ssgManifest.js +0 -1
  961. package/website/.next/static/chunks/119.05f66060d7798fc9.js +0 -25
  962. package/website/.next/static/chunks/255-bf407b21685f2318.js +0 -1
  963. package/website/.next/static/chunks/451-235273497e501ae9.js +0 -1
  964. package/website/.next/static/chunks/4bd1b696-409494caf8c83275.js +0 -1
  965. package/website/.next/static/chunks/619-f072ac750404f9da.js +0 -1
  966. package/website/.next/static/chunks/651-5cd3c87d43b7eb46.js +0 -1
  967. package/website/.next/static/chunks/778.278ac2aadb2a1105.js +0 -1
  968. package/website/.next/static/chunks/890-ab915e0570e1961b.js +0 -1
  969. package/website/.next/static/chunks/app/_not-found/page-ccdaf9d90b537c5d.js +0 -1
  970. package/website/.next/static/chunks/app/about/page-bd4cb2219b41f933.js +0 -1
  971. package/website/.next/static/chunks/app/blog/[slug]/page-8fd43000c4969233.js +0 -1
  972. package/website/.next/static/chunks/app/blog/page-bd4cb2219b41f933.js +0 -1
  973. package/website/.next/static/chunks/app/design-guide/page-bd4cb2219b41f933.js +0 -1
  974. package/website/.next/static/chunks/app/ecosystem/page-bd4cb2219b41f933.js +0 -1
  975. package/website/.next/static/chunks/app/layout-ccacbd90656baa78.js +0 -1
  976. package/website/.next/static/chunks/app/license/page-bd4cb2219b41f933.js +0 -1
  977. package/website/.next/static/chunks/app/page-31241dc7465f9590.js +0 -1
  978. package/website/.next/static/chunks/app/playground/page-c2af00885374900f.js +0 -1
  979. package/website/.next/static/chunks/app/robots.txt/route-032c05054032342f.js +0 -1
  980. package/website/.next/static/chunks/app/rss.xml/route-032c05054032342f.js +0 -1
  981. package/website/.next/static/chunks/app/schema/page-f7c224b281771083.js +0 -1
  982. package/website/.next/static/chunks/app/sitemap.xml/route-032c05054032342f.js +0 -1
  983. package/website/.next/static/chunks/app/specification/page-bd4cb2219b41f933.js +0 -1
  984. package/website/.next/static/chunks/framework-1ce91eb6f9ecda85.js +0 -1
  985. package/website/.next/static/chunks/main-3099e141650ec47a.js +0 -1
  986. package/website/.next/static/chunks/main-app-a2fc6ac9305e3090.js +0 -1
  987. package/website/.next/static/chunks/pages/_app-5addca2b3b969fde.js +0 -1
  988. package/website/.next/static/chunks/pages/_error-022e4ac7bbb9914f.js +0 -1
  989. package/website/.next/static/chunks/polyfills-42372ed130431b0a.js +0 -1
  990. package/website/.next/static/chunks/webpack-6ecb09e5c6e34cb4.js +0 -1
  991. package/website/.next/static/css/23135390005d4468.css +0 -3
  992. package/website/.next/static/media/19cfc7226ec3afaa-s.woff2 +0 -0
  993. package/website/.next/static/media/21350d82a1f187e9-s.woff2 +0 -0
  994. package/website/.next/static/media/8e9860b6e62d6359-s.woff2 +0 -0
  995. package/website/.next/static/media/ba9851c3c22cd980-s.woff2 +0 -0
  996. package/website/.next/static/media/c5fe6dc8356a8c31-s.woff2 +0 -0
  997. package/website/.next/static/media/df0a9ae256c0569c-s.woff2 +0 -0
  998. package/website/.next/static/media/e4af272ccee01ff0-s.p.woff2 +0 -0
  999. package/website/.next/trace +0 -3
  1000. package/website/.next/types/app/about/page.ts +0 -84
  1001. package/website/.next/types/app/blog/[slug]/page.ts +0 -84
  1002. package/website/.next/types/app/blog/page.ts +0 -84
  1003. package/website/.next/types/app/design-guide/page.ts +0 -84
  1004. package/website/.next/types/app/ecosystem/page.ts +0 -84
  1005. package/website/.next/types/app/license/page.ts +0 -84
  1006. package/website/.next/types/app/page.ts +0 -84
  1007. package/website/.next/types/app/playground/page.ts +0 -84
  1008. package/website/.next/types/app/rss.xml/route.ts +0 -347
  1009. package/website/.next/types/app/schema/page.ts +0 -84
  1010. package/website/.next/types/app/specification/page.ts +0 -84
  1011. package/website/.next/types/cache-life.d.ts +0 -141
  1012. package/website/.next/types/package.json +0 -1
  1013. package/website/.next/types/routes.d.ts +0 -85
  1014. package/website/.next/types/validator.ts +0 -187
  1015. package/website/.wiki-export/Agent-Folder-Structure.md +0 -215
  1016. package/website/.wiki-export/CI-STATUS.md +0 -66
  1017. package/website/.wiki-export/COMPLETE-IMPLEMENTATION-CHECKLIST.md +0 -74
  1018. package/website/.wiki-export/DRUPAL-MODULE-INTEGRATION.md +0 -103
  1019. package/website/.wiki-export/FINAL-STATUS.md +0 -63
  1020. package/website/.wiki-export/Getting-Started.md +0 -87
  1021. package/website/.wiki-export/INSTRUCTIONS.md +0 -46
  1022. package/website/.wiki-export/INTEGRATION-ANALYSIS.md +0 -216
  1023. package/website/.wiki-export/MANIFEST.json +0 -62
  1024. package/website/.wiki-export/OSSA-COMPLIANT-BADGE.md +0 -247
  1025. package/website/.wiki-export/Openapi-Extensions.md +0 -930
  1026. package/website/.wiki-export/README.md +0 -31
  1027. package/website/.wiki-export/RELEASE-READINESS.md +0 -95
  1028. package/website/.wiki-export/VERSIONING.md +0 -284
  1029. package/website/next-env.d.ts +0 -6
  1030. package/website/out/app-build-manifest.json +0 -3
  1031. package/website/out/build-manifest.json +0 -17
  1032. package/website/out/cache/.rscinfo +0 -1
  1033. package/website/out/cache/next-devtools-config.json +0 -1
  1034. package/website/out/cache/webpack/client-development/0.pack.gz +0 -0
  1035. package/website/out/cache/webpack/client-development/1.pack.gz +0 -0
  1036. package/website/out/cache/webpack/client-development/2.pack.gz +0 -0
  1037. package/website/out/cache/webpack/client-development/3.pack.gz +0 -0
  1038. package/website/out/cache/webpack/client-development/index.pack.gz +0 -0
  1039. package/website/out/cache/webpack/client-development/index.pack.gz.old +0 -0
  1040. package/website/out/cache/webpack/client-development-fallback/0.pack.gz +0 -0
  1041. package/website/out/cache/webpack/client-development-fallback/index.pack.gz +0 -0
  1042. package/website/out/cache/webpack/server-development/0.pack.gz +0 -0
  1043. package/website/out/cache/webpack/server-development/1.pack.gz +0 -0
  1044. package/website/out/cache/webpack/server-development/2.pack.gz +0 -0
  1045. package/website/out/cache/webpack/server-development/3.pack.gz +0 -0
  1046. package/website/out/cache/webpack/server-development/index.pack.gz +0 -0
  1047. package/website/out/cache/webpack/server-development/index.pack.gz.old +0 -0
  1048. package/website/out/package.json +0 -1
  1049. package/website/out/prerender-manifest.json +0 -11
  1050. package/website/out/react-loadable-manifest.json +0 -1
  1051. package/website/out/routes-manifest.json +0 -1
  1052. package/website/out/server/app-paths-manifest.json +0 -1
  1053. package/website/out/server/interception-route-rewrite-manifest.js +0 -1
  1054. package/website/out/server/middleware-build-manifest.js +0 -19
  1055. package/website/out/server/middleware-manifest.json +0 -6
  1056. package/website/out/server/middleware-react-loadable-manifest.js +0 -1
  1057. package/website/out/server/next-font-manifest.js +0 -1
  1058. package/website/out/server/next-font-manifest.json +0 -1
  1059. package/website/out/server/pages-manifest.json +0 -1
  1060. package/website/out/server/server-reference-manifest.js +0 -1
  1061. package/website/out/server/server-reference-manifest.json +0 -5
  1062. package/website/out/static/chunks/polyfills.js +0 -1
  1063. package/website/out/static/development/_buildManifest.js +0 -1
  1064. package/website/out/static/development/_ssgManifest.js +0 -1
  1065. package/website/out/trace +0 -2
  1066. package/website/out/types/cache-life.d.ts +0 -141
  1067. package/website/out/types/package.json +0 -1
  1068. package/website/out/types/routes.d.ts +0 -85
  1069. package/website/out/types/validator.ts +0 -187
  1070. package/website/public/examples.json +0 -476
  1071. package/website/public/schemas/openapi-extensions.schema.json +0 -486
  1072. package/website/tsconfig.tsbuildinfo +0 -1
  1073. /package/dist/spec/{v0.2.4-dev → v0.2.4}/ossa-0.2.4-dev.yaml +0 -0
  1074. /package/spec/v0.2.4/{ossa-0.2.4.yaml → ossa-0.2.4-dev.yaml} +0 -0
@@ -0,0 +1,934 @@
1
+ ---
2
+ title: "OpenAPI Extensions"
3
+ ---
4
+
5
+ # OSSA OpenAPI/Swagger Specification Extensions
6
+
7
+ ## Overview
8
+
9
+ OSSA (Open Standard for Scalable AI Agents) extends OpenAPI 3.1 specifications with AI agent-specific metadata, capabilities, and configuration. These extensions enable OpenAPI specs to describe not just REST APIs, but the full agent behavior including autonomy levels, LLM configuration, tool usage, and compliance requirements.
10
+
11
+ **Key Benefits:**
12
+ - **Agent Discovery**: OpenAPI specs become agent manifests that describe capabilities
13
+ - **Type Safety**: Full TypeScript types and JSON Schema validation
14
+ - **Tool Integration**: Declare MCP servers and tools directly in API specs
15
+ - **Compliance**: Built-in support for governance, security, and observability
16
+ - **Framework Agnostic**: Works with any agent runtime (LangChain, CrewAI, kAgent, etc.)
17
+
18
+ ## Table of Contents
19
+
20
+ 1. [Root-Level Extensions](#root-level-extensions)
21
+ - [x-ossa-metadata](#x-ossa-metadata)
22
+ - [x-ossa](#x-ossa)
23
+ - [x-agent](#x-agent)
24
+ 2. [Operation-Level Extensions](#operation-level-extensions)
25
+ - [x-ossa-capability](#x-ossa-capability)
26
+ - [x-ossa-autonomy](#x-ossa-autonomy)
27
+ - [x-ossa-constraints](#x-ossa-constraints)
28
+ - [x-ossa-tools](#x-ossa-tools)
29
+ - [x-ossa-llm](#x-ossa-llm)
30
+ 3. [Parameter Extensions](#parameter-extensions)
31
+ - [x-ossa-agent-id](#x-ossa-agent-id)
32
+ - [x-ossa-version](#x-ossa-version)
33
+ 4. [Schema Extensions](#schema-extensions)
34
+ - [x-ossa-capability-schema](#x-ossa-capability-schema)
35
+ 5. [Complete Examples](#complete-examples)
36
+ 6. [Integration with OSSA Manifests](#integration-with-ossa-manifests)
37
+
38
+ ---
39
+
40
+ ## Root-Level Extensions
41
+
42
+ Extensions that can be added at the root level of an OpenAPI 3.1 specification.
43
+
44
+ ### x-ossa-metadata
45
+
46
+ Embeds comprehensive OSSA agent metadata in OpenAPI spec root. Provides governance, compliance, security, and observability metadata.
47
+
48
+ **Location**: Root level of OpenAPI spec
49
+
50
+ **Schema**:
51
+
52
+ ```yaml
53
+ x-ossa-metadata:
54
+ version: string # OSSA specification version (e.g., "0.2.x", "1.0.0")
55
+ compliance:
56
+ level: string # "basic" | "standard" | "advanced" | "enterprise"
57
+ frameworks: string[] # List of compliance frameworks
58
+ governance:
59
+ approved: boolean # Whether specification has been approved
60
+ approvedBy: string # Entity that approved (optional)
61
+ approvalDate: string # Date of approval in YYYY-MM-DD format (optional)
62
+ security:
63
+ classification: string # "public" | "internal" | "confidential" | "restricted"
64
+ authentication: string # "required" | "optional" | "none"
65
+ encryption: string # Encryption requirements (e.g., "tls1.3")
66
+ observability:
67
+ tracing: boolean # Enable distributed tracing
68
+ metrics: boolean # Enable metrics collection
69
+ logging: boolean # Enable structured logging
70
+ ```
71
+
72
+ **OpenAPI Example**:
73
+
74
+ ```yaml
75
+ openapi: 3.1.0
76
+ info:
77
+ title: Kubernetes Troubleshooter Agent API
78
+ version: 1.0.0
79
+
80
+ x-ossa-metadata:
81
+ version: 0.2.x
82
+ compliance:
83
+ level: enterprise
84
+ frameworks:
85
+ - OSSA
86
+ - OpenAPI 3.1
87
+ - RFC7807
88
+ governance:
89
+ approved: true
90
+ approvedBy: Platform Team
91
+ approvalDate: 2024-01-15
92
+ security:
93
+ classification: internal
94
+ authentication: required
95
+ encryption: tls1.3
96
+ observability:
97
+ tracing: true
98
+ metrics: true
99
+ logging: true
100
+
101
+ paths:
102
+ # ... paths ...
103
+ ```
104
+
105
+ **JSON Example**:
106
+
107
+ ```json
108
+ {
109
+ "openapi": "3.1.0",
110
+ "info": {
111
+ "title": "Kubernetes Troubleshooter Agent API",
112
+ "version": "1.0.0"
113
+ },
114
+ "x-ossa-metadata": {
115
+ "version": "0.2.2",
116
+ "compliance": {
117
+ "level": "enterprise",
118
+ "frameworks": ["OSSA", "OpenAPI 3.1", "RFC7807"]
119
+ },
120
+ "governance": {
121
+ "approved": true,
122
+ "approvedBy": "Platform Team",
123
+ "approvalDate": "2024-01-15"
124
+ },
125
+ "security": {
126
+ "classification": "internal",
127
+ "authentication": "required",
128
+ "encryption": "tls1.3"
129
+ },
130
+ "observability": {
131
+ "tracing": true,
132
+ "metrics": true,
133
+ "logging": true
134
+ }
135
+ }
136
+ }
137
+ ```
138
+
139
+ ---
140
+
141
+ ### x-ossa
142
+
143
+ Core OSSA compliance information with agent identification and validation metadata.
144
+
145
+ **Location**: Root level or `info` section of OpenAPI spec
146
+
147
+ **Schema**:
148
+
149
+ ```yaml
150
+ x-ossa:
151
+ version: string # OSSA specification version
152
+ agent:
153
+ id: string # Unique agent identifier (DNS-不为subdomain format)
154
+ type: string # Agent type (see enum below)
155
+ compliance:
156
+ standards: string[] # Architectural standards
157
+ validated: boolean # Whether agent has been validated
158
+ validatedAt: string # ISO 8601 timestamp of validation
159
+ ```
160
+
161
+ **Agent Types**:
162
+ - `orchestrator` - Coordinates multiple agents and workflows
163
+ - `worker` - Performs specific tasks and operations
164
+ - `specialist` - Specialized domain expertise
165
+ - `critic` - Reviews and validates agent outputs
166
+ - `judge` - Makes decisions and evaluates outcomes
167
+ - `monitor` - Observes and reports on system state
168
+ - `gateway` - Entry point for agent communication
169
+ - `governor` - Enforces policies and compliance
170
+ - `integrator` - Connects systems and protocols
171
+ - `voice` - Handles audio/speech interactions
172
+
173
+ **OpenAPI Example**:
174
+
175
+ ```yaml
176
+ openapi: 3.1.0
177
+ info:
178
+ title: My Agent API
179
+ version: 1.0.0
180
+
181
+ x-ossa:
182
+ version: 0.2.x
183
+ agent:
184
+ id: k8s-troubleshooter
185
+ type: worker
186
+ compliance:
187
+ standards:
188
+ - openapi-first
189
+ - dry
190
+ - crud
191
+ - solid
192
+ - type-safe
193
+ validated: true
194
+ validatedAt: "2024-01-15T10:30:00Z"
195
+
196
+ paths:
197
+ # ... paths ...
198
+ ```
199
+
200
+ ---
201
+
202
+ ### x-agent
203
+
204
+ Agent-specific capabilities, tools, environment, and rules configuration.
205
+
206
+ **Location**: Root level or `info` section of OpenAPI spec
207
+
208
+ **Schema**:
209
+
210
+ ```yaml
211
+ x-agent:
212
+ capabilities: string[] # List of agent capability names
213
+ tools: string[] # List of tools/MCP servers available
214
+ environment: object # Environment-specific configuration (key-value pairs)
215
+ rules: string[] # List of rules or policies the agent follows
216
+ ```
217
+
218
+ **OpenAPI Example**:
219
+
220
+ ```yaml
221
+ openapi: 3.1.0
222
+ info:
223
+ title: Data Processing Agent API
224
+ version: 1.0.0
225
+
226
+ x-agent:
227
+ capabilities:
228
+ - data-transformation
229
+ - csv-parsing
230
+ - json-validation
231
+ tools:
232
+ - postgres-mcp
233
+ - redis-mcp
234
+ - file-system-mcp
235
+ environment:
236
+ processingTimeout: 300
237
+ maxFileSize: "100MB"
238
+ enableCaching: true
239
+ rules:
240
+ - no-external-api-calls
241
+ - validate-all-inputs
242
+ - encrypt-sensitive-data
243
+
244
+ paths:
245
+ # ... paths ...
246
+ ```
247
+
248
+ ---
249
+
250
+ ## Operation-Level Extensions
251
+
252
+ Extensions that can be added to individual OpenAPI operations (GET, POST, PUT, DELETE, etc.).
253
+
254
+ ### x-ossa-capability
255
+
256
+ Links an OpenAPI operation to an OSSA agent capability. Can be a simple string reference or a detailed capability object.
257
+
258
+ **Location**: Operation object within path item
259
+
260
+ **Schema**:
261
+
262
+ ```yaml
263
+ # Simple string reference
264
+ x-ossa-capability: "capability-name"
265
+
266
+ # Or detailed object
267
+ x-ossa-capability:
268
+ name: string # Capability name
269
+ description: string # Capability description (optional)
270
+ inputSchema: object # JSON Schema for capability input (optional)
271
+ outputSchema: object # JSON Schema for capability output (optional)
272
+ ```
273
+
274
+ **OpenAPI Example**:
275
+
276
+ ```yaml
277
+ paths:
278
+ /api/v1/process-data:
279
+ post:
280
+ summary: Process incoming data
281
+ operationId: processData
282
+ x-ossa-capability:
283
+ name: data-transformation
284
+ description: Transforms CSV data to JSON format
285
+ inputSchema:
286
+ type: object
287
+ required: [csvData]
288
+ properties:
289
+ csvData:
290
+ type: string
291
+ description: CSV content to transform
292
+ outputSchema:
293
+ type: object
294
+ properties:
295
+ jsonData:
296
+ type: array
297
+ items:
298
+ type: object
299
+ requestBody:
300
+ # ... request body ...
301
+ responses:
302
+ # ... responses ...
303
+ ```
304
+
305
+ **Note**: The `inputSchema` and `outputSchema` should match the OpenAPI `requestBody` and `responses` schemas respectively, providing additional capability-level metadata.
306
+
307
+ ---
308
+
309
+ ### x-ossa-autonomy
310
+
311
+ Defines autonomy level and approval requirements for operation execution.
312
+
313
+ **Location**: Operation object within path item
314
+
315
+ **Schema**:
316
+
317
+ ```yaml
318
+ x-ossa-autonomy:
319
+ level: string # "supervised" | "autonomous" | "semi-autonomous"
320
+ approval_required: boolean # Whether human approval is required
321
+ allowed_actions: string[] # List of allowed actions (optional)
322
+ blocked_actions: string[] # List of blocked actions (optional)
323
+ ```
324
+
325
+ **Autonomy Levels**:
326
+
327
+ | Level | Description |
328
+ |-------|-------------|
329
+ | `supervised` | Requires human approval before execution |
330
+ | `semi-autonomous` | Can execute with automatic approval under certain conditions |
331
+ | `autonomous` | Can execute without human intervention |
332
+
333
+ **OpenAPI Example**:
334
+
335
+ ```yaml
336
+ paths:
337
+ /api/v1/delete-resource:
338
+ delete:
339
+ summary: Delete a resource
340
+ operationId: deleteResource
341
+ x-ossa-autonomy:
342
+ level: supervised
343
+ approval_required: true
344
+ allowed_actions:
345
+ - read_resource
346
+ - validate_deletion
347
+ blocked_actions:
348
+ - permanent_delete
349
+ - cascade_delete
350
+ parameters:
351
+ # ... parameters ...
352
+ responses:
353
+ # ... responses ...
354
+ ```
355
+
356
+ ---
357
+
358
+ ### x-ossa-constraints
359
+
360
+ Defines cost, token, performance, and time constraints for operation execution.
361
+
362
+ **Location**: Operation object within path item
363
+
364
+ **Schema**:
365
+
366
+ ```yaml
367
+ x-ossa-constraints:
368
+ cost:
369
+ maxTokensPerDay: integer # Maximum tokens allowed per day
370
+ maxTokensPerRequest: integer # Maximum tokens allowed per request
371
+ maxCostPerDay: number # Maximum cost in USD per day
372
+ currency: string # Currency code (default: "USD")
373
+ performance:
374
+ maxLatencySeconds: number # Maximum acceptable latency in seconds
375
+ maxConcurrentRequests: integer # Maximum concurrent requests
376
+ time:
377
+ maxExecutionTime: integer # Maximum execution time in seconds
378
+ ```
379
+
380
+ **OpenAPI Example**:
381
+
382
+ ```yaml
383
+ paths:
384
+ /api/v1/generate-report:
385
+ post:
386
+ summary: Generate comprehensive report
387
+ operationId: generateReport
388
+ x-ossa-constraints:
389
+ cost:
390
+ maxTokensPerDay: 50000
391
+ maxTokensPerRequest: 4000
392
+ maxCostPerDay: 10.0
393
+ currency: USD
394
+ performance:
395
+ maxLatencySeconds: 30
396
+ maxConcurrentRequests: 5
397
+ time:
398
+ maxExecutionTime: 300
399
+ requestBody:
400
+ # ... request body ...
401
+ responses:
402
+ # ... responses ...
403
+ ```
404
+
405
+ ---
406
+
407
+ ### x-ossa-tools
408
+
409
+ Specifies MCP servers or tools required for operation execution.
410
+
411
+ **Location**: Operation object within path item
412
+
413
+ **Schema**:
414
+
415
+ ```yaml
416
+ x-ossa-tools:
417
+ - type: string # "mcp" | "http" | "custom"
418
+ server: string # Tool server identifier or URL
419
+ namespace: string # Namespace for the tool (optional, for MCP servers)
420
+ capabilities: string[] # List of tool capabilities (optional)
421
+ ```
422
+
423
+ **OpenAPI Example**:
424
+
425
+ ```yaml
426
+ paths:
427
+ /api/v1/diagnose-issue:
428
+ post:
429
+ summary: Diagnose Kubernetes issue
430
+ operationId: diagnoseIssue
431
+ x-ossa-tools:
432
+ - type: mcp
433
+ server: kubernetes-mcp
434
+ namespace: default
435
+ capabilities:
436
+ - get_pods
437
+ - get_logs
438
+ - get_events
439
+ - describe_resource
440
+ - type: mcp
441
+ server: buildkit-agent-protocol
442
+ namespace: default
443
+ capabilities:
444
+ - search_documentation
445
+ - analyze_logs
446
+ requestBody:
447
+ # ... request body ...
448
+ responses:
449
+ # ... responses ...
450
+ ```
451
+
452
+ ---
453
+
454
+ ### x-ossa-llm
455
+
456
+ Overrides LLM configuration for a specific operation. Useful when different operations require different models or settings.
457
+
458
+ **Location**: Operation object within path item
459
+
460
+ **Schema**:
461
+
462
+ ```yaml
463
+ x-ossa-llm:
464
+ provider: string # "openai" | "anthropic" | "google" | "azure" | "custom"
465
+ model: string # Model identifier (e.g., "gpt-4", "claude-3-opus")
466
+ temperature: number # Sampling temperature (0-2, optional)
467
+ maxTokens: integer # Maximum tokens in response (optional)
468
+ ```
469
+
470
+ **OpenAPI Example**:
471
+
472
+ ```yaml
473
+ paths:
474
+ /api/v1/analyze-code:
475
+ post:
476
+ summary: Analyze code for issues
477
+ operationId: analyzeCode
478
+ x-ossa-llm:
479
+ provider: openai
480
+ model: gpt-4
481
+ temperature: 0.2
482
+ maxTokens: 4000
483
+ requestBody:
484
+ # ... request body ...
485
+ responses:
486
+ # ... responses ...
487
+ ```
488
+
489
+ **Note**: If `x-ossa-llm` is not specified at the operation level, the agent should use the default LLM configuration from the OSSA manifest or root-level configuration.
490
+
491
+ ---
492
+
493
+ ## Parameter Extensions
494
+
495
+ Extensions for OpenAPI parameters (headers, query params, path params, cookies).
496
+
497
+ ### x-ossa-agent-id
498
+
499
+ Standard header parameter for agent identification in agent-to-agent communication.
500
+
501
+ **Location**: Parameter definition in `components.parameters` or operation-level `parameters`
502
+
503
+ **OpenAPI Example**:
504
+
505
+ ```yaml
506
+ components:
507
+ parameters:
508
+ X-Ossa-Agent-Id:
509
+ name: X-OSSA-Agent-ID
510
+ in: header
511
+ description: Unique identifier of the agent making the request
512
+ required: false
513
+ schema:
514
+ type: string
515
+ pattern: "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$"
516
+ example: "k8s-troubleshooter"
517
+
518
+ paths:
519
+ /api/v1/capabilities:
520
+ get:
521
+ summary: Get agent capabilities
522
+ parameters:
523
+ - $ref: '#/components/parameters/X-Ossa-Agent-Id'
524
+ mathbb
525
+ ```
526
+
527
+ ---
528
+
529
+ ### x-ossa-version
530
+
531
+ Standard header parameter for OSSA specification version in requests.
532
+
533
+ **Location**: Parameter definition in `components.parameters` or operation-level `parameters`
534
+
535
+ **OpenAPI Example**:
536
+
537
+ ```yaml
538
+ components:
539
+ parameters:
540
+ X-Ossa-Version:
541
+ name: X-OSSA-Version
542
+ in: header
543
+ description: OSSA specification version the agent supports
544
+ required: false
545
+ schema:
546
+ type: string
547
+ pattern: "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9]+)?$"
548
+ example: "0.2.2"
549
+
550
+ paths:
551
+ /api/v1/execute:
552
+ post:
553
+ summary: Execute agent capability
554
+ parameters:
555
+ - $ref: '#/components/parameters/X-Ossa-Version'
556
+ ```
557
+
558
+ ---
559
+
560
+ ## Schema Extensions
561
+
562
+ Extensions for OpenAPI schema definitions.
563
+
564
+ ### x-ossa-capability-schema
565
+
566
+ Extends schema definition with capability metadata, linking OpenAPI schemas to OSSA capabilities.
567
+
568
+ **Location**: Schema definition in `components.schemas`
569
+
570
+ **Schema**:
571
+
572
+ ```yaml
573
+ x-ossa-capability-schema:
574
+ capabilityName: string # Name of the capability this schema represents
575
+ input: boolean # Whether this is an input schema (default: false)
576
+ output: boolean # Whether this is an output schema (default: false)
577
+ validation:
578
+ required: boolean # Whether validation is required (optional)
579
+ strict: boolean # Whether to use strict validation (optional)
580
+ ```
581
+
582
+ **OpenAPI Example**:
583
+
584
+ ```yaml
585
+ components:
586
+ schemas:
587
+ DataProcessingInput:
588
+ type: object
589
+ required: [csvData]
590
+ properties:
591
+ csvData:
592
+ type: string
593
+ description: CSV content to process
594
+ x-ossa-capability-schema:
595
+ capabilityName: data-transformation
596
+ input: true
597
+ validation:
598
+ required: true
599
+ strict: true
600
+
601
+ DataProcessingOutput:
602
+ type: object
603
+ properties:
604
+ jsonData:
605
+ type: array
606
+ items:
607
+ type: object
608
+ x-ossa-capability-schema:
609
+ capabilityName: data-transformation
610
+ output: true
611
+ ```
612
+
613
+ ---
614
+
615
+ ## Complete Examples
616
+
617
+ ### Minimal Agent API
618
+
619
+ A minimal example showing basic OSSA extensions:
620
+
621
+ ```yaml
622
+ openapi: 3.1.0
623
+ info:
624
+ title: Hello World Agent
625
+ version: 1.0.0
626
+ description: Minimal OSSA-compliant agent API
627
+
628
+ x-ossa-metadata:
629
+ version: 0.2.x
630
+ compliance:
631
+ level: basic
632
+ frameworks: [OSSA, OpenAPI 3.1]
633
+
634
+ x-ossa:
635
+ version: 0.2.x
636
+ agent:
637
+ id: hello-world-agent
638
+ type: worker
639
+ compliance:
640
+ standards: [openapi-first]
641
+ validated: true
642
+ validatedAt: "2024-01-15T10:00:00Z"
643
+
644
+ paths:
645
+ /greet:
646
+ post:
647
+ summary: Generate greeting
648
+ operationId: greet
649
+ x-ossa-capability: greeting
650
+ x-ossa-autonomy:
651
+ level: autonomous
652
+ approval_required: false
653
+ x-ossa-llm:
654
+ provider: openai
655
+ model: gpt-3.5-turbo
656
+ temperature: 0.7
657
+ requestBody:
658
+ required: true
659
+ content:
660
+ application/json:
661
+ schema:
662
+ type: object
663
+ required: [name]
664
+ properties:
665
+ name:
666
+ type: string
667
+ responses:
668
+ '200':
669
+ description: Greeting generated
670
+ content:
671
+ application/json:
672
+ schema:
673
+ type: object
674
+ properties:
675
+ message:
676
+ type: string
677
+ ```
678
+
679
+ ### Full Worker Agent API
680
+
681
+ A complete example showing all extensions:
682
+
683
+ ```yaml
684
+ openapi: 3.1.0
685
+ info:
686
+ title: Kubernetes Troubleshooter Agent API
687
+ version: 1.0.0
688
+ description: |
689
+ Kubernetes cluster troubleshooting agent with diagnostic capabilities.
690
+ Supports pod inspection, log analysis, and event correlation.
691
+
692
+ x-ossa-metadata:
693
+ version: 0.2.x
694
+ compliance:
695
+ level: enterprise
696
+ frameworks:
697
+ - OSSA
698
+ - OpenAPI 3.1
699
+ - RFC7807
700
+ governance:
701
+ approved: true
702
+ approvedBy: Platform Team
703
+ approvalDate: 2024-01-15
704
+ security:
705
+ classification: internal
706
+ authentication: required
707
+ encryption: tls1.3
708
+ observability:
709
+ tracing: true
710
+ metrics: true
711
+ logging: true
712
+
713
+ x-ossa:
714
+ version: 0.2.x
715
+ agent:
716
+ id: k8s-troubleshooter
717
+ type: worker
718
+ compliance:
719
+ standards:
720
+ - openapi-first
721
+ - dry
722
+ - crud
723
+ - solid
724
+ - type-safe
725
+ validated: true
726
+ validatedAt: "2024-01-15T10:30:00Z"
727
+
728
+ x-agent:
729
+ capabilities:
730
+ - pod-diagnostics
731
+ - log-analysis
732
+ - event-correlation
733
+ tools:
734
+ - kubernetes-mcp
735
+ - buildkit-agent-protocol
736
+ environment:
737
+ defaultNamespace: default
738
+ logRetention: 7d
739
+ rules:
740
+ - read-only-operations
741
+ - require-approval-for-writes
742
+
743
+ components:
744
+ parameters:
745
+ X-Ossa-Agent-Id:
746
+ name: X-OSSA-Agent-ID
747
+ in: header
748
+ description: Agent identifier
749
+ schema:
750
+ type: string
751
+
752
+ paths:
753
+ /api/v1/diagnose/pod:
754
+ post:
755
+ summary: Diagnose pod issues
756
+ operationId: diagnosePod
757
+ tags: [Diagnostics]
758
+ x-ossa-capability:
759
+ name: pod-diagnostics
760
+ description: Diagnose Kubernetes pod failures and issues
761
+ x-ossa-autonomy:
762
+ level: supervised
763
+ approval_required: true
764
+ allowed_actions:
765
+ - read_pods
766
+ - read_logs
767
+ - read_events
768
+ blocked_actions:
769
+ - delete_pods
770
+ - modify_configs
771
+ x-ossa-constraints:
772
+ cost:
773
+ maxTokensPerDay: 50000
774
+ maxTokensPerRequest: 4000
775
+ maxCostPerDay: 10.0
776
+ currency: USD
777
+ performance:
778
+ maxLatencySeconds: 30
779
+ maxConcurrentRequests: 5
780
+ x-ossa-tools:
781
+ - type: mcp
782
+ server: kubernetes-mcp
783
+ namespace: default
784
+ capabilities:
785
+ - get_pods
786
+ - get_logs
787
+ - get_events
788
+ - describe_resource
789
+ x-ossa-llm:
790
+ provider: openai
791
+ model: gpt-4
792
+ temperature: 0.2
793
+ maxTokens: 4000
794
+ parameters:
795
+ - $ref: '#/components/parameters/X-Ossa-Agent-Id'
796
+ requestBody:
797
+ required: true
798
+ content:
799
+ application/json:
800
+ schema:
801
+ type: object
802
+ required: [podName, namespace]
803
+ properties:
804
+ podName:
805
+ type: string
806
+ namespace:
807
+ type: string
808
+ responses:
809
+ '200':
810
+ description: Diagnosis complete
811
+ content:
812
+ application/json:
813
+ schema:
814
+ type: object
815
+ properties:
816
+ status:
817
+ type: string
818
+ issues:
819
+ type: array
820
+ items:
821
+ type: object
822
+ recommendations:
823
+ type: array
824
+ items:
825
+ type: string
826
+ ```
827
+
828
+ ---
829
+
830
+ ## Integration with OSSA Manifests
831
+
832
+ OSSA OpenAPI extensions complement OSSA agent manifests (`.ossa.yaml` files). They serve different but related purposes:
833
+
834
+ ### OSSA Agent Manifest (`.ossa.yaml`)
835
+ - **Purpose**: Declarative agent definition with full configuration
836
+ - **Contains**: Role, LLM config, tools, autonomy, constraints, extensions
837
+ - **Used For**: Agent deployment, runtime configuration, framework integration
838
+
839
+ ### OpenAPI Specification with OSSA Extensions
840
+ - **Purpose**: API interface definition with agent metadata
841
+ - **Contains**: HTTP endpoints, request/response schemas, agent capabilities
842
+ - **Used For**: API documentation, client generation, runtime API validation
843
+
844
+ ### Bidirectional Mapping
845
+
846
+ An agent can have both:
847
+
848
+ 1. **OSSA Manifest** (`agent.ossa.yaml`) - Defines the agent's behavior
849
+ 2. **OpenAPI Spec** (`agent.openapi.yaml`) - Defines the agent's HTTP interface
850
+
851
+ The OpenAPI spec should reference capabilities and tools defined in the manifest:
852
+
853
+ ```yaml
854
+ # agent.ossa.yaml
855
+ apiVersion: ossa/v0.2.x
856
+ kind: Agent
857
+ metadata:
858
+ name: k8s-troubleshooter
859
+ spec:
860
+ capabilities:
861
+ - pod-diagnostics
862
+ tools:
863
+ - type: mcp
864
+ server: kubernetes-mcp
865
+
866
+ ---
867
+
868
+ # agent.openapi.yaml
869
+ openapi: 3.1.0
870
+ x-ossa:
871
+ agent:
872
+ id: k8s-troubleshooter # References manifest metadata.name
873
+ paths:
874
+ /api/v1/diagnose/pod:
875
+ post:
876
+ x-ossa-capability: pod-diagnostics # References manifest capability
877
+ x-ossa-tools:
878
+ - type: mcp
879
+ server: kubernetes-mcp # References manifest tool
880
+ ```
881
+
882
+ ### Best Practices
883
+
884
+ 1. **Keep in Sync**: Ensure OpenAPI extensions reference capabilities/tools from the manifest
885
+ 2. **Single Source of Truth**: Use manifest for agent behavior, OpenAPI for API contract
886
+ 3. **Version Together**: When updating agent capabilities, update both files
887
+ 4. **Validate Both**: Use `ossa validate` for manifest and OpenAPI validation for spec
888
+
889
+ ---
890
+
891
+ ## Tools & Validation
892
+
893
+ ### CLI Validation
894
+
895
+ The OSSA CLI can validate OpenAPI specs with OSSA extensions:
896
+
897
+ ```bash
898
+ # Validate OpenAPI spec with OSSA extensions
899
+ ossa validate --openapi agent.openapi.yaml
900
+
901
+ # Validate both manifest and OpenAPI spec
902
+ ossa validate agent.ossa.yaml agent.openapi.yaml
903
+ ```
904
+
905
+ ### IDE Support
906
+
907
+ - **VS Code**: Install OpenAPI extension + OSSA extension (when available)
908
+ - **IntelliJ**: OpenAPI plugin recognizes custom extensions
909
+ - **Online Editors**: Swagger Editor and Stoplight Studio support custom extensions
910
+
911
+ ### OpenAPI Tool Compatibility
912
+
913
+ Most OpenAPI tools ignore unknown extensions (per OpenAPI spec), so OSSA extensions won't break existing tooling. However, OSSA-aware tools can:
914
+
915
+ - Generate agent clients with capability awareness
916
+ - Validate autonomy and constraint requirements
917
+ - Document tool requirements and MCP server dependencies
918
+ - Generate compliance reports from metadata
919
+
920
+ ---
921
+
922
+ ## References
923
+
924
+ - [OSSA Specification v0.2.x](Specification/v0.2.x/OSSA-SPECIFICATION-v0.2.x.md)
925
+ - [OSSA JSON Schema](Specification/v0.2.x/ossa-0.2.x.schema.json)
926
+ - [OpenAPI 3.1 Specification](https://spec.openapis.org/oas/v3.1.0)
927
+ - [OpenAPI Extensions Schema](../schemas/openapi-extensions.schema.json)
928
+ - [OSSA Examples](../../examples/)
929
+ - [GitHub Repository](https://github.com/blueflyio/openstandardagents)
930
+
931
+ ---
932
+
933
+ **OSSA OpenAPI Extensions: Making AI agents discoverable, interoperable, and enterprise-ready.**
934
+