@bluefly/openstandardagents 0.5.1 → 0.5.3

package/dist/adapters/autogen/config-adapter.js

@@ -1,72 +0,0 @@
-/**
- * AutoGen Config-Only Adapter
- *
- * Provides lightweight Microsoft AutoGen agent JSON config.
- * This adapter is registered in the PlatformRegistry so the MCP server
- * can delegate to it instead of using inline conversion logic.
- *
- * SOLID: Single Responsibility - AutoGen config-only export
- */
-import { BaseAdapter } from '../base/adapter.interface.js';
-export class AutogenConfigAdapter extends BaseAdapter {
-    platform = 'autogen';
-    displayName = 'AutoGen';
-    description = 'Microsoft AutoGen agent configuration';
-    status = 'alpha';
-    supportedVersions = ['v0.4'];
-    async export(manifest, _options) {
-        return this.createResult(false, [], 'Use toConfig() for AutoGen export');
-    }
-    getExample() {
-        return {
-            apiVersion: 'ossa/v0.4',
-            kind: 'Agent',
-            metadata: { name: 'autogen-example', version: '1.0.0' },
-            spec: { role: 'Example AutoGen agent' },
-        };
-    }
-    async toConfig(manifest) {
-        const meta = manifest.metadata || { name: 'agent', version: '0.0.0' };
-        const autogenTools = (manifest.spec?.tools || []);
-        const config = {
-            name: meta.name,
-            description: meta.description || '',
-            system_message: manifest.spec?.role || '',
-            llm_config: {
-                config_list: [
-                    {
-                        model: manifest.spec?.llm?.model || 'gpt-4',
-                        api_type: manifest.spec?.llm?.provider === 'anthropic'
-                            ? 'anthropic'
-                            : 'openai',
-                    },
-                ],
-                ...(manifest.spec?.llm?.temperature != null
-                    ? { temperature: manifest.spec.llm.temperature }
-                    : {}),
-                ...(manifest.spec?.llm?.maxTokens != null
-                    ? { max_tokens: manifest.spec.llm.maxTokens }
-                    : {}),
-            },
-            ...(autogenTools.length > 0
-                ? {
-                    tools: autogenTools.map((t) => ({
-                        name: t.name || 'unnamed',
-                        description: t.description || '',
-                        ...(t.inputSchema || t.input_schema
-                            ? { parameters: t.inputSchema || t.input_schema }
-                            : {}),
-                    })),
-                }
-                : {}),
-            metadata: {
-                ossa_version: manifest.apiVersion || 'ossa/v0.4',
-            },
-        };
-        return {
-            config,
-            filename: `${meta.name}.autogen.json`,
-        };
-    }
-}
-//# sourceMappingURL=config-adapter.js.map

package/dist/adapters/base/adapter.interface.d.ts

@@ -1,327 +0,0 @@
-/**
- * Base Adapter Interface for OSSA Export System
- *
- * All platform adapters must implement this interface to provide
- * consistent export functionality across different platforms.
- *
- * SOLID: Interface Segregation Principle - Small, focused interface
- * DRY: Reusable across all platform adapters
- */
-import type { OssaAgent } from '../../types/index.js';
-export type { OssaAgent };
-/**
- * Export result containing generated files
- */
-export interface ExportResult {
-    /**
-     * Platform name (e.g., 'langchain', 'mcp', 'drupal')
-     */
-    platform: string;
-    /**
-     * Export status
-     */
-    success: boolean;
-    /**
-     * Generated files
-     */
-    files: ExportFile[];
-    /**
-     * Export metadata
-     */
-    metadata?: {
-        /**
-         * Time taken to export (ms)
-         */
-        duration?: number;
-        /**
-         * Platform version
-         */
-        version?: string;
-        /**
-         * Warnings during export
-         */
-        warnings?: string[];
-        /**
-         * Whether Claude Skill was included
-         */
-        includeSkill?: boolean;
-        /**
-         * Additional platform-specific metadata
-         */
-        [key: string]: unknown;
-    };
-    /**
-     * Error message if export failed
-     */
-    error?: string;
-}
-/**
- * Exported file
- */
-export interface ExportFile {
-    /**
-     * Relative file path
-     */
-    path: string;
-    /**
-     * File content
-     */
-    content: string;
-    /**
-     * File type
-     */
-    type: 'code' | 'config' | 'documentation' | 'test' | 'other';
-    /**
-     * Programming language or format
-     */
-    language?: string;
-}
-/**
- * Export options
- */
-export interface ExportOptions {
-    /**
-     * Output directory
-     */
-    outputDir?: string;
-    /**
-     * Whether to validate export before generation
-     */
-    validate?: boolean;
-    /**
-     * Whether to include tests
-     */
-    includeTests?: boolean;
-    /**
-     * Whether to include documentation
-     */
-    includeDocs?: boolean;
-    /**
-     * Whether to include Claude Skill (SKILL.md)
-     */
-    includeSkill?: boolean;
-    /**
-     * Platform-specific options
-     */
-    platformOptions?: Record<string, unknown>;
-    /**
-     * Dry run mode - validate only, don't write files
-     */
-    dryRun?: boolean;
-    /**
-     * Master flag: generate full "Perfect Agent" structure.
-     * Enables all include* flags below.
-     */
-    perfectAgent?: boolean;
-    /**
-     * Generate .well-known/agent-card.json for universal agent discovery
-     */
-    includeAgentCard?: boolean;
-    /**
-     * Generate AGENTS.md (AAIF convention, adopted by 60K+ projects)
-     */
-    includeAgentsMd?: boolean;
-    /**
-     * Include multi-agent team scaffolding
-     * (auto-detected from spec.team, spec.swarm, or agentArchitecture.pattern)
-     */
-    includeTeam?: boolean;
-    /**
-     * Generate identity/ with DID document (.well-known/did.json)
-     */
-    includeDID?: boolean;
-    /**
-     * Generate evals/ with CLEAR framework config and golden sets
-     */
-    includeEvals?: boolean;
-    /**
-     * Generate governance/ with compliance, policies, audit config
-     */
-    includeGovernance?: boolean;
-    /**
-     * Generate observability/ with OTel traces, metrics, dashboards
-     */
-    includeObservability?: boolean;
-}
-/**
- * Adapter maturity status
- */
-export type AdapterStatus = 'production' | 'beta' | 'alpha' | 'planned';
-/**
- * Lightweight config-only export result.
- * Used by MCP tool responses and other contexts where full file scaffolds
- * are too heavy.
- */
-export interface ConfigResult {
-    /**
-     * The converted configuration object (platform-specific JSON)
-     */
-    config: Record<string, unknown>;
-    /**
-     * Suggested filename for the config (e.g. 'agent.kagent.yaml')
-     */
-    filename: string;
-}
-/**
- * Platform Adapter Interface
- *
- * All export adapters must implement this interface
- */
-export interface PlatformAdapter {
-    /**
-     * Platform identifier (unique)
-     */
-    readonly platform: string;
-    /**
-     * Platform display name
-     */
-    readonly displayName: string;
-    /**
-     * Platform description
-     */
-    readonly description: string;
-    /**
-     * Adapter maturity status — honest reporting of readiness
-     */
-    readonly status: AdapterStatus;
-    /**
-     * Supported OSSA versions
-     */
-    readonly supportedVersions: string[];
-    /**
-     * Export manifest to platform-specific format
-     *
-     * @param manifest - OSSA agent manifest
-     * @param options - Export options
-     * @returns Export result with generated files
-     */
-    export(manifest: OssaAgent, options?: ExportOptions): Promise<ExportResult>;
-    /**
-     * Validate manifest can be exported to this platform
-     *
-     * @param manifest - OSSA agent manifest
-     * @returns Validation result
-     */
-    validate(manifest: OssaAgent): Promise<ValidationResult>;
-    /**
-     * Get example manifest for this platform
-     *
-     * @returns Example OSSA manifest optimized for this platform
-     */
-    getExample(): OssaAgent;
-    /**
-     * Produce a lightweight JSON config suitable for MCP tool responses.
-     * Unlike export() which generates full multi-file project scaffolds,
-     * toConfig() returns a single JSON object representing the platform config.
-     *
-     * @param manifest - OSSA agent manifest
-     * @returns Lightweight config result with config object and suggested filename
-     */
-    toConfig(manifest: OssaAgent): Promise<ConfigResult>;
-}
-/**
- * Validation result
- */
-export interface ValidationResult {
-    /**
-     * Whether manifest is valid for this platform
-     */
-    valid: boolean;
-    /**
-     * Validation errors
-     */
-    errors?: ValidationError[];
-    /**
-     * Validation warnings
-     */
-    warnings?: ValidationWarning[];
-}
-/**
- * Validation error
- */
-export interface ValidationError {
-    /**
-     * Error message
-     */
-    message: string;
-    /**
-     * JSON path to error location (e.g., 'spec.llm.model')
-     */
-    path?: string;
-    /**
-     * Error code
-     */
-    code?: string;
-}
-/**
- * Validation warning
- */
-export interface ValidationWarning {
-    /**
-     * Warning message
-     */
-    message: string;
-    /**
-     * JSON path to warning location
-     */
-    path?: string;
-    /**
-     * Suggestion for fixing warning
-     */
-    suggestion?: string;
-    /**
-     * Warning code
-     */
-    code?: string;
-}
-/**
- * Base adapter implementation with common functionality
- */
-export declare abstract class BaseAdapter implements PlatformAdapter {
-    abstract readonly platform: string;
-    abstract readonly displayName: string;
-    abstract readonly description: string;
-    abstract readonly status: AdapterStatus;
-    abstract readonly supportedVersions: string[];
-    abstract export(manifest: OssaAgent, options?: ExportOptions): Promise<ExportResult>;
-    /**
-     * Default validation - checks basic manifest structure
-     */
-    validate(manifest: OssaAgent): Promise<ValidationResult>;
-    /**
-     * Get example manifest - subclasses should override
-     */
-    getExample(): OssaAgent;
-    /**
-     * Helper: Create export result
-     */
-    protected createResult(success: boolean, files: ExportFile[], error?: string, metadata?: ExportResult['metadata']): ExportResult;
-    /**
-     * Helper: Create export file
-     */
-    protected createFile(path: string, content: string, type: ExportFile['type'], language?: string): ExportFile;
-    /**
-     * Helper: Create agent.ossa.yaml manifest file for provenance
-     */
-    protected createManifestFile(manifest: OssaAgent): ExportFile;
-    /**
-     * Default toConfig() — throws unless overridden by the adapter.
-     * Adapters that support lightweight config-only export should override this.
-     */
-    toConfig(manifest: OssaAgent): Promise<ConfigResult>;
-    /**
-     * Resolve effective options: if perfectAgent is set, enable all flags.
-     */
-    protected resolvePerfectAgentOptions(options?: ExportOptions): ExportOptions;
-    /**
-     * Detect if manifest defines a multi-agent system
-     */
-    isMultiAgent(manifest: OssaAgent): boolean;
-    /**
-     * Generate all "perfect agent" supplementary files.
-     * Called by adapters when ExportOptions.perfectAgent is true.
-     * Delegates to generatePerfectAgentBundle() in common-file-generator.
-     */
-    generatePerfectAgentFiles(manifest: OssaAgent, options?: ExportOptions): ExportFile[];
-}
-//# sourceMappingURL=adapter.interface.d.ts.map

package/dist/adapters/base/adapter.interface.js

@@ -1,138 +0,0 @@
-/**
- * Base Adapter Interface for OSSA Export System
- *
- * All platform adapters must implement this interface to provide
- * consistent export functionality across different platforms.
- *
- * SOLID: Interface Segregation Principle - Small, focused interface
- * DRY: Reusable across all platform adapters
- */
-import * as yaml from 'yaml';
-import { isMultiAgentManifest } from '../../services/multi-agent/team-generator.service.js';
-import { generatePerfectAgentBundle } from './common-file-generator.js';
-/**
- * Base adapter implementation with common functionality
- */
-export class BaseAdapter {
-    /**
-     * Default validation - checks basic manifest structure
-     */
-    async validate(manifest) {
-        const errors = [];
-        const warnings = [];
-        // Check required fields
-        if (!manifest.metadata?.name) {
-            errors.push({
-                message: 'metadata.name is required',
-                path: 'metadata.name',
-                code: 'MISSING_REQUIRED_FIELD',
-            });
-        }
-        if (!manifest.metadata?.version) {
-            errors.push({
-                message: 'metadata.version is required',
-                path: 'metadata.version',
-                code: 'MISSING_REQUIRED_FIELD',
-            });
-        }
-        if (!manifest.spec?.role) {
-            warnings.push({
-                message: 'spec.role is recommended for better agent behavior',
-                path: 'spec.role',
-                suggestion: 'Add a system prompt describing the agent role',
-            });
-        }
-        return {
-            valid: errors.length === 0,
-            errors: errors.length > 0 ? errors : undefined,
-            warnings: warnings.length > 0 ? warnings : undefined,
-        };
-    }
-    /**
-     * Get example manifest - subclasses should override
-     */
-    getExample() {
-        return {
-            apiVersion: 'ossa/v{{VERSION}}',
-            kind: 'Agent',
-            metadata: {
-                name: 'example-agent',
-                version: '1.0.0',
-                description: 'Example agent for ' + this.displayName,
-            },
-            spec: {
-                role: 'Example agent role',
-            },
-        };
-    }
-    /**
-     * Helper: Create export result
-     */
-    createResult(success, files, error, metadata) {
-        return {
-            platform: this.platform,
-            success,
-            files,
-            error,
-            metadata,
-        };
-    }
-    /**
-     * Helper: Create export file
-     */
-    createFile(path, content, type, language) {
-        return {
-            path,
-            content,
-            type,
-            language,
-        };
-    }
-    /**
-     * Helper: Create agent.ossa.yaml manifest file for provenance
-     */
-    createManifestFile(manifest) {
-        return this.createFile('agent.ossa.yaml', yaml.stringify(manifest), 'config', 'yaml');
-    }
-    /**
-     * Default toConfig() — throws unless overridden by the adapter.
-     * Adapters that support lightweight config-only export should override this.
-     */
-    async toConfig(manifest) {
-        throw new Error(`toConfig() is not implemented for platform "${this.platform}". ` +
-            `Use export() for full file scaffold export.`);
-    }
-    // ── Perfect Agent Export ─────────────────────────────────────────
-    /**
-     * Resolve effective options: if perfectAgent is set, enable all flags.
-     */
-    resolvePerfectAgentOptions(options) {
-        const opts = { ...options };
-        if (opts.perfectAgent) {
-            opts.includeAgentCard ??= true;
-            opts.includeAgentsMd ??= true;
-            opts.includeDID ??= true;
-            opts.includeEvals ??= true;
-            opts.includeGovernance ??= true;
-            opts.includeObservability ??= true;
-            opts.includeSkill ??= true;
-            opts.includeTeam ??= true;
-        }
-        return opts;
-    }
-    /**
-     * Detect if manifest defines a multi-agent system
-     */
-    isMultiAgent(manifest) {
-        return isMultiAgentManifest(manifest);
-    }
-    /**
-     * Generate all "perfect agent" supplementary files.
-     * Called by adapters when ExportOptions.perfectAgent is true.
-     * Delegates to generatePerfectAgentBundle() in common-file-generator.
-     */
-    generatePerfectAgentFiles(manifest, options) {
-        return generatePerfectAgentBundle(manifest, options);
-    }
-}
-//# sourceMappingURL=adapter.interface.js.map

package/dist/adapters/base/base-exporter.d.ts

@@ -1,108 +0,0 @@
-/**
- * Base Exporter - Abstract class for export orchestration
- *
- * Extracts the common export pattern shared across all platform adapters:
- * 1. Start timing
- * 2. Validate manifest (optional, based on options)
- * 3. Generate platform-specific files (delegated to subclass)
- * 4. Return result with timing metadata
- * 5. Catch and wrap errors
- *
- * This eliminates ~53% duplication across adapters by centralizing:
- * - Export method boilerplate (validation, timing, error handling)
- * - Validate method boilerplate (base + platform-specific merge)
- * - Common file generation (package.json, tsconfig.json, README)
- *
- * SOLID: Template Method pattern - subclasses provide platform-specific logic
- * DRY: All orchestration boilerplate lives here, not in each adapter
- */
-import { BaseAdapter } from './adapter.interface.js';
-import type { OssaAgent, ExportOptions, ExportResult, ExportFile, ValidationResult, ValidationError, ValidationWarning } from './adapter.interface.js';
-import { type PackageJsonOptions, type TsConfigOptions, type ReadmeSections } from './common-file-generator.js';
-/**
- * Abstract Base Exporter
- *
- * Subclasses implement:
- * - generateFiles() - platform-specific file generation
- * - platformValidate() - platform-specific validation rules
- * - getExportVersion() - version string for metadata
- *
- * The base class handles:
- * - Export orchestration (timing, validation, error handling)
- * - Manifest provenance file generation
- * - Common file helpers (package.json, tsconfig, README, gitignore)
- */
-export declare abstract class BaseExporter extends BaseAdapter {
-    /**
-     * Generate platform-specific files from the manifest.
-     * This is the core method subclasses must implement.
-     *
-     * @param manifest - Validated OSSA agent manifest
-     * @param options - Export options
-     * @returns Array of generated files
-     */
-    protected abstract generateFiles(manifest: OssaAgent, options?: ExportOptions): Promise<ExportFile[]>;
-    /**
-     * Platform-specific validation rules.
-     * Called after base validation. Override to add platform checks.
-     *
-     * @param manifest - OSSA agent manifest
-     * @returns Object with arrays of errors and warnings
-     */
-    protected platformValidate(manifest: OssaAgent): {
-        errors: ValidationError[];
-        warnings: ValidationWarning[];
-    };
-    /**
-     * Get the export adapter version for metadata.
-     * Override to provide a specific version string.
-     */
-    protected getExportVersion(): string;
-    /**
-     * Export OSSA manifest to platform-specific format.
-     * Orchestrates: validate -> generate -> wrap result with timing.
-     *
-     * Subclasses do NOT need to override this. Implement generateFiles() instead.
-     */
-    export(manifest: OssaAgent, options?: ExportOptions): Promise<ExportResult>;
-    /**
-     * Validate manifest for platform compatibility.
-     * Merges base validation with platform-specific rules.
-     *
-     * Subclasses do NOT need to override this. Implement platformValidate() instead.
-     */
-    validate(manifest: OssaAgent): Promise<ValidationResult>;
-    /**
-     * Generate a package.json file using shared generator
-     */
-    protected generatePackageJsonFile(manifest: OssaAgent, prefix: string, options?: PackageJsonOptions): ExportFile;
-    /**
-     * Generate a tsconfig.json file using shared generator
-     */
-    protected generateTsConfigFile(prefix: string, options?: TsConfigOptions): ExportFile;
-    /**
-     * Generate a README.md file using shared generator
-     */
-    protected generateReadmeFile(manifest: OssaAgent, prefix: string, sections?: ReadmeSections): ExportFile;
-    /**
-     * Generate a .gitignore file using shared generator
-     */
-    protected generateGitIgnoreFile(prefix: string): ExportFile;
-    /**
-     * Helper: Get the agent name from manifest with fallback
-     */
-    protected getAgentName(manifest: OssaAgent, fallback?: string): string;
-    /**
-     * Helper: Get the agent description from manifest
-     */
-    protected getAgentDescription(manifest: OssaAgent): string;
-    /**
-     * Helper: Extract tools array from manifest
-     */
-    protected getTools(manifest: OssaAgent): Array<Record<string, unknown>>;
-    /**
-     * Helper: Extract capabilities array from manifest (as strings)
-     */
-    protected getCapabilities(manifest: OssaAgent): string[];
-}
-//# sourceMappingURL=base-exporter.d.ts.map