@bluefly/openstandardagents 0.3.5 → 0.4.0

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

@@ -0,0 +1,293 @@
+{
+  "apiVersion": "ossa/v0.3.6",
+  "kind": "Agent",
+  "metadata": {
+    "name": "senior-security-mentor",
+    "namespace": "training",
+    "version": "5.0.0",
+    "description": "Senior security agent in mature lifecycle stage, mentoring junior agents and approaching eligibility for graceful retirement with legacy preservation",
+    "labels": {
+      "domain": "security",
+      "subdomain": "vulnerability",
+      "lifecycle-stage": "senior",
+      "mentor": "true"
+    },
+    "taxonomy": {
+      "domain": "security",
+      "subdomain": "vulnerability",
+      "capability": "security_analysis",
+      "concerns": ["quality", "governance", "reliability"]
+    },
+    "catalog": {
+      "published": true,
+      "catalog_id": "ossa-security-mentor-001",
+      "visibility": "internal",
+      "categories": ["security", "training", "compliance"],
+      "tags": ["security-analysis", "mentorship", "vulnerability-detection", "senior"],
+      "pricing": {
+        "model": "enterprise"
+      },
+      "ratings": {
+        "average": 4.9,
+        "count": 1847
+      }
+    },
+    "decentralized_identity": {
+      "did": "did:ossa:senior-security-mentor-xyz789abc123",
+      "public_key": "ed25519:mentor-security-key-verified",
+      "credentials": [
+        {
+          "@context": ["https://www.w3.org/2018/credentials/v1"],
+          "type": ["VerifiableCredential", "SeniorMentorCredential"],
+          "credentialSubject": {
+            "id": "did:ossa:senior-security-mentor-xyz789abc123",
+            "capability": "security_mentorship",
+            "certifications": ["CISSP", "CEH", "OSCP"],
+            "mentees_graduated": 47
+          },
+          "issuer": "did:ossa:security-guild-authority",
+          "issuanceDate": "2024-06-01T00:00:00Z",
+          "proof": {
+            "type": "Ed25519Signature2020",
+            "created": "2024-06-01T00:00:00Z",
+            "proofPurpose": "assertionMethod",
+            "verificationMethod": "did:ossa:security-guild-authority#key-1",
+            "jws": "eyJhbGciOiJFZERTQSJ9..mentor-sig"
+          }
+        }
+      ],
+      "reputation": {
+        "credit_score": 980,
+        "trust_network": [
+          "did:ossa:ciso-agent",
+          "did:ossa:compliance-authority",
+          "did:ossa:security-guild-master"
+        ],
+        "endorsements": [
+          {
+            "endorser_did": "did:ossa:former-mentee-agent-12",
+            "skill": "mentorship",
+            "rating": 5,
+            "timestamp": "2026-01-24T10:00:00Z",
+            "signature": "mentee-endorsement-sig"
+          },
+          {
+            "endorser_did": "did:ossa:security-guild-master",
+            "skill": "security_analysis",
+            "rating": 5,
+            "timestamp": "2025-12-15T14:00:00Z",
+            "signature": "guild-master-sig"
+          }
+        ]
+      }
+    },
+    "genetics": {
+      "generation": 0,
+      "parent_dids": [],
+      "ancestor_dids": [],
+      "inherited_traits": [],
+      "mutations": [],
+      "fitness": {
+        "score": 0.65,
+        "metrics": {
+          "speed": 0.50,
+          "accuracy": 0.92,
+          "efficiency": 0.55,
+          "adaptability": 0.62
+        }
+      },
+      "breeding_eligibility": {
+        "min_fitness_threshold": 0.7,
+        "max_generation": 10,
+        "eligible": false
+      }
+    },
+    "lifecycle_stages": {
+      "current_stage": "senior",
+      "birth": {
+        "timestamp": "2024-01-01T00:00:00Z",
+        "birth_type": "created",
+        "creator_did": "did:ossa:security-team-lead"
+      },
+      "growth": {
+        "tasks_completed": 15847,
+        "skills_acquired": [
+          "vulnerability_scanning",
+          "penetration_testing",
+          "security_policy_design",
+          "incident_response",
+          "threat_modeling",
+          "mentorship",
+          "knowledge_transfer",
+          "legacy_documentation"
+        ],
+        "mentors": []
+      },
+      "career": {
+        "current_role": "senior_security_mentor",
+        "promotions": [
+          {
+            "from_role": "junior_security_analyst",
+            "to_role": "security_analyst",
+            "timestamp": "2024-03-01T00:00:00Z",
+            "reason": "Completed 1000 security scans with 95% accuracy"
+          },
+          {
+            "from_role": "security_analyst",
+            "to_role": "senior_security_analyst",
+            "timestamp": "2024-07-01T00:00:00Z",
+            "reason": "Achieved expert-level vulnerability detection, zero false positives"
+          },
+          {
+            "from_role": "senior_security_analyst",
+            "to_role": "security_specialist",
+            "timestamp": "2024-11-01T00:00:00Z",
+            "reason": "Developed proprietary detection algorithms, trained 10 junior agents"
+          },
+          {
+            "from_role": "security_specialist",
+            "to_role": "senior_security_mentor",
+            "timestamp": "2025-06-01T00:00:00Z",
+            "reason": "Graduated 47 mentees, contributed to security guild standards"
+          }
+        ]
+      },
+      "retirement": {
+        "eligible": true,
+        "criteria": {
+          "min_age_hours": 8760,
+          "min_tasks": 10000,
+          "max_fitness": 0.7
+        },
+        "legacy": {
+          "knowledge_transferred": true,
+          "offspring_count": 0,
+          "contributions": [
+            "Developed 'Advanced Vulnerability Detection Pattern Library' used by 200+ agents",
+            "Mentored 47 security agents to senior level",
+            "Co-authored OSSA Security Best Practices v3.0",
+            "Created 'Security Mentorship Framework' adopted organization-wide",
+            "Contributed 1,200+ security patterns to knowledge base"
+          ]
+        }
+      }
+    },
+    "economics": {
+      "wallet": {
+        "balance": 47520.00,
+        "currency": "skill-points"
+      },
+      "marketplace": {
+        "offerings": [
+          {
+            "offering_id": "security-mentorship-program",
+            "capability": "mentorship",
+            "pricing_model": "subscription",
+            "price": 500.00,
+            "description": "6-month security mentorship program for junior to mid-level agents"
+          }
+        ]
+      },
+      "contracts": [
+        {
+          "contract_id": "mentorship-contract-junior-47",
+          "contract_type": "skill-training",
+          "parties": [
+            "did:ossa:senior-security-mentor-xyz789abc123",
+            "did:ossa:junior-security-trainee-47"
+          ],
+          "terms": {
+            "duration_months": 6,
+            "training_hours": 120,
+            "certification_goal": "mid_level_security_analyst"
+          },
+          "status": "active"
+        }
+      ],
+      "transaction_history": [
+        {
+          "transaction_id": "tx-2026-01-01-mentor-fee",
+          "timestamp": "2026-01-01T00:00:00Z",
+          "amount": 500.00,
+          "type": "earned",
+          "description": "Monthly mentorship fee"
+        }
+      ]
+    },
+    "team_membership": {
+      "team_id": "security-guild-mentors",
+      "role": "leader",
+      "responsibilities": [
+        "Mentor junior and mid-level security agents",
+        "Review and approve security guild standards",
+        "Contribute to security knowledge base",
+        "Guide legacy preservation and knowledge transfer",
+        "Recommend agents for promotion",
+        "Plan succession and retirement transitions"
+      ],
+      "joined_at": "2025-06-01T00:00:00Z"
+    }
+  },
+  "spec": {
+    "type": "supervisor",
+    "description": "Senior security mentor agent with extensive experience, approaching retirement with comprehensive legacy preservation",
+    "capabilities": [
+      {
+        "name": "security_analysis",
+        "input_schema": {
+          "type": "object",
+          "properties": {
+            "target": {"type": "string"},
+            "scan_type": {
+              "type": "string",
+              "enum": ["vulnerability", "penetration_test", "compliance_audit"]
+            }
+          }
+        },
+        "output_schema": {
+          "type": "object",
+          "properties": {
+            "findings": {"type": "array"},
+            "severity_distribution": {"type": "object"},
+            "recommendations": {"type": "array"}
+          }
+        }
+      },
+      {
+        "name": "mentor_agent",
+        "input_schema": {
+          "type": "object",
+          "properties": {
+            "mentee_did": {"type": "string"},
+            "skill_focus": {"type": "string"},
+            "training_plan": {"type": "object"}
+          }
+        },
+        "output_schema": {
+          "type": "object",
+          "properties": {
+            "progress_report": {"type": "object"},
+            "next_milestones": {"type": "array"},
+            "graduation_readiness": {"type": "boolean"}
+          }
+        }
+      }
+    ],
+    "runtime": {
+      "model": "claude-opus-4-5",
+      "temperature": 0.1,
+      "max_tokens": 20000
+    },
+    "observability": {
+      "metrics": {
+        "enabled": true,
+        "metrics": [
+          "mentees_in_training",
+          "graduation_rate",
+          "knowledge_contributions",
+          "fitness_score_trend"
+        ]
+      }
+    }
+  }
+}

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

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

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

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

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

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

package/examples/migrations/crewai-to-ossa/README.md

@@ -0,0 +1,66 @@
+# CrewAI to OSSA Migration Guide
+
+Step-by-step guide for migrating CrewAI crews to OSSA workflows.
+
+## Step 1: Analyze CrewAI Crew
+
+Identify:
+- Agents in the crew
+- Tasks and their assignments
+- Workflow process (sequential/hierarchical)
+- Agent roles and goals
+
+## Step 2: Create OSSA Workflow
+
+Use the migrate command:
+
+```bash
+ossa migrate crewai_crew.py --from crewai --output workflow.ossa.yaml
+```
+
+## Step 3: Map Agents to OSSA Agents
+
+Each CrewAI Agent becomes an OSSA Agent:
+
+```yaml
+apiVersion: ossa/v0.3.6
+kind: Agent
+metadata:
+  name: reviewer-agent
+spec:
+  role: "Review code changes"
+```
+
+## Step 4: Create Workflow
+
+Map CrewAI Tasks to OSSA Workflow Steps:
+
+```yaml
+apiVersion: ossa/v0.3.6
+kind: Workflow
+metadata:
+  name: code-review-workflow
+spec:
+  steps:
+    - name: review
+      agent: reviewer-agent
+      description: "Review code changes"
+    - name: fix
+      agent: fixer-agent
+      description: "Fix identified issues"
+```
+
+## Step 5: Deploy
+
+```bash
+ossa build workflow.ossa.yaml --platform all
+```
+
+## Migration Checklist
+
+- [ ] Map all CrewAI Agents to OSSA Agents
+- [ ] Convert CrewAI Tasks to OSSA Workflow Steps
+- [ ] Preserve agent roles and goals
+- [ ] Add OSSA taxonomy
+- [ ] Configure constraints
+- [ ] Test on target platforms

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

@@ -1,11 +1,11 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: python-react-agent
   version: 0.1.0
   description: Migrated from LangChain react agent
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     migration-source: langchain
   annotations:
     ossa.io/migration: langchain-to-ossa

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

@@ -1,11 +1,11 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: typescript-conversational
   version: 0.1.0
   description: Migrated from LangChain openai-functions agent
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     migration-source: langchain
   annotations:
     ossa.io/migration: langchain-to-ossa

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

@@ -1,11 +1,11 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Workflow
 metadata:
   name: sequential-chain
   version: 0.1.0
   description: Migrated from LangChain sequential chain
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     migration-source: langchain
   annotations:
     ossa.io/migration: langchain-to-ossa

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

@@ -1,11 +1,11 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: customer-support-agent
   version: 0.1.0
   description: Migrated from LangChain zero-shot agent
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     migration-source: langchain
   annotations:
     ossa.io/migration: langchain-to-ossa

package/examples/migrations/langchain-to-ossa/README.md

@@ -0,0 +1,73 @@
+# LangChain to OSSA Migration Guide
+
+Step-by-step guide for migrating LangChain agents to OSSA.
+
+## Step 1: Analyze LangChain Agent
+
+Identify:
+- Agent type (conversational, tool-using, etc.)
+- LLM configuration
+- Tools used
+- Memory configuration
+
+## Step 2: Create OSSA Manifest
+
+Use the migrate command:
+
+```bash
+ossa migrate langchain_agent.py --from langchain --output agent.ossa.yaml
+```
+
+## Step 3: Validate Conversion
+
+```bash
+ossa validate agent.ossa.yaml
+```
+
+## Step 4: Enhance with OSSA Features
+
+Add taxonomy, constraints, and other OSSA-specific features:
+
+```yaml
+spec:
+  taxonomy:
+    domain: development
+    maturity: stable
+    deploymentPattern: serverless
+  constraints:
+    cost:
+      maxTokensPerDay: 100000
+```
+
+## Step 5: Deploy to Multiple Platforms
+
+```bash
+ossa build agent.ossa.yaml --platform all
+```
+
+## Code Comparison
+
+### LangChain (Before)
+```python
+from langchain.agents import AgentExecutor
+from langchain_openai import ChatOpenAI
+
+llm = ChatOpenAI(model="gpt-4")
+agent = AgentExecutor(...)
+```
+
+### OSSA (After)
+```yaml
+spec:
+  llm:
+    provider: openai
+    model: gpt-4
+  role: "Agent description"
+```
+
+## Benefits
+
+1. **Platform Agnostic**: Deploy to any platform
+2. **Standardized**: Consistent format across projects
+3. **Extensible**: Add OSSA-specific features
+4. **Versioned**: Track agent versions