@bluefly/openstandardagents 0.4.4 → 0.4.6

package/dist/adapters/claude-code/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Claude Code Sub-agent Type Definitions
+ * https://code.claude.com/docs/en/sub-agents
+ */
+/**
+ * Claude Code Sub-agent Definition
+ */
+export interface ClaudeCodeSubAgent {
+    /**
+     * Sub-agent name
+     */
+    name: string;
+    /**
+     * Sub-agent description
+     */
+    description: string;
+    /**
+     * System prompt for sub-agent behavior
+     */
+    system_prompt: string;
+    /**
+     * Sub-agent type
+     */
+    subagent_type: 'general-purpose' | 'Explore' | 'Plan' | 'Bash';
+    /**
+     * Maximum conversation turns
+     */
+    max_turns?: number;
+    /**
+     * Model to use (defaults to parent agent's model)
+     */
+    model?: 'sonnet' | 'opus' | 'haiku';
+    /**
+     * Tools available to sub-agent
+     */
+    tools: ClaudeCodeTool[];
+    /**
+     * Sub-agent metadata
+     */
+    metadata?: {
+        version?: string;
+        author?: string;
+        tags?: string[];
+        [key: string]: unknown;
+    };
+}
+/**
+ * Claude Code Tool Definition
+ */
+export interface ClaudeCodeTool {
+    /**
+     * Tool name
+     */
+    name: string;
+    /**
+     * Tool description
+     */
+    description: string;
+    /**
+     * Tool parameters (JSON Schema)
+     */
+    input_schema: ClaudeCodeInputSchema;
+    /**
+     * Tool implementation
+     */
+    implementation?: ClaudeCodeToolImplementation;
+}
+/**
+ * Tool input schema (JSON Schema subset)
+ */
+export interface ClaudeCodeInputSchema {
+    type: 'object';
+    properties: Record<string, ClaudeCodeSchemaProperty>;
+    required?: string[];
+}
+/**
+ * Schema property
+ */
+export interface ClaudeCodeSchemaProperty {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+    enum?: unknown[];
+    items?: ClaudeCodeSchemaProperty;
+    default?: unknown;
+}
+/**
+ * Tool implementation options
+ */
+export interface ClaudeCodeToolImplementation {
+    /**
+     * Implementation type
+     */
+    type: 'bash' | 'mcp' | 'api';
+    /**
+     * Bash command (for type: bash)
+     */
+    command?: string;
+    /**
+     * MCP server name (for type: mcp)
+     */
+    mcp_server?: string;
+    /**
+     * MCP tool name (for type: mcp)
+     */
+    mcp_tool?: string;
+    /**
+     * API endpoint (for type: api)
+     */
+    endpoint?: string;
+    /**
+     * HTTP method (for type: api)
+     */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+}
+/**
+ * Sub-agent Configuration File
+ */
+export interface ClaudeCodeSubAgentConfig {
+    /**
+     * Config file version
+     */
+    version: '1.0';
+    /**
+     * Sub-agent definition
+     */
+    subagent: ClaudeCodeSubAgent;
+}
+/**
+ * Sub-agent Skills Configuration
+ * For integration with Claude Code skills system
+ */
+export interface ClaudeCodeSkillConfig {
+    /**
+     * Skill name (command name without slash)
+     */
+    name: string;
+    /**
+     * Skill description
+     */
+    description: string;
+    /**
+     * Whether skill spawns a sub-agent
+     */
+    spawns_subagent: boolean;
+    /**
+     * Sub-agent configuration (if spawns_subagent is true)
+     */
+    subagent_config?: ClaudeCodeSubAgent;
+    /**
+     * Skill implementation (if spawns_subagent is false)
+     */
+    implementation?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/claude-code/types.js

@@ -0,0 +1,6 @@
+/**
+ * Claude Code Sub-agent Type Definitions
+ * https://code.claude.com/docs/en/sub-agents
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -9,17 +9,22 @@
  * 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';
+import type { OssaAgent, ExportOptions, ExportResult, ValidationResult, ConfigResult } 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 status: "beta";
     readonly supportedVersions: string[];
     private converter;
     /**
      * Export OSSA manifest to CrewAI format
      */
     export(manifest: OssaAgent, options?: ExportOptions): Promise<ExportResult>;
+    /**
+     * Produce lightweight JSON config for MCP tool responses.
+     */
+    toConfig(manifest: OssaAgent): Promise<ConfigResult>;
     /**
      * Validate manifest for CrewAI compatibility
      */

package/dist/adapters/crewai/adapter.js

@@ -11,11 +11,13 @@
 import * as yaml from 'yaml';
 import { BaseAdapter } from '../base/adapter.interface.js';
 import { getApiVersion } from '../../utils/version.js';
+import { generatePythonToolParams } from '../base/tool-params.js';
 import { CrewAIConverter } from './converter.js';
 export class CrewAIAdapter extends BaseAdapter {
     platform = 'crewai';
     displayName = 'CrewAI';
     description = 'CrewAI multi-agent framework (Python)';
+    status = 'beta';
     supportedVersions = ['v0.3.6', 'v{{VERSION}}'];
     converter = new CrewAIConverter();
     /**
@@ -86,6 +88,8 @@ export class CrewAIAdapter extends BaseAdapter {
                 const testToolsCode = this.generateTestToolsCode(manifest);
                 files.push(this.createFile('tests/test_tools.py', testToolsCode, 'test', 'python'));
             }
+            // Perfect Agent files
+            files.push(...(await this.generatePerfectAgentFiles(manifest, options)));
             return this.createResult(true, files, undefined, {
                 duration: Date.now() - startTime,
                 version: '0.1.0',
@@ -96,6 +100,27 @@ export class CrewAIAdapter extends BaseAdapter {
             return this.createResult(false, [], error instanceof Error ? error.message : String(error), { duration: Date.now() - startTime });
         }
     }
+    /**
+     * Produce lightweight JSON config for MCP tool responses.
+     */
+    async toConfig(manifest) {
+        const meta = manifest.metadata || { name: 'agent', version: '0.0.0' };
+        const config = {
+            agents: [
+                {
+                    role: meta.name,
+                    goal: meta.description || '',
+                    backstory: manifest.spec?.role || '',
+                    llm: manifest.spec?.llm?.model || 'gpt-4',
+                    tools: (manifest.spec?.tools || []).map((t) => t.name),
+                },
+            ],
+        };
+        return {
+            config,
+            filename: `${meta.name}.crewai.yaml`,
+        };
+    }
     /**
      * Validate manifest for CrewAI compatibility
      */
@@ -245,23 +270,32 @@ ${config.tasks.map((_, index) => `    task_${index + 1}`).join(',\n')}
      */
     generateToolsCode(manifest) {
         const tools = (manifest.spec?.tools || []);
+        const allImports = new Set();
+        const toolDefs = tools.map((t) => {
+            const { params, imports, docParams } = generatePythonToolParams(t);
+            imports.forEach((i) => allImports.add(i));
+            return `
+@tool
+def ${t.name || 'unknown_tool'}(${params}) -> str:
+    """${t.description || 'Tool implementation'}
+
+    Args:
+${docParams}
+    """
+    return json.dumps({"result": "ok", "tool": "${t.name || 'tool'}"})
+`;
+        });
+        const extraImports = allImports.size > 0 ? '\n' + Array.from(allImports).join('\n') : '';
         return `"""
 CrewAI Tool Implementations
 Generated from OSSA manifest: ${manifest.metadata?.name || 'unknown'}
 """
 
+import json
 from crewai_tools import tool
-from typing import Any
+from typing import Any${extraImports}
 
-${tools
-            .map((t) => `
-@tool
-def ${t.name || 'unknown_tool'}(input_data: str) -> str:
-    """${t.description || 'Tool implementation'}"""
-    # Implement tool logic here
-    return f"Executed ${t.name || 'tool'} with: {input_data}"
-`)
-            .join('\n')}
+${toolDefs.join('\n')}
 
 def get_tools() -> list:
     """Return all available tools"""
@@ -357,6 +391,25 @@ class ${className}:
      */
     generateCustomToolsCode(manifest) {
         const tools = (manifest.spec?.tools || []);
+        const allImports = new Set();
+        const toolDefs = tools.map((t) => {
+            const { params, imports, docParams } = generatePythonToolParams(t);
+            imports.forEach((i) => allImports.add(i));
+            return `@tool("${t.name || 'unknown_tool'}")
+def ${t.name || 'unknown_tool'}(${params}) -> str:
+    """
+    ${t.description || 'Tool implementation'}
+
+    Args:
+${docParams}
+
+    Returns:
+        Tool execution result
+    """
+    return json.dumps({"result": "ok", "tool": "${t.name || 'tool'}"})
+`;
+        });
+        const extraImports = allImports.size > 0 ? '\n' + Array.from(allImports).join('\n') : '';
         return `"""
 Custom Tool Implementations
 Generated from OSSA manifest: ${manifest.metadata?.name || 'unknown'}
@@ -364,36 +417,18 @@ Generated from OSSA manifest: ${manifest.metadata?.name || 'unknown'}
 Implement your custom tools here following CrewAI's tool decorator pattern.
 """
 
+import json
 from crewai_tools import tool
-from typing import Any, Optional
+from typing import Any, Optional${extraImports}
 import os
 
 
-${tools
-            .map((t) => `@tool("${t.name || 'unknown_tool'}")
-def ${t.name || 'unknown_tool'}(input_data: str) -> str:
-    """
-    ${t.description || 'Tool implementation'}
-
-    Args:
-        input_data: Input data for the tool
-
-    Returns:
-        Tool execution result
-    """
-    # TODO: Implement ${t.name || 'tool'} logic here
-    # Example implementation:
-    try:
-        result = f"Executed ${t.name || 'tool'} with input: {input_data}"
-        return result
-    except Exception as e:
-        return f"Error executing ${t.name || 'tool'}: {str(e)}"
-`)
-            .join('\n\n')}
+${toolDefs.join('\n\n')}
 
 
 # Add more custom tools as needed
-${tools.length === 0 ? `
+${tools.length === 0
+            ? `
 @tool("example_tool")
 def example_tool(query: str) -> str:
     """
@@ -405,8 +440,9 @@ def example_tool(query: str) -> str:
     Returns:
         Tool result
     """
-    return f"Processed query: {query}"
-` : ''}
+    return json.dumps({"result": "ok", "tool": "example_tool"})
+`
+            : ''}
 `;
     }
     /**
@@ -501,8 +537,12 @@ langchain-community>=0.0.20
      */
     generateEnvExample(manifest) {
         const llmProvider = manifest.spec?.llm?.provider || 'openai';
-        const primaryKey = llmProvider === 'anthropic' ? 'ANTHROPIC_API_KEY=sk-ant-...' : 'OPENAI_API_KEY=sk-...';
-        const secondaryKey = llmProvider === 'anthropic' ? '# OPENAI_API_KEY=sk-...' : '# ANTHROPIC_API_KEY=sk-ant-...';
+        const primaryKey = llmProvider === 'anthropic'
+            ? 'ANTHROPIC_API_KEY=sk-ant-...'
+            : 'OPENAI_API_KEY=sk-...';
+        const secondaryKey = llmProvider === 'anthropic'
+            ? '# OPENAI_API_KEY=sk-...'
+            : '# ANTHROPIC_API_KEY=sk-ant-...';
         return `# ${manifest.metadata?.name || 'CrewAI Crew'} Environment Configuration
 
 # LLM Provider API Keys
@@ -824,7 +864,8 @@ import pytest
 from tools.custom_tools import *
 
 
-${tools.map((t) => `
+${tools
+            .map((t) => `
 class Test${this.toPascalCase(t.name || 'Tool')}:
     """Test suite for ${t.name || 'tool'}"""
 
@@ -838,7 +879,8 @@ class Test${this.toPascalCase(t.name || 'Tool')}:
         """Test ${t.name || 'tool'} handles empty input"""
         result = ${t.name || 'tool'}("")
         assert result is not None
-`).join('\n')}
+`)
+            .join('\n')}
 
 
 if __name__ == "__main__":
@@ -1051,7 +1093,8 @@ ${projectName}/
 
 This crew consists of ${config.agents.length} specialized agent(s):
 
-${config.agents.map((a, i) => `
+${config.agents
+            .map((a, i) => `
 ### ${i + 1}. ${a.role}
 
 **Goal:** ${a.goal}
@@ -1062,25 +1105,30 @@ ${config.agents.map((a, i) => `
 - Utilizes custom tools for enhanced functionality
 - Collaborates with other agents in the crew
 - Produces structured outputs for downstream tasks
-`).join('\n')}
+`)
+            .join('\n')}
 
 ## Tasks
 
 The crew executes ${config.tasks.length} task(s) in ${config.process} order:
 
-${config.tasks.map((t, i) => `
+${config.tasks
+            .map((t, i) => `
 ### Task ${i + 1}: ${t.description}
 
 - **Assigned Agent:** ${t.agent}
 - **Expected Output:** ${t.expected_output || 'Completed task result'}
 ${i < config.tasks.length - 1 ? '- **Flows to:** Task ' + (i + 2) : '- **Final Output:** Yes'}
-`).join('\n')}
+`)
+            .join('\n')}
 
 ## Tools
 
 Custom tools are implemented in \`tools/custom_tools.py\`:
 
-${(manifest.spec?.tools || []).length > 0 ? (manifest.spec?.tools).map((t) => `
+${(manifest.spec?.tools || []).length > 0
+            ? (manifest.spec?.tools)
+                .map((t) => `
 ### ${t.name || 'Tool'}
 
 ${t.description || 'Custom tool implementation'}
@@ -1090,7 +1138,9 @@ from tools.custom_tools import ${t.name || 'tool'}
 
 result = ${t.name || 'tool'}("input data")
 \`\`\`
-`).join('\n') : `
+`)
+                .join('\n')
+            : `
 No custom tools defined. Add tools in \`tools/custom_tools.py\`.
 `}
 

package/dist/adapters/crewai/converter.js

@@ -40,8 +40,7 @@ export class CrewAIConverter {
             const mainRole = this.extractRoleFromSpec(spec, manifest.metadata?.name);
             agents.push({
                 role: mainRole,
-                goal: manifest.metadata?.description ||
-                    'Execute tasks effectively',
+                goal: manifest.metadata?.description || 'Execute tasks effectively',
                 backstory: spec.role || manifest.metadata?.description || 'AI agent',
                 verbose: true,
             });
@@ -67,7 +66,7 @@ export class CrewAIConverter {
     sanitizeRoleName(name) {
         return name
             .split(/[-_\s]/)
-            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
             .join(' ');
     }
     /**
@@ -76,7 +75,7 @@ export class CrewAIConverter {
     extractRoleFromSpec(spec, fallback) {
         // Try to extract from role field (could be multiline)
         if (spec.role && typeof spec.role === 'string') {
-            const lines = spec.role.split('\n').filter(l => l.trim());
+            const lines = spec.role.split('\n').filter((l) => l.trim());
             if (lines.length > 0) {
                 const firstLine = lines[0].trim();
                 // If first line is reasonable length, use it as role

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

@@ -0,0 +1,75 @@
+/**
+ * Cursor Cloud Agent Platform Adapter
+ * Exports OSSA agent manifests to Cursor Cloud Agent format
+ *
+ * Cursor Cloud Agents are AI agents that run in the Cursor IDE
+ * https://cursor.com/docs/cloud-agent
+ *
+ * SOLID: Single Responsibility - Cursor agent generation only
+ * DRY: Extends BaseExporter for orchestration, validation, and common files
+ */
+import { BaseExporter } from '../base/base-exporter.js';
+import type { OssaAgent, ExportOptions, ExportFile, ValidationError, ValidationWarning } from '../base/adapter.interface.js';
+export declare class CursorAdapter extends BaseExporter {
+    readonly platform = "cursor";
+    readonly displayName = "Cursor Cloud Agent";
+    readonly description = "Cursor Cloud Agent for AI-powered coding assistance in Cursor IDE";
+    readonly status: "beta";
+    readonly supportedVersions: string[];
+    /**
+     * Platform-specific validation for Cursor compatibility
+     */
+    protected platformValidate(manifest: OssaAgent): {
+        errors: ValidationError[];
+        warnings: ValidationWarning[];
+    };
+    /**
+     * Generate Cursor-specific files
+     */
+    protected generateFiles(manifest: OssaAgent, options?: ExportOptions): Promise<ExportFile[]>;
+    /**
+     * Get example Cursor-optimized manifest
+     */
+    getExample(): OssaAgent;
+    /**
+     * Convert OSSA manifest to Cursor Cloud Agent
+     */
+    private convertToCursorAgent;
+    /**
+     * Extract capabilities from manifest
+     */
+    private extractCapabilities;
+    /**
+     * Convert OSSA tools to Cursor tools
+     */
+    private convertTools;
+    /**
+     * Generate tool implementation
+     */
+    private generateToolImplementation;
+    /**
+     * Generate TypeScript parameter type from JSON Schema
+     */
+    private generateParamType;
+    /**
+     * Convert JSON Schema type to TypeScript type
+     */
+    private jsonSchemaTypeToTS;
+    /**
+     * Generate agent.ts - Main entry point
+     */
+    private generateAgentCode;
+    /**
+     * Generate package.json
+     */
+    private generatePackageJson;
+    /**
+     * Generate tsconfig.json
+     */
+    private generateTsConfig;
+    /**
+     * Generate README.md
+     */
+    private generateReadme;
+}
+//# sourceMappingURL=adapter.d.ts.map