@bluefly/openstandardagents 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (371) hide show
  1. package/.env.example +41 -0
  2. package/.eslintrc.cjs +43 -0
  3. package/.github/PULL_REQUEST_TEMPLATE.md +39 -0
  4. package/.github/dependabot.yml +58 -0
  5. package/.github/workflows/ci.yml +154 -0
  6. package/.github/workflows/codeql.yml +41 -0
  7. package/.github/workflows/dependabot-auto-merge.yml +28 -0
  8. package/.github/workflows/release.yml +103 -0
  9. package/.prettierignore +7 -0
  10. package/.prettierrc.json +10 -0
  11. package/.redocly.yaml +9 -0
  12. package/.releaserc.json +84 -0
  13. package/.releaserc.json.disabled +81 -0
  14. package/CHANGELOG.md +152 -0
  15. package/CONTRIBUTING.md +249 -0
  16. package/LICENSE +190 -0
  17. package/README.md +280 -0
  18. package/bin/ossa +8 -0
  19. package/bin/validate-ossa-0.2.2.ts +244 -0
  20. package/dist/di-container.d.ts +18 -0
  21. package/dist/di-container.d.ts.map +1 -0
  22. package/dist/di-container.js +43 -0
  23. package/dist/di-container.js.map +1 -0
  24. package/dist/index.d.ts +13 -0
  25. package/dist/index.d.ts.map +1 -0
  26. package/dist/index.js +17 -0
  27. package/dist/index.js.map +1 -0
  28. package/dist/repositories/manifest.repository.d.ts +26 -0
  29. package/dist/repositories/manifest.repository.d.ts.map +1 -0
  30. package/dist/repositories/manifest.repository.js +90 -0
  31. package/dist/repositories/manifest.repository.js.map +1 -0
  32. package/dist/repositories/schema.repository.d.ts +30 -0
  33. package/dist/repositories/schema.repository.d.ts.map +1 -0
  34. package/dist/repositories/schema.repository.js +143 -0
  35. package/dist/repositories/schema.repository.js.map +1 -0
  36. package/dist/services/generation.service.d.ts +54 -0
  37. package/dist/services/generation.service.d.ts.map +1 -0
  38. package/dist/services/generation.service.js +298 -0
  39. package/dist/services/generation.service.js.map +1 -0
  40. package/dist/services/migration.service.d.ts +30 -0
  41. package/dist/services/migration.service.d.ts.map +1 -0
  42. package/dist/services/migration.service.js +231 -0
  43. package/dist/services/migration.service.js.map +1 -0
  44. package/dist/services/runtime/openai.adapter.d.ts +94 -0
  45. package/dist/services/runtime/openai.adapter.d.ts.map +1 -0
  46. package/dist/services/runtime/openai.adapter.js +209 -0
  47. package/dist/services/runtime/openai.adapter.js.map +1 -0
  48. package/dist/services/validation.service.d.ts +45 -0
  49. package/dist/services/validation.service.d.ts.map +1 -0
  50. package/dist/services/validation.service.js +362 -0
  51. package/dist/services/validation.service.js.map +1 -0
  52. package/dist/services/validators/anthropic.validator.d.ts +9 -0
  53. package/dist/services/validators/anthropic.validator.d.ts.map +1 -0
  54. package/dist/services/validators/anthropic.validator.js +105 -0
  55. package/dist/services/validators/anthropic.validator.js.map +1 -0
  56. package/dist/services/validators/autogen.validator.d.ts +9 -0
  57. package/dist/services/validators/autogen.validator.d.ts.map +1 -0
  58. package/dist/services/validators/autogen.validator.js +111 -0
  59. package/dist/services/validators/autogen.validator.js.map +1 -0
  60. package/dist/services/validators/crewai.validator.d.ts +9 -0
  61. package/dist/services/validators/crewai.validator.d.ts.map +1 -0
  62. package/dist/services/validators/crewai.validator.js +117 -0
  63. package/dist/services/validators/crewai.validator.js.map +1 -0
  64. package/dist/services/validators/cursor.validator.d.ts +9 -0
  65. package/dist/services/validators/cursor.validator.d.ts.map +1 -0
  66. package/dist/services/validators/cursor.validator.js +88 -0
  67. package/dist/services/validators/cursor.validator.js.map +1 -0
  68. package/dist/services/validators/index.d.ts +15 -0
  69. package/dist/services/validators/index.d.ts.map +1 -0
  70. package/dist/services/validators/index.js +15 -0
  71. package/dist/services/validators/index.js.map +1 -0
  72. package/dist/services/validators/langchain.validator.d.ts +9 -0
  73. package/dist/services/validators/langchain.validator.d.ts.map +1 -0
  74. package/dist/services/validators/langchain.validator.js +103 -0
  75. package/dist/services/validators/langchain.validator.js.map +1 -0
  76. package/dist/services/validators/langflow.validator.d.ts +9 -0
  77. package/dist/services/validators/langflow.validator.d.ts.map +1 -0
  78. package/dist/services/validators/langflow.validator.js +92 -0
  79. package/dist/services/validators/langflow.validator.js.map +1 -0
  80. package/dist/services/validators/langgraph.validator.d.ts +9 -0
  81. package/dist/services/validators/langgraph.validator.d.ts.map +1 -0
  82. package/dist/services/validators/langgraph.validator.js +123 -0
  83. package/dist/services/validators/langgraph.validator.js.map +1 -0
  84. package/dist/services/validators/llamaindex.validator.d.ts +9 -0
  85. package/dist/services/validators/llamaindex.validator.d.ts.map +1 -0
  86. package/dist/services/validators/llamaindex.validator.js +121 -0
  87. package/dist/services/validators/llamaindex.validator.js.map +1 -0
  88. package/dist/services/validators/openai.validator.d.ts +9 -0
  89. package/dist/services/validators/openai.validator.d.ts.map +1 -0
  90. package/dist/services/validators/openai.validator.js +126 -0
  91. package/dist/services/validators/openai.validator.js.map +1 -0
  92. package/dist/services/validators/vercel-ai.validator.d.ts +9 -0
  93. package/dist/services/validators/vercel-ai.validator.d.ts.map +1 -0
  94. package/dist/services/validators/vercel-ai.validator.js +99 -0
  95. package/dist/services/validators/vercel-ai.validator.js.map +1 -0
  96. package/dist/spec/v0.1.9/agent-autonomous-extensions.json +234 -0
  97. package/dist/spec/v0.1.9/ecosystem-compliance.json +235 -0
  98. package/dist/spec/v0.1.9/ossa-v0.1.9.schema.json +695 -0
  99. package/dist/spec/v0.1.9/ossa-v0.1.9.schema.json.backup +695 -0
  100. package/dist/spec/v0.1.9/reasoning-compliance.json +654 -0
  101. package/dist/spec/v0.2.2/kagent-enhancements.json +395 -0
  102. package/dist/spec/v0.2.2/ossa-0.2.2.schema.json +906 -0
  103. package/dist/spec/v0.2.2/ossa-0.2.2.yaml +448 -0
  104. package/dist/spec/v0.2.2/ossa-reasoning-compliance-1.0.schema.json +424 -0
  105. package/dist/spec/v0.2.3/CHANGELOG.md +176 -0
  106. package/dist/spec/v0.2.3/README.md +154 -0
  107. package/dist/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +343 -0
  108. package/dist/spec/v0.2.3/ossa-0.2.3.schema.json +1397 -0
  109. package/dist/spec/v0.2.3/ossa-0.2.3.yaml +448 -0
  110. package/dist/spec/v0.2.4-dev/CHANGELOG.md +403 -0
  111. package/dist/spec/v0.2.4-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  112. package/dist/spec/v0.2.4-dev/ossa-0.2.4-dev.schema.json +1696 -0
  113. package/dist/spec/v0.2.4-dev/ossa-0.2.4-dev.yaml +581 -0
  114. package/dist/spec/v0.2.5-dev/CHANGELOG.md +171 -0
  115. package/dist/spec/v0.2.5-dev/examples/customer-support-graph.ossa.yaml +362 -0
  116. package/dist/spec/v0.2.5-dev/examples/parallel-processors.ossa.yaml +464 -0
  117. package/dist/spec/v0.2.5-dev/examples/research-team.ossa.yaml +440 -0
  118. package/dist/spec/v0.2.5-dev/migrations/v0.2.4-to-v0.2.5.md +317 -0
  119. package/dist/spec/v0.2.5-dev/ossa-0.2.5-dev.schema.json +1732 -0
  120. package/dist/spec/v0.2.5-dev/ossa-0.2.5-dev.yaml +409 -0
  121. package/dist/types/index.d.ts +178 -0
  122. package/dist/types/index.d.ts.map +1 -0
  123. package/dist/types/index.js +6 -0
  124. package/dist/types/index.js.map +1 -0
  125. package/dist/types/openapi-extensions.d.ts +164 -0
  126. package/dist/types/openapi-extensions.d.ts.map +1 -0
  127. package/dist/types/openapi-extensions.js +6 -0
  128. package/dist/types/openapi-extensions.js.map +1 -0
  129. package/docs/OSSA-COMPLIANT-BADGE.md +248 -0
  130. package/docs/README.md +31 -0
  131. package/docs/VERSIONING.md +284 -0
  132. package/docs/agent-openapi-spec.yml +942 -0
  133. package/docs/getting-started.md +87 -0
  134. package/docs/migration/general-agent-schema.yml +255 -0
  135. package/docs/migration/migration-manifest.json +64 -0
  136. package/docs/openapi-extensions.md +930 -0
  137. package/docs/schemas/openapi-extensions.schema.json +486 -0
  138. package/examples/adk-integration/code-review-workflow.yml +136 -0
  139. package/examples/adk-integration/customer-support.yml +263 -0
  140. package/examples/adk-integration/data-pipeline.yml +173 -0
  141. package/examples/advanced/patterns/compliance-context-production.json +53 -0
  142. package/examples/advanced/patterns/model-router.ts +274 -0
  143. package/examples/advanced/patterns/smart-model-routing.ts +248 -0
  144. package/examples/advanced/workflows/hybrid-model-strategy.yaml +232 -0
  145. package/examples/agent-manifests/critics/critic-agent.yaml +149 -0
  146. package/examples/agent-manifests/governors/governor-agent.yaml +128 -0
  147. package/examples/agent-manifests/integrators/integrator-agent.yaml +103 -0
  148. package/examples/agent-manifests/judges/judge-agent.yaml +153 -0
  149. package/examples/agent-manifests/monitors/monitor-agent.yaml +122 -0
  150. package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml +247 -0
  151. package/examples/agent-manifests/sample-compliant-agent.yaml +147 -0
  152. package/examples/agent-manifests/workers/worker-agent.yaml +82 -0
  153. package/examples/anthropic/claude-assistant.ossa.json +45 -0
  154. package/examples/architecture/model-configuration/ollama-integration.ts +110 -0
  155. package/examples/autogen/multi-agent.ossa.json +37 -0
  156. package/examples/bridge-configurations.yaml +346 -0
  157. package/examples/bridges/Dockerfile.production +87 -0
  158. package/examples/bridges/__pycache__/aiflow-bridge-enhanced.cpython-313.pyc +0 -0
  159. package/examples/bridges/__pycache__/aiflow-phoenix-tracing.cpython-313.pyc +0 -0
  160. package/examples/bridges/__pycache__/test_aiflow_integration.cpython-313.pyc +0 -0
  161. package/examples/bridges/aiflow-bridge-enhanced.py +462 -0
  162. package/examples/bridges/aiflow-bridge-example.yml +310 -0
  163. package/examples/bridges/aiflow-phoenix-tracing.py +310 -0
  164. package/examples/bridges/aiflow-registration-api.openapi.yml +439 -0
  165. package/examples/bridges/k8s/configmap.yaml +121 -0
  166. package/examples/bridges/k8s/deployment-simple.yaml +34 -0
  167. package/examples/bridges/k8s/deployment.yaml +275 -0
  168. package/examples/bridges/k8s/hpa.yaml +126 -0
  169. package/examples/bridges/k8s/ingress.yaml +155 -0
  170. package/examples/bridges/kagent-bridge-example.yml +94 -0
  171. package/examples/bridges/load-tests/Dockerfile +28 -0
  172. package/examples/bridges/load-tests/k6-load-test.js +302 -0
  173. package/examples/bridges/load-tests/requirements.txt +20 -0
  174. package/examples/bridges/loadtest/k6-scenarios.js +270 -0
  175. package/examples/bridges/phase4/SLO-SLA.yaml +249 -0
  176. package/examples/bridges/phase4/chaos-tests.yaml +226 -0
  177. package/examples/bridges/requirements.txt +24 -0
  178. package/examples/bridges/test_aiflow_integration.py +341 -0
  179. package/examples/common_npm/agent-router.ossa.yaml +182 -0
  180. package/examples/common_npm/agent-router.v0.2.2.ossa.yaml +60 -0
  181. package/examples/compliance-agent.yml +155 -0
  182. package/examples/crewai/research-team.ossa.json +36 -0
  183. package/examples/cursor/code-review-agent.ossa.json +47 -0
  184. package/examples/drupal/gitlab-ml-recommender.ossa.yaml +609 -0
  185. package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml +68 -0
  186. package/examples/enterprise/agent.yml +452 -0
  187. package/examples/extensions/drupal-v1.yml +266 -0
  188. package/examples/extensions/kagent-v1.yml +167 -0
  189. package/examples/getting-started/hello-world-complete.ossa.yaml +266 -0
  190. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +376 -0
  191. package/examples/kagent/README.md +31 -0
  192. package/examples/kagent/compliance-validator.ossa.yaml +111 -0
  193. package/examples/kagent/cost-optimizer.ossa.yaml +93 -0
  194. package/examples/kagent/documentation-agent.ossa.yaml +91 -0
  195. package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml +269 -0
  196. package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml +106 -0
  197. package/examples/kagent/k8s-troubleshooter.ossa.yaml +257 -0
  198. package/examples/kagent/security-scanner.ossa.yaml +140 -0
  199. package/examples/langchain/chain-agent.ossa.json +42 -0
  200. package/examples/langflow/workflow-agent.ossa.json +39 -0
  201. package/examples/langgraph/state-machine-agent.ossa.json +59 -0
  202. package/examples/llamaindex/rag-agent.ossa.json +41 -0
  203. package/examples/migration-guides/from-langchain-to-ossa.yaml +309 -0
  204. package/examples/minimal/agent.yml +152 -0
  205. package/examples/minimal/openapi.yaml +95 -0
  206. package/examples/openai/swarm-agent.ossa.json +59 -0
  207. package/examples/openapi-extensions/README.md +87 -0
  208. package/examples/openapi-extensions/minimal-agent-api.openapi.yml +288 -0
  209. package/examples/openapi-extensions/orchestrator-agent-api.openapi.yml +633 -0
  210. package/examples/openapi-extensions/worker-agent-api.openapi.yml +533 -0
  211. package/examples/production/agent.yml +713 -0
  212. package/examples/production/document-analyzer-openai.yml +134 -0
  213. package/examples/quickstart/support-agent.ossa.yaml +59 -0
  214. package/examples/service-registry-usage.ts +423 -0
  215. package/examples/spec-examples/audit-agent.yml +147 -0
  216. package/examples/spec-examples/chat-agent.yml +189 -0
  217. package/examples/spec-examples/compliance-agent.yml +204 -0
  218. package/examples/spec-examples/data-processing-agent.yml +132 -0
  219. package/examples/spec-examples/development-agent.yml +138 -0
  220. package/examples/spec-examples/edge-agent.yml +101 -0
  221. package/examples/spec-examples/integration-agent.yml +129 -0
  222. package/examples/spec-examples/monitoring-agent.yml +130 -0
  223. package/examples/spec-examples/serverless-agent.yml +82 -0
  224. package/examples/spec-examples/workflow-agent.yml +223 -0
  225. package/examples/templates/ossa-compliance.yaml +56 -0
  226. package/examples/typescript/advanced/demo-registry.ts +168 -0
  227. package/examples/typescript/mcpb-agent-example.ts +358 -0
  228. package/examples/vercel/edge-agent.ossa.json +43 -0
  229. package/infrastructure/docker-compose.yml +33 -0
  230. package/junit.xml +1 -0
  231. package/openapi/drupal-agent-api.openapi.yaml +348 -0
  232. package/openapi/gitlab-orchestrator.openapi.yaml +330 -0
  233. package/openapi/helm-generator.openapi.yaml +389 -0
  234. package/openapi/ossa-core-api.openapi.yaml +1448 -0
  235. package/openapi/ossa-registry-api.openapi.yaml +980 -0
  236. package/openapi/ossa-registry.openapi.yaml +782 -0
  237. package/openapi/self-evolving-ecosystem.openapi.yaml +1530 -0
  238. package/openapi/unified-agent-gateway.openapi.yaml +833 -0
  239. package/ossa-website-swarm-tasks.json +105 -0
  240. package/package.json +132 -0
  241. package/release.config.js +64 -0
  242. package/spec/v0.1.9/agent-autonomous-extensions.json +234 -0
  243. package/spec/v0.1.9/ecosystem-compliance.json +235 -0
  244. package/spec/v0.1.9/ossa-v0.1.9.schema.json +695 -0
  245. package/spec/v0.1.9/ossa-v0.1.9.schema.json.backup +695 -0
  246. package/spec/v0.1.9/reasoning-compliance.json +654 -0
  247. package/spec/v0.2.2/kagent-enhancements.json +395 -0
  248. package/spec/v0.2.2/ossa-0.2.2.schema.json +906 -0
  249. package/spec/v0.2.2/ossa-0.2.2.yaml +448 -0
  250. package/spec/v0.2.2/ossa-reasoning-compliance-1.0.schema.json +424 -0
  251. package/spec/v0.2.3/CHANGELOG.md +176 -0
  252. package/spec/v0.2.3/README.md +154 -0
  253. package/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +343 -0
  254. package/spec/v0.2.3/ossa-0.2.3.schema.json +1397 -0
  255. package/spec/v0.2.3/ossa-0.2.3.yaml +448 -0
  256. package/spec/v0.2.4-dev/CHANGELOG.md +403 -0
  257. package/spec/v0.2.4-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  258. package/spec/v0.2.4-dev/ossa-0.2.4-dev.schema.json +1696 -0
  259. package/spec/v0.2.4-dev/ossa-0.2.4-dev.yaml +581 -0
  260. package/spec/v0.2.5-dev/CHANGELOG.md +171 -0
  261. package/spec/v0.2.5-dev/examples/customer-support-graph.ossa.yaml +362 -0
  262. package/spec/v0.2.5-dev/examples/parallel-processors.ossa.yaml +464 -0
  263. package/spec/v0.2.5-dev/examples/research-team.ossa.yaml +440 -0
  264. package/spec/v0.2.5-dev/migrations/v0.2.4-to-v0.2.5.md +317 -0
  265. package/spec/v0.2.5-dev/ossa-0.2.5-dev.schema.json +1732 -0
  266. package/spec/v0.2.5-dev/ossa-0.2.5-dev.yaml +409 -0
  267. package/test-results.xml +1 -0
  268. package/website/.lighthouserc.js +20 -0
  269. package/website/.prettierrc +10 -0
  270. package/website/Dockerfile +17 -0
  271. package/website/app/about/page.tsx +295 -0
  272. package/website/app/api/validate/route.ts +88 -0
  273. package/website/app/blog/[slug]/page.tsx +167 -0
  274. package/website/app/blog/page.tsx +162 -0
  275. package/website/app/docs/[[...slug]]/page.tsx +349 -0
  276. package/website/app/docs/core-concepts/project-structure/page.tsx +349 -0
  277. package/website/app/ecosystem/page.tsx +375 -0
  278. package/website/app/examples/page.tsx +123 -0
  279. package/website/app/globals.css +108 -0
  280. package/website/app/layout.tsx +106 -0
  281. package/website/app/page.tsx +409 -0
  282. package/website/app/playground/page.tsx +507 -0
  283. package/website/app/robots.ts +19 -0
  284. package/website/app/rss.xml/route.ts +74 -0
  285. package/website/app/schema/page.tsx +970 -0
  286. package/website/app/sitemap.ts +56 -0
  287. package/website/app/specification/page.tsx +211 -0
  288. package/website/components/InstallCommand.tsx +96 -0
  289. package/website/components/Logo.tsx +24 -0
  290. package/website/components/StructuredData.tsx +65 -0
  291. package/website/components/docs/DocsSearch.tsx +104 -0
  292. package/website/components/docs/DocsSidebar.tsx +118 -0
  293. package/website/components/docs/MarkdownContent.tsx +183 -0
  294. package/website/components/docs/VersionSelector.tsx +49 -0
  295. package/website/components/examples/ExamplesViewer.tsx +293 -0
  296. package/website/components/layout/Footer.tsx +111 -0
  297. package/website/components/layout/Header.tsx +170 -0
  298. package/website/components/schema/SchemaExplorer.tsx +213 -0
  299. package/website/content/blog/OpenAPI-AI-Agents-Standard.md +285 -0
  300. package/website/content/blog/Why-Formal-Standards-Matter-Now.md +209 -0
  301. package/website/content/blog/introducing-ossa-framework.md +328 -0
  302. package/website/content/blog/ossa-production-results.md +279 -0
  303. package/website/content/blog/welcome-to-ossa.md +43 -0
  304. package/website/content/blog/why-ai-agents-need-open-standard.md +98 -0
  305. package/website/content/docs/00-HOME.md +160 -0
  306. package/website/content/docs/AIFlow-Framework-Integration-with-OSSA.md +107 -0
  307. package/website/content/docs/OpenAPI-Extensions.md +498 -0
  308. package/website/content/docs/architecture/execution-flow.md +335 -0
  309. package/website/content/docs/architecture/multi-agent-systems.md +737 -0
  310. package/website/content/docs/architecture/overview.md +121 -0
  311. package/website/content/docs/architecture/stack-integration.md +461 -0
  312. package/website/content/docs/changelog.md +246 -0
  313. package/website/content/docs/contributing.md +599 -0
  314. package/website/content/docs/core-concepts/project-structure.md +348 -0
  315. package/website/content/docs/ecosystem/framework-support.md +821 -0
  316. package/website/content/docs/ecosystem/overview.md +366 -0
  317. package/website/content/docs/examples/Migration-Guides.md +214 -0
  318. package/website/content/docs/examples.md +71 -0
  319. package/website/content/docs/for-audiences/Enterprises.md +256 -0
  320. package/website/content/docs/for-audiences/Students-Researchers.md +122 -0
  321. package/website/content/docs/for-audiences/architects.md +224 -0
  322. package/website/content/docs/for-audiences/developers.md +220 -0
  323. package/website/content/docs/getting-started/5-minute-overview.md +85 -0
  324. package/website/content/docs/getting-started/Hello-World.md +184 -0
  325. package/website/content/docs/getting-started/first-agent.md +196 -0
  326. package/website/content/docs/getting-started/installation.md +155 -0
  327. package/website/content/docs/getting-started/running-agents.md +107 -0
  328. package/website/content/docs/integrations/aiflow.md +104 -0
  329. package/website/content/docs/integrations/drupal.md +105 -0
  330. package/website/content/docs/migration-guides/00-index.md +76 -0
  331. package/website/content/docs/migration-guides/README.md +133 -0
  332. package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +1750 -0
  333. package/website/content/docs/migration-guides/crewai-to-ossa.md +274 -0
  334. package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +2017 -0
  335. package/website/content/docs/migration-guides/index.md +133 -0
  336. package/website/content/docs/migration-guides/langchain-to-ossa.md +1714 -0
  337. package/website/content/docs/migration-guides/langflow-to-ossa.md +2075 -0
  338. package/website/content/docs/migration-guides/openai-to-ossa.md +1202 -0
  339. package/website/content/docs/openapi-extensions/examples.md +550 -0
  340. package/website/content/docs/openapi-extensions/index.md +495 -0
  341. package/website/content/docs/openapi-extensions/operation-extensions.md +398 -0
  342. package/website/content/docs/openapi-extensions/root-extensions.md +364 -0
  343. package/website/content/docs/pre-release/index.md +175 -0
  344. package/website/content/docs/quick-reference.md +17 -0
  345. package/website/content/docs/schema-reference/agent-spec.md +406 -0
  346. package/website/content/docs/schema-reference/autonomy.md +568 -0
  347. package/website/content/docs/schema-reference/constraints.md +543 -0
  348. package/website/content/docs/schema-reference/index.md +176 -0
  349. package/website/content/docs/schema-reference/llm-config.md +445 -0
  350. package/website/content/docs/schema-reference/observability.md +654 -0
  351. package/website/content/docs/schema-reference/ossa-manifest.md +309 -0
  352. package/website/content/docs/schema-reference/taxonomy.md +509 -0
  353. package/website/content/docs/schema-reference/tools.md +628 -0
  354. package/website/content/docs/templates/blog-post.md +43 -0
  355. package/website/content/docs/use-cases/00-index.md +395 -0
  356. package/website/content/docs/use-cases/cicd-code-review.md +1236 -0
  357. package/website/content/docs/use-cases/customer-support.md +1234 -0
  358. package/website/content/docs/use-cases/enterprise-compliance.md +1208 -0
  359. package/website/content/docs/use-cases/research-multi-agent.md +1161 -0
  360. package/website/lib/version.ts +18 -0
  361. package/website/next.config.js +17 -0
  362. package/website/next.config.ts +16 -0
  363. package/website/nginx.conf +32 -0
  364. package/website/package-lock.json +9145 -0
  365. package/website/package.json +53 -0
  366. package/website/postcss.config.js +7 -0
  367. package/website/postcss.config.mjs +9 -0
  368. package/website/scripts/sync-version.js +44 -0
  369. package/website/scripts/sync-wiki.ts +261 -0
  370. package/website/tailwind.config.js +58 -0
  371. package/website/tailwind.config.ts +65 -0
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Migration Service
3
+ * Migrates OSSA manifests between versions (v0.1.9 to v0.2.2, legacy formats to v0.2.2)
4
+ */
5
+ import type { SchemaVersion } from '../types/index.js';
6
+ export declare class MigrationService {
7
+ /**
8
+ * Migrate manifest to target version
9
+ * @param manifest - Source manifest
10
+ * @param targetVersion - Target version
11
+ * @returns Migrated manifest
12
+ */
13
+ migrate(manifest: unknown, targetVersion?: SchemaVersion): Promise<any>;
14
+ /**
15
+ * Migrate v1.0 manifest to v0.2.2
16
+ */
17
+ private migrateV1ToV022;
18
+ private detectDomain;
19
+ private detectSubdomain;
20
+ private detectCapability;
21
+ /**
22
+ * Migrate multiple manifests
23
+ */
24
+ migrateMany(manifests: unknown[], targetVersion?: SchemaVersion): Promise<any[]>;
25
+ /**
26
+ * Check if manifest needs migration
27
+ */
28
+ needsMigration(manifest: unknown): boolean;
29
+ }
30
+ //# sourceMappingURL=migration.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migration.service.d.ts","sourceRoot":"","sources":["../../src/services/migration.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgCvD,qBACa,gBAAgB;IAC3B;;;;;OAKG;IACG,OAAO,CACX,QAAQ,EAAE,OAAO,EACjB,aAAa,GAAE,aAAuB,GACrC,OAAO,CAAC,GAAG,CAAC;IAsBf;;OAEG;IACH,OAAO,CAAC,eAAe;IAsJvB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,OAAO,EAAE,EACpB,aAAa,GAAE,aAAuB,GACrC,OAAO,CAAC,GAAG,EAAE,CAAC;IAIjB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;CAI3C"}
@@ -0,0 +1,231 @@
1
+ /**
2
+ * Migration Service
3
+ * Migrates OSSA manifests between versions (v0.1.9 to v0.2.2, legacy formats to v0.2.2)
4
+ */
5
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
6
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
7
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
8
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
9
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
10
+ };
11
+ import { injectable } from 'inversify';
12
+ let MigrationService = class MigrationService {
13
+ /**
14
+ * Migrate manifest to target version
15
+ * @param manifest - Source manifest
16
+ * @param targetVersion - Target version
17
+ * @returns Migrated manifest
18
+ */
19
+ async migrate(manifest, targetVersion = '0.2.2') {
20
+ const m = manifest;
21
+ // Detect source version
22
+ if (m.apiVersion === 'ossa/v1' && m.kind === 'Agent') {
23
+ // Already v0.2.2 format
24
+ return manifest;
25
+ }
26
+ if (m.ossaVersion === '1.0' && m.agent) {
27
+ // v1.0 to v0.2.2
28
+ return this.migrateV1ToV022(m);
29
+ }
30
+ if (m.apiVersion && m.kind && m.metadata && m.spec) {
31
+ // Already in v0₁.9/v0.2.2 format, just return
32
+ return manifest;
33
+ }
34
+ throw new Error('Unsupported manifest format');
35
+ }
36
+ /**
37
+ * Migrate v1.0 manifest to v0.2.2
38
+ */
39
+ migrateV1ToV022(v1) {
40
+ const migrated = {
41
+ apiVersion: 'ossa/v1',
42
+ kind: 'Agent',
43
+ metadata: {
44
+ name: v1.agent.id,
45
+ version: v1.agent.version || '0.1.0',
46
+ description: v1.agent.description || '',
47
+ labels: {},
48
+ annotations: {
49
+ 'ossa.io/migration': 'v1.0 to v0.2.2',
50
+ 'ossa.io/migrated-date': new Date().toISOString().split('T')[0],
51
+ },
52
+ },
53
+ spec: {
54
+ role: v1.agent.role,
55
+ },
56
+ };
57
+ // Convert tags to labels
58
+ if (v1.agent.tags && Array.isArray(v1.agent.tags)) {
59
+ v1.agent.tags.forEach((tag) => {
60
+ migrated.metadata.labels[tag] = 'true';
61
+ });
62
+ }
63
+ // Copy metadata
64
+ if (v1.metadata) {
65
+ if (v1.metadata.authors) {
66
+ migrated.metadata.annotations.author = Array.isArray(v1.metadata.authors)
67
+ ? v1.metadata.authors.join(', ')
68
+ : v1.metadata.authors;
69
+ }
70
+ if (v1.metadata.license) {
71
+ migrated.metadata.annotations.license = v1.metadata.license;
72
+ }
73
+ if (v1.metadata.repository) {
74
+ migrated.metadata.annotations.repository = v1.metadata.repository;
75
+ }
76
+ }
77
+ // Detect taxonomy
78
+ migrated.spec.taxonomy = {
79
+ domain: this.detectDomain(v1.agent),
80
+ subdomain: this.detectSubdomain(v1.agent),
81
+ capability: this.detectCapability(v1.agent),
82
+ };
83
+ // Convert LLM config with normalization
84
+ if (v1.agent.llm) {
85
+ migrated.spec.llm = {
86
+ provider: v1.agent.llm.provider === 'auto' ? 'openai' : v1.agent.llm.provider,
87
+ model: v1.agent.llm.model,
88
+ temperature: v1.agent.llm.temperature,
89
+ maxTokens: v1.agent.llm.maxTokens,
90
+ topP: v1.agent.llm.topP,
91
+ frequencyPenalty: v1.agent.llm.frequencyPenalty,
92
+ presencePenalty: v1.agent.llm.presencePenalty,
93
+ };
94
+ }
95
+ // Convert capabilities to tools
96
+ if (v1.agent.capabilities && Array.isArray(v1.agent.capabilities)) {
97
+ migrated.spec.tools = v1.agent.capabilities.map((cap) => ({
98
+ type: 'mcp',
99
+ name: cap.name || 'unnamed_tool',
100
+ server: v1.agent.integration?.mcp?.server_name || migrated.metadata.name,
101
+ }));
102
+ }
103
+ // Convert autonomy, constraints
104
+ if (v1.agent.autonomy)
105
+ migrated.spec.autonomy = v1.agent.autonomy;
106
+ if (v1.agent.constraints)
107
+ migrated.spec.constraints = v1.agent.constraints;
108
+ // Handle observability with proper structure
109
+ if (v1.agent.observability || v1.agent.monitoring) {
110
+ const obs = v1.agent.observability || v1.agent.monitoring;
111
+ let normalizedMetrics = obs.metrics;
112
+ if (normalizedMetrics === true) {
113
+ normalizedMetrics = { enabled: true };
114
+ }
115
+ else if (!normalizedMetrics || typeof normalizedMetrics !== 'object') {
116
+ normalizedMetrics = { enabled: true };
117
+ }
118
+ if (obs.tracing || normalizedMetrics || obs.logging) {
119
+ migrated.spec.observability = {
120
+ tracing: obs.tracing || { enabled: true },
121
+ metrics: normalizedMetrics,
122
+ logging: obs.logging || { level: 'info', format: 'json' },
123
+ };
124
+ }
125
+ }
126
+ // Create extensions section
127
+ migrated.spec.extensions = {};
128
+ // MCP extension
129
+ if (v1.agent.integration?.mcp) {
130
+ migrated.spec.extensions.mcp = {
131
+ enabled: v1.agent.integration.mcp.enabled !== false,
132
+ server_type: v1.agent.integration.mcp.protocol ||
133
+ v1.agent.integration.mcp.server_type ||
134
+ 'stdio',
135
+ };
136
+ }
137
+ // Buildkit extension
138
+ if (v1.agent.deployment || v1.agent.runtime) {
139
+ migrated.spec.extensions.buildkit = {
140
+ deployment: {
141
+ replicas: v1.agent.deployment?.replicas || { min: 1, max: 4 },
142
+ },
143
+ container: {
144
+ image: v1.agent.runtime?.image,
145
+ runtime: v1.agent.runtime?.type || 'docker',
146
+ resources: v1.agent.runtime?.resources || {},
147
+ },
148
+ };
149
+ }
150
+ // kagent extension
151
+ if (v1.agent.runtime?.type === 'k8s') {
152
+ migrated.spec.extensions.kagent = {
153
+ kubernetes: {
154
+ namespace: 'default',
155
+ labels: { app: migrated.metadata.name },
156
+ },
157
+ deployment: { replicas: 2, strategy: 'rolling-update' },
158
+ };
159
+ }
160
+ // Runtime extension
161
+ if (v1.agent.runtime) {
162
+ migrated.spec.extensions.runtime = v1.agent.runtime;
163
+ }
164
+ // Integration extension
165
+ if (v1.agent.integration) {
166
+ migrated.spec.extensions.integration = v1.agent.integration;
167
+ }
168
+ return migrated;
169
+ }
170
+ detectDomain(agent) {
171
+ const text = [
172
+ agent.id,
173
+ agent.name,
174
+ agent.description,
175
+ ...(agent.tags || []),
176
+ ]
177
+ .join(' ')
178
+ .toLowerCase();
179
+ if (text.includes('infrastructure') || text.includes('k8s'))
180
+ return 'infrastructure';
181
+ if (text.includes('security') || text.includes('compliance'))
182
+ return 'security';
183
+ if (text.includes('data') || text.includes('vector'))
184
+ return 'data';
185
+ if (text.includes('chat'))
186
+ return 'conversation';
187
+ if (text.includes('workflow'))
188
+ return 'automation';
189
+ return 'integration';
190
+ }
191
+ detectSubdomain(agent) {
192
+ const text = [agent.id, agent.name].join(' ').toLowerCase();
193
+ if (text.includes('kubernetes') || text.includes('k8s'))
194
+ return 'kubernetes';
195
+ if (text.includes('protocol') || text.includes('mcp'))
196
+ return 'protocol';
197
+ if (text.includes('workflow'))
198
+ return 'workflow';
199
+ return 'general';
200
+ }
201
+ detectCapability(agent) {
202
+ const text = [agent.id, agent.name].join(' ').toLowerCase();
203
+ if (text.includes('troubleshoot'))
204
+ return 'troubleshooting';
205
+ if (text.includes('monitor'))
206
+ return 'monitoring';
207
+ if (text.includes('route'))
208
+ return 'routing';
209
+ if (text.includes('search'))
210
+ return 'search';
211
+ return 'general';
212
+ }
213
+ /**
214
+ * Migrate multiple manifests
215
+ */
216
+ async migrateMany(manifests, targetVersion = '0.2.2') {
217
+ return Promise.all(manifests.map((m) => this.migrate(m, targetVersion)));
218
+ }
219
+ /**
220
+ * Check if manifest needs migration
221
+ */
222
+ needsMigration(manifest) {
223
+ const m = manifest;
224
+ return !!(m.ossaVersion === '1.0' && m.agent);
225
+ }
226
+ };
227
+ MigrationService = __decorate([
228
+ injectable()
229
+ ], MigrationService);
230
+ export { MigrationService };
231
+ //# sourceMappingURL=migration.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migration.service.js","sourceRoot":"","sources":["../../src/services/migration.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,94 @@
1
+ /**
2
+ * OpenAI Runtime Adapter
3
+ * Runs OSSA agents using OpenAI's function calling API
4
+ */
5
+ export interface OssaManifest {
6
+ apiVersion: string;
7
+ kind: string;
8
+ metadata: {
9
+ name: string;
10
+ version?: string;
11
+ description?: string;
12
+ };
13
+ spec: {
14
+ role: string;
15
+ llm?: {
16
+ provider: string;
17
+ model: string;
18
+ temperature?: number;
19
+ maxTokens?: number;
20
+ };
21
+ tools?: Array<{
22
+ type: string;
23
+ name?: string;
24
+ capabilities?: string[];
25
+ config?: Record<string, unknown>;
26
+ }>;
27
+ };
28
+ extensions?: {
29
+ openai_agents?: {
30
+ model?: string;
31
+ instructions?: string;
32
+ tools_mapping?: Array<{
33
+ ossa_capability: string;
34
+ openai_tool_name?: string;
35
+ description?: string;
36
+ parameters?: Record<string, unknown>;
37
+ }>;
38
+ };
39
+ };
40
+ }
41
+ export interface RunOptions {
42
+ verbose?: boolean;
43
+ maxTurns?: number;
44
+ }
45
+ export interface ToolDefinition {
46
+ name: string;
47
+ description: string;
48
+ parameters: Record<string, unknown>;
49
+ handler?: (args: Record<string, unknown>) => Promise<string>;
50
+ }
51
+ export declare class OpenAIAdapter {
52
+ private client;
53
+ private manifest;
54
+ private tools;
55
+ private messages;
56
+ constructor(manifest: OssaManifest, apiKey?: string);
57
+ /**
58
+ * Get the model to use from manifest
59
+ */
60
+ private getModel;
61
+ /**
62
+ * Get system prompt from manifest
63
+ */
64
+ private getSystemPrompt;
65
+ /**
66
+ * Convert OSSA tools to OpenAI function calling format
67
+ */
68
+ private getOpenAITools;
69
+ /**
70
+ * Register a tool handler
71
+ */
72
+ registerToolHandler(name: string, handler: (args: Record<string, unknown>) => Promise<string>): void;
73
+ /**
74
+ * Execute a tool call
75
+ */
76
+ private executeTool;
77
+ /**
78
+ * Initialize the conversation
79
+ */
80
+ initialize(): void;
81
+ /**
82
+ * Send a message and get a response
83
+ */
84
+ chat(userMessage: string, options?: RunOptions): Promise<string>;
85
+ /**
86
+ * Get agent info
87
+ */
88
+ getAgentInfo(): {
89
+ name: string;
90
+ model: string;
91
+ tools: string[];
92
+ };
93
+ }
94
+ //# sourceMappingURL=openai.adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openai.adapter.d.ts","sourceRoot":"","sources":["../../../src/services/runtime/openai.adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE;YACJ,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,KAAK,CAAC,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAClC,CAAC,CAAC;KACJ,CAAC;IACF,UAAU,CAAC,EAAE;QACX,aAAa,CAAC,EAAE;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,aAAa,CAAC,EAAE,KAAK,CAAC;gBACpB,eAAe,EAAE,MAAM,CAAC;gBACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aACtC,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,QAAQ,CAAoC;gBAExC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM;IAOnD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAahB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,cAAc;IA2DtB;;OAEG;IACH,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAC1D,IAAI;IAOP;;OAEG;YACW,WAAW;IAqBzB;;OAEG;IACH,UAAU,IAAI,IAAI;IASlB;;OAEG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAwEtE;;OAEG;IACH,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;CAOjE"}
@@ -0,0 +1,209 @@
1
+ /**
2
+ * OpenAI Runtime Adapter
3
+ * Runs OSSA agents using OpenAI's function calling API
4
+ */
5
+ import OpenAI from 'openai';
6
+ export class OpenAIAdapter {
7
+ client;
8
+ manifest;
9
+ tools = new Map();
10
+ messages = [];
11
+ constructor(manifest, apiKey) {
12
+ this.manifest = manifest;
13
+ this.client = new OpenAI({
14
+ apiKey: apiKey || process.env.OPENAI_API_KEY,
15
+ });
16
+ }
17
+ /**
18
+ * Get the model to use from manifest
19
+ */
20
+ getModel() {
21
+ // Check OpenAI extension first
22
+ if (this.manifest.extensions?.openai_agents?.model) {
23
+ return this.manifest.extensions.openai_agents.model;
24
+ }
25
+ // Fall back to LLM config
26
+ if (this.manifest.spec.llm?.model) {
27
+ return this.manifest.spec.llm.model;
28
+ }
29
+ // Default
30
+ return 'gpt-4o-mini';
31
+ }
32
+ /**
33
+ * Get system prompt from manifest
34
+ */
35
+ getSystemPrompt() {
36
+ // Check OpenAI extension first
37
+ if (this.manifest.extensions?.openai_agents?.instructions) {
38
+ return this.manifest.extensions.openai_agents.instructions;
39
+ }
40
+ // Fall back to role
41
+ return this.manifest.spec.role;
42
+ }
43
+ /**
44
+ * Convert OSSA tools to OpenAI function calling format
45
+ */
46
+ getOpenAITools() {
47
+ const openaiTools = [];
48
+ // Check for tools_mapping in OpenAI extension
49
+ const toolsMapping = this.manifest.extensions?.openai_agents?.tools_mapping;
50
+ if (toolsMapping) {
51
+ for (const mapping of toolsMapping) {
52
+ const toolDef = {
53
+ name: mapping.openai_tool_name || mapping.ossa_capability,
54
+ description: mapping.description || `Execute ${mapping.ossa_capability}`,
55
+ parameters: mapping.parameters || {
56
+ type: 'object',
57
+ properties: {},
58
+ required: [],
59
+ },
60
+ };
61
+ this.tools.set(toolDef.name, toolDef);
62
+ openaiTools.push({
63
+ type: 'function',
64
+ function: {
65
+ name: toolDef.name,
66
+ description: toolDef.description,
67
+ parameters: toolDef.parameters,
68
+ },
69
+ });
70
+ }
71
+ }
72
+ // Also check spec.tools for basic tool definitions
73
+ if (this.manifest.spec.tools) {
74
+ for (const tool of this.manifest.spec.tools) {
75
+ if (tool.name && !this.tools.has(tool.name)) {
76
+ const toolDef = {
77
+ name: tool.name,
78
+ description: `Execute ${tool.name} (${tool.type})`,
79
+ parameters: {
80
+ type: 'object',
81
+ properties: {},
82
+ required: [],
83
+ },
84
+ };
85
+ this.tools.set(tool.name, toolDef);
86
+ openaiTools.push({
87
+ type: 'function',
88
+ function: {
89
+ name: tool.name,
90
+ description: toolDef.description,
91
+ parameters: toolDef.parameters,
92
+ },
93
+ });
94
+ }
95
+ }
96
+ }
97
+ return openaiTools;
98
+ }
99
+ /**
100
+ * Register a tool handler
101
+ */
102
+ registerToolHandler(name, handler) {
103
+ const tool = this.tools.get(name);
104
+ if (tool) {
105
+ tool.handler = handler;
106
+ }
107
+ }
108
+ /**
109
+ * Execute a tool call
110
+ */
111
+ async executeTool(name, args) {
112
+ const tool = this.tools.get(name);
113
+ if (!tool) {
114
+ return `Error: Tool '${name}' not found`;
115
+ }
116
+ if (tool.handler) {
117
+ try {
118
+ return await tool.handler(args);
119
+ }
120
+ catch (error) {
121
+ return `Error executing ${name}: ${error instanceof Error ? error.message : String(error)}`;
122
+ }
123
+ }
124
+ // Default: return a placeholder response
125
+ return `Tool '${name}' executed with args: ${JSON.stringify(args)}`;
126
+ }
127
+ /**
128
+ * Initialize the conversation
129
+ */
130
+ initialize() {
131
+ this.messages = [
132
+ {
133
+ role: 'system',
134
+ content: this.getSystemPrompt(),
135
+ },
136
+ ];
137
+ }
138
+ /**
139
+ * Send a message and get a response
140
+ */
141
+ async chat(userMessage, options) {
142
+ // Add user message
143
+ this.messages.push({
144
+ role: 'user',
145
+ content: userMessage,
146
+ });
147
+ const tools = this.getOpenAITools();
148
+ let turnCount = 0;
149
+ const maxTurns = options?.maxTurns || 10;
150
+ while (turnCount < maxTurns) {
151
+ turnCount++;
152
+ // Call OpenAI
153
+ const response = await this.client.chat.completions.create({
154
+ model: this.getModel(),
155
+ messages: this.messages,
156
+ tools: tools.length > 0 ? tools : undefined,
157
+ temperature: this.manifest.spec.llm?.temperature ?? 0.7,
158
+ max_tokens: this.manifest.spec.llm?.maxTokens,
159
+ });
160
+ const choice = response.choices[0];
161
+ const message = choice.message;
162
+ // Add assistant message to history
163
+ this.messages.push(message);
164
+ // Check if we need to call tools
165
+ if (message.tool_calls && message.tool_calls.length > 0) {
166
+ if (options?.verbose) {
167
+ console.log(`\n[Calling ${message.tool_calls.length} tool(s)...]`);
168
+ }
169
+ // Execute each tool call
170
+ for (const toolCall of message.tool_calls) {
171
+ // Type guard for function tool calls
172
+ if (toolCall.type !== 'function')
173
+ continue;
174
+ const funcCall = toolCall;
175
+ const args = JSON.parse(funcCall.function.arguments);
176
+ if (options?.verbose) {
177
+ console.log(` → ${funcCall.function.name}(${JSON.stringify(args)})`);
178
+ }
179
+ const result = await this.executeTool(funcCall.function.name, args);
180
+ if (options?.verbose) {
181
+ console.log(` ← ${result.substring(0, 100)}${result.length > 100 ? '...' : ''}`);
182
+ }
183
+ // Add tool result to messages
184
+ this.messages.push({
185
+ role: 'tool',
186
+ tool_call_id: toolCall.id,
187
+ content: result,
188
+ });
189
+ }
190
+ // Continue the loop to get the final response
191
+ continue;
192
+ }
193
+ // No tool calls, return the response
194
+ return message.content || '';
195
+ }
196
+ return 'Max turns reached without completion';
197
+ }
198
+ /**
199
+ * Get agent info
200
+ */
201
+ getAgentInfo() {
202
+ return {
203
+ name: this.manifest.metadata.name,
204
+ model: this.getModel(),
205
+ tools: Array.from(this.tools.keys()),
206
+ };
207
+ }
208
+ }
209
+ //# sourceMappingURL=openai.adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openai.adapter.js","sourceRoot":"","sources":["../../../src/services/runtime/openai.adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Validation Service
3
+ * Validates OSSA agent manifests against JSON schemas
4
+ */
5
+ import { SchemaRepository } from '../repositories/schema.repository.js';
6
+ import type { IValidationService, SchemaVersion, ValidationResult } from '../types/index.js';
7
+ export declare class ValidationService implements IValidationService {
8
+ private schemaRepository;
9
+ private ajv;
10
+ private platformValidators;
11
+ constructor(schemaRepository: SchemaRepository);
12
+ /**
13
+ * Validate OSSA agent manifest
14
+ * @param manifest - Manifest object to validate
15
+ * @param version - OSSA version (e.g., '0.2.3', '0.2.2', '0.1.9')
16
+ * @returns Validation result with errors and warnings
17
+ */
18
+ validate(manifest: unknown, version?: SchemaVersion): Promise<ValidationResult>;
19
+ /**
20
+ * Generate warnings for best practices
21
+ * @param manifest - Manifest object to check
22
+ * @returns Array of warning messages
23
+ */
24
+ private generateWarnings;
25
+ /**
26
+ * Validate platform-specific extensions
27
+ * @param manifest - Manifest object to validate
28
+ * @returns Combined validation result from all platform validators
29
+ */
30
+ private validatePlatformExtensions;
31
+ /**
32
+ * Validate multiple manifests
33
+ * @param manifests - Array of manifests to validate
34
+ * @param version - Schema version
35
+ * @returns Array of validation results
36
+ */
37
+ validateMany(manifests: unknown[], version?: SchemaVersion): Promise<ValidationResult[]>;
38
+ /**
39
+ * Validate OpenAPI spec with OSSA extensions
40
+ * @param openapiSpec - OpenAPI specification object
41
+ * @returns Validation result with errors and warnings for extensions
42
+ */
43
+ validateOpenAPIExtensions(openapiSpec: unknown): Promise<ValidationResult>;
44
+ }
45
+ //# sourceMappingURL=validation.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validation.service.d.ts","sourceRoot":"","sources":["../../src/services/validation.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAGxE,OAAO,KAAK,EACV,kBAAkB,EAElB,aAAa,EACb,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAa3B,qBACa,iBAAkB,YAAW,kBAAkB;IAK9B,OAAO,CAAC,gBAAgB;IAJpD,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,kBAAkB,CAAmB;gBAGT,gBAAgB,EAAE,gBAAgB;IAuBtE;;;;;OAKG;IACG,QAAQ,CACZ,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,aAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAmD5B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAgExB;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IA4BlC;;;;;OAKG;IACG,YAAY,CAChB,SAAS,EAAE,OAAO,EAAE,EACpB,OAAO,GAAE,aAAuB,GAC/B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAM9B;;;;OAIG;IACG,yBAAyB,CAC7B,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,gBAAgB,CAAC;CAkL7B"}