@bluefly/openstandardagents 0.4.9 → 0.5.0

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 (125) hide show
  1. package/.version.json +3 -3
  2. package/CHANGELOG.md +8 -8
  3. package/README.md +68 -58
  4. package/bin/postinstall +0 -0
  5. package/dist/.version.json +3 -3
  6. package/dist/adapters/claude-code/adapter.js +2 -2
  7. package/dist/adapters/docker/generators.js +19 -19
  8. package/dist/adapters/drupal/generator.js +76 -76
  9. package/dist/adapters/openai-agents/adapter.js +2 -2
  10. package/dist/cli/schema-driven/schema-loader.js +5 -5
  11. package/dist/mcp-server/__tests__/mcp-server.spec.js +20 -11
  12. package/dist/mcp-server/index.js +0 -0
  13. package/dist/package.json +24 -11
  14. package/dist/services/export/langchain/langchain-exporter.js +2 -2
  15. package/dist/services/export/langchain/memory-generator.js +2 -2
  16. package/dist/services/export/testing/test-generator.js +1 -1
  17. package/dist/services/taxonomy-service.d.ts +3 -3
  18. package/dist/skills/test-skill/package.json +1 -1
  19. package/dist/spec/extensions/role-manifest.md +188 -0
  20. package/dist/spec/v0.4/extensions/mcp/README.md +1 -1
  21. package/dist/spec/v0.5/agent.schema.json +2 -1
  22. package/dist/spec/v0.5/extensions/mcp/README.md +1 -1
  23. package/dist/spec/v0.5/role.schema.json +268 -0
  24. package/dist/types/index.d.ts +2 -0
  25. package/dist/types/index.js +2 -0
  26. package/dist/types/role.d.ts +126 -0
  27. package/dist/types/role.js +38 -0
  28. package/dist/validation/validator.js +1 -1
  29. package/examples/agents/01-customer-support-bot/agent.ossa.yaml +24 -31
  30. package/examples/agents/05-sales-assistant/agent.ossa.yaml +35 -23
  31. package/examples/agents/07-research-assistant/agent.ossa.yaml +27 -21
  32. package/examples/agents/10-meeting-assistant/agent.ossa.yaml +27 -35
  33. package/examples/agents/security-audit-agent.ossa.yaml +234 -0
  34. package/examples/agentscope/react-assistant/agent.ossa.yaml +36 -32
  35. package/examples/drupal/content-moderator.ossa.yaml +2 -2
  36. package/examples/drupal/drupal-contributor.ossa.yaml +247 -0
  37. package/examples/export/langchain/production-agent-with-memory/README.md +1 -1
  38. package/examples/export/langchain/production-agent-with-memory/agent.ossa.yaml +13 -23
  39. package/examples/export/langchain/production-agent-with-streaming/agent.ossa.yaml +1 -15
  40. package/examples/export/langchain/production-agent-with-tools/agent.ossa.yaml +28 -29
  41. package/examples/getting-started/01-minimal-agent.ossa.yaml +1 -1
  42. package/examples/getting-started/02-agent-with-tools.ossa.yaml +1 -1
  43. package/examples/getting-started/03-agent-with-safety.ossa.yaml +1 -1
  44. package/examples/getting-started/04-agent-with-messaging.ossa.yaml +1 -1
  45. package/examples/getting-started/05-workflow-composition.ossa.yaml +1 -1
  46. package/examples/getting-started/README.md +3 -3
  47. package/examples/getting-started/hello-world-complete.ossa.yaml +1 -1
  48. package/examples/gitlab-agents/gitlab-ci-agent.ossa.yaml +221 -0
  49. package/examples/hierarchical-agent.ossa.yaml +10 -53
  50. package/examples/kagent/ossa-kagent-anthropic.ossa.yaml +2 -25
  51. package/examples/kagent/ossa-kagent-mcp-tools.ossa.yaml +2 -30
  52. package/examples/kagent/ossa-kagent-multi-tool.ossa.yaml +2 -18
  53. package/examples/kagent/ossa-kagent-poc.ossa.yaml +2 -16
  54. package/examples/pipeline-agent.ossa.yaml +3 -3
  55. package/examples/platform-specific/claude-code-subagent.yaml +1 -1
  56. package/examples/platform-specific/cursor-coding-agent.yaml +1 -1
  57. package/examples/platform-specific/warp-terminal-agent.yaml +1 -1
  58. package/examples/production-ready/01-customer-support-bot/agent.ossa.yaml +24 -31
  59. package/examples/production-ready/05-sales-assistant/agent.ossa.yaml +35 -23
  60. package/examples/production-ready/07-research-assistant/agent.ossa.yaml +27 -19
  61. package/examples/production-ready/10-meeting-assistant/agent.ossa.yaml +27 -35
  62. package/examples/reference-implementations/python-client/examples/basic_usage.py +0 -0
  63. package/examples/reference-implementations/python-client/examples/publish_agent.py +0 -0
  64. package/examples/roles/drupal-developer.role.yaml +37 -0
  65. package/examples/roles/platform-operator.role.yaml +28 -0
  66. package/examples/roles/security-auditor.role.yaml +27 -0
  67. package/examples/swarm-agent.ossa.yaml +13 -51
  68. package/examples/team-agent.ossa.yaml +12 -61
  69. package/examples/team-lead-teammate.ossa.yaml +12 -17
  70. package/openapi/agent-communication.yaml +260 -212
  71. package/openapi/agent-crud.yaml +217 -187
  72. package/openapi/agent-discovery.yaml +119 -81
  73. package/openapi/agent-identity.yaml +219 -187
  74. package/openapi/agent-taxonomy.yaml +95 -38
  75. package/openapi/agents-md-service.yaml +103 -30
  76. package/openapi/cli/openapi.yaml +147 -40
  77. package/openapi/core/ossa-core-api.openapi.yaml +327 -271
  78. package/openapi/core/ossa-registry-api.openapi.yaml +298 -235
  79. package/openapi/core/ossa-registry.openapi.yaml +299 -159
  80. package/openapi/core/unified-agent-gateway.openapi.yaml +234 -170
  81. package/openapi/daemon-api.openapi.yaml +323 -181
  82. package/openapi/dev-cli/openapi.yaml +137 -113
  83. package/openapi/github-sync.yaml +62 -19
  84. package/openapi/marketplace-plugin.openapi.yaml +539 -466
  85. package/openapi/ossa-api.openapi.yaml +354 -213
  86. package/openapi/ossa-cli-enhancements.openapi.yaml +108 -89
  87. package/openapi/ossa-cli.yaml +260 -184
  88. package/openapi/protocols/sse-streams.yaml +66 -74
  89. package/openapi/protocols/websocket-events.yaml +61 -54
  90. package/openapi/reference-implementations/aiflow-bridge-api.openapi.yaml +37 -20
  91. package/openapi/reference-implementations/compliance-agent-api.openapi.yaml +35 -23
  92. package/openapi/reference-implementations/crewai-agent-api.openapi.yaml +29 -18
  93. package/openapi/reference-implementations/critic-agent-api.openapi.yaml +45 -19
  94. package/openapi/reference-implementations/document-analyzer-api.openapi.yaml +30 -24
  95. package/openapi/reference-implementations/drupal-agent-api.openapi.yaml +101 -50
  96. package/openapi/reference-implementations/getting-started-hello-world-api.openapi.yaml +33 -22
  97. package/openapi/reference-implementations/gitlab-ml-recommender-api.openapi.yaml +20 -16
  98. package/openapi/reference-implementations/governor-agent-api.openapi.yaml +41 -23
  99. package/openapi/reference-implementations/helm-generator.openapi.yaml +88 -46
  100. package/openapi/reference-implementations/integrator-agent-api.openapi.yaml +30 -20
  101. package/openapi/reference-implementations/judge-agent-api.openapi.yaml +22 -16
  102. package/openapi/reference-implementations/k8s-troubleshooter-api.openapi.yaml +32 -18
  103. package/openapi/reference-implementations/langchain-agent-api.openapi.yaml +32 -21
  104. package/openapi/reference-implementations/monitor-agent-api.openapi.yaml +34 -21
  105. package/openapi/reference-implementations/orchestrator-agent-api.openapi.yaml +49 -27
  106. package/openapi/reference-implementations/quickstart-support-agent-api.openapi.yaml +27 -19
  107. package/openapi/reference-implementations/self-evolving-ecosystem.openapi.yaml +427 -293
  108. package/openapi/reference-implementations/worker-agent-api.openapi.yaml +34 -23
  109. package/openapi/reference-implementations/workflow-orchestrator-api.openapi.yaml +35 -21
  110. package/openapi/release-automation.openapi.yaml +47 -13
  111. package/openapi/schemas/common/agent.yaml +30 -29
  112. package/openapi/schemas/common/errors.yaml +13 -3
  113. package/openapi/schemas/common/metadata.yaml +22 -7
  114. package/openapi/schemas/common/pagination.yaml +18 -6
  115. package/openapi/schemas/common/security.yaml +13 -5
  116. package/openapi/schemas/index.yaml +49 -42
  117. package/openapi/uadp-asyncapi.yaml +4 -2
  118. package/openapi/uadp-openapi.yaml +243 -165
  119. package/openapi/version-management.openapi.yaml +142 -135
  120. package/package.json +114 -103
  121. package/spec/extensions/role-manifest.md +188 -0
  122. package/spec/v0.4/extensions/mcp/README.md +1 -1
  123. package/spec/v0.5/agent.schema.json +2 -1
  124. package/spec/v0.5/extensions/mcp/README.md +1 -1
  125. package/spec/v0.5/role.schema.json +268 -0
@@ -5,7 +5,9 @@ info:
5
5
  description: |
6
6
  CrewAI research agent for multi-agent collaboration.
7
7
  Specializes in gathering comprehensive information on assigned topics.
8
-
8
+ contact:
9
+ name: Bluefly OSSA Team
10
+ url: https://gitlab.com/blueflyio/ossa/openstandardagents
9
11
  x-ossa-metadata:
10
12
  version: 0.2.5-RC
11
13
  compliance:
@@ -14,35 +16,36 @@ x-ossa-metadata:
14
16
  - OSSA
15
17
  - OpenAPI 3.1
16
18
  - CrewAI
17
-
19
+ observability:
20
+ tracing: true
21
+ metrics: true
22
+ logging: true
18
23
  x-ossa:
19
24
  version: 0.2.5-RC
20
25
  agent:
21
- id: research-agent
22
- type: worker
26
+ id: reference-implementations-crewai-agent-api
27
+ type: specialist
23
28
  compliance:
24
29
  standards:
25
30
  - openapi-first
26
31
  validated: true
27
- validatedAt: "2024-01-15T10:00:00Z"
28
-
32
+ validatedAt: 2024-01-15T10:00:00Z
29
33
  servers:
30
34
  - url: http://localhost:3000
31
35
  description: Local development
32
-
33
36
  tags:
34
37
  - name: research
35
38
  description: Research operations
36
39
  - name: collaboration
37
40
  description: Multi-agent collaboration operations
38
-
39
41
  paths:
40
42
  /research:
41
43
  post:
42
44
  summary: Conduct research
43
45
  description: Gather comprehensive information on assigned research topic
44
46
  operationId: conductResearch
45
- tags: [research]
47
+ tags:
48
+ - research
46
49
  x-ossa-capability: research
47
50
  x-ossa-autonomy:
48
51
  level: autonomous
@@ -57,14 +60,18 @@ paths:
57
60
  application/json:
58
61
  schema:
59
62
  type: object
60
- required: [topic]
63
+ required:
64
+ - topic
61
65
  properties:
62
66
  topic:
63
67
  type: string
64
68
  description: Research topic
65
69
  depth:
66
70
  type: string
67
- enum: [shallow, medium, deep]
71
+ enum:
72
+ - shallow
73
+ - medium
74
+ - deep
68
75
  default: medium
69
76
  sources:
70
77
  type: array
@@ -72,7 +79,7 @@ paths:
72
79
  type: string
73
80
  description: Preferred sources
74
81
  responses:
75
- '200':
82
+ "200":
76
83
  description: Research completed
77
84
  content:
78
85
  application/json:
@@ -98,13 +105,13 @@ paths:
98
105
  type: array
99
106
  items:
100
107
  type: string
101
-
102
108
  /collaborate:
103
109
  post:
104
110
  summary: Collaborate with other agents
105
111
  description: Coordinate with other CrewAI agents for collaborative tasks
106
112
  operationId: collaborate
107
- tags: [collaboration]
113
+ tags:
114
+ - collaboration
108
115
  x-ossa-capability: collaborate
109
116
  x-ossa-autonomy:
110
117
  level: autonomous
@@ -115,7 +122,9 @@ paths:
115
122
  application/json:
116
123
  schema:
117
124
  type: object
118
- required: [task, agents]
125
+ required:
126
+ - task
127
+ - agents
119
128
  properties:
120
129
  task:
121
130
  type: string
@@ -130,7 +139,7 @@ paths:
130
139
  role:
131
140
  type: string
132
141
  responses:
133
- '200':
142
+ "200":
134
143
  description: Collaboration initiated
135
144
  content:
136
145
  application/json:
@@ -141,9 +150,11 @@ paths:
141
150
  type: string
142
151
  status:
143
152
  type: string
144
- enum: [initiated, in_progress, completed]
153
+ enum:
154
+ - initiated
155
+ - in_progress
156
+ - completed
145
157
  agents:
146
158
  type: array
147
159
  items:
148
160
  type: object
149
-
@@ -5,7 +5,9 @@ info:
5
5
  description: |
6
6
  Quality assurance agent for code review, testing, and continuous improvement.
7
7
  Analyzes code quality, detects issues, and suggests improvements.
8
-
8
+ contact:
9
+ name: Bluefly OSSA Team
10
+ url: https://gitlab.com/blueflyio/ossa/openstandardagents
9
11
  x-ossa-metadata:
10
12
  version: 0.2.5-RC
11
13
  compliance:
@@ -13,36 +15,37 @@ x-ossa-metadata:
13
15
  frameworks:
14
16
  - OSSA
15
17
  - OpenAPI 3.1
16
-
18
+ observability:
19
+ tracing: true
20
+ metrics: true
21
+ logging: true
17
22
  x-ossa:
18
23
  version: 0.2.5-RC
19
24
  agent:
20
- id: code-quality-critic
25
+ id: reference-implementations-critic-agent-api
21
26
  type: critic
22
27
  compliance:
23
28
  standards:
24
29
  - openapi-first
25
30
  - type-safe
26
31
  validated: true
27
- validatedAt: "2024-01-15T10:00:00Z"
28
-
32
+ validatedAt: 2024-01-15T10:00:00Z
29
33
  servers:
30
34
  - url: https://critic.platform.com/api/v1
31
35
  description: Production
32
-
33
36
  tags:
34
37
  - name: review
35
38
  description: Code review operations
36
39
  - name: analysis
37
40
  description: Code analysis operations
38
-
39
41
  paths:
40
42
  /review:
41
43
  post:
42
44
  summary: Review code changes
43
45
  description: Analyze code changes for quality, security, and best practices
44
46
  operationId: reviewCode
45
- tags: [review]
47
+ tags:
48
+ - review
46
49
  x-ossa-capability: review-changes
47
50
  x-ossa-autonomy:
48
51
  level: autonomous
@@ -57,19 +60,28 @@ paths:
57
60
  application/json:
58
61
  schema:
59
62
  type: object
60
- required: [code, language]
63
+ required:
64
+ - code
65
+ - language
61
66
  properties:
62
67
  code:
63
68
  type: string
64
69
  description: Code to review
65
70
  language:
66
71
  type: string
67
- enum: [javascript, typescript, python, java, go, rust, csharp]
72
+ enum:
73
+ - javascript
74
+ - typescript
75
+ - python
76
+ - java
77
+ - go
78
+ - rust
79
+ - csharp
68
80
  diff:
69
81
  type: string
70
82
  description: Git diff of changes
71
83
  responses:
72
- '200':
84
+ "200":
73
85
  description: Review completed
74
86
  content:
75
87
  application/json:
@@ -83,10 +95,18 @@ paths:
83
95
  properties:
84
96
  severity:
85
97
  type: string
86
- enum: [critical, high, medium, low]
98
+ enum:
99
+ - critical
100
+ - high
101
+ - medium
102
+ - low
87
103
  type:
88
104
  type: string
89
- enum: [security, performance, maintainability, style]
105
+ enum:
106
+ - security
107
+ - performance
108
+ - maintainability
109
+ - style
90
110
  message:
91
111
  type: string
92
112
  line:
@@ -99,13 +119,13 @@ paths:
99
119
  type: number
100
120
  minimum: 0
101
121
  maximum: 100
102
-
103
122
  /analyze:
104
123
  post:
105
124
  summary: Analyze code quality
106
125
  description: Perform comprehensive code quality analysis
107
126
  operationId: analyzeCode
108
- tags: [analysis]
127
+ tags:
128
+ - analysis
109
129
  x-ossa-capability: analyze-code
110
130
  x-ossa-autonomy:
111
131
  level: autonomous
@@ -116,7 +136,8 @@ paths:
116
136
  application/json:
117
137
  schema:
118
138
  type: object
119
- required: [code]
139
+ required:
140
+ - code
120
141
  properties:
121
142
  code:
122
143
  type: string
@@ -124,9 +145,15 @@ paths:
124
145
  type: array
125
146
  items:
126
147
  type: string
127
- enum: [complexity, maintainability, reliability, security, performance, testability]
148
+ enum:
149
+ - complexity
150
+ - maintainability
151
+ - reliability
152
+ - security
153
+ - performance
154
+ - testability
128
155
  responses:
129
- '200':
156
+ "200":
130
157
  description: Analysis completed
131
158
  content:
132
159
  application/json:
@@ -148,4 +175,3 @@ paths:
148
175
  type: number
149
176
  testability:
150
177
  type: number
151
-
@@ -5,7 +5,9 @@ info:
5
5
  description: |
6
6
  Production document analysis agent with NLP capabilities.
7
7
  Analyzes documents for sentiment, extracts entities, generates summaries, and classifies content.
8
-
8
+ contact:
9
+ name: Bluefly OSSA Team
10
+ url: https://gitlab.com/blueflyio/ossa/openstandardagents
9
11
  x-ossa-metadata:
10
12
  version: 0.2.5-RC
11
13
  compliance:
@@ -13,36 +15,37 @@ x-ossa-metadata:
13
15
  frameworks:
14
16
  - OSSA
15
17
  - OpenAPI 3.1
16
-
18
+ observability:
19
+ tracing: true
20
+ metrics: true
21
+ logging: true
17
22
  x-ossa:
18
23
  version: 0.2.5-RC
19
24
  agent:
20
- id: document-analyzer
21
- type: worker
25
+ id: reference-implementations-document-analyzer-api
26
+ type: specialist
22
27
  compliance:
23
28
  standards:
24
29
  - openapi-first
25
30
  - type-safe
26
31
  validated: true
27
- validatedAt: "2024-01-15T10:00:00Z"
28
-
32
+ validatedAt: 2024-01-15T10:00:00Z
29
33
  servers:
30
34
  - url: https://document-analyzer.platform.com/api/v1
31
35
  description: Production
32
-
33
36
  tags:
34
37
  - name: analysis
35
38
  description: Document analysis operations
36
39
  - name: extraction
37
40
  description: Text extraction operations
38
-
39
41
  paths:
40
42
  /analyze:
41
43
  post:
42
44
  summary: Analyze document
43
45
  description: Comprehensive document analysis with sentiment and entity extraction
44
46
  operationId: analyzeDocument
45
- tags: [analysis]
47
+ tags:
48
+ - analysis
46
49
  x-ossa-capability: analyze_document
47
50
  x-ossa-autonomy:
48
51
  level: autonomous
@@ -57,7 +60,8 @@ paths:
57
60
  application/json:
58
61
  schema:
59
62
  type: object
60
- required: [document]
63
+ required:
64
+ - document
61
65
  properties:
62
66
  document:
63
67
  type: string
@@ -69,7 +73,7 @@ paths:
69
73
  type: boolean
70
74
  default: true
71
75
  responses:
72
- '200':
76
+ "200":
73
77
  description: Analysis completed
74
78
  content:
75
79
  application/json:
@@ -100,13 +104,13 @@ paths:
100
104
  type: integer
101
105
  summary:
102
106
  type: string
103
-
104
107
  /extract:
105
108
  post:
106
109
  summary: Extract text from document
107
110
  description: Extract text from various document formats (PDF, DOCX, images)
108
111
  operationId: extractText
109
- tags: [extraction]
112
+ tags:
113
+ - extraction
110
114
  x-ossa-capability: extract_text
111
115
  x-ossa-autonomy:
112
116
  level: autonomous
@@ -117,14 +121,15 @@ paths:
117
121
  multipart/form-data:
118
122
  schema:
119
123
  type: object
120
- required: [document]
124
+ required:
125
+ - document
121
126
  properties:
122
127
  document:
123
128
  type: string
124
129
  format: binary
125
130
  description: Document file to extract text from
126
131
  responses:
127
- '200':
132
+ "200":
128
133
  description: Text extracted
129
134
  content:
130
135
  application/json:
@@ -140,13 +145,13 @@ paths:
140
145
  type: string
141
146
  pages:
142
147
  type: integer
143
-
144
148
  /summarize:
145
149
  post:
146
150
  summary: Summarize document
147
151
  description: Generate concise document summary
148
152
  operationId: summarizeDocument
149
- tags: [analysis]
153
+ tags:
154
+ - analysis
150
155
  x-ossa-capability: summarize_document
151
156
  x-ossa-autonomy:
152
157
  level: autonomous
@@ -157,7 +162,8 @@ paths:
157
162
  application/json:
158
163
  schema:
159
164
  type: object
160
- required: [text]
165
+ required:
166
+ - text
161
167
  properties:
162
168
  text:
163
169
  type: string
@@ -167,7 +173,7 @@ paths:
167
173
  default: 500
168
174
  description: Maximum summary length in characters
169
175
  responses:
170
- '200':
176
+ "200":
171
177
  description: Summary generated
172
178
  content:
173
179
  application/json:
@@ -178,13 +184,13 @@ paths:
178
184
  type: string
179
185
  length:
180
186
  type: integer
181
-
182
187
  /classify:
183
188
  post:
184
189
  summary: Classify document
185
190
  description: Classify document into predefined categories
186
191
  operationId: classifyDocument
187
- tags: [analysis]
192
+ tags:
193
+ - analysis
188
194
  x-ossa-capability: classify_document
189
195
  x-ossa-autonomy:
190
196
  level: autonomous
@@ -195,13 +201,14 @@ paths:
195
201
  application/json:
196
202
  schema:
197
203
  type: object
198
- required: [text]
204
+ required:
205
+ - text
199
206
  properties:
200
207
  text:
201
208
  type: string
202
209
  description: Document text to classify
203
210
  responses:
204
- '200':
211
+ "200":
205
212
  description: Classification completed
206
213
  content:
207
214
  application/json:
@@ -214,4 +221,3 @@ paths:
214
221
  type: number
215
222
  minimum: 0
216
223
  maximum: 1
217
-