overai 1.4.0

package/dist/cli/commands/vector.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * Vector command - Vector store management
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const json_1 = require("../output/json");
+const pretty = __importStar(require("../output/pretty"));
+const cli_spec_1 = require("../spec/cli-spec");
+const errors_1 = require("../output/errors");
+async function execute(args, options) {
+    const action = args[0] || 'help';
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    try {
+        switch (action) {
+            case 'providers':
+                await listProviders(outputFormat);
+                break;
+            case 'info':
+                await showInfo(outputFormat);
+                break;
+            case 'help':
+            default:
+                await showHelp(outputFormat);
+                break;
+        }
+    }
+    catch (error) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.UNKNOWN, error instanceof Error ? error.message : String(error)));
+        }
+        else {
+            await pretty.error(error instanceof Error ? error.message : String(error));
+        }
+        process.exit(cli_spec_1.EXIT_CODES.RUNTIME_ERROR);
+    }
+}
+async function showInfo(outputFormat) {
+    const info = {
+        feature: 'Vector Stores',
+        description: 'Vector database integrations for embeddings and similarity search',
+        providers: [
+            { name: 'MemoryVectorStore', description: 'In-memory vector store for development' },
+            { name: 'PineconeVectorStore', description: 'Pinecone cloud vector database' },
+            { name: 'WeaviateVectorStore', description: 'Weaviate vector search engine' },
+            { name: 'QdrantVectorStore', description: 'Qdrant vector database' },
+            { name: 'ChromaVectorStore', description: 'ChromaDB embedding database' }
+        ],
+        sdkUsage: `
+import { createMemoryVectorStore, createPineconeStore } from 'praisonai';
+
+// Create a memory vector store
+const store = createMemoryVectorStore('my-store');
+
+// Create index
+await store.createIndex({ indexName: 'docs', dimension: 1536 });
+
+// Upsert vectors
+await store.upsert({
+  indexName: 'docs',
+  vectors: [{ id: '1', vector: [...], metadata: { text: 'Hello' } }]
+});
+
+// Query
+const results = await store.query({
+  indexName: 'docs',
+  vector: [...],
+  topK: 5
+});
+`
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(info));
+    }
+    else {
+        await pretty.heading('Vector Stores');
+        await pretty.plain(info.description);
+        await pretty.newline();
+        await pretty.plain('Available Providers:');
+        for (const p of info.providers) {
+            await pretty.plain(`  • ${p.name}: ${p.description}`);
+        }
+        await pretty.newline();
+        await pretty.dim('Use the SDK for full vector store functionality');
+    }
+}
+async function listProviders(outputFormat) {
+    const providers = [
+        { name: 'memory', description: 'In-memory vector store (default)', available: true },
+        { name: 'pinecone', description: 'Pinecone vector database', available: true },
+        { name: 'weaviate', description: 'Weaviate vector database', available: true },
+        { name: 'qdrant', description: 'Qdrant vector database', available: true },
+        { name: 'chroma', description: 'ChromaDB vector database', available: true }
+    ];
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ providers }));
+    }
+    else {
+        await pretty.heading('Vector Store Providers');
+        for (const p of providers) {
+            const status = p.available ? '✓' : '✗';
+            await pretty.plain(`  ${status} ${p.name.padEnd(15)} ${p.description}`);
+        }
+    }
+}
+async function showHelp(outputFormat) {
+    const help = {
+        command: 'vector',
+        description: 'Vector store management for embeddings and similarity search',
+        subcommands: [
+            { name: 'add <content>', description: 'Add document to vector store' },
+            { name: 'search <query>', description: 'Search vector store' },
+            { name: 'stats', description: 'Show vector store statistics' },
+            { name: 'providers', description: 'List available vector store providers' },
+            { name: 'help', description: 'Show this help' }
+        ],
+        flags: [
+            { name: '--store', description: 'Vector store provider (memory, pinecone, etc.)' }
+        ]
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(help));
+    }
+    else {
+        await pretty.heading('Vector Command');
+        await pretty.plain(help.description);
+        await pretty.newline();
+        await pretty.plain('Subcommands:');
+        for (const cmd of help.subcommands) {
+            await pretty.plain(`  ${cmd.name.padEnd(25)} ${cmd.description}`);
+        }
+        await pretty.newline();
+        await pretty.plain('Flags:');
+        for (const flag of help.flags) {
+            await pretty.plain(`  ${flag.name.padEnd(20)} ${flag.description}`);
+        }
+    }
+}

package/dist/cli/commands/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Version command - Show CLI version
+ */
+export interface VersionOptions {
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+}
+export declare function execute(args: string[], options: VersionOptions): Promise<void>;

package/dist/cli/commands/version.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Version command - Show CLI version
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const cli_spec_1 = require("../spec/cli-spec");
+const pretty_logger_1 = require("../../utils/pretty-logger");
+function outputJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function formatSuccess(data) {
+    return { success: true, data };
+}
+async function execute(args, options) {
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    // Load package.json for version
+    let packageVersion = '0.0.0';
+    try {
+        const pkg = require('../../../package.json');
+        packageVersion = pkg.version;
+    }
+    catch {
+        // Fallback if package.json not found
+    }
+    const versionInfo = {
+        version: packageVersion,
+        cli_spec: cli_spec_1.CLI_SPEC_VERSION,
+        runtime: 'node',
+        node_version: process.version
+    };
+    if (outputFormat === 'json') {
+        outputJson(formatSuccess(versionInfo));
+    }
+    else {
+        await pretty_logger_1.PrettyLogger.plain(`overai v${packageVersion}`);
+        await pretty_logger_1.PrettyLogger.dim(`CLI Spec: v${cli_spec_1.CLI_SPEC_VERSION}`);
+        await pretty_logger_1.PrettyLogger.dim(`Node: ${process.version}`);
+    }
+}

package/dist/cli/commands/voice.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Voice command - Text-to-speech and speech-to-text
+ */
+export interface VoiceOptions {
+    verbose?: boolean;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+    provider?: string;
+}
+export declare function execute(args: string[], options: VoiceOptions): Promise<void>;

package/dist/cli/commands/voice.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Voice command - Text-to-speech and speech-to-text
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const json_1 = require("../output/json");
+const pretty = __importStar(require("../output/pretty"));
+const cli_spec_1 = require("../spec/cli-spec");
+const errors_1 = require("../output/errors");
+async function execute(args, options) {
+    const action = args[0] || 'help';
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    try {
+        switch (action) {
+            case 'providers':
+                await listProviders(outputFormat);
+                break;
+            case 'info':
+                await showInfo(outputFormat);
+                break;
+            case 'help':
+            default:
+                await showHelp(outputFormat);
+                break;
+        }
+    }
+    catch (error) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.UNKNOWN, error instanceof Error ? error.message : String(error)));
+        }
+        else {
+            await pretty.error(error instanceof Error ? error.message : String(error));
+        }
+        process.exit(cli_spec_1.EXIT_CODES.RUNTIME_ERROR);
+    }
+}
+async function showInfo(outputFormat) {
+    const info = {
+        feature: 'Voice',
+        description: 'Text-to-speech and speech-to-text capabilities',
+        providers: [
+            { name: 'OpenAIVoiceProvider', description: 'OpenAI TTS and Whisper' },
+            { name: 'ElevenLabsVoiceProvider', description: 'ElevenLabs voice synthesis' }
+        ],
+        capabilities: [
+            'Text-to-speech conversion',
+            'Speech-to-text transcription',
+            'Multiple voice options',
+            'Streaming audio support'
+        ],
+        sdkUsage: `
+import { createOpenAIVoice, createElevenLabsVoice } from 'praisonai';
+
+// Create OpenAI voice provider
+const voice = createOpenAIVoice({ apiKey: process.env.OPENAI_API_KEY });
+
+// Text to speech
+const audio = await voice.speak({ text: 'Hello world', voice: 'alloy' });
+
+// Speech to text
+const text = await voice.listen({ audio: audioBuffer });
+`
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(info));
+    }
+    else {
+        await pretty.heading('Voice');
+        await pretty.plain(info.description);
+        await pretty.newline();
+        await pretty.plain('Providers:');
+        for (const p of info.providers) {
+            await pretty.plain(`  • ${p.name}: ${p.description}`);
+        }
+        await pretty.newline();
+        await pretty.plain('Capabilities:');
+        for (const cap of info.capabilities) {
+            await pretty.plain(`  • ${cap}`);
+        }
+    }
+}
+async function listProviders(outputFormat) {
+    const providers = [
+        { name: 'openai', description: 'OpenAI TTS and Whisper', available: true },
+        { name: 'elevenlabs', description: 'ElevenLabs voice synthesis', available: true }
+    ];
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ providers }));
+    }
+    else {
+        await pretty.heading('Voice Providers');
+        for (const p of providers) {
+            const status = p.available ? '✓' : '✗';
+            await pretty.plain(`  ${status} ${p.name.padEnd(15)} ${p.description}`);
+        }
+    }
+}
+async function showHelp(outputFormat) {
+    const help = {
+        command: 'voice',
+        description: 'Text-to-speech and speech-to-text capabilities',
+        subcommands: [
+            { name: 'info', description: 'Show voice feature information' },
+            { name: 'providers', description: 'List available voice providers' },
+            { name: 'help', description: 'Show this help' }
+        ],
+        flags: [
+            { name: '--provider', description: 'Voice provider (openai, elevenlabs)' }
+        ]
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(help));
+    }
+    else {
+        await pretty.heading('Voice Command');
+        await pretty.plain(help.description);
+        await pretty.newline();
+        await pretty.plain('Subcommands:');
+        for (const cmd of help.subcommands) {
+            await pretty.plain(`  ${cmd.name.padEnd(20)} ${cmd.description}`);
+        }
+        await pretty.newline();
+        await pretty.plain('Flags:');
+        for (const flag of help.flags) {
+            await pretty.plain(`  ${flag.name.padEnd(20)} ${flag.description}`);
+        }
+    }
+}

package/dist/cli/commands/workflow.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Workflow command - Execute a multi-agent workflow
+ */
+export interface WorkflowOptions {
+    parallel?: boolean;
+    model?: string;
+    verbose?: boolean;
+    profile?: string;
+    config?: string;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+}
+export declare function execute(args: string[], options: WorkflowOptions): Promise<void>;

package/dist/cli/commands/workflow.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Workflow command - Execute a multi-agent workflow
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const resolve_1 = require("../config/resolve");
+const json_1 = require("../output/json");
+const pretty = __importStar(require("../output/pretty"));
+const cli_spec_1 = require("../spec/cli-spec");
+const errors_1 = require("../output/errors");
+/**
+ * Simple YAML parser for workflow files
+ */
+function parseWorkflowYaml(content) {
+    const result = {};
+    const lines = content.split('\n');
+    let currentSection = null;
+    let currentItem = null;
+    let currentKey = null;
+    for (const line of lines) {
+        if (!line.trim() || line.trim().startsWith('#'))
+            continue;
+        const indent = line.search(/\S/);
+        const trimmed = line.trim();
+        // Top-level keys
+        if (indent === 0 && trimmed.includes(':')) {
+            const colonIdx = trimmed.indexOf(':');
+            const key = trimmed.slice(0, colonIdx).trim();
+            const value = trimmed.slice(colonIdx + 1).trim();
+            if (value) {
+                result[key] = value;
+            }
+            else {
+                currentSection = key;
+                if (key === 'agents')
+                    result.agents = {};
+                if (key === 'steps')
+                    result.steps = [];
+            }
+        }
+        else if (indent > 0 && currentSection) {
+            // Handle list items (steps)
+            if (trimmed.startsWith('- ')) {
+                if (currentSection === 'steps') {
+                    currentItem = {};
+                    result.steps.push(currentItem);
+                    // Parse inline values after -
+                    const afterDash = trimmed.slice(2).trim();
+                    if (afterDash.includes(':')) {
+                        const colonIdx = afterDash.indexOf(':');
+                        const key = afterDash.slice(0, colonIdx).trim();
+                        const value = afterDash.slice(colonIdx + 1).trim();
+                        currentItem[key] = value;
+                    }
+                }
+            }
+            else if (trimmed.includes(':') && currentItem) {
+                const colonIdx = trimmed.indexOf(':');
+                const key = trimmed.slice(0, colonIdx).trim();
+                const value = trimmed.slice(colonIdx + 1).trim();
+                currentItem[key] = value || [];
+            }
+        }
+    }
+    return result;
+}
+async function execute(args, options) {
+    const workflowFile = args[0];
+    if (!workflowFile) {
+        if (options.json || options.output === 'json') {
+            (0, json_1.printError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide a workflow file path');
+        }
+        else {
+            await pretty.error('Please provide a workflow file path');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    // Resolve config
+    const config = (0, resolve_1.resolveConfig)({
+        configPath: options.config,
+        profile: options.profile,
+        model: options.model,
+        verbose: options.verbose
+    });
+    const startTime = Date.now();
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    try {
+        // Read and parse workflow file
+        const filePath = path.resolve(workflowFile);
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`Workflow file not found: ${filePath}`);
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const workflow = parseWorkflowYaml(content);
+        if (outputFormat !== 'json') {
+            await pretty.heading(`Executing workflow: ${workflow.name || 'Unnamed'}`);
+            if (workflow.description) {
+                await pretty.info(workflow.description);
+            }
+        }
+        // Execute workflow steps
+        const results = {};
+        const steps = workflow.steps || [];
+        for (const step of steps) {
+            if (outputFormat !== 'json') {
+                await pretty.info(`Running step: ${step.name}`);
+            }
+            // For now, we'll simulate step execution
+            // In a full implementation, this would create agents and execute tasks
+            results[step.name] = {
+                status: 'completed',
+                output: `Step ${step.name} completed`
+            };
+        }
+        const duration = Date.now() - startTime;
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatSuccess)({
+                workflow: workflow.name || 'Unnamed',
+                steps: steps.length,
+                results
+            }, {
+                duration_ms: duration,
+                model: config.model
+            }));
+        }
+        else {
+            await pretty.success(`Workflow completed in ${duration}ms`);
+            await pretty.newline();
+            await pretty.keyValue({
+                'Steps executed': steps.length,
+                'Duration': `${duration}ms`
+            });
+        }
+    }
+    catch (error) {
+        const cliError = (0, errors_1.normalizeError)(error);
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(cliError.code, cliError.message, cliError.details));
+        }
+        else {
+            await pretty.error(cliError.message);
+            if (config.verbose && error instanceof Error && error.stack) {
+                await pretty.dim(error.stack);
+            }
+        }
+        process.exit(cliError.exitCode);
+    }
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Config utilities index
+ */
+export * from './schema';
+export * from './load';
+export * from './resolve';

package/dist/cli/config/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Config utilities index
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./schema"), exports);
+__exportStar(require("./load"), exports);
+__exportStar(require("./resolve"), exports);

package/dist/cli/config/load.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Config file loading
+ */
+import { FullConfig } from './schema';
+export interface LoadConfigOptions {
+    configPath?: string;
+    cwd?: string;
+}
+/**
+ * Load config from file
+ */
+export declare function loadConfigFile(filePath: string): FullConfig;
+/**
+ * Load config with resolution order:
+ * 1. Explicit config path
+ * 2. Project config (current dir and parents)
+ * 3. User config (~/.praisonai.yaml)
+ * 4. Defaults
+ */
+export declare function loadConfig(options?: LoadConfigOptions): FullConfig;