overai 1.4.0

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

@@ -0,0 +1,9 @@
+/**
+ * MCP command - Model Context Protocol management
+ */
+export interface MCPOptions {
+    verbose?: boolean;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+}
+export declare function execute(args: string[], options: MCPOptions): Promise<void>;

package/dist/cli/commands/mcp.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * MCP command - Model Context Protocol 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");
+const mcpServers = new Map();
+async function execute(args, options) {
+    const action = args[0] || 'list';
+    const actionArgs = args.slice(1);
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    try {
+        switch (action) {
+            case 'list':
+                await listServers(outputFormat);
+                break;
+            case 'add':
+                await addServer(actionArgs, outputFormat);
+                break;
+            case 'remove':
+                await removeServer(actionArgs, outputFormat);
+                break;
+            case 'start':
+                await startServer(actionArgs, outputFormat);
+                break;
+            case 'stop':
+                await stopServer(actionArgs, 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 listServers(outputFormat) {
+    const servers = Array.from(mcpServers.values());
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({
+            servers,
+            count: servers.length
+        }));
+    }
+    else {
+        await pretty.heading('MCP Servers');
+        if (servers.length === 0) {
+            await pretty.info('No MCP servers registered');
+            await pretty.dim('Run "praisonai-ts mcp add <name> <command>" to add a server');
+        }
+        else {
+            for (const server of servers) {
+                const statusIcon = server.status === 'running' ? '🟢' : '⚪';
+                await pretty.plain(`  ${statusIcon} ${server.name}`);
+                await pretty.dim(`    Command: ${server.command} ${(server.args || []).join(' ')}`);
+            }
+        }
+        await pretty.newline();
+        await pretty.info(`Total: ${servers.length} servers`);
+    }
+}
+async function addServer(args, outputFormat) {
+    const name = args[0];
+    const command = args[1];
+    const serverArgs = args.slice(2);
+    if (!name || !command) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide server name and command'));
+        }
+        else {
+            await pretty.error('Please provide server name and command');
+            await pretty.dim('Usage: praisonai-ts mcp add <name> <command> [args...]');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    const server = {
+        name,
+        command,
+        args: serverArgs.length > 0 ? serverArgs : undefined,
+        status: 'stopped'
+    };
+    mcpServers.set(name, server);
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ added: true, server }));
+    }
+    else {
+        await pretty.success(`MCP server added: ${name}`);
+        await pretty.dim(`Command: ${command} ${serverArgs.join(' ')}`);
+    }
+}
+async function removeServer(args, outputFormat) {
+    const name = args[0];
+    if (!name) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide server name'));
+        }
+        else {
+            await pretty.error('Please provide server name');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    const removed = mcpServers.delete(name);
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ removed, name }));
+    }
+    else {
+        if (removed) {
+            await pretty.success(`MCP server removed: ${name}`);
+        }
+        else {
+            await pretty.warn(`Server not found: ${name}`);
+        }
+    }
+}
+async function startServer(args, outputFormat) {
+    const name = args[0];
+    if (!name) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide server name'));
+        }
+        else {
+            await pretty.error('Please provide server name');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    const server = mcpServers.get(name);
+    if (!server) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.UNKNOWN, `Server not found: ${name}`));
+        }
+        else {
+            await pretty.error(`Server not found: ${name}`);
+        }
+        process.exit(cli_spec_1.EXIT_CODES.RUNTIME_ERROR);
+    }
+    // Mark as running (actual process management would be more complex)
+    server.status = 'running';
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ started: true, server }));
+    }
+    else {
+        await pretty.success(`MCP server started: ${name}`);
+    }
+}
+async function stopServer(args, outputFormat) {
+    const name = args[0];
+    if (!name) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide server name'));
+        }
+        else {
+            await pretty.error('Please provide server name');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    const server = mcpServers.get(name);
+    if (!server) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.UNKNOWN, `Server not found: ${name}`));
+        }
+        else {
+            await pretty.error(`Server not found: ${name}`);
+        }
+        process.exit(cli_spec_1.EXIT_CODES.RUNTIME_ERROR);
+    }
+    server.status = 'stopped';
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ stopped: true, server }));
+    }
+    else {
+        await pretty.success(`MCP server stopped: ${name}`);
+    }
+}
+async function showHelp(outputFormat) {
+    const help = {
+        command: 'mcp',
+        description: 'Model Context Protocol server management',
+        subcommands: [
+            { name: 'list', description: 'List registered MCP servers' },
+            { name: 'add <name> <cmd> [args]', description: 'Add an MCP server' },
+            { name: 'remove <name>', description: 'Remove an MCP server' },
+            { name: 'start <name>', description: 'Start an MCP server' },
+            { name: 'stop <name>', description: 'Stop an MCP server' },
+            { name: 'help', description: 'Show this help' }
+        ]
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(help));
+    }
+    else {
+        await pretty.heading('MCP Command');
+        await pretty.plain('Model Context Protocol server management\n');
+        await pretty.plain('Subcommands:');
+        for (const cmd of help.subcommands) {
+            await pretty.plain(`  ${cmd.name.padEnd(25)} ${cmd.description}`);
+        }
+    }
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Memory command - Manage agent memory
+ */
+export interface MemoryOptions {
+    userId?: string;
+    verbose?: boolean;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+}
+export declare function execute(args: string[], options: MemoryOptions): Promise<void>;

package/dist/cli/commands/memory.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Memory command - Manage agent memory
+ */
+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 memory_1 = require("../../memory/memory");
+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] || 'list';
+    const actionArgs = args.slice(1);
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    try {
+        const memory = (0, memory_1.createMemory)();
+        switch (action) {
+            case 'list':
+                await listMemories(memory, outputFormat);
+                break;
+            case 'add':
+                await addMemory(memory, actionArgs, outputFormat);
+                break;
+            case 'search':
+                await searchMemory(memory, actionArgs, outputFormat);
+                break;
+            case 'clear':
+                await clearMemory(memory, 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 listMemories(memory, outputFormat) {
+    const entries = memory.getAll();
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({
+            memories: entries,
+            count: entries.length
+        }));
+    }
+    else {
+        await pretty.heading('Memory Entries');
+        if (entries.length === 0) {
+            await pretty.info('No memories stored');
+        }
+        else {
+            for (const entry of entries) {
+                await pretty.plain(`  • ${entry.content.substring(0, 100)}${entry.content.length > 100 ? '...' : ''}`);
+                if (entry.metadata) {
+                    await pretty.dim(`    Created: ${new Date(entry.timestamp).toISOString()}`);
+                }
+            }
+        }
+        await pretty.newline();
+        await pretty.info(`Total: ${entries.length} memories`);
+    }
+}
+async function addMemory(memory, args, outputFormat) {
+    const content = args.join(' ');
+    if (!content) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide content to add'));
+        }
+        else {
+            await pretty.error('Please provide content to add');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    await memory.add(content, 'user');
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ added: content }));
+    }
+    else {
+        await pretty.success('Memory added successfully');
+    }
+}
+async function searchMemory(memory, args, outputFormat) {
+    const query = args.join(' ');
+    if (!query) {
+        if (outputFormat === 'json') {
+            (0, json_1.outputJson)((0, json_1.formatError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide a search query'));
+        }
+        else {
+            await pretty.error('Please provide a search query');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    const results = await memory.search(query);
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({
+            query,
+            results,
+            count: results.length
+        }));
+    }
+    else {
+        await pretty.heading(`Search Results for: "${query}"`);
+        if (results.length === 0) {
+            await pretty.info('No matching memories found');
+        }
+        else {
+            for (const result of results) {
+                const content = result.entry.content;
+                await pretty.plain(`  • ${content.substring(0, 100)}${content.length > 100 ? '...' : ''}`);
+                await pretty.dim(`    Score: ${result.score.toFixed(3)}`);
+            }
+        }
+        await pretty.newline();
+        await pretty.info(`Found: ${results.length} results`);
+    }
+}
+async function clearMemory(memory, outputFormat) {
+    memory.clear();
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ cleared: true }));
+    }
+    else {
+        await pretty.success('Memory cleared successfully');
+    }
+}
+async function showHelp(outputFormat) {
+    const help = {
+        command: 'memory',
+        subcommands: [
+            { name: 'list', description: 'List all memories' },
+            { name: 'add <content>', description: 'Add a new memory' },
+            { name: 'search <query>', description: 'Search memories' },
+            { name: 'clear', description: 'Clear all memories' },
+            { name: 'help', description: 'Show this help' }
+        ],
+        options: [
+            { name: '--user-id', description: 'User ID for memory isolation' }
+        ]
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(help));
+    }
+    else {
+        await pretty.heading('Memory Command');
+        await pretty.plain('Manage agent memory storage\n');
+        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('Options:');
+        for (const opt of help.options) {
+            await pretty.plain(`  ${opt.name.padEnd(20)} ${opt.description}`);
+        }
+    }
+}

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

@@ -0,0 +1,5 @@
+/**
+ * CLI command: n8n
+ * N8N workflow integration
+ */
+export declare function execute(args: string[], options: Record<string, unknown>): Promise<void>;

package/dist/cli/commands/n8n.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * CLI command: n8n
+ * N8N workflow integration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const n8n_integration_1 = require("../features/n8n-integration");
+async function execute(args, options) {
+    const subcommand = args[0] || 'help';
+    const isJson = Boolean(options.output === 'json' || options.json);
+    switch (subcommand) {
+        case 'trigger':
+            await handleTrigger(args.slice(1), options, isJson);
+            break;
+        case 'export':
+            await handleExport(args.slice(1), options, isJson);
+            break;
+        case 'help':
+        default:
+            showHelp(isJson);
+    }
+}
+async function handleTrigger(args, options, isJson) {
+    const webhookId = args[0];
+    const payloadStr = args[1] || '{}';
+    if (!webhookId) {
+        console.error('Error: Webhook ID is required');
+        process.exit(1);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(payloadStr);
+    }
+    catch {
+        payload = { data: payloadStr };
+    }
+    const baseUrl = options['base-url'];
+    const apiKey = options['api-key'];
+    const n8n = (0, n8n_integration_1.createN8NIntegration)({ baseUrl, apiKey });
+    const result = await n8n.triggerWebhook(webhookId, payload);
+    if (isJson) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        if (result.success) {
+            console.log(`✓ Webhook triggered: ${webhookId}`);
+            if (result.response) {
+                console.log('Response:', JSON.stringify(result.response, null, 2));
+            }
+        }
+        else {
+            console.error(`✗ Webhook failed: ${result.error}`);
+            process.exit(1);
+        }
+    }
+}
+async function handleExport(args, options, isJson) {
+    const name = args[0] || 'workflow';
+    const stepsStr = options.steps;
+    let steps = [];
+    if (stepsStr) {
+        try {
+            steps = JSON.parse(stepsStr);
+        }
+        catch {
+            // Parse simple format: "step1:agent,step2:tool"
+            steps = stepsStr.split(',').map(s => {
+                const [stepName, type] = s.split(':');
+                return { name: stepName, type: (type || 'agent') };
+            });
+        }
+    }
+    else {
+        // Default example workflow
+        steps = [
+            { name: 'Process Input', type: 'agent' },
+            { name: 'Validate', type: 'condition' },
+            { name: 'Execute', type: 'tool' }
+        ];
+    }
+    const n8n = (0, n8n_integration_1.createN8NIntegration)();
+    const workflow = n8n.exportWorkflowJSON(name, steps);
+    if (isJson || !options.pretty) {
+        console.log(workflow);
+    }
+    else {
+        console.log(`N8N Workflow: ${name}\n`);
+        console.log('Steps:');
+        for (const step of steps) {
+            console.log(`  - ${step.name} (${step.type})`);
+        }
+        console.log('\nExported workflow JSON:');
+        console.log(workflow);
+    }
+}
+function showHelp(isJson) {
+    const help = {
+        command: 'n8n',
+        description: 'N8N workflow integration',
+        subcommands: {
+            trigger: 'Trigger an N8N webhook',
+            export: 'Export workflow to N8N format'
+        },
+        flags: {
+            '--base-url': 'N8N base URL (default: http://localhost:5678)',
+            '--api-key': 'N8N API key',
+            '--steps': 'Workflow steps as JSON or "name:type,name:type"',
+            '--pretty': 'Pretty print export',
+            '--json': 'Output in JSON format'
+        },
+        examples: [
+            'overai n8n trigger my-webhook \'{"data": "test"}\'',
+            'overai n8n trigger webhook-id --base-url https://n8n.example.com',
+            'overai n8n export my-workflow',
+            'overai n8n export workflow --steps "Process:agent,Validate:condition"'
+        ]
+    };
+    if (isJson) {
+        console.log(JSON.stringify(help, null, 2));
+    }
+    else {
+        console.log('N8N - Workflow integration\n');
+        console.log('Subcommands:');
+        for (const [cmd, desc] of Object.entries(help.subcommands)) {
+            console.log(`  ${cmd.padEnd(12)} ${desc}`);
+        }
+        console.log('\nFlags:');
+        for (const [flag, desc] of Object.entries(help.flags)) {
+            console.log(`  ${flag.padEnd(12)} ${desc}`);
+        }
+        console.log('\nExamples:');
+        for (const ex of help.examples) {
+            console.log(`  ${ex}`);
+        }
+    }
+}

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

@@ -0,0 +1,16 @@
+/**
+ * Observability command - Monitoring and tracing
+ *
+ * Supports 14+ observability integrations:
+ * - list: List all available observability tools
+ * - doctor: Check environment variables for selected tool
+ * - test: Run a test trace to verify tool works
+ * - info: Show observability feature information
+ */
+export interface ObservabilityOptions {
+    verbose?: boolean;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+    tool?: string;
+}
+export declare function execute(args: string[], options: ObservabilityOptions): Promise<void>;