@bluefly/openstandardagents 0.3.5 → 0.3.6

package/dist/validation/validator.js

@@ -0,0 +1,262 @@
+/**
+ * OSSA v0.3.6 Manifest Validator
+ *
+ * JSON Schema validator for OSSA agent manifests using Ajv
+ * Validates revolutionary features: identity, genetics, lifecycle, economics, taxonomy
+ */
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+export class OSSAValidator {
+    ajv;
+    schema;
+    constructor(schemaPath) {
+        this.ajv = new Ajv({
+            allErrors: true,
+            verbose: true,
+            strict: false, // Allow additional properties for extensibility
+        });
+        addFormats(this.ajv);
+        // Load schema
+        const defaultSchemaPath = join(__dirname, '../spec/v0.3/ossa-0.3.6.schema.json');
+        const resolvedPath = schemaPath || defaultSchemaPath;
+        try {
+            const schemaContent = readFileSync(resolvedPath, 'utf-8');
+            this.schema = JSON.parse(schemaContent);
+        }
+        catch (error) {
+            throw new Error(`Failed to load schema from ${resolvedPath}: ${error}`);
+        }
+    }
+    /**
+     * Get Ajv instance for internal use
+     */
+    get ajvInstance() {
+        return this.ajv;
+    }
+    /**
+     * Validate an OSSA manifest
+     */
+    validate(manifest) {
+        const valid = this.ajv.validate(this.schema, manifest);
+        if (valid) {
+            return { valid: true, warnings: this.generateWarnings(manifest) };
+        }
+        const errors = this.ajv.errors?.map((err) => {
+            const path = err.instancePath || '/';
+            const message = err.message || 'Unknown error';
+            return `${path}: ${message}`;
+        }) || [];
+        return {
+            valid: false,
+            errors,
+            warnings: this.generateWarnings(manifest),
+        };
+    }
+    /**
+     * Validate from file path
+     */
+    validateFile(filePath) {
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const manifest = JSON.parse(content);
+            return this.validate(manifest);
+        }
+        catch (error) {
+            return {
+                valid: false,
+                errors: [`Failed to read or parse file: ${error}`],
+            };
+        }
+    }
+    /**
+     * Generate validation warnings (non-breaking issues)
+     */
+    generateWarnings(manifest) {
+        const warnings = [];
+        // Check for revolutionary features usage
+        const metadata = manifest.metadata || {};
+        // Warn if DID-based identity is used without credentials
+        if (metadata.decentralized_identity) {
+            const identity = metadata.decentralized_identity;
+            if (identity.did &&
+                (!identity.credentials ||
+                    (Array.isArray(identity.credentials) &&
+                        identity.credentials.length === 0))) {
+                warnings.push('decentralized_identity.did is set but no credentials provided');
+            }
+            if (identity.reputation) {
+                const reputation = identity.reputation;
+                if (reputation.credit_score === undefined) {
+                    warnings.push('decentralized_identity.reputation exists but credit_score is not set');
+                }
+            }
+        }
+        // Warn if genetics is used without fitness scoring
+        if (metadata.genetics) {
+            const genetics = metadata.genetics;
+            if (typeof genetics.generation === 'number' &&
+                genetics.generation > 0 &&
+                (!genetics.parent_dids ||
+                    (Array.isArray(genetics.parent_dids) &&
+                        genetics.parent_dids.length === 0))) {
+                warnings.push('genetics.generation > 0 but no parent_dids specified');
+            }
+            if (!genetics.fitness) {
+                warnings.push('genetics defined but fitness.score not set - breeding eligibility cannot be determined');
+            }
+            else {
+                const fitness = genetics.fitness;
+                if (fitness.score === undefined) {
+                    warnings.push('genetics defined but fitness.score not set - breeding eligibility cannot be determined');
+                }
+            }
+        }
+        // Warn if lifecycle_stages retirement is eligible but no legacy defined
+        if (metadata.lifecycle_stages) {
+            const lifecycle = metadata.lifecycle_stages;
+            if (lifecycle.retirement) {
+                const retirement = lifecycle.retirement;
+                if (retirement.eligible && !retirement.legacy) {
+                    warnings.push('lifecycle_stages.retirement.eligible is true but no legacy defined');
+                }
+            }
+            if (lifecycle.current_stage === 'retired') {
+                const retirement = lifecycle.retirement;
+                if (!retirement?.retired_at) {
+                    warnings.push('lifecycle_stages.current_stage is "retired" but retirement.retired_at timestamp missing');
+                }
+            }
+        }
+        // Warn if economics marketplace has offerings but no wallet
+        if (metadata.economics) {
+            const economics = metadata.economics;
+            if (economics.marketplace) {
+                const marketplace = economics.marketplace;
+                if (marketplace.offerings &&
+                    Array.isArray(marketplace.offerings) &&
+                    marketplace.offerings.length > 0 &&
+                    !economics.wallet) {
+                    warnings.push('economics.marketplace.offerings exist but no wallet defined to receive payments');
+                }
+            }
+        }
+        // Warn if team_membership exists but lifecycle_stages missing
+        if (metadata.team_membership && !metadata.lifecycle_stages) {
+            warnings.push('team_membership defined but lifecycle_stages missing - consider tracking agent growth');
+        }
+        // Warn if taxonomy domain doesn't match typical agent type
+        if (metadata.taxonomy && manifest.spec) {
+            const taxonomy = metadata.taxonomy;
+            const spec = manifest.spec;
+            const domain = taxonomy.domain;
+            const agentType = spec.type;
+            // Security domain should typically use analyzer/specialist types
+            if (domain === 'security' &&
+                !['analyzer', 'specialist', 'worker'].includes(agentType)) {
+                warnings.push(`taxonomy.domain is "security" but spec.type is "${agentType}" - consider using analyzer or specialist type`);
+            }
+            // Agents domain should use orchestrator/supervisor types
+            if (domain === 'agents' &&
+                !['orchestrator', 'supervisor'].includes(agentType)) {
+                warnings.push(`taxonomy.domain is "agents" but spec.type is "${agentType}" - consider using orchestrator or supervisor type`);
+            }
+        }
+        return warnings;
+    }
+    /**
+     * Validate revolutionary features specifically
+     */
+    validateRevolutionaryFeatures(manifest) {
+        const errors = [];
+        const warnings = [];
+        const metadata = manifest.metadata || {};
+        // Validate decentralized_identity
+        if (metadata.decentralized_identity) {
+            const identity = metadata.decentralized_identity;
+            if (identity.did &&
+                typeof identity.did === 'string' &&
+                !/^did:ossa:[a-z0-9]{32,64}$/.test(identity.did)) {
+                errors.push('decentralized_identity.did must match pattern: did:ossa:[a-z0-9]{32,64}');
+            }
+        }
+        // Validate genetics
+        if (metadata.genetics) {
+            const genetics = metadata.genetics;
+            if (typeof genetics.generation === 'number' && genetics.generation < 0) {
+                errors.push('genetics.generation must be >= 0');
+            }
+            if (genetics.fitness) {
+                const fitness = genetics.fitness;
+                if (typeof fitness.score === 'number' &&
+                    (fitness.score < 0 || fitness.score > 1)) {
+                    errors.push('genetics.fitness.score must be between 0.0 and 1.0');
+                }
+            }
+        }
+        // Validate lifecycle_stages
+        if (metadata.lifecycle_stages) {
+            const lifecycle = metadata.lifecycle_stages;
+            const validStages = [
+                'embryonic',
+                'juvenile',
+                'mature',
+                'senior',
+                'retired',
+            ];
+            if (typeof lifecycle.current_stage === 'string' &&
+                !validStages.includes(lifecycle.current_stage)) {
+                errors.push(`lifecycle_stages.current_stage must be one of: ${validStages.join(', ')}`);
+            }
+        }
+        // Validate economics
+        if (metadata.economics) {
+            const economics = metadata.economics;
+            if (economics.wallet) {
+                const wallet = economics.wallet;
+                if (typeof wallet.balance === 'number' && wallet.balance < 0) {
+                    errors.push('economics.wallet.balance cannot be negative');
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    }
+}
+// CLI usage
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        console.log('Usage: ts-node validator.ts <manifest.json> [schema.json]');
+        process.exit(1);
+    }
+    const manifestPath = args[0];
+    const schemaPath = args[1];
+    const validator = new OSSAValidator(schemaPath);
+    const result = validator.validateFile(manifestPath);
+    if (result.valid) {
+        console.log('✅ Valid OSSA manifest');
+        if (result.warnings && result.warnings.length > 0) {
+            console.log('\n⚠️  Warnings:');
+            result.warnings.forEach((w) => console.log(`   - ${w}`));
+        }
+        process.exit(0);
+    }
+    else {
+        console.log('❌ Invalid OSSA manifest');
+        if (result.errors) {
+            console.log('\nErrors:');
+            result.errors.forEach((e) => console.log(`   - ${e}`));
+        }
+        if (result.warnings && result.warnings.length > 0) {
+            console.log('\n⚠️  Warnings:');
+            result.warnings.forEach((w) => console.log(`   - ${w}`));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/validation/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/validation/validator.ts"],"names":[],"mappings":"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"}

package/examples/a2a/agent-handoff.ossa.yaml

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

package/examples/a2a/service-discovery.ossa.yaml

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

package/examples/adapters/drupal-eca-mapping.yaml

@@ -1,6 +1,6 @@
 # Example: ECA (Event-Condition-Action) to OSSA Task Mapping
 # Demonstrates how Drupal ECA rules map to OSSA Task/Workflow manifests
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Task
 metadata:
   name: eca-content-published-notify

package/examples/adapters/drupal-eca-task.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Task
 metadata:
   name: drupal-content-moderation

package/examples/adapters/drupal-flowdrop-mapping.yaml

@@ -1,6 +1,6 @@
 # Example: FlowDrop Visual Workflow to OSSA Workflow Mapping
 # Demonstrates how Drupal FlowDrop diagrams map to OSSA Workflows
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Workflow
 metadata:
   name: flowdrop-user-registration

package/examples/adapters/drupal-maestro-mapping.yaml

@@ -1,6 +1,6 @@
 # Example: Maestro Business Process to OSSA Workflow Mapping
 # Demonstrates how Drupal Maestro templates map to OSSA Workflows
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Workflow
 metadata:
   name: maestro-content-approval

package/examples/adapters/mistral-agent.yaml

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

package/examples/adapters/symfony-messenger-task.yaml

@@ -1,6 +1,6 @@
 # Example: OSSA Task executed via Symfony Messenger
 # Demonstrates async task execution with queue-based processing
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Task
 metadata:
   name: send-email-symfony

package/examples/adapters/symfony-messenger-workflow.yaml

@@ -1,6 +1,6 @@
 # Example: OSSA Workflow executed via Symfony Messenger
 # Demonstrates multi-step workflow with async Task orchestration
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Workflow
 metadata:
   name: user-onboarding-symfony

package/examples/advanced/reasoning-agent.yaml

@@ -1,6 +1,6 @@
 # OSSA v0.2.9 - Reasoning Agent Example
 # Demonstrates: reasoning strategies, prompt templates, knowledge graph
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: research-analyst

package/examples/advanced/workflows/hybrid-model-strategy.yaml

@@ -1,7 +1,7 @@
 # Hybrid Model Strategy: Fast Local Planning + Premium Development
 # Demonstrates using fast Ollama models for planning agents and Claude for development
 
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Workflow
 metadata:
   name: hybrid-development-workflow

package/examples/agent-manifests/critics/critic-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: code-quality-critic

package/examples/agent-manifests/governors/governor-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: policy-compliance-governor

package/examples/agent-manifests/integrators/integrator-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: multi-system-integrator

package/examples/agent-manifests/judges/judge-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: decision-arbitration-judge

package/examples/agent-manifests/monitors/monitor-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: system-performance-monitor

package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml

@@ -20,7 +20,7 @@
 # ============================================================================
 
 # OSSA manifest version - defines the schema and features available
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 
 # Kind declares this as an Agent manifest (vs. Bridge, Tool, etc.)
 kind: Agent

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: data-processing-worker

package/examples/agents/architecture-healer-enterprise.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: architecture-healer-enterprise

package/examples/agents/dependency-healer-npm.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: dependency-healer-npm

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: spec-healer-openapi

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: wiki-healer-production

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

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

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: self-evolving-agent

package/examples/build-once-use-everywhere/README.md

@@ -0,0 +1,184 @@
+# Build Once, Use Everywhere Demo
+
+This comprehensive demo showcases how a single OSSA manifest can be built and deployed across multiple platforms simultaneously, demonstrating the true power of OSSA as the "OpenAPI for AI agents."
+
+## Overview
+
+This example demonstrates deploying one OSSA agent manifest to:
+- kagent.dev (Kubernetes)
+- LangChain (Python)
+- CrewAI (Python)
+- Docker (Container)
+- Kubernetes (Native)
+- GitLab CI/CD
+- Temporal (TypeScript)
+
+## Quick Start
+
+```bash
+# Build for all platforms
+ossa build agent.ossa.yaml --all
+
+# Or build for specific platforms
+ossa build agent.ossa.yaml --platform kagent --platform langchain --platform docker
+
+# Deploy to all configured platforms
+ossa deploy agent.ossa.yaml --all
+
+# Or deploy to specific platform
+ossa deploy agent.ossa.yaml --platform kagent
+```
+
+## Example Agent Manifest
+
+See `agent.ossa.yaml` for the complete OSSA manifest that works across all platforms.
+
+## Platform-Specific Builds
+
+### kagent.dev
+
+```bash
+# Generate kagent CRD
+ossa export agent.ossa.yaml --platform kagent --output kagent-crd.yaml
+
+# Deploy to kagent.dev
+ossa deploy agent.ossa.yaml --platform kagent
+```
+
+**Generated Artifacts:**
+- `kagent-crd.yaml` - Kubernetes Custom Resource Definition
+
+### LangChain
+
+```bash
+# Generate LangChain Python code
+ossa export agent.ossa.yaml --platform langchain --format python --output langchain_agent.py
+
+# Run LangChain agent
+python langchain_agent.py
+```
+
+**Generated Artifacts:**
+- `langchain_agent.py` - Executable Python code
+
+### CrewAI
+
+```bash
+# Generate CrewAI Python code
+ossa export agent.ossa.yaml --platform crewai --format python --output crewai_crew.py
+
+# Run CrewAI crew
+python crewai_crew.py
+```
+
+**Generated Artifacts:**
+- `crewai_crew.py` - Executable Python code
+
+### Docker
+
+```bash
+# Generate Dockerfile
+ossa export agent.ossa.yaml --platform docker --output Dockerfile
+
+# Build and run
+docker build -t my-agent .
+docker run my-agent
+```
+
+**Generated Artifacts:**
+- `Dockerfile` - Production-ready Dockerfile
+
+### Kubernetes
+
+```bash
+# Generate Kubernetes manifests
+ossa export agent.ossa.yaml --platform kubernetes --output k8s-manifests.yaml
+
+# Deploy to cluster
+kubectl apply -f k8s-manifests.yaml
+```
+
+**Generated Artifacts:**
+- `k8s-manifests.yaml` - Deployment, Service, ConfigMap manifests
+
+### GitLab CI/CD
+
+```bash
+# Generate GitLab CI config
+ossa export agent.ossa.yaml --platform gitlab --output .gitlab-ci.yml
+
+# Commit and push
+git add .gitlab-ci.yml
+git commit -m "Add OSSA agent CI/CD"
+git push
+```
+
+**Generated Artifacts:**
+- `.gitlab-ci.yml` - GitLab CI/CD pipeline configuration
+
+### Temporal
+
+```bash
+# Generate Temporal workflow
+ossa export agent.ossa.yaml --platform temporal --format typescript --output temporal_workflow.ts
+
+# Deploy Temporal workflow
+temporal workflow start --workflow-id my-agent --task-queue agents
+```
+
+**Generated Artifacts:**
+- `temporal_workflow.ts` - TypeScript workflow code
+
+## Multi-Platform Deployment
+
+Deploy to multiple platforms simultaneously:
+
+```bash
+# Build for all platforms
+ossa build agent.ossa.yaml --all
+
+# Deploy to all configured platforms
+ossa deploy agent.ossa.yaml --all --config deploy-config.yaml
+```
+
+## Comparison Matrix
+
+| Platform | Build Time | Deploy Time | Runtime | Scaling |
+|----------|-----------|-------------|---------|---------|
+| kagent.dev | <5s | <30s | K8s Native | Auto |
+| LangChain | <2s | N/A | Python | Manual |
+| CrewAI | <2s | N/A | Python | Manual |
+| Docker | <10s | <5s | Container | Manual |
+| Kubernetes | <5s | <30s | K8s Native | Auto |
+| GitLab CI | <2s | On Push | CI Runner | Auto |
+| Temporal | <5s | <10s | Temporal | Auto |
+
+## Workflow
+
+1. **Create OSSA Manifest** - Write once in OSSA format
+2. **Build for Platforms** - Generate platform-specific artifacts
+3. **Validate** - Validate against platform requirements
+4. **Deploy** - Deploy to selected platforms
+5. **Monitor** - Monitor across all platforms
+
+## Benefits
+
+- **Single Source of Truth**: One manifest, multiple platforms
+- **Consistency**: Same agent behavior across platforms
+- **Flexibility**: Choose the right platform for each use case
+- **Maintainability**: Update once, deploy everywhere
+- **Cost Optimization**: Use the most cost-effective platform per workload
+
+## Next Steps
+
+1. Review the example manifest (`agent.ossa.yaml`)
+2. Customize for your use case
+3. Build for your target platforms
+4. Deploy and monitor
+5. Iterate and improve
+
+## See Also
+
+- [Platform Comparison Matrix](../../docs/comparison/platform-matrix.md)
+- [Integration Guides](../../docs/integrations/)
+- [Multi-Platform Example](../multi-platform/single-manifest/)