praisonai 1.2.2 → 1.2.3

package/dist/cli/commands/tools.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Tools command - List or manage tools
+ */
+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 decorator_1 = require("../../tools/decorator");
+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");
+// Built-in tools that are always available
+const BUILTIN_TOOLS = [
+    { name: 'arxiv_search', description: 'Search arXiv for academic papers' },
+    { name: 'web_search', description: 'Search the web for information' },
+    { name: 'calculator', description: 'Perform mathematical calculations' },
+    { name: 'code_executor', description: 'Execute code snippets' },
+    { name: 'file_reader', description: 'Read file contents' },
+    { name: 'file_writer', description: 'Write content to files' }
+];
+async function execute(args, options) {
+    const subcommand = args[0] || 'list';
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    switch (subcommand) {
+        case 'list':
+            await listTools(options, outputFormat);
+            break;
+        case 'info':
+            await toolInfo(args.slice(1), options, outputFormat);
+            break;
+        default:
+            if (outputFormat === 'json') {
+                (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.INVALID_ARGS, `Unknown subcommand: ${subcommand}`));
+            }
+            else {
+                await pretty.error(`Unknown subcommand: ${subcommand}`);
+            }
+            process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+}
+async function listTools(options, outputFormat) {
+    // Get registered tools from registry
+    const registry = (0, decorator_1.getRegistry)();
+    const registeredTools = registry.list();
+    // Combine built-in and registered tools
+    const allTools = [
+        ...BUILTIN_TOOLS,
+        ...registeredTools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters
+        }))
+    ];
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({
+            tools: allTools.map(t => ({
+                name: t.name,
+                description: t.description,
+                parameters: options.verbose ? t.parameters : undefined
+            })),
+            count: allTools.length
+        }));
+    }
+    else {
+        await pretty.heading('Available Tools');
+        await pretty.plain('Built-in Tools:');
+        for (const tool of BUILTIN_TOOLS) {
+            await pretty.plain(`  • ${tool.name}`);
+            if (tool.description) {
+                await pretty.dim(`    ${tool.description}`);
+            }
+        }
+        if (registeredTools.length > 0) {
+            await pretty.newline();
+            await pretty.plain('Registered Tools:');
+            for (const tool of registeredTools) {
+                await pretty.plain(`  • ${tool.name}`);
+                if (tool.description) {
+                    await pretty.dim(`    ${tool.description}`);
+                }
+            }
+        }
+        await pretty.newline();
+        await pretty.info(`Total: ${allTools.length} tools`);
+    }
+}
+async function toolInfo(args, options, outputFormat) {
+    const toolName = args[0];
+    if (!toolName) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide a tool name'));
+        }
+        else {
+            await pretty.error('Please provide a tool name');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    // Look for tool in built-in and registered tools
+    const builtinTool = BUILTIN_TOOLS.find(t => t.name === toolName);
+    const registry = (0, decorator_1.getRegistry)();
+    const registeredTool = registry.get(toolName);
+    const tool = builtinTool || (registeredTool ? {
+        name: registeredTool.name,
+        description: registeredTool.description,
+        parameters: registeredTool.parameters
+    } : null);
+    if (!tool) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.TOOL_NOT_FOUND, `Tool not found: ${toolName}`));
+        }
+        else {
+            await pretty.error(`Tool not found: ${toolName}`);
+        }
+        process.exit(cli_spec_1.EXIT_CODES.RUNTIME_ERROR);
+    }
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({
+            tool: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+                type: builtinTool ? 'builtin' : 'registered'
+            }
+        }));
+    }
+    else {
+        await pretty.heading(`Tool: ${tool.name}`);
+        await pretty.keyValue({
+            'Name': tool.name,
+            'Type': builtinTool ? 'Built-in' : 'Registered',
+            'Description': tool.description || 'No description'
+        });
+        if (tool.parameters && options.verbose) {
+            await pretty.newline();
+            await pretty.plain('Parameters:');
+            await pretty.plain(JSON.stringify(tool.parameters, null, 2));
+        }
+    }
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Vector command - Vector store management
+ */
+export interface VectorOptions {
+    verbose?: boolean;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+    store?: string;
+}
+export declare function execute(args: string[], options: VectorOptions): Promise<void>;

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,68 @@
+"use strict";
+/**
+ * Version command - Show CLI version
+ */
+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 cli_spec_1 = require("../spec/cli-spec");
+const json_1 = require("../output/json");
+const pretty = __importStar(require("../output/pretty"));
+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') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(versionInfo));
+    }
+    else {
+        await pretty.plain(`praisonai-ts v${packageVersion}`);
+        await pretty.dim(`CLI Spec: v${cli_spec_1.CLI_SPEC_VERSION}`);
+        await pretty.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>;