@bluefly/openstandardagents 0.3.5 → 0.4.0

package/bin/ossa

@@ -2,28 +2,7 @@
 
 /**
  * OSSA CLI Entry Point
- * Enhanced with error handling, version detection, and better UX
+ * Runs the compiled JavaScript from dist/
  */
 
-import { fileURLToPath } from 'url';
-import { dirname, resolve } from 'path';
-import { existsSync } from 'fs';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Try to load compiled CLI
-const cliPath = resolve(__dirname, '../dist/cli/index.js');
-
-if (!existsSync(cliPath)) {
-  console.error('❌ OSSA CLI not built. Run: npm run build');
-  process.exit(1);
-}
-
-try {
-  await import(cliPath);
-} catch (error) {
-  console.error('❌ Failed to load OSSA CLI:');
-  console.error(error);
-  process.exit(1);
-}
+import '../dist/cli/index.js';

package/bin/ossa-dev

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+/**
+ * OSSA Dev CLI Entry Point
+ * Development tools for OSSA maintainers
+ */
+
+import '../dist/dev-cli/index.js';

package/bin/postinstall

@@ -14,7 +14,7 @@ import { join } from 'path';
 import { execSync } from 'child_process';
 
 // Detect if we're being installed in a user's project (not the package itself)
-const isUserProject = () => {
+const isUserProject = async () => {
   const cwd = process.cwd();
   const packageJsonPath = join(cwd, 'package.json');
 
@@ -23,8 +23,9 @@ const isUserProject = () => {
   }
 
   try {
+    // Use dynamic import without assert (Node 22 compatible)
     const pkgContent = existsSync(packageJsonPath) ?
-      await import('file://' + packageJsonPath, { assert: { type: 'json' } }) : null;
+      await import('file://' + packageJsonPath, { with: { type: 'json' } }) : null;
     if (!pkgContent) return false;
     const pkg = pkgContent.default;
     // If package.json name is our package, we're inside the package itself

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

@@ -0,0 +1,233 @@
+/**
+ * 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]: any;
+    };
+    /**
+     * 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, any>;
+    /**
+     * Dry run mode - validate only, don't write files
+     */
+    dryRun?: boolean;
+}
+/**
+ * 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;
+    /**
+     * 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;
+}
+/**
+ * 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;
+}
+/**
+ * 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 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;
+}
+//# sourceMappingURL=adapter.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.interface.d.ts","sourceRoot":"","sources":["../../../src/adapters/base/adapter.interface.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,89 @@
+/**
+ * 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
+ */
+/**
+ * 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,
+        };
+    }
+}
+//# sourceMappingURL=adapter.interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.interface.js","sourceRoot":"","sources":["../../../src/adapters/base/adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8OH;;GAEG;AACH,MAAM,OAAgB,WAAW;IAW/B;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAmB;QAChC,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,wBAAwB;QACxB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,2BAA2B;gBACpC,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,wBAAwB;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,8BAA8B;gBACvC,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,wBAAwB;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,oDAAoD;gBAC7D,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,+CAA+C;aAC5D,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC9C,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SACrD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO;YACL,UAAU,EAAE,mBAAmB;YAC/B,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE;gBACR,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC,WAAW;aACrD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,oBAAoB;aAC3B;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,YAAY,CACpB,OAAgB,EAChB,KAAmB,EACnB,KAAc,EACd,QAAmC;QAEnC,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO;YACP,KAAK;YACL,KAAK;YACL,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,UAAU,CAClB,IAAY,EACZ,OAAe,EACf,IAAwB,EACxB,QAAiB;QAEjB,OAAO;YACL,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}

package/dist/adapters/crewai/adapter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * CrewAI Platform Adapter
+ * Exports OSSA agent manifests to CrewAI format (Python)
+ *
+ * CrewAI is a framework for orchestrating role-playing autonomous AI agents.
+ * It excels at multi-agent collaboration and task delegation.
+ *
+ * SOLID: Single Responsibility - CrewAI export only
+ * DRY: Reuses BaseAdapter validation and existing converter
+ */
+import { BaseAdapter } from '../base/adapter.interface.js';
+import type { OssaAgent, ExportOptions, ExportResult, ValidationResult } from '../base/adapter.interface.js';
+export declare class CrewAIAdapter extends BaseAdapter {
+    readonly platform = "crewai";
+    readonly displayName = "CrewAI";
+    readonly description = "CrewAI multi-agent framework (Python)";
+    readonly supportedVersions: string[];
+    private converter;
+    /**
+     * Export OSSA manifest to CrewAI format
+     */
+    export(manifest: OssaAgent, options?: ExportOptions): Promise<ExportResult>;
+    /**
+     * Validate manifest for CrewAI compatibility
+     */
+    validate(manifest: OssaAgent): Promise<ValidationResult>;
+    /**
+     * Get example CrewAI-optimized manifest
+     */
+    getExample(): OssaAgent;
+    /**
+     * Generate agents.py - Agent definitions
+     */
+    private generateAgentsCode;
+    /**
+     * Generate tasks.py - Task definitions
+     */
+    private generateTasksCode;
+    /**
+     * Generate tools.py - Tool implementations
+     */
+    private generateToolsCode;
+    /**
+     * Generate requirements.txt
+     */
+    private generateRequirements;
+    /**
+     * Generate README.md
+     */
+    private generateReadme;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/crewai/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/crewai/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGjB,MAAM,8BAA8B,CAAC;AAGtC,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,QAAQ,YAAY;IAC7B,QAAQ,CAAC,WAAW,YAAY;IAChC,QAAQ,CAAC,WAAW,2CAA2C;IAC/D,QAAQ,CAAC,iBAAiB,WAA8B;IAExD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IA6ExB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsC9D;;OAEG;IACH,UAAU,IAAI,SAAS;IA8CvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,cAAc;CAyCvB"}