@bluefly/openstandardagents 0.4.0 → 0.4.2

package/dist/cli/schema-driven/ui-generator.js

@@ -0,0 +1,326 @@
+/**
+ * UI Generator - Schema-Driven Inquirer Prompt Generation
+ * Automatically generates inquirer prompts from JSON Schema definitions
+ * TRUE API-FIRST APPROACH
+ */
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { SchemaLoader } from './schema-loader.js';
+export class UIGenerator {
+    schema;
+    options;
+    constructor(schemaLoader, options = {}) {
+        this.schema = schemaLoader;
+        this.options = {
+            includeOptional: true,
+            showDescriptions: true,
+            groupByCategory: false,
+            allowSkip: true,
+            ...options,
+        };
+    }
+    /**
+     * Generate inquirer prompt from schema path
+     * Example: generatePrompt('spec.llm.provider')
+     */
+    generatePrompt(path, name) {
+        const definition = this.schema.getDefinition(path);
+        if (!definition) {
+            return null;
+        }
+        const fieldName = name || path.split('.').pop() || path;
+        const isRequired = this.schema.isRequired(path);
+        const description = this.schema.getDescription(path);
+        const defaultValue = this.schema.getDefault(path);
+        const examples = this.schema.getExamples(path);
+        // Generate appropriate prompt based on type
+        if (definition.enum) {
+            return this.generateEnumPrompt(fieldName, path, definition, isRequired, description, defaultValue);
+        }
+        switch (definition.type) {
+            case 'string':
+                return this.generateStringPrompt(fieldName, path, definition, isRequired, description, defaultValue, examples);
+            case 'number':
+            case 'integer':
+                return this.generateNumberPrompt(fieldName, path, definition, isRequired, description, defaultValue);
+            case 'boolean':
+                return this.generateBooleanPrompt(fieldName, definition, isRequired, description, defaultValue);
+            case 'array':
+                return this.generateArrayPrompt(fieldName, definition, isRequired, description);
+            case 'object':
+                // For objects, we typically handle them recursively
+                return null;
+            default:
+                return null;
+        }
+    }
+    /**
+     * Generate enum selection prompt (list or checkbox)
+     */
+    generateEnumPrompt(name, path, definition, isRequired, description, defaultValue) {
+        const enumOptions = this.schema.getEnumOptions(path);
+        const message = this.formatMessage(name, description, isRequired);
+        const choices = enumOptions.map((option) => ({
+            name: option.description
+                ? `${option.value} ${chalk.gray(`- ${option.description}`)}`
+                : option.value,
+            value: option.value,
+            short: option.value,
+        }));
+        return {
+            type: 'list',
+            name,
+            message,
+            choices,
+            default: defaultValue,
+            validate: isRequired ? this.requiredValidator : undefined,
+        };
+    }
+    /**
+     * Generate string input prompt
+     */
+    generateStringPrompt(name, path, definition, isRequired, description, defaultValue, examples) {
+        const message = this.formatMessage(name, description, isRequired, examples);
+        const pattern = this.schema.getPattern(path);
+        return {
+            type: 'input',
+            name,
+            message,
+            default: defaultValue,
+            validate: (input) => {
+                // Required check
+                if (isRequired && !input.trim()) {
+                    return 'This field is required';
+                }
+                // Pattern validation
+                if (pattern && input && !pattern.test(input)) {
+                    return `Must match pattern: ${pattern.source}`;
+                }
+                return true;
+            },
+        };
+    }
+    /**
+     * Generate number input prompt
+     */
+    generateNumberPrompt(name, path, definition, isRequired, description, defaultValue) {
+        const message = this.formatMessage(name, description, isRequired);
+        const { minimum, maximum } = this.schema.getNumericConstraints(path);
+        return {
+            type: 'number',
+            name,
+            message,
+            default: defaultValue,
+            validate: (input) => {
+                // Required check
+                if (isRequired && (input === null || input === undefined)) {
+                    return 'This field is required';
+                }
+                // Range validation
+                if (minimum !== undefined && input < minimum) {
+                    return `Must be at least ${minimum}`;
+                }
+                if (maximum !== undefined && input > maximum) {
+                    return `Must be at most ${maximum}`;
+                }
+                return true;
+            },
+        };
+    }
+    /**
+     * Generate boolean confirmation prompt
+     */
+    generateBooleanPrompt(name, definition, isRequired, description, defaultValue) {
+        const message = this.formatMessage(name, description, isRequired);
+        return {
+            type: 'confirm',
+            name,
+            message,
+            default: defaultValue !== undefined ? defaultValue : false,
+        };
+    }
+    /**
+     * Generate array/multi-select prompt
+     */
+    generateArrayPrompt(name, definition, isRequired, description) {
+        const message = this.formatMessage(name, description, isRequired);
+        // If array items have enum, use checkbox
+        if (definition.items?.enum) {
+            const choices = definition.items.enum.map((value) => ({
+                name: value,
+                value,
+                checked: false,
+            }));
+            return {
+                type: 'checkbox',
+                name,
+                message,
+                choices,
+                validate: isRequired
+                    ? (input) => {
+                        return input.length > 0 || 'Select at least one option';
+                    }
+                    : undefined,
+            };
+        }
+        // Otherwise, use input for comma-separated values
+        return {
+            type: 'input',
+            name,
+            message: `${message} (comma-separated)`,
+            filter: (input) => {
+                return input.split(',').map((s) => s.trim()).filter(Boolean);
+            },
+            validate: isRequired
+                ? (input) => {
+                    return input.trim().length > 0 || 'This field is required';
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Format message with description and requirements
+     */
+    formatMessage(name, description, isRequired, examples) {
+        let message = chalk.blue(this.formatFieldName(name));
+        if (isRequired) {
+            message += chalk.red(' *');
+        }
+        if (this.options.showDescriptions && description) {
+            message += `\n  ${chalk.gray(description)}`;
+        }
+        if (examples && examples.length > 0) {
+            message += `\n  ${chalk.gray('Example:')} ${chalk.white(examples[0])}`;
+        }
+        return message;
+    }
+    /**
+     * Format field name to human-readable
+     */
+    formatFieldName(name) {
+        return name
+            .split('_')
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    /**
+     * Required field validator
+     */
+    requiredValidator(input) {
+        if (input === null || input === undefined || input === '') {
+            return 'This field is required';
+        }
+        return true;
+    }
+    /**
+     * Generate prompts for all fields in a schema path
+     * Example: generateForObject('spec.llm')
+     */
+    async generateForObject(path, values = {}) {
+        const definition = this.schema.getDefinition(path);
+        if (!definition?.properties) {
+            return {};
+        }
+        const prompts = [];
+        const requiredFields = this.schema.getRequiredFields(path);
+        // Generate prompts for each property
+        for (const [propName, propDef] of Object.entries(definition.properties)) {
+            const propPath = `${path}.${propName}`;
+            const isRequired = requiredFields.includes(propName);
+            // Skip optional fields if configured
+            if (!isRequired && !this.options.includeOptional) {
+                continue;
+            }
+            const prompt = this.generatePrompt(propPath, propName);
+            if (prompt) {
+                prompts.push(prompt);
+            }
+        }
+        // Run prompts
+        if (prompts.length === 0) {
+            return {};
+        }
+        return inquirer.prompt(prompts);
+    }
+    /**
+     * Generate LLM configuration prompts (common use case)
+     */
+    async generateLLMConfig() {
+        // Provider selection
+        const providers = this.schema.getLLMProviders();
+        const { provider } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'provider',
+                message: chalk.blue('Select LLM Provider:'),
+                choices: providers.map((p) => ({
+                    name: p.description ? `${p.value} ${chalk.gray(`- ${p.description}`)}` : p.value,
+                    value: p.value,
+                })),
+            },
+        ]);
+        // Model and temperature
+        const llmConfig = await this.generateForObject('spec.llm', { provider });
+        return { provider, ...llmConfig };
+    }
+    /**
+     * Generate tool configuration prompts
+     */
+    async generateToolConfig() {
+        const tools = [];
+        let addingTools = true;
+        while (addingTools) {
+            const toolTypes = this.schema.getToolTypes();
+            const { toolType } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'toolType',
+                    message: 'Select tool type:',
+                    choices: [
+                        ...toolTypes.map((t) => ({
+                            name: t.description ? `${t.value} ${chalk.gray(`- ${t.description}`)}` : t.value,
+                            value: t.value,
+                        })),
+                        { name: chalk.gray('Done adding tools'), value: 'done' },
+                    ],
+                },
+            ]);
+            if (toolType === 'done') {
+                addingTools = false;
+                continue;
+            }
+            // Generate tool-specific prompts based on type
+            const toolConfig = await this.generateForObject(`spec.tools`, { type: toolType });
+            tools.push({ type: toolType, ...toolConfig });
+            console.log(chalk.green('✓'), `Added ${toolType} tool`);
+        }
+        return tools;
+    }
+    /**
+     * Generate extension configuration prompts
+     */
+    async generateExtensionConfig(extensionType) {
+        const extensionPath = `extensions.${extensionType}`;
+        return this.generateForObject(extensionPath);
+    }
+    /**
+     * Validate generated config against schema
+     */
+    validate(manifest) {
+        return this.schema.validate(manifest);
+    }
+    /**
+     * Get all available extension types
+     */
+    getAvailableExtensions() {
+        return this.schema.getExtensionTypes();
+    }
+}
+/**
+ * Create UIGenerator with schema loader
+ */
+export function createUIGenerator(schemaPath, options) {
+    const schemaLoader = new SchemaLoader(schemaPath);
+    return new UIGenerator(schemaLoader, options);
+}
+//# sourceMappingURL=ui-generator.js.map

package/dist/cli/schema-driven/ui-generator.js.map

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

package/dist/cli/wizard/interactive-wizard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Enhanced Interactive Wizard for OSSA Agent Creation
+ * Provides guided agent creation with use-case detection and template selection
+ */
+import type { OssaAgent } from '../../types/index.js';
+export interface WizardOptions {
+    skipUseCase?: boolean;
+    skipTemplate?: boolean;
+    useDefaults?: boolean;
+}
+export interface WizardResult {
+    manifest: OssaAgent;
+    template?: string;
+    useCase?: string;
+}
+export declare class InteractiveWizard {
+    run(options?: WizardOptions): Promise<WizardResult>;
+    private selectUseCase;
+    private selectTemplate;
+    private collectBasicInfo;
+    private configureLLM;
+    private getModelChoices;
+    private selectPlatforms;
+    private buildManifest;
+}
+//# sourceMappingURL=interactive-wizard.d.ts.map

package/dist/cli/wizard/interactive-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-wizard.d.ts","sourceRoot":"","sources":["../../../src/cli/wizard/interactive-wizard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKtD,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAiB;IACtB,GAAG,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;YAuC/C,aAAa;YAqCb,cAAc;YAoCd,gBAAgB;YAmDhB,YAAY;IA0D1B,OAAO,CAAC,eAAe;YAgCT,eAAe;IAsB7B,OAAO,CAAC,aAAa;CA2DtB"}

package/dist/cli/wizard/interactive-wizard.js

@@ -0,0 +1,296 @@
+/**
+ * Enhanced Interactive Wizard for OSSA Agent Creation
+ * Provides guided agent creation with use-case detection and template selection
+ */
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { getApiVersion } from '../../utils/version.js';
+import { USE_CASES, getRecommendedConfig } from './use-cases.js';
+import { TEMPLATE_CATALOG } from './template-catalog.js';
+export class InteractiveWizard {
+    async run(options = {}) {
+        console.log(chalk.bold.blue('\n🧙 OSSA Interactive Wizard\n'));
+        console.log(chalk.gray('Create a production-ready agent manifest\n'));
+        // Step 1: Use case detection
+        let useCase;
+        let template;
+        if (!options.skipUseCase && !options.useDefaults) {
+            useCase = await this.selectUseCase();
+        }
+        // Step 2: Template selection (if use case has templates)
+        if (useCase && !options.skipTemplate && !options.useDefaults) {
+            const useCaseTemplates = USE_CASES.find((uc) => uc.id === useCase)?.templates || [];
+            if (useCaseTemplates.length > 0) {
+                template = await this.selectTemplate(useCaseTemplates);
+            }
+        }
+        // Step 3: Basic information
+        const basics = await this.collectBasicInfo(options.useDefaults);
+        // Step 4: LLM configuration
+        const llmConfig = await this.configureLLM(useCase, options.useDefaults);
+        // Step 5: Platform selection
+        const platforms = await this.selectPlatforms(options.useDefaults);
+        // Build manifest
+        const manifest = this.buildManifest(basics, llmConfig, platforms);
+        return {
+            manifest,
+            template,
+            useCase,
+        };
+    }
+    async selectUseCase() {
+        const { category } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'category',
+                message: 'What type of agent are you building?',
+                choices: [
+                    { name: '🤖 Development - Code review, IDE assistance', value: 'development' },
+                    { name: '💬 Assistant - Customer support, chat', value: 'assistant' },
+                    { name: '⚙️  Automation - Workflows, task orchestration', value: 'automation' },
+                    { name: '🔌 Integration - CMS, external systems', value: 'integration' },
+                    { name: '📊 Analysis - Research, data processing', value: 'analysis' },
+                ],
+            },
+        ]);
+        const categoryUseCases = USE_CASES.filter((uc) => uc.category === category);
+        const { useCaseId } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'useCaseId',
+                message: 'Select your specific use case:',
+                choices: categoryUseCases.map((uc) => ({
+                    name: `${uc.name} - ${uc.description}`,
+                    value: uc.id,
+                })),
+            },
+        ]);
+        const useCase = USE_CASES.find((uc) => uc.id === useCaseId);
+        console.log(chalk.green(`\n✓ Use case selected: ${useCase.name}`));
+        return useCaseId;
+    }
+    async selectTemplate(templateIds) {
+        if (templateIds.length === 0)
+            return undefined;
+        const templates = TEMPLATE_CATALOG.filter((t) => templateIds.includes(t.id));
+        const { useTemplate } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'useTemplate',
+                message: 'Would you like to start from a template?',
+                default: true,
+            },
+        ]);
+        if (!useTemplate)
+            return undefined;
+        const { templateId } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'templateId',
+                message: 'Select a template:',
+                choices: templates.map((t) => ({
+                    name: `${t.name} (${t.platform}) - ${t.description}`,
+                    value: t.id,
+                })),
+            },
+        ]);
+        console.log(chalk.green(`\n✓ Template selected: ${templateId}`));
+        console.log(chalk.gray(`   Template path: platform-agents/${templates.find((t) => t.id === templateId)?.path}`));
+        return templateId;
+    }
+    async collectBasicInfo(useDefaults) {
+        if (useDefaults) {
+            return {
+                name: 'my-agent',
+                displayName: 'My Agent',
+                description: 'OSSA-compliant agent',
+                version: '1.0.0',
+            };
+        }
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'name',
+                message: 'Agent ID (DNS-1123 format):',
+                default: 'my-agent',
+                validate: (input) => {
+                    if (!/^[a-z0-9]([-a-z0-9]*[a-z0-9])?$/.test(input)) {
+                        return 'Must be lowercase alphanumeric with hyphens (DNS-1123)';
+                    }
+                    return true;
+                },
+            },
+            {
+                type: 'input',
+                name: 'displayName',
+                message: 'Display name:',
+                default: (answers) => answers.name,
+            },
+            {
+                type: 'input',
+                name: 'description',
+                message: 'Description:',
+                default: 'OSSA-compliant agent',
+            },
+            {
+                type: 'input',
+                name: 'version',
+                message: 'Version:',
+                default: '1.0.0',
+            },
+        ]);
+        return answers;
+    }
+    async configureLLM(useCase, useDefaults) {
+        const recommended = useCase ? getRecommendedConfig(useCase) : null;
+        if (useDefaults) {
+            return {
+                provider: recommended?.provider || 'openai',
+                model: recommended?.model || 'gpt-4o',
+                temperature: 0.7,
+            };
+        }
+        const { provider } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'provider',
+                message: 'Select LLM provider:',
+                default: recommended?.provider || 'openai',
+                choices: [
+                    { name: 'OpenAI (GPT-4, GPT-4o)', value: 'openai' },
+                    { name: 'Anthropic (Claude)', value: 'anthropic' },
+                    { name: 'Google (Gemini)', value: 'google' },
+                    { name: 'AWS Bedrock', value: 'aws-bedrock' },
+                    { name: 'Azure OpenAI', value: 'azure' },
+                ],
+            },
+        ]);
+        const modelChoices = this.getModelChoices(provider);
+        const defaultModel = recommended?.provider === provider ? recommended.model : modelChoices[0].value;
+        const { model, temperature } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'model',
+                message: `Select ${provider} model:`,
+                default: defaultModel,
+                choices: modelChoices,
+            },
+            {
+                type: 'number',
+                name: 'temperature',
+                message: 'Temperature (0.0 - 1.0):',
+                default: 0.7,
+                validate: (input) => {
+                    if (input < 0 || input > 1)
+                        return 'Must be between 0 and 1';
+                    return true;
+                },
+            },
+        ]);
+        return { provider, model, temperature };
+    }
+    getModelChoices(provider) {
+        const models = {
+            openai: [
+                { name: 'GPT-4o (Recommended)', value: 'gpt-4o' },
+                { name: 'GPT-4o Mini (Cost-optimized)', value: 'gpt-4o-mini' },
+                { name: 'GPT-4 Turbo', value: 'gpt-4-turbo' },
+                { name: 'GPT-4', value: 'gpt-4' },
+                { name: 'GPT-3.5 Turbo', value: 'gpt-3.5-turbo' },
+            ],
+            anthropic: [
+                { name: 'Claude Sonnet 4 (Recommended)', value: 'claude-sonnet-4' },
+                { name: 'Claude Opus 4 (Most capable)', value: 'claude-opus-4' },
+                { name: 'Claude Haiku 4 (Fast)', value: 'claude-haiku-4' },
+            ],
+            google: [
+                { name: 'Gemini 1.5 Flash (Recommended)', value: 'gemini-1.5-flash' },
+                { name: 'Gemini 1.5 Pro', value: 'gemini-1.5-pro' },
+                { name: 'Gemini Pro', value: 'gemini-pro' },
+            ],
+            'aws-bedrock': [
+                { name: 'Claude 3 Sonnet (Bedrock)', value: 'bedrock-claude-3-sonnet' },
+                { name: 'Claude 3 Opus (Bedrock)', value: 'bedrock-claude-3-opus' },
+            ],
+            azure: [
+                { name: 'GPT-4 Turbo (Azure)', value: 'azure-gpt-4-turbo' },
+                { name: 'GPT-4 (Azure)', value: 'azure-gpt-4' },
+            ],
+        };
+        return models[provider] || [];
+    }
+    async selectPlatforms(useDefaults) {
+        if (useDefaults)
+            return ['openai'];
+        const { platforms } = await inquirer.prompt([
+            {
+                type: 'checkbox',
+                name: 'platforms',
+                message: 'Select target platforms (optional):',
+                choices: [
+                    { name: 'Cursor (IDE integration)', value: 'cursor' },
+                    { name: 'OpenAI Assistants', value: 'openai' },
+                    { name: 'CrewAI (Multi-agent)', value: 'crewai' },
+                    { name: 'LangChain', value: 'langchain' },
+                    { name: 'LangFlow', value: 'langflow' },
+                    { name: 'Anthropic Claude', value: 'anthropic' },
+                ],
+            },
+        ]);
+        return platforms;
+    }
+    buildManifest(basics, llm, platforms) {
+        const manifest = {
+            apiVersion: getApiVersion(),
+            kind: 'Agent',
+            metadata: {
+                name: basics.name,
+                version: basics.version,
+                description: basics.description,
+            },
+            spec: {
+                role: `You are ${basics.displayName}. ${basics.description}`,
+                llm: {
+                    provider: llm.provider,
+                    model: llm.model,
+                    temperature: llm.temperature,
+                },
+                tools: [],
+            },
+        };
+        // Add platform extensions
+        if (platforms.length > 0) {
+            manifest.extensions = {};
+            for (const platform of platforms) {
+                switch (platform) {
+                    case 'cursor':
+                        manifest.extensions.cursor = {
+                            enabled: true,
+                            agent_type: 'composer',
+                        };
+                        break;
+                    case 'openai':
+                        manifest.extensions.openai_agents = { enabled: true };
+                        break;
+                    case 'crewai':
+                        manifest.extensions.crewai = {
+                            enabled: true,
+                            agent_type: 'worker',
+                        };
+                        break;
+                    case 'langchain':
+                        manifest.extensions.langchain = { enabled: true };
+                        break;
+                    case 'langflow':
+                        manifest.extensions.langflow = { enabled: true };
+                        break;
+                    case 'anthropic':
+                        manifest.extensions.anthropic = { enabled: true };
+                        break;
+                }
+            }
+        }
+        return manifest;
+    }
+}
+//# sourceMappingURL=interactive-wizard.js.map