@bluefly/openstandardagents 0.4.0 → 0.4.2

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 (517) hide show
  1. package/CHANGELOG.md +137 -0
  2. package/DEMO.md +212 -0
  3. package/README.md +77 -17
  4. package/dist/adapters/drupal/generator.d.ts +149 -0
  5. package/dist/adapters/drupal/generator.d.ts.map +1 -0
  6. package/dist/adapters/drupal/generator.js +1760 -0
  7. package/dist/adapters/drupal/generator.js.map +1 -0
  8. package/dist/adapters/drupal/index.d.ts +2 -0
  9. package/dist/adapters/drupal/index.d.ts.map +1 -1
  10. package/dist/adapters/drupal/index.js +3 -0
  11. package/dist/adapters/drupal/index.js.map +1 -1
  12. package/dist/adapters/npm/adapter.js +2 -2
  13. package/dist/adapters/npm/converter.js +3 -3
  14. package/dist/cli/banner.d.ts +21 -0
  15. package/dist/cli/banner.d.ts.map +1 -0
  16. package/dist/cli/banner.js +128 -0
  17. package/dist/cli/banner.js.map +1 -0
  18. package/dist/cli/commands/dev.command.d.ts +20 -0
  19. package/dist/cli/commands/dev.command.d.ts.map +1 -0
  20. package/dist/cli/commands/dev.command.js +78 -0
  21. package/dist/cli/commands/dev.command.js.map +1 -0
  22. package/dist/cli/commands/estimate.command.d.ts +12 -0
  23. package/dist/cli/commands/estimate.command.d.ts.map +1 -0
  24. package/dist/cli/commands/estimate.command.js +226 -0
  25. package/dist/cli/commands/estimate.command.js.map +1 -0
  26. package/dist/cli/commands/export-enhanced.command.d.ts +7 -0
  27. package/dist/cli/commands/export-enhanced.command.d.ts.map +1 -0
  28. package/dist/cli/commands/{export-v2.command.js → export-enhanced.command.js} +3 -3
  29. package/dist/cli/commands/export-enhanced.command.js.map +1 -0
  30. package/dist/cli/commands/export.command.d.ts.map +1 -1
  31. package/dist/cli/commands/export.command.js +82 -4
  32. package/dist/cli/commands/export.command.js.map +1 -1
  33. package/dist/cli/commands/init.command.d.ts.map +1 -1
  34. package/dist/cli/commands/init.command.js +2 -0
  35. package/dist/cli/commands/init.command.js.map +1 -1
  36. package/dist/cli/commands/test.command.d.ts +1 -0
  37. package/dist/cli/commands/test.command.d.ts.map +1 -1
  38. package/dist/cli/commands/test.command.js +172 -105
  39. package/dist/cli/commands/test.command.js.map +1 -1
  40. package/dist/cli/commands/types/wizard-config.types.d.ts +59 -0
  41. package/dist/cli/commands/types/wizard-config.types.d.ts.map +1 -0
  42. package/dist/cli/commands/types/wizard-config.types.js +34 -0
  43. package/dist/cli/commands/types/wizard-config.types.js.map +1 -0
  44. package/dist/cli/commands/upgrade.command.d.ts +9 -0
  45. package/dist/cli/commands/upgrade.command.d.ts.map +1 -0
  46. package/dist/cli/commands/upgrade.command.js +167 -0
  47. package/dist/cli/commands/upgrade.command.js.map +1 -0
  48. package/dist/cli/commands/wizard-api-first.command.d.ts +18 -0
  49. package/dist/cli/commands/wizard-api-first.command.d.ts.map +1 -0
  50. package/dist/cli/commands/wizard-api-first.command.js +854 -0
  51. package/dist/cli/commands/wizard-api-first.command.js.map +1 -0
  52. package/dist/cli/commands/wizard-interactive.command.d.ts +25 -0
  53. package/dist/cli/commands/wizard-interactive.command.d.ts.map +1 -0
  54. package/dist/cli/commands/wizard-interactive.command.js +1875 -0
  55. package/dist/cli/commands/wizard-interactive.command.js.map +1 -0
  56. package/dist/cli/commands/workspace.command.js +1 -1
  57. package/dist/cli/commands/workspace.command.js.map +1 -1
  58. package/dist/cli/index.js +9 -0
  59. package/dist/cli/index.js.map +1 -1
  60. package/dist/cli/schema-driven/index.d.ts +27 -0
  61. package/dist/cli/schema-driven/index.d.ts.map +1 -0
  62. package/dist/cli/schema-driven/index.js +34 -0
  63. package/dist/cli/schema-driven/index.js.map +1 -0
  64. package/dist/cli/schema-driven/schema-loader.d.ts +115 -0
  65. package/dist/cli/schema-driven/schema-loader.d.ts.map +1 -0
  66. package/dist/cli/schema-driven/schema-loader.js +270 -0
  67. package/dist/cli/schema-driven/schema-loader.js.map +1 -0
  68. package/dist/cli/schema-driven/ui-generator.d.ts +88 -0
  69. package/dist/cli/schema-driven/ui-generator.d.ts.map +1 -0
  70. package/dist/cli/schema-driven/ui-generator.js +326 -0
  71. package/dist/cli/schema-driven/ui-generator.js.map +1 -0
  72. package/dist/cli/wizard/interactive-wizard.d.ts +26 -0
  73. package/dist/cli/wizard/interactive-wizard.d.ts.map +1 -0
  74. package/dist/cli/wizard/interactive-wizard.js +296 -0
  75. package/dist/cli/wizard/interactive-wizard.js.map +1 -0
  76. package/dist/cli/wizard/template-catalog.d.ts +32 -0
  77. package/dist/cli/wizard/template-catalog.d.ts.map +1 -0
  78. package/dist/cli/wizard/template-catalog.js +99 -0
  79. package/dist/cli/wizard/template-catalog.js.map +1 -0
  80. package/dist/cli/wizard/use-cases.d.ts +37 -0
  81. package/dist/cli/wizard/use-cases.d.ts.map +1 -0
  82. package/dist/cli/wizard/use-cases.js +157 -0
  83. package/dist/cli/wizard/use-cases.js.map +1 -0
  84. package/dist/di-container.d.ts.map +1 -1
  85. package/dist/di-container.js +2 -0
  86. package/dist/di-container.js.map +1 -1
  87. package/dist/package.json +33 -11
  88. package/dist/runtime/agent-runner.d.ts +46 -0
  89. package/dist/runtime/agent-runner.d.ts.map +1 -0
  90. package/dist/runtime/agent-runner.js +346 -0
  91. package/dist/runtime/agent-runner.js.map +1 -0
  92. package/dist/sdks/kagent/crd-generator.d.ts +4 -0
  93. package/dist/sdks/kagent/crd-generator.d.ts.map +1 -1
  94. package/dist/sdks/kagent/crd-generator.js +83 -2
  95. package/dist/sdks/kagent/crd-generator.js.map +1 -1
  96. package/dist/sdks/kagent/k8s-resources-generator.d.ts +73 -0
  97. package/dist/sdks/kagent/k8s-resources-generator.d.ts.map +1 -0
  98. package/dist/sdks/kagent/k8s-resources-generator.js +286 -0
  99. package/dist/sdks/kagent/k8s-resources-generator.js.map +1 -0
  100. package/dist/sdks/kagent/types.d.ts +79 -0
  101. package/dist/sdks/kagent/types.d.ts.map +1 -1
  102. package/dist/sdks/shared/validation.d.ts +2 -2
  103. package/dist/services/cost-estimation/optimization-patterns.d.ts +23 -0
  104. package/dist/services/cost-estimation/optimization-patterns.d.ts.map +1 -0
  105. package/dist/services/cost-estimation/optimization-patterns.js +147 -0
  106. package/dist/services/cost-estimation/optimization-patterns.js.map +1 -0
  107. package/dist/services/cost-estimation/pricing.d.ts +29 -0
  108. package/dist/services/cost-estimation/pricing.d.ts.map +1 -0
  109. package/dist/services/cost-estimation/pricing.js +225 -0
  110. package/dist/services/cost-estimation/pricing.js.map +1 -0
  111. package/dist/services/cost-estimation/scenario-estimator.d.ts +59 -0
  112. package/dist/services/cost-estimation/scenario-estimator.d.ts.map +1 -0
  113. package/dist/services/cost-estimation/scenario-estimator.js +145 -0
  114. package/dist/services/cost-estimation/scenario-estimator.js.map +1 -0
  115. package/dist/services/cost-estimation/token-counter.service.d.ts +51 -0
  116. package/dist/services/cost-estimation/token-counter.service.d.ts.map +1 -0
  117. package/dist/services/cost-estimation/token-counter.service.js +125 -0
  118. package/dist/services/cost-estimation/token-counter.service.js.map +1 -0
  119. package/dist/services/dev-server/dev-server.service.d.ts +121 -0
  120. package/dist/services/dev-server/dev-server.service.d.ts.map +1 -0
  121. package/dist/services/dev-server/dev-server.service.js +290 -0
  122. package/dist/services/dev-server/dev-server.service.js.map +1 -0
  123. package/dist/services/dev-server/file-watcher.d.ts +101 -0
  124. package/dist/services/dev-server/file-watcher.d.ts.map +1 -0
  125. package/dist/services/dev-server/file-watcher.js +190 -0
  126. package/dist/services/dev-server/file-watcher.js.map +1 -0
  127. package/dist/services/dev-server/live-validator.d.ts +157 -0
  128. package/dist/services/dev-server/live-validator.d.ts.map +1 -0
  129. package/dist/services/dev-server/live-validator.js +301 -0
  130. package/dist/services/dev-server/live-validator.js.map +1 -0
  131. package/dist/services/dev-server/websocket-server.d.ts +137 -0
  132. package/dist/services/dev-server/websocket-server.d.ts.map +1 -0
  133. package/dist/services/dev-server/websocket-server.js +229 -0
  134. package/dist/services/dev-server/websocket-server.js.map +1 -0
  135. package/dist/services/export/anthropic/anthropic-exporter.d.ts +70 -0
  136. package/dist/services/export/anthropic/anthropic-exporter.d.ts.map +1 -0
  137. package/dist/services/export/anthropic/anthropic-exporter.js +576 -0
  138. package/dist/services/export/anthropic/anthropic-exporter.js.map +1 -0
  139. package/dist/services/export/anthropic/api-generator.d.ts +39 -0
  140. package/dist/services/export/anthropic/api-generator.d.ts.map +1 -0
  141. package/dist/services/export/anthropic/api-generator.js +395 -0
  142. package/dist/services/export/anthropic/api-generator.js.map +1 -0
  143. package/dist/services/export/anthropic/index.d.ts +18 -0
  144. package/dist/services/export/anthropic/index.d.ts.map +1 -0
  145. package/dist/services/export/anthropic/index.js +16 -0
  146. package/dist/services/export/anthropic/index.js.map +1 -0
  147. package/dist/services/export/anthropic/tools-generator.d.ts +35 -0
  148. package/dist/services/export/anthropic/tools-generator.d.ts.map +1 -0
  149. package/dist/services/export/anthropic/tools-generator.js +260 -0
  150. package/dist/services/export/anthropic/tools-generator.js.map +1 -0
  151. package/dist/services/export/langchain/api-generator.d.ts +17 -0
  152. package/dist/services/export/langchain/api-generator.d.ts.map +1 -0
  153. package/dist/services/export/langchain/api-generator.js +375 -0
  154. package/dist/services/export/langchain/api-generator.js.map +1 -0
  155. package/dist/services/export/langchain/callbacks-generator.d.ts +63 -0
  156. package/dist/services/export/langchain/callbacks-generator.d.ts.map +1 -0
  157. package/dist/services/export/langchain/callbacks-generator.js +408 -0
  158. package/dist/services/export/langchain/callbacks-generator.js.map +1 -0
  159. package/dist/services/export/langchain/error-handling-generator.d.ts +76 -0
  160. package/dist/services/export/langchain/error-handling-generator.d.ts.map +1 -0
  161. package/dist/services/export/langchain/error-handling-generator.js +522 -0
  162. package/dist/services/export/langchain/error-handling-generator.js.map +1 -0
  163. package/dist/services/export/langchain/index.d.ts +17 -0
  164. package/dist/services/export/langchain/index.d.ts.map +1 -0
  165. package/dist/services/export/langchain/index.js +13 -0
  166. package/dist/services/export/langchain/index.js.map +1 -0
  167. package/dist/services/export/langchain/langchain-exporter.d.ts +174 -0
  168. package/dist/services/export/langchain/langchain-exporter.d.ts.map +1 -0
  169. package/dist/services/export/langchain/langchain-exporter.js +953 -0
  170. package/dist/services/export/langchain/langchain-exporter.js.map +1 -0
  171. package/dist/services/export/langchain/langgraph-generator.d.ts +86 -0
  172. package/dist/services/export/langchain/langgraph-generator.d.ts.map +1 -0
  173. package/dist/services/export/langchain/langgraph-generator.js +473 -0
  174. package/dist/services/export/langchain/langgraph-generator.js.map +1 -0
  175. package/dist/services/export/langchain/langserve-generator.d.ts +95 -0
  176. package/dist/services/export/langchain/langserve-generator.d.ts.map +1 -0
  177. package/dist/services/export/langchain/langserve-generator.js +807 -0
  178. package/dist/services/export/langchain/langserve-generator.js.map +1 -0
  179. package/dist/services/export/langchain/memory-generator.d.ts +71 -0
  180. package/dist/services/export/langchain/memory-generator.d.ts.map +1 -0
  181. package/dist/services/export/langchain/memory-generator.js +1182 -0
  182. package/dist/services/export/langchain/memory-generator.js.map +1 -0
  183. package/dist/services/export/langchain/openapi-generator.d.ts +20 -0
  184. package/dist/services/export/langchain/openapi-generator.d.ts.map +1 -0
  185. package/dist/services/export/langchain/openapi-generator.js +364 -0
  186. package/dist/services/export/langchain/openapi-generator.js.map +1 -0
  187. package/dist/services/export/langchain/plan-execute-generator.d.ts +60 -0
  188. package/dist/services/export/langchain/plan-execute-generator.d.ts.map +1 -0
  189. package/dist/services/export/langchain/plan-execute-generator.js +679 -0
  190. package/dist/services/export/langchain/plan-execute-generator.js.map +1 -0
  191. package/dist/services/export/langchain/streaming-generator.d.ts +66 -0
  192. package/dist/services/export/langchain/streaming-generator.d.ts.map +1 -0
  193. package/dist/services/export/langchain/streaming-generator.js +749 -0
  194. package/dist/services/export/langchain/streaming-generator.js.map +1 -0
  195. package/dist/services/export/langchain/tools-generator.d.ts +67 -0
  196. package/dist/services/export/langchain/tools-generator.d.ts.map +1 -0
  197. package/dist/services/export/langchain/tools-generator.js +543 -0
  198. package/dist/services/export/langchain/tools-generator.js.map +1 -0
  199. package/dist/services/export/npm/express-generator.d.ts +23 -0
  200. package/dist/services/export/npm/express-generator.d.ts.map +1 -0
  201. package/dist/services/export/npm/express-generator.js +296 -0
  202. package/dist/services/export/npm/express-generator.js.map +1 -0
  203. package/dist/services/export/npm/index.d.ts +13 -0
  204. package/dist/services/export/npm/index.d.ts.map +1 -0
  205. package/dist/services/export/npm/index.js +11 -0
  206. package/dist/services/export/npm/index.js.map +1 -0
  207. package/dist/services/export/npm/npm-exporter.d.ts +142 -0
  208. package/dist/services/export/npm/npm-exporter.d.ts.map +1 -0
  209. package/dist/services/export/npm/npm-exporter.js +480 -0
  210. package/dist/services/export/npm/npm-exporter.js.map +1 -0
  211. package/dist/services/export/npm/openapi-generator.d.ts +19 -0
  212. package/dist/services/export/npm/openapi-generator.d.ts.map +1 -0
  213. package/dist/services/export/npm/openapi-generator.js +428 -0
  214. package/dist/services/export/npm/openapi-generator.js.map +1 -0
  215. package/dist/services/export/npm/package-json-generator.d.ts +31 -0
  216. package/dist/services/export/npm/package-json-generator.d.ts.map +1 -0
  217. package/dist/services/export/npm/package-json-generator.js +153 -0
  218. package/dist/services/export/npm/package-json-generator.js.map +1 -0
  219. package/dist/services/export/npm/typescript-generator.d.ts +69 -0
  220. package/dist/services/export/npm/typescript-generator.d.ts.map +1 -0
  221. package/dist/services/export/npm/typescript-generator.js +437 -0
  222. package/dist/services/export/npm/typescript-generator.js.map +1 -0
  223. package/dist/services/export/testing/index.d.ts +8 -0
  224. package/dist/services/export/testing/index.d.ts.map +1 -0
  225. package/dist/services/export/testing/index.js +7 -0
  226. package/dist/services/export/testing/index.js.map +1 -0
  227. package/dist/services/export/testing/test-generator.d.ts +178 -0
  228. package/dist/services/export/testing/test-generator.d.ts.map +1 -0
  229. package/dist/services/export/testing/test-generator.js +2542 -0
  230. package/dist/services/export/testing/test-generator.js.map +1 -0
  231. package/dist/services/test-runner/mock-llm.service.d.ts +77 -0
  232. package/dist/services/test-runner/mock-llm.service.d.ts.map +1 -0
  233. package/dist/services/test-runner/mock-llm.service.js +173 -0
  234. package/dist/services/test-runner/mock-llm.service.js.map +1 -0
  235. package/dist/services/test-runner/scenarios.d.ts +36 -0
  236. package/dist/services/test-runner/scenarios.d.ts.map +1 -0
  237. package/dist/services/test-runner/scenarios.js +196 -0
  238. package/dist/services/test-runner/scenarios.js.map +1 -0
  239. package/dist/services/test-runner/test-runner.service.d.ts +19 -1
  240. package/dist/services/test-runner/test-runner.service.d.ts.map +1 -1
  241. package/dist/services/test-runner/test-runner.service.js +72 -6
  242. package/dist/services/test-runner/test-runner.service.js.map +1 -1
  243. package/dist/services/validation/best-practices-validator.d.ts +84 -0
  244. package/dist/services/validation/best-practices-validator.d.ts.map +1 -0
  245. package/dist/services/validation/best-practices-validator.js +499 -0
  246. package/dist/services/validation/best-practices-validator.js.map +1 -0
  247. package/dist/services/validation/cost-estimator.d.ts +69 -0
  248. package/dist/services/validation/cost-estimator.d.ts.map +1 -0
  249. package/dist/services/validation/cost-estimator.js +221 -0
  250. package/dist/services/validation/cost-estimator.js.map +1 -0
  251. package/dist/services/validation/enhanced-validator.d.ts +78 -0
  252. package/dist/services/validation/enhanced-validator.d.ts.map +1 -0
  253. package/dist/services/validation/enhanced-validator.js +212 -0
  254. package/dist/services/validation/enhanced-validator.js.map +1 -0
  255. package/dist/services/validation/index.d.ts +13 -0
  256. package/dist/services/validation/index.d.ts.map +1 -0
  257. package/dist/services/validation/index.js +9 -0
  258. package/dist/services/validation/index.js.map +1 -0
  259. package/dist/services/validation/security-validator.d.ts +81 -0
  260. package/dist/services/validation/security-validator.d.ts.map +1 -0
  261. package/dist/services/validation/security-validator.js +328 -0
  262. package/dist/services/validation/security-validator.js.map +1 -0
  263. package/dist/services/wizard/prompts.d.ts +71 -0
  264. package/dist/services/wizard/prompts.d.ts.map +1 -0
  265. package/dist/services/wizard/prompts.js +322 -0
  266. package/dist/services/wizard/prompts.js.map +1 -0
  267. package/dist/services/wizard/wizard.service.d.ts +60 -0
  268. package/dist/services/wizard/wizard.service.d.ts.map +1 -0
  269. package/dist/services/wizard/wizard.service.js +261 -0
  270. package/dist/services/wizard/wizard.service.js.map +1 -0
  271. package/dist/types/personality.zod.d.ts +23 -23
  272. package/dist/utils/version.d.ts +1 -1
  273. package/dist/utils/version.js +1 -1
  274. package/dist/version-management/core/version-manager.test.js.map +1 -1
  275. package/dist/version.d.ts +62 -0
  276. package/dist/version.d.ts.map +1 -0
  277. package/dist/version.js +73 -0
  278. package/dist/version.js.map +1 -0
  279. package/examples/a2a/agent-handoff.ossa.yaml +1 -1
  280. package/examples/a2a/service-discovery.ossa.yaml +1 -1
  281. package/examples/adapters/drupal-eca-mapping.yaml +1 -1
  282. package/examples/adapters/drupal-eca-task.yaml +1 -1
  283. package/examples/adapters/drupal-flowdrop-mapping.yaml +1 -1
  284. package/examples/adapters/drupal-maestro-mapping.yaml +1 -1
  285. package/examples/adapters/mistral-agent.yaml +1 -1
  286. package/examples/adapters/symfony-messenger-task.yaml +1 -1
  287. package/examples/adapters/symfony-messenger-workflow.yaml +1 -1
  288. package/examples/adk-integration/code-review-workflow.yml +1 -1
  289. package/examples/adk-integration/customer-support.yml +1 -1
  290. package/examples/adk-integration/data-pipeline.yml +1 -1
  291. package/examples/advanced/reasoning-agent.yaml +1 -1
  292. package/examples/advanced/workflows/hybrid-model-strategy.yaml +1 -1
  293. package/examples/agent-manifests/critics/critic-agent.yaml +1 -1
  294. package/examples/agent-manifests/governors/governor-agent.yaml +1 -1
  295. package/examples/agent-manifests/integrators/integrator-agent.yaml +1 -1
  296. package/examples/agent-manifests/judges/judge-agent.yaml +1 -1
  297. package/examples/agent-manifests/monitors/monitor-agent.yaml +1 -1
  298. package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml +1 -1
  299. package/examples/agent-manifests/sample-compliant-agent.yaml +1 -1
  300. package/examples/agent-manifests/workers/worker-agent.yaml +1 -1
  301. package/examples/agents/01-customer-support-bot/.env.example +32 -0
  302. package/examples/agents/01-customer-support-bot/Dockerfile +30 -0
  303. package/examples/agents/01-customer-support-bot/README.md +295 -0
  304. package/examples/agents/01-customer-support-bot/agent.ossa.yaml +172 -0
  305. package/examples/agents/01-customer-support-bot/docker-compose.yml +55 -0
  306. package/examples/agents/01-customer-support-bot/openapi.yaml +238 -0
  307. package/examples/agents/01-customer-support-bot/package.json +48 -0
  308. package/examples/agents/02-code-review-agent/README.md +72 -0
  309. package/examples/agents/02-code-review-agent/agent.ossa.yaml +239 -0
  310. package/examples/agents/02-code-review-agent/docker-compose.yml +22 -0
  311. package/examples/agents/02-code-review-agent/openapi.yaml +150 -0
  312. package/examples/agents/03-data-analysis-agent/README.md +51 -0
  313. package/examples/agents/03-data-analysis-agent/agent.ossa.yaml +97 -0
  314. package/examples/agents/03-data-analysis-agent/openapi.yaml +74 -0
  315. package/examples/agents/04-content-moderator/README.md +55 -0
  316. package/examples/agents/04-content-moderator/agent.ossa.yaml +131 -0
  317. package/examples/agents/04-content-moderator/openapi.yaml +50 -0
  318. package/examples/agents/05-sales-assistant/README.md +37 -0
  319. package/examples/agents/05-sales-assistant/agent.ossa.yaml +146 -0
  320. package/examples/agents/05-sales-assistant/openapi.yaml +59 -0
  321. package/examples/agents/06-devops-agent/README.md +39 -0
  322. package/examples/agents/06-devops-agent/agent.ossa.yaml +141 -0
  323. package/examples/agents/06-devops-agent/openapi.yaml +51 -0
  324. package/examples/agents/07-research-assistant/README.md +31 -0
  325. package/examples/agents/07-research-assistant/agent.ossa.yaml +119 -0
  326. package/examples/agents/07-research-assistant/openapi.yaml +56 -0
  327. package/examples/agents/08-email-triage-agent/README.md +33 -0
  328. package/examples/agents/08-email-triage-agent/agent.ossa.yaml +133 -0
  329. package/examples/agents/08-email-triage-agent/openapi.yaml +41 -0
  330. package/examples/agents/09-security-scanner/README.md +49 -0
  331. package/examples/agents/09-security-scanner/agent.ossa.yaml +174 -0
  332. package/examples/agents/09-security-scanner/openapi.yaml +46 -0
  333. package/examples/agents/10-meeting-assistant/README.md +53 -0
  334. package/examples/agents/10-meeting-assistant/agent.ossa.yaml +211 -0
  335. package/examples/agents/10-meeting-assistant/docker-compose.yml +27 -0
  336. package/examples/agents/10-meeting-assistant/openapi.yaml +131 -0
  337. package/examples/agents/COMPLETION_REPORT.txt +272 -0
  338. package/examples/agents/INDEX.md +296 -0
  339. package/examples/agents/README.md +452 -0
  340. package/examples/agents/SUMMARY.md +362 -0
  341. package/examples/agents/TEST_RESULTS.md +458 -0
  342. package/examples/agents/architecture-healer-enterprise.yaml +1 -1
  343. package/examples/agents/dependency-healer-npm.yaml +1 -1
  344. package/examples/agents/spec-healer-openapi.yaml +1 -1
  345. package/examples/agents/wiki-healer-production.yaml +1 -1
  346. package/examples/agents-md/code-agent.ossa.json +1 -1
  347. package/examples/agents-md/monorepo-agent.ossa.yaml +1 -1
  348. package/examples/anthropic/claude-assistant.ossa.json +1 -1
  349. package/examples/autogen/multi-agent.ossa.json +1 -1
  350. package/examples/autonomous-evolution/self-evolving-agent.ossa.yaml +1 -1
  351. package/examples/build-once-use-everywhere/agent.ossa.yaml +1 -1
  352. package/examples/claude-code/code-reviewer.ossa.yaml +1 -1
  353. package/examples/claude-code/ossa-validator.ossa.yaml +1 -1
  354. package/examples/common_npm/agent-router.ossa.yaml +2 -2
  355. package/examples/contracts/data-consumer.ossa.yaml +1 -1
  356. package/examples/contracts/data-producer-v2.ossa.yaml +1 -1
  357. package/examples/contracts/data-producer.ossa.yaml +1 -1
  358. package/examples/crewai/research-team.ossa.json +1 -1
  359. package/examples/cursor/code-review-agent.ossa.json +1 -1
  360. package/examples/drupal/QUICKSTART.md +439 -0
  361. package/examples/drupal/ai_agents_ossa-module/.agents/example-agent/agent.ossa.yaml +1 -1
  362. package/examples/drupal/content-moderator.ossa.yaml +107 -0
  363. package/examples/drupal/gitlab-ml-recommender.ossa.yaml +2 -2
  364. package/examples/economics/marketplace-agent.ossa.json +1 -1
  365. package/examples/export/langchain/production-agent-with-memory/README.md +373 -0
  366. package/examples/export/langchain/production-agent-with-memory/agent.ossa.yaml +97 -0
  367. package/examples/export/langchain/production-agent-with-streaming/README.md +617 -0
  368. package/examples/export/langchain/production-agent-with-streaming/agent.ossa.yaml +100 -0
  369. package/examples/export/langchain/production-agent-with-streaming/client-example.py +263 -0
  370. package/examples/export/langchain/production-agent-with-tools/README.md +296 -0
  371. package/examples/export/langchain/production-agent-with-tools/agent.ossa.yaml +216 -0
  372. package/examples/export/langchain-export-example.ts +246 -0
  373. package/examples/export/langserve-export-example.ts +246 -0
  374. package/examples/export/test-generation-example.ts +457 -0
  375. package/examples/extensions/agents-md-advanced.yml +1 -1
  376. package/examples/extensions/agents-md-basic.yml +1 -1
  377. package/examples/extensions/agents-md-sync.yml +1 -1
  378. package/examples/extensions/agents-md-v1.yml +1 -1
  379. package/examples/extensions/drupal-v1.yml +1 -1
  380. package/examples/extensions/encryption-multi-provider.yaml +4 -4
  381. package/examples/extensions/kagent-v1.yml +1 -1
  382. package/examples/extensions/knowledge-sources.yaml +1 -1
  383. package/examples/extensions/mcp-full-featured.yaml +1 -1
  384. package/examples/genetics/breeding-agent.ossa.json +1 -1
  385. package/examples/getting-started/01-minimal-agent.ossa.yaml +1 -1
  386. package/examples/getting-started/02-agent-with-tools.ossa.yaml +1 -1
  387. package/examples/getting-started/03-agent-with-safety.ossa.yaml +1 -1
  388. package/examples/getting-started/04-agent-with-messaging.ossa.yaml +1 -1
  389. package/examples/getting-started/05-workflow-composition.ossa.yaml +1 -1
  390. package/examples/getting-started/hello-world-complete.ossa.yaml +1 -1
  391. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +1 -1
  392. package/examples/kagent/compliance-validator.ossa.yaml +1 -1
  393. package/examples/kagent/cost-optimizer.ossa.yaml +1 -1
  394. package/examples/kagent/documentation-agent.ossa.yaml +1 -1
  395. package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml +2 -2
  396. package/examples/kagent/k8s-troubleshooter.ossa.yaml +1 -1
  397. package/examples/kagent/security-scanner.ossa.yaml +1 -1
  398. package/examples/langchain/chain-agent.ossa.json +1 -1
  399. package/examples/langflow/workflow-agent.ossa.json +1 -1
  400. package/examples/langgraph/state-machine-agent.ossa.json +1 -1
  401. package/examples/lifecycle/mentoring-agent.ossa.json +1 -1
  402. package/examples/llamaindex/rag-agent.ossa.json +1 -1
  403. package/examples/mcp/database-mcp.ossa.yaml +1 -1
  404. package/examples/mcp/filesystem-mcp.ossa.yaml +1 -1
  405. package/examples/messaging/dependency-healer.ossa.yaml +1 -1
  406. package/examples/messaging/incident-responder.ossa.yaml +1 -1
  407. package/examples/messaging/routing-rules.ossa.yaml +1 -1
  408. package/examples/messaging/security-scanner.ossa.yaml +1 -1
  409. package/examples/migration-guides/from-langchain-to-ossa.yaml +4 -4
  410. package/examples/migrations/langchain/01-python-react-agent-after.ossa.yaml +1 -1
  411. package/examples/migrations/langchain/02-typescript-conversational-after.ossa.yaml +1 -1
  412. package/examples/migrations/langchain/03-sequential-chain-after.ossa.yaml +1 -1
  413. package/examples/migrations/langchain/04-config-based-after.ossa.yaml +1 -1
  414. package/examples/migrations/swarm-to-ossa/after-handoffs.ossa.yaml +6 -6
  415. package/examples/migrations/swarm-to-ossa/after-triage-agent.ossa.yaml +3 -3
  416. package/examples/multi-agent/conditional-router.ossa.yaml +1 -1
  417. package/examples/multi-agent/parallel-execution.ossa.yaml +1 -1
  418. package/examples/multi-agent/sequential-pipeline.ossa.yaml +1 -1
  419. package/examples/multi-agent-research-workflow.ossa.yaml +133 -0
  420. package/examples/multi-platform/single-manifest/agent.ossa.yaml +1 -1
  421. package/examples/npm-export-example.ts +150 -0
  422. package/examples/observability/activity-stream-full.yaml +1 -1
  423. package/examples/openai/basic-agent.ossa.yaml +1 -1
  424. package/examples/openai/multi-tool-agent.ossa.json +1 -1
  425. package/examples/openai/swarm-agent.ossa.json +1 -1
  426. package/examples/ossa-templates/01-code-assistant.ossa.yaml +1 -1
  427. package/examples/ossa-templates/02-security-scanner.ossa.yaml +1 -1
  428. package/examples/ossa-templates/03-ci-pipeline.ossa.yaml +1 -1
  429. package/examples/ossa-templates/04-code-reviewer.ossa.yaml +1 -1
  430. package/examples/ossa-templates/05-doc-generator.ossa.yaml +1 -1
  431. package/examples/ossa-templates/06-compliance-validator.ossa.yaml +1 -1
  432. package/examples/ossa-templates/07-workflow-orchestrator.ossa.yaml +1 -1
  433. package/examples/ossa-templates/08-content-writer.ossa.yaml +1 -1
  434. package/examples/ossa-templates/09-test-generator.ossa.yaml +1 -1
  435. package/examples/ossa-templates/10-data-transformer.ossa.yaml +1 -1
  436. package/examples/ossa-templates/11-react-performance-expert.ossa.yaml +1 -1
  437. package/examples/ossa-templates/12-typescript-type-safety-expert.ossa.yaml +1 -1
  438. package/examples/ossa-templates/13-accessibility-champion.ossa.yaml +1 -1
  439. package/examples/ossa-templates/14-security-hardening-agent.ossa.yaml +1 -1
  440. package/examples/production/document-analyzer-openai.yml +1 -1
  441. package/examples/production-ready/01-customer-support-bot/.env.example +32 -0
  442. package/examples/production-ready/01-customer-support-bot/Dockerfile +30 -0
  443. package/examples/production-ready/01-customer-support-bot/README.md +295 -0
  444. package/examples/production-ready/01-customer-support-bot/agent.ossa.yaml +172 -0
  445. package/examples/production-ready/01-customer-support-bot/docker-compose.yml +55 -0
  446. package/examples/production-ready/01-customer-support-bot/openapi.yaml +238 -0
  447. package/examples/production-ready/01-customer-support-bot/package.json +48 -0
  448. package/examples/production-ready/02-code-review-agent/README.md +72 -0
  449. package/examples/production-ready/02-code-review-agent/agent.ossa.yaml +239 -0
  450. package/examples/production-ready/02-code-review-agent/docker-compose.yml +22 -0
  451. package/examples/production-ready/02-code-review-agent/openapi.yaml +150 -0
  452. package/examples/production-ready/03-data-analysis-agent/README.md +51 -0
  453. package/examples/production-ready/03-data-analysis-agent/agent.ossa.yaml +97 -0
  454. package/examples/production-ready/03-data-analysis-agent/openapi.yaml +74 -0
  455. package/examples/production-ready/04-content-moderator/README.md +55 -0
  456. package/examples/production-ready/04-content-moderator/agent.ossa.yaml +131 -0
  457. package/examples/production-ready/04-content-moderator/openapi.yaml +50 -0
  458. package/examples/production-ready/05-sales-assistant/README.md +37 -0
  459. package/examples/production-ready/05-sales-assistant/agent.ossa.yaml +146 -0
  460. package/examples/production-ready/05-sales-assistant/openapi.yaml +59 -0
  461. package/examples/production-ready/06-devops-agent/README.md +39 -0
  462. package/examples/production-ready/06-devops-agent/agent.ossa.yaml +141 -0
  463. package/examples/production-ready/06-devops-agent/openapi.yaml +51 -0
  464. package/examples/production-ready/07-research-assistant/README.md +31 -0
  465. package/examples/production-ready/07-research-assistant/agent.ossa.yaml +119 -0
  466. package/examples/production-ready/07-research-assistant/openapi.yaml +56 -0
  467. package/examples/production-ready/08-email-triage-agent/README.md +33 -0
  468. package/examples/production-ready/08-email-triage-agent/agent.ossa.yaml +133 -0
  469. package/examples/production-ready/08-email-triage-agent/openapi.yaml +41 -0
  470. package/examples/production-ready/09-security-scanner/README.md +49 -0
  471. package/examples/production-ready/09-security-scanner/agent.ossa.yaml +174 -0
  472. package/examples/production-ready/09-security-scanner/openapi.yaml +46 -0
  473. package/examples/production-ready/10-meeting-assistant/README.md +53 -0
  474. package/examples/production-ready/10-meeting-assistant/agent.ossa.yaml +211 -0
  475. package/examples/production-ready/10-meeting-assistant/docker-compose.yml +27 -0
  476. package/examples/production-ready/10-meeting-assistant/openapi.yaml +131 -0
  477. package/examples/production-ready/COMPLETION_REPORT.txt +272 -0
  478. package/examples/production-ready/INDEX.md +296 -0
  479. package/examples/production-ready/README.md +452 -0
  480. package/examples/production-ready/SUMMARY.md +362 -0
  481. package/examples/production-ready/TEST_RESULTS.md +458 -0
  482. package/examples/quickstart/support-agent.ossa.yaml +1 -1
  483. package/examples/real-world/gitlab-cicd-optimizer.ossa.yaml +1 -1
  484. package/examples/real-world/rag-documentation-assistant.ossa.yaml +1 -1
  485. package/examples/registry/agents/code-reviewer/agent.yaml +1 -1
  486. package/examples/registry/agents/security-scanner/agent.yaml +1 -1
  487. package/examples/runtime-adapters/bedrock-claude-example.ossa.yaml +1 -1
  488. package/examples/schema/reusable-components.yaml +1 -1
  489. package/examples/showcase/ci-pipeline.ossa.yaml +1 -1
  490. package/examples/showcase/code-assistant.ossa.yaml +1 -1
  491. package/examples/showcase/code-reviewer.ossa.yaml +1 -1
  492. package/examples/showcase/compliance-validator.ossa.yaml +1 -1
  493. package/examples/showcase/content-writer.ossa.yaml +1 -1
  494. package/examples/showcase/data-transformer.ossa.yaml +1 -1
  495. package/examples/showcase/doc-generator.ossa.yaml +1 -1
  496. package/examples/showcase/security-scanner.ossa.yaml +1 -1
  497. package/examples/showcase/test-generator.ossa.yaml +1 -1
  498. package/examples/showcase/workflow-orchestrator.ossa.yaml +1 -1
  499. package/examples/skills-example.ossa.yaml +140 -0
  500. package/examples/swarm/pso-optimizer.ossa.json +1 -1
  501. package/examples/tasks/batch-email-sender.yaml +1 -1
  502. package/examples/tasks/data-transform.yaml +1 -1
  503. package/examples/tasks/publish-content.yaml +1 -1
  504. package/examples/templates/ossa-compliance.yaml +1 -1
  505. package/examples/unified/security-scanner.ossa.yaml +1 -1
  506. package/examples/v0.3.6-features/genetics-breeding-advanced.ossa.yaml +1 -1
  507. package/examples/v0.3.6-features/genetics-breeding-simple.ossa.yaml +1 -1
  508. package/examples/v0.3.6-features/genetics-fitness-scoring.ossa.yaml +1 -1
  509. package/examples/vercel/edge-agent.ossa.json +1 -1
  510. package/examples/workflows/batch-email-campaign.yaml +1 -1
  511. package/examples/workflows/content-review-publish.yaml +1 -1
  512. package/examples/workflows/simple-etl.yaml +1 -1
  513. package/openapi/cli/openapi.yaml +221 -5
  514. package/package.json +31 -9
  515. package/dist/cli/commands/export-v2.command.d.ts +0 -7
  516. package/dist/cli/commands/export-v2.command.d.ts.map +0 -1
  517. package/dist/cli/commands/export-v2.command.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,142 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [0.4.2] - 2026-02-04
9
+
10
+ ### Fixed
11
+ - Added missing runtime dependencies preventing global installation:
12
+ - `cli-table3` - Required by CLI wizard UI (broken in v0.4.1)
13
+ - `uuid` - Required by taxonomy service
14
+ - `js-yaml` - Required by YAML generators and tools
15
+ - `langchain` - Required by LangChain adapter
16
+ - `@langchain/core` - Required by LangChain integration
17
+ - `@langchain/openai` - Required by LangChain LLM support
18
+ - `@langchain/anthropic` - Required by LangChain Anthropic support
19
+ - `@modelcontextprotocol/sdk` - Required by MCP adapter
20
+ - `@temporalio/workflow` - Required by Temporal adapter
21
+ - `@temporalio/activity` - Required by Temporal adapter
22
+
23
+ ### Added
24
+ - Dependency validation tool (`tools/validate-dependencies.ts`) to catch missing dependencies
25
+ - Pre-publish dependency check in `prepublishOnly` script
26
+ - `validate:deps` npm script to manually validate dependencies
27
+
28
+ ## [0.4.1] - 2026-02-04
29
+
30
+ ### Added
31
+
32
+ **Wizard Enhancements:**
33
+ - Claude Skills system integration with skill creation, validation, and parameter support
34
+ - Export target configuration for LangChain, KAgent, Drupal, and Symfony platforms
35
+ - Testing & validation configuration with unit, integration, load, security, and cost testing
36
+ - Multi-platform deployment support with platform-specific options (RBAC, TLS, caching)
37
+ - Schema-compliant annotations storage using `buildkit.ossa.io/` namespace
38
+ - Type-safe configuration interfaces and helper functions
39
+
40
+ **LangServe Export (Optional):**
41
+ - Production FastAPI + LangServe deployment templates (30 files, 4,350+ lines)
42
+ - One-click deployment support: Docker, Kubernetes, Railway, Render, Fly.io
43
+ - Multi-stage Docker builds with Alpine base for minimal image size
44
+ - Kubernetes manifests with HPA, security contexts, and production best practices
45
+ - Complete monitoring stack: Prometheus, Grafana, OpenTelemetry integration
46
+ - Health check endpoints with readiness and liveness probes
47
+ - OSSA manifest loader with runtime validation
48
+ - Comprehensive deployment documentation (180+ pages, 200+ code examples)
49
+
50
+ **Drupal Integration Architecture:**
51
+ - Complete TypeScript ↔ PHP bridge architecture (150+ pages)
52
+ - Runtime bridge server design for agent execution
53
+ - Config export workflow for Drupal module generation
54
+ - Module generation patterns with DRY principles via ai_agents base module
55
+ - Comprehensive examples: 50+ production code samples
56
+ - Architecture diagrams: 15+ ASCII diagrams
57
+ - Integration guides: Quick start (5 minutes), complete technical specs
58
+
59
+ **Testing Framework:**
60
+ - GitLab CI Components with 7-stage pipeline
61
+ - Zod schemas for validation at all layers
62
+ - OWASP Top 10 security testing integration
63
+ - Unit, integration, E2E, security, and performance test support
64
+
65
+ **Production-Quality Exports:**
66
+ - Complete REST API endpoints for all platform exports (LangChain, npm, Anthropic)
67
+ - OpenAPI 3.1 specifications automatically generated for all exports
68
+ - Interactive API documentation via Swagger UI and ReDoc
69
+ - Client SDK generation support (TypeScript, Python, Go, Java, etc.)
70
+ - Express server templates with authentication, rate limiting, and monitoring
71
+
72
+ **LangChain Export:**
73
+ - Dual language support (Python + TypeScript implementations)
74
+ - Production-ready LangChain agent classes and tools
75
+ - API endpoints: `/api/v1/execute`, `/api/v1/tools`, `/api/v1/status`
76
+ - Requirements.txt and package.json with dependencies
77
+ - Complete usage documentation
78
+
79
+ **npm Package Export:**
80
+ - Installable npm packages with TypeScript type definitions
81
+ - Embedded OSSA manifest (agent.ossa.yaml)
82
+ - API server with OpenAPI spec
83
+ - Claude Code skill integration (SKILL.md)
84
+ - Auto-generated README with examples
85
+ - License file support (MIT, Apache-2.0, ISC)
86
+
87
+ **Anthropic Claude Export:**
88
+ - Native Anthropic SDK integration
89
+ - Tool use support with handler registration
90
+ - Streaming response support via Server-Sent Events
91
+ - Prompt caching support (90% cost reduction)
92
+ - Message history and context management
93
+ - Cost tracking and usage metrics
94
+
95
+ **Cost Optimization:**
96
+ - Anthropic prompt caching (90% savings on cached portions)
97
+ - Token budgets with hard limits and warnings
98
+ - Cost estimation before execution
99
+ - Temperature optimization recommendations
100
+ - Model selection guidance for cost vs quality
101
+ - Tool output limits to prevent expensive operations
102
+ - Batch processing suggestions
103
+
104
+ **Enhanced Validation:**
105
+ - Best practices validation (temperature, maxTokens, etc.)
106
+ - Security validation (input sanitization, output filtering)
107
+ - Cost analysis and recommendations
108
+ - Auto-fix capability for common issues
109
+ - Enhanced linting with multiple rule categories
110
+
111
+ **API Features:**
112
+ - Standard endpoints: `/health`, `/api/v1/info`, `/api/v1/execute`, `/openapi`
113
+ - Authentication: API key and JWT support
114
+ - Rate limiting with configurable limits
115
+ - CORS configuration
116
+ - Request/response validation against OpenAPI spec
117
+ - Error handling with consistent error responses
118
+ - Metrics endpoint for Prometheus monitoring
119
+ - WebSocket support for real-time communication
120
+
121
+ **Documentation:**
122
+ - Complete export guides: [LangChain](./docs/exports/langchain.md), [npm](./docs/exports/npm.md), [Anthropic](./docs/exports/anthropic.md)
123
+ - API Endpoints guide: [docs/guides/api-endpoints.md](./docs/guides/api-endpoints.md)
124
+ - OpenAPI Specifications guide: [docs/guides/openapi-specs.md](./docs/guides/openapi-specs.md)
125
+ - Best Practices guide: [docs/guides/best-practices.md](./docs/guides/best-practices.md)
126
+ - Cost Optimization guide: [docs/guides/cost-optimization.md](./docs/guides/cost-optimization.md)
127
+ - Migration guide: [docs/migration/v0.4-to-v0.5.md](./docs/migration/v0.4-to-v0.5.md)
128
+
129
+ ### Changed
130
+ - Export command now supports `--with-api` flag to include API endpoints
131
+ - Export command now supports `--skill` flag to include Claude Code skills
132
+ - All exports now include OpenAPI 3.1 specifications
133
+ - Enhanced dry-run mode with detailed preview
134
+ - Improved validation messages with actionable suggestions
135
+ - Better error messages with context and fix suggestions
136
+
137
+ ### Fixed
138
+ - Export path handling for nested directories
139
+ - OpenAPI spec generation for complex schemas
140
+ - TypeScript type generation for optional properties
141
+ - API server port configuration
142
+ - CORS handling for cross-origin requests
143
+
8
144
  ## [0.4.0] - 2026-02-01
9
145
 
10
146
  ### Added
@@ -220,6 +356,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
220
356
  - Fixed CI/CD configuration for proper Docker image usage
221
357
  - Fixed hardcoded version detection and validation
222
358
 
359
+ [0.4.1]: https://github.com/blueflyio/openstandardagents/compare/v0.4.0...v0.4.1
223
360
  [0.4.0]: https://github.com/blueflyio/openstandardagents/compare/v0.3.6...v0.4.0
224
361
  [0.3.6]: https://github.com/blueflyio/openstandardagents/compare/v0.3.5...v0.3.6
225
362
  [0.3.5]: https://github.com/blueflyio/openstandardagents/compare/v0.3.4...v0.3.5
package/DEMO.md ADDED
@@ -0,0 +1,212 @@
1
+ # OSSA v0.4.1 - The Killer Demo
2
+
3
+ ## Turn Any AI Agent into a Production NPM Package in 60 Seconds
4
+
5
+ **Problem**: You built an AI agent. How do you deploy it? Share it? Version it? Install it like real software?
6
+
7
+ **Solution**: OSSA CLI
8
+
9
+ ---
10
+
11
+ ## The Demo
12
+
13
+ ### 1. Install OSSA CLI (when published)
14
+ ```bash
15
+ npm install -g @bluefly/openstandardagents
16
+ ```
17
+
18
+ ### 2. Create Your Agent (3 commands)
19
+ ```bash
20
+ # Quick start with wizard
21
+ ossa quickstart
22
+
23
+ # OR create from scratch
24
+ ossa wizard
25
+
26
+ # OR import from another platform
27
+ ossa import cursor-agent.json --from cursor
28
+ ```
29
+
30
+ ### 3. Export to Production Package (1 command)
31
+ ```bash
32
+ ossa export my-agent.ossa.yaml --platform npm --output ./my-agent-package
33
+ ```
34
+
35
+ **Output**: A production-ready NPM package with:
36
+ - ✅ `package.json` with proper metadata
37
+ - ✅ `index.js` entry point
38
+ - ✅ `index.d.ts` TypeScript types
39
+ - ✅ `README.md` with usage docs
40
+ - ✅ `.npmignore` for clean publishing
41
+ - ✅ Original OSSA manifest included
42
+
43
+ ### 4. Publish & Use
44
+ ```bash
45
+ cd my-agent-package
46
+ npm publish
47
+
48
+ # Now anyone can install it:
49
+ npm install my-agent
50
+ ```
51
+
52
+ ---
53
+
54
+ ## What Problem Does This Solve?
55
+
56
+ **Before OSSA:**
57
+ - No standard format for agent definitions
58
+ - Platform lock-in - rewrite for each platform
59
+ - Manual packaging and deployment setup
60
+ - No dependency management or versioning
61
+ - Copy-paste agent configs between tools
62
+
63
+ **With OSSA:**
64
+ - One manifest works across 12+ platforms
65
+ - Export to: NPM, Docker, Kubernetes, MCP, Cursor, Claude Desktop, Langchain, CrewAI, AutoGen, AG2, Langflow, OpenAI
66
+ - Production CLI with validation, dry-run, JSON output
67
+ - Type-safe manifests with Zod + TypeScript
68
+ - OpenAPI-style approach for agents
69
+
70
+ ---
71
+
72
+ ## Real Example
73
+
74
+ ```yaml
75
+ # my-agent.ossa.yaml
76
+ apiVersion: ossa/v0.3.6
77
+ kind: Agent
78
+ metadata:
79
+ name: code-reviewer
80
+ version: 1.0.0
81
+ description: AI code reviewer agent
82
+ spec:
83
+ role: "You review code for quality, security, and best practices"
84
+ llm:
85
+ provider: openai
86
+ model: gpt-4
87
+ capabilities:
88
+ - id: review-code
89
+ type: tool
90
+ name: review_code
91
+ description: Review code and provide feedback
92
+ ```
93
+
94
+ **One command later:**
95
+ ```bash
96
+ ossa export my-agent.ossa.yaml --platform npm
97
+
98
+ # Outputs:
99
+ # ✓ NPM package exported to: code-reviewer-npm/
100
+ # Files: package.json, index.js, index.d.ts, README.md
101
+ ```
102
+
103
+ **Now it's installable software:**
104
+ ```bash
105
+ npm install @myorg/code-reviewer
106
+ ```
107
+
108
+ ---
109
+
110
+ ## Platform Support Matrix
111
+
112
+ | Platform | Export | Import | Status |
113
+ |----------|--------|--------|--------|
114
+ | NPM | ✅ | ✅ | Production |
115
+ | Docker | ✅ | ❌ | Beta |
116
+ | Kubernetes | ✅ | ❌ | Beta |
117
+ | MCP | ✅ | ✅ | Production |
118
+ | Cursor | ✅ | ✅ | Production |
119
+ | Claude Desktop | ✅ | ❌ | Production |
120
+ | Langchain | ✅ | ✅ | Beta |
121
+ | CrewAI | ✅ | ✅ | Beta |
122
+ | AutoGen | ✅ | ✅ | Beta |
123
+ | AG2 | ✅ | ❌ | Beta |
124
+ | Langflow | ✅ | ✅ | Beta |
125
+ | OpenAI | ✅ | ✅ | Production |
126
+
127
+ ---
128
+
129
+ ## The "Wow" Factor
130
+
131
+ **Traditional approach** (Cursor agent to production):
132
+ 1. Write agent in Cursor format
133
+ 2. Manually create package.json
134
+ 3. Write entry point code
135
+ 4. Create TypeScript types
136
+ 5. Write README
137
+ 6. Configure for each platform
138
+ 7. Test deployments
139
+ 8. Maintain separate configs
140
+
141
+ **Time**: Hours to days
142
+
143
+ **OSSA approach**:
144
+ ```bash
145
+ ossa import cursor-agent.json --from cursor
146
+ ossa export agent.ossa.yaml --platform npm
147
+ ```
148
+
149
+ **Time**: 60 seconds
150
+
151
+ ---
152
+
153
+ ## Production Features
154
+
155
+ All commands support:
156
+ - `--dry-run` - Preview without changes
157
+ - `--verbose` - Detailed output
158
+ - `--quiet` - Minimal output for scripts
159
+ - `--json` - Machine-readable output
160
+ - `--no-color` - CI-friendly
161
+ - Proper exit codes for scripts
162
+
163
+ Example:
164
+ ```bash
165
+ # Safe preview
166
+ ossa export agent.yaml --platform npm --dry-run
167
+
168
+ # Automated pipeline
169
+ ossa export agent.yaml --platform npm --quiet --json > result.json
170
+ ```
171
+
172
+ ---
173
+
174
+ ## Why OSSA is The Standard
175
+
176
+ 1. **OpenAPI-inspired**: We learned from the API revolution
177
+ 2. **Platform-agnostic**: Write once, deploy everywhere
178
+ 3. **Type-safe**: Zod + TypeScript for reliability
179
+ 4. **Production-ready**: Built for real deployments
180
+ 5. **Open Standard**: Community-driven, not vendor lock-in
181
+
182
+ ---
183
+
184
+ ## Get Started Now
185
+
186
+ ```bash
187
+ # Install
188
+ npm install -g @bluefly/openstandardagents
189
+
190
+ # Quick start
191
+ ossa quickstart
192
+
193
+ # Create agent
194
+ ossa wizard
195
+
196
+ # Export to any platform
197
+ ossa export agent.yaml --platform npm
198
+ ```
199
+
200
+ **Documentation**: https://openstandardagents.org
201
+ **GitHub**: https://github.com/blueflyio/openstandardagents
202
+ **Spec**: https://openstandardagents.org/spec
203
+
204
+ ---
205
+
206
+ ## Why OSSA Exists
207
+
208
+ OpenAPI standardized REST API definitions. OSSA does the same for AI agents.
209
+
210
+ One manifest format. Works everywhere. Production-ready tooling.
211
+
212
+ **OSSA v0.4.1** - Ready for production use.
package/README.md CHANGED
@@ -17,13 +17,73 @@ npm install -g @bluefly/openstandardagents
17
17
  # Create agent
18
18
  ossa quickstart
19
19
 
20
- # Export to NPM package (or Docker, K8s, MCP, Cursor, Claude, etc.)
21
- ossa export my-agent.ossa.yaml --platform npm --output ./package
20
+ # Export to NPM package with REST API
21
+ ossa export my-agent.ossa.yaml --platform npm --with-api --output ./package
22
+
23
+ # Start API server
24
+ cd package && npm install && npm start
25
+
26
+ # Use via HTTP
27
+ curl -X POST http://localhost:3000/api/v1/execute \
28
+ -H "Content-Type: application/json" \
29
+ -d '{"input":"Analyze this code"}'
30
+ ```
31
+
32
+ **Result**: Production-ready package with REST API, OpenAPI spec, TypeScript types, and interactive documentation.
33
+
34
+ See [DEMO.md](https://github.com/blueflyio/openstandardagents/blob/main/DEMO.md) for the full story.
35
+
36
+ ---
37
+
38
+ ## What's New in v0.4.1 (Latest)
39
+
40
+ ### Production-Quality Exports with API Endpoints
41
+
42
+ Export agents with complete REST APIs, OpenAPI specifications, and production features:
43
+
44
+ ```bash
45
+ # Export with API endpoints
46
+ ossa export agent.ossa.yaml --platform langchain --with-api
47
+ ossa export agent.ossa.yaml --platform anthropic --with-api
48
+ ossa export agent.ossa.yaml --platform npm --skill --with-api
22
49
  ```
23
50
 
24
- **Result**: Production-ready NPM package with `package.json`, entry point, TypeScript types, and docs.
51
+ **What you get:**
52
+ - ✅ **REST API Endpoints**: HTTP access to your agents
53
+ - ✅ **OpenAPI 3.1 Specs**: Complete API documentation
54
+ - ✅ **Interactive Docs**: Swagger UI and ReDoc
55
+ - ✅ **Client Generation**: Auto-generate TypeScript, Python, Go clients
56
+ - ✅ **Cost Optimization**: Prompt caching (90% savings), token budgets
57
+ - ✅ **Production Features**: Auth, rate limiting, monitoring
58
+
59
+ ### Cost Optimization
60
+
61
+ Save up to 90% on API costs:
62
+
63
+ ```yaml
64
+ spec:
65
+ llm:
66
+ provider: anthropic
67
+ model: claude-3-5-sonnet-20241022
68
+ temperature: 0.3
69
+ maxTokens: 2048
70
+
71
+ extensions:
72
+ anthropic:
73
+ prompt_caching:
74
+ enabled: true # 90% cost reduction on cached portions
75
+
76
+ token_budget:
77
+ max_total_tokens: 100000
78
+ reset_interval: daily
79
+ ```
25
80
 
26
- See [DEMO.md](./DEMO.md) for the full story.
81
+ **See Complete Guides:**
82
+ - [LangChain Export](./docs/exports/langchain.md)
83
+ - [Anthropic Export](./docs/exports/anthropic.md)
84
+ - [npm Export](./docs/exports/npm.md)
85
+ - [Cost Optimization](./docs/guides/cost-optimization.md)
86
+ - [Migration Guide v0.4→v0.5](./docs/migration/v0.4-to-v0.5.md)
27
87
 
28
88
  ---
29
89
 
@@ -38,7 +98,7 @@ OSSA is a **specification standard** that provides a common contract for definin
38
98
 
39
99
  ## Real-World Benefits
40
100
 
41
- ### 1. Agent Lifecycle Management (NEW in v0.3.6)
101
+ ### 1. Agent Lifecycle Management (v0.4.1)
42
102
 
43
103
  Track agents through their entire lifecycle from creation to retirement:
44
104
 
@@ -69,7 +129,7 @@ metadata:
69
129
  - Plan for agent retirement and knowledge transfer
70
130
  - Document career progression and achievements
71
131
 
72
- ### 2. Agent Genetics & Breeding (NEW in v0.3.6)
132
+ ### 2. Agent Genetics & Breeding (v0.4.1)
73
133
 
74
134
  Create new agents by combining traits from successful parent agents:
75
135
 
@@ -99,7 +159,7 @@ metadata:
99
159
  - Track lineage and inherited traits
100
160
  - Optimize agent performance across generations
101
161
 
102
- ### 3. Agent Marketplace & Economics (NEW in v0.3.6)
162
+ ### 3. Agent Marketplace & Economics (v0.4.1)
103
163
 
104
164
  Monetize agent capabilities and enable agent-to-agent transactions:
105
165
 
@@ -129,7 +189,7 @@ metadata:
129
189
  - Track agent resource consumption and costs
130
190
  - Enable pay-per-use agent services
131
191
 
132
- ### 4. Decentralized Identity (NEW in v0.3.6)
192
+ ### 4. Decentralized Identity (v0.4.1)
133
193
 
134
194
  Give agents globally unique, verifiable identities:
135
195
 
@@ -163,7 +223,7 @@ import { validateManifest } from '@bluefly/openstandardagents/validation';
163
223
 
164
224
  // Your OSSA manifest
165
225
  const manifest = {
166
- apiVersion: "ossa/v0.3.6",
226
+ apiVersion: "ossa/v0.4.1",
167
227
  kind: "Agent",
168
228
  metadata: {
169
229
  name: "code-reviewer",
@@ -203,7 +263,7 @@ npm install @bluefly/openstandardagents
203
263
  Create an `agent.ossa.yaml` file:
204
264
 
205
265
  ```yaml
206
- apiVersion: ossa/v0.3.6
266
+ apiVersion: ossa/v0.4.1
207
267
  kind: Agent
208
268
  metadata:
209
269
  name: my-agent
@@ -240,7 +300,7 @@ if (result.valid) {
240
300
  import type { OssaAgent } from '@bluefly/openstandardagents/types';
241
301
 
242
302
  const agent: OssaAgent = {
243
- apiVersion: "ossa/v0.3.6",
303
+ apiVersion: "ossa/v0.4.1",
244
304
  kind: "Agent",
245
305
  metadata: {
246
306
  name: "code-reviewer"
@@ -251,7 +311,7 @@ const agent: OssaAgent = {
251
311
  };
252
312
  ```
253
313
 
254
- ## What's New in v0.4.0 (Release Candidate)
314
+ ## What's New in v0.4.1 (Release Candidate)
255
315
 
256
316
  ### NPM Package Export + Claude Skills Integration
257
317
 
@@ -313,7 +373,7 @@ claude --print "use my-agent to analyze this code"
313
373
 
314
374
  ---
315
375
 
316
- ## What's New in v0.3.6
376
+ ## What's New in v0.4.1
317
377
 
318
378
  ### New Features
319
379
 
@@ -336,7 +396,7 @@ claude --print "use my-agent to analyze this code"
336
396
  - **Full Documentation**: [openstandardagents.org](https://openstandardagents.org)
337
397
  - **API Reference**: [GitLab Pages](https://blueflyio.gitlab.io/ossa/openstandardagents)
338
398
  - **Examples**: [`examples/`](./examples) directory
339
- - **Migration Guide**: [`spec/v0.3/MIGRATION-v0.3.5-to-v0.3.6.md`](./spec/v0.3/MIGRATION-v0.3.5-to-v0.3.6.md)
399
+ - **Migration Guide**: [`spec/v0.3/MIGRATION-v0.3.6-to-v0.4.x.md`](./spec/v0.3/MIGRATION-v0.3.6-to-v0.4.x.md)
340
400
 
341
401
  ## Real-World Use Cases
342
402
 
@@ -344,7 +404,7 @@ claude --print "use my-agent to analyze this code"
344
404
 
345
405
  ```yaml
346
406
  # Production agent with full lifecycle tracking
347
- apiVersion: ossa/v0.3.6
407
+ apiVersion: ossa/v0.4.1
348
408
  kind: Agent
349
409
  metadata:
350
410
  name: enterprise-analyst
@@ -375,7 +435,7 @@ spec:
375
435
 
376
436
  ```yaml
377
437
  # Particle Swarm Optimization for infrastructure
378
- apiVersion: ossa/v0.3.6
438
+ apiVersion: ossa/v0.4.1
379
439
  kind: Agent
380
440
  metadata:
381
441
  name: pso-optimizer
@@ -411,7 +471,7 @@ MIT License - see [LICENSE](./LICENSE) for details.
411
471
  - **GitLab**: [blueflyio/ossa/openstandardagents](https://gitlab.com/blueflyio/ossa/openstandardagents)
412
472
  - **GitHub Mirror**: [blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
413
473
  - **Website**: [openstandardagents.org](https://openstandardagents.org)
414
- - **Spec**: [JSON Schema](./spec/v0.3/ossa-0.3.6.schema.json)
474
+ - **Spec**: [JSON Schema](./spec/v0.4/agent.schema.json)
415
475
 
416
476
  ## Support
417
477
 
@@ -0,0 +1,149 @@
1
+ /**
2
+ * Drupal Module Generator for OSSA Agents
3
+ *
4
+ * Generates complete, production-ready Drupal modules from OSSA agent manifests.
5
+ *
6
+ * Generated modules include:
7
+ * - MODULE.info.yml (module metadata)
8
+ * - MODULE.services.yml (DI configuration)
9
+ * - src/Service/AgentExecutor (wrapper around ossa/symfony-bundle)
10
+ * - src/Plugin/QueueWorker (async execution support)
11
+ * - src/Controller (admin UI and API endpoints)
12
+ * - src/Entity (agent result storage)
13
+ * - src/Form (configuration forms)
14
+ * - MODULE.module (Drupal hooks: entity_presave, cron, etc.)
15
+ * - templates/*.html.twig (Twig templates)
16
+ * - composer.json (with ossa/symfony-bundle dependency)
17
+ * - config/schema/MODULE.schema.yml (configuration schema)
18
+ * - config/install/*.yml (default configuration)
19
+ *
20
+ * SOLID Principles:
21
+ * - Single Responsibility: Drupal module generation only
22
+ * - Dependency Inversion: Uses ossa/symfony-bundle for agent execution
23
+ * - Interface Segregation: Separate interfaces for different module components
24
+ *
25
+ * DRY: Reuses Symfony bundle patterns, no duplication
26
+ */
27
+ import { BaseAdapter } from '../base/adapter.interface.js';
28
+ import type { OssaAgent, ExportOptions, ExportResult, ValidationResult } from '../base/adapter.interface.js';
29
+ export interface DrupalModuleGeneratorOptions extends ExportOptions {
30
+ /** Include Queue Worker for async execution */
31
+ includeQueueWorker?: boolean;
32
+ /** Include Entity for result storage */
33
+ includeEntity?: boolean;
34
+ /** Include Controller with admin UI */
35
+ includeController?: boolean;
36
+ /** Include Configuration Form */
37
+ includeConfigForm?: boolean;
38
+ /** Include Drupal hooks (entity_presave, cron) */
39
+ includeHooks?: boolean;
40
+ /** Include Views integration */
41
+ includeViews?: boolean;
42
+ /** Drupal core version requirement */
43
+ coreVersion?: string;
44
+ }
45
+ export declare class DrupalModuleGenerator extends BaseAdapter {
46
+ readonly platform = "drupal";
47
+ readonly displayName = "Drupal Module (Full)";
48
+ readonly description = "Production-ready Drupal module with OSSA/Symfony integration";
49
+ readonly supportedVersions: string[];
50
+ /**
51
+ * Generate complete Drupal module from OSSA manifest
52
+ */
53
+ export(manifest: OssaAgent, options?: DrupalModuleGeneratorOptions): Promise<ExportResult>;
54
+ /**
55
+ * Validate manifest for Drupal compatibility
56
+ */
57
+ validate(manifest: OssaAgent): Promise<ValidationResult>;
58
+ /**
59
+ * Get example manifest optimized for Drupal
60
+ */
61
+ getExample(): OssaAgent;
62
+ /**
63
+ * Generate MODULE.info.yml
64
+ */
65
+ private generateInfoYml;
66
+ /**
67
+ * Generate MODULE.services.yml with full DI configuration
68
+ */
69
+ private generateServicesYml;
70
+ /**
71
+ * Generate composer.json with ossa/symfony-bundle dependency
72
+ */
73
+ private generateComposerJson;
74
+ /**
75
+ * Generate MODULE.module with Drupal hooks
76
+ */
77
+ private generateModuleHooks;
78
+ /**
79
+ * Generate src/Service/AgentExecutorService.php
80
+ *
81
+ * Wraps Symfony bundle AgentExecutor with Drupal-specific features
82
+ */
83
+ private generateAgentExecutorService;
84
+ /**
85
+ * Generate src/Plugin/QueueWorker/AgentQueueWorker.php
86
+ */
87
+ private generateQueueWorker;
88
+ /**
89
+ * Generate src/Entity/AgentResult.php
90
+ */
91
+ private generateEntityClass;
92
+ /**
93
+ * Generate src/Entity/AgentResultInterface.php
94
+ */
95
+ private generateEntityInterface;
96
+ /**
97
+ * Generate MODULE.views.inc
98
+ */
99
+ private generateViewsData;
100
+ /**
101
+ * Generate src/Controller/AgentController.php
102
+ */
103
+ private generateController;
104
+ /**
105
+ * Generate MODULE.routing.yml
106
+ */
107
+ private generateRouting;
108
+ /**
109
+ * Generate src/Form/AgentConfigForm.php
110
+ */
111
+ private generateConfigForm;
112
+ /**
113
+ * Generate MODULE.links.menu.yml
114
+ */
115
+ private generateMenuLinks;
116
+ /**
117
+ * Generate config/schema/MODULE.schema.yml
118
+ */
119
+ private generateConfigSchema;
120
+ /**
121
+ * Generate config/install/MODULE.settings.yml
122
+ */
123
+ private generateDefaultConfig;
124
+ /**
125
+ * Generate templates/agent-result.html.twig
126
+ */
127
+ private generateAgentResultTemplate;
128
+ /**
129
+ * Generate templates/agent-execute-form.html.twig
130
+ */
131
+ private generateExecuteFormTemplate;
132
+ /**
133
+ * Generate README.md
134
+ */
135
+ private generateReadme;
136
+ /**
137
+ * Generate INSTALL.md
138
+ */
139
+ private generateInstallGuide;
140
+ /**
141
+ * Sanitize module name for Drupal
142
+ */
143
+ private sanitizeModuleName;
144
+ /**
145
+ * Convert module name to class name (PascalCase)
146
+ */
147
+ private toClassName;
148
+ }
149
+ //# sourceMappingURL=generator.d.ts.map