@bluefly/openstandardagents 0.4.4 → 0.4.5

package/dist/services/agent-protocol-client.js

@@ -1,166 +0,0 @@
-/**
- * Agent Protocol Client Service
- *
- * HTTP client for communicating with the Agent Protocol API.
- * Implements OSSA CLI registry commands for agent registration and discovery.
- */
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-import axios from 'axios';
-import { injectable, unmanaged } from 'inversify';
-/**
- * Agent Protocol Client Service
- *
- * Provides methods for interacting with the Agent Protocol API:
- * - Register agents to the global registry
- * - Search for agents by query and filters
- * - Retrieve agent details by GAID
- * - Resolve DIDs to agent manifests
- */
-let AgentProtocolClient = class AgentProtocolClient {
-    client;
-    baseURL;
-    constructor(config) {
-        this.baseURL = config?.baseURL || 'https://api.blueflyagents.com';
-        this.client = axios.create({
-            baseURL: this.baseURL,
-            timeout: config?.timeout || 30000,
-            headers: {
-                'Content-Type': 'application/json',
-                ...(config?.apiKey && { Authorization: `Bearer ${config.apiKey}` }),
-            },
-        });
-        // Add response interceptor for error handling
-        this.client.interceptors.response.use((response) => response, (error) => {
-            return Promise.reject(this.formatError(error));
-        });
-    }
-    /**
-     * Register an agent to the global registry
-     *
-     * Accepts comprehensive AgentCard with full identity, trust, and operational information.
-     * Agents are treated as first-class citizens with complete credentials and provenance.
-     *
-     * @param manifest - OSSA agent manifest
-     * @param card - Comprehensive agent identity card (with identity, trust, runtime, compliance)
-     * @returns Registration response with GAID
-     * @throws Error if registration fails
-     *
-     * @example
-     * ```typescript
-     * const card: AgentCard = {
-     *   gaid: 'ag-001-code-reviewer',
-     *   name: 'Code Review Agent',
-     *   version: '1.0.0',
-     *   identity: {
-     *     serialNumber: 'AG-0001-0001',
-     *     publicKey: '-----BEGIN PUBLIC KEY-----...',
-     *     trustScore: 95,
-     *     trustTier: 'verified',
-     *     issuer: 'BlueFly.io Platform',
-     *   },
-     *   created: new Date().toISOString(),
-     *   modified: new Date().toISOString(),
-     *   registeredAt: new Date().toISOString(),
-     * };
-     * const response = await client.registerAgent(manifest, card);
-     * ```
-     */
-    async registerAgent(manifest, card) {
-        try {
-            const response = await this.client.post('/api/v1/agents', {
-                manifest,
-                card,
-            });
-            return response.data;
-        }
-        catch (error) {
-            throw new Error(`Agent registration failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    /**
-     * Search for agents in the registry
-     *
-     * @param query - Search query and filters
-     * @returns Search results with matching agents
-     */
-    async searchAgents(query) {
-        try {
-            const response = await this.client.post('/api/v1/agents/search', query);
-            return response.data;
-        }
-        catch (error) {
-            throw new Error(`Agent search failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    /**
-     * Get agent details by GAID
-     *
-     * @param gaid - Global Agent ID
-     * @returns Agent card and manifest
-     */
-    async getAgent(gaid) {
-        try {
-            const response = await this.client.get(`/api/v1/agents/${gaid}`);
-            return response.data;
-        }
-        catch (error) {
-            throw new Error(`Failed to get agent ${gaid}: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    /**
-     * Resolve DID to agent manifest
-     *
-     * @param gaid - Global Agent ID (or DID)
-     * @returns DID document with agent manifest
-     */
-    async resolveDID(gaid) {
-        try {
-            const response = await this.client.get(`/api/v1/dids/${gaid}`);
-            return response.data;
-        }
-        catch (error) {
-            throw new Error(`DID resolution failed for ${gaid}: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    /**
-     * Format axios error to user-friendly message
-     *
-     * @param error - Axios error
-     * @returns Formatted error
-     */
-    formatError(error) {
-        if (error.response) {
-            // Server responded with error status
-            const status = error.response.status;
-            const data = error.response.data;
-            const message = data?.error || data?.message || error.response.statusText;
-            return new Error(`HTTP ${status}: ${message}`);
-        }
-        else if (error.request) {
-            // Request made but no response
-            return new Error(`No response from server at ${this.baseURL}. Check network connection.`);
-        }
-        else {
-            // Error setting up request
-            return new Error(`Request setup failed: ${error.message}`);
-        }
-    }
-};
-AgentProtocolClient = __decorate([
-    injectable(),
-    __param(0, unmanaged()),
-    __metadata("design:paramtypes", [Object])
-], AgentProtocolClient);
-export { AgentProtocolClient };
-//# sourceMappingURL=agent-protocol-client.js.map

package/dist/services/agent-protocol-client.js.map

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

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

@@ -1,237 +0,0 @@
-# OSSA v0.3.5 Changelog
-
-**Release Date**: TBD (Q2 2026)  
-**Status**: Design Phase
-
----
-
-## 🚀 Major Features
-
-### 1. Completion Signals
-
-**Added**: Standardized agent termination conditions
-
-- Five signal types: `continue`, `complete`, `blocked`, `escalate`, `checkpoint`
-- Conditional signal configuration
-- Integration with workflow orchestration
-
-**Breaking Changes**: None (optional feature)
-
-**Migration**: Add `completion` section to agent spec (optional)
-
----
-
-### 2. Session Checkpointing
-
-**Added**: Resilient state management with pause/resume
-
-- Automatic checkpoint creation
-- Checkpoint storage backends (agent-brain, s3, local)
-- Session recovery support
-- Retention policies
-
-**Breaking Changes**: None (optional feature)
-
-**Migration**: Add `checkpointing` section to agent spec (optional)
-
----
-
-### 3. Mixture of Experts (MoE)
-
-**Added**: Agent-controlled expert model selection
-
-- Expert registry configuration
-- Selection strategies (agent_controlled, cost_optimized, capability_match, hybrid)
-- Expert tools (list_experts, invoke_expert, get_expert_history)
-- Cost tier classification
-
-**Breaking Changes**: None (optional extension)
-
-**Migration**: Add `extensions.experts` section (optional)
-
----
-
-### 4. BAT Framework
-
-**Added**: Best Available Technology selection framework
-
-- Multi-dimensional selection criteria
-- Technology comparison
-- Decision process documentation
-- Audit trail support
-
-**Breaking Changes**: None (optional extension)
-
-**Migration**: Add `extensions.bat` section (optional)
-
----
-
-### 5. MOE Metrics
-
-**Added**: Measure of Effectiveness metrics framework
-
-- Primary, secondary, and operational metrics
-- Metric collection configuration
-- Dashboard integration
-- Alert thresholds
-
-**Breaking Changes**: None (optional extension)
-
-**Migration**: Add `extensions.moe` section (optional)
-
----
-
-### 6. Flow Kind
-
-**Added**: Native flow-based orchestration
-
-- Flow state machines
-- Transitions and triggers
-- Flow events
-- Framework adaptors (LangGraph, Temporal, n8n)
-
-**Breaking Changes**: None (new kind, doesn't affect existing agents)
-
-**Migration**: Create new Flow manifests (no migration needed)
-
----
-
-### 7. Capability Discovery
-
-**Added**: Runtime capability discovery
-
-- Dynamic capability registration
-- Registry backends (agent-mesh, mcp-registry, local)
-- Context injection
-- Recent activity tracking
-
-**Breaking Changes**: None (optional extension)
-
-**Migration**: Add `extensions.capabilities` section (optional)
-
----
-
-### 8. Feedback Loops
-
-**Added**: Continuous improvement mechanisms
-
-- Feedback recording tools
-- Feedback aggregation
-- Learning strategies (reinforcement, supervised, unsupervised)
-- Model fine-tuning integration
-
-**Breaking Changes**: None (optional extension)
-
-**Migration**: Add `extensions.feedback` section (optional)
-
----
-
-### 9. Infrastructure Substrate
-
-**Added**: Infrastructure as agent-addressable resources
-
-- Infrastructure agent definitions
-- Capability declarations
-- Resource monitoring
-- Lifecycle management
-
-**Breaking Changes**: None (optional feature)
-
-**Migration**: Add `infrastructure` section (optional)
-
----
-
-### 10. Enhanced A2A Protocol
-
-**Added**: Production-ready agent-to-agent communication
-
-- Completion signal messages
-- Checkpoint sync messages
-- Expert invocation messages
-- Enhanced message types
-
-**Breaking Changes**: None (backward compatible)
-
-**Migration**: No migration needed (automatic)
-
----
-
-## 📊 Statistics
-
-- **New Definitions**: 30+
-- **New Extensions**: 9
-- **New Examples**: 4
-- **Backward Compatibility**: 100%
-- **Schema Size**: ~10,000 lines
-
----
-
-## 🔧 Tooling
-
-### New CLI Commands
-
-- `ossa v0.3.5 validate` - Validate v0.3.5 features
-- `ossa v0.3.5 migrate` - Migrate v0.3.4 → v0.3.5
-- `ossa v0.3.5 example` - Generate example agents
-- `ossa v0.3.5 features` - List available features
-
-### New NPM Scripts
-
-- `npm run validate:v0.3.5` - Validate v0.3.5 features
-- `npm run validate:v0.3.5:examples` - Validate examples
-- `npm run test:v0.3.5` - Run v0.3.5 tests
-- `npm run gen:v0.3.5:schema` - Generate merged schema
-- `npm run docs:v0.3.5` - Generate documentation
-
----
-
-## 📚 Documentation
-
-- [README.md](./README.md) - Feature overview
-- [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
-- [POSITIONING.md](./POSITIONING.md) - Market positioning
-- [PRODUCTION-DEPLOYMENT.md](./PRODUCTION-DEPLOYMENT.md) - Deployment guide
-- [docs/FEATURES.md](./docs/FEATURES.md) - Feature documentation
-- [docs/API-REFERENCE.md](./docs/API-REFERENCE.md) - API reference
-
----
-
-## 🧪 Testing
-
-### Test Coverage
-
-- Unit tests for all v0.3.5 features
-- Integration tests for backward compatibility
-- Example validation tests
-- Schema validation tests
-
-### Test Commands
-
-```bash
-npm run test:v0.3.5
-npm run validate:v0.3.5:examples
-```
-
----
-
-## 🎯 Success Metrics
-
-By Q3 2026:
-- **50+ agents** using v0.3.5 features
-- **100% compatibility** with LangGraph, Temporal, n8n
-- **Improved** agent autonomy rate through enhanced capabilities
-- **Cost optimization** via MoE intelligent model selection
-- **99% session recovery** success rate
-
----
-
-## 🔗 Related
-
-- [v0.3.4 Changelog](../v0.3.4/CHANGELOG.md)
-- [GitHub Releases](https://github.com/blueflyio/openstandardagents/releases)
-- [OpenStandardAgents.org](https://openstandardagents.org)
-
----
-
-**OSSA v0.3.5: The Next OpenAPI for Software Agents** 🚀

package/dist/spec/v0.3/MIGRATION-v0.3.4-to-v0.3.5.md

@@ -1,292 +0,0 @@
-# Migration Guide: OSSA v0.3.4 → v0.3.5
-
-**Target Audience**: Agent developers, platform builders, framework maintainers
-
----
-
-## OVERVIEW
-
-OSSA v0.3.5 introduces **10 major enhancements** that transform the specification into the definitive OpenAPI for Software Agents. This guide helps you migrate existing agents and adopt new features.
-
----
-
-## BREAKING CHANGES
-
-**None**. OSSA v0.3.5 is **100% backward compatible** with v0.3.4. All new features are optional extensions.
-
----
-
-## MIGRATION STEPS
-
-### Step 1: Update API Version
-
-```yaml
-# Before (v0.3.4)
-apiVersion: ossa/v0.3.4
-
-# After (v0.3.5)
-apiVersion: ossa/v0.3.5
-```
-
-### Step 2: Add Completion Signals (Recommended)
-
-**Why**: Enables intelligent workflow orchestration.
-
-```yaml
-# Add to spec section
-spec:
-  completion:
-    default_signal: complete
-    signals:
-      - signal: continue
-        condition: "iteration_count < max_iterations"
-      - signal: blocked
-        condition: "confidence < 0.5"
-    max_iterations: 10
-```
-
-**Impact**: Orchestrators can make intelligent decisions about workflow progression.
-
----
-
-### Step 3: Enable Checkpointing (For Long-Running Agents)
-
-**Why**: Enables fault tolerance and cost optimization.
-
-```yaml
-# Add to spec section
-spec:
-  checkpointing:
-    enabled: true
-    interval: iteration
-    interval_value: 5
-    storage:
-      backend: agent-brain
-```
-
-**Impact**: Agents can pause/resume, reducing costs and improving reliability.
-
----
-
-### Step 4: Add MoE Extension (For Cost Optimization)
-
-**Why**: 30% cost reduction via intelligent expert selection.
-
-```yaml
-# Add to extensions section
-extensions:
-  experts:
-    registry:
-      - id: reasoning-expert
-        model:
-          provider: anthropic
-          model: claude-opus-4-5-20251101
-        specializations: [complex_reasoning, planning]
-        cost_tier: premium
-      - id: speed-expert
-        model:
-          provider: google
-          model: gemini-2.0-flash
-        specializations: [quick_responses]
-        cost_tier: economy
-    selection_strategy: agent_controlled
-```
-
-**Impact**: Agents can select optimal experts based on task requirements.
-
----
-
-### Step 5: Configure MOE Metrics (For Performance Tracking)
-
-**Why**: Data-driven agent improvement.
-
-```yaml
-# Add to extensions section
-extensions:
-  moe:
-    primary:
-      metric: review_accuracy
-      target: 0.95
-      measurement:
-        type: ratio
-        numerator: approved_reviews_without_issues
-        denominator: total_reviews
-    secondary:
-      - metric: review_latency_p95
-        target: 600
-        unit: seconds
-    operational:
-      - metric: uptime
-        target: 0.999
-```
-
-**Impact**: Standardized performance evaluation and improvement tracking.
-
----
-
-### Step 6: Add BAT Framework (For Technology Selection)
-
-**Why**: Consistent, auditable technology selection.
-
-```yaml
-# Add to extensions section
-extensions:
-  bat:
-    selection_criteria:
-      - dimension: reasoning_depth
-        required: true
-        options:
-          - value: deep
-            technologies: [claude-opus, gpt-4-turbo]
-            cost_tier: premium
-          - value: balanced
-            technologies: [claude-sonnet, gpt-4o]
-            cost_tier: standard
-```
-
-**Impact**: Systematic technology selection with audit trail.
-
----
-
-### Step 7: Enable Capability Discovery (For Runtime Adaptation)
-
-**Why**: Agents adapt to infrastructure changes automatically.
-
-```yaml
-# Add to extensions section
-extensions:
-  capabilities:
-    discovery:
-      enabled: true
-      registry: agent-mesh
-      refresh_interval: 60s
-```
-
-**Impact**: Agents discover new capabilities at runtime.
-
----
-
-### Step 8: Add Feedback Loops (For Learning)
-
-**Why**: Continuous agent improvement.
-
-```yaml
-# Add to extensions section
-extensions:
-  feedback:
-    tools:
-      - name: record_feedback
-      - name: get_feedback_summary
-      - name: suggest_improvements
-    learning:
-      enabled: true
-      strategy: reinforcement
-```
-
-**Impact**: Agents learn from feedback and improve over time.
-
----
-
-## MIGRATION CHECKLIST
-
-### Basic Migration (Minimal Changes)
-
-- [ ] Update `apiVersion` to `ossa/v0.3.5`
-- [ ] Test agent still works (backward compatibility)
-- [ ] Update documentation
-
-### Recommended Migration (Adopt Key Features)
-
-- [ ] Add `completion` signals
-- [ ] Enable `checkpointing` (if long-running)
-- [ ] Add `moe` metrics
-- [ ] Configure `experts` registry (if cost-sensitive)
-
-### Full Migration (All Features)
-
-- [ ] Add all extensions (MoE, BAT, MOE, Capabilities, Feedback)
-- [ ] Configure infrastructure substrate
-- [ ] Add Flow kind support
-- [ ] Enable enhanced A2A protocol
-
----
-
-## EXAMPLE: Minimal Migration
-
-```yaml
-# Before (v0.3.4)
-apiVersion: ossa/v0.3.4
-kind: Agent
-metadata:
-  name: my-agent
-spec:
-  identity:
-    id: "@my-agent"
-  llm:
-    provider: anthropic
-    model: claude-sonnet-4
-
-# After (v0.3.5) - Minimal
-apiVersion: ossa/v0.3.5
-kind: Agent
-metadata:
-  name: my-agent
-spec:
-  identity:
-    id: "@my-agent"
-  llm:
-    provider: anthropic
-    model: claude-sonnet-4
-  completion:
-    default_signal: complete
-```
-
-**That's it!** Your agent is now v0.3.5 compatible.
-
----
-
-## EXAMPLE: Full Migration
-
-See [forward-thinking-agent.ossa.yaml](./examples/forward-thinking-agent.ossa.yaml) for a complete example with all v0.3.5 features.
-
----
-
-## VALIDATION
-
-After migration, validate your agent:
-
-```bash
-# Validate schema
-ossa validate my-agent.ossa.yaml
-
-# Check for v0.3.5 features
-ossa validate --version 0.3.5 my-agent.ossa.yaml
-
-# Test backward compatibility
-ossa validate --version 0.3.4 my-agent.ossa.yaml
-```
-
----
-
-## ROLLBACK PLAN
-
-If you encounter issues:
-
-1. **Revert API version**: Change `apiVersion` back to `ossa/v0.3.4`
-2. **Remove extensions**: Comment out new extension sections
-3. **Test**: Verify agent works with v0.3.4 runtime
-
-**Note**: v0.3.5 agents are backward compatible with v0.3.4 runtimes (new features ignored).
-
----
-
-## SUPPORT
-
-- **Documentation**: [README.md](./README.md)
-- **Examples**: [examples/](./examples/)
-- **Schema Files**: [*.schema.json](./)
-- **Enhancement Plan**: [ENHANCEMENT-PLAN.md](./ENHANCEMENT-PLAN.md)
-
----
-
-**Migration is optional but recommended. Start with minimal changes and adopt features incrementally.**