@bluefly/openstandardagents 0.4.4 → 0.4.5

package/dist/spec/v0.3/README.md

@@ -1,366 +0,0 @@
-# OSSA v0.3.5: The Next OpenAPI for Software Agents
-
-**Status**: Design Phase  
-**Target Release**: Q2 2026  
-**Vision**: The definitive specification for production-ready software agents
-
----
-
-## WHAT IS OSSA v0.3.5?
-
-OSSA (Open Standard for Scalable Agents) v0.3.5 transforms from a basic agent manifest standard into **the definitive OpenAPI for Software Agents**—the specification that every agent framework, platform, and tool will adopt.
-
-Just as OpenAPI revolutionized REST APIs, OSSA v0.3.5 revolutionizes software agents.
-
----
-
-## KEY INNOVATIONS
-
-### 1. Completion Signals 🎯
-
-**Problem**: Agents need standardized ways to signal task completion status.
-
-**Solution**: Five standardized signals (`continue`, `complete`, `blocked`, `escalate`, `checkpoint`) enable intelligent workflow orchestration.
-
-```yaml
-completion:
-  default_signal: complete
-  signals:
-    - signal: continue
-      condition: "iteration_count < max_iterations"
-    - signal: blocked
-      condition: "confidence < 0.5"
-```
-
-**Impact**: Orchestrators can make intelligent decisions about workflow progression without custom logic.
-
----
-
-### 2. Session Checkpointing 💾
-
-**Problem**: Agents need resilient state management to survive interruptions.
-
-**Solution**: Native checkpoint/resume support enables long-running tasks and cost optimization.
-
-```yaml
-checkpointing:
-  enabled: true
-  interval: iteration
-  interval_value: 5
-  storage:
-    backend: agent-brain
-```
-
-**Impact**: Agents can pause/resume, reducing costs and enabling fault tolerance.
-
----
-
-### 3. Mixture of Experts (MoE) 🧠
-
-**Problem**: Agents should control expert model selection, not infrastructure.
-
-**Solution**: Agent-controlled expert registry with intelligent routing.
-
-```yaml
-experts:
-  registry:
-    - id: reasoning-expert
-      model: claude-opus-4-5-20251101
-      specializations: [complex_reasoning, planning]
-      cost_tier: premium
-    - id: speed-expert
-      model: gemini-2.0-flash
-      specializations: [quick_responses]
-      cost_tier: economy
-  selection_strategy: agent_controlled
-```
-
-**Impact**: Intelligent expert selection optimizes costs and improves task quality.
-
----
-
-### 4. BAT Framework 🎯
-
-**Problem**: Agents need systematic technology selection.
-
-**Solution**: Best Available Technology framework with multi-dimensional selection criteria.
-
-```yaml
-bat:
-  selection_criteria:
-    - dimension: reasoning_depth
-      options:
-        - value: deep
-          technologies: [claude-opus, gpt-4-turbo]
-        - value: fast
-          technologies: [gemini-flash]
-```
-
-**Impact**: Consistent, auditable technology selection across all agents.
-
----
-
-### 5. MOE Metrics 📊
-
-**Problem**: Agents need standardized performance evaluation.
-
-**Solution**: Measure of Effectiveness metrics with primary, secondary, and operational categories.
-
-```yaml
-moe:
-  primary:
-    metric: review_accuracy
-    target: 0.95
-  secondary:
-    - metric: review_latency_p95
-      target: 600
-  operational:
-    - metric: uptime
-      target: 0.999
-```
-
-**Impact**: Data-driven agent improvement and performance tracking.
-
----
-
-### 6. Flow Kind Specification 🔄
-
-**Problem**: OSSA needs native flow-based orchestration support.
-
-**Solution**: Native `Flow` kind with state machines, transitions, and adaptors.
-
-```yaml
-apiVersion: ossa/v0.3.5
-kind: Flow
-spec:
-  flow_schema:
-    initial_state: ready
-    states: [ready, reviewing, completed]
-  transitions:
-    - from: ready
-      to: reviewing
-      trigger:
-        type: webhook
-        event: merge_request.opened
-  adaptors:
-    langgraph:
-      export: true
-    temporal:
-      export: true
-```
-
-**Impact**: 100% compatibility with LangGraph, Temporal, n8n, and other flow engines.
-
----
-
-### 7. Dynamic Capability Discovery 🔍
-
-**Problem**: Agents need to discover capabilities at runtime.
-
-**Solution**: Runtime capability discovery with automatic refresh.
-
-```yaml
-capabilities:
-  discovery:
-    enabled: true
-    registry: agent-mesh
-    refresh_interval: 60s
-```
-
-**Impact**: Agents adapt to infrastructure changes automatically.
-
----
-
-### 8. Feedback & Learning Loops 📈
-
-**Problem**: Agents need mechanisms to learn from feedback.
-
-**Solution**: Native feedback tools and learning strategies.
-
-```yaml
-feedback:
-  tools:
-    - name: record_feedback
-    - name: get_feedback_summary
-    - name: suggest_improvements
-  learning:
-    enabled: true
-    strategy: reinforcement
-    model_fine_tuning:
-      enabled: true
-```
-
-**Impact**: Continuous agent improvement over time.
-
----
-
-### 9. Infrastructure Substrate 🏗️
-
-**Problem**: Infrastructure should be agent-addressable.
-
-**Solution**: Infrastructure agents with capability declarations.
-
-```yaml
-infrastructure:
-  - type: synology_nas
-    hostname: blueflynas.tailcf98b3.ts.net
-    capabilities:
-      - store_artifact
-      - manage_checkpoints
-```
-
-**Impact**: Infrastructure-aware agent deployment and resource optimization.
-
----
-
-### 10. Enhanced A2A Protocol 📡
-
-**Problem**: A2A protocol needs completion signals and checkpoint sync.
-
-**Solution**: Enhanced message types for production workflows.
-
-```yaml
-communication:
-  a2a:
-    enabled: true
-    completion_signals: true
-    checkpoint_sync: true
-```
-
-**Impact**: Production-ready agent-to-agent communication.
-
----
-
-## COMPARISON: OSSA vs Other Standards
-
-| Feature | OSSA v0.3.5 | MCP | AGENTS.md | A2A | OpenAPI |
-|---------|-------------|-----|-----------|-----|---------|
-| **Agent Manifests** | ✅ Native | ❌ | ✅ | ❌ | ❌ |
-| **Completion Signals** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **Checkpointing** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **MoE Support** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **Flow Orchestration** | ✅ Native | ❌ | ❌ | Partial | ❌ |
-| **Metrics Framework** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **Infrastructure** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **Learning Loops** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **Framework Bridges** | ✅ 20+ | ❌ | ❌ | ❌ | ❌ |
-
-**OSSA v0.3.5 is the only specification that combines all these capabilities.**
-
----
-
-## ADOPTION PATH
-
-### For Framework Developers
-
-```yaml
-# Export OSSA to your framework
-adaptors:
-  langgraph:
-    export: true
-  temporal:
-    export: true
-  n8n:
-    export: true
-```
-
-### For Platform Builders
-
-```yaml
-# Use OSSA as your agent registry format
-apiVersion: ossa/v0.3.5
-kind: Agent
-metadata:
-  name: my-agent
-spec:
-  # All v0.3.5 features available
-```
-
-### For Agent Developers
-
-```yaml
-# Write agents in OSSA, deploy anywhere
-apiVersion: ossa/v0.3.5
-kind: Agent
-spec:
-  completion:
-    default_signal: complete
-  checkpointing:
-    enabled: true
-  experts:
-    registry: [...]
-```
-
----
-
-## MIGRATION FROM v0.3.4
-
-See [MIGRATION-v0.3.4-to-v0.3.5.md](./MIGRATION-v0.3.4-to-v0.3.5.md) for complete migration guide.
-
-**Quick Start**:
-1. Update `apiVersion` to `ossa/v0.3.5`
-2. Add `completion` section (optional but recommended)
-3. Enable `checkpointing` for long-running agents
-4. Add `experts` registry for MoE support
-5. Configure `moe` metrics for performance tracking
-
----
-
-## EXAMPLES
-
-- [forward-thinking-agent.ossa.yaml](./examples/forward-thinking-agent.ossa.yaml) - Comprehensive example with all features
-- [moe-example.ossa.yaml](./examples/moe-example.ossa.yaml) - Mixture of Experts usage
-- [flow-example.ossa.yaml](./examples/flow-example.ossa.yaml) - Flow-based orchestration
-- [checkpoint-example.ossa.yaml](./examples/checkpoint-example.ossa.yaml) - Session checkpointing
-
----
-
-## SCHEMA FILES
-
-All schemas are available in JSON Schema format:
-
-- [completion-signals.schema.json](./completion-signals.schema.json)
-- [checkpoint.schema.json](./checkpoint.schema.json)
-- [mixture-of-experts.schema.json](./mixture-of-experts.schema.json)
-- [bat-framework.schema.json](./bat-framework.schema.json)
-- [moe-metrics.schema.json](./moe-metrics.schema.json)
-- [flow-kind.schema.json](./flow-kind.schema.json)
-- [capability-discovery.schema.json](./capability-discovery.schema.json)
-- [feedback-loops.schema.json](./feedback-loops.schema.json)
-- [infrastructure-substrate.schema.json](./infrastructure-substrate.schema.json)
-
----
-
-## SUCCESS METRICS
-
-By Q3 2026:
-- **50+ agents** using v0.3.5 features
-- **100% compatibility** with LangGraph, Temporal, n8n
-- **30% improvement** in agent autonomy rate
-- **Cost optimization** via MoE intelligent model selection
-- **99% session recovery** success rate
-
----
-
-## RELATED DOCUMENTS
-
-- [ENHANCEMENT-PLAN.md](./ENHANCEMENT-PLAN.md) - Complete enhancement plan
-- [MIGRATION-v0.3.4-to-v0.3.5.md](./MIGRATION-v0.3.4-to-v0.3.5.md) - Migration guide
-- [v0.3.4 Documentation](../v0.3.4/) - Previous version
-
----
-
-## CONTRIBUTING
-
-OSSA v0.3.5 is designed to be **the OpenAPI for Software Agents**. We welcome contributions that:
-
-1. Enhance interoperability
-2. Improve production readiness
-3. Add framework bridges
-4. Expand capability coverage
-
-**Join us in making OSSA the definitive agent specification.**
-
----
-
-**OSSA v0.3.5: The Next OpenAPI for Software Agents** 🚀

package/dist/spec/v0.3/adoption-blockers.json

@@ -1,142 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "version": "0.3.5",
-  "status": "stable",
-  "release_candidate": "0.3.5",
-  "stable_release_blocked": false,
-  "blockers": {
-    "kagent_extension_schema": {
-      "status": "done",
-      "description": "Kagent extension schema for GitLab Kubernetes Agents - CRITICAL",
-      "deliverables": [
-        "spec/v0.3/extensions/kagent/kagent.schema.json",
-        "src/services/validators/kagent.validator.ts",
-        "spec/v0.3/extensions/kagent/README.md",
-        "24 unit tests (all passing)",
-        "CI validation job (validate:kagent-examples)",
-        "6 production-ready examples",
-        "gitlab-kagent conformance profile"
-      ],
-      "completed_date": "2026-01-15",
-      "importance": "CRITICAL - GitLab Kubernetes Agent integration is the anchor enterprise use case"
-    },
-    "kagent_validator": {
-      "status": "done",
-      "description": "Kagent extension validator with CI gates - CRITICAL",
-      "deliverables": [
-        "src/services/validators/kagent.validator.ts",
-        "Integration into ValidationService",
-        "24 comprehensive unit tests",
-        "CI pipeline validation",
-        "All 6 examples validated successfully"
-      ],
-      "completed_date": "2026-01-15"
-    },
-    "public_registry_mvp": {
-      "status": "done",
-      "description": "Public agent registry for discovery and publishing",
-      "deliverables": [
-        "src/services/registry/bundle.service.ts",
-        "src/services/registry/index.service.ts",
-        "src/cli/commands/catalog/search.command.ts",
-        "src/cli/commands/catalog/info.command.ts",
-        "Enhanced publish command with bundling",
-        "2 example agents in registry",
-        "Integration tests"
-      ],
-      "completed_date": "2026-01-15"
-    },
-    "langchain_migrator": {
-      "status": "done",
-      "description": "LangChain → OSSA migration tool",
-      "deliverables": [
-        "src/services/migration/langchain-migration.service.ts",
-        "src/cli/commands/migrate-langchain.command.ts",
-        "4 complete migration examples (Python, TypeScript, Config)",
-        "Migration reports with confidence scoring",
-        "Comprehensive test suite"
-      ],
-      "completed_date": "2026-01-15"
-    },
-    "framework_extension_schemas": {
-      "status": "done",
-      "description": "Convert framework markdown docs to JSON schemas",
-      "target_frameworks": [
-        "MCP (Model Context Protocol)",
-        "A2A (Agent-to-Agent)",
-        "LangChain / LangGraph",
-        "AutoGen / AG2",
-        "CrewAI"
-      ],
-      "deliverables": [
-        "spec/v0.3/extensions/mcp/mcp.schema.json + validator",
-        "spec/v0.3/extensions/a2a/a2a.schema.json + validator",
-        "spec/v0.3/extensions/langchain/langchain.schema.json + enhanced validator",
-        "spec/v0.3/extensions/langgraph/langgraph.schema.json + enhanced validator",
-        "spec/v0.3/extensions/ag2/ag2.schema.json + enhanced validator",
-        "spec/v0.3/extensions/crewai/crewai.schema.json + enhanced validator",
-        "Examples and documentation for MCP and A2A"
-      ],
-      "completed_date": "2026-01-15"
-    },
-    "conformance_suite": {
-      "status": "done",
-      "description": "Conformance test suite for Linux Foundation adoption",
-      "deliverables": [
-        "src/services/conformance/conformance.service.ts",
-        "src/cli/commands/conformance.command.ts",
-        "spec/v0.3/conformance/profiles/ (baseline, enterprise, gitlab-kagent)",
-        "8+ test fixtures",
-        "75+ unit tests",
-        "CI jobs configuration",
-        "Complete documentation"
-      ],
-      "completed_date": "2026-01-15"
-    }
-  },
-  "milestones": {
-    "A": {
-      "name": "Kagent Extension Schema + Validation - CRITICAL",
-      "status": "done",
-      "completed_date": "2026-01-15",
-      "importance": "CRITICAL - Anchor enterprise integration for GitLab"
-    },
-    "B": {
-      "name": "Registry MVP",
-      "status": "done",
-      "completed_date": "2026-01-15"
-    },
-    "C": {
-      "name": "LangChain Migrator",
-      "status": "done",
-      "completed_date": "2026-01-15"
-    },
-    "D": {
-      "name": "Framework Extension Schemas",
-      "status": "done",
-      "completed_date": "2026-01-15"
-    },
-    "E": {
-      "name": "Conformance Suite",
-      "status": "done",
-      "completed_date": "2026-01-15"
-    }
-  },
-  "ci_gates": {
-    "block_stable_release": {
-      "enabled": false,
-      "description": "All adoption blockers complete - stable release unblocked",
-      "job_name": "validate:adoption-blockers"
-    }
-  },
-  "release_notes": {
-    "headline": "OSSA v0.3.5 - Enterprise-Ready with GitLab Kagent Integration",
-    "key_highlights": [
-      "KAGENT EXTENSION: Complete GitLab Kubernetes Agent integration (CRITICAL)",
-      "Registry MVP: Agent discovery and publishing",
-      "LangChain Migrator: Seamless migration from LangChain",
-      "6 Framework Extensions: MCP, A2A, LangChain, LangGraph, AG2, CrewAI",
-      "Conformance Suite: Linux Foundation adoption ready"
-    ]
-  }
-}

package/dist/spec/v0.3/bat-framework.schema.json

@@ -1,114 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.3.5/bat-framework.json",
-  "title": "OSSA v0.3.5 BAT (Best Available Technology) Framework",
-  "description": "Systematic technology selection framework for agents",
-  "type": "object",
-  "definitions": {
-    "BATDimension": {
-      "type": "object",
-      "required": ["dimension", "options"],
-      "properties": {
-        "dimension": {
-          "type": "string",
-          "examples": ["reasoning_depth", "multimodal", "cost_sensitivity", "latency", "throughput"]
-        },
-        "required": {
-          "type": "boolean",
-          "default": true
-        },
-        "options": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["value"],
-            "properties": {
-              "value": {
-                "type": "string"
-              },
-              "technologies": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Compatible technologies"
-              },
-              "cost_tier": {
-                "type": "string",
-                "enum": ["economy", "standard", "premium"]
-              },
-              "constraints": {
-                "type": "object",
-                "additionalProperties": true
-              }
-            }
-          }
-        }
-      }
-    },
-    "BATDecisionProcess": {
-      "type": "object",
-      "properties": {
-        "steps": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["step", "description"],
-            "properties": {
-              "step": {
-                "type": "string",
-                "examples": ["evaluate_requirements", "compare_technologies", "select_best_fit", "document_rationale"]
-              },
-              "description": {
-                "type": "string"
-              },
-              "automated": {
-                "type": "boolean",
-                "default": false
-              }
-            }
-          }
-        }
-      }
-    },
-    "BATFramework": {
-      "type": "object",
-      "properties": {
-        "selection_criteria": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/BATDimension"
-          }
-        },
-        "decision_process": {
-          "$ref": "#/definitions/BATDecisionProcess"
-        },
-        "tools": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "name": {
-                "type": "string",
-                "enum": ["select_technology", "evaluate_requirements", "compare_technologies"]
-              },
-              "description": {
-                "type": "string"
-              },
-              "parameters": {
-                "type": "object",
-                "additionalProperties": true
-              }
-            }
-          }
-        }
-      },
-      "required": ["selection_criteria"]
-    }
-  },
-  "properties": {
-    "bat": {
-      "$ref": "#/definitions/BATFramework"
-    }
-  }
-}