@bluefly/openstandardagents 0.2.7 → 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 (277) hide show
  1. package/.devfile.yaml +1 -1
  2. package/.env.example +1 -1
  3. package/.version.json +2 -2
  4. package/.wiki-config.json +24 -0
  5. package/CHANGELOG.md +11 -18
  6. package/CODEOWNERS +75 -0
  7. package/CONTRIBUTING.md +1 -1
  8. package/README.md +171 -243
  9. package/dist/index.d.ts +1 -0
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +2 -0
  12. package/dist/index.js.map +1 -1
  13. package/dist/repositories/schema.repository.d.ts +6 -1
  14. package/dist/repositories/schema.repository.d.ts.map +1 -1
  15. package/dist/repositories/schema.repository.js +49 -27
  16. package/dist/repositories/schema.repository.js.map +1 -1
  17. package/dist/services/migration.service.d.ts +4 -3
  18. package/dist/services/migration.service.d.ts.map +1 -1
  19. package/dist/services/migration.service.js +11 -10
  20. package/dist/services/migration.service.js.map +1 -1
  21. package/dist/services/release-automation/release.service.js +1 -1
  22. package/dist/services/release-automation/release.service.js.map +1 -1
  23. package/dist/services/release-automation/schemas/release.schema.js +1 -1
  24. package/dist/services/runtime/claude/claude-adapter.js +1 -1
  25. package/dist/services/runtime/claude/claude-adapter.js.map +1 -1
  26. package/dist/spec/v0.2.8/CHANGELOG.md +401 -0
  27. package/dist/spec/v0.2.8/README.md +72 -0
  28. package/dist/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
  29. package/dist/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  30. package/dist/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
  31. package/{spec/v0.2.6-dev/ossa-0.2.5.schema.json → dist/spec/v0.2.8/ossa-0.2.8.schema.json} +1509 -52
  32. package/dist/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
  33. package/dist/types/index.d.ts +3 -2
  34. package/dist/types/index.d.ts.map +1 -1
  35. package/dist/utils/index.d.ts +6 -0
  36. package/dist/utils/index.d.ts.map +1 -0
  37. package/dist/utils/index.js +6 -0
  38. package/dist/utils/index.js.map +1 -0
  39. package/dist/utils/version.d.ts +68 -0
  40. package/dist/utils/version.d.ts.map +1 -0
  41. package/dist/utils/version.js +156 -0
  42. package/dist/utils/version.js.map +1 -0
  43. package/eslint-report.json +1 -0
  44. package/examples/adk-integration/code-review-workflow.yml +1 -1
  45. package/examples/adk-integration/customer-support.yml +1 -1
  46. package/examples/adk-integration/data-pipeline.yml +1 -1
  47. package/examples/advanced/workflows/hybrid-model-strategy.yaml +1 -1
  48. package/examples/agent-manifests/critics/critic-agent.yaml +1 -1
  49. package/examples/agent-manifests/governors/governor-agent.yaml +1 -1
  50. package/examples/agent-manifests/integrators/integrator-agent.yaml +1 -1
  51. package/examples/agent-manifests/judges/judge-agent.yaml +1 -1
  52. package/examples/agent-manifests/monitors/monitor-agent.yaml +1 -1
  53. package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml +1 -1
  54. package/examples/agent-manifests/sample-compliant-agent.yaml +1 -1
  55. package/examples/agent-manifests/workers/worker-agent.yaml +1 -1
  56. package/examples/anthropic/claude-assistant.ossa.json +1 -1
  57. package/examples/autogen/multi-agent.ossa.json +1 -1
  58. package/examples/claude-code/code-reviewer.ossa.yaml +78 -0
  59. package/examples/claude-code/ossa-validator.ossa.yaml +80 -0
  60. package/examples/common_npm/agent-router.ossa.yaml +1 -0
  61. package/examples/common_npm/agent-router.v0.2.2.ossa.yaml +1 -1
  62. package/examples/crewai/research-team.ossa.json +1 -1
  63. package/examples/cursor/code-review-agent.ossa.json +1 -1
  64. package/examples/drupal/gitlab-ml-recommender.ossa.yaml +1 -0
  65. package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml +1 -1
  66. package/examples/extensions/drupal-v1.yml +1 -1
  67. package/examples/extensions/kagent-v1.yml +1 -1
  68. package/examples/getting-started/hello-world-complete.ossa.yaml +1 -1
  69. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +4 -4
  70. package/examples/kagent/compliance-validator.ossa.yaml +1 -1
  71. package/examples/kagent/cost-optimizer.ossa.yaml +1 -1
  72. package/examples/kagent/documentation-agent.ossa.yaml +1 -1
  73. package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml +1 -0
  74. package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml +1 -1
  75. package/examples/kagent/k8s-troubleshooter.ossa.yaml +1 -1
  76. package/examples/kagent/security-scanner.ossa.yaml +1 -1
  77. package/examples/langchain/chain-agent.ossa.json +1 -1
  78. package/examples/langflow/workflow-agent.ossa.json +1 -1
  79. package/examples/langgraph/state-machine-agent.ossa.json +1 -1
  80. package/examples/llamaindex/rag-agent.ossa.json +1 -1
  81. package/examples/migration-guides/from-langchain-to-ossa.yaml +4 -4
  82. package/examples/multi-agent/README.md +74 -0
  83. package/examples/multi-agent/conditional-router.ossa.yaml +42 -0
  84. package/examples/multi-agent/parallel-execution.ossa.yaml +54 -0
  85. package/examples/multi-agent/sequential-pipeline.ossa.yaml +45 -0
  86. package/examples/openai/basic-agent.ossa.yaml +1 -1
  87. package/examples/openai/multi-tool-agent.ossa.json +1 -1
  88. package/examples/openai/swarm-agent.ossa.json +1 -1
  89. package/examples/production/document-analyzer-openai.yml +1 -1
  90. package/examples/quickstart/support-agent.ossa.yaml +1 -1
  91. package/examples/spec-examples/audit-agent.yml +1 -1
  92. package/examples/spec-examples/chat-agent.yml +1 -1
  93. package/examples/spec-examples/compliance-agent.yml +1 -1
  94. package/examples/spec-examples/monitoring-agent.yml +1 -1
  95. package/examples/spec-examples/workflow-agent.yml +1 -1
  96. package/examples/templates/ossa-compliance.yaml +1 -1
  97. package/examples/vercel/edge-agent.ossa.json +1 -1
  98. package/gl-code-quality-report.json +62 -0
  99. package/llms-ctx-full.txt +39 -0
  100. package/llms-ctx.txt +39 -0
  101. package/llms.txt +47 -0
  102. package/package.json +3 -2
  103. package/scripts/eslint-to-codequality.cjs +34 -0
  104. package/scripts/generate-llms-ctx.sh +17 -0
  105. package/scripts/generate-schema-docs.ts +31 -10
  106. package/scripts/sync-version.js +4 -12
  107. package/scripts/validate-schema.ts +2 -1
  108. package/spec/v0.2.8/CHANGELOG.md +401 -0
  109. package/spec/v0.2.8/README.md +72 -0
  110. package/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
  111. package/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  112. package/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
  113. package/{dist/spec/v0.2.6-dev/ossa-0.2.5.schema.json → spec/v0.2.8/ossa-0.2.8.schema.json} +1509 -52
  114. package/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
  115. package/test-results/junit.xml +299 -0
  116. package/bin/validate-ossa-0.2.5-RC.ts +0 -244
  117. package/dist/spec/v0.2.6-dev/ossa-0.2.6-dev.schema.json +0 -1696
  118. package/scripts/lib/exec.ts +0 -37
  119. package/scripts/lib/file-ops.ts +0 -58
  120. package/scripts/lib/version.ts +0 -83
  121. package/spec/v0.2.6-dev/ossa-0.2.6-dev.schema.json +0 -1696
  122. package/website/.lighthouserc.ts +0 -24
  123. package/website/.prettierrc +0 -10
  124. package/website/DESIGN_SYSTEM_IMPLEMENTATION.md +0 -445
  125. package/website/Dockerfile +0 -30
  126. package/website/app/about/page.tsx +0 -304
  127. package/website/app/blog/[slug]/page.tsx +0 -208
  128. package/website/app/blog/page.tsx +0 -249
  129. package/website/app/design-guide/page.tsx +0 -511
  130. package/website/app/docs/[[...slug]]/page.tsx +0 -847
  131. package/website/app/docs/core-concepts/project-structure/page.tsx +0 -349
  132. package/website/app/ecosystem/page.tsx +0 -410
  133. package/website/app/examples/page.tsx +0 -133
  134. package/website/app/globals.scss +0 -370
  135. package/website/app/layout.tsx +0 -106
  136. package/website/app/license/page.tsx +0 -183
  137. package/website/app/not-found.tsx +0 -18
  138. package/website/app/page.tsx +0 -686
  139. package/website/app/page.tsx.bak +0 -679
  140. package/website/app/page.tsx.bak2 +0 -649
  141. package/website/app/playground/page.tsx +0 -487
  142. package/website/app/robots.ts +0 -19
  143. package/website/app/rss.xml/route.ts +0 -74
  144. package/website/app/schema/page.tsx +0 -1001
  145. package/website/app/sitemap.ts +0 -56
  146. package/website/app/specification/page.tsx +0 -287
  147. package/website/components/InstallCommand.tsx +0 -96
  148. package/website/components/Logo.tsx +0 -97
  149. package/website/components/StructuredData.tsx +0 -65
  150. package/website/components/docs/DocsSearch.tsx +0 -104
  151. package/website/components/docs/DocsSidebar.tsx +0 -155
  152. package/website/components/docs/MarkdownContent.tsx +0 -401
  153. package/website/components/docs/VersionSelector.tsx +0 -105
  154. package/website/components/examples/ExamplesViewer.tsx +0 -293
  155. package/website/components/layout/Footer.tsx +0 -116
  156. package/website/components/layout/Header.tsx +0 -172
  157. package/website/components/schema/SchemaComponentsAccordion.tsx +0 -84
  158. package/website/components/schema/SchemaExplorer.tsx +0 -213
  159. package/website/components/ui/Badge.tsx +0 -82
  160. package/website/components/ui/Button.tsx +0 -116
  161. package/website/components/ui/Card.tsx +0 -167
  162. package/website/components/ui/Checkbox.tsx +0 -141
  163. package/website/components/ui/Input.tsx +0 -169
  164. package/website/components/ui/Radio.tsx +0 -141
  165. package/website/components/ui/Select.tsx +0 -182
  166. package/website/components/ui/Tag.tsx +0 -158
  167. package/website/components/ui/Textarea.tsx +0 -195
  168. package/website/components/ui/index.ts +0 -11
  169. package/website/content/blog/OpenAPI-AI-Agents-Standard.md +0 -285
  170. package/website/content/blog/Why-Formal-Standards-Matter-Now.md +0 -198
  171. package/website/content/blog/gitlab-kubernetes-agent-ecosystem.md +0 -286
  172. package/website/content/blog/introducing-ossa-framework.md +0 -328
  173. package/website/content/blog/ossa-production-results.md +0 -279
  174. package/website/content/blog/welcome-to-ossa.md +0 -43
  175. package/website/content/blog/why-ai-agents-need-open-standard.md +0 -98
  176. package/website/content/docs/00-home.md +0 -153
  177. package/website/content/docs/adapters/openai-adapter.md +0 -693
  178. package/website/content/docs/agents/catalog.md +0 -28
  179. package/website/content/docs/aiflow-framework-integration-with-ossa.md +0 -107
  180. package/website/content/docs/api-reference/index.md +0 -38
  181. package/website/content/docs/api-reference/ossa-core-api.md +0 -634
  182. package/website/content/docs/api-reference/ossa-registry-api.md +0 -515
  183. package/website/content/docs/api-reference/unified-agent-gateway.md +0 -599
  184. package/website/content/docs/architecture/execution-flow.md +0 -335
  185. package/website/content/docs/architecture/multi-agent-systems.md +0 -737
  186. package/website/content/docs/architecture/overview.md +0 -121
  187. package/website/content/docs/architecture/stack-integration.md +0 -461
  188. package/website/content/docs/changelog.md +0 -246
  189. package/website/content/docs/cli-reference/index.md +0 -111
  190. package/website/content/docs/cli-reference/ossa-agents.md +0 -70
  191. package/website/content/docs/cli-reference/ossa-export.md +0 -56
  192. package/website/content/docs/cli-reference/ossa-generate.md +0 -66
  193. package/website/content/docs/cli-reference/ossa-gitlab-agent.md +0 -57
  194. package/website/content/docs/cli-reference/ossa-import.md +0 -56
  195. package/website/content/docs/cli-reference/ossa-init.md +0 -57
  196. package/website/content/docs/cli-reference/ossa-migrate.md +0 -62
  197. package/website/content/docs/cli-reference/ossa-run.md +0 -66
  198. package/website/content/docs/cli-reference/ossa-schema.md +0 -57
  199. package/website/content/docs/cli-reference/ossa-setup.md +0 -57
  200. package/website/content/docs/cli-reference/ossa-validate.md +0 -66
  201. package/website/content/docs/configuration/index.md +0 -97
  202. package/website/content/docs/contributing.md +0 -599
  203. package/website/content/docs/deployment/github-mirroring.md +0 -924
  204. package/website/content/docs/documentation.md +0 -100
  205. package/website/content/docs/ecosystem/framework-support.md +0 -1361
  206. package/website/content/docs/ecosystem/overview.md +0 -366
  207. package/website/content/docs/errors/index.md +0 -10
  208. package/website/content/docs/examples/aiflow-framework-integration-with-ossa.md +0 -107
  209. package/website/content/docs/examples/catalog.md +0 -300
  210. package/website/content/docs/for-audiences/students-researchers.md +0 -122
  211. package/website/content/docs/getting-started/index.md +0 -92
  212. package/website/content/docs/getting-started/installation.md +0 -155
  213. package/website/content/docs/getting-started/running-agents.md +0 -309
  214. package/website/content/docs/getting-started.md +0 -91
  215. package/website/content/docs/integrations/aiflow.md +0 -104
  216. package/website/content/docs/integrations/drupal.md +0 -105
  217. package/website/content/docs/migration-guides/agent-schema-comparison.md +0 -232
  218. package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +0 -1750
  219. package/website/content/docs/migration-guides/crewai-to-ossa.md +0 -274
  220. package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +0 -2017
  221. package/website/content/docs/migration-guides/general-agent-schema.yml +0 -247
  222. package/website/content/docs/migration-guides/index.md +0 -133
  223. package/website/content/docs/migration-guides/langchain-to-ossa.md +0 -1714
  224. package/website/content/docs/migration-guides/langflow-to-ossa.md +0 -2075
  225. package/website/content/docs/migration-guides/migration-manifest.json +0 -64
  226. package/website/content/docs/migration-guides/openai-to-ossa.md +0 -1202
  227. package/website/content/docs/openapi-extensions/examples.md +0 -550
  228. package/website/content/docs/openapi-extensions/index.md +0 -551
  229. package/website/content/docs/openapi-extensions/operation-extensions.md +0 -457
  230. package/website/content/docs/openapi-extensions/root-extensions.md +0 -410
  231. package/website/content/docs/ossa-compliant-badge.md +0 -251
  232. package/website/content/docs/pre-release/index.md +0 -175
  233. package/website/content/docs/quick-reference.md +0 -17
  234. package/website/content/docs/readme.md +0 -35
  235. package/website/content/docs/releases/v0.2.6.md +0 -99
  236. package/website/content/docs/schema-reference/agent-capabilities.md +0 -50
  237. package/website/content/docs/schema-reference/agent-id.md +0 -52
  238. package/website/content/docs/schema-reference/agent-name.md +0 -50
  239. package/website/content/docs/schema-reference/agent-role.md +0 -54
  240. package/website/content/docs/schema-reference/agent-spec.md +0 -406
  241. package/website/content/docs/schema-reference/agent-version.md +0 -50
  242. package/website/content/docs/schema-reference/autonomy.md +0 -568
  243. package/website/content/docs/schema-reference/constraints.md +0 -543
  244. package/website/content/docs/schema-reference/index.md +0 -45
  245. package/website/content/docs/schema-reference/llm-config.md +0 -445
  246. package/website/content/docs/schema-reference/observability.md +0 -654
  247. package/website/content/docs/schema-reference/ossa-manifest.md +0 -309
  248. package/website/content/docs/schema-reference/taxonomy.md +0 -509
  249. package/website/content/docs/schema-reference/tools.md +0 -628
  250. package/website/content/docs/templates/blog-post.md +0 -43
  251. package/website/content/docs/types-reference/index.md +0 -105
  252. package/website/content/docs/use-cases/00-index.md +0 -395
  253. package/website/content/docs/use-cases/cicd-code-review.md +0 -1236
  254. package/website/content/docs/use-cases/customer-support.md +0 -1234
  255. package/website/content/docs/use-cases/enterprise-compliance.md +0 -1208
  256. package/website/content/docs/use-cases/research-multi-agent.md +0 -1161
  257. package/website/content/docs/versioning.md +0 -288
  258. package/website/dev.sh +0 -53
  259. package/website/docker-compose.dev.yml +0 -36
  260. package/website/lib/version.ts +0 -35
  261. package/website/lib/versions.json +0 -103
  262. package/website/next.config.ts +0 -18
  263. package/website/nginx.conf +0 -32
  264. package/website/package-lock.json +0 -9679
  265. package/website/package.json +0 -59
  266. package/website/postcss.config.mjs +0 -9
  267. package/website/scripts/fetch-versions.js +0 -166
  268. package/website/scripts/generate-examples-index.js +0 -163
  269. package/website/scripts/merge-docs-to-wiki.ts +0 -207
  270. package/website/scripts/sync-version.js +0 -72
  271. package/website/scripts/sync-wiki.ts +0 -322
  272. package/website/scripts/upload-wiki.ts +0 -199
  273. package/website/styles/_spacing.scss +0 -453
  274. package/website/styles/_tokens.scss +0 -245
  275. package/website/styles/_typography.scss +0 -361
  276. package/website/styles/_variables.scss +0 -287
  277. package/website/tailwind.config.ts +0 -170
@@ -1,247 +0,0 @@
1
- openapi: 3.0.3
2
- info:
3
- title: General Agent API Schema
4
- description: A generalized agent schema for comparison with GitLab Duo Agent API
5
- version: 1.0.0
6
-
7
- components:
8
- schemas:
9
- Agent:
10
- type: object
11
- properties:
12
- id:
13
- type: string
14
- format: uuid
15
- name:
16
- type: string
17
- description:
18
- type: string
19
- agent_type:
20
- type: string
21
- enum: [cli, web, chat, workflow, autonomous]
22
- status:
23
- type: string
24
- enum: [active, inactive, paused, error, training]
25
- capabilities:
26
- type: array
27
- items:
28
- type: string
29
- enum: [code_generation, code_review, issue_analysis, documentation, testing, deployment]
30
- configuration:
31
- type: object
32
- properties:
33
- model:
34
- type: string
35
- provider:
36
- type: string
37
- enum: [openai, anthropic, cohere, local]
38
- temperature:
39
- type: number
40
- minimum: 0
41
- maximum: 2
42
- max_tokens:
43
- type: integer
44
- minimum: 1
45
- permissions:
46
- type: array
47
- items:
48
- type: string
49
- enum: [read, write, execute, admin]
50
- created_at:
51
- type: string
52
- format: date-time
53
- updated_at:
54
- type: string
55
- format: date-time
56
- last_activity:
57
- type: string
58
- format: date-time
59
- metadata:
60
- type: object
61
- additionalProperties: true
62
-
63
- CreateAgentRequest:
64
- type: object
65
- required:
66
- - name
67
- - agent_type
68
- - capabilities
69
- properties:
70
- name:
71
- type: string
72
- description:
73
- type: string
74
- agent_type:
75
- type: string
76
- enum: [cli, web, chat, workflow, autonomous]
77
- capabilities:
78
- type: array
79
- items:
80
- type: string
81
- configuration:
82
- type: object
83
- permissions:
84
- type: array
85
- items:
86
- type: string
87
- metadata:
88
- type: object
89
- additionalProperties: true
90
-
91
- AgentExecution:
92
- type: object
93
- properties:
94
- execution_id:
95
- type: string
96
- format: uuid
97
- agent_id:
98
- type: string
99
- format: uuid
100
- task:
101
- type: object
102
- properties:
103
- description:
104
- type: string
105
- input_data:
106
- type: object
107
- context:
108
- type: object
109
- status:
110
- type: string
111
- enum: [pending, running, completed, failed, cancelled]
112
- result:
113
- type: object
114
- properties:
115
- output:
116
- type: string
117
- artifacts:
118
- type: array
119
- items:
120
- type: string
121
- metrics:
122
- type: object
123
- logs:
124
- type: array
125
- items:
126
- type: object
127
- properties:
128
- timestamp:
129
- type: string
130
- format: date-time
131
- level:
132
- type: string
133
- enum: [debug, info, warning, error]
134
- message:
135
- type: string
136
- started_at:
137
- type: string
138
- format: date-time
139
- completed_at:
140
- type: string
141
- format: date-time
142
- duration_ms:
143
- type: integer
144
-
145
- AgentTrigger:
146
- type: object
147
- properties:
148
- id:
149
- type: string
150
- format: uuid
151
- agent_id:
152
- type: string
153
- format: uuid
154
- name:
155
- type: string
156
- trigger_type:
157
- type: string
158
- enum: [manual, scheduled, event_based, api_call, webhook]
159
- event_config:
160
- type: object
161
- properties:
162
- events:
163
- type: array
164
- items:
165
- type: string
166
- conditions:
167
- type: object
168
- schedule:
169
- type: object
170
- properties:
171
- cron_expression:
172
- type: string
173
- timezone:
174
- type: string
175
- status:
176
- type: string
177
- enum: [active, inactive]
178
- created_at:
179
- type: string
180
- format: date-time
181
- last_triggered:
182
- type: string
183
- format: date-time
184
- nullable: true
185
-
186
- AgentSkill:
187
- type: object
188
- properties:
189
- id:
190
- type: string
191
- format: uuid
192
- name:
193
- type: string
194
- description:
195
- type: string
196
- skill_type:
197
- type: string
198
- enum: [tool, knowledge, workflow]
199
- input_schema:
200
- type: object
201
- output_schema:
202
- type: object
203
- implementation:
204
- type: object
205
- properties:
206
- type:
207
- type: string
208
- enum: [function, api_call, script, workflow]
209
- endpoint:
210
- type: string
211
- parameters:
212
- type: object
213
- version:
214
- type: string
215
- status:
216
- type: string
217
- enum: [active, deprecated, experimental]
218
-
219
- AgentMemory:
220
- type: object
221
- properties:
222
- id:
223
- type: string
224
- format: uuid
225
- agent_id:
226
- type: string
227
- format: uuid
228
- memory_type:
229
- type: string
230
- enum: [short_term, long_term, episodic, semantic]
231
- content:
232
- type: object
233
- embedding:
234
- type: array
235
- items:
236
- type: number
237
- metadata:
238
- type: object
239
- created_at:
240
- type: string
241
- format: date-time
242
- last_accessed:
243
- type: string
244
- format: date-time
245
- access_count:
246
- type: integer
247
- default: 0
@@ -1,133 +0,0 @@
1
- ---
2
- title: "README"
3
- ---
4
-
5
- # Migration Guides
6
-
7
- Comprehensive guides for migrating to or extending with OSSA (Open Standards for Scalable Agents).
8
-
9
- ## Available Guides
10
-
11
- ### 1. [Anthropic MCP to OSSA](./Anthropic-MCP-to-OSSA.md)
12
- **Extend Anthropic Model Context Protocol servers with OSSA**
13
-
14
- - **Target Audience:** MCP server developers, Claude Desktop users
15
- - **Complexity:** Intermediate
16
- - **Time to Complete:** 2-4 hours
17
- - **Key Benefits:**
18
- - Keep MCP compatibility
19
- - Add HTTP/REST API support
20
- - Enable production monitoring
21
- - Deploy to Kubernetes
22
- - Multi-protocol access (MCP + OpenAPI + A2A)
23
-
24
- **Topics Covered:**
25
- - MCP servers → OSSA agents
26
- - MCP tools → OSSA capabilities
27
- - MCP resources → OSSA data sources
28
- - Dual-mode implementation (stdio + HTTP)
29
- - Integration patterns
30
- - 3 complete before/after examples
31
-
32
- ---
33
-
34
- ### 2. [LangChain to OSSA](./LangChain-to-OSSA.md)
35
- **Migrate Python LangChain agents to OSSA specification**
36
-
37
- - **Target Audience:** LangChain developers, Python AI engineers
38
- - **Complexity:** Intermediate to Advanced
39
- - **Time to Complete:** 4-8 hours
40
- - **Key Benefits:**
41
- - Language-agnostic deployment
42
- - Better orchestration
43
- - Production-ready infrastructure
44
- - Multi-framework support
45
-
46
- ---
47
-
48
- ## Quick Decision Guide
49
-
50
- **Choose the right guide based on your current stack:**
51
-
52
- ```
53
- Have MCP servers? → Use "Anthropic MCP to OSSA"
54
- ├─ Already working in Claude Desktop?
55
- │ └─ Keep MCP, add OSSA for production features
56
-
57
- Have LangChain agents? → Use "LangChain to OSSA"
58
- ├─ Python-based AI workflows?
59
- │ └─ Migrate to OSSA for better orchestration
60
-
61
- Starting fresh? → Check Getting Started guide
62
- └─ Use OSSA from day one
63
- ```
64
-
65
- ## Common Scenarios
66
-
67
- ### Scenario 1: "I have MCP servers for Claude Desktop"
68
- → **Use:** [Anthropic MCP to OSSA](./Anthropic-MCP-to-OSSA.md)
69
- - Extend with HTTP API
70
- - Add monitoring/metrics
71
- - Deploy to production
72
-
73
- ### Scenario 2: "I have LangChain Python agents"
74
- → **Use:** [LangChain to OSSA](./LangChain-to-OSSA.md)
75
- - Migrate to TypeScript/Node.js
76
- - Add multi-protocol support
77
- - Enable agent orchestration
78
-
79
- ### Scenario 3: "I want to expose my agent via multiple protocols"
80
- → **Use:** [Anthropic MCP to OSSA](./Anthropic-MCP-to-OSSA.md)
81
- - MCP for Claude Desktop
82
- - OpenAPI for REST clients
83
- - A2A for agent-to-agent communication
84
-
85
- ## Migration Roadmap
86
-
87
- ```
88
- 1. Assessment (1-2 hours)
89
- ├─ Inventory existing agents/servers
90
- ├─ Identify required features
91
- └─ Choose migration guide
92
-
93
- 2. Planning (2-4 hours)
94
- ├─ Map existing functionality to OSSA
95
- ├─ Design agent manifest
96
- └─ Plan deployment strategy
97
-
98
- 3. Implementation (4-8 hours)
99
- ├─ Create OSSA agent structure
100
- ├─ Migrate business logic
101
- ├─ Configure bridges (MCP, OpenAPI, etc.)
102
- └─ Add monitoring
103
-
104
- 4. Testing (2-4 hours)
105
- ├─ Test all protocols
106
- ├─ Verify backward compatibility
107
- └─ Load testing
108
-
109
- 5. Deployment (2-4 hours)
110
- ├─ Deploy to target environment
111
- ├─ Configure monitoring
112
- └─ Update client configurations
113
- ```
114
-
115
- ## Support
116
-
117
- - **Documentation:** `/Users/flux423/Sites/LLM/agent-buildkit/docs/`
118
- - **Examples:** `/Users/flux423/Sites/LLM/agent-buildkit/.agents/`
119
- - **OSSA Spec:** [Schema Reference](/docs/schema-reference)
120
- - **BuildKit CLI:** `buildkit agents --help`
121
-
122
- ## Contributing
123
-
124
- Found an issue or want to add a migration guide?
125
-
126
- 1. Create an issue: [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
127
- 2. Submit a merge request with your guide
128
- 3. Follow the existing structure and format
129
-
130
- ---
131
-
132
- **Last Updated:** 2025-11-10
133
- **Maintained By:** Agent BuildKit Team