@bluefly/openstandardagents 0.2.4 → 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 (355) hide show
  1. package/.cursorrules +84 -0
  2. package/.devfile.yaml +87 -0
  3. package/.env.example +25 -3
  4. package/.github/workflows/release.yml +1 -1
  5. package/.kiro/specs/agent-buildkit-templates/design.md +495 -0
  6. package/.kiro/specs/agent-buildkit-templates/requirements.md +165 -0
  7. package/.kiro/specs/kiro-ide-supercharger/README.md +202 -0
  8. package/.kiro/specs/kiro-ide-supercharger/design.md +1005 -0
  9. package/.kiro/specs/kiro-ide-supercharger/requirements.md +141 -0
  10. package/.kiro/specs/kiro-ide-supercharger/tasks.md +507 -0
  11. package/.kiro/specs/website-design-audit/design.md +679 -0
  12. package/.kiro/specs/website-design-audit/requirements.md +199 -0
  13. package/.releaserc.json +5 -4
  14. package/.version.json +6 -0
  15. package/CHANGELOG.md +140 -96
  16. package/CONTRIBUTING.md +23 -5
  17. package/README.md +121 -43
  18. package/bin/ossa +24 -3
  19. package/bin/ossa-validate-all +55 -0
  20. package/bin/ossa-version +23 -0
  21. package/bin/validate-ossa-0.2.4.ts +244 -0
  22. package/bin/validate-ossa-0.2.5-RC.ts +244 -0
  23. package/bin/validate-ossa.ts +273 -0
  24. package/dist/di-container.d.ts +1 -1
  25. package/dist/di-container.d.ts.map +1 -1
  26. package/dist/di-container.js.map +1 -1
  27. package/dist/repositories/schema.repository.d.ts +17 -2
  28. package/dist/repositories/schema.repository.d.ts.map +1 -1
  29. package/dist/repositories/schema.repository.js +96 -18
  30. package/dist/repositories/schema.repository.js.map +1 -1
  31. package/dist/services/generation.service.d.ts +7 -5
  32. package/dist/services/generation.service.d.ts.map +1 -1
  33. package/dist/services/generation.service.js +92 -44
  34. package/dist/services/generation.service.js.map +1 -1
  35. package/dist/services/gitlab-agent.service.d.ts +94 -0
  36. package/dist/services/gitlab-agent.service.d.ts.map +1 -0
  37. package/dist/services/gitlab-agent.service.js +162 -0
  38. package/dist/services/gitlab-agent.service.js.map +1 -0
  39. package/dist/services/migration.service.d.ts +3 -3
  40. package/dist/services/migration.service.d.ts.map +1 -1
  41. package/dist/services/migration.service.js +108 -61
  42. package/dist/services/migration.service.js.map +1 -1
  43. package/dist/services/release-automation/base-crud.service.d.ts +93 -0
  44. package/dist/services/release-automation/base-crud.service.d.ts.map +1 -0
  45. package/dist/services/release-automation/base-crud.service.js +68 -0
  46. package/dist/services/release-automation/base-crud.service.js.map +1 -0
  47. package/dist/services/release-automation/index.d.ts +12 -0
  48. package/dist/services/release-automation/index.d.ts.map +1 -0
  49. package/dist/services/release-automation/index.js +12 -0
  50. package/dist/services/release-automation/index.js.map +1 -0
  51. package/dist/services/release-automation/merge-request.service.d.ts +119 -0
  52. package/dist/services/release-automation/merge-request.service.d.ts.map +1 -0
  53. package/dist/services/release-automation/merge-request.service.js +212 -0
  54. package/dist/services/release-automation/merge-request.service.js.map +1 -0
  55. package/dist/services/release-automation/milestone.service.d.ts +104 -0
  56. package/dist/services/release-automation/milestone.service.d.ts.map +1 -0
  57. package/dist/services/release-automation/milestone.service.js +207 -0
  58. package/dist/services/release-automation/milestone.service.js.map +1 -0
  59. package/dist/services/release-automation/release.service.d.ts +118 -0
  60. package/dist/services/release-automation/release.service.d.ts.map +1 -0
  61. package/dist/services/release-automation/release.service.js +207 -0
  62. package/dist/services/release-automation/release.service.js.map +1 -0
  63. package/dist/services/release-automation/schemas/release.schema.d.ts +299 -0
  64. package/dist/services/release-automation/schemas/release.schema.d.ts.map +1 -0
  65. package/dist/services/release-automation/schemas/release.schema.js +269 -0
  66. package/dist/services/release-automation/schemas/release.schema.js.map +1 -0
  67. package/dist/services/release-automation/tag.service.d.ts +99 -0
  68. package/dist/services/release-automation/tag.service.d.ts.map +1 -0
  69. package/dist/services/release-automation/tag.service.js +180 -0
  70. package/dist/services/release-automation/tag.service.js.map +1 -0
  71. package/dist/services/release-automation/webhook.service.d.ts +37 -0
  72. package/dist/services/release-automation/webhook.service.d.ts.map +1 -0
  73. package/dist/services/release-automation/webhook.service.js +173 -0
  74. package/dist/services/release-automation/webhook.service.js.map +1 -0
  75. package/dist/services/runtime/openai.adapter.d.ts.map +1 -1
  76. package/dist/services/runtime/openai.adapter.js.map +1 -1
  77. package/dist/services/validation.service.d.ts.map +1 -1
  78. package/dist/services/validation.service.js +24 -11
  79. package/dist/services/validation.service.js.map +1 -1
  80. package/dist/services/validators/anthropic.validator.d.ts +2 -2
  81. package/dist/services/validators/anthropic.validator.d.ts.map +1 -1
  82. package/dist/services/validators/anthropic.validator.js +14 -9
  83. package/dist/services/validators/anthropic.validator.js.map +1 -1
  84. package/dist/services/validators/autogen.validator.d.ts +2 -2
  85. package/dist/services/validators/autogen.validator.d.ts.map +1 -1
  86. package/dist/services/validators/autogen.validator.js +18 -15
  87. package/dist/services/validators/autogen.validator.js.map +1 -1
  88. package/dist/services/validators/crewai.validator.d.ts +2 -2
  89. package/dist/services/validators/crewai.validator.d.ts.map +1 -1
  90. package/dist/services/validators/crewai.validator.js +18 -17
  91. package/dist/services/validators/crewai.validator.js.map +1 -1
  92. package/dist/services/validators/cursor.validator.d.ts +2 -2
  93. package/dist/services/validators/cursor.validator.d.ts.map +1 -1
  94. package/dist/services/validators/cursor.validator.js +15 -11
  95. package/dist/services/validators/cursor.validator.js.map +1 -1
  96. package/dist/services/validators/langchain.validator.d.ts +2 -2
  97. package/dist/services/validators/langchain.validator.d.ts.map +1 -1
  98. package/dist/services/validators/langchain.validator.js +14 -11
  99. package/dist/services/validators/langchain.validator.js.map +1 -1
  100. package/dist/services/validators/langflow.validator.d.ts +2 -2
  101. package/dist/services/validators/langflow.validator.d.ts.map +1 -1
  102. package/dist/services/validators/langflow.validator.js +14 -9
  103. package/dist/services/validators/langflow.validator.js.map +1 -1
  104. package/dist/services/validators/langgraph.validator.d.ts +2 -2
  105. package/dist/services/validators/langgraph.validator.d.ts.map +1 -1
  106. package/dist/services/validators/langgraph.validator.js +23 -18
  107. package/dist/services/validators/langgraph.validator.js.map +1 -1
  108. package/dist/services/validators/llamaindex.validator.d.ts +2 -2
  109. package/dist/services/validators/llamaindex.validator.d.ts.map +1 -1
  110. package/dist/services/validators/llamaindex.validator.js +19 -16
  111. package/dist/services/validators/llamaindex.validator.js.map +1 -1
  112. package/dist/services/validators/openai.validator.d.ts +2 -2
  113. package/dist/services/validators/openai.validator.d.ts.map +1 -1
  114. package/dist/services/validators/openai.validator.js +20 -16
  115. package/dist/services/validators/openai.validator.js.map +1 -1
  116. package/dist/services/validators/vercel-ai.validator.d.ts +2 -2
  117. package/dist/services/validators/vercel-ai.validator.d.ts.map +1 -1
  118. package/dist/services/validators/vercel-ai.validator.js +16 -15
  119. package/dist/services/validators/vercel-ai.validator.js.map +1 -1
  120. package/dist/spec/v0.2.0/ossa-0.2.0.schema.json +0 -0
  121. package/dist/spec/v0.2.1/ossa-0.2.1.schema.json +555 -0
  122. package/dist/spec/v0.2.3/CHANGELOG.md +7 -7
  123. package/dist/spec/v0.2.3/README.md +9 -9
  124. package/dist/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +18 -18
  125. package/{spec/v0.2.4-dev → dist/spec/v0.2.4}/CHANGELOG.md +8 -8
  126. package/dist/spec/{v0.2.4-dev → v0.2.4}/migrations/v0.2.3-to-v0.2.4.md +10 -10
  127. package/dist/spec/{v0.2.4-dev → v0.2.4}/ossa-0.2.4-dev.yaml +1 -1
  128. package/dist/spec/v0.2.4/ossa-0.2.4.schema.json +1819 -0
  129. package/dist/spec/v0.2.5/CHANGELOG.md +401 -0
  130. package/dist/spec/v0.2.5/README.md +72 -0
  131. package/dist/spec/v0.2.5/migrations/v0.2.3-to-v0.2.4.md +599 -0
  132. package/dist/spec/{v0.2.5-dev/ossa-0.2.5-dev.schema.json → v0.2.5/ossa-0.2.5.schema.json} +323 -359
  133. package/dist/spec/v0.2.5/ossa-0.2.5.yaml +581 -0
  134. package/dist/spec/v0.2.5-RC/CHANGELOG.md +401 -0
  135. package/dist/spec/v0.2.5-RC/README.md +72 -0
  136. package/{spec/v0.2.4-dev → dist/spec/v0.2.5-RC}/migrations/v0.2.3-to-v0.2.4.md +10 -10
  137. package/dist/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json +1696 -0
  138. package/dist/spec/v0.2.5-RC/ossa-0.2.5-RC.yaml +581 -0
  139. package/dist/types/index.d.ts +6 -1
  140. package/dist/types/index.d.ts.map +1 -1
  141. package/docs/issue-19-completion-summary.md +648 -0
  142. package/docs/issue-19-validation.md +351 -0
  143. package/examples/anthropic/claude-assistant.ossa.json +1 -1
  144. package/examples/autogen/multi-agent.ossa.json +1 -1
  145. package/examples/bridges/Dockerfile.production +1 -1
  146. package/examples/crewai/research-team.ossa.json +1 -1
  147. package/examples/cursor/code-review-agent.ossa.json +1 -1
  148. package/examples/enterprise/agent.yml +1 -1
  149. package/examples/getting-started/hello-world-complete.ossa.yaml +2 -2
  150. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +4 -4
  151. package/examples/langchain/chain-agent.ossa.json +1 -1
  152. package/examples/langflow/workflow-agent.ossa.json +1 -1
  153. package/examples/langgraph/state-machine-agent.ossa.json +1 -1
  154. package/examples/llamaindex/rag-agent.ossa.json +1 -1
  155. package/examples/openai/basic-agent.ossa.yaml +61 -0
  156. package/examples/openai/multi-tool-agent.ossa.json +165 -0
  157. package/examples/openai/swarm-agent.ossa.json +1 -1
  158. package/examples/openapi-extensions/README.md +1 -1
  159. package/examples/quickstart/support-agent.ossa.yaml +1 -1
  160. package/examples/vercel/edge-agent.ossa.json +1 -1
  161. package/infrastructure/gitlab-agent/rbac.yaml +126 -0
  162. package/infrastructure/gitlab-agent/values.yaml +150 -0
  163. package/infrastructure/k8s/monitoring/00-namespace.yaml +7 -0
  164. package/infrastructure/k8s/monitoring/01-prometheus.yaml +142 -0
  165. package/infrastructure/k8s/monitoring/02-grafana.yaml +63 -0
  166. package/infrastructure/k8s/monitoring/03-lightweight.yaml +121 -0
  167. package/infrastructure/k8s/monitoring/README.md +73 -0
  168. package/infrastructure/k8s/monitoring/deploy.sh +38 -0
  169. package/openapi/CHANGELOG.md +21 -0
  170. package/openapi/README.md +46 -0
  171. package/openapi/{ossa-core-api.openapi.yaml → core/ossa-core-api.openapi.yaml} +59 -4
  172. package/openapi/{ossa-registry.openapi.yaml → core/ossa-registry.openapi.yaml} +75 -2
  173. package/openapi/{unified-agent-gateway.openapi.yaml → core/unified-agent-gateway.openapi.yaml} +3 -3
  174. package/openapi/reference-implementations/aiflow-bridge-api.openapi.yaml +136 -0
  175. package/openapi/reference-implementations/compliance-agent-api.openapi.yaml +192 -0
  176. package/openapi/reference-implementations/crewai-agent-api.openapi.yaml +149 -0
  177. package/openapi/reference-implementations/critic-agent-api.openapi.yaml +151 -0
  178. package/openapi/reference-implementations/document-analyzer-api.openapi.yaml +217 -0
  179. package/openapi/reference-implementations/getting-started-hello-world-api.openapi.yaml +149 -0
  180. package/openapi/reference-implementations/gitlab-ml-recommender-api.openapi.yaml +151 -0
  181. package/openapi/reference-implementations/governor-agent-api.openapi.yaml +193 -0
  182. package/openapi/reference-implementations/integrator-agent-api.openapi.yaml +165 -0
  183. package/openapi/reference-implementations/judge-agent-api.openapi.yaml +148 -0
  184. package/openapi/reference-implementations/k8s-troubleshooter-api.openapi.yaml +167 -0
  185. package/openapi/reference-implementations/langchain-agent-api.openapi.yaml +171 -0
  186. package/openapi/reference-implementations/monitor-agent-api.openapi.yaml +171 -0
  187. package/openapi/reference-implementations/orchestrator-agent-api.openapi.yaml +242 -0
  188. package/openapi/reference-implementations/quickstart-support-agent-api.openapi.yaml +187 -0
  189. package/openapi/{self-evolving-ecosystem.openapi.yaml → reference-implementations/self-evolving-ecosystem.openapi.yaml} +2 -2
  190. package/openapi/reference-implementations/worker-agent-api.openapi.yaml +208 -0
  191. package/openapi/reference-implementations/workflow-orchestrator-api.openapi.yaml +193 -0
  192. package/package.json +31 -21
  193. package/release.config.js +20 -5
  194. package/scripts/bump-version.ts +57 -0
  195. package/scripts/enhanced-version-manager.ts +257 -0
  196. package/scripts/gen-types.ts +51 -0
  197. package/scripts/gen-zod.ts +51 -0
  198. package/scripts/lib/exec.ts +37 -0
  199. package/scripts/lib/file-ops.ts +58 -0
  200. package/scripts/lib/version.ts +83 -0
  201. package/scripts/process-doc-templates.ts +37 -0
  202. package/scripts/schemas/package.schema.ts +75 -0
  203. package/scripts/setup-branch-protection.sh +33 -0
  204. package/scripts/sync-version.ts +39 -0
  205. package/scripts/sync-versions.ts +488 -0
  206. package/scripts/validate-schema.ts +49 -0
  207. package/spec/v0.2.0/ossa-0.2.0.schema.json +0 -0
  208. package/spec/v0.2.1/ossa-0.2.1.schema.json +555 -0
  209. package/spec/v0.2.3/CHANGELOG.md +7 -7
  210. package/spec/v0.2.3/README.md +9 -9
  211. package/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +18 -18
  212. package/{dist/spec/v0.2.4-dev → spec/v0.2.4}/CHANGELOG.md +8 -8
  213. package/spec/v0.2.4/migrations/v0.2.3-to-v0.2.4.md +599 -0
  214. package/spec/{v0.2.4-dev → v0.2.4}/ossa-0.2.4-dev.yaml +1 -1
  215. package/spec/v0.2.4/ossa-0.2.4.schema.json +1819 -0
  216. package/spec/v0.2.5/CHANGELOG.md +401 -0
  217. package/spec/v0.2.5/README.md +72 -0
  218. package/spec/v0.2.5/migrations/v0.2.3-to-v0.2.4.md +599 -0
  219. package/spec/{v0.2.5-dev/ossa-0.2.5-dev.schema.json → v0.2.5/ossa-0.2.5.schema.json} +323 -359
  220. package/spec/v0.2.5/ossa-0.2.5.yaml +581 -0
  221. package/spec/v0.2.5-RC/CHANGELOG.md +401 -0
  222. package/spec/v0.2.5-RC/README.md +72 -0
  223. package/spec/v0.2.5-RC/migrations/v0.2.3-to-v0.2.4.md +599 -0
  224. package/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json +1696 -0
  225. package/spec/v0.2.5-RC/ossa-0.2.5-RC.yaml +581 -0
  226. package/website/{.lighthouserc.js → .lighthouserc.ts} +5 -1
  227. package/website/Dockerfile +18 -5
  228. package/website/app/about/page.tsx +7 -7
  229. package/website/app/blog/[slug]/page.tsx +61 -20
  230. package/website/app/blog/page.tsx +120 -33
  231. package/website/app/design-guide/page.tsx +511 -0
  232. package/website/app/docs/[[...slug]]/page.tsx +641 -143
  233. package/website/app/examples/page.tsx +51 -41
  234. package/website/app/{globals.css → globals.scss} +50 -23
  235. package/website/app/layout.tsx +2 -2
  236. package/website/app/license/page.tsx +183 -0
  237. package/website/app/not-found.tsx +18 -0
  238. package/website/app/page.tsx +144 -79
  239. package/website/app/playground/page.tsx +25 -45
  240. package/website/app/schema/page.tsx +423 -392
  241. package/website/app/specification/page.tsx +245 -169
  242. package/website/components/Logo.tsx +75 -2
  243. package/website/components/docs/DocsSidebar.tsx +40 -3
  244. package/website/components/docs/MarkdownContent.tsx +265 -47
  245. package/website/components/docs/VersionSelector.tsx +64 -8
  246. package/website/components/examples/ExamplesViewer.tsx +2 -2
  247. package/website/components/layout/Footer.tsx +6 -1
  248. package/website/components/layout/Header.tsx +31 -33
  249. package/website/components/schema/SchemaComponentsAccordion.tsx +84 -0
  250. package/website/components/schema/SchemaExplorer.tsx +4 -4
  251. package/website/content/blog/OpenAPI-AI-Agents-Standard.md +276 -276
  252. package/website/content/blog/Why-Formal-Standards-Matter-Now.md +3 -14
  253. package/website/content/blog/gitlab-kubernetes-agent-ecosystem.md +286 -0
  254. package/website/content/blog/introducing-ossa-framework.md +1 -1
  255. package/website/content/blog/ossa-production-results.md +5 -5
  256. package/website/content/blog/welcome-to-ossa.md +2 -2
  257. package/website/content/blog/why-ai-agents-need-open-standard.md +5 -5
  258. package/website/content/docs/00-HOME.md +18 -25
  259. package/website/content/docs/AIFlow-Framework-Integration-with-OSSA.md +8 -8
  260. package/website/content/docs/OpenAPI-Extensions.md +576 -140
  261. package/website/content/docs/adapters/openai-adapter.md +693 -0
  262. package/website/content/docs/architecture/execution-flow.md +3 -3
  263. package/website/content/docs/architecture/multi-agent-systems.md +4 -4
  264. package/website/content/docs/architecture/overview.md +4 -4
  265. package/website/content/docs/architecture/stack-integration.md +4 -4
  266. package/website/content/docs/changelog.md +4 -4
  267. package/website/content/docs/contributing.md +2 -2
  268. package/website/content/docs/ecosystem/framework-support.md +0 -2
  269. package/website/content/docs/examples/AIFlow-Framework-Integration-with-OSSA.md +107 -0
  270. package/website/content/docs/examples/Migration-Guides.md +2 -2
  271. package/website/content/docs/for-audiences/{architects.md → Architects.md} +1 -1
  272. package/website/content/docs/for-audiences/{developers.md → Developers.md} +3 -3
  273. package/website/content/docs/for-audiences/Enterprises.md +2 -2
  274. package/website/content/docs/for-audiences/Students-Researchers.md +1 -1
  275. package/website/content/docs/getting-started/{5-minute-overview.md → 5-Minute-Overview.md} +2 -2
  276. package/website/content/docs/getting-started/{first-agent.md → First-Agent.md} +1 -1
  277. package/website/content/docs/getting-started/Hello-World.md +3 -3
  278. package/website/content/docs/getting-started/{installation.md → Installation.md} +7 -7
  279. package/website/content/docs/getting-started/index.md +92 -0
  280. package/website/content/docs/getting-started/running-agents.md +215 -13
  281. package/{docs → website/content/docs}/getting-started.md +10 -6
  282. package/website/content/docs/integrations/aiflow.md +2 -2
  283. package/website/content/docs/integrations/drupal.md +2 -2
  284. package/website/content/docs/migration-guides/README.md +1 -1
  285. package/website/content/docs/migration-guides/agent-schema-comparison.md +232 -0
  286. package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +5 -5
  287. package/website/content/docs/migration-guides/crewai-to-ossa.md +3 -3
  288. package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +11 -11
  289. package/{docs/migration → website/content/docs/migration-guides}/general-agent-schema.yml +1 -9
  290. package/website/content/docs/migration-guides/index.md +1 -1
  291. package/website/content/docs/migration-guides/langchain-to-ossa.md +17 -17
  292. package/website/content/docs/migration-guides/langflow-to-ossa.md +3 -3
  293. package/website/content/docs/migration-guides/openai-to-ossa.md +10 -10
  294. package/website/content/docs/openapi-extensions/examples.md +9 -9
  295. package/website/content/docs/openapi-extensions/index.md +59 -3
  296. package/website/content/docs/openapi-extensions/operation-extensions.md +61 -2
  297. package/website/content/docs/openapi-extensions/root-extensions.md +49 -3
  298. package/{docs/OSSA-COMPLIANT-BADGE.md → website/content/docs/ossa-compliant-badge.md} +18 -15
  299. package/website/content/docs/pre-release/index.md +10 -10
  300. package/website/content/docs/readme.md +35 -0
  301. package/website/content/docs/schema-reference/agent-spec.md +2 -2
  302. package/website/content/docs/schema-reference/autonomy.md +5 -5
  303. package/website/content/docs/schema-reference/constraints.md +5 -5
  304. package/website/content/docs/schema-reference/llm-config.md +1 -1
  305. package/website/content/docs/schema-reference/observability.md +5 -5
  306. package/website/content/docs/schema-reference/ossa-manifest.md +6 -6
  307. package/website/content/docs/schema-reference/taxonomy.md +3 -3
  308. package/website/content/docs/use-cases/00-index.md +1 -1
  309. package/{docs/VERSIONING.md → website/content/docs/versioning.md} +9 -5
  310. package/website/lib/version.ts +18 -1
  311. package/website/lib/versions.json +78 -0
  312. package/website/next.config.ts +3 -1
  313. package/website/package-lock.json +552 -18
  314. package/website/package.json +11 -5
  315. package/website/postcss.config.mjs +1 -1
  316. package/website/scripts/fetch-versions.js +166 -0
  317. package/website/scripts/generate-examples-index.js +163 -0
  318. package/website/scripts/merge-docs-to-wiki.ts +207 -0
  319. package/website/scripts/sync-version.js +28 -0
  320. package/website/scripts/sync-wiki.ts +64 -3
  321. package/website/scripts/upload-wiki.ts +199 -0
  322. package/website/styles/_variables.scss +36 -0
  323. package/website/tailwind.config.ts +93 -22
  324. package/.releaserc.json.disabled +0 -81
  325. package/dist/spec/v0.2.5-dev/CHANGELOG.md +0 -171
  326. package/dist/spec/v0.2.5-dev/examples/customer-support-graph.ossa.yaml +0 -362
  327. package/dist/spec/v0.2.5-dev/examples/parallel-processors.ossa.yaml +0 -464
  328. package/dist/spec/v0.2.5-dev/examples/research-team.ossa.yaml +0 -440
  329. package/dist/spec/v0.2.5-dev/migrations/v0.2.4-to-v0.2.5.md +0 -317
  330. package/dist/spec/v0.2.5-dev/ossa-0.2.5-dev.yaml +0 -409
  331. package/docs/README.md +0 -31
  332. package/docs/agent-openapi-spec.yml +0 -942
  333. package/docs/openapi-extensions.md +0 -930
  334. package/docs/schemas/openapi-extensions.schema.json +0 -486
  335. package/openapi/gitlab-orchestrator.openapi.yaml +0 -330
  336. package/ossa-website-swarm-tasks.json +0 -105
  337. package/spec/v0.2.5-dev/CHANGELOG.md +0 -171
  338. package/spec/v0.2.5-dev/examples/customer-support-graph.ossa.yaml +0 -362
  339. package/spec/v0.2.5-dev/examples/parallel-processors.ossa.yaml +0 -464
  340. package/spec/v0.2.5-dev/examples/research-team.ossa.yaml +0 -440
  341. package/spec/v0.2.5-dev/migrations/v0.2.4-to-v0.2.5.md +0 -317
  342. package/spec/v0.2.5-dev/ossa-0.2.5-dev.yaml +0 -409
  343. package/website/app/api/validate/route.ts +0 -88
  344. package/website/next.config.js +0 -17
  345. package/website/postcss.config.js +0 -7
  346. package/website/tailwind.config.js +0 -58
  347. /package/dist/spec/{v0.2.4-dev → v0.2.4}/ossa-0.2.4-dev.schema.json +0 -0
  348. /package/openapi/{ossa-registry-api.openapi.yaml → core/ossa-registry-api.openapi.yaml} +0 -0
  349. /package/openapi/{drupal-agent-api.openapi.yaml → reference-implementations/drupal-agent-api.openapi.yaml} +0 -0
  350. /package/openapi/{helm-generator.openapi.yaml → reference-implementations/helm-generator.openapi.yaml} +0 -0
  351. /package/spec/{v0.2.4-dev → v0.2.4}/ossa-0.2.4-dev.schema.json +0 -0
  352. /package/website/content/docs/{examples.md → Examples.md} +0 -0
  353. /package/website/content/docs/core-concepts/{project-structure.md → Project-Structure.md} +0 -0
  354. /package/website/content/docs/migration-guides/{00-index.md → 00-INDEX.md} +0 -0
  355. /package/{docs/migration → website/content/docs/migration-guides}/migration-manifest.json +0 -0
@@ -1,52 +1,44 @@
1
1
  {
2
2
  "$schema": "http://json-schema.org/draft-07/schema#",
3
- "$id": "https://openstandardagents.org/schemas/v0.2.5-dev/agent.json",
4
- "title": "OSSA v0.2.5-dev Agent Manifest Schema",
5
- "description": "Open Standard for Scalable AI Agents (OSSA) - The OpenAPI for AI Agents. Specification for declarative agent definition with framework-agnostic portability. v0.2.5-dev adds multi-agent composition support via AgentGraph.",
3
+ "$id": "https://openstandardagents.org/schemas/v0.2.5/agent.json",
4
+ "title": "OSSA v0.2.5-RC Agent Manifest Schema",
5
+ "description": "Open Standard for Scalable AI Agents (OSSA) - The OpenAPI for AI Agents. Specification for declarative agent definition with framework-agnostic portability.",
6
6
  "type": "object",
7
7
  "required": [
8
8
  "apiVersion",
9
9
  "kind",
10
- "metadata"
10
+ "metadata",
11
+ "spec"
11
12
  ],
12
13
  "properties": {
13
14
  "apiVersion": {
14
15
  "type": "string",
15
- "pattern": "^ossa/v(0\\.2\\.[2-5]|1)(\\.[0-9]+)?(-[a-zA-Z0-9]+)?$",
16
- "description": "OSSA API version (supports ossa/v0.2.2 through v0.2.5-dev, or ossa/v1 for compatibility)",
16
+ "pattern": "^ossa/v(0\\.2\\.[2-5](-dev)?|1)(\\.[0-9]+)?(-[a-zA-Z0-9]+)?$",
17
+ "description": "OSSA API version (supports ossa/v0.2.2, ossa/v0.2.3, ossa/v0.2.5, or ossa/v1 for compatibility)",
17
18
  "examples": [
18
19
  "ossa/v1",
19
- "ossa/v0.2.5-dev",
20
- "ossa/v0.2.4",
20
+ "ossa/v0.2.5",
21
21
  "ossa/v0.2.3",
22
- "ossa/v0.2.2"
22
+ "ossa/v0.2.2",
23
+ "ossa/v1.0"
23
24
  ]
24
25
  },
25
26
  "kind": {
26
27
  "type": "string",
27
28
  "enum": [
28
- "Agent",
29
- "AgentGraph"
29
+ "Agent"
30
30
  ],
31
- "description": "Resource type - 'Agent' for single agents, 'AgentGraph' for multi-agent compositions"
31
+ "description": "Resource type - currently only 'Agent' is supported"
32
32
  },
33
33
  "metadata": {
34
34
  "$ref": "#/definitions/Metadata"
35
35
  },
36
36
  "spec": {
37
- "description": "Specification for the resource - AgentSpec for Agent kind, AgentGraphSpec for AgentGraph kind",
38
- "oneOf": [
39
- {
40
- "$ref": "#/definitions/AgentSpec"
41
- },
42
- {
43
- "$ref": "#/definitions/AgentGraphSpec"
44
- }
45
- ]
37
+ "$ref": "#/definitions/AgentSpec"
46
38
  },
47
39
  "extensions": {
48
40
  "type": "object",
49
- "description": "Framework-specific extensions for integration with kagent, buildkit, drupal, librechat, mcp, langchain, crewai, openai_agents, cursor, langflow, autogen, vercel_ai, llamaindex, langgraph, anthropic, google_adk, microsoft_af, metagpt, and other frameworks",
41
+ "description": "Framework-specific extensions for integration with kagent, buildkit, drupal, librechat, mcp, langchain, crewai, openai_agents, cursor, langflow, autogen, vercel_ai, llamaindex, langgraph, anthropic, and other frameworks",
50
42
  "properties": {
51
43
  "kagent": {
52
44
  "$ref": "#/definitions/KAgentExtension"
@@ -95,12 +87,6 @@
95
87
  },
96
88
  "google_adk": {
97
89
  "$ref": "#/definitions/GoogleADKExtension"
98
- },
99
- "microsoft_af": {
100
- "$ref": "#/definitions/MicrosoftAFExtension"
101
- },
102
- "metagpt": {
103
- "$ref": "#/definitions/MetaGPTExtension"
104
90
  }
105
91
  },
106
92
  "additionalProperties": true
@@ -180,156 +166,13 @@
180
166
  },
181
167
  "observability": {
182
168
  "$ref": "#/definitions/Observability"
183
- }
184
- },
185
- "additionalProperties": true
186
- },
187
- "AgentGraphSpec": {
188
- "type": "object",
189
- "required": [
190
- "agents"
191
- ],
192
- "description": "Specification for multi-agent composition graphs",
193
- "properties": {
194
- "agents": {
195
- "type": "array",
196
- "minItems": 1,
197
- "items": {
198
- "$ref": "#/definitions/AgentRef"
199
- },
200
- "description": "Array of agent references that compose this graph"
201
- },
202
- "edges": {
203
- "type": "array",
204
- "items": {
205
- "$ref": "#/definitions/GraphEdge"
206
- },
207
- "description": "Connections between agents defining execution flow"
208
- },
209
- "process": {
210
- "type": "string",
211
- "enum": [
212
- "sequential",
213
- "parallel",
214
- "hierarchical",
215
- "conditional",
216
- "loop"
217
- ],
218
- "default": "sequential",
219
- "description": "Execution pattern for the agent graph"
220
- },
221
- "entry_point": {
222
- "type": "string",
223
- "description": "Starting agent ref (metadata.name of the first agent)"
224
- },
225
- "exit_points": {
226
- "type": "array",
227
- "items": {
228
- "type": "string"
229
- },
230
- "description": "Agent refs that can terminate the graph execution"
231
169
  },
232
170
  "state": {
233
- "$ref": "#/definitions/GraphState"
234
- },
235
- "observability": {
236
- "$ref": "#/definitions/Observability"
237
- },
238
- "constraints": {
239
- "$ref": "#/definitions/Constraints"
171
+ "$ref": "#/definitions/State"
240
172
  }
241
173
  },
242
174
  "additionalProperties": true
243
175
  },
244
- "AgentRef": {
245
- "type": "object",
246
- "required": [
247
- "ref"
248
- ],
249
- "properties": {
250
- "ref": {
251
- "type": "string",
252
- "description": "Reference to agent metadata.name"
253
- },
254
- "role": {
255
- "type": "string",
256
- "description": "Role of this agent within the graph context"
257
- },
258
- "inline": {
259
- "$ref": "#/definitions/AgentSpec",
260
- "description": "Inline agent specification (alternative to ref)"
261
- },
262
- "config": {
263
- "type": "object",
264
- "description": "Agent-specific configuration overrides for this graph context",
265
- "additionalProperties": true
266
- }
267
- },
268
- "additionalProperties": false
269
- },
270
- "GraphEdge": {
271
- "type": "object",
272
- "required": [
273
- "from",
274
- "to"
275
- ],
276
- "properties": {
277
- "from": {
278
- "type": "string",
279
- "description": "Source agent ref"
280
- },
281
- "to": {
282
- "type": "string",
283
- "description": "Target agent ref"
284
- },
285
- "condition": {
286
- "type": "string",
287
- "description": "Condition expression for this edge (e.g., 'output.status == success')"
288
- },
289
- "priority": {
290
- "type": "integer",
291
- "minimum": 0,
292
- "default": 0,
293
- "description": "Edge priority for conflict resolution (higher = preferred)"
294
- },
295
- "transform": {
296
- "type": "string",
297
- "description": "Data transformation expression between agents"
298
- },
299
- "metadata": {
300
- "type": "object",
301
- "description": "Additional edge metadata",
302
- "additionalProperties": true
303
- }
304
- },
305
- "additionalProperties": false
306
- },
307
- "GraphState": {
308
- "type": "object",
309
- "description": "Shared state configuration for the agent graph",
310
- "properties": {
311
- "schema": {
312
- "type": "object",
313
- "description": "JSON Schema for the shared state structure"
314
- },
315
- "initial": {
316
- "type": "object",
317
- "description": "Initial state values"
318
- },
319
- "persistence": {
320
- "type": "string",
321
- "enum": [
322
- "none",
323
- "memory",
324
- "redis",
325
- "database"
326
- ],
327
- "default": "memory",
328
- "description": "State persistence mechanism"
329
- }
330
- },
331
- "additionalProperties": false
332
- },
333
176
  "Taxonomy": {
334
177
  "type": "object",
335
178
  "required": [
@@ -441,6 +284,7 @@
441
284
  "http",
442
285
  "grpc",
443
286
  "function",
287
+ "a2a",
444
288
  "custom"
445
289
  ],
446
290
  "description": "Tool integration type"
@@ -465,7 +309,7 @@
465
309
  "capabilities": {
466
310
  "type": "array",
467
311
  "items": {
468
- "type": "string"
312
+ "$ref": "#/definitions/Capability"
469
313
  },
470
314
  "description": "Specific capabilities/operations from this tool"
471
315
  },
@@ -490,8 +334,198 @@
490
334
  "credentials": {
491
335
  "type": "string",
492
336
  "description": "Reference to secret/credential (not the actual secret)"
337
+ },
338
+ "scopes": {
339
+ "type": "array",
340
+ "items": {
341
+ "type": "string"
342
+ },
343
+ "description": "OAuth2 scopes or permission scopes required"
493
344
  }
494
345
  }
346
+ },
347
+ "transport": {
348
+ "$ref": "#/definitions/Transport"
349
+ },
350
+ "compliance_tags": {
351
+ "type": "array",
352
+ "items": {
353
+ "type": "string"
354
+ },
355
+ "description": "Compliance framework tags (e.g., 'pii', 'hipaa', 'gdpr', 'fedramp')"
356
+ }
357
+ },
358
+ "additionalProperties": false
359
+ },
360
+ "Capability": {
361
+ "type": "object",
362
+ "properties": {
363
+ "name": {
364
+ "type": "string",
365
+ "description": "Capability name/identifier"
366
+ },
367
+ "description": {
368
+ "type": "string",
369
+ "description": "Human-readable description of the capability"
370
+ },
371
+ "version": {
372
+ "type": "string",
373
+ "pattern": "^[0-9]+\\.[0-9]+$",
374
+ "description": "Capability version (major.minor format)"
375
+ },
376
+ "deprecated": {
377
+ "type": "boolean",
378
+ "default": false,
379
+ "description": "Whether this capability is deprecated"
380
+ },
381
+ "deprecation_message": {
382
+ "type": "string",
383
+ "description": "Message explaining deprecation and migration path"
384
+ },
385
+ "input_schema": {
386
+ "type": "object",
387
+ "description": "JSON Schema for capability input"
388
+ },
389
+ "output_schema": {
390
+ "type": "object",
391
+ "description": "JSON Schema for capability output"
392
+ },
393
+ "transport": {
394
+ "$ref": "#/definitions/Transport"
395
+ },
396
+ "scopes": {
397
+ "type": "array",
398
+ "items": {
399
+ "type": "string"
400
+ },
401
+ "description": "Required permission scopes for this capability"
402
+ },
403
+ "compliance_tags": {
404
+ "type": "array",
405
+ "items": {
406
+ "type": "string"
407
+ },
408
+ "description": "Compliance framework tags for this capability"
409
+ }
410
+ },
411
+ "additionalProperties": false
412
+ },
413
+ "Transport": {
414
+ "type": "object",
415
+ "description": "Transport metadata for protocol-specific configuration (v0.2.5)",
416
+ "properties": {
417
+ "protocol": {
418
+ "type": "string",
419
+ "enum": [
420
+ "http",
421
+ "grpc",
422
+ "a2a",
423
+ "mcp",
424
+ "websocket",
425
+ "custom"
426
+ ],
427
+ "description": "Transport protocol"
428
+ },
429
+ "streaming": {
430
+ "type": "string",
431
+ "enum": [
432
+ "none",
433
+ "request",
434
+ "response",
435
+ "bidirectional"
436
+ ],
437
+ "default": "none",
438
+ "description": "Streaming mode for the transport"
439
+ },
440
+ "binding": {
441
+ "type": "string",
442
+ "description": "Path or endpoint binding (e.g., '/api/v1/chat', 'myservice.MyMethod')"
443
+ },
444
+ "content_type": {
445
+ "type": "string",
446
+ "description": "Content type for HTTP transports",
447
+ "examples": [
448
+ "application/json",
449
+ "application/x-ndjson",
450
+ "text/event-stream"
451
+ ]
452
+ }
453
+ },
454
+ "additionalProperties": false
455
+ },
456
+ "State": {
457
+ "type": "object",
458
+ "description": "Agent state and memory configuration (v0.2.5)",
459
+ "properties": {
460
+ "mode": {
461
+ "type": "string",
462
+ "enum": [
463
+ "stateless",
464
+ "session",
465
+ "long_running"
466
+ ],
467
+ "default": "stateless",
468
+ "description": "State management mode"
469
+ },
470
+ "storage": {
471
+ "type": "object",
472
+ "properties": {
473
+ "type": {
474
+ "type": "string",
475
+ "enum": [
476
+ "memory",
477
+ "vector-db",
478
+ "kv",
479
+ "rdbms",
480
+ "custom"
481
+ ],
482
+ "default": "memory",
483
+ "description": "Storage backend type"
484
+ },
485
+ "retention": {
486
+ "type": "string",
487
+ "description": "Retention period (e.g., '30d', '1y', 'forever')",
488
+ "examples": [
489
+ "24h",
490
+ "7d",
491
+ "30d",
492
+ "1y",
493
+ "forever"
494
+ ]
495
+ },
496
+ "config": {
497
+ "type": "object",
498
+ "description": "Storage-specific configuration",
499
+ "additionalProperties": true
500
+ }
501
+ },
502
+ "additionalProperties": false
503
+ },
504
+ "context_window": {
505
+ "type": "object",
506
+ "properties": {
507
+ "max_messages": {
508
+ "type": "integer",
509
+ "minimum": 1,
510
+ "description": "Maximum messages to retain in context"
511
+ },
512
+ "max_tokens": {
513
+ "type": "integer",
514
+ "minimum": 1,
515
+ "description": "Maximum tokens to retain in context"
516
+ },
517
+ "strategy": {
518
+ "type": "string",
519
+ "enum": [
520
+ "sliding_window",
521
+ "summarization",
522
+ "importance_weighted"
523
+ ],
524
+ "default": "sliding_window",
525
+ "description": "Context management strategy"
526
+ }
527
+ },
528
+ "additionalProperties": false
495
529
  }
496
530
  },
497
531
  "additionalProperties": false
@@ -912,25 +946,6 @@
912
946
  "type": "string"
913
947
  },
914
948
  "description": "CrewAI tool names"
915
- },
916
- "crew": {
917
- "type": "object",
918
- "description": "CrewAI crew configuration for AgentGraph",
919
- "properties": {
920
- "process": {
921
- "type": "string",
922
- "enum": ["sequential", "hierarchical"],
923
- "description": "CrewAI process type"
924
- },
925
- "verbose": {
926
- "type": "boolean",
927
- "default": false
928
- },
929
- "manager_llm": {
930
- "type": "string",
931
- "description": "LLM for manager agent in hierarchical process"
932
- }
933
- }
934
949
  }
935
950
  },
936
951
  "additionalProperties": true
@@ -1120,14 +1135,14 @@
1120
1135
  "type": "string",
1121
1136
  "enum": ["composer", "chat", "background", "cloud"],
1122
1137
  "default": "composer",
1123
- "description": "Cursor agent type"
1138
+ "description": "Cursor agent type (composer, chat, background, or cloud)"
1124
1139
  },
1125
1140
  "workspace_config": {
1126
1141
  "type": "object",
1127
1142
  "properties": {
1128
1143
  "rules_file": {
1129
1144
  "type": "string",
1130
- "description": "Path to .cursorrules file"
1145
+ "description": "Path to .cursorrules file (default: .cursor/.cursorrules)"
1131
1146
  },
1132
1147
  "context_files": {
1133
1148
  "type": "array",
@@ -1176,7 +1191,7 @@
1176
1191
  },
1177
1192
  "name": {
1178
1193
  "type": "string",
1179
- "description": "Model name"
1194
+ "description": "Model name (e.g., gpt-4, claude-3-opus)"
1180
1195
  }
1181
1196
  }
1182
1197
  }
@@ -1189,7 +1204,8 @@
1189
1204
  "properties": {
1190
1205
  "enabled": {
1191
1206
  "type": "boolean",
1192
- "default": false
1207
+ "default": false,
1208
+ "description": "Enable Langflow integration"
1193
1209
  },
1194
1210
  "flow_id": {
1195
1211
  "type": "string",
@@ -1210,6 +1226,7 @@
1210
1226
  },
1211
1227
  "components": {
1212
1228
  "type": "array",
1229
+ "description": "Langflow components used in this agent",
1213
1230
  "items": {
1214
1231
  "type": "object",
1215
1232
  "properties": {
@@ -1227,7 +1244,7 @@
1227
1244
  },
1228
1245
  "dataflow": {
1229
1246
  "type": "object",
1230
- "description": "Data flow configuration"
1247
+ "description": "Data flow configuration between components"
1231
1248
  }
1232
1249
  },
1233
1250
  "additionalProperties": true
@@ -1238,7 +1255,8 @@
1238
1255
  "properties": {
1239
1256
  "enabled": {
1240
1257
  "type": "boolean",
1241
- "default": false
1258
+ "default": false,
1259
+ "description": "Enable AutoGen integration"
1242
1260
  },
1243
1261
  "agent_type": {
1244
1262
  "type": "string",
@@ -1247,12 +1265,13 @@
1247
1265
  },
1248
1266
  "system_message": {
1249
1267
  "type": "string",
1250
- "description": "System message for AutoGen agent"
1268
+ "description": "System message for AutoGen agent (overrides spec.role if provided)"
1251
1269
  },
1252
1270
  "human_input_mode": {
1253
1271
  "type": "string",
1254
1272
  "enum": ["ALWAYS", "NEVER", "TERMINATE"],
1255
- "default": "NEVER"
1273
+ "default": "NEVER",
1274
+ "description": "When to request human input"
1256
1275
  },
1257
1276
  "code_execution": {
1258
1277
  "type": "object",
@@ -1262,31 +1281,37 @@
1262
1281
  "default": false
1263
1282
  },
1264
1283
  "work_dir": {
1265
- "type": "string"
1284
+ "type": "string",
1285
+ "description": "Working directory for code execution"
1266
1286
  },
1267
1287
  "use_docker": {
1268
1288
  "type": "boolean",
1269
- "default": false
1289
+ "default": false,
1290
+ "description": "Execute code in Docker container"
1270
1291
  }
1271
1292
  }
1272
1293
  },
1273
1294
  "max_consecutive_auto_reply": {
1274
1295
  "type": "integer",
1275
1296
  "minimum": 1,
1276
- "default": 10
1297
+ "default": 10,
1298
+ "description": "Maximum consecutive auto-replies before human input"
1277
1299
  },
1278
1300
  "groupchat": {
1279
1301
  "type": "object",
1302
+ "description": "Group chat configuration (for agent_type=groupchat)",
1280
1303
  "properties": {
1281
1304
  "agents": {
1282
1305
  "type": "array",
1283
1306
  "items": {
1284
1307
  "type": "string"
1285
- }
1308
+ },
1309
+ "description": "Other agent IDs in the group"
1286
1310
  },
1287
1311
  "max_round": {
1288
1312
  "type": "integer",
1289
- "minimum": 1
1313
+ "minimum": 1,
1314
+ "description": "Maximum rounds in group chat"
1290
1315
  }
1291
1316
  }
1292
1317
  }
@@ -1299,22 +1324,27 @@
1299
1324
  "properties": {
1300
1325
  "enabled": {
1301
1326
  "type": "boolean",
1302
- "default": false
1327
+ "default": false,
1328
+ "description": "Enable Vercel AI SDK integration"
1303
1329
  },
1304
1330
  "runtime": {
1305
1331
  "type": "string",
1306
1332
  "enum": ["edge", "nodejs"],
1307
- "default": "edge"
1333
+ "default": "edge",
1334
+ "description": "Runtime environment (edge or nodejs)"
1308
1335
  },
1309
1336
  "stream": {
1310
1337
  "type": "boolean",
1311
- "default": true
1338
+ "default": true,
1339
+ "description": "Enable streaming responses"
1312
1340
  },
1313
1341
  "route": {
1314
- "type": "string"
1342
+ "type": "string",
1343
+ "description": "API route path (e.g., /api/chat)"
1315
1344
  },
1316
1345
  "tools": {
1317
1346
  "type": "array",
1347
+ "description": "Vercel AI SDK tools configuration",
1318
1348
  "items": {
1319
1349
  "type": "object",
1320
1350
  "properties": {
@@ -1325,13 +1355,15 @@
1325
1355
  "type": "string"
1326
1356
  },
1327
1357
  "parameters": {
1328
- "type": "object"
1358
+ "type": "object",
1359
+ "description": "Tool parameters schema (JSON Schema)"
1329
1360
  }
1330
1361
  }
1331
1362
  }
1332
1363
  },
1333
1364
  "experimental": {
1334
1365
  "type": "object",
1366
+ "description": "Experimental Vercel AI SDK features",
1335
1367
  "additionalProperties": true
1336
1368
  }
1337
1369
  },
@@ -1343,11 +1375,13 @@
1343
1375
  "properties": {
1344
1376
  "enabled": {
1345
1377
  "type": "boolean",
1346
- "default": false
1378
+ "default": false,
1379
+ "description": "Enable LlamaIndex integration"
1347
1380
  },
1348
1381
  "agent_type": {
1349
1382
  "type": "string",
1350
- "enum": ["query_engine", "chat_engine", "retriever", "custom"]
1383
+ "enum": ["query_engine", "chat_engine", "retriever", "custom"],
1384
+ "description": "LlamaIndex agent/engine type"
1351
1385
  },
1352
1386
  "llm": {
1353
1387
  "type": "object",
@@ -1368,6 +1402,7 @@
1368
1402
  },
1369
1403
  "vector_store": {
1370
1404
  "type": "object",
1405
+ "description": "Vector store configuration for RAG",
1371
1406
  "properties": {
1372
1407
  "type": {
1373
1408
  "type": "string",
@@ -1381,11 +1416,13 @@
1381
1416
  },
1382
1417
  "retrieval": {
1383
1418
  "type": "object",
1419
+ "description": "Retrieval configuration",
1384
1420
  "properties": {
1385
1421
  "top_k": {
1386
1422
  "type": "integer",
1387
1423
  "minimum": 1,
1388
- "default": 5
1424
+ "default": 5,
1425
+ "description": "Number of documents to retrieve"
1389
1426
  },
1390
1427
  "similarity_top_k": {
1391
1428
  "type": "integer",
@@ -1395,6 +1432,7 @@
1395
1432
  },
1396
1433
  "tools": {
1397
1434
  "type": "array",
1435
+ "description": "LlamaIndex tools/query modules",
1398
1436
  "items": {
1399
1437
  "type": "object",
1400
1438
  "properties": {
@@ -1416,16 +1454,20 @@
1416
1454
  "properties": {
1417
1455
  "enabled": {
1418
1456
  "type": "boolean",
1419
- "default": false
1457
+ "default": false,
1458
+ "description": "Enable LangGraph integration"
1420
1459
  },
1421
1460
  "graph_name": {
1422
- "type": "string"
1461
+ "type": "string",
1462
+ "description": "LangGraph graph/state machine name"
1423
1463
  },
1424
1464
  "state_schema": {
1425
- "type": "object"
1465
+ "type": "object",
1466
+ "description": "State schema definition (TypedDict structure)"
1426
1467
  },
1427
1468
  "nodes": {
1428
1469
  "type": "array",
1470
+ "description": "Graph nodes configuration",
1429
1471
  "items": {
1430
1472
  "type": "object",
1431
1473
  "properties": {
@@ -1433,13 +1475,15 @@
1433
1475
  "type": "string"
1434
1476
  },
1435
1477
  "function": {
1436
- "type": "string"
1478
+ "type": "string",
1479
+ "description": "Node function name"
1437
1480
  }
1438
1481
  }
1439
1482
  }
1440
1483
  },
1441
1484
  "edges": {
1442
1485
  "type": "array",
1486
+ "description": "Graph edges/transitions",
1443
1487
  "items": {
1444
1488
  "type": "object",
1445
1489
  "properties": {
@@ -1450,13 +1494,15 @@
1450
1494
  "type": "string"
1451
1495
  },
1452
1496
  "condition": {
1453
- "type": "string"
1497
+ "type": "string",
1498
+ "description": "Condition function name (optional)"
1454
1499
  }
1455
1500
  }
1456
1501
  }
1457
1502
  },
1458
1503
  "checkpoint": {
1459
1504
  "type": "object",
1505
+ "description": "Checkpoint configuration for state persistence",
1460
1506
  "properties": {
1461
1507
  "enabled": {
1462
1508
  "type": "boolean",
@@ -1477,7 +1523,8 @@
1477
1523
  "properties": {
1478
1524
  "enabled": {
1479
1525
  "type": "boolean",
1480
- "default": false
1526
+ "default": false,
1527
+ "description": "Enable Anthropic Claude integration"
1481
1528
  },
1482
1529
  "model": {
1483
1530
  "type": "string",
@@ -1488,25 +1535,30 @@
1488
1535
  "claude-3-sonnet-20240229",
1489
1536
  "claude-3-haiku-20240307"
1490
1537
  ],
1491
- "default": "claude-3-5-sonnet-20241022"
1538
+ "default": "claude-3-5-sonnet-20241022",
1539
+ "description": "Claude model version"
1492
1540
  },
1493
1541
  "system": {
1494
- "type": "string"
1542
+ "type": "string",
1543
+ "description": "System prompt (overrides spec.role if provided)"
1495
1544
  },
1496
1545
  "max_tokens": {
1497
1546
  "type": "integer",
1498
1547
  "minimum": 1,
1499
1548
  "maximum": 4096,
1500
- "default": 4096
1549
+ "default": 4096,
1550
+ "description": "Maximum tokens in response"
1501
1551
  },
1502
1552
  "temperature": {
1503
1553
  "type": "number",
1504
1554
  "minimum": 0,
1505
1555
  "maximum": 1,
1506
- "default": 1
1556
+ "default": 1,
1557
+ "description": "Sampling temperature"
1507
1558
  },
1508
1559
  "tools": {
1509
1560
  "type": "array",
1561
+ "description": "Claude tools/capabilities",
1510
1562
  "items": {
1511
1563
  "type": "object",
1512
1564
  "properties": {
@@ -1517,7 +1569,8 @@
1517
1569
  "type": "string"
1518
1570
  },
1519
1571
  "input_schema": {
1520
- "type": "object"
1572
+ "type": "object",
1573
+ "description": "Tool input schema (JSON Schema)"
1521
1574
  }
1522
1575
  },
1523
1576
  "required": ["name", "description", "input_schema"]
@@ -1525,47 +1578,46 @@
1525
1578
  },
1526
1579
  "streaming": {
1527
1580
  "type": "boolean",
1528
- "default": false
1581
+ "default": false,
1582
+ "description": "Enable streaming responses"
1529
1583
  },
1530
1584
  "stop_sequences": {
1531
1585
  "type": "array",
1532
1586
  "items": {
1533
1587
  "type": "string"
1534
- }
1588
+ },
1589
+ "description": "Stop sequences for response generation"
1535
1590
  }
1536
1591
  },
1537
1592
  "additionalProperties": true
1538
1593
  },
1539
1594
  "GoogleADKExtension": {
1540
1595
  "type": "object",
1541
- "description": "Google Agent Development Kit (ADK) integration extension for multi-agent orchestration",
1596
+ "description": "Google Agent Development Kit (ADK) integration extension (v0.2.5)",
1542
1597
  "properties": {
1543
1598
  "enabled": {
1544
1599
  "type": "boolean",
1545
- "default": false
1600
+ "default": false,
1601
+ "description": "Enable Google ADK integration"
1546
1602
  },
1547
1603
  "agent_type": {
1548
1604
  "type": "string",
1549
1605
  "enum": ["llm_agent", "sequential_agent", "parallel_agent", "loop_agent", "custom"],
1606
+ "default": "llm_agent",
1550
1607
  "description": "ADK agent type"
1551
1608
  },
1552
1609
  "model": {
1553
1610
  "type": "string",
1554
- "description": "Gemini model to use (e.g., gemini-2.0-flash-exp)"
1611
+ "description": "Gemini model to use",
1612
+ "examples": ["gemini-2.0-flash-exp", "gemini-1.5-pro"]
1555
1613
  },
1556
1614
  "instruction": {
1557
1615
  "type": "string",
1558
- "description": "Agent instruction/prompt"
1559
- },
1560
- "sub_agents": {
1561
- "type": "array",
1562
- "description": "Sub-agents for orchestration agents",
1563
- "items": {
1564
- "type": "string"
1565
- }
1616
+ "description": "Agent instruction (overrides spec.role if provided)"
1566
1617
  },
1567
1618
  "tools": {
1568
1619
  "type": "array",
1620
+ "description": "ADK tools configuration",
1569
1621
  "items": {
1570
1622
  "type": "object",
1571
1623
  "properties": {
@@ -1574,154 +1626,66 @@
1574
1626
  },
1575
1627
  "type": {
1576
1628
  "type": "string",
1577
- "enum": ["function", "google_search", "code_execution", "custom"]
1629
+ "enum": ["function", "agent", "mcp_server"]
1630
+ },
1631
+ "config": {
1632
+ "type": "object",
1633
+ "additionalProperties": true
1578
1634
  }
1579
1635
  }
1580
1636
  }
1581
1637
  },
1638
+ "sub_agents": {
1639
+ "type": "array",
1640
+ "description": "Sub-agent references for orchestration",
1641
+ "items": {
1642
+ "type": "string"
1643
+ }
1644
+ },
1582
1645
  "session": {
1583
1646
  "type": "object",
1647
+ "description": "Session management configuration",
1584
1648
  "properties": {
1585
1649
  "service": {
1586
1650
  "type": "string",
1587
1651
  "enum": ["in_memory", "database", "vertex_ai"],
1588
1652
  "default": "in_memory"
1653
+ },
1654
+ "state_schema": {
1655
+ "type": "object",
1656
+ "description": "Session state schema"
1589
1657
  }
1590
1658
  }
1591
- }
1592
- },
1593
- "additionalProperties": true
1594
- },
1595
- "MicrosoftAFExtension": {
1596
- "type": "object",
1597
- "description": "Microsoft AutoGen/Magentic-One Agent Framework integration extension",
1598
- "properties": {
1599
- "enabled": {
1600
- "type": "boolean",
1601
- "default": false
1602
- },
1603
- "framework": {
1604
- "type": "string",
1605
- "enum": ["autogen_v0.4", "magentic_one", "semantic_kernel"],
1606
- "default": "autogen_v0.4",
1607
- "description": "Microsoft agent framework variant"
1608
1659
  },
1609
- "team_type": {
1610
- "type": "string",
1611
- "enum": ["round_robin", "selector", "swarm", "magentic_one"],
1612
- "description": "Team orchestration type"
1613
- },
1614
- "agent_type": {
1615
- "type": "string",
1616
- "enum": ["assistant", "code_executor", "user_proxy", "orchestrator", "web_surfer", "file_surfer", "coder"],
1617
- "description": "Agent type within the team"
1618
- },
1619
- "model_client": {
1660
+ "memory": {
1620
1661
  "type": "object",
1662
+ "description": "Memory service configuration",
1621
1663
  "properties": {
1622
- "type": {
1623
- "type": "string",
1624
- "enum": ["openai", "azure_openai", "anthropic"]
1664
+ "enabled": {
1665
+ "type": "boolean",
1666
+ "default": false
1625
1667
  },
1626
- "model": {
1627
- "type": "string"
1628
- }
1629
- }
1630
- },
1631
- "tools": {
1632
- "type": "array",
1633
- "items": {
1634
- "type": "object",
1635
- "properties": {
1636
- "name": {
1637
- "type": "string"
1638
- },
1639
- "type": {
1640
- "type": "string",
1641
- "enum": ["function", "code_executor", "mcp"]
1642
- }
1668
+ "service": {
1669
+ "type": "string",
1670
+ "enum": ["in_memory", "vertex_ai_rag"]
1643
1671
  }
1644
1672
  }
1645
1673
  },
1646
- "termination": {
1674
+ "callbacks": {
1647
1675
  "type": "object",
1676
+ "description": "Lifecycle callbacks",
1648
1677
  "properties": {
1649
- "type": {
1650
- "type": "string",
1651
- "enum": ["text_mention", "max_messages", "token_limit", "custom"]
1678
+ "before_agent_callback": {
1679
+ "type": "string"
1652
1680
  },
1653
- "condition": {
1681
+ "after_agent_callback": {
1654
1682
  "type": "string"
1655
- }
1656
- }
1657
- }
1658
- },
1659
- "additionalProperties": true
1660
- },
1661
- "MetaGPTExtension": {
1662
- "type": "object",
1663
- "description": "MetaGPT multi-agent framework integration extension for software development teams",
1664
- "properties": {
1665
- "enabled": {
1666
- "type": "boolean",
1667
- "default": false
1668
- },
1669
- "role": {
1670
- "type": "string",
1671
- "enum": ["product_manager", "architect", "project_manager", "engineer", "qa_engineer", "custom"],
1672
- "description": "MetaGPT role type"
1673
- },
1674
- "sop": {
1675
- "type": "object",
1676
- "description": "Standard Operating Procedure configuration",
1677
- "properties": {
1678
- "name": {
1679
- "type": "string",
1680
- "description": "SOP name (e.g., 'software_development')"
1681
1683
  },
1682
- "phases": {
1683
- "type": "array",
1684
- "items": {
1685
- "type": "string"
1686
- },
1687
- "description": "SOP phases (e.g., ['requirements', 'design', 'implementation', 'testing'])"
1688
- }
1689
- }
1690
- },
1691
- "actions": {
1692
- "type": "array",
1693
- "description": "MetaGPT actions this agent can perform",
1694
- "items": {
1695
- "type": "object",
1696
- "properties": {
1697
- "name": {
1698
- "type": "string"
1699
- },
1700
- "type": {
1701
- "type": "string"
1702
- }
1703
- }
1704
- }
1705
- },
1706
- "memory": {
1707
- "type": "object",
1708
- "properties": {
1709
- "type": {
1710
- "type": "string",
1711
- "enum": ["role_memory", "team_memory", "long_term"]
1712
- }
1713
- }
1714
- },
1715
- "environment": {
1716
- "type": "object",
1717
- "properties": {
1718
- "workspace": {
1719
- "type": "string",
1720
- "description": "Workspace directory"
1684
+ "before_model_callback": {
1685
+ "type": "string"
1721
1686
  },
1722
- "max_budget": {
1723
- "type": "number",
1724
- "description": "Maximum budget in USD"
1687
+ "after_model_callback": {
1688
+ "type": "string"
1725
1689
  }
1726
1690
  }
1727
1691
  }