@bluefly/openstandardagents 0.4.0 → 0.4.1

package/examples/langgraph/state-machine-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3",
+  "apiVersion": "ossa/v0.4.1",
   "kind": "Agent",
   "metadata": {
     "name": "state-machine-agent",

package/examples/lifecycle/mentoring-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3.6",
+  "apiVersion": "ossa/v0.4.1",
   "kind": "Agent",
   "metadata": {
     "name": "senior-security-mentor",

package/examples/llamaindex/rag-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3",
+  "apiVersion": "ossa/v0.4.1",
   "kind": "Agent",
   "metadata": {
     "name": "rag-query-agent",

package/examples/mcp/database-mcp.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: database-assistant

package/examples/mcp/filesystem-mcp.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: filesystem-assistant

package/examples/messaging/dependency-healer.ossa.yaml

@@ -3,7 +3,7 @@
 # This agent monitors dependencies, detects outdated packages, and coordinates
 # updates while communicating with security scanners via OSSA messaging.
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: dependency-healer

package/examples/messaging/incident-responder.ossa.yaml

@@ -3,7 +3,7 @@
 # This agent receives security incidents from multiple sources and coordinates
 # response activities across teams via OSSA messaging.
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: incident-responder

package/examples/messaging/routing-rules.ossa.yaml

@@ -4,7 +4,7 @@
 # in a multi-agent security system. It implements the routing rules
 # for the security-scanner, dependency-healer, and incident-responder agents.
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Workflow
 metadata:
   name: security-workflow-routing

package/examples/messaging/security-scanner.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: security-scanner

package/examples/migration-guides/from-langchain-to-ossa.yaml

@@ -50,7 +50,7 @@
 # OSSA MANIFEST (After):
 # ----------------------------------------------------------------------------
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 
 metadata:
@@ -117,7 +117,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 
 metadata:
@@ -185,7 +185,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 
 metadata:
@@ -215,7 +215,7 @@ spec:
       endpoint: https://api.academic.com/search
 
 ---
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 
 metadata:

package/examples/migrations/langchain/01-python-react-agent-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: python-react-agent

package/examples/migrations/langchain/02-typescript-conversational-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: typescript-conversational

package/examples/migrations/langchain/03-sequential-chain-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Workflow
 metadata:
   name: sequential-chain

package/examples/migrations/langchain/04-config-based-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: customer-support-agent

package/examples/migrations/swarm-to-ossa/after-handoffs.ossa.yaml

@@ -15,7 +15,7 @@
 # ============================================================================
 # Sales Agent - Entry Point
 # ============================================================================
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: sales-agent
@@ -81,7 +81,7 @@ spec:
 # ============================================================================
 # Order Verification Agent
 # ============================================================================
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: order-verification-agent
@@ -160,7 +160,7 @@ spec:
 # ============================================================================
 # Payment Processing Agent
 # ============================================================================
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: payment-processing-agent
@@ -270,7 +270,7 @@ spec:
 # ============================================================================
 # Fulfillment Agent
 # ============================================================================
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: fulfillment-agent
@@ -339,7 +339,7 @@ spec:
 # ============================================================================
 # Supervisor Agent
 # ============================================================================
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: supervisor-agent
@@ -421,7 +421,7 @@ spec:
 # ============================================================================
 # Workflow Orchestration (Bonus: NOT POSSIBLE in Swarm!)
 # ============================================================================
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Workflow
 metadata:
   name: order-processing-workflow

package/examples/migrations/swarm-to-ossa/after-triage-agent.ossa.yaml

@@ -10,7 +10,7 @@
 # - 50% less code
 # - Enterprise features built-in
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: customer-service-triage
@@ -139,7 +139,7 @@ spec:
 
 ---
 # Sales Agent (equivalent to sales_agent in Swarm)
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: sales-agent
@@ -223,7 +223,7 @@ spec:
 
 ---
 # Refunds Agent (equivalent to refunds_agent in Swarm)
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: refunds-agent

package/examples/multi-agent/conditional-router.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: conditional-router

package/examples/multi-agent/parallel-execution.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: parallel-executor

package/examples/multi-agent/sequential-pipeline.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: sequential-pipeline

package/examples/multi-agent-research-workflow.ossa.yaml

@@ -0,0 +1,133 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: research-workflow
+  version: 1.0.0
+  description: Multi-agent research and writing workflow with human review
+  labels:
+    type: workflow
+    pattern: multi-agent
+spec:
+  role: |
+    You are an orchestrator for a research and writing workflow.
+    You coordinate multiple specialized agents to produce high-quality content.
+
+  llm:
+    provider: openai
+    model: gpt-4
+    temperature: 0.7
+    maxTokens: 2000
+
+  workflow:
+    steps:
+      - id: researcher
+        name: Research Agent
+        description: Conducts thorough research on the given topic using available tools
+        kind: Agent
+        depends_on: []
+
+      - id: writer
+        name: Writer Agent
+        description: Writes a comprehensive article based on research findings
+        kind: Agent
+        depends_on:
+          - researcher
+
+      - id: critic
+        name: Critic Agent
+        description: Reviews and provides constructive feedback on the article
+        kind: Agent
+        depends_on:
+          - writer
+        condition: quality_score < 8
+
+      - id: editor
+        name: Editor Agent
+        description: Final editing and polish of the article
+        kind: Agent
+        depends_on:
+          - writer
+          - critic
+
+  tools:
+    - name: web_search
+      type: function
+      description: Search the web for information
+      parameters:
+        type: object
+        properties:
+          query:
+            type: string
+            description: Search query
+          num_results:
+            type: integer
+            description: Number of results to return
+            default: 5
+        required:
+          - query
+
+    - name: read_url
+      type: function
+      description: Read content from a URL
+      parameters:
+        type: object
+        properties:
+          url:
+            type: string
+            description: URL to read
+        required:
+          - url
+
+    - name: save_document
+      type: function
+      description: Save document to storage
+      parameters:
+        type: object
+        properties:
+          title:
+            type: string
+            description: Document title
+          content:
+            type: string
+            description: Document content
+          format:
+            type: string
+            enum:
+              - markdown
+              - html
+              - text
+        required:
+          - title
+          - content
+
+  autonomy:
+    level: supervised
+    approval_required: true
+    allowed_actions:
+      - web_search
+      - read_url
+      - save_document
+    blocked_actions:
+      - delete_file
+      - modify_system
+
+  constraints:
+    cost:
+      maxTokensPerRequest: 4000
+      maxCostPerDay: 10.00
+      currency: USD
+    performance:
+      maxLatencySeconds: 30
+      maxErrorRate: 0.05
+
+  observability:
+    tracing:
+      enabled: true
+      exporter: otlp
+      endpoint: http://localhost:4317
+    metrics:
+      enabled: true
+      exporter: prometheus
+    logging:
+      level: info
+      format: json

package/examples/multi-platform/single-manifest/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: multi-platform-demo

package/examples/npm-export-example.ts

@@ -0,0 +1,150 @@
+/**
+ * NPM Package Export Example
+ *
+ * Demonstrates exporting OSSA manifests to npm packages
+ */
+
+import { NPMExporter } from '../src/services/export/npm/npm-exporter.js';
+import type { OssaAgent } from '../src/types/index.js';
+import * as fs from 'fs';
+import * as path from 'path';
+
+/**
+ * Example OSSA agent manifest
+ */
+const manifest: OssaAgent = {
+  apiVersion: 'ossa/v0.4.1',
+  kind: 'Agent',
+  metadata: {
+    name: 'code-review-agent',
+    version: '1.0.0',
+    description: 'An AI agent specialized in code review and analysis',
+    author: 'OSSA Team',
+    license: 'MIT',
+    annotations: {
+      repository: 'https://github.com/ossa/code-review-agent',
+    },
+    labels: {
+      category: 'developer-tools',
+      framework: 'ossa',
+    },
+  },
+  spec: {
+    role: `You are an expert code reviewer with deep knowledge of software engineering best practices.
+Your role is to:
+- Analyze code for potential bugs and issues
+- Suggest improvements for code quality
+- Identify security vulnerabilities
+- Recommend performance optimizations
+- Ensure adherence to coding standards`,
+    llm: {
+      provider: 'anthropic',
+      model: 'claude-3-5-sonnet-20241022',
+      temperature: 0.3,
+      maxTokens: 8000,
+    },
+    tools: [
+      {
+        name: 'analyze-code',
+        description: 'Perform static code analysis',
+        type: 'function',
+      },
+      {
+        name: 'check-security',
+        description: 'Scan code for security vulnerabilities',
+        type: 'api',
+      },
+      {
+        name: 'suggest-improvements',
+        description: 'Generate code improvement suggestions',
+        type: 'function',
+      },
+    ],
+    capabilities: ['code-analysis', 'security-scanning', 'best-practices'],
+  },
+};
+
+/**
+ * Export agent to npm package
+ */
+async function exportToNpm() {
+  const exporter = new NPMExporter();
+
+  console.log('Exporting OSSA manifest to npm package...\n');
+
+  const result = await exporter.export(manifest, {
+    scope: '@ossa',
+    includeDocker: true,
+    includeTests: true,
+    nodeVersion: '18-alpine',
+  });
+
+  if (!result.success) {
+    console.error('❌ Export failed:', result.error);
+    process.exit(1);
+  }
+
+  console.log(`✅ Export successful!`);
+  console.log(`   Package: ${result.packageName}`);
+  console.log(`   Version: ${result.version}`);
+  console.log(`   Files: ${result.files.length}`);
+  console.log(`   Duration: ${result.metadata?.duration}ms\n`);
+
+  // Write files to exports directory
+  const outputDir = path.join(process.cwd(), 'exports', 'npm', 'code-review-agent');
+
+  console.log(`Writing files to: ${outputDir}\n`);
+
+  for (const file of result.files) {
+    const filePath = path.join(outputDir, file.path);
+    const dir = path.dirname(filePath);
+
+    // Create directory if it doesn't exist
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+
+    // Write file
+    fs.writeFileSync(filePath, file.content, 'utf-8');
+    console.log(`  ✓ ${file.path}`);
+  }
+
+  console.log('\n📦 Package generated successfully!');
+  console.log('\nNext steps:');
+  console.log(`  cd ${outputDir}`);
+  console.log('  npm install');
+  console.log('  npm run build');
+  console.log('  npm test');
+  console.log('  npm start\n');
+
+  console.log('To publish to npm:');
+  console.log('  npm publish\n');
+
+  // Show file structure
+  console.log('Generated files:');
+  console.log('├── package.json');
+  console.log('├── tsconfig.json');
+  console.log('├── README.md');
+  console.log('├── .gitignore');
+  console.log('├── .npmignore');
+  console.log('├── Dockerfile');
+  console.log('├── docker-compose.yaml');
+  console.log('├── openapi.yaml');
+  console.log('├── src/');
+  console.log('│   ├── index.ts         (Agent class)');
+  console.log('│   ├── types.ts         (TypeScript types)');
+  console.log('│   ├── server.ts        (Express server)');
+  console.log('│   └── tools/');
+  console.log('│       ├── index.ts');
+  console.log('│       ├── analyze-code.ts');
+  console.log('│       ├── check-security.ts');
+  console.log('│       └── suggest-improvements.ts');
+  console.log('└── tests/');
+  console.log('    └── agent.test.ts\n');
+}
+
+// Run example
+exportToNpm().catch((error) => {
+  console.error('Error:', error);
+  process.exit(1);
+});

package/examples/observability/activity-stream-full.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: activity-tracked-agent

package/examples/openai/basic-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: basic-openai-agent

package/examples/openai/multi-tool-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3",
+  "apiVersion": "ossa/v0.4.1",
   "kind": "Agent",
   "metadata": {
     "name": "multi-tool-agent",

package/examples/openai/swarm-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3",
+  "apiVersion": "ossa/v0.4.1",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",

package/examples/ossa-templates/01-code-assistant.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: code-assistant

package/examples/ossa-templates/02-security-scanner.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: security-scanner

package/examples/ossa-templates/03-ci-pipeline.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: ci-pipeline

package/examples/ossa-templates/04-code-reviewer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: code-reviewer

package/examples/ossa-templates/05-doc-generator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: doc-generator

package/examples/ossa-templates/06-compliance-validator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: compliance-validator

package/examples/ossa-templates/07-workflow-orchestrator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Workflow
 metadata:
   name: workflow-orchestrator

package/examples/ossa-templates/08-content-writer.ossa.yaml

@@ -7,7 +7,7 @@
 # Showcases: Drupal extension, async processing (Messenger), ECA integration
 # ============================================================================
 
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: content-writer

package/examples/ossa-templates/09-test-generator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: test-generator

package/examples/ossa-templates/10-data-transformer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Task
 metadata:
   name: data-transformer

package/examples/ossa-templates/11-react-performance-expert.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: react-performance-expert

package/examples/ossa-templates/12-typescript-type-safety-expert.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: typescript-type-safety-expert

package/examples/ossa-templates/13-accessibility-champion.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: accessibility-champion

package/examples/ossa-templates/14-security-hardening-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: security-hardening-agent