@bluefly/openstandardagents 0.2.9 → 0.3.0

package/examples/agents/spec-healer-openapi.yaml

@@ -0,0 +1,59 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: spec-healer-openapi
+  description: OpenAPI specification healer and validator
+spec:
+  model:
+    provider: anthropic
+    name: claude-3-5-sonnet-20241022
+  
+  tools:
+    - name: validate_openapi
+      description: Validate OpenAPI spec against standards
+      action: |
+        openapi-validator spec/openapi.yaml --errors-only
+    
+    - name: detect_breaking_changes
+      description: Compare specs and detect breaking changes
+      action: |
+        oasdiff breaking spec/v1.yaml spec/v2.yaml
+    
+    - name: generate_examples
+      description: Auto-generate request/response examples
+      action: |
+        openapi-examples-generator spec/openapi.yaml
+    
+    - name: sync_with_code
+      description: Ensure spec matches implementation
+      action: |
+        # Extract routes from code
+        # Compare with spec paths
+        # Flag mismatches
+        spectral lint spec/openapi.yaml --ruleset .spectral.yaml
+  
+  healing_rules:
+    - name: fix-missing-examples
+      condition: schema_without_examples
+      actions:
+        - generate_realistic_examples
+        - add_to_spec
+    
+    - name: fix-inconsistent-naming
+      condition: inconsistent_parameter_names
+      actions:
+        - standardize_to_camelCase
+        - update_all_references
+    
+    - name: add-missing-descriptions
+      condition: endpoint_without_description
+      actions:
+        - infer_from_code_comments
+        - generate_description
+    
+    - name: fix-security-definitions
+      condition: missing_security_schemes
+      actions:
+        - add_oauth2_flow
+        - add_api_key_header
+        - document_scopes

package/examples/agents/wiki-healer-production.yaml

@@ -0,0 +1,131 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: wiki-healer-production
+  description: Production wiki healer with comprehensive checks
+  labels:
+    tier: healer
+    domain: documentation
+spec:
+  model:
+    provider: anthropic
+    name: claude-3-5-sonnet-20241022
+  
+  capabilities:
+    - file_operations
+    - git_operations
+    - markdown_parsing
+    - link_validation
+    - content_analysis
+  
+  tools:
+    - name: check_broken_links
+      description: Scan wiki for broken internal/external links
+      action: |
+        find docs/ -name "*.md" -exec grep -H "](http" {} \; | \
+        while read line; do
+          url=$(echo "$line" | grep -oP '(?<=\()http[^)]+')
+          curl -s -o /dev/null -w "%{http_code}" "$url"
+        done
+    
+    - name: validate_frontmatter
+      description: Ensure all wiki pages have valid frontmatter
+      action: |
+        for file in docs/**/*.md; do
+          if ! head -n 5 "$file" | grep -q "^---$"; then
+            echo "Missing frontmatter: $file"
+          fi
+        done
+    
+    - name: check_orphaned_pages
+      description: Find pages not linked from anywhere
+      action: |
+        all_pages=$(find docs/ -name "*.md")
+        for page in $all_pages; do
+          basename=$(basename "$page")
+          if ! grep -r "$basename" docs/ --exclude="$page" > /dev/null; then
+            echo "Orphaned: $page"
+          fi
+        done
+    
+    - name: fix_markdown_formatting
+      description: Auto-fix common markdown issues
+      action: |
+        # Fix heading hierarchy
+        # Fix list indentation
+        # Fix code block fences
+        # Fix table formatting
+        prettier --write "docs/**/*.md"
+    
+    - name: update_table_of_contents
+      description: Regenerate TOC for changed pages
+      action: |
+        for file in $(git diff --name-only HEAD~1 docs/**/*.md); do
+          markdown-toc -i "$file"
+        done
+    
+    - name: check_image_references
+      description: Validate all image references exist
+      action: |
+        grep -r "!\[.*\](" docs/ | while read line; do
+          img=$(echo "$line" | grep -oP '(?<=\().*?(?=\))')
+          if [[ ! -f "docs/$img" ]]; then
+            echo "Missing image: $img in $line"
+          fi
+        done
+  
+  triggers:
+    - event: wiki.page.created
+      action: validate_and_enhance
+    - event: wiki.page.updated
+      action: check_and_fix
+    - event: schedule.daily
+      action: comprehensive_audit
+  
+  healing_rules:
+    - name: fix-broken-links
+      condition: broken_links_detected
+      actions:
+        - update_links_to_latest
+        - create_redirects
+        - notify_page_owners
+    
+    - name: fix-orphaned-pages
+      condition: orphaned_pages_found
+      actions:
+        - add_to_index
+        - suggest_parent_pages
+        - create_category_links
+    
+    - name: fix-formatting
+      condition: markdown_errors_detected
+      actions:
+        - auto_format
+        - fix_heading_hierarchy
+        - standardize_code_blocks
+    
+    - name: update-stale-content
+      condition: page_not_updated_90_days
+      actions:
+        - flag_for_review
+        - notify_maintainers
+        - add_stale_warning
+  
+  observability:
+    metrics:
+      - name: pages_healed
+        type: counter
+      - name: broken_links_fixed
+        type: counter
+      - name: orphaned_pages_linked
+        type: counter
+      - name: healing_duration_ms
+        type: histogram
+    
+    activity_stream:
+      enabled: true
+      track:
+        - healing.started
+        - healing.completed
+        - issue.detected
+        - issue.fixed

package/examples/agents-md/code-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.9",
+  "apiVersion": "ossa/v0.3.0",
   "kind": "Agent",
   "metadata": {
     "name": "code-assistant",

package/examples/agents-md/monorepo-agent.ossa.yaml

@@ -1,6 +1,6 @@
 # OSSA Agent Manifest with agents.md Extension
 # Demonstrates monorepo support with nested AGENTS.md files
-apiVersion: ossa/v0.2.9
+apiVersion: ossa/v0.3.0
 kind: Agent
 metadata:
   name: monorepo-assistant

package/examples/anthropic/claude-assistant.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.9",
+  "apiVersion": "ossa/v0.3.0",
   "kind": "Agent",
   "metadata": {
     "name": "claude-assistant",

package/examples/anthropic-adapter-example.ts

@@ -0,0 +1,374 @@
+/**
+ * Anthropic Adapter Usage Example
+ * Demonstrates how to use the AnthropicAdapter with OSSA manifests
+ */
+
+import { AnthropicAdapter } from '../src/services/runtime/anthropic.adapter.js';
+import type { OssaManifest } from '../src/services/runtime/anthropic.adapter.js';
+
+// Example 1: Basic Chat Agent (No Tools)
+async function basicChatExample() {
+  console.log('\n=== Basic Chat Example ===\n');
+
+  const manifest: OssaManifest = {
+    apiVersion: 'ossa/v0.3.0',
+    kind: 'Agent',
+    metadata: {
+      name: 'basic-chat-agent',
+      version: '1.0.0',
+      description: 'A simple conversational agent',
+    },
+    spec: {
+      role: 'You are a helpful AI assistant that provides clear and concise answers.',
+      llm: {
+        provider: 'anthropic',
+        model: 'claude-3-5-sonnet-20241022',
+        temperature: 0.7,
+        maxTokens: 1024,
+      },
+    },
+  };
+
+  const adapter = new AnthropicAdapter(manifest);
+  adapter.initialize();
+
+  const response = await adapter.chat('What are the three laws of robotics?', {
+    verbose: true,
+  });
+
+  console.log('\nResponse:', response);
+  console.log('\nAgent Info:', adapter.getAgentInfo());
+}
+
+// Example 2: Agent with Tools
+async function toolCallingExample() {
+  console.log('\n=== Tool Calling Example ===\n');
+
+  const manifest: OssaManifest = {
+    apiVersion: 'ossa/v0.3.0',
+    kind: 'Agent',
+    metadata: {
+      name: 'weather-agent',
+      version: '1.0.0',
+      description: 'Weather information agent',
+    },
+    spec: {
+      role: 'You are a helpful weather assistant. Use the get_weather tool to provide current weather information.',
+      llm: {
+        provider: 'anthropic',
+        model: 'claude-3-5-sonnet-20241022',
+        temperature: 0.5,
+        maxTokens: 2048,
+      },
+    },
+    extensions: {
+      anthropic: {
+        tools: [
+          {
+            name: 'get_weather',
+            description: 'Get the current weather for a given location',
+            input_schema: {
+              type: 'object',
+              properties: {
+                location: {
+                  type: 'string',
+                  description: 'The city and state, e.g. San Francisco, CA',
+                },
+                unit: {
+                  type: 'string',
+                  enum: ['celsius', 'fahrenheit'],
+                  description: 'The temperature unit',
+                },
+              },
+              required: ['location'],
+            },
+          },
+          {
+            name: 'get_forecast',
+            description: 'Get the weather forecast for the next few days',
+            input_schema: {
+              type: 'object',
+              properties: {
+                location: {
+                  type: 'string',
+                  description: 'The city and state, e.g. San Francisco, CA',
+                },
+                days: {
+                  type: 'number',
+                  description: 'Number of days to forecast (1-7)',
+                },
+              },
+              required: ['location', 'days'],
+            },
+          },
+        ],
+      },
+    },
+  };
+
+  const adapter = new AnthropicAdapter(manifest);
+  adapter.initialize();
+
+  // Register tool handlers
+  adapter.registerToolHandler('get_weather', async (args) => {
+    const location = args.location as string;
+    const unit = (args.unit as string) || 'fahrenheit';
+
+    // Simulate API call
+    return JSON.stringify({
+      location,
+      temperature: unit === 'celsius' ? 22 : 72,
+      unit,
+      conditions: 'Partly cloudy',
+      humidity: 65,
+      wind_speed: 10,
+    });
+  });
+
+  adapter.registerToolHandler('get_forecast', async (args) => {
+    const location = args.location as string;
+    const days = args.days as number;
+
+    // Simulate API call
+    const forecast = Array.from({ length: days }, (_, i) => ({
+      day: i + 1,
+      high: 75 + i,
+      low: 55 + i,
+      conditions: i % 2 === 0 ? 'Sunny' : 'Partly cloudy',
+    }));
+
+    return JSON.stringify({
+      location,
+      forecast,
+    });
+  });
+
+  const response = await adapter.chat(
+    "What's the weather like in San Francisco, and what's the forecast for the next 3 days?",
+    {
+      verbose: true,
+      maxTurns: 5,
+    }
+  );
+
+  console.log('\nFinal Response:', response);
+}
+
+// Example 3: Streaming Response
+async function streamingExample() {
+  console.log('\n=== Streaming Example ===\n');
+
+  const manifest: OssaManifest = {
+    apiVersion: 'ossa/v0.3.0',
+    kind: 'Agent',
+    metadata: {
+      name: 'streaming-agent',
+      version: '1.0.0',
+    },
+    spec: {
+      role: 'You are a helpful AI assistant. Provide detailed, thoughtful responses.',
+    },
+    extensions: {
+      anthropic: {
+        model: 'claude-3-5-sonnet-20241022',
+        max_tokens: 1024,
+        temperature: 0.7,
+      },
+    },
+  };
+
+  const adapter = new AnthropicAdapter(manifest);
+  adapter.initialize();
+
+  console.log('User: Explain how neural networks work in simple terms.\n');
+  console.log('Assistant: ');
+
+  const stream = adapter.chatStream(
+    'Explain how neural networks work in simple terms.'
+  );
+
+  for await (const chunk of stream) {
+    process.stdout.write(chunk);
+  }
+
+  console.log('\n');
+}
+
+// Example 4: Multi-turn Conversation
+async function conversationExample() {
+  console.log('\n=== Multi-turn Conversation Example ===\n');
+
+  const manifest: OssaManifest = {
+    apiVersion: 'ossa/v0.3.0',
+    kind: 'Agent',
+    metadata: {
+      name: 'conversation-agent',
+      version: '1.0.0',
+    },
+    spec: {
+      role: 'You are a knowledgeable AI tutor. Help students learn by asking questions and providing explanations.',
+      llm: {
+        provider: 'anthropic',
+        model: 'claude-3-haiku-20250320', // Using Haiku for faster responses
+        temperature: 0.8,
+        maxTokens: 512,
+      },
+    },
+  };
+
+  const adapter = new AnthropicAdapter(manifest);
+  adapter.initialize();
+
+  const questions = [
+    "What is the Pythagorean theorem?",
+    "Can you give me an example?",
+    "How is it used in real life?",
+  ];
+
+  for (const question of questions) {
+    console.log(`\nUser: ${question}`);
+    const response = await adapter.chat(question);
+    console.log(`Assistant: ${response}`);
+  }
+
+  console.log('\nConversation History:');
+  console.log(JSON.stringify(adapter.getConversationHistory(), null, 2));
+}
+
+// Example 5: Using Different Claude Models
+async function modelComparisonExample() {
+  console.log('\n=== Model Comparison Example ===\n');
+
+  const models = [
+    { name: 'Claude 3.5 Sonnet', id: 'claude-3-5-sonnet-20241022' },
+    { name: 'Claude 3 Opus', id: 'claude-3-opus-20240229' },
+    { name: 'Claude 3 Haiku', id: 'claude-3-haiku-20250320' },
+  ];
+
+  const prompt = 'Write a haiku about artificial intelligence.';
+
+  for (const model of models) {
+    console.log(`\n--- ${model.name} ---`);
+
+    const manifest: OssaManifest = {
+      apiVersion: 'ossa/v0.3.0',
+      kind: 'Agent',
+      metadata: {
+        name: `${model.id}-agent`,
+        version: '1.0.0',
+      },
+      spec: {
+        role: 'You are a creative poet.',
+      },
+      extensions: {
+        anthropic: {
+          model: model.id,
+          max_tokens: 256,
+          temperature: 0.9,
+        },
+      },
+    };
+
+    const adapter = new AnthropicAdapter(manifest);
+    adapter.initialize();
+
+    const response = await adapter.chat(prompt);
+    console.log(response);
+  }
+}
+
+// Example 6: Error Handling
+async function errorHandlingExample() {
+  console.log('\n=== Error Handling Example ===\n');
+
+  const manifest: OssaManifest = {
+    apiVersion: 'ossa/v0.3.0',
+    kind: 'Agent',
+    metadata: {
+      name: 'error-demo-agent',
+      version: '1.0.0',
+    },
+    spec: {
+      role: 'You are a helpful assistant.',
+    },
+    extensions: {
+      anthropic: {
+        tools: [
+          {
+            name: 'risky_operation',
+            description: 'An operation that might fail',
+            input_schema: {
+              type: 'object',
+              properties: {
+                action: {
+                  type: 'string',
+                  description: 'The action to perform',
+                },
+              },
+              required: ['action'],
+            },
+          },
+        ],
+      },
+    },
+  };
+
+  const adapter = new AnthropicAdapter(manifest);
+  adapter.initialize();
+
+  // Register a tool that throws an error
+  adapter.registerToolHandler('risky_operation', async (args) => {
+    if (args.action === 'fail') {
+      throw new Error('Operation failed intentionally');
+    }
+    return JSON.stringify({ success: true, action: args.action });
+  });
+
+  try {
+    const response = await adapter.chat(
+      'Please perform a risky operation with action "fail"',
+      { verbose: true }
+    );
+    console.log('\nResponse:', response);
+  } catch (error) {
+    console.error('\nCaught error:', error);
+  }
+}
+
+// Run examples
+async function main() {
+  // Check if API key is set
+  if (!process.env.ANTHROPIC_API_KEY) {
+    console.error('Error: ANTHROPIC_API_KEY environment variable not set');
+    console.log('\nPlease set your API key:');
+    console.log('  export ANTHROPIC_API_KEY=your-key-here');
+    process.exit(1);
+  }
+
+  try {
+    // Run examples (comment out any you don't want to run)
+    await basicChatExample();
+    // await toolCallingExample();
+    // await streamingExample();
+    // await conversationExample();
+    // await modelComparisonExample();
+    // await errorHandlingExample();
+  } catch (error) {
+    console.error('Error running examples:', error);
+    process.exit(1);
+  }
+}
+
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}
+
+export {
+  basicChatExample,
+  toolCallingExample,
+  streamingExample,
+  conversationExample,
+  modelComparisonExample,
+  errorHandlingExample,
+};

package/examples/anthropic-simple.ts

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * Simple Anthropic Adapter Example
+ * Demonstrates the absolute minimum needed to use the adapter
+ */
+
+import { AnthropicAdapter } from '../src/services/runtime/anthropic.adapter.js';
+
+async function main() {
+  // Check API key
+  if (!process.env.ANTHROPIC_API_KEY) {
+    console.error('Error: ANTHROPIC_API_KEY environment variable not set');
+    console.log('\nSet it with:');
+    console.log('  export ANTHROPIC_API_KEY=your-key-here');
+    process.exit(1);
+  }
+
+  // Create manifest
+  const manifest = {
+    apiVersion: 'ossa/v0.3.0',
+    kind: 'Agent',
+    metadata: {
+      name: 'simple-assistant',
+      version: '1.0.0',
+    },
+    spec: {
+      role: 'You are a helpful AI assistant.',
+    },
+  };
+
+  // Create adapter
+  console.log('Creating Anthropic adapter...');
+  const adapter = new AnthropicAdapter(manifest);
+
+  // Show agent info
+  const info = adapter.getAgentInfo();
+  console.log('\nAgent Info:');
+  console.log(`  Name: ${info.name}`);
+  console.log(`  Model: ${info.model}`);
+  console.log(`  Provider: ${info.provider}`);
+  console.log(`  Tools: ${info.tools.length}`);
+
+  // Initialize
+  adapter.initialize();
+
+  // Simple chat
+  console.log('\n--- Chat Example ---');
+  console.log('User: Hello, who are you?');
+
+  const response1 = await adapter.chat('Hello, who are you?');
+  console.log(`Assistant: ${response1}`);
+
+  // Follow-up (conversation history maintained)
+  console.log('\nUser: What can you help me with?');
+
+  const response2 = await adapter.chat('What can you help me with?');
+  console.log(`Assistant: ${response2}`);
+
+  // Show conversation history
+  console.log('\n--- Conversation History ---');
+  const history = adapter.getConversationHistory();
+  console.log(`Total messages: ${history.length}`);
+
+  console.log('\n✅ Done!');
+}
+
+main().catch((error) => {
+  console.error('Error:', error.message);
+  process.exit(1);
+});

package/examples/autogen/multi-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.9",
+  "apiVersion": "ossa/v0.3.0",
   "kind": "Agent",
   "metadata": {
     "name": "autogen-assistant",

package/examples/autonomous-evolution/self-evolving-agent.ossa.yaml

@@ -0,0 +1,37 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: self-evolving-agent
+  version: 1.0.0
+  description: Example demonstrating OSSA v0.3.0 features
+  lifecycle:
+    state: active
+    maturity: beta
+spec:
+  role: Example agent with lifecycle, environments, and dependencies
+  llm:
+    provider: anthropic
+    model: claude-3-5-sonnet-20241022
+  dependencies:
+    agents:
+      - name: "@ossa/research-agent"
+        version: ">=1.0.0"
+  environments:
+    staging:
+      version: "1.0.0-rc1"
+      deployedAt: "2025-12-01T00:00:00Z"
+      status: healthy
+    production:
+      version: "1.0.0"
+      deployedAt: "2025-12-15T00:00:00Z"
+      status: healthy
+  tests:
+    - id: test-metadata
+      type: unit
+      assertions:
+        - type: equals
+          actual: "metadata.name"
+          expected: "self-evolving-agent"
+extensions:
+  anthropic:
+    model: claude-3-5-sonnet-20241022