@bluefly/openstandardagents 0.4.2 → 0.4.4

package/dist/interfaces/governance-provider.interface.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Governance Provider Interface
+ *
+ * Defines the contract that all governance providers must implement.
+ * Enables pluggable governance systems (Cedar, OPA, custom).
+ *
+ * Implementation-agnostic: providers can be Cedar, OPA, or custom logic.
+ *
+ * API-FIRST COMPLIANCE:
+ * These types MUST match the compliance-engine OpenAPI spec:
+ * - openapi/cedar-provider.openapi.yaml
+ *
+ * TODO: Generate these types from compliance-engine's published OpenAPI spec
+ * using openapi-typescript once compliance-engine publishes @bluefly/compliance-engine-types
+ *
+ * For now, these types are manually kept in sync with the OpenAPI spec
+ * defined in CEDAR_GOVERNANCE_IMPLEMENTATION_PLAN.md
+ */
+export interface GovernanceProvider {
+    /**
+     * Provider metadata
+     */
+    name: string;
+    version: string;
+    /**
+     * Check if agent configuration meets governance requirements
+     */
+    checkCompliance(config: GovernanceConfig): Promise<ComplianceResult>;
+    /**
+     * Authorize an agent action
+     */
+    authorize(request: AuthorizationRequest): Promise<AuthorizationResult>;
+    /**
+     * Evaluate quality gate for deployment
+     */
+    evaluateQualityGate(request: QualityGateRequest): Promise<QualityGateResult>;
+}
+/**
+ * Governance configuration from agent manifest
+ */
+export interface GovernanceConfig {
+    authorization?: {
+        clearance_level?: number;
+        tool_permissions?: ToolPermission[];
+        policy_references?: string[];
+    };
+    quality_requirements?: {
+        confidence_threshold?: number;
+        test_coverage_threshold?: number;
+        security_score_threshold?: number;
+        max_vulnerability_count?: number;
+    };
+    compliance?: {
+        frameworks?: ('SOC2' | 'HIPAA' | 'GDPR' | 'PCI-DSS')[];
+        data_classification?: 'public' | 'internal' | 'confidential' | 'restricted';
+        audit_logging_required?: boolean;
+    };
+}
+export interface ToolPermission {
+    tool: string;
+    risk_level: 'low' | 'medium' | 'high' | 'critical';
+    requires_approval?: boolean;
+}
+export interface ComplianceResult {
+    compliant: boolean;
+    issues: string[];
+    warnings: string[];
+}
+export interface AuthorizationRequest {
+    agent: string;
+    action: string;
+    resource: string;
+    context?: Record<string, any>;
+}
+export interface AuthorizationResult {
+    decision: 'ALLOW' | 'DENY';
+    reason?: string;
+    diagnostics?: {
+        policies_evaluated?: string[];
+        errors?: string[];
+    };
+}
+export interface QualityGateRequest {
+    pipeline_id?: string;
+    environment: 'production' | 'staging' | 'development';
+    metrics: {
+        test_coverage: number;
+        security_score: number;
+        confidence_score: number;
+        vulnerability_count: number;
+    };
+}
+export interface QualityGateResult {
+    decision: 'PASS' | 'FAIL';
+    blocked_by?: string[];
+    policy_decision?: AuthorizationResult;
+}
+//# sourceMappingURL=governance-provider.interface.d.ts.map

package/dist/interfaces/governance-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-provider.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/governance-provider.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErE;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEvE;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;QACpC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IACF,oBAAoB,CAAC,EAAE;QACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,UAAU,CAAC,EAAE;QACX,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;QACvD,mBAAmB,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;QAC5E,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACnD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QACZ,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;IACtD,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC"}

package/dist/interfaces/governance-provider.interface.js

@@ -0,0 +1,20 @@
+/**
+ * Governance Provider Interface
+ *
+ * Defines the contract that all governance providers must implement.
+ * Enables pluggable governance systems (Cedar, OPA, custom).
+ *
+ * Implementation-agnostic: providers can be Cedar, OPA, or custom logic.
+ *
+ * API-FIRST COMPLIANCE:
+ * These types MUST match the compliance-engine OpenAPI spec:
+ * - openapi/cedar-provider.openapi.yaml
+ *
+ * TODO: Generate these types from compliance-engine's published OpenAPI spec
+ * using openapi-typescript once compliance-engine publishes @bluefly/compliance-engine-types
+ *
+ * For now, these types are manually kept in sync with the OpenAPI spec
+ * defined in CEDAR_GOVERNANCE_IMPLEMENTATION_PLAN.md
+ */
+export {};
+//# sourceMappingURL=governance-provider.interface.js.map

package/dist/interfaces/governance-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-provider.interface.js","sourceRoot":"","sources":["../../src/interfaces/governance-provider.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/mesh/advanced-routing.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Advanced Agent Routing
+ * Sophisticated routing logic for agent-to-agent communication
+ *
+ * Features:
+ * - Capability-based routing (find agent with capability X)
+ * - Load balancing across multiple instances
+ * - Health-aware routing (exclude unhealthy agents)
+ * - Geographic routing (nearest agent)
+ * - Priority routing
+ * - Circuit breaker pattern
+ */
+import { AgentCard, MessageEnvelope } from './types.js';
+import { DiscoveryService } from './discovery.js';
+import { AgentGraph } from './agent-graph.js';
+/**
+ * Routing Strategy
+ */
+export type RoutingStrategy = 'round-robin' | 'random' | 'least-connections' | 'least-latency' | 'weighted' | 'geographic' | 'capability-match';
+/**
+ * Load Balancer Interface
+ */
+export interface LoadBalancer {
+    /**
+     * Select an agent from available candidates
+     */
+    select(candidates: AgentCard[], context?: RoutingContext): AgentCard | null;
+    /**
+     * Record routing decision
+     */
+    recordRouting(agentUri: string, success: boolean, latencyMs?: number): void;
+    /**
+     * Get statistics
+     */
+    getStats(): LoadBalancerStats;
+}
+/**
+ * Routing Context
+ */
+export interface RoutingContext {
+    message?: MessageEnvelope;
+    requiredCapabilities?: string[];
+    preferredRegion?: string;
+    excludeAgents?: string[];
+    maxLatencyMs?: number;
+}
+/**
+ * Load Balancer Statistics
+ */
+export interface LoadBalancerStats {
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    avgLatencyMs: number;
+    agentStats: Map<string, {
+        requests: number;
+        successes: number;
+        failures: number;
+        avgLatencyMs: number;
+    }>;
+}
+/**
+ * Round-Robin Load Balancer
+ */
+export declare class RoundRobinLoadBalancer implements LoadBalancer {
+    private currentIndex;
+    private stats;
+    select(candidates: AgentCard[], context?: RoutingContext): AgentCard | null;
+    recordRouting(agentUri: string, success: boolean, latencyMs?: number): void;
+    getStats(): LoadBalancerStats;
+}
+/**
+ * Least Connections Load Balancer
+ */
+export declare class LeastConnectionsLoadBalancer implements LoadBalancer {
+    private connectionTracker;
+    private stats;
+    select(candidates: AgentCard[], context?: RoutingContext): AgentCard | null;
+    recordRouting(agentUri: string, success: boolean, latencyMs?: number): void;
+    getStats(): LoadBalancerStats;
+}
+/**
+ * Weighted Load Balancer
+ * Routes based on agent weights (performance, capacity, etc.)
+ */
+export declare class WeightedLoadBalancer implements LoadBalancer {
+    private stats;
+    select(candidates: AgentCard[], context?: RoutingContext): AgentCard | null;
+    recordRouting(agentUri: string, success: boolean, latencyMs?: number): void;
+    getStats(): LoadBalancerStats;
+}
+/**
+ * Circuit Breaker State
+ */
+type CircuitState = 'closed' | 'open' | 'half-open';
+/**
+ * Circuit Breaker
+ * Prevents cascading failures by temporarily blocking requests to failing agents
+ */
+export declare class CircuitBreaker {
+    private readonly threshold;
+    private readonly timeoutMs;
+    private readonly halfOpenRequests;
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime?;
+    private nextRetryTime?;
+    constructor(threshold?: number, timeoutMs?: number, halfOpenRequests?: number);
+    /**
+     * Check if circuit allows request
+     */
+    allowRequest(): boolean;
+    /**
+     * Record successful request
+     */
+    recordSuccess(): void;
+    /**
+     * Record failed request
+     */
+    recordFailure(): void;
+    /**
+     * Get current state
+     */
+    getState(): CircuitState;
+    /**
+     * Reset circuit breaker
+     */
+    reset(): void;
+}
+/**
+ * Advanced Agent Router
+ * Combines discovery, load balancing, and routing strategies
+ */
+export declare class AdvancedAgentRouter {
+    private loadBalancer;
+    private circuitBreakers;
+    private discovery;
+    private graph?;
+    constructor(config: {
+        discovery: DiscoveryService;
+        loadBalancer?: LoadBalancer;
+        graph?: AgentGraph;
+        circuitBreakerThreshold?: number;
+        circuitBreakerTimeoutMs?: number;
+    });
+    /**
+     * Route message to best agent based on capability
+     */
+    routeByCapability(capability: string, context?: RoutingContext): Promise<AgentCard | null>;
+    /**
+     * Route to multiple agents (broadcast)
+     */
+    routeToMultiple(capability: string, count: number, context?: RoutingContext): Promise<AgentCard[]>;
+    /**
+     * Find nearest agent geographically
+     */
+    routeNearest(capability: string, region: string, context?: RoutingContext): Promise<AgentCard | null>;
+    /**
+     * Record routing result
+     */
+    recordResult(agentUri: string, success: boolean, latencyMs?: number): void;
+    /**
+     * Get load balancer statistics
+     */
+    getStats(): LoadBalancerStats;
+    /**
+     * Get circuit breaker for agent
+     */
+    private getCircuitBreaker;
+    /**
+     * Get all circuit breaker states
+     */
+    getCircuitBreakerStates(): Map<string, CircuitState>;
+    /**
+     * Reset circuit breaker for agent
+     */
+    resetCircuitBreaker(agentUri: string): void;
+}
+export {};
+//# sourceMappingURL=advanced-routing.d.ts.map

package/dist/mesh/advanced-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-routing.d.ts","sourceRoot":"","sources":["../../src/mesh/advanced-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,QAAQ,GACR,mBAAmB,GACnB,eAAe,GACf,UAAU,GACV,YAAY,GACZ,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;IAE5E;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5E;;OAEG;IACH,QAAQ,IAAI,iBAAiB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AA4BD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IACzD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAMX;IAEF,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAkB3E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmC3E,QAAQ,IAAI,iBAAiB;CAG9B;AAED;;GAEG;AACH,qBAAa,4BAA6B,YAAW,YAAY;IAC/D,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,KAAK,CAMX;IAEF,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IA8B3E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAqC3E,QAAQ,IAAI,iBAAiB;CAG9B;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,KAAK,CAMX;IAEF,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAuC3E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmC3E,QAAQ,IAAI,iBAAiB;CAG9B;AAED;;GAEG;AACH,KAAK,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEpD;;;GAGG;AACH,qBAAa,cAAc;IAQvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IATnC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAC,CAAO;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAO;gBAGV,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAc,EACzB,gBAAgB,GAAE,MAAU;IAG/C;;OAEG;IACH,YAAY,IAAI,OAAO;IAmBvB;;OAEG;IACH,aAAa,IAAI,IAAI;IAWrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAarB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,KAAK,CAAC,CAAa;gBAEf,MAAM,EAAE;QAClB,SAAS,EAAE,gBAAgB,CAAC;QAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;QACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC;IAMD;;OAEG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA8C5B;;OAEG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,EAAE,CAAC;IA4BvB;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAyB5B;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAY1E;;OAEG;IACH,QAAQ,IAAI,iBAAiB;IAI7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAWpD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAM5C"}