@bluefly/openstandardagents 0.2.4

package/examples/agent-manifests/workers/worker-agent.yaml

@@ -0,0 +1,82 @@
+apiVersion: ossa.io/v0.1.9
+kind: Agent
+metadata:
+  name: data-processing-worker
+  version: v1.2.0
+  description: 'High-performance worker agent for distributed data processing tasks'
+  author: 'data-engineering-team'
+  labels:
+    environment: production
+    classification: internal
+    role: worker
+    complexity: standard
+spec:
+  type: worker
+  subtype: data-processor
+  capabilities:
+    domains:
+      - data-processing
+      - stream-analytics
+      - batch-processing
+      - file-operations
+      - database-operations
+    operations:
+      - process-records
+      - transform-data
+      - validate-input
+      - generate-output
+      - handle-errors
+      - report-progress
+    patterns:
+      - pipeline-processing
+      - error-recovery
+      - checkpoint-resume
+      - rate-limiting
+      - batching
+  protocols:
+    supported:
+      - name: rest
+        version: '1.1'
+        endpoint: 'https://worker.platform.com/api/v1'
+        authentication:
+          type: bearer-token
+          scopes: ['worker.execute', 'data.read', 'data.write']
+        tls: true
+      - name: message-queue
+        version: '1.0'
+        endpoint: 'amqp://queue.platform.com:5672/workers'
+        authentication:
+          type: sasl
+      - name: grpc
+        version: '1.0'
+        endpoint: 'grpc://worker.platform.com:9090/DataProcessor'
+        authentication:
+          type: mutual-tls
+  processing:
+    maxConcurrentTasks: 10
+    maxMemoryUsage: '2Gi'
+    maxCpuUsage: '1000m'
+    timeout: 300000
+    retryPolicy:
+      maxAttempts: 3
+      backoffStrategy: exponential
+      baseDelay: 1000
+    errorHandling:
+      strategy: dead-letter-queue
+      maxFailures: 5
+  performance:
+    throughput:
+      recordsPerSecond: 1000
+      maxBatchSize: 100
+    latency:
+      processingTime: 50
+      p95: 200
+      p99: 500
+  monitoring:
+    healthChecks: true
+    performanceMetrics: true
+    errorTracking: true
+    alerting:
+      errorThreshold: 5
+      latencyThreshold: 1000
+      memoryThreshold: 80

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

@@ -0,0 +1,45 @@
+{
+  "apiVersion": "ossa/v0.2.3",
+  "kind": "Agent",
+  "metadata": {
+    "name": "claude-assistant",
+    "version": "1.0.0",
+    "description": "Anthropic Claude API assistant agent"
+  },
+  "spec": {
+    "role": "You are a helpful, harmless, and honest AI assistant.",
+    "llm": {
+      "provider": "anthropic",
+      "model": "claude-3-5-sonnet-20241022",
+      "temperature": 1.0
+    },
+    "tools": []
+  },
+  "extensions": {
+    "anthropic": {
+      "enabled": true,
+      "model": "claude-3-5-sonnet-20241022",
+      "system": "You are a helpful, harmless, and honest AI assistant.",
+      "max_tokens": 4096,
+      "temperature": 1.0,
+      "tools": [
+        {
+          "name": "calculator",
+          "description": "Perform mathematical calculations",
+          "input_schema": {
+            "type": "object",
+            "properties": {
+              "expression": {
+                "type": "string",
+                "description": "Mathematical expression to evaluate"
+              }
+            },
+            "required": ["expression"]
+          }
+        }
+      ],
+      "streaming": false
+    }
+  }
+}
+

package/examples/architecture/model-configuration/ollama-integration.ts

@@ -0,0 +1,110 @@
+#!/usr/bin/env ts-node
+/**
+ * Example of OSSA LLM Agent using Ollama for free local inference
+ * Run: npx ts-node examples/ollama-integration.ts
+ */
+
+import { OSSALlmAgent } from '../dist/adk/agents/llm-agent.js';
+import { ADKAgentConfig } from '../dist/adk/agents/index.js';
+
+// Load environment variables
+import * as dotenv from 'dotenv';
+dotenv.config();
+
+async function demonstrateOllamaIntegration() {
+  console.log('🤖 OSSA + Ollama Integration Demo');
+  console.log('===================================');
+
+  // Create agent configuration
+  const agentConfig: ADKAgentConfig = {
+    name: 'OllamaTestAgent',
+    instruction:
+      'You are a helpful AI assistant. Provide clear, concise answers.',
+    tools: [],
+  };
+
+  // Create LLM agent
+  const agent = new OSSALlmAgent(agentConfig);
+
+  console.log(
+    `Using Ollama model: ${process.env.OLLAMA_MODEL || 'gpt-oss:20b'}`
+  );
+  console.log(
+    `Ollama URL: ${process.env.OLLAMA_BASE_URL || 'http://localhost:11434'}`
+  );
+
+  // Test cases
+  const testCases = [
+    {
+      name: 'Basic Greeting',
+      input: 'Hello! Can you introduce yourself?',
+    },
+    {
+      name: 'Code Question',
+      input: 'Explain what TypeScript interfaces are in one sentence.',
+    },
+    {
+      name: 'OSSA Question',
+      input: 'What is OSSA and why is it useful for AI agents?',
+    },
+  ];
+
+  for (const testCase of testCases) {
+    console.log(`\n📝 Test: ${testCase.name}`);
+    console.log(`Input: ${testCase.input}`);
+    console.log('---');
+
+    try {
+      const startTime = Date.now();
+      const result = await agent.invoke({ question: testCase.input });
+      const duration = Date.now() - startTime;
+
+      if (result.success) {
+        console.log(`✅ Response (${duration}ms):`);
+        console.log(result.output);
+        if (result.thinking) {
+          console.log(`🧠 Model thinking: ${result.thinking}`);
+        }
+        console.log(`🏷️  Model: ${result.model}`);
+      } else {
+        console.log(`❌ Error: ${result.error}`);
+      }
+    } catch (error) {
+      console.log(`💥 Exception: ${error}`);
+    }
+  }
+
+  console.log(
+    '\n🎉 Demo completed! You are now using free local AI with OSSA + Ollama'
+  );
+}
+
+// Check if Ollama is running
+async function checkOllamaConnection(): Promise<boolean> {
+  try {
+    const baseUrl = process.env.OLLAMA_BASE_URL || 'http://localhost:11434';
+    const response = await fetch(`${baseUrl}/api/tags`);
+    return response.ok;
+  } catch (error) {
+    return false;
+  }
+}
+
+// Main execution
+async function main() {
+  // Check Ollama connection first
+  const isOllamaRunning = await checkOllamaConnection();
+
+  if (!isOllamaRunning) {
+    console.log('❌ Ollama is not running or not accessible');
+    console.log('Please start Ollama with: ollama serve');
+    console.log('Then run this demo again.');
+    process.exit(1);
+  }
+
+  await demonstrateOllamaIntegration();
+}
+
+if (require.main === module) {
+  main().catch(console.error);
+}

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

@@ -0,0 +1,37 @@
+{
+  "apiVersion": "ossa/v0.2.3",
+  "kind": "Agent",
+  "metadata": {
+    "name": "autogen-assistant",
+    "version": "1.0.0",
+    "description": "AutoGen multi-agent assistant"
+  },
+  "spec": {
+    "role": "You are an AI assistant that can collaborate with other agents to solve complex problems.",
+    "llm": {
+      "provider": "openai",
+      "model": "gpt-4",
+      "temperature": 0.7
+    },
+    "tools": []
+  },
+  "extensions": {
+    "autogen": {
+      "enabled": true,
+      "agent_type": "assistant",
+      "system_message": "You are an AI assistant that can collaborate with other agents to solve complex problems.",
+      "human_input_mode": "NEVER",
+      "code_execution": {
+        "enabled": true,
+        "work_dir": "/tmp/autogen",
+        "use_docker": false
+      },
+      "max_consecutive_auto_reply": 10,
+      "groupchat": {
+        "agents": ["user_proxy", "assistant"],
+        "max_round": 20
+      }
+    }
+  }
+}
+

package/examples/bridge-configurations.yaml

@@ -0,0 +1,346 @@
+# OSSA Bridge Configuration Examples
+# Demonstrates how to configure various protocol bridges for agent interoperability
+
+---
+# Example 1: MCP Bridge with stdio transport (Claude Desktop integration)
+ossaVersion: '1.0'
+agent:
+  id: mcp-stdio-agent
+  name: 'Claude Desktop MCP Agent'
+  version: '1.0.0'
+  description: 'Agent exposed as MCP tool server for Claude Desktop'
+  role: custom
+  tags: ['mcp', 'claude-desktop', 'local']
+
+  runtime:
+    type: local
+    command: ['node', 'dist/agent.js']
+    resources:
+      cpu: '500m'
+      memory: '512Mi'
+
+  capabilities:
+    - name: analyze_code
+      description: 'Analyze source code for issues'
+      input_schema:
+        type: object
+        properties:
+          code:
+            type: string
+          language:
+            type: string
+            enum: ['typescript', 'javascript', 'python']
+        required: ['code', 'language']
+      output_schema:
+        type: object
+        properties:
+          issues:
+            type: array
+            items:
+              type: object
+
+  bridge:
+    mcp:
+      enabled: true
+      server_type: stdio
+      tools:
+        - name: analyze_code
+          description: 'Analyze source code for issues'
+          capability: analyze_code
+          input_schema:
+            type: object
+            properties:
+              code: { type: string }
+              language: { type: string }
+            required: ['code', 'language']
+
+      resources:
+        - uri: 'ossa://code-analysis'
+          name: 'Code Analysis Results'
+          description: 'Access to code analysis results'
+          mimeType: 'application/json'
+          readonly: true
+
+      prompts:
+        - name: review_pr
+          description: 'Review a pull request'
+          template: "Review the following {{language}} code changes:\n{{diff}}"
+          arguments:
+            - name: language
+              type: string
+              required: true
+            - name: diff
+              type: string
+              required: true
+
+      config:
+        max_message_size: 1048576
+        timeout_ms: 30000
+        retry_count: 3
+
+---
+# Example 2: Multi-Bridge Agent (MCP + OpenAPI + LangChain)
+ossaVersion: '1.0'
+agent:
+  id: multi-bridge-orchestrator
+  name: 'Multi-Protocol Orchestrator'
+  version: '1.0.0'
+  description: 'Agent supporting multiple bridge protocols simultaneously'
+  role: orchestration
+  tags: ['multi-protocol', 'orchestrator', 'integration']
+
+  runtime:
+    type: docker
+    image: 'ossa/multi-bridge:latest'
+    resources:
+      cpu: '1'
+      memory: '1Gi'
+
+  capabilities:
+    - name: execute_workflow
+      description: 'Execute multi-step workflow'
+      input_schema:
+        type: object
+        properties:
+          workflow_id: { type: string }
+          steps: { type: array }
+
+  bridge:
+    # MCP Bridge for AI assistant integration
+    mcp:
+      enabled: true
+      server_type: websocket
+      tools:
+        - name: execute_workflow
+          description: 'Execute a workflow'
+          capability: execute_workflow
+
+    # OpenAPI Bridge for REST API access
+    openapi:
+      enabled: true
+      spec_url: 'https://api.example.com/openapi.json'
+      spec_version: '3.1'
+      auto_generate: false
+      servers:
+        - url: 'https://api.example.com'
+          description: 'Production API'
+
+    # LangChain Bridge for Python integration
+    langchain:
+      enabled: true
+      tool_class: 'OSSAWorkflowTool'
+      chain_type: agent
+      memory:
+        type: conversation
+        max_tokens: 4096
+      export:
+        as_tool: true
+        as_chain: true
+        as_agent: false
+
+---
+# Example 3: CrewAI Integration
+ossaVersion: '1.0'
+agent:
+  id: crewai-researcher
+  name: 'Research Agent'
+  version: '1.0.0'
+  description: 'Agent configured for CrewAI framework'
+  role: custom
+  tags: ['crewai', 'research', 'analyst']
+
+  runtime:
+    type: docker
+    image: 'ossa/crewai-agent:latest'
+
+  capabilities:
+    - name: research_topic
+      description: 'Research a topic and provide insights'
+
+  bridge:
+    crewai:
+      enabled: true
+      agent_type: researcher
+      role: 'Senior Research Analyst'
+      goal: 'Conduct thorough research and provide actionable insights'
+      backstory: 'Expert researcher with 10+ years of experience in data analysis'
+      tools: ['web_search', 'document_reader', 'data_analyzer']
+      llm:
+        model: 'gpt-4'
+        temperature: 0.7
+      max_iter: 15
+      allow_delegation: true
+
+---
+# Example 4: AutoGen Group Chat Agent
+ossaVersion: '1.0'
+agent:
+  id: autogen-assistant
+  name: 'AutoGen Assistant'
+  version: '1.0.0'
+  description: 'Agent for AutoGen multi-agent conversations'
+  role: chat
+  tags: ['autogen', 'assistant', 'conversation']
+
+  runtime:
+    type: local
+    command: ['python', 'agent.py']
+
+  capabilities:
+    - name: code_generation
+      description: 'Generate code based on requirements'
+    - name: code_execution
+      description: 'Execute and test code'
+
+  bridge:
+    autogen:
+      enabled: true
+      agent_type: assistant
+      system_message: 'You are a helpful AI assistant specializing in code generation and testing.'
+      human_input_mode: TERMINATE
+      code_execution:
+        enabled: true
+        work_dir: '/tmp/autogen'
+        use_docker: true
+      llm_config:
+        model: 'gpt-4'
+        temperature: 0.7
+        max_tokens: 4096
+        functions:
+          - name: generate_code
+            description: 'Generate code'
+          - name: execute_code
+            description: 'Execute code'
+      max_consecutive_auto_reply: 10
+
+---
+# Example 5: Agent-to-Agent (A2A) Protocol
+ossaVersion: '1.0'
+agent:
+  id: a2a-discovery-agent
+  name: 'Discovery Agent'
+  version: '1.0.0'
+  description: 'Agent supporting A2A protocol for discovery'
+  role: custom
+  tags: ['a2a', 'discovery', 'coordination']
+
+  runtime:
+    type: k8s
+    image: 'ossa/a2a-agent:latest'
+
+  capabilities:
+    - name: discover_agents
+      description: 'Discover other agents in the network'
+    - name: coordinate_task
+      description: 'Coordinate task execution across agents'
+
+  bridge:
+    a2a:
+      enabled: true
+      card_url: 'https://agents.example.com/cards/discovery-agent'
+      schema_version: '1.0'
+      capabilities_mapping:
+        discover_agents: 'agent.discovery'
+        coordinate_task: 'task.coordination'
+      metadata:
+        '@context': 'https://a2a-protocol.org/context'
+        '@type': 'DiscoveryAgent'
+
+---
+# Example 6: Custom Bridge Implementation
+ossaVersion: '1.0'
+agent:
+  id: custom-bridge-agent
+  name: 'Custom Bridge Agent'
+  version: '1.0.0'
+  description: 'Agent with custom bridge protocol'
+  role: integration
+  tags: ['custom', 'integration']
+
+  runtime:
+    type: docker
+    image: 'ossa/custom-bridge:latest'
+
+  capabilities:
+    - name: custom_operation
+      description: 'Custom operation'
+
+  bridge:
+    # Standard MCP bridge
+    mcp:
+      enabled: true
+      server_type: websocket
+
+    # Custom bridge configuration
+    custom:
+      my_custom_protocol:
+        enabled: true
+        endpoint: 'wss://custom.protocol.io'
+        auth:
+          type: 'api_key'
+          key_env_var: 'CUSTOM_API_KEY'
+        features:
+          - streaming
+          - bidirectional
+          - binary_data
+        config:
+          max_connections: 100
+          heartbeat_interval_ms: 30000
+
+---
+# Example 7: MCP Bridge with SSE Transport (Web Integration)
+ossaVersion: '1.0'
+agent:
+  id: mcp-sse-agent
+  name: 'Web MCP Agent'
+  version: '1.0.0'
+  description: 'Agent exposed via Server-Sent Events for web apps'
+  role: custom
+  tags: ['mcp', 'sse', 'web']
+
+  runtime:
+    type: docker
+    image: 'ossa/mcp-sse:latest'
+    resources:
+      cpu: '500m'
+      memory: '512Mi'
+
+  integration:
+    protocol: http
+    endpoints:
+      base_url: 'https://agent.example.com'
+      health: '/health'
+      metrics: '/metrics'
+
+  capabilities:
+    - name: chat
+      description: 'Chat with the agent'
+    - name: file_analysis
+      description: 'Analyze uploaded files'
+
+  bridge:
+    mcp:
+      enabled: true
+      server_type: sse
+      tools:
+        - name: chat
+          description: 'Chat with the agent'
+          capability: chat
+        - name: analyze_file
+          description: 'Analyze a file'
+          capability: file_analysis
+
+      resources:
+        - uri: 'ossa://conversations'
+          name: 'Conversation History'
+          mimeType: 'application/json'
+          readonly: false
+        - uri: 'ossa://files'
+          name: 'Uploaded Files'
+          mimeType: 'application/octet-stream'
+          readonly: false
+
+      config:
+        max_message_size: 5242880 # 5MB
+        timeout_ms: 60000
+        retry_count: 5

package/examples/bridges/Dockerfile.production

@@ -0,0 +1,87 @@
+# Production Multi-Stage Dockerfile for AIFlow Agent
+# Optimized for size, security, and performance
+
+#===========================================
+# Stage 1: Base Dependencies
+#===========================================
+FROM python:3.11-slim as base
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create non-root user
+RUN groupadd -r aiflow && useradd -r -g aiflow -u 1000 aiflow
+
+# Set working directory
+WORKDIR /app
+
+#===========================================
+# Stage 2: Dependencies Builder
+#===========================================
+FROM base as builder
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    g++ \
+    make \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir --prefix=/install -r requirements.txt
+
+#===========================================
+# Stage 3: Production Runtime
+#===========================================
+FROM base as production
+
+# Copy installed dependencies from builder
+COPY --from=builder /install /usr/local
+
+# Copy application code
+COPY aiflow-bridge-enhanced.py /app/
+COPY aiflow-phoenix-tracing.py /app/
+
+# Copy character configuration
+COPY characters/ /app/characters/
+
+# Change ownership to non-root user
+RUN chown -R aiflow:aiflow /app
+
+# Switch to non-root user
+USER aiflow
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# Environment variables
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# Run the application
+CMD ["python", "-u", "aiflow-bridge-enhanced.py"]
+
+# Metadata
+LABEL org.opencontainers.image.title="AIFlow Social Agent" \
+      org.opencontainers.image.description="Personality-driven social AI agent with BuildKit registration" \
+      org.opencontainers.image.version="1.0.0" \
+      org.opencontainers.image.vendor="OSSA Community" \
+      org.opencontainers.image.source="https://gitlab.bluefly.io/llm/openapi-ai-agents-standard" \
+      ossa.compliant="true" \
+      ossa.version="1.0" \
+      agent.framework="aiflow" \
+      agent.role="chat"
+