@bluefly/openstandardagents 0.2.9 → 0.3.0

package/dist/cli/commands/validate.command.js

@@ -0,0 +1,143 @@
+/**
+ * OSSA Validate Command
+ * Validate OSSA agent manifest against JSON schema
+ */
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { container } from '../../di-container.js';
+import { ManifestRepository } from '../../repositories/manifest.repository.js';
+import { ValidationService } from '../../services/validation.service.js';
+import { formatValidationErrors, formatErrorCompact } from '../utils/error-formatter.js';
+export const validateCommand = new Command('validate')
+    .argument('<path>', 'Path to OSSA manifest or OpenAPI spec (YAML or JSON)')
+    .option('-s, --schema <version>', 'Schema version to validate against. If not specified, auto-detects from manifest apiVersion. (0.3.0, 0.2.9, 0.2.8, 0.2.6, 0.2.5, 0.2.3, 0.2.2, or 1.0)')
+    .option('--openapi', 'Validate as OpenAPI specification with OSSA extensions')
+    .option('--check-messaging', 'Validate messaging extension (v0.3.0+)')
+    .option('-v, --verbose', 'Verbose output with detailed information')
+    .description('Validate OSSA agent manifest or OpenAPI spec against JSON schema')
+    .action(async (path, options) => {
+    try {
+        // Get services from DI container
+        const manifestRepo = container.get(ManifestRepository);
+        const validationService = container.get(ValidationService);
+        // Load file
+        if (options.openapi) {
+            console.log(chalk.blue(`Validating OpenAPI spec with OSSA extensions: ${path}`));
+        }
+        else {
+            console.log(chalk.blue(`Validating OSSA agent: ${path}`));
+        }
+        const manifest = await manifestRepo.load(path);
+        // Validate
+        let result;
+        if (options.openapi) {
+            result = await validationService.validateOpenAPIExtensions(manifest);
+        }
+        else {
+            result = await validationService.validate(manifest, options.schema);
+        }
+        // Output results
+        if (result.valid) {
+            if (options.openapi) {
+                console.log(chalk.green('✓ OpenAPI spec is valid with OSSA extensions'));
+            }
+            else {
+                // Extract version from result manifest or use provided option
+                const m = result.manifest;
+                const detectedVersion = m?.apiVersion?.replace('ossa/', '') || options.schema || 'unknown';
+                console.log(chalk.green('✓ Agent manifest is valid OSSA ' + detectedVersion));
+            }
+            if (options.verbose && result.manifest) {
+                console.log(chalk.gray('\nAgent Details:'));
+                const m = result.manifest;
+                if (m.apiVersion) {
+                    console.log(`  Name: ${chalk.cyan(m.metadata?.name || 'unknown')}`);
+                    console.log(`  Version: ${chalk.cyan(m.metadata?.version || 'unknown')}`);
+                    console.log(`  Role: ${chalk.cyan(m.spec?.role || 'unknown')}`);
+                }
+                else if (m.agent) {
+                    console.log(`  ID: ${chalk.cyan(m.agent.id)}`);
+                    console.log(`  Name: ${chalk.cyan(m.agent.name)}`);
+                    console.log(`  Version: ${chalk.cyan(m.agent.version)}`);
+                    console.log(`  Role: ${chalk.cyan(m.agent.role)}`);
+                }
+                if (m.spec) {
+                    if (m.spec.tools) {
+                        console.log(`  Tools: ${chalk.cyan(m.spec.tools.length)}`);
+                    }
+                    if (m.spec.llm) {
+                        console.log(`  LLM: ${chalk.cyan(m.spec.llm.provider)} / ${chalk.cyan(m.spec.llm.model)}`);
+                    }
+                }
+                if (m.spec?.messaging) {
+                    console.log(chalk.gray('\nMessaging Configuration:'));
+                    if (m.spec.messaging.publishes) {
+                        console.log(`  Publishes: ${chalk.cyan(m.spec.messaging.publishes.length)} channel(s)`);
+                        m.spec.messaging.publishes.forEach((ch) => {
+                            console.log(`    - ${chalk.cyan(ch.channel)}`);
+                        });
+                    }
+                    if (m.spec.messaging.subscribes) {
+                        console.log(`  Subscribes: ${chalk.cyan(m.spec.messaging.subscribes.length)} channel(s)`);
+                        m.spec.messaging.subscribes.forEach((sub) => {
+                            console.log(`    - ${chalk.cyan(sub.channel)}`);
+                        });
+                    }
+                    if (m.spec.messaging.commands) {
+                        console.log(`  Commands: ${chalk.cyan(m.spec.messaging.commands.length)}`);
+                        m.spec.messaging.commands.forEach((cmd) => {
+                            console.log(`    - ${chalk.cyan(cmd.name)}`);
+                        });
+                    }
+                }
+                if (m.agent?.capabilities) {
+                    console.log(`  Capabilities: ${chalk.cyan(m.agent.capabilities.length)}`);
+                }
+                if (m.agent?.runtime) {
+                    console.log(`  Runtime: ${chalk.cyan(m.agent.runtime.type)}`);
+                }
+                if (m.agent?.llm) {
+                    console.log(`  LLM: ${chalk.cyan(m.agent.llm.provider)} / ${chalk.cyan(m.agent.llm.model)}`);
+                }
+                if (m.extensions) {
+                    const extensions = Object.keys(m.extensions);
+                    console.log(`  Extensions: ${chalk.cyan(extensions.join(', '))}`);
+                }
+            }
+            // Show warnings if any
+            if (result.warnings.length > 0) {
+                console.log(chalk.yellow('\n⚠  Warnings (Best Practices):'));
+                result.warnings.forEach((warning) => {
+                    console.log(chalk.yellow(`  - ${warning}`));
+                });
+            }
+            process.exit(0);
+        }
+        else {
+            // Use the new error formatter for better error messages
+            if (options.verbose) {
+                // Detailed, helpful error messages with manifest context
+                console.error(formatValidationErrors(result.errors, manifest));
+            }
+            else {
+                // Compact error messages
+                console.error(chalk.red.bold('\n✗ Validation Failed'));
+                console.error(chalk.red(`Found ${result.errors.length} error(s):\n`));
+                result.errors.forEach((error, index) => {
+                    console.error(formatErrorCompact(error, index, manifest));
+                });
+                console.error(chalk.gray('\nUse --verbose for detailed error information'));
+                console.error(chalk.blue('📚 Docs: https://openstandardagents.org/docs\n'));
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        if (options.verbose && error instanceof Error) {
+            console.error(chalk.gray(error.stack));
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=validate.command.js.map

package/dist/cli/commands/validate.command.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * OSSA CLI - Open Standard for Scalable AI Agents
+ * Main CLI entry point
+ */
+import 'reflect-metadata';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * OSSA CLI - Open Standard for Scalable AI Agents
+ * Main CLI entry point
+ */
+import 'reflect-metadata';
+import { program } from 'commander';
+import { validateCommand } from './commands/validate.command.js';
+import { generateCommand } from './commands/generate.command.js';
+import { migrateCommand } from './commands/migrate.command.js';
+import { initCommand } from './commands/init.command.js';
+import { exportCommand } from './commands/export.command.js';
+import { importCommand } from './commands/import.command.js';
+import { schemaCommand } from './commands/schema.command.js';
+import { runCommand } from './commands/run.command.js';
+import { gitlabAgentCommand } from './commands/gitlab-agent.command.js';
+import { releaseCommandGroup } from './commands/release.command.js';
+import { setupCommand } from './commands/setup.command.js';
+import { syncCommand } from './commands/sync.command.js';
+import { agentsMdCommand } from './commands/agents-md.command.js';
+import { quickstartCommand } from './commands/quickstart.command.js';
+import { dependenciesCommand } from './commands/dependencies.command.js';
+import { contractCommand } from './commands/contract.command.js';
+import { publishCommand } from './commands/publish.command.js';
+import { searchCommand } from './commands/search.command.js';
+import { installCommand } from './commands/install.command.js';
+import { infoCommand } from './commands/info.command.js';
+import { deployGroup } from './commands/deploy.command.js';
+import { testCommand } from './commands/test.command.js';
+import { deployCommand, statusCommand, rollbackCommand, stopCommand, } from './commands/deploy.js';
+// Load package.json for version (lazy to avoid Jest module resolution issues)
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Get version dynamically from package.json
+ * Uses multiple strategies to find package.json reliably
+ */
+function getVersion() {
+    // Try multiple strategies to find package.json
+    // Strategy 1: Relative to this file (for built dist)
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const relativePath = path.resolve(__dirname, '../../package.json');
+    if (fs.existsSync(relativePath)) {
+        try {
+            const content = fs.readFileSync(relativePath, 'utf-8');
+            const pkg = JSON.parse(content);
+            if (pkg.version)
+                return pkg.version;
+        }
+        catch {
+            // Fall through to next strategy
+        }
+    }
+    // Strategy 2: From current working directory
+    const cwdPath = path.resolve(process.cwd(), 'package.json');
+    if (fs.existsSync(cwdPath)) {
+        try {
+            const content = fs.readFileSync(cwdPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            if (pkg.version)
+                return pkg.version;
+        }
+        catch {
+            // Fall through to next strategy
+        }
+    }
+    // Strategy 3: Search upward from cwd
+    let current = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.resolve(current, 'package.json');
+        if (fs.existsSync(candidate)) {
+            try {
+                const content = fs.readFileSync(candidate, 'utf-8');
+                const pkg = JSON.parse(content);
+                if (pkg.version)
+                    return pkg.version;
+            }
+            catch {
+                // Continue searching
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break; // Reached root
+        current = parent;
+    }
+    // Strategy 4: Environment variable
+    if (process.env.OSSA_VERSION) {
+        return process.env.OSSA_VERSION;
+    }
+    // Ultimate fallback - read from spec directory names
+    try {
+        const specDir = path.resolve(__dirname, '../../spec');
+        if (fs.existsSync(specDir)) {
+            const dirs = fs
+                .readdirSync(specDir)
+                .filter((d) => d.startsWith('v'))
+                .sort((a, b) => b.localeCompare(a, undefined, { numeric: true }));
+            if (dirs.length > 0) {
+                return dirs[0].slice(1); // Remove 'v' prefix
+            }
+        }
+    }
+    catch {
+        // Ignore
+    }
+    // Should never reach here if package.json exists
+    throw new Error('Unable to determine OSSA version. Ensure package.json exists.');
+}
+program
+    .name('ossa')
+    .description('OSSA CLI - Open Standard for Scalable AI Agents (The OpenAPI for AI Agents)')
+    .version(getVersion());
+// Register commands
+program.addCommand(quickstartCommand); // First for discoverability
+program.addCommand(validateCommand);
+program.addCommand(dependenciesCommand);
+program.addCommand(contractCommand);
+program.addCommand(generateCommand);
+program.addCommand(migrateCommand);
+program.addCommand(initCommand);
+program.addCommand(exportCommand);
+program.addCommand(importCommand);
+program.addCommand(schemaCommand);
+program.addCommand(runCommand);
+program.addCommand(gitlabAgentCommand);
+program.addCommand(releaseCommandGroup);
+program.addCommand(setupCommand);
+program.addCommand(syncCommand);
+program.addCommand(agentsMdCommand);
+// Registry commands
+program.addCommand(publishCommand);
+program.addCommand(searchCommand);
+program.addCommand(installCommand);
+program.addCommand(infoCommand);
+// Register new enhanced deploy commands
+program.addCommand(deployCommand);
+program.addCommand(statusCommand);
+program.addCommand(rollbackCommand);
+program.addCommand(stopCommand);
+// Register legacy deploy group for backward compatibility
+program.addCommand(deployGroup);
+program.addCommand(testCommand);
+// Parse arguments - MUST be after all commands are registered
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/utils/error-formatter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error Formatter for OSSA CLI
+ * Transforms AJV validation errors into helpful, actionable error messages
+ * Inspired by professional tools like npm, cargo, rustc
+ */
+import type { ErrorObject } from 'ajv';
+/**
+ * Format multiple validation errors into a helpful error message
+ */
+export declare function formatValidationErrors(errors: ErrorObject[], manifest?: unknown): string;
+/**
+ * Create a helpful suggestion based on manifest content
+ */
+export declare function suggestFix(manifest: unknown, error: ErrorObject): string | null;
+/**
+ * Format a single error for compact output (non-verbose)
+ */
+export declare function formatErrorCompact(error: ErrorObject, index: number, manifest?: unknown): string;
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/cli/utils/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/error-formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AA8QvC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAyBxF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAsC/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAyBhG"}