@bluefly/openstandardagents 0.3.6 → 0.4.1

package/dist/services/validation/best-practices-validator.js

@@ -0,0 +1,499 @@
+/**
+ * Best Practices Validator
+ * Checks OSSA manifests against best practices and recommendations
+ *
+ * SOLID: Single Responsibility - Only handles best practices validation
+ * DRY: Centralized best practices rules
+ */
+/**
+ * Best Practices Validator Service
+ */
+export class BestPracticesValidator {
+    /**
+     * Validate best practices for an agent manifest
+     */
+    validate(manifest) {
+        const issues = [];
+        // Metadata checks
+        issues.push(...this.checkMetadata(manifest));
+        // LLM configuration checks
+        issues.push(...this.checkLLMConfig(manifest));
+        // Tools and capabilities checks
+        issues.push(...this.checkTools(manifest));
+        // Autonomy checks
+        issues.push(...this.checkAutonomy(manifest));
+        // Constraints checks
+        issues.push(...this.checkConstraints(manifest));
+        // Observability checks
+        issues.push(...this.checkObservability(manifest));
+        // Runtime checks
+        issues.push(...this.checkRuntime(manifest));
+        // Messaging checks (v0.3.0+)
+        issues.push(...this.checkMessaging(manifest));
+        // Calculate score
+        const score = this.calculateScore(issues);
+        return {
+            score,
+            issues,
+            passed: score >= 80,
+        };
+    }
+    /**
+     * Check metadata completeness
+     */
+    checkMetadata(manifest) {
+        const issues = [];
+        const metadata = manifest.metadata;
+        if (!metadata) {
+            issues.push({
+                severity: 'error',
+                category: 'metadata',
+                message: 'Missing metadata section',
+                path: 'metadata',
+                recommendation: 'Add metadata with name, version, and description.',
+            });
+            return issues;
+        }
+        // Check description
+        if (!metadata.description ||
+            (typeof metadata.description === 'string' &&
+                metadata.description.trim().length === 0)) {
+            issues.push({
+                severity: 'warning',
+                category: 'metadata',
+                message: 'Missing or empty description',
+                path: 'metadata.description',
+                recommendation: 'Add a clear description explaining the agent purpose and capabilities.',
+            });
+        }
+        else if (typeof metadata.description === 'string' &&
+            metadata.description.length < 20) {
+            issues.push({
+                severity: 'info',
+                category: 'metadata',
+                message: 'Description is too short',
+                path: 'metadata.description',
+                recommendation: 'Provide a detailed description (at least 20 characters) for better documentation.',
+            });
+        }
+        // Check version
+        if (!metadata.version) {
+            issues.push({
+                severity: 'warning',
+                category: 'metadata',
+                message: 'Missing version',
+                path: 'metadata.version',
+                recommendation: 'Add version following semantic versioning (e.g., "1.0.0").',
+            });
+        }
+        // Check author
+        if (!metadata.author) {
+            issues.push({
+                severity: 'info',
+                category: 'metadata',
+                message: 'Missing author information',
+                path: 'metadata.author',
+                recommendation: 'Add author for better maintainability.',
+            });
+        }
+        // Check tags
+        if (!metadata.tags || metadata.tags.length === 0) {
+            issues.push({
+                severity: 'info',
+                category: 'metadata',
+                message: 'No tags defined',
+                path: 'metadata.tags',
+                recommendation: 'Add tags for better discoverability (e.g., ["chatbot", "customer-service"]).',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check LLM configuration
+     */
+    checkLLMConfig(manifest) {
+        const issues = [];
+        const llm = manifest.spec?.llm || manifest.agent?.llm;
+        if (!llm) {
+            issues.push({
+                severity: 'error',
+                category: 'llm',
+                message: 'Missing LLM configuration',
+                path: 'spec.llm',
+                recommendation: 'Specify LLM provider, model, and parameters for predictable behavior.',
+            });
+            return issues;
+        }
+        // Check provider and model
+        if (!llm.provider) {
+            issues.push({
+                severity: 'error',
+                category: 'llm',
+                message: 'Missing LLM provider',
+                path: 'spec.llm.provider',
+                recommendation: 'Specify provider (e.g., "openai", "anthropic", "google").',
+            });
+        }
+        if (!llm.model) {
+            issues.push({
+                severity: 'error',
+                category: 'llm',
+                message: 'Missing LLM model',
+                path: 'spec.llm.model',
+                recommendation: 'Specify model (e.g., "gpt-4o-mini", "claude-sonnet-4").',
+            });
+        }
+        // Check temperature
+        if (llm.temperature === undefined) {
+            issues.push({
+                severity: 'warning',
+                category: 'llm',
+                message: 'Temperature not set',
+                path: 'spec.llm.temperature',
+                recommendation: 'Set temperature (0.0-1.0) for consistent behavior. Use 0.1 for deterministic, 0.7 for creative.',
+            });
+        }
+        else if (llm.temperature < 0 || llm.temperature > 1) {
+            issues.push({
+                severity: 'error',
+                category: 'llm',
+                message: 'Temperature out of range',
+                path: 'spec.llm.temperature',
+                recommendation: 'Temperature must be between 0.0 and 1.0.',
+            });
+        }
+        // Check maxTokens
+        if (!llm.maxTokens) {
+            issues.push({
+                severity: 'warning',
+                category: 'llm',
+                message: 'maxTokens not set',
+                path: 'spec.llm.maxTokens',
+                recommendation: 'Set maxTokens to control response length and costs (e.g., 1000-4000).',
+            });
+        }
+        else if (llm.maxTokens > 8000) {
+            issues.push({
+                severity: 'info',
+                category: 'llm',
+                message: 'maxTokens is very high',
+                path: 'spec.llm.maxTokens',
+                recommendation: 'Consider reducing maxTokens to optimize costs and latency.',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check tools configuration
+     */
+    checkTools(manifest) {
+        const issues = [];
+        const tools = manifest.spec?.tools || manifest.agent?.tools || [];
+        if (tools.length === 0) {
+            issues.push({
+                severity: 'warning',
+                category: 'tools',
+                message: 'No tools defined',
+                path: 'spec.tools',
+                recommendation: 'Define tools/capabilities for the agent to use (e.g., MCP servers, APIs).',
+            });
+            return issues;
+        }
+        // Check each tool
+        for (let i = 0; i < tools.length; i++) {
+            const tool = tools[i];
+            const basePath = `spec.tools[${i}]`;
+            // Check name
+            if (!tool.name) {
+                issues.push({
+                    severity: 'warning',
+                    category: 'tools',
+                    message: `Tool at index ${i} has no name`,
+                    path: `${basePath}.name`,
+                    recommendation: 'Add descriptive name for each tool.',
+                });
+            }
+            // Check description
+            if (!tool.description) {
+                issues.push({
+                    severity: 'info',
+                    category: 'tools',
+                    message: `Tool "${tool.name || i}" has no description`,
+                    path: `${basePath}.description`,
+                    recommendation: 'Add description explaining what the tool does and when to use it.',
+                });
+            }
+            // Check schema definitions
+            if (tool.type === 'mcp' || tool.type === 'api') {
+                if (!tool.inputSchema && !tool.outputSchema) {
+                    issues.push({
+                        severity: 'info',
+                        category: 'tools',
+                        message: `Tool "${tool.name || i}" has no input/output schemas`,
+                        path: basePath,
+                        recommendation: 'Define inputSchema and outputSchema for better type safety.',
+                    });
+                }
+            }
+        }
+        return issues;
+    }
+    /**
+     * Check autonomy configuration
+     */
+    checkAutonomy(manifest) {
+        const issues = [];
+        const autonomy = manifest.spec?.autonomy;
+        if (!autonomy) {
+            issues.push({
+                severity: 'warning',
+                category: 'autonomy',
+                message: 'No autonomy configuration',
+                path: 'spec.autonomy',
+                recommendation: 'Define autonomy level and approval requirements for safety.',
+            });
+            return issues;
+        }
+        // Check level
+        if (!autonomy.level) {
+            issues.push({
+                severity: 'warning',
+                category: 'autonomy',
+                message: 'Autonomy level not specified',
+                path: 'spec.autonomy.level',
+                recommendation: 'Set level: "supervised", "semi-autonomous", or "autonomous".',
+            });
+        }
+        // Check approval requirements for high autonomy
+        if ((autonomy.level === 'autonomous' || autonomy.level === 'high') &&
+            !autonomy.approval_required) {
+            issues.push({
+                severity: 'warning',
+                category: 'autonomy',
+                message: 'High autonomy without approval requirement',
+                path: 'spec.autonomy',
+                recommendation: 'Enable approval_required for autonomous agents to prevent unwanted actions.',
+            });
+        }
+        // Check allowed/blocked actions
+        if ((!autonomy.allowed_actions || autonomy.allowed_actions.length === 0) &&
+            (!autonomy.blocked_actions || autonomy.blocked_actions.length === 0)) {
+            issues.push({
+                severity: 'info',
+                category: 'autonomy',
+                message: 'No action restrictions defined',
+                path: 'spec.autonomy',
+                recommendation: 'Define allowed_actions or blocked_actions for better control.',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check constraints configuration
+     */
+    checkConstraints(manifest) {
+        const issues = [];
+        const constraints = manifest.spec?.constraints;
+        if (!constraints) {
+            issues.push({
+                severity: 'warning',
+                category: 'constraints',
+                message: 'No constraints configured',
+                path: 'spec.constraints',
+                recommendation: 'Add cost and performance constraints to prevent resource abuse.',
+            });
+            return issues;
+        }
+        // Check cost constraints
+        if (!constraints.cost) {
+            issues.push({
+                severity: 'info',
+                category: 'constraints',
+                message: 'No cost constraints',
+                path: 'spec.constraints.cost',
+                recommendation: 'Set maxTokensPerDay and maxCostPerDay to control spending.',
+            });
+        }
+        else {
+            const cost = constraints.cost;
+            if (!cost.maxTokensPerDay && !cost.maxCostPerDay) {
+                issues.push({
+                    severity: 'info',
+                    category: 'constraints',
+                    message: 'Cost constraints have no limits',
+                    path: 'spec.constraints.cost',
+                    recommendation: 'Set at least maxTokensPerDay or maxCostPerDay.',
+                });
+            }
+        }
+        // Check performance constraints
+        if (!constraints.performance) {
+            issues.push({
+                severity: 'info',
+                category: 'constraints',
+                message: 'No performance constraints',
+                path: 'spec.constraints.performance',
+                recommendation: 'Set maxLatencySeconds and timeoutSeconds for better reliability.',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check observability configuration
+     */
+    checkObservability(manifest) {
+        const issues = [];
+        const observability = manifest.spec?.observability;
+        if (!observability) {
+            issues.push({
+                severity: 'info',
+                category: 'observability',
+                message: 'No observability configured',
+                path: 'spec.observability',
+                recommendation: 'Enable tracing, metrics, and logging for production monitoring.',
+            });
+            return issues;
+        }
+        // Check tracing
+        if (!observability.tracing?.enabled) {
+            issues.push({
+                severity: 'info',
+                category: 'observability',
+                message: 'Tracing not enabled',
+                path: 'spec.observability.tracing',
+                recommendation: 'Enable tracing for debugging and performance analysis.',
+            });
+        }
+        // Check metrics
+        if (!observability.metrics?.enabled) {
+            issues.push({
+                severity: 'info',
+                category: 'observability',
+                message: 'Metrics not enabled',
+                path: 'spec.observability.metrics',
+                recommendation: 'Enable metrics for monitoring agent performance and health.',
+            });
+        }
+        // Check logging
+        if (!observability.logging?.level) {
+            issues.push({
+                severity: 'info',
+                category: 'observability',
+                message: 'Logging level not set',
+                path: 'spec.observability.logging.level',
+                recommendation: 'Set logging level (debug, info, warn, error) for better diagnostics.',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check runtime configuration
+     */
+    checkRuntime(manifest) {
+        const issues = [];
+        const runtime = manifest.agent?.runtime;
+        if (!runtime) {
+            return issues;
+        }
+        // Check resource limits
+        const resources = manifest.spec?.constraints?.resources;
+        if (!resources) {
+            issues.push({
+                severity: 'info',
+                category: 'runtime',
+                message: 'No resource limits configured',
+                path: 'spec.constraints.resources',
+                recommendation: 'Set CPU and memory limits for containerized deployments.',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check messaging configuration (v0.3.0+)
+     */
+    checkMessaging(manifest) {
+        const issues = [];
+        const messaging = manifest.spec?.messaging;
+        if (!messaging) {
+            return issues;
+        }
+        // Check publishes channels
+        const publishes = messaging.publishes || [];
+        for (let i = 0; i < publishes.length; i++) {
+            const channel = publishes[i];
+            const basePath = `spec.messaging.publishes[${i}]`;
+            if (!channel.description) {
+                issues.push({
+                    severity: 'info',
+                    category: 'messaging',
+                    message: `Published channel "${channel.channel}" has no description`,
+                    path: `${basePath}.description`,
+                    recommendation: 'Add description for better documentation.',
+                });
+            }
+            if (!channel.examples || channel.examples.length === 0) {
+                issues.push({
+                    severity: 'info',
+                    category: 'messaging',
+                    message: `Published channel "${channel.channel}" has no examples`,
+                    path: `${basePath}.examples`,
+                    recommendation: 'Add examples showing message format.',
+                });
+            }
+        }
+        // Check subscribes channels
+        const subscribes = messaging.subscribes || [];
+        for (let i = 0; i < subscribes.length; i++) {
+            const sub = subscribes[i];
+            const basePath = `spec.messaging.subscribes[${i}]`;
+            if (!sub.handler) {
+                issues.push({
+                    severity: 'warning',
+                    category: 'messaging',
+                    message: `Subscription to "${sub.channel}" has no handler`,
+                    path: `${basePath}.handler`,
+                    recommendation: 'Specify handler function to process incoming messages.',
+                });
+            }
+        }
+        // Check reliability
+        if (!messaging.reliability) {
+            issues.push({
+                severity: 'info',
+                category: 'messaging',
+                message: 'No messaging reliability configuration',
+                path: 'spec.messaging.reliability',
+                recommendation: 'Configure delivery guarantees and retry policy for production.',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Calculate score based on issues
+     */
+    calculateScore(issues) {
+        let score = 100;
+        const severityPenalties = {
+            error: 15,
+            warning: 8,
+            info: 3,
+        };
+        for (const issue of issues) {
+            score -= severityPenalties[issue.severity];
+        }
+        return Math.max(0, score);
+    }
+    /**
+     * Get issues by severity
+     */
+    getBySeverity(issues, severity) {
+        return issues.filter((i) => i.severity === severity);
+    }
+    /**
+     * Get issues by category
+     */
+    getByCategory(issues, category) {
+        return issues.filter((i) => i.category === category);
+    }
+}
+//# sourceMappingURL=best-practices-validator.js.map

package/dist/services/validation/best-practices-validator.js.map

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

package/dist/services/validation/cost-estimator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Cost Estimator
+ * Estimates runtime costs for OSSA agents based on LLM provider, model, and usage
+ *
+ * SOLID: Single Responsibility - Only handles cost estimation
+ * DRY: Centralized pricing data and calculation logic
+ */
+import type { OssaAgent } from '../../types/index.js';
+/**
+ * Cost estimate result
+ */
+export interface CostEstimate {
+    provider: string;
+    model: string;
+    estimatedDailyCost: number;
+    estimatedMonthlyCost: number;
+    breakdown: {
+        inputCost: number;
+        outputCost: number;
+        requestsPerDay: number;
+        tokensPerRequest: {
+            input: number;
+            output: number;
+        };
+    };
+    recommendations: string[];
+    currency: string;
+}
+/**
+ * Cost Estimator Service
+ */
+export declare class CostEstimator {
+    /**
+     * Estimate costs for an agent manifest
+     */
+    estimate(manifest: OssaAgent): CostEstimate;
+    /**
+     * Extract LLM configuration from manifest
+     */
+    private extractLLMConfig;
+    /**
+     * Normalize provider name
+     */
+    private normalizeProvider;
+    /**
+     * Normalize model name
+     */
+    private normalizeModel;
+    /**
+     * Get pricing for provider and model
+     */
+    private getPricing;
+    /**
+     * Estimate usage from manifest
+     */
+    private estimateUsage;
+    /**
+     * Generate cost optimization recommendations
+     */
+    private generateRecommendations;
+    /**
+     * Compare costs between different models
+     */
+    compareCosts(manifest: OssaAgent, alternativeModels: Array<{
+        provider: string;
+        model: string;
+    }>): Array<CostEstimate>;
+}
+//# sourceMappingURL=cost-estimator.d.ts.map

package/dist/services/validation/cost-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../../../src/services/validation/cost-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAyDtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,YAAY;IAqC3C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;OAEG;IACH,YAAY,CACV,QAAQ,EAAE,SAAS,EACnB,iBAAiB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAC5D,KAAK,CAAC,YAAY,CAAC;CAkBvB"}