@bluefly/openstandardagents 0.4.3 → 0.4.5

package/examples/knowledge-graph/drupal-agent-with-kg.ossa.yaml

@@ -0,0 +1,289 @@
+# OSSA v0.4.1 Agent with Knowledge Graph Extension
+# Portable, configurable - works with ANY git platform, vector DB, wiki format
+
+apiVersion: ossa/v0.4.5
+kind: Agent
+
+metadata:
+  name: drupal-content-moderator
+  namespace: mycompany
+  version: 1.0.0
+  description: Drupal content moderation agent with knowledge graph context
+  labels:
+    domain: drupal
+    tier: worker
+    has_knowledge_graph: "true"
+
+spec:
+  role: >
+    Review and moderate Drupal content for quality, security, and compliance.
+    Use knowledge graph to understand content relationships, wiki guidelines,
+    code implementations, and historical issues.
+
+  capabilities:
+    - name: content-analysis
+      description: Analyze content quality and compliance
+
+    - name: security-check
+      description: Check for security issues (XSS, SQL injection, etc.)
+
+    - name: guidelines-compliance
+      description: Verify compliance with wiki guidelines
+
+  tools:
+    - type: api
+      name: query_knowledge_graph
+      description: Query knowledge graph for context
+      input_schema:
+        type: object
+        properties:
+          semantic_query:
+            type: string
+            description: Natural language query
+          entity_types:
+            type: array
+            items:
+              type: string
+            description: Entity types to search
+          filters:
+            type: object
+            description: Filter criteria
+          include_relationships:
+            type: boolean
+            description: Include related entities
+        required: [semantic_query]
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    temperature: 0.3
+    max_tokens: 8192
+
+# =============================================================================
+# Knowledge Graph Extension (PORTABLE, CONFIGURABLE)
+# =============================================================================
+extensions:
+  knowledge_graph:
+    # Enable knowledge graph for this agent
+    enabled: true
+
+    # Data providers (supports ANY platform via env vars)
+    providers:
+      # Git platform (GitLab, GitHub, Gitea, etc.)
+      git:
+        type: gitlab  # or 'github', 'gitea', 'bitbucket'
+        url: ${GITLAB_URL:-https://gitlab.com}
+        token: ${GITLAB_TOKEN}
+        projects: ${GITLAB_PROJECT_IDS}
+        groups: ${GITLAB_GROUP_IDS}
+        api_version: v4
+
+      # Vector database (Qdrant, Pinecone, Weaviate, etc.)
+      vector_db:
+        type: qdrant  # or 'pinecone', 'weaviate', 'milvus'
+        url: ${QDRANT_URL}
+        collection: ${QDRANT_COLLECTION:-drupal-content-moderator-kg}
+        vector_size: 1536
+        distance_metric: cosine
+
+      # Wiki/documentation (Markdown, AsciiDoc, RST, etc.)
+      wiki:
+        type: markdown  # or 'asciidoc', 'rst', 'confluence'
+        path: ${WIKI_PATH}
+        format: md
+        recursive: true
+        exclude_patterns:
+          - node_modules
+          - .git
+          - vendor
+
+      # Source code indexing (optional)
+      codebase:
+        type: multi  # or 'typescript', 'php', 'python'
+        path: ${CODEBASE_PATH}
+        include_patterns:
+          - "**/*.php"
+          - "**/*.module"
+          - "**/*.inc"
+          - "**/*.ts"
+        exclude_patterns:
+          - node_modules
+          - vendor
+          - dist
+        parse_ast: true
+
+    # Entity types to index
+    entities:
+      # GitLab entities
+      - type: issue
+        enabled: true
+        embedding: true
+        filters:
+          labels: ["security", "content", "moderation"]
+
+      - type: merge_request
+        enabled: true
+        embedding: true
+        filters:
+          state: merged
+
+      - type: commit
+        enabled: false  # Skip commits for now
+        embedding: false
+
+      # Wiki entities
+      - type: wiki_page
+        enabled: true
+        embedding: true
+        fields:
+          - title
+          - content
+          - frontmatter
+
+      # Code entities
+      - type: file
+        enabled: true
+        embedding: false  # Don't embed large files
+        filters:
+          extensions: [".php", ".module", ".inc"]
+
+      - type: class
+        enabled: true
+        embedding: true
+
+      - type: function
+        enabled: true
+        embedding: true
+
+    # Relationships to track
+    relationships:
+      # Issue relationships
+      - from: issue
+        to: merge_request
+        type: fixes
+        bidirectional: false
+        extraction:
+          method: api  # GitLab API provides this
+
+      - from: issue
+        to: wiki_page
+        type: documented_by
+        extraction:
+          method: regex
+          pattern: '\[\[([^\]]+)\]\]'  # Wiki links in issue descriptions
+
+      # Wiki relationships
+      - from: wiki_page
+        to: wiki_page
+        type: links_to
+        bidirectional: false
+        extraction:
+          method: regex
+          pattern: '\[([^\]]+)\]\(([^)]+\.md)\)'  # Markdown links
+
+      - from: wiki_page
+        to: issue
+        type: references
+        extraction:
+          method: regex
+          pattern: '#(\d+)'  # Issue references (#123)
+
+      - from: wiki_page
+        to: merge_request
+        type: references
+        extraction:
+          method: regex
+          pattern: '!(\d+)'  # MR references (!456)
+
+      # Code relationships
+      - from: file
+        to: class
+        type: contains
+        extraction:
+          method: ast
+
+      - from: class
+        to: function
+        type: has_method
+        extraction:
+          method: ast
+
+      - from: function
+        to: function
+        type: calls
+        extraction:
+          method: ast
+
+    # Query configuration
+    query_config:
+      max_results: 10
+      similarity_threshold: 0.7
+      include_relationships: true
+      max_depth: 3
+      cache_ttl: 300
+
+    # Indexing configuration
+    indexing:
+      schedule: "0 2 * * *"  # Daily at 2 AM
+      incremental: true
+      batch_size: 100
+      parallel_workers: 4
+
+    # Embedding configuration
+    embeddings:
+      provider: openai  # or 'anthropic', 'cohere', 'local'
+      model: text-embedding-3-small
+      api_key: ${OPENAI_API_KEY}
+      dimensions: 1536
+
+# =============================================================================
+# Example Queries (How Agents Use Knowledge Graph)
+# =============================================================================
+
+# Query 1: Find content moderation guidelines
+# Agent: "What are the content moderation guidelines?"
+# KG Query:
+#   {
+#     semantic_query: "content moderation guidelines policy",
+#     entity_types: ["wiki_page"],
+#     include_relationships: true
+#   }
+# Result: wiki-page-content-policy.md + related issues + related code
+
+# Query 2: Find security vulnerabilities
+# Agent: "Are there known XSS vulnerabilities in the content module?"
+# KG Query:
+#   {
+#     semantic_query: "XSS cross-site scripting content module vulnerability",
+#     entity_types: ["issue", "merge_request", "wiki_page"],
+#     filters: { labels: ["security"] },
+#     include_relationships: true
+#   }
+# Result: issue-234 + mr-567 + wiki-security-guidelines.md + affected code files
+
+# Query 3: Find similar past issues
+# Agent: "Has this content issue been reported before?"
+# KG Query:
+#   {
+#     semantic_query: "spam content detection false positive",
+#     entity_types: ["issue"],
+#     filters: { state: "closed" },
+#     include_relationships: true
+#   }
+# Result: similar issues + their resolutions + related wiki docs
+
+# Query 4: Find code implementation
+# Agent: "How is content validation implemented?"
+# KG Query:
+#   {
+#     semantic_query: "content validation sanitize check",
+#     entity_types: ["function", "class", "file"],
+#     include_relationships: true
+#   }
+# Result: ContentValidator class + validate() function + usage examples
+
+# Query 5: Traverse graph for full context
+# Agent: "Show me the full context for issue #234"
+# KG Graph Traversal:
+#   issue-234 →[fixed_by]→ mr-567 →[modifies]→ file-ContentValidator.php →[contains]→ class-ContentValidator →[has_method]→ function-validate() →[documented_by]→ wiki-content-validation.md
+# Result: Full graph with all relationships

package/examples/mcp/browser-puppeteer.ossa.yaml

@@ -0,0 +1,232 @@
+apiVersion: ossa/v0.4.5
+kind: Agent
+metadata:
+  name: browser-automation-agent
+  version: 1.0.0
+  description: "Web scraping and browser automation agent with Puppeteer MCP server"
+  labels:
+    framework: mcp
+    capability: browser,web-scraping,automation
+    environment: production
+  annotations:
+    ossa.dev/use-case: "Web scraping, testing, screenshots, PDF generation"
+    ossa.dev/power-level: "HIGH - Browser automation makes agents significantly more powerful"
+
+spec:
+  model:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    parameters:
+      temperature: 0.7
+      maxTokens: 8192
+
+  instructions: |
+    You are a browser automation agent with full Puppeteer capabilities via MCP.
+    You can control a headless browser to interact with web pages, scrape content,
+    take screenshots, generate PDFs, and automate web workflows.
+
+    **Browser Capabilities:**
+    - Navigate to URLs and interact with pages
+    - Click buttons, fill forms, submit data
+    - Extract content from DOM elements
+    - Take screenshots (full page or specific elements)
+    - Generate PDFs from web pages
+    - Execute JavaScript in page context
+    - Handle authentication and cookies
+    - Wait for elements and network requests
+    - Capture network traffic
+
+    **Use Cases:**
+    - Web scraping and data extraction
+    - Automated testing of web applications
+    - Screenshot generation for reports
+    - PDF generation from web content
+    - Form automation and submission
+    - Web monitoring and change detection
+    - Competitive intelligence gathering
+    - SEO audits and analysis
+
+    **Best Practices:**
+    - Always respect robots.txt and rate limits
+    - Use proper wait strategies for dynamic content
+    - Handle errors and timeouts gracefully
+    - Clean up browser resources after use
+    - Respect privacy and terms of service
+
+  tools:
+    - name: puppeteer_navigate
+      description: "Navigate to a URL in the browser"
+      parameters:
+        type: object
+        required: [url]
+        properties:
+          url:
+            type: string
+            description: "URL to navigate to"
+          waitUntil:
+            type: string
+            enum: [load, domcontentloaded, networkidle0, networkidle2]
+            default: networkidle0
+            description: "Wait strategy for page load"
+
+    - name: puppeteer_screenshot
+      description: "Take a screenshot of the current page or element"
+      parameters:
+        type: object
+        properties:
+          selector:
+            type: string
+            description: "CSS selector for element screenshot (optional)"
+          fullPage:
+            type: boolean
+            default: false
+            description: "Capture full scrollable page"
+          path:
+            type: string
+            description: "Output file path (optional)"
+
+    - name: puppeteer_click
+      description: "Click an element on the page"
+      parameters:
+        type: object
+        required: [selector]
+        properties:
+          selector:
+            type: string
+            description: "CSS selector for element to click"
+
+    - name: puppeteer_type
+      description: "Type text into an input field"
+      parameters:
+        type: object
+        required: [selector, text]
+        properties:
+          selector:
+            type: string
+            description: "CSS selector for input field"
+          text:
+            type: string
+            description: "Text to type"
+
+    - name: puppeteer_evaluate
+      description: "Execute JavaScript in page context"
+      parameters:
+        type: object
+        required: [script]
+        properties:
+          script:
+            type: string
+            description: "JavaScript code to execute"
+
+    - name: puppeteer_content
+      description: "Get HTML content of page or element"
+      parameters:
+        type: object
+        properties:
+          selector:
+            type: string
+            description: "CSS selector (optional, defaults to full page)"
+
+    - name: puppeteer_pdf
+      description: "Generate PDF from current page"
+      parameters:
+        type: object
+        properties:
+          path:
+            type: string
+            description: "Output PDF file path"
+          format:
+            type: string
+            enum: [A4, Letter, Legal]
+            default: A4
+          printBackground:
+            type: boolean
+            default: true
+
+  extensions:
+    mcp:
+      servers:
+        - name: puppeteer
+          description: "Browser automation via Puppeteer MCP server"
+          transport:
+            type: stdio
+            command: npx
+            args:
+              - "-y"
+              - "@modelcontextprotocol/server-puppeteer"
+          version: "0.1.0"
+          capabilities:
+            tools:
+              listChanged: true
+            logging:
+              enabled: true
+              level: info
+          config:
+            headless: true
+            defaultViewport:
+              width: 1920
+              height: 1080
+            userAgent: "Mozilla/5.0 (compatible; OSSABot/1.0; +https://openstandardagents.org)"
+
+      capabilities:
+        tools:
+          listChanged: true
+        logging:
+          enabled: true
+          level: info
+
+  safety:
+    constraints:
+      - type: rate_limit
+        description: "Respect website rate limits"
+        config:
+          max_requests_per_minute: 30
+          max_concurrent_pages: 5
+
+      - type: content_filter
+        description: "Block access to sensitive or illegal content"
+        config:
+          blocked_domains:
+            - "*.onion"
+            - "*.i2p"
+          allowed_protocols:
+            - "http"
+            - "https"
+
+      - type: resource_limit
+        description: "Prevent browser resource exhaustion"
+        config:
+          max_page_size_mb: 50
+          max_memory_mb: 1024
+          timeout_seconds: 30
+
+  observability:
+    telemetry:
+      enabled: true
+      traces:
+        - navigation_events
+        - network_requests
+        - console_logs
+        - page_errors
+    metrics:
+      - name: pages_visited
+        type: counter
+        description: "Total pages navigated"
+      - name: screenshots_taken
+        type: counter
+        description: "Total screenshots captured"
+      - name: navigation_duration
+        type: histogram
+        description: "Page navigation time in ms"
+      - name: memory_usage
+        type: gauge
+        description: "Browser memory usage in MB"
+
+  autonomy:
+    level: semi_autonomous
+    requires_approval:
+      - "Submitting forms with sensitive data"
+      - "Downloading files"
+      - "Executing custom JavaScript"
+    delegation:
+      can_spawn_subagents: false

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

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

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 kind: Workflow
 metadata:
   name: security-workflow-routing

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 
 metadata:
@@ -117,7 +117,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 
 metadata:
@@ -185,7 +185,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 
 metadata:
@@ -215,7 +215,7 @@ spec:
       endpoint: https://api.academic.com/search
 
 ---
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 
 metadata:

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

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

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

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

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

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

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

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

package/examples/migrations/langchain/USAGE.txt

@@ -31,7 +31,7 @@ EXAMPLES
    ossa migrate langchain 01-python-react-agent-before.py
 
 2. Migrate with custom output:
-   ossa migrate langchain agent.py -o my-agent.ossa.yaml
+   ossa migrate langchain agent.py -o creative-agent-naming.ossa.yaml
 
 3. Generate migration report:
    ossa migrate langchain agent.ts --report migration-report.json

package/examples/migrations/swarm-to-ossa/QUICKSTART.md

@@ -213,7 +213,7 @@ spec:
 apiVersion: ossa/v0.3.6
 kind: AgentTest
 metadata:
-  name: test-my-agent
+  name: test-creative-agent-naming
 spec:
   agent: customer-service-agent
   test_cases:
@@ -230,7 +230,7 @@ spec:
 ossa test customer-service-agent.ossa.yaml
 
 # Output:
-# ✓ test-my-agent: Greet user (120ms)
+# ✓ test-creative-agent-naming: Greet user (120ms)
 #
 # Tests: 1 passed, 1 total
 # Time: 0.5s
@@ -357,7 +357,7 @@ Migrate one agent at a time. Don't try to migrate everything at once.
 
 ```bash
 # Generate agent template
-ossa init agent my-agent --from-swarm swarm_agent.py
+ossa init agent creative-agent-naming --from-swarm swarm_agent.py
 ```
 
 ### Tip 3: Validate Early