ctxpkg 0.0.3 → 0.0.4

package/dist/cli/cli.chat.js

@@ -0,0 +1,311 @@
+import { input } from '@inquirer/prompts';
+import { createDocumentAgent, getLLMConfigFromAppConfig } from '../agent/agent.js';
+import { createCliClient } from './cli.client.js';
+import { chalk, formatError, formatHeader, formatInfo, withErrorHandling } from './cli.utils.js';
+import { CollectionsService } from '#root/collections/collections.js';
+import { Services } from '#root/utils/utils.services.js';
+/**
+ * Create a verbose step callback that logs agent reasoning to console
+ */
+const createVerboseCallback = () => {
+    return (step) => {
+        switch (step.type) {
+            case 'thinking':
+                console.log(chalk.dim(`  [thinking] ${step.content}`));
+                break;
+            case 'tool_call':
+                console.log(chalk.blue(`  [tool] ${step.toolName}`));
+                if (step.toolInput) {
+                    const inputPreview = JSON.stringify(step.toolInput).slice(0, 100);
+                    console.log(chalk.dim(`    Input: ${inputPreview}${inputPreview.length >= 100 ? '...' : ''}`));
+                }
+                break;
+            case 'tool_result':
+                console.log(chalk.green(`  [result] ${step.content}`));
+                break;
+            case 'error':
+                console.log(chalk.yellow(`  [retry] ${step.content}`));
+                break;
+        }
+    };
+};
+/**
+ * Resolve collection names to IDs, returning a list of resolved collection IDs
+ */
+const resolveCollectionIds = (collections, aliasMap) => {
+    if (!collections || collections.length === 0)
+        return undefined;
+    return collections.map((c) => aliasMap.get(c) ?? c);
+};
+/**
+ * Run one-shot chat mode - ask a single question and get an answer.
+ */
+const runOneShotChat = async (query, options) => {
+    // Get LLM config
+    const llmConfig = await getLLMConfigFromAppConfig();
+    if (!llmConfig.apiKey) {
+        formatError('LLM API key not configured. Set it with: ctxpkg config set llm.apiKey <key>');
+        formatError('Or use environment variable: CTXPKG_LLM_API_KEY=<key>');
+        process.exitCode = 1;
+        return;
+    }
+    // Override model if specified
+    if (options.model) {
+        llmConfig.model = options.model;
+    }
+    // Prompt for use case if not provided
+    let useCase = options.useCase;
+    if (!useCase) {
+        useCase = await input({
+            message: 'What is your use case? (helps find relevant information)',
+        });
+    }
+    if (!useCase) {
+        formatError('Use case is required to help the agent find relevant information.');
+        process.exitCode = 1;
+        return;
+    }
+    const client = await createCliClient();
+    const services = new Services();
+    try {
+        // Build alias map
+        const aliasMap = new Map();
+        const collectionsService = services.get(CollectionsService);
+        const includeGlobal = options.global !== false;
+        if (includeGlobal) {
+            const allCollections = collectionsService.getAllCollections();
+            for (const [alias, { spec }] of allCollections) {
+                const collectionId = collectionsService.computeCollectionId(spec);
+                aliasMap.set(alias, collectionId);
+            }
+        }
+        else if (collectionsService.projectConfigExists()) {
+            const projectConfig = collectionsService.readProjectConfig();
+            for (const [alias, spec] of Object.entries(projectConfig.collections)) {
+                const collectionId = collectionsService.computeCollectionId(spec);
+                aliasMap.set(alias, collectionId);
+            }
+        }
+        // Resolve collection filtering
+        const resolvedCollections = resolveCollectionIds(options.collections, aliasMap);
+        // Create verbose callback if needed
+        const onStep = options.verbose ? createVerboseCallback() : undefined;
+        // Create agent with collection filtering
+        const agent = createDocumentAgent({
+            client,
+            llmConfig,
+            aliasMap,
+            collections: resolvedCollections,
+            onStep,
+        });
+        formatInfo('Searching documentation...\n');
+        // Ask the question
+        const response = await agent.ask(query, useCase);
+        // Display answer
+        formatHeader('Answer');
+        console.log(response.answer);
+        console.log();
+        // Display sources
+        if (response.sources.length > 0) {
+            formatHeader('Sources');
+            for (const source of response.sources) {
+                const section = source.section ? ` → "${source.section}"` : '';
+                console.log(`${chalk.dim('•')} ${chalk.cyan(source.collection)}: ${source.document}${section}`);
+            }
+            console.log();
+        }
+        // Display confidence and note
+        const confidenceColor = response.confidence === 'high' ? chalk.green : response.confidence === 'medium' ? chalk.yellow : chalk.red;
+        console.log(`Confidence: ${confidenceColor(response.confidence)}`);
+        if (response.note) {
+            console.log(`\n${chalk.dim('Note:')} ${response.note}`);
+        }
+    }
+    finally {
+        await client.disconnect();
+        await services.destroy();
+    }
+};
+/**
+ * Run interactive chat mode - continuous conversation with the agent.
+ */
+const runInteractiveChat = async (options) => {
+    // Get LLM config
+    const llmConfig = await getLLMConfigFromAppConfig();
+    if (!llmConfig.apiKey) {
+        formatError('LLM API key not configured. Set it with: ctxpkg config set llm.apiKey <key>');
+        formatError('Or use environment variable: CTXPKG_LLM_API_KEY=<key>');
+        process.exitCode = 1;
+        return;
+    }
+    // Override model if specified
+    if (options.model) {
+        llmConfig.model = options.model;
+    }
+    const client = await createCliClient();
+    const services = new Services();
+    try {
+        // Build alias map
+        const aliasMap = new Map();
+        const collectionsService = services.get(CollectionsService);
+        const includeGlobal = options.global !== false;
+        if (includeGlobal) {
+            const allCollections = collectionsService.getAllCollections();
+            for (const [alias, { spec }] of allCollections) {
+                const collectionId = collectionsService.computeCollectionId(spec);
+                aliasMap.set(alias, collectionId);
+            }
+        }
+        else if (collectionsService.projectConfigExists()) {
+            const projectConfig = collectionsService.readProjectConfig();
+            for (const [alias, spec] of Object.entries(projectConfig.collections)) {
+                const collectionId = collectionsService.computeCollectionId(spec);
+                aliasMap.set(alias, collectionId);
+            }
+        }
+        // Resolve collection filtering
+        const resolvedCollections = resolveCollectionIds(options.collections, aliasMap);
+        // Track verbose mode state
+        let verbose = options.verbose ?? false;
+        // Create agent with collection filtering
+        const agent = createDocumentAgent({
+            client,
+            llmConfig,
+            aliasMap,
+            collections: resolvedCollections,
+        });
+        // Display header
+        formatHeader('ctxpkg Chat');
+        console.log('Type your questions. Commands: /help, /use-case, /clear, /verbose, /quit');
+        console.log();
+        // Get initial use case
+        let useCase = options.useCase;
+        if (!useCase) {
+            useCase = await input({
+                message: 'What are you trying to accomplish?',
+            });
+        }
+        if (!useCase) {
+            formatError('Use case is required.');
+            process.exitCode = 1;
+            return;
+        }
+        console.log();
+        console.log(chalk.dim(`Use case: ${useCase}`));
+        if (verbose) {
+            console.log(chalk.dim('Verbose mode: on'));
+        }
+        console.log();
+        // Chat loop
+        while (true) {
+            let message;
+            try {
+                message = await input({ message: chalk.cyan('You:') });
+            }
+            catch {
+                // Handle Ctrl+C
+                console.log('\nGoodbye!');
+                break;
+            }
+            if (!message.trim()) {
+                continue;
+            }
+            // Handle commands
+            if (message.startsWith('/')) {
+                const cmd = message.toLowerCase().trim();
+                if (cmd === '/quit' || cmd === '/exit' || cmd === '/q') {
+                    console.log('Goodbye!');
+                    break;
+                }
+                if (cmd === '/help' || cmd === '/h') {
+                    console.log('\nCommands:');
+                    console.log('  /help, /h       Show this help');
+                    console.log('  /use-case, /u   Change use case');
+                    console.log('  /clear, /c      Clear conversation history');
+                    console.log('  /verbose, /v    Toggle verbose mode');
+                    console.log('  /quit, /q       Exit chat\n');
+                    continue;
+                }
+                if (cmd === '/use-case' || cmd === '/u') {
+                    console.log(chalk.dim(`Current use case: ${useCase}`));
+                    const newUseCase = await input({ message: 'New use case (or press enter to keep current):' });
+                    if (newUseCase.trim()) {
+                        useCase = newUseCase;
+                        agent.clearHistory(); // Clear history when use case changes
+                        console.log(chalk.dim(`Use case updated: ${useCase}`));
+                        console.log(chalk.dim('Conversation history cleared.\n'));
+                    }
+                    continue;
+                }
+                if (cmd === '/clear' || cmd === '/c') {
+                    agent.clearHistory();
+                    console.log(chalk.dim('Conversation history cleared.\n'));
+                    continue;
+                }
+                if (cmd === '/verbose' || cmd === '/v') {
+                    verbose = !verbose;
+                    console.log(chalk.dim(`Verbose mode: ${verbose ? 'on' : 'off'}\n`));
+                    continue;
+                }
+                console.log(chalk.yellow(`Unknown command: ${message}. Type /help for available commands.\n`));
+                continue;
+            }
+            // Ask the question using chat (maintains history)
+            console.log();
+            formatInfo('Searching...');
+            try {
+                const onStep = verbose ? createVerboseCallback() : undefined;
+                const response = await agent.chat(message, useCase, { onStep });
+                console.log();
+                console.log(response.answer);
+                console.log();
+                if (response.sources.length > 0) {
+                    console.log(chalk.dim('Sources:'));
+                    for (const source of response.sources) {
+                        const section = source.section ? ` → "${source.section}"` : '';
+                        console.log(chalk.dim(`  • ${source.collection}: ${source.document}${section}`));
+                    }
+                    console.log();
+                }
+                // Show conversation length in verbose mode
+                if (verbose) {
+                    console.log(chalk.dim(`[${agent.getHistoryLength()} messages in history]\n`));
+                }
+            }
+            catch (error) {
+                const errMessage = error instanceof Error ? error.message : String(error);
+                formatError(`Error: ${errMessage}`);
+                console.log();
+            }
+        }
+    }
+    finally {
+        await client.disconnect();
+        await services.destroy();
+    }
+};
+const createChatCli = (command) => {
+    command
+        .description('Chat with your documentation using AI')
+        .argument('[query]', 'Question to ask (starts one-shot mode)')
+        .option('-i, --interactive', 'Start interactive chat session')
+        .option('-u, --use-case <text>', 'Context for why you need this information')
+        .option('-c, --collections <names...>', 'Limit to specific collections')
+        .option('--no-global', 'Exclude global collections')
+        .option('--model <model>', 'Override LLM model from config')
+        .option('--verbose', 'Show agent reasoning (not yet implemented)')
+        .action(withErrorHandling(async (query, options) => {
+        if (options.interactive) {
+            await runInteractiveChat(options);
+        }
+        else if (query) {
+            await runOneShotChat(query, options);
+        }
+        else {
+            // No query and not interactive - start interactive mode
+            await runInteractiveChat(options);
+        }
+    }));
+};
+export { createChatCli };
+//# sourceMappingURL=cli.chat.js.map

package/dist/cli/cli.chat.js.map

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

package/dist/cli/cli.client.d.ts

@@ -0,0 +1,11 @@
+import { BackendClient } from '#root/client/client.js';
+type CliClientMode = 'auto' | 'direct' | 'daemon';
+type CliClientOptions = {
+    mode?: CliClientMode;
+    socketPath?: string;
+    timeout?: number;
+};
+declare const createCliClient: (options?: CliClientOptions) => Promise<BackendClient>;
+export { createCliClient };
+export type { CliClientOptions, CliClientMode };
+//# sourceMappingURL=cli.client.d.ts.map

package/dist/cli/cli.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.client.d.ts","sourceRoot":"","sources":["../../src/cli/cli.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,KAAK,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAGF,QAAA,MAAM,eAAe,GAAU,UAAU,gBAAgB,KAAG,OAAO,CAAC,aAAa,CAuChF,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/cli/cli.client.js

@@ -0,0 +1,40 @@
+import { BackendClient } from '#root/client/client.js';
+import { DaemonManager } from '#root/daemon/daemon.manager.js';
+// Factory function for CLI commands
+const createCliClient = async (options) => {
+    const mode = options?.mode ?? 'auto';
+    if (mode === 'auto') {
+        // Try daemon first, fall back to direct
+        const manager = new DaemonManager({ socketPath: options?.socketPath });
+        const isDaemonRunning = await manager.isRunning();
+        if (isDaemonRunning) {
+            const client = new BackendClient({
+                mode: 'daemon',
+                socketPath: options?.socketPath,
+                timeout: options?.timeout,
+            });
+            await client.connect();
+            return client;
+        }
+        // Fall back to direct mode
+        const client = new BackendClient({ mode: 'direct' });
+        await client.connect();
+        return client;
+    }
+    if (mode === 'daemon') {
+        const client = new BackendClient({
+            mode: 'daemon',
+            socketPath: options?.socketPath,
+            autoStartDaemon: true,
+            timeout: options?.timeout,
+        });
+        await client.connect();
+        return client;
+    }
+    // Direct mode
+    const client = new BackendClient({ mode: 'direct' });
+    await client.connect();
+    return client;
+};
+export { createCliClient };
+//# sourceMappingURL=cli.client.js.map

package/dist/cli/cli.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.client.js","sourceRoot":"","sources":["../../src/cli/cli.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAU/D,oCAAoC;AACpC,MAAM,eAAe,GAAG,KAAK,EAAE,OAA0B,EAA0B,EAAE;IACnF,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,MAAM,CAAC;IAErC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QACvE,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QAElD,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;gBAC/B,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,OAAO,EAAE,UAAU;gBAC/B,OAAO,EAAE,OAAO,EAAE,OAAO;aAC1B,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,2BAA2B;QAC3B,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;YAC/B,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO,EAAE,UAAU;YAC/B,eAAe,EAAE,IAAI;YACrB,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,cAAc;IACd,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/cli/cli.collections.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+declare const createCollectionsCli: (command: Command) => void;
+export { createCollectionsCli };
+//# sourceMappingURL=cli.collections.d.ts.map

package/dist/cli/cli.collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.collections.d.ts","sourceRoot":"","sources":["../../src/cli/cli.collections.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBzC,QAAA,MAAM,oBAAoB,GAAI,SAAS,OAAO,SAgc7C,CAAC;AAgBF,OAAO,EAAE,oBAAoB,EAAE,CAAC"}