@bluefly/openstandardagents 0.2.5-RC → 0.2.8

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 (365) hide show
  1. package/.devfile.yaml +1 -1
  2. package/.env.example +1 -1
  3. package/.github/ISSUE_TEMPLATE/bug_report.yml +63 -0
  4. package/.github/ISSUE_TEMPLATE/feature_request.yml +40 -0
  5. package/.github/workflows/dependabot-comment.yml +34 -0
  6. package/.github/workflows/pr-comment.yml +33 -0
  7. package/.husky/pre-commit +5 -0
  8. package/.kiro/config.json +21 -0
  9. package/.kiro/settings/mcp.json +61 -0
  10. package/.kiro/specs/scripts-migration-api-first/design.md +883 -0
  11. package/.kiro/specs/scripts-migration-api-first/requirements.md +165 -0
  12. package/.kiro/specs/scripts-migration-api-first/tasks.md +539 -0
  13. package/.kiro/specs/{website-design-audit → website-brand-identity}/design.md +381 -0
  14. package/.kiro/specs/{website-design-audit → website-brand-identity}/requirements.md +88 -0
  15. package/.kiro/specs/website-brand-identity/tasks.md +981 -0
  16. package/.version.json +2 -2
  17. package/.wiki-config.json +24 -0
  18. package/CHANGELOG.md +34 -18
  19. package/CODEOWNERS +75 -0
  20. package/CONTRIBUTING.md +1 -1
  21. package/README.md +176 -239
  22. package/bin/ossa-dev +42 -0
  23. package/bin/ossa-export +32 -0
  24. package/bin/ossa-generate +60 -0
  25. package/bin/ossa-health +40 -0
  26. package/bin/ossa-init +26 -0
  27. package/dist/index.d.ts +1 -0
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +2 -0
  30. package/dist/index.js.map +1 -1
  31. package/dist/repositories/schema.repository.d.ts +6 -1
  32. package/dist/repositories/schema.repository.d.ts.map +1 -1
  33. package/dist/repositories/schema.repository.js +63 -36
  34. package/dist/repositories/schema.repository.js.map +1 -1
  35. package/dist/services/github-sync/github-client.d.ts +14 -0
  36. package/dist/services/github-sync/github-client.d.ts.map +1 -0
  37. package/dist/services/github-sync/github-client.js +41 -0
  38. package/dist/services/github-sync/github-client.js.map +1 -0
  39. package/dist/services/github-sync/gitlab-client.d.ts +17 -0
  40. package/dist/services/github-sync/gitlab-client.d.ts.map +1 -0
  41. package/dist/services/github-sync/gitlab-client.js +42 -0
  42. package/dist/services/github-sync/gitlab-client.js.map +1 -0
  43. package/dist/services/github-sync/schemas.d.ts +46 -0
  44. package/dist/services/github-sync/schemas.d.ts.map +1 -0
  45. package/dist/services/github-sync/schemas.js +36 -0
  46. package/dist/services/github-sync/schemas.js.map +1 -0
  47. package/dist/services/github-sync/sync.service.d.ts +27 -0
  48. package/dist/services/github-sync/sync.service.d.ts.map +1 -0
  49. package/dist/services/github-sync/sync.service.js +99 -0
  50. package/dist/services/github-sync/sync.service.js.map +1 -0
  51. package/dist/services/migration.service.d.ts +4 -3
  52. package/dist/services/migration.service.d.ts.map +1 -1
  53. package/dist/services/migration.service.js +11 -10
  54. package/dist/services/migration.service.js.map +1 -1
  55. package/dist/services/release-automation/release.service.js +1 -1
  56. package/dist/services/release-automation/release.service.js.map +1 -1
  57. package/dist/services/release-automation/schemas/release.schema.js +1 -1
  58. package/dist/services/runtime/claude/capability-mapper.d.ts +84 -0
  59. package/dist/services/runtime/claude/capability-mapper.d.ts.map +1 -0
  60. package/dist/services/runtime/claude/capability-mapper.js +245 -0
  61. package/dist/services/runtime/claude/capability-mapper.js.map +1 -0
  62. package/dist/services/runtime/claude/claude-adapter.d.ts +80 -0
  63. package/dist/services/runtime/claude/claude-adapter.d.ts.map +1 -0
  64. package/dist/services/runtime/claude/claude-adapter.js +287 -0
  65. package/dist/services/runtime/claude/claude-adapter.js.map +1 -0
  66. package/dist/services/runtime/claude/manifest-parser.d.ts +77 -0
  67. package/dist/services/runtime/claude/manifest-parser.d.ts.map +1 -0
  68. package/dist/services/runtime/claude/manifest-parser.js +169 -0
  69. package/dist/services/runtime/claude/manifest-parser.js.map +1 -0
  70. package/dist/services/runtime/claude/types.d.ts +115 -0
  71. package/dist/services/runtime/claude/types.d.ts.map +1 -0
  72. package/dist/services/runtime/claude/types.js +6 -0
  73. package/dist/services/runtime/claude/types.js.map +1 -0
  74. package/dist/services/validation.service.d.ts.map +1 -1
  75. package/dist/services/validation.service.js +12 -1
  76. package/dist/services/validation.service.js.map +1 -1
  77. package/dist/spec/v0.2.4/ossa-0.2.4.schema.json +85 -208
  78. package/dist/spec/v0.2.6/CHANGELOG.md +401 -0
  79. package/dist/spec/v0.2.6/README.md +72 -0
  80. package/dist/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
  81. package/dist/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  82. package/dist/spec/{v0.2.4/ossa-0.2.4-dev.schema.json → v0.2.6/ossa-0.2.6.schema.json} +128 -38
  83. package/dist/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
  84. package/dist/spec/v0.2.6-dev/CHANGELOG.md +164 -0
  85. package/dist/spec/v0.2.6-dev/README.md +75 -0
  86. package/dist/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
  87. package/dist/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  88. package/dist/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
  89. package/dist/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
  90. package/dist/spec/v0.2.7/core/agentgraph.md +324 -0
  91. package/dist/spec/v0.2.7/resources/agentgraph.yaml +135 -0
  92. package/dist/spec/v0.2.8/CHANGELOG.md +401 -0
  93. package/dist/spec/v0.2.8/README.md +72 -0
  94. package/dist/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
  95. package/dist/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  96. package/dist/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
  97. package/dist/spec/v0.2.8/ossa-0.2.8.schema.json +3153 -0
  98. package/dist/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
  99. package/dist/types/index.d.ts +3 -2
  100. package/dist/types/index.d.ts.map +1 -1
  101. package/dist/utils/index.d.ts +6 -0
  102. package/dist/utils/index.d.ts.map +1 -0
  103. package/dist/utils/index.js +6 -0
  104. package/dist/utils/index.js.map +1 -0
  105. package/dist/utils/version.d.ts +68 -0
  106. package/dist/utils/version.d.ts.map +1 -0
  107. package/dist/utils/version.js +156 -0
  108. package/dist/utils/version.js.map +1 -0
  109. package/docs/brand-guide/01-brand-overview.md +37 -0
  110. package/docs/brand-guide/02-logo-usage.md +43 -0
  111. package/docs/brand-guide/03-color-palette.md +70 -0
  112. package/docs/brand-guide/04-typography.md +82 -0
  113. package/docs/brand-guide/05-voice-and-tone.md +108 -0
  114. package/docs/brand-guide/06-visual-elements.md +137 -0
  115. package/docs/brand-guide/07-application-examples.md +153 -0
  116. package/docs/brand-guide/OssaLogo/OssA_Logo.svg +21 -0
  117. package/docs/brand-guide/OssaLogo/brand.af +0 -0
  118. package/docs/brand-guide/README.md +107 -0
  119. package/docs/comparison.md +315 -0
  120. package/docs/operations/automation-roadmap.md +245 -0
  121. package/docs/operations/github-sync-strategy.md +357 -0
  122. package/eslint-report.json +1 -0
  123. package/examples/adk-integration/code-review-workflow.yml +1 -1
  124. package/examples/adk-integration/customer-support.yml +1 -1
  125. package/examples/adk-integration/data-pipeline.yml +1 -1
  126. package/examples/advanced/workflows/hybrid-model-strategy.yaml +1 -1
  127. package/examples/agent-manifests/critics/critic-agent.yaml +1 -1
  128. package/examples/agent-manifests/governors/governor-agent.yaml +1 -1
  129. package/examples/agent-manifests/integrators/integrator-agent.yaml +1 -1
  130. package/examples/agent-manifests/judges/judge-agent.yaml +1 -1
  131. package/examples/agent-manifests/monitors/monitor-agent.yaml +1 -1
  132. package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml +1 -1
  133. package/examples/agent-manifests/sample-compliant-agent.yaml +1 -1
  134. package/examples/agent-manifests/workers/worker-agent.yaml +1 -1
  135. package/examples/anthropic/claude-assistant.ossa.json +5 -4
  136. package/examples/autogen/multi-agent.ossa.json +6 -4
  137. package/examples/claude-code/code-reviewer.ossa.yaml +78 -0
  138. package/examples/claude-code/ossa-validator.ossa.yaml +80 -0
  139. package/examples/common_npm/agent-router.ossa.yaml +1 -0
  140. package/examples/common_npm/agent-router.v0.2.2.ossa.yaml +1 -1
  141. package/examples/crewai/research-team.ossa.json +14 -5
  142. package/examples/cursor/code-review-agent.ossa.json +21 -6
  143. package/examples/drupal/gitlab-ml-recommender.ossa.yaml +1 -0
  144. package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml +1 -1
  145. package/examples/extensions/drupal-v1.yml +1 -1
  146. package/examples/extensions/kagent-v1.yml +1 -1
  147. package/examples/getting-started/hello-world-complete.ossa.yaml +1 -1
  148. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +4 -4
  149. package/examples/kagent/compliance-validator.ossa.yaml +1 -1
  150. package/examples/kagent/cost-optimizer.ossa.yaml +1 -1
  151. package/examples/kagent/documentation-agent.ossa.yaml +1 -1
  152. package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml +1 -0
  153. package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml +1 -1
  154. package/examples/kagent/k8s-troubleshooter.ossa.yaml +1 -1
  155. package/examples/kagent/security-scanner.ossa.yaml +1 -1
  156. package/examples/langchain/chain-agent.ossa.json +21 -5
  157. package/examples/langflow/workflow-agent.ossa.json +2 -3
  158. package/examples/langgraph/state-machine-agent.ossa.json +2 -3
  159. package/examples/llamaindex/rag-agent.ossa.json +2 -3
  160. package/examples/migration-guides/from-langchain-to-ossa.yaml +4 -4
  161. package/examples/multi-agent/README.md +74 -0
  162. package/examples/multi-agent/conditional-router.ossa.yaml +42 -0
  163. package/examples/multi-agent/parallel-execution.ossa.yaml +54 -0
  164. package/examples/multi-agent/sequential-pipeline.ossa.yaml +45 -0
  165. package/examples/openai/basic-agent.ossa.yaml +1 -1
  166. package/examples/openai/multi-tool-agent.ossa.json +33 -10
  167. package/examples/openai/swarm-agent.ossa.json +18 -5
  168. package/examples/production/document-analyzer-openai.yml +1 -1
  169. package/examples/quickstart/support-agent.ossa.yaml +1 -1
  170. package/examples/spec-examples/audit-agent.yml +1 -1
  171. package/examples/spec-examples/chat-agent.yml +1 -1
  172. package/examples/spec-examples/compliance-agent.yml +1 -1
  173. package/examples/spec-examples/monitoring-agent.yml +1 -1
  174. package/examples/spec-examples/workflow-agent.yml +1 -1
  175. package/examples/templates/ossa-compliance.yaml +1 -1
  176. package/examples/vercel/edge-agent.ossa.json +5 -4
  177. package/gl-code-quality-report.json +62 -0
  178. package/llms-ctx-full.txt +39 -0
  179. package/llms-ctx.txt +39 -0
  180. package/llms.txt +47 -0
  181. package/openapi/github-sync.yaml +115 -0
  182. package/package.json +26 -4
  183. package/scripts/README.md +103 -0
  184. package/scripts/auto-rebase-mrs.ts +106 -0
  185. package/scripts/batch-dependabot.sh +57 -0
  186. package/scripts/configure-gitlab-branch-protection.ts +95 -0
  187. package/scripts/create-issue-helper.ts +238 -0
  188. package/scripts/create-milestone-issue.ts +73 -0
  189. package/scripts/eslint-to-codequality.cjs +34 -0
  190. package/scripts/fix-schema-formats.js +82 -0
  191. package/scripts/generate-agents-catalog.ts +77 -0
  192. package/scripts/generate-api-docs.ts +218 -0
  193. package/scripts/generate-cli-docs.ts +410 -0
  194. package/scripts/generate-config-docs.ts +109 -0
  195. package/scripts/generate-errors-docs.ts +76 -0
  196. package/scripts/generate-examples-docs.ts +99 -0
  197. package/scripts/generate-llms-ctx.sh +17 -0
  198. package/scripts/generate-schema-docs.ts +317 -0
  199. package/scripts/generate-types-docs.ts +48 -0
  200. package/scripts/lowercase-docs.ts +43 -0
  201. package/scripts/manage-milestone-mrs.ts +279 -0
  202. package/scripts/rebase-all-mrs.sh +75 -0
  203. package/scripts/sync-github-pr.sh +48 -0
  204. package/scripts/sync-version.js +32 -0
  205. package/scripts/sync-wiki.sh +50 -0
  206. package/scripts/validate-all.js +127 -0
  207. package/scripts/validate-schema.ts +2 -1
  208. package/spec/v0.2.4/ossa-0.2.4.schema.json +85 -208
  209. package/spec/v0.2.6/CHANGELOG.md +401 -0
  210. package/spec/v0.2.6/README.md +72 -0
  211. package/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
  212. package/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  213. package/spec/{v0.2.4/ossa-0.2.4-dev.schema.json → v0.2.6/ossa-0.2.6.schema.json} +128 -38
  214. package/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
  215. package/spec/v0.2.6-dev/CHANGELOG.md +164 -0
  216. package/spec/v0.2.6-dev/README.md +75 -0
  217. package/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
  218. package/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  219. package/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
  220. package/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
  221. package/spec/v0.2.7/core/agentgraph.md +324 -0
  222. package/spec/v0.2.7/resources/agentgraph.yaml +135 -0
  223. package/spec/v0.2.8/CHANGELOG.md +401 -0
  224. package/spec/v0.2.8/README.md +72 -0
  225. package/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
  226. package/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  227. package/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
  228. package/spec/v0.2.8/ossa-0.2.8.schema.json +3153 -0
  229. package/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
  230. package/test-results/junit.xml +299 -0
  231. package/.kiro/specs/agent-buildkit-templates/design.md +0 -495
  232. package/.kiro/specs/agent-buildkit-templates/requirements.md +0 -165
  233. package/.kiro/specs/kiro-ide-supercharger/README.md +0 -202
  234. package/.kiro/specs/kiro-ide-supercharger/design.md +0 -1005
  235. package/.kiro/specs/kiro-ide-supercharger/requirements.md +0 -141
  236. package/.kiro/specs/kiro-ide-supercharger/tasks.md +0 -507
  237. package/bin/validate-ossa-0.2.5-RC.ts +0 -244
  238. package/docs/issue-19-completion-summary.md +0 -648
  239. package/docs/issue-19-validation.md +0 -351
  240. package/scripts/lib/exec.ts +0 -37
  241. package/scripts/lib/file-ops.ts +0 -58
  242. package/scripts/lib/version.ts +0 -83
  243. package/website/.lighthouserc.ts +0 -24
  244. package/website/.prettierrc +0 -10
  245. package/website/Dockerfile +0 -30
  246. package/website/app/about/page.tsx +0 -295
  247. package/website/app/blog/[slug]/page.tsx +0 -208
  248. package/website/app/blog/page.tsx +0 -249
  249. package/website/app/design-guide/page.tsx +0 -511
  250. package/website/app/docs/[[...slug]]/page.tsx +0 -847
  251. package/website/app/docs/core-concepts/project-structure/page.tsx +0 -349
  252. package/website/app/ecosystem/page.tsx +0 -375
  253. package/website/app/examples/page.tsx +0 -133
  254. package/website/app/globals.scss +0 -135
  255. package/website/app/layout.tsx +0 -106
  256. package/website/app/license/page.tsx +0 -183
  257. package/website/app/not-found.tsx +0 -18
  258. package/website/app/page.tsx +0 -474
  259. package/website/app/playground/page.tsx +0 -487
  260. package/website/app/robots.ts +0 -19
  261. package/website/app/rss.xml/route.ts +0 -74
  262. package/website/app/schema/page.tsx +0 -1001
  263. package/website/app/sitemap.ts +0 -56
  264. package/website/app/specification/page.tsx +0 -287
  265. package/website/components/InstallCommand.tsx +0 -96
  266. package/website/components/Logo.tsx +0 -97
  267. package/website/components/StructuredData.tsx +0 -65
  268. package/website/components/docs/DocsSearch.tsx +0 -104
  269. package/website/components/docs/DocsSidebar.tsx +0 -155
  270. package/website/components/docs/MarkdownContent.tsx +0 -401
  271. package/website/components/docs/VersionSelector.tsx +0 -105
  272. package/website/components/examples/ExamplesViewer.tsx +0 -293
  273. package/website/components/layout/Footer.tsx +0 -116
  274. package/website/components/layout/Header.tsx +0 -168
  275. package/website/components/schema/SchemaComponentsAccordion.tsx +0 -84
  276. package/website/components/schema/SchemaExplorer.tsx +0 -213
  277. package/website/content/blog/OpenAPI-AI-Agents-Standard.md +0 -285
  278. package/website/content/blog/Why-Formal-Standards-Matter-Now.md +0 -198
  279. package/website/content/blog/gitlab-kubernetes-agent-ecosystem.md +0 -286
  280. package/website/content/blog/introducing-ossa-framework.md +0 -328
  281. package/website/content/blog/ossa-production-results.md +0 -279
  282. package/website/content/blog/welcome-to-ossa.md +0 -43
  283. package/website/content/blog/why-ai-agents-need-open-standard.md +0 -98
  284. package/website/content/docs/00-HOME.md +0 -153
  285. package/website/content/docs/AIFlow-Framework-Integration-with-OSSA.md +0 -107
  286. package/website/content/docs/Examples.md +0 -71
  287. package/website/content/docs/OpenAPI-Extensions.md +0 -934
  288. package/website/content/docs/adapters/openai-adapter.md +0 -693
  289. package/website/content/docs/architecture/execution-flow.md +0 -335
  290. package/website/content/docs/architecture/multi-agent-systems.md +0 -737
  291. package/website/content/docs/architecture/overview.md +0 -121
  292. package/website/content/docs/architecture/stack-integration.md +0 -461
  293. package/website/content/docs/changelog.md +0 -246
  294. package/website/content/docs/contributing.md +0 -599
  295. package/website/content/docs/core-concepts/Project-Structure.md +0 -348
  296. package/website/content/docs/ecosystem/framework-support.md +0 -819
  297. package/website/content/docs/ecosystem/overview.md +0 -366
  298. package/website/content/docs/examples/AIFlow-Framework-Integration-with-OSSA.md +0 -107
  299. package/website/content/docs/examples/Migration-Guides.md +0 -214
  300. package/website/content/docs/for-audiences/Architects.md +0 -224
  301. package/website/content/docs/for-audiences/Developers.md +0 -220
  302. package/website/content/docs/for-audiences/Enterprises.md +0 -256
  303. package/website/content/docs/for-audiences/Students-Researchers.md +0 -122
  304. package/website/content/docs/getting-started/5-Minute-Overview.md +0 -85
  305. package/website/content/docs/getting-started/First-Agent.md +0 -196
  306. package/website/content/docs/getting-started/Hello-World.md +0 -184
  307. package/website/content/docs/getting-started/Installation.md +0 -155
  308. package/website/content/docs/getting-started/index.md +0 -92
  309. package/website/content/docs/getting-started/running-agents.md +0 -309
  310. package/website/content/docs/getting-started.md +0 -91
  311. package/website/content/docs/integrations/aiflow.md +0 -104
  312. package/website/content/docs/integrations/drupal.md +0 -105
  313. package/website/content/docs/migration-guides/00-INDEX.md +0 -76
  314. package/website/content/docs/migration-guides/README.md +0 -133
  315. package/website/content/docs/migration-guides/agent-schema-comparison.md +0 -232
  316. package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +0 -1750
  317. package/website/content/docs/migration-guides/crewai-to-ossa.md +0 -274
  318. package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +0 -2017
  319. package/website/content/docs/migration-guides/general-agent-schema.yml +0 -247
  320. package/website/content/docs/migration-guides/index.md +0 -133
  321. package/website/content/docs/migration-guides/langchain-to-ossa.md +0 -1714
  322. package/website/content/docs/migration-guides/langflow-to-ossa.md +0 -2075
  323. package/website/content/docs/migration-guides/migration-manifest.json +0 -64
  324. package/website/content/docs/migration-guides/openai-to-ossa.md +0 -1202
  325. package/website/content/docs/openapi-extensions/examples.md +0 -550
  326. package/website/content/docs/openapi-extensions/index.md +0 -551
  327. package/website/content/docs/openapi-extensions/operation-extensions.md +0 -457
  328. package/website/content/docs/openapi-extensions/root-extensions.md +0 -410
  329. package/website/content/docs/ossa-compliant-badge.md +0 -251
  330. package/website/content/docs/pre-release/index.md +0 -175
  331. package/website/content/docs/quick-reference.md +0 -17
  332. package/website/content/docs/readme.md +0 -35
  333. package/website/content/docs/schema-reference/agent-spec.md +0 -406
  334. package/website/content/docs/schema-reference/autonomy.md +0 -568
  335. package/website/content/docs/schema-reference/constraints.md +0 -543
  336. package/website/content/docs/schema-reference/index.md +0 -176
  337. package/website/content/docs/schema-reference/llm-config.md +0 -445
  338. package/website/content/docs/schema-reference/observability.md +0 -654
  339. package/website/content/docs/schema-reference/ossa-manifest.md +0 -309
  340. package/website/content/docs/schema-reference/taxonomy.md +0 -509
  341. package/website/content/docs/schema-reference/tools.md +0 -628
  342. package/website/content/docs/templates/blog-post.md +0 -43
  343. package/website/content/docs/use-cases/00-index.md +0 -395
  344. package/website/content/docs/use-cases/cicd-code-review.md +0 -1236
  345. package/website/content/docs/use-cases/customer-support.md +0 -1234
  346. package/website/content/docs/use-cases/enterprise-compliance.md +0 -1208
  347. package/website/content/docs/use-cases/research-multi-agent.md +0 -1161
  348. package/website/content/docs/versioning.md +0 -288
  349. package/website/lib/version.ts +0 -35
  350. package/website/lib/versions.json +0 -78
  351. package/website/next.config.ts +0 -18
  352. package/website/nginx.conf +0 -32
  353. package/website/package-lock.json +0 -9679
  354. package/website/package.json +0 -59
  355. package/website/postcss.config.mjs +0 -9
  356. package/website/scripts/fetch-versions.js +0 -166
  357. package/website/scripts/generate-examples-index.js +0 -163
  358. package/website/scripts/merge-docs-to-wiki.ts +0 -207
  359. package/website/scripts/sync-version.js +0 -72
  360. package/website/scripts/sync-wiki.ts +0 -322
  361. package/website/scripts/upload-wiki.ts +0 -199
  362. package/website/styles/_variables.scss +0 -36
  363. package/website/tailwind.config.ts +0 -136
  364. /package/dist/spec/v0.2.4/{ossa-0.2.4-dev.yaml → ossa-0.2.4.yaml} +0 -0
  365. /package/spec/v0.2.4/{ossa-0.2.4-dev.yaml → ossa-0.2.4.yaml} +0 -0
package/README.md CHANGED
@@ -1,357 +1,294 @@
1
1
  # OSSA - Open Standard for Scalable AI Agents
2
2
 
3
- **The OpenAPI for AI Agents**
3
+ > **The OpenAPI for AI Agents**
4
+ >
5
+ > - **🐙 GitHub**: [github.com/blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
6
+ > - **📦 npm**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
7
+ > - **🌐 Website**: [openstandardagents.org](https://openstandardagents.org)
8
+ > - **💬 Discord**: [Join our community](https://discord.gg/ossa)
9
+
10
+ ---
4
11
 
5
12
  [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
6
13
  [![npm version](https://img.shields.io/npm/v/@bluefly/openstandardagents)](https://www.npmjs.com/package/@bluefly/openstandardagents)
7
- [![GitLab](https://img.shields.io/badge/GitLab-OSSA-orange.svg)](https://github.com/blueflyio/openstandardagents)
8
14
  [![GitHub](https://img.shields.io/badge/GitHub-OSSA-black.svg)](https://github.com/blueflyio/openstandardagents)
9
- [![OSSA Compliant](https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg)](https://github.com/blueflyio/openstandardagents)
15
+
16
+ **Vendor-neutral, compliance-ready, enterprise-grade**
17
+
18
+ - ✅ Switch between AI providers without code changes
19
+ - ✅ Built-in compliance and security frameworks
20
+ - ✅ Standardized agent lifecycle and governance
21
+ - ✅ Multi-runtime support (Node.js, Python, more)
10
22
 
11
23
  ---
12
24
 
13
25
  ## What is OSSA?
14
26
 
15
- **OSSA: Open Standard for Scalable AI Agents** - The definitive open standard for defining and connecting AI agents.
27
+ **Open Standard Agents (OSSA)** is an open, vendor-neutral specification for defining AI agents, similar to how OpenAPI standardizes REST APIs. It enables interoperability across frameworks, runtimes, and organizations.
16
28
 
17
- Just as OpenAPI standardized REST APIs, OSSA standardizes AI agent interaction, enabling vendor-neutral interoperability across frameworks. OSSA provides a unified schema for AI agents to communicate, ensuring compatibility across frameworks and enhancing trust in autonomous systems.
29
+ ### OSSA is NOT a Framework
18
30
 
19
- **OSSA is NOT a framework** - it's a standard that defines the contract. Implementations provide the functionality.
31
+ OSSA is a **specification standard** that defines the contract for agent definition, deployment, and management.
20
32
 
21
- **Key Qualities:**
22
- - **Vendor-Neutral** - Community-driven, not controlled by any single company
23
- - **Interoperable** - Common language enabling diverse AI agents to work together
24
- - **Trustworthy** - Built with compliance and security in mind
25
- - **Open** - Collaborative effort for the "Internet of Agents"
33
+ Just like OpenAPI doesn't implement APIs, OSSA doesn't implement agents. It provides the standard that implementations follow.
26
34
 
27
- | Component | Role | Comparable To |
28
- |-----------|------|---------------|
29
- | OSSA Specification | Standard definition | OpenAPI Specification |
30
- | OSSA CLI | Validation & generation | OpenAPI Generator (minimal) |
31
- | agent-buildkit | Reference implementation | Kong API Gateway |
32
- | OSSA Registry | Agent distribution | npm Registry |
35
+ ### Why Does This Matter?
33
36
 
34
- ---
37
+ **Portability: Avoid Vendor Lock-in**
38
+ Switch between AI providers (OpenAI, Anthropic, Azure) without rewriting code. Define your agent once in OSSA format, deploy anywhere.
39
+
40
+ **Regulatory Compliance: Built-in Frameworks**
41
+ Meet SOC2, FedRAMP, HIPAA, and GDPR requirements with standardized security models, audit trails, and data boundary controls.
35
42
 
36
- ## Core Principles
43
+ **Vendor Independence: True Interoperability**
44
+ Community-driven standard, not controlled by any single company. Works with LangChain, CrewAI, AutoGen, and any framework.
37
45
 
38
- 1. **Specification-Driven** - OSSA defines the standard
39
- 2. **Implementation-Agnostic** - Any runtime can implement it
40
- 3. **Minimal Tooling** - Basic CLI for validation & generation
41
- 4. **No Vendor Lock-in** - Deploy to any infrastructure
46
+ **One standard. Any framework. True portability.**
42
47
 
43
48
  ---
44
49
 
45
- ## Quick Start
50
+ ## Get Started in Minutes
46
51
 
47
- ### Installation
52
+ ### 1. Install CLI
48
53
 
49
54
  ```bash
50
55
  npm install -g @bluefly/openstandardagents
51
56
  ```
52
57
 
53
- ### Create Agent
58
+ ### 2. Create Agent
54
59
 
55
60
  ```bash
56
- ossa generate worker --name "My Agent" --id my-agent
57
- # Creates agent.ossa.yaml
61
+ ossa init my-agent
62
+ cd my-agent
58
63
  ```
59
64
 
60
- ### Validate
65
+ ### 3. Validate
61
66
 
62
67
  ```bash
63
- ossa validate agent.yml
68
+ ossa validate my-agent.ossa.yaml
64
69
  ```
65
70
 
66
- ### Run Your Agent
71
+ ### 4. Run
67
72
 
68
73
  ```bash
69
74
  # Set your API key
70
75
  export OPENAI_API_KEY=sk-your-key-here
71
76
 
72
77
  # Run interactively
73
- ossa run agent.ossa.yaml
74
-
75
- # Or send a single message
76
- ossa run agent.ossa.yaml -m "Hello, how can you help me?"
77
-
78
- # With verbose output
79
- ossa run agent.ossa.yaml -v
80
- ```
81
-
82
- ### Deploy
83
-
84
- Deploy to **YOUR** infrastructure:
85
- - AWS, GCP, Azure
86
- - Kubernetes, Docker
87
- - On-premise
88
- - Serverless
89
-
90
- OSSA doesn't care - it's just a standard.
91
-
92
- ---
93
-
94
- ## OSSA CLI (Minimal Tooling)
95
-
96
- The OSSA CLI provides basic tooling:
97
-
98
- ```bash
99
- ossa validate <path> # Validate against OSSA schema
100
- ossa generate <type> # Generate agent from template (chat, workflow, compliance, etc.)
101
- ossa migrate <source> # Migrate between OSSA versions
102
- ossa run <path> # Run agents with OpenAI adapter
78
+ ossa run my-agent.ossa.yaml
103
79
  ```
104
80
 
105
- **What OSSA CLI does:**
106
- - Validate agent manifests
107
- - Generate project scaffolding
108
- - Provide templates
109
- - Run agents interactively (OpenAI adapter)
110
-
111
- **What OSSA CLI does NOT do:**
112
- - Runtime orchestration
113
- - Deployment
114
- - Production monitoring
115
- - Infrastructure management
116
-
117
- For production features, see [Agent Buildkit](https://github.com/blueflyio/agent-buildkit).
118
-
119
- ### Running Agents
120
-
121
- The `ossa run` command allows you to execute agents using the OpenAI adapter:
81
+ ### 5. Export to Any Framework
122
82
 
123
83
  ```bash
124
- # Interactive mode (REPL)
125
- ossa run my-agent.ossa.yaml
126
-
127
- # Single message mode
128
- ossa run my-agent.ossa.yaml -m "What is the weather today?"
129
-
130
- # Verbose output (show tool calls)
131
- ossa run my-agent.ossa.yaml -v
132
-
133
- # Custom options
134
- ossa run my-agent.ossa.yaml --max-turns 20 --no-validate
84
+ ossa export --to cursor
85
+ ossa export --to langchain
86
+ ossa export --to crewai
135
87
  ```
136
88
 
137
- **Features:**
138
- - Interactive REPL mode for conversations
139
- - Single message mode for quick queries
140
- - Tool execution with custom handlers
141
- - Verbose mode for debugging
142
- - Configurable max turns to prevent loops
143
-
144
- **Requirements:**
145
- - OpenAI API key: `export OPENAI_API_KEY=sk-...`
146
- - Valid OSSA manifest (YAML or JSON)
147
-
148
- See [Running Agents Guide](https://openstandardagents.org/docs/getting-started/running-agents) for more details.
89
+ [Read Full Getting Started Guide](https://openstandardagents.org/docs/getting-started/)
149
90
 
150
91
  ---
151
92
 
152
- ## Specification
153
-
154
- OSSA v0.2.5-RC Schema: [`spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json`](spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json)
155
-
156
- ### Required Fields
93
+ ## Minimal Example
157
94
 
158
95
  ```yaml
159
- ossaVersion: "0.2.5-RC"
160
-
161
- agent:
162
- id: my-agent # DNS-1123 format
163
- name: My Agent # Human-readable
164
- version: "1.0.0" # Semantic version
165
- role: worker # Agent role
166
-
167
- runtime:
168
- type: k8s # Runtime type
169
-
170
- capabilities: # At least one capability
171
- - name: process_data
172
- description: Process data
173
- input_schema: { ... }
174
- output_schema: { ... }
96
+ apiVersion: ossa/v0.2.8
97
+ kind: Agent
98
+
99
+ metadata:
100
+ name: my-agent
101
+ version: "1.0.0"
102
+ description: My first OSSA agent
103
+
104
+ spec:
105
+ role: |
106
+ You are a helpful assistant that answers questions.
107
+
108
+ llm:
109
+ provider: openai
110
+ model: gpt-4
111
+
112
+ tools:
113
+ - type: function
114
+ name: get_weather
115
+ capabilities:
116
+ - name: get_current_weather
117
+ description: Get current weather for a location
118
+ input_schema:
119
+ type: object
120
+ properties:
121
+ location:
122
+ type: string
123
+ required: [location]
175
124
  ```
176
125
 
177
- Full schema documentation: [`docs/specification/`](docs/specification/)
178
-
179
126
  ---
180
127
 
181
- ## Production-Ready Example: GitLab Kubernetes Agent Ecosystem
182
-
183
- **NEW**: Complete production ecosystem with **8 specialized agents** for GitLab-integrated Kubernetes deployments.
184
-
185
- [**View Full Documentation**](https://github.com/blueflyio/openstandardagents/wiki/OSSA-Agent-Ecosystem-for-GitLab-Kubernetes-Deployments)
186
-
187
- ### Highlights
128
+ ## Why OSSA?
188
129
 
189
- - **8 OSSA-compliant agents**: Security, Performance, Database, Config, Monitoring, Rollback, Cost, Compliance
190
- - **Agent mesh** with Istio + STRICT mTLS
191
- - **Elite DORA metrics**: 12 deployments/day, 45min lead time, 8.5% change failure rate
192
- - **Massive ROI**: $80-145K/month cost savings (31-57x return)
193
- - **Full compliance**: SOC2, HIPAA, PCI-DSS, GDPR, FedRAMP
130
+ ### Framework-Agnostic
131
+ Works with LangChain, Anthropic, OpenAI, CrewAI, Langflow, AutoGen, and more. No vendor lock-in.
194
132
 
195
- ### Quick Deploy
133
+ ### Portable
134
+ Move agents between teams, organizations, and infrastructures without rewriting code.
196
135
 
197
- ```bash
198
- # Deploy agent mesh
199
- kubectl apply -f .gitlab/agents/mesh-config.yaml
200
-
201
- # Deploy all 8 agents
202
- for agent in security-scanner performance-optimizer db-migrator \
203
- config-validator monitoring-agent rollback-coordinator \
204
- cost-analyzer compliance-auditor; do
205
- buildkit agents deploy .gitlab/agents/$agent/manifest.ossa.yaml
206
- done
207
- ```
136
+ ### Validatable
137
+ JSON Schema validation ensures correctness before deployment. Catch errors early.
208
138
 
209
- **Location**: [`.gitlab/agents/`](.gitlab/agents/)
139
+ ### Well-Documented
140
+ Comprehensive documentation, examples, and tooling. Built for developers, by developers.
210
141
 
211
- ---
142
+ ### Open Source
143
+ Apache 2.0 licensed. Community-driven. Transparent development process.
212
144
 
213
- ## Examples
145
+ ### Fast Integration
146
+ Export to any framework format. Import existing agents. Seamless migration paths.
214
147
 
215
- Reference implementations: [`examples/`](examples/)
148
+ ### Secure by Design
149
+ Built-in security patterns, authentication, and compliance features.
216
150
 
217
- - `compliance-agent.yml` - FedRAMP compliance
218
- - `chat-agent.yml` - Conversation agent
219
- - `workflow-agent.yml` - Workflow orchestration
220
- - **GitLab K8s Ecosystem** - Production-ready multi-agent system (see above)
151
+ ### Observable
152
+ Built-in observability, logging, and monitoring. Track agent performance and behavior.
221
153
 
222
154
  ---
223
155
 
224
- ## OSSA Ecosystem
156
+ ## Works With Your Favorite Tools
225
157
 
226
- ### Core Products
158
+ OSSA integrates seamlessly with leading AI frameworks, platforms, and tools:
227
159
 
228
- **OSSA** (This Repository) - The specification standard
229
- - JSON Schema specification
230
- - CLI for validation & generation
231
- - Reference implementations
232
- - Documentation
160
+ **LLM Providers**: OpenAI, Anthropic, Google Gemini, Azure OpenAI, Ollama
233
161
 
234
- **Agent Buildkit** - CLI tool for building and managing OSSA-compliant agents
235
- - Modern, fast, minimal CLI
236
- - GitLab integration
237
- - Kubernetes deployment
238
- - Production monitoring
162
+ **Frameworks**: LangChain, CrewAI, AutoGen, LlamaIndex, LangGraph, Langflow
239
163
 
240
- **Agent Studio** - GUI platform for agent orchestration
241
- - macOS-aligned design
242
- - Visual workflow design
243
- - Agent monitoring and debugging
244
- - End-to-end agent lifecycle management
164
+ **Platforms**: Kubernetes, Docker, AWS, Azure, GCP
245
165
 
246
- ### Part of the OSSA Ecosystem
166
+ **Tools**: MCP, Drupal, LibreChat, Cursor, VS Code
247
167
 
248
- All three products work together:
249
- - **OSSA** defines the standard
250
- - **Agent Buildkit** provides CLI tooling
251
- - **Agent Studio** offers visual management
252
-
253
- Together, they form a complete ecosystem for AI agent development, deployment, and management.
254
-
255
- **Others welcome** - OSSA is an open standard, anyone can implement it.
168
+ [View All Integrations](https://openstandardagents.org/docs/ecosystem/framework-support/)
256
169
 
257
170
  ---
258
171
 
259
- ## Why OSSA?
172
+ ## Examples
260
173
 
261
- ### For Enterprises
174
+ We provide comprehensive examples for all major frameworks:
262
175
 
263
- - **Lightweight** - Just a standard, minimal dependencies
264
- - **No Vendor Lock-in** - Use any implementation
265
- - **Deploy Anywhere** - Your infrastructure, your choice
266
- - **Clear Specification** - Well-defined contract
176
+ ### Framework Integration Examples
267
177
 
268
- ### For Framework Builders
178
+ - **OpenAI** - [examples/openai/](https://github.com/blueflyio/openstandardagents/tree/main/examples/openai)
179
+ - **Anthropic** - [examples/anthropic/](https://github.com/blueflyio/openstandardagents/tree/main/examples/anthropic)
180
+ - **LangChain** - [examples/langchain/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langchain)
181
+ - **CrewAI** - [examples/crewai/](https://github.com/blueflyio/openstandardagents/tree/main/examples/crewai)
182
+ - **AutoGen** - [examples/autogen/](https://github.com/blueflyio/openstandardagents/tree/main/examples/autogen)
183
+ - **LlamaIndex** - [examples/llamaindex/](https://github.com/blueflyio/openstandardagents/tree/main/examples/llamaindex)
184
+ - **LangGraph** - [examples/langgraph/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langgraph)
185
+ - **Langflow** - [examples/langflow/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langflow)
186
+ - **Vercel AI** - [examples/vercel/](https://github.com/blueflyio/openstandardagents/tree/main/examples/vercel)
187
+ - **Cursor** - [examples/cursor/](https://github.com/blueflyio/openstandardagents/tree/main/examples/cursor)
269
188
 
270
- - **Standard to Build On** - Like OpenAPI for APIs
271
- - **Reference Implementation** - Agent Buildkit shows the way
272
- - **Clear Boundaries** - Standard vs. implementation
189
+ ### Production Examples
273
190
 
274
- ---
191
+ **GitLab Kubernetes Ecosystem** - [.gitlab/agents/](https://github.com/blueflyio/openstandardagents/tree/main/.gitlab/agents)
192
+ - 8 specialized agents for production Kubernetes deployments
193
+ - Security, Performance, Database, Config, Monitoring, Rollback, Cost, Compliance
194
+ - Full documentation: [Wiki](https://github.com/blueflyio/openstandardagents/wiki/OSSA-Agent-Ecosystem-for-GitLab-Kubernetes-Deployments)
275
195
 
276
- ## Installation & Usage
196
+ [View All Examples](https://openstandardagents.org/examples/)
277
197
 
278
- ### As a Standard (Validation Only)
198
+ ---
279
199
 
280
- ```bash
281
- npm install -g @bluefly/openstandardagents
282
- ossa validate my-agent.yml
283
- ```
200
+ ## Documentation
284
201
 
285
- ### With Production Features
202
+ ### Official Website
286
203
 
287
- ```bash
288
- npm install -g @bluefly/agent-buildkit
289
- buildkit ossa validate my-agent.yml # Uses OSSA + adds features
290
- buildkit ossa sync-docs # GitLab integration
291
- ```
204
+ **Live Website**: [openstandardagents.org](https://openstandardagents.org)
292
205
 
293
- ---
206
+ Features:
207
+ - **Interactive Documentation** - Complete OSSA specification
208
+ - **Schema Validator** - Validate your manifests in the browser
209
+ - **Playground** - Test agents interactively
210
+ - **Migration Guides** - From LangChain, MCP, OpenAI Swarm, CrewAI, Langflow, Drupal ECA
294
211
 
295
- ## Documentation
212
+ ### Resources
296
213
 
297
- ### Official Website & Documentation Portal
214
+ - **Getting Started**: [openstandardagents.org/docs/getting-started/](https://openstandardagents.org/docs/getting-started/)
215
+ - **Full Documentation**: [openstandardagents.org/docs/](https://openstandardagents.org/docs/)
216
+ - **Schema Reference**: [openstandardagents.org/schema/](https://openstandardagents.org/schema/)
217
+ - **Specification**: [spec/v0.2.8/ossa-0.2.8.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.8/ossa-0.2.8.schema.json)
218
+ - **Examples**: [openstandardagents.org/examples/](https://openstandardagents.org/examples/)
219
+ - **Blog**: [openstandardagents.org/blog/](https://openstandardagents.org/blog/)
298
220
 
299
- **Live Website**: https://openstandardagents.org
221
+ ---
300
222
 
301
- The OSSA website features:
302
- - **Interactive Documentation** - Browse the complete OSSA wiki with an enhanced UI
303
- - **GitLab Wiki Integration** - Automatically synced from the official GitLab wiki
304
- - **Interactive Examples** - Explore OSSA manifests with live validation and URL tracking
305
- - **Schema Validator** - Validate your OSSA manifests in the browser
306
- - **Migration Guides** - Step-by-step guides from 6 major frameworks
307
- - **Responsive Design** - Beautiful, accessible UI built with Next.js 15 and Tailwind CSS
223
+ ## How OSSA Compares
308
224
 
309
- The documentation is organized into:
310
- - **Getting Started** - Quick start guides, installation, and first agent creation
311
- - **Core Concepts** - OSSA specification, agent types, capabilities, and runtime models
312
- - **Advanced Topics** - Security, deployment, monitoring, and scaling
313
- - **For Your Role** - Tailored guides for developers, architects, enterprises, and researchers
314
- - **Migration Guides** - From LangChain, MCP, OpenAI Swarm, CrewAI, Langflow, and Drupal ECA
315
- - **Reference** - Complete schema, CLI, and OpenAPI extension reference
225
+ | Feature | OSSA | LangChain | AutoGen | MCP | Semantic Kernel |
226
+ |---------|------|-----------|---------|-----|-----------------|
227
+ | Vendor Neutral | | | | | ❌ |
228
+ | Formal Standard | | | ❌ | ✅ | ❌ |
229
+ | Multi-runtime | | ⚠️ | ⚠️ | | ⚠️ |
230
+ | Enterprise Governance | | | | | ⚠️ |
231
+ | Compliance Ready | | | | ❌ | ❌ |
232
+ | Open Source | ✅ | ✅ | ✅ | ✅ | ✅ |
316
233
 
317
- ### Additional Resources
234
+ **OSSA**: Vendor-neutral specification standard
235
+ **LangChain/AutoGen/Semantic Kernel**: Framework-specific implementations
236
+ **MCP**: Formal standard focused on context, not full agent lifecycle
318
237
 
319
- - **Specification**: [spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json](spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json)
238
+ - **Specification**: [spec/v0.2.8/ossa-0.2.8.schema.json](spec/v0.2.8/ossa-0.2.8.schema.json)
320
239
  - **Examples**: [examples/](examples/)
321
240
  - **API Reference**: [docs/](docs/)
241
+ - **Deployment Guides**: [GitHub Mirroring](https://openstandardagents.org/docs/deployment/github-mirroring)
322
242
  - **GitHub Issues**: https://github.com/blueflyio/openstandardagents/issues
323
243
 
324
244
  ---
325
245
 
326
246
  ## Contributing
327
247
 
328
- OSSA is an open standard. Contributions welcome.
248
+ OSSA is an open-source, community-driven project. We welcome contributions!
249
+
250
+ **Repository**: [github.com/blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
251
+ **Issues**: [github.com/blueflyio/openstandardagents/issues](https://github.com/blueflyio/openstandardagents/issues)
252
+ **Discussions**: [github.com/blueflyio/openstandardagents/discussions](https://github.com/blueflyio/openstandardagents/discussions)
329
253
 
330
- **Repository**: https://github.com/blueflyio/openstandardagents/
331
- **Homepage**: https://openstandardagents.org
332
- **Issues**: https://github.com/blueflyio/openstandardagents/issues
254
+ ### How to Contribute
333
255
 
334
256
  1. Fork the repository on GitHub
335
- 2. Create feature branch
336
- 3. Submit pull request
257
+ 2. Create a feature branch
258
+ 3. Make your changes
259
+ 4. Submit a pull request
337
260
 
338
- See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
261
+ See [CONTRIBUTING.md](https://github.com/blueflyio/openstandardagents/blob/main/CONTRIBUTING.md) for detailed guidelines.
262
+
263
+ ### Ways to Contribute
264
+
265
+ - **Code** - Improve the CLI, add examples, fix bugs
266
+ - **Documentation** - Improve docs, write tutorials
267
+ - **Examples** - Add framework integrations
268
+ - **Feedback** - Report issues, suggest features
269
+ - **Community** - Help others, answer questions
339
270
 
340
271
  ---
341
272
 
342
- ## License
273
+ ## Community
274
+
275
+ Join our growing community:
343
276
 
344
- Apache 2.0 - see [LICENSE](LICENSE) for details.
277
+ - **Discord**: [Join our community](https://discord.gg/ossa)
278
+ - **GitHub Discussions**: [github.com/blueflyio/openstandardagents/discussions](https://github.com/blueflyio/openstandardagents/discussions)
279
+ - **GitHub Issues**: [github.com/blueflyio/openstandardagents/issues](https://github.com/blueflyio/openstandardagents/issues)
345
280
 
346
281
  ---
347
282
 
348
- ## Part of the OSSA Ecosystem
283
+ ## License
284
+
285
+ Apache 2.0 - see [LICENSE](https://github.com/blueflyio/openstandardagents/blob/main/LICENSE) for details.
286
+
287
+ ---
349
288
 
350
- OSSA is part of a unified ecosystem for AI agent development:
289
+ ## About
351
290
 
352
- - **OSSA** - The open standard (this repository)
353
- - **Agent Buildkit** - CLI for building and managing agents
354
- - **Agent Studio** - GUI platform for agent orchestration
291
+ Open Standard Agents (OSSA) is a vendor-neutral specification created by Thomas Scola, founder of Bluefly.io.
355
292
 
356
293
  **OSSA: Open. Interoperable. Trustworthy.**
357
294
 
package/bin/ossa-dev ADDED
@@ -0,0 +1,42 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { spawn } from 'child_process';
4
+ import { watch } from 'fs';
5
+ import { resolve } from 'path';
6
+
7
+ const args = process.argv.slice(2);
8
+ const agentPath = args[0] || './agent.yaml';
9
+ const port = args[1] || '3000';
10
+
11
+ let server;
12
+
13
+ function startServer() {
14
+ if (server) server.kill();
15
+
16
+ console.log(`\n🚀 Starting OSSA agent: ${agentPath}`);
17
+ server = spawn('node', ['--loader', 'tsx', '-e', `
18
+ import { readFileSync } from 'fs';
19
+ import { createServer } from 'http';
20
+
21
+ const agent = readFileSync('${agentPath}', 'utf-8');
22
+
23
+ createServer((req, res) => {
24
+ res.writeHead(200, { 'Content-Type': 'application/json' });
25
+ res.end(JSON.stringify({ status: 'ok', agent: '${agentPath}' }));
26
+ }).listen(${port}, () => {
27
+ console.log('✓ Agent running on http://localhost:${port}');
28
+ });
29
+ `], { stdio: 'inherit' });
30
+ }
31
+
32
+ watch(resolve(agentPath), () => {
33
+ console.log('📝 Agent config changed, reloading...');
34
+ startServer();
35
+ });
36
+
37
+ startServer();
38
+
39
+ process.on('SIGINT', () => {
40
+ if (server) server.kill();
41
+ process.exit(0);
42
+ });
@@ -0,0 +1,32 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * OSSA Export Utility
5
+ * Quick export of OSSA manifests to various formats
6
+ */
7
+
8
+ const { execSync } = require('child_process');
9
+ const path = require('path');
10
+
11
+ const args = process.argv.slice(2);
12
+ const format = args[0];
13
+ const file = args[1];
14
+
15
+ if (!format || !file) {
16
+ console.log('Usage: ossa-export <format> <file>');
17
+ console.log('');
18
+ console.log('Formats:');
19
+ console.log(' cursor - Export to Cursor AI format');
20
+ console.log(' langchain - Export to LangChain format');
21
+ console.log(' openai - Export to OpenAI Assistants format');
22
+ console.log(' anthropic - Export to Anthropic Claude format');
23
+ console.log('');
24
+ console.log('Example: ossa-export cursor my-agent.ossa.yaml');
25
+ process.exit(1);
26
+ }
27
+
28
+ try {
29
+ execSync(`ossa export --to ${format} ${file}`, { stdio: 'inherit' });
30
+ } catch (error) {
31
+ process.exit(1);
32
+ }
@@ -0,0 +1,60 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { writeFileSync, mkdirSync } from 'fs';
4
+ import { join } from 'path';
5
+
6
+ const [type, name] = process.argv.slice(2);
7
+
8
+ if (!type || !name) {
9
+ console.log('Usage: ossa-generate <agent|adapter> <name>');
10
+ process.exit(1);
11
+ }
12
+
13
+ const templates = {
14
+ agent: `apiVersion: ossa.ai/v0.2.6
15
+ kind: Agent
16
+ metadata:
17
+ name: ${name}
18
+ version: 1.0.0
19
+ spec:
20
+ description: ${name} agent
21
+ capabilities:
22
+ - text-generation
23
+ interface:
24
+ input:
25
+ type: object
26
+ properties:
27
+ prompt:
28
+ type: string
29
+ output:
30
+ type: object
31
+ properties:
32
+ response:
33
+ type: string
34
+ `,
35
+ adapter: `import { Adapter } from '@ossa/core';
36
+
37
+ export class ${name.charAt(0).toUpperCase() + name.slice(1)}Adapter implements Adapter {
38
+ async execute(input: any): Promise<any> {
39
+ // Implementation
40
+ return { result: 'success' };
41
+ }
42
+ }
43
+ `
44
+ };
45
+
46
+ if (!templates[type]) {
47
+ console.log('❌ Unknown type. Use: agent or adapter');
48
+ process.exit(1);
49
+ }
50
+
51
+ const ext = type === 'agent' ? 'yaml' : 'ts';
52
+ const filename = `${name}.${ext}`;
53
+
54
+ try {
55
+ writeFileSync(filename, templates[type]);
56
+ console.log(`✓ Created ${type}: ${filename}`);
57
+ } catch (err) {
58
+ console.error('❌ Error:', err.message);
59
+ process.exit(1);
60
+ }