@bluefly/openstandardagents 0.5.0 → 0.5.3

package/examples/bridge-configurations.yaml

@@ -1,346 +0,0 @@
-# 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/.gitlab-ci.yml

@@ -1,293 +0,0 @@
-# GitLab CI/CD Pipeline for AIFlow Social Agent
-# Follows production architecture: Build → Test → Deploy
-
-stages:
-  - validate
-  - build
-  - test
-  - deploy
-  - monitor
-
-variables:
-  DOCKER_REGISTRY: registry.bluefly.io
-  IMAGE_NAME: $DOCKER_REGISTRY/llm/aiflow-social-agent
-  KUBERNETES_NAMESPACE: agents
-  HELM_RELEASE_NAME: aiflow-social-agent
-
-# Global rules
-workflow:
-  rules:
-    - if: $CI_COMMIT_BRANCH == "main"
-    - if: $CI_COMMIT_BRANCH == "development"
-    - if: $CI_MERGE_REQUEST_IID
-    - if: $CI_COMMIT_TAG
-
-#===========================================
-# Stage 1: Validation
-#===========================================
-
-validate:openapi:
-  stage: validate
-  image: stoplight/spectral:latest
-  script:
-    - spectral lint aiflow-registration-api.openapi.yml --ruleset ../../config/linting/.spectral.yaml
-  only:
-    - merge_requests
-    - main
-    - development
-
-validate:python:
-  stage: validate
-  image: python:3.11-slim
-  before_script:
-    - pip install --no-cache-dir black flake8 mypy
-  script:
-    - black --check *.py
-    - flake8 *.py --max-line-length=120
-    - mypy *.py --ignore-missing-imports
-  only:
-    - merge_requests
-    - main
-    - development
-
-validate:ossa:
-  stage: validate
-  image: node:20-alpine
-  before_script:
-    - npm install -g @llm/ossa-cli
-  script:
-    - ossa validate ../social-agent-aiflow.ossa.yaml
-  only:
-    - merge_requests
-    - main
-    - development
-
-#===========================================
-# Stage 2: Build
-#===========================================
-
-build:docker:
-  stage: build
-  image: docker:27-dind
-  services:
-    - docker:27-dind
-  before_script:
-    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $DOCKER_REGISTRY
-  script:
-    # Build multi-stage production image
-    - |
-      docker build \
-        -f Dockerfile.production \
-        -t $IMAGE_NAME:$CI_COMMIT_SHORT_SHA \
-        -t $IMAGE_NAME:latest \
-        --label "git.commit=$CI_COMMIT_SHORT_SHA" \
-        --label "git.branch=$CI_COMMIT_BRANCH" \
-        --label "pipeline.id=$CI_PIPELINE_ID" \
-        --label "ossa.version=1.0" \
-        .
-    
-    # Scan for vulnerabilities
-    - docker run --rm -v /var/run/docker.sock:/var/run/docker.sock aquasec/trivy image --severity HIGH,CRITICAL $IMAGE_NAME:$CI_COMMIT_SHORT_SHA
-    
-    # Push images
-    - docker push $IMAGE_NAME:$CI_COMMIT_SHORT_SHA
-    - docker push $IMAGE_NAME:latest
-  only:
-    - main
-    - development
-  tags:
-    - docker
-
-#===========================================
-# Stage 3: Test
-#===========================================
-
-test:unit:
-  stage: test
-  image: python:3.11-slim
-  before_script:
-    - pip install --no-cache-dir -r requirements.txt
-    - pip install --no-cache-dir pytest pytest-asyncio pytest-cov
-  script:
-    - pytest test_aiflow_integration.py -v --cov=. --cov-report=xml --cov-report=html
-  coverage: '/^TOTAL.*\s+(\d+\%)$/'
-  artifacts:
-    reports:
-      coverage_report:
-        coverage_format: cobertura
-        path: coverage.xml
-    paths:
-      - htmlcov/
-    expire_in: 1 week
-  only:
-    - merge_requests
-    - main
-    - development
-
-test:integration:
-  stage: test
-  image: $IMAGE_NAME:$CI_COMMIT_SHORT_SHA
-  services:
-    - name: redis:7-alpine
-      alias: redis
-  variables:
-    BUILDKIT_REGISTRY_URL: http://mock-buildkit:3000
-    PHOENIX_ENDPOINT: http://mock-phoenix:4318
-  script:
-    - python -m pytest test_aiflow_integration.py -v -k "integration"
-  only:
-    - main
-    - development
-
-test:load:
-  stage: test
-  image: grafana/k6:latest
-  script:
-    - k6 run --vus 10 --duration 2m loadtest/k6-scenarios.js
-  artifacts:
-    reports:
-      junit: k6-results.xml
-  only:
-    - main
-  when: manual
-  allow_failure: true
-
-#===========================================
-# Stage 4: Deploy
-#===========================================
-
-deploy:development:
-  stage: deploy
-  image: bitnami/kubectl:latest
-  environment:
-    name: development
-    url: https://aiflow-dev.agent-buildkit.orb.local
-    kubernetes:
-      namespace: agents-dev
-  before_script:
-    - kubectl config use-context $KUBE_CONTEXT_DEV
-  script:
-    # Update image in deployment
-    - |
-      kubectl set image deployment/aiflow-social-agent \
-        aiflow-agent=$IMAGE_NAME:$CI_COMMIT_SHORT_SHA \
-        -n agents-dev
-    
-    # Wait for rollout
-    - kubectl rollout status deployment/aiflow-social-agent -n agents-dev --timeout=5m
-    
-    # Verify deployment
-    - kubectl get pods -n agents-dev -l app=aiflow-social-agent
-  only:
-    - development
-  tags:
-    - kubernetes
-
-deploy:staging:
-  stage: deploy
-  image: bitnami/kubectl:latest
-  environment:
-    name: staging
-    url: https://aiflow-staging.agent-buildkit.orb.local
-    kubernetes:
-      namespace: agents-staging
-  before_script:
-    - kubectl config use-context $KUBE_CONTEXT_STAGING
-  script:
-    - |
-      kubectl set image deployment/aiflow-social-agent \
-        aiflow-agent=$IMAGE_NAME:$CI_COMMIT_SHORT_SHA \
-        -n agents-staging
-    - kubectl rollout status deployment/aiflow-social-agent -n agents-staging --timeout=5m
-  only:
-    - main
-  when: manual
-  tags:
-    - kubernetes
-
-deploy:production:
-  stage: deploy
-  image: bitnami/kubectl:latest
-  environment:
-    name: production
-    url: https://aiflow.agent-buildkit.orb.local
-    kubernetes:
-      namespace: agents
-  before_script:
-    - kubectl config use-context $KUBE_CONTEXT_PROD
-  script:
-    # Blue/Green deployment
-    - |
-      # Create green deployment
-      kubectl apply -f k8s/deployment.yaml -n agents
-      kubectl set image deployment/aiflow-social-agent \
-        aiflow-agent=$IMAGE_NAME:$CI_COMMIT_SHORT_SHA \
-        -n agents
-      
-      # Wait for green to be ready
-      kubectl rollout status deployment/aiflow-social-agent -n agents --timeout=10m
-      
-      # Run smoke tests
-      kubectl run smoke-test --image=curlimages/curl:latest --rm -i --restart=Never -- \
-        curl -f http://aiflow-social-agent.agents.svc.cluster.local:8000/health || exit 1
-      
-      # Switch traffic (already done by deployment)
-      echo "Deployment successful"
-  only:
-    - main
-  when: manual
-  tags:
-    - kubernetes
-  needs:
-    - deploy:staging
-
-#===========================================
-# Stage 5: Monitor
-#===========================================
-
-monitor:health:
-  stage: monitor
-  image: curlimages/curl:latest
-  script:
-    - |
-      for i in {1..5}; do
-        curl -f https://aiflow.agent-buildkit.orb.local/health || exit 1
-        sleep 10
-      done
-  only:
-    - main
-  needs:
-    - deploy:production
-  when: on_success
-
-monitor:traces:
-  stage: monitor
-  image: curlimages/curl:latest
-  script:
-    - echo "Verifying Phoenix traces..."
-    - curl -f http://phoenix.agent-buildkit.orb.local:6006/api/projects/aiflow-social-agents/traces
-  only:
-    - main
-  needs:
-    - deploy:production
-  when: on_success
-  allow_failure: true
-
-#===========================================
-# Rollback (Manual)
-#===========================================
-
-rollback:production:
-  stage: deploy
-  image: bitnami/kubectl:latest
-  environment:
-    name: production
-    action: stop
-  script:
-    - kubectl rollout undo deployment/aiflow-social-agent -n agents
-    - kubectl rollout status deployment/aiflow-social-agent -n agents
-  only:
-    - main
-  when: manual
-  tags:
-    - kubernetes

package/examples/bridges/Dockerfile.production

@@ -1,87 +0,0 @@
-# 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://github.com/blueflyio/openstandardagents" \
-      ossa.compliant="true" \
-      ossa.version="1.0" \
-      agent.framework="aiflow" \
-      agent.role="chat"
-