overai 1.4.0

package/dist/cli/commands/cache.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Cache command - Caching 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 'info':
+                await showInfo(outputFormat);
+                break;
+            case 'providers':
+                await listProviders(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: 'Cache',
+        description: 'Caching system for LLM responses and computations',
+        providers: [
+            { name: 'MemoryCache', description: 'In-memory cache (default)' },
+            { name: 'FileCache', description: 'File-based persistent cache' }
+        ],
+        capabilities: [
+            'Cache LLM responses',
+            'Reduce API costs',
+            'Improve response times',
+            'TTL-based expiration',
+            'Configurable cache keys'
+        ]
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(info));
+    }
+    else {
+        await pretty.heading('Cache');
+        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: 'memory', description: 'In-memory cache', available: true },
+        { name: 'file', description: 'File-based cache', available: true }
+    ];
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)({ providers }));
+    }
+    else {
+        await pretty.heading('Cache 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: 'cache',
+        description: 'Caching management for LLM responses',
+        subcommands: [
+            { name: 'info', description: 'Show cache feature information' },
+            { name: 'providers', description: 'List available cache providers' },
+            { name: 'help', description: 'Show this help' }
+        ]
+    };
+    if (outputFormat === 'json') {
+        (0, json_1.outputJson)((0, json_1.formatSuccess)(help));
+    }
+    else {
+        await pretty.heading('Cache 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}`);
+        }
+    }
+}

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

@@ -0,0 +1,14 @@
+/**
+ * Chat command - Chat with an AI agent
+ */
+export interface ChatOptions {
+    model?: string;
+    stream?: boolean;
+    session?: string;
+    verbose?: boolean;
+    profile?: string;
+    config?: string;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+}
+export declare function execute(args: string[], options: ChatOptions): Promise<void>;

package/dist/cli/commands/chat.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Chat command - Chat with an AI agent
+ */
+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 backend_resolver_1 = require("../../llm/backend-resolver");
+const session_1 = require("../../session");
+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");
+async function execute(args, options) {
+    const prompt = args[0];
+    if (!prompt) {
+        if (options.json || options.output === 'json') {
+            (0, json_1.printError)(errors_1.ERROR_CODES.MISSING_ARG, 'Please provide a prompt');
+        }
+        else {
+            await pretty.error('Please provide a prompt');
+        }
+        process.exit(cli_spec_1.EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    // Resolve config with precedence
+    const config = (0, resolve_1.resolveConfig)({
+        configPath: options.config,
+        profile: options.profile,
+        model: options.model,
+        verbose: options.verbose,
+        stream: options.stream
+    });
+    const startTime = Date.now();
+    const outputFormat = options.json ? 'json' : (options.output || 'pretty');
+    try {
+        const { provider } = await (0, backend_resolver_1.resolveBackend)(config.model);
+        const session = new session_1.Session({ id: options.session });
+        session.addMessage({ role: 'user', content: prompt });
+        let responseText = '';
+        let inputTokens = 0;
+        let outputTokens = 0;
+        if (config.stream && outputFormat !== 'json') {
+            // Streaming mode (only for non-JSON output)
+            const stream = await provider.streamText({
+                messages: [{ role: 'user', content: prompt }],
+                onToken: (token) => {
+                    process.stdout.write(token);
+                    responseText += token;
+                }
+            });
+            for await (const chunk of stream) {
+                // Stream is consumed by onToken
+            }
+            console.log(); // New line after streaming
+        }
+        else {
+            // Non-streaming mode
+            const result = await provider.generateText({
+                messages: [{ role: 'user', content: prompt }]
+            });
+            responseText = result.text;
+            inputTokens = result.usage?.promptTokens || 0;
+            outputTokens = result.usage?.completionTokens || 0;
+            if (outputFormat === 'json') {
+                const duration = Date.now() - startTime;
+                (0, json_1.outputJson)((0, json_1.formatSuccess)({ response: responseText }, {
+                    duration_ms: duration,
+                    model: config.model,
+                    tokens: {
+                        input: inputTokens,
+                        output: outputTokens
+                    }
+                }));
+            }
+            else {
+                console.log(responseText);
+            }
+        }
+        session.addMessage({ role: 'assistant', content: responseText });
+    }
+    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/commands/checkpoints.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI command: checkpoints
+ * Session state checkpointing and recovery
+ */
+export declare function execute(args: string[], options: Record<string, unknown>): Promise<void>;

package/dist/cli/commands/checkpoints.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * CLI command: checkpoints
+ * Session state checkpointing and recovery
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const checkpoints_1 = require("../features/checkpoints");
+let manager = null;
+function getManager(storagePath) {
+    if (!manager) {
+        const storage = storagePath ? (0, checkpoints_1.createFileCheckpointStorage)(storagePath) : undefined;
+        manager = (0, checkpoints_1.createCheckpointManager)({ storage });
+    }
+    return manager;
+}
+async function execute(args, options) {
+    const subcommand = args[0] || 'help';
+    const isJson = Boolean(options.output === 'json' || options.json);
+    const storagePath = options.storage;
+    switch (subcommand) {
+        case 'create':
+            await handleCreate(args.slice(1), options, isJson, storagePath);
+            break;
+        case 'list':
+            await handleList(isJson, storagePath);
+            break;
+        case 'get':
+            await handleGet(args.slice(1), isJson, storagePath);
+            break;
+        case 'restore':
+            await handleRestore(args.slice(1), isJson, storagePath);
+            break;
+        case 'delete':
+            await handleDelete(args.slice(1), isJson, storagePath);
+            break;
+        case 'export':
+            await handleExport(args.slice(1), isJson, storagePath);
+            break;
+        case 'import':
+            await handleImport(args.slice(1), isJson, storagePath);
+            break;
+        case 'help':
+        default:
+            showHelp(isJson);
+    }
+}
+async function handleCreate(args, options, isJson, storagePath) {
+    const name = args[0] || `checkpoint-${Date.now()}`;
+    const mgr = getManager(storagePath);
+    // Set state from options if provided
+    const state = options.state ? JSON.parse(options.state) : {};
+    mgr.setState(state);
+    const checkpoint = await mgr.create(name, {
+        sessionId: options.session,
+        metadata: options.metadata ? JSON.parse(options.metadata) : undefined
+    });
+    if (isJson) {
+        console.log(JSON.stringify({ success: true, checkpoint }, null, 2));
+    }
+    else {
+        console.log(`✓ Checkpoint created: ${checkpoint.id}`);
+        console.log(`  Name: ${checkpoint.name}`);
+        console.log(`  Time: ${checkpoint.timestamp.toISOString()}`);
+    }
+}
+async function handleList(isJson, storagePath) {
+    const mgr = getManager(storagePath);
+    const checkpoints = await mgr.list();
+    if (isJson) {
+        console.log(JSON.stringify({ success: true, checkpoints }, null, 2));
+    }
+    else {
+        if (checkpoints.length === 0) {
+            console.log('No checkpoints found');
+        }
+        else {
+            console.log('Checkpoints:');
+            for (const cp of checkpoints) {
+                console.log(`  ${cp.name} (${cp.id})`);
+                console.log(`    Created: ${cp.timestamp.toISOString()}`);
+                if (cp.sessionId)
+                    console.log(`    Session: ${cp.sessionId}`);
+            }
+        }
+    }
+}
+async function handleGet(args, isJson, storagePath) {
+    const id = args[0];
+    if (!id) {
+        console.error('Error: Checkpoint ID is required');
+        process.exit(1);
+    }
+    const mgr = getManager(storagePath);
+    const checkpoint = await mgr.get(id);
+    if (!checkpoint) {
+        if (isJson) {
+            console.log(JSON.stringify({ success: false, error: 'Checkpoint not found' }));
+        }
+        else {
+            console.error(`Checkpoint ${id} not found`);
+        }
+        process.exit(1);
+    }
+    if (isJson) {
+        console.log(JSON.stringify({ success: true, checkpoint }, null, 2));
+    }
+    else {
+        console.log(`Checkpoint: ${checkpoint.id}`);
+        console.log(`  Name: ${checkpoint.name}`);
+        console.log(`  Created: ${checkpoint.timestamp.toISOString()}`);
+        console.log(`  State: ${JSON.stringify(checkpoint.state, null, 2)}`);
+    }
+}
+async function handleRestore(args, isJson, storagePath) {
+    const id = args[0];
+    const mgr = getManager(storagePath);
+    let checkpoint;
+    if (id) {
+        checkpoint = await mgr.restore(id);
+    }
+    else {
+        checkpoint = await mgr.restoreLatest();
+    }
+    if (!checkpoint) {
+        if (isJson) {
+            console.log(JSON.stringify({ success: false, error: 'No checkpoint to restore' }));
+        }
+        else {
+            console.error('No checkpoint to restore');
+        }
+        process.exit(1);
+    }
+    if (isJson) {
+        console.log(JSON.stringify({ success: true, restored: checkpoint }, null, 2));
+    }
+    else {
+        console.log(`✓ Restored checkpoint: ${checkpoint.id}`);
+        console.log(`  Name: ${checkpoint.name}`);
+        console.log(`  State keys: ${Object.keys(checkpoint.state).join(', ') || 'none'}`);
+    }
+}
+async function handleDelete(args, isJson, storagePath) {
+    const id = args[0];
+    if (!id) {
+        console.error('Error: Checkpoint ID is required');
+        process.exit(1);
+    }
+    const mgr = getManager(storagePath);
+    await mgr.delete(id);
+    if (isJson) {
+        console.log(JSON.stringify({ success: true, deleted: id }));
+    }
+    else {
+        console.log(`✓ Checkpoint ${id} deleted`);
+    }
+}
+async function handleExport(args, isJson, storagePath) {
+    const id = args[0];
+    if (!id) {
+        console.error('Error: Checkpoint ID is required');
+        process.exit(1);
+    }
+    const mgr = getManager(storagePath);
+    const exported = await mgr.export(id);
+    if (!exported) {
+        console.error(`Checkpoint ${id} not found`);
+        process.exit(1);
+    }
+    console.log(exported);
+}
+async function handleImport(args, isJson, storagePath) {
+    const jsonData = args[0];
+    if (!jsonData) {
+        console.error('Error: JSON data is required');
+        process.exit(1);
+    }
+    const mgr = getManager(storagePath);
+    const checkpoint = await mgr.import(jsonData);
+    if (isJson) {
+        console.log(JSON.stringify({ success: true, imported: checkpoint }, null, 2));
+    }
+    else {
+        console.log(`✓ Checkpoint imported: ${checkpoint.id}`);
+    }
+}
+function showHelp(isJson) {
+    const help = {
+        command: 'checkpoints',
+        description: 'Session state checkpointing and recovery',
+        subcommands: {
+            create: 'Create a new checkpoint',
+            list: 'List all checkpoints',
+            get: 'Get checkpoint details',
+            restore: 'Restore from a checkpoint',
+            delete: 'Delete a checkpoint',
+            export: 'Export checkpoint as JSON',
+            import: 'Import checkpoint from JSON'
+        },
+        flags: {
+            '--storage': 'Path to checkpoint storage directory',
+            '--state': 'JSON state to save with checkpoint',
+            '--session': 'Session ID to associate',
+            '--metadata': 'JSON metadata',
+            '--json': 'Output in JSON format'
+        },
+        examples: [
+            'overai checkpoints create my-checkpoint',
+            'overai checkpoints create --state \'{"key": "value"}\'',
+            'overai checkpoints list',
+            'overai checkpoints restore <id>',
+            'overai checkpoints restore  # restores latest',
+            'overai checkpoints export <id> > checkpoint.json',
+            'overai checkpoints import \'{"name": "imported"}\'',
+            'overai checkpoints delete <id>'
+        ]
+    };
+    if (isJson) {
+        console.log(JSON.stringify(help, null, 2));
+    }
+    else {
+        console.log('Checkpoints - Session state checkpointing\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/context.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Context command - Manage conversation context
+ */
+export interface ContextOptions {
+    model?: string;
+    verbose?: boolean;
+    output?: 'json' | 'text' | 'pretty';
+    json?: boolean;
+    maxMessages?: number;
+}
+export declare function execute(args: string[], options: ContextOptions): Promise<void>;