orquesta-cli 0.1.2

package/dist/agents/base/base-agent.js

@@ -0,0 +1,69 @@
+import { logger } from '../../utils/logger.js';
+export class BaseAgent {
+    llmClient;
+    config;
+    constructor(llmClient, config) {
+        this.llmClient = llmClient;
+        this.config = {
+            maxIterations: config?.maxIterations ?? 10,
+            temperature: config?.temperature ?? 0.3,
+            maxTokens: config?.maxTokens ?? 4000,
+        };
+    }
+    async runToolLoop(messages, toolExecutor) {
+        const tools = this.getTools();
+        let iterations = 0;
+        let finalResult = '';
+        logger.enter(`${this.name}.runToolLoop`);
+        while (iterations < this.config.maxIterations) {
+            iterations++;
+            logger.flow(`${this.name} iteration ${iterations}`);
+            const response = await this.llmClient.chatCompletion({
+                messages,
+                tools: tools.length > 0 ? tools : undefined,
+                temperature: this.config.temperature,
+                max_tokens: this.config.maxTokens,
+            });
+            const assistantMessage = response.choices[0]?.message;
+            if (!assistantMessage) {
+                throw new Error('No response from LLM');
+            }
+            messages.push(assistantMessage);
+            if (assistantMessage.tool_calls && assistantMessage.tool_calls.length > 0) {
+                for (const toolCall of assistantMessage.tool_calls) {
+                    let args;
+                    try {
+                        args = JSON.parse(toolCall.function.arguments);
+                    }
+                    catch (error) {
+                        logger.warn('Failed to parse tool arguments', { error, arguments: toolCall.function.arguments });
+                        messages.push({
+                            role: 'tool',
+                            content: 'Error: Invalid tool arguments. The arguments must be a valid JSON object.',
+                            tool_call_id: toolCall.id,
+                        });
+                        continue;
+                    }
+                    const result = await toolExecutor(toolCall.function.name, args);
+                    messages.push({
+                        role: 'tool',
+                        content: result,
+                        tool_call_id: toolCall.id,
+                    });
+                }
+            }
+            else {
+                finalResult = assistantMessage.content || '';
+                break;
+            }
+        }
+        logger.exit(`${this.name}.runToolLoop`, { iterations });
+        return {
+            success: true,
+            result: finalResult,
+            iterations,
+        };
+    }
+}
+export default BaseAgent;
+//# sourceMappingURL=base-agent.js.map

package/dist/agents/base/base-agent.js.map

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

package/dist/agents/docs-search/index.d.ts

@@ -0,0 +1,33 @@
+import { BaseAgent, AgentContext, AgentResult, AgentConfig } from '../base/base-agent.js';
+import { LLMClient } from '../../core/llm/llm-client.js';
+import { ToolDefinition } from '../../types/index.js';
+export type DocsSearchProgressCallback = (type: 'info' | 'tell_user' | 'complete', message: string, data?: {
+    summary?: string;
+    findings?: string;
+    sources?: string[];
+}) => void;
+export declare function setDocsSearchProgressCallback(callback: DocsSearchProgressCallback | null): void;
+export declare class DocsSearchAgent extends BaseAgent {
+    readonly name = "DocsSearchAgent";
+    readonly description = "Searches ~/.local-cli/docs using hierarchical navigation";
+    constructor(llmClient: LLMClient, config?: Partial<AgentConfig>);
+    protected getTools(): ToolDefinition[];
+    protected buildSystemPrompt(_context?: AgentContext): string;
+    execute(input: string, _context?: AgentContext): Promise<AgentResult>;
+    private formatToolArgs;
+    private formatFinalResult;
+}
+export declare function createDocsSearchAgent(llmClient: LLMClient, config?: Partial<AgentConfig>): DocsSearchAgent;
+export declare function executeDocsSearchAgent(llmClient: LLMClient, query: string): Promise<{
+    success: boolean;
+    result?: string;
+    error?: string;
+}>;
+export declare function initializeDocsDirectory(): Promise<void>;
+export declare function addDocumentationFile(filename: string, content: string): Promise<{
+    success: boolean;
+    path?: string;
+    error?: string;
+}>;
+export default DocsSearchAgent;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/docs-search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/docs-search/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAW,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ/D,MAAM,MAAM,0BAA0B,GAAG,CACvC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,EACvC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,KAC/D,IAAI,CAAC;AAUV,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,GAAG,IAAI,CAE/F;AAoBD,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,8DAA8D;gBAEtE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAI/D,SAAS,CAAC,QAAQ,IAAI,cAAc,EAAE;IAItC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM;IAItD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAqJ3E,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,iBAAiB;CAe1B;AAKD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,eAAe,CAE1G;AAKD,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAGhE;AAKD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwD7D;AAKD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB9D;AAED,eAAe,eAAe,CAAC"}

package/dist/agents/docs-search/index.js

@@ -0,0 +1,244 @@
+import { BaseAgent } from '../base/base-agent.js';
+import { DOCS_SEARCH_SYSTEM_PROMPT, buildDocsSearchUserMessage } from '../../prompts/agents/docs-search.js';
+import { DOCS_SEARCH_TOOLS, createDocsToolExecutor } from '../../tools/llm/agents/docs-search-tools.js';
+import { logger } from '../../utils/logger.js';
+let globalProgressCallback = null;
+export function setDocsSearchProgressCallback(callback) {
+    globalProgressCallback = callback;
+}
+const DEFAULT_CONFIG = {
+    temperature: 0.3,
+    maxTokens: 4000,
+};
+const SOFT_ITERATION_LIMIT = 50;
+const HARD_ITERATION_LIMIT = 100;
+export class DocsSearchAgent extends BaseAgent {
+    name = 'DocsSearchAgent';
+    description = 'Searches ~/.local-cli/docs using hierarchical navigation';
+    constructor(llmClient, config) {
+        super(llmClient, { ...DEFAULT_CONFIG, ...config });
+    }
+    getTools() {
+        return DOCS_SEARCH_TOOLS;
+    }
+    buildSystemPrompt(_context) {
+        return DOCS_SEARCH_SYSTEM_PROMPT;
+    }
+    async execute(input, _context) {
+        logger.enter('DocsSearchAgent.execute', { query: input });
+        logger.startTimer('docs-search-total');
+        const progressCallback = globalProgressCallback;
+        progressCallback?.('info', `Searching: "${input.slice(0, 50)}${input.length > 50 ? '...' : ''}"`);
+        let finalResult = null;
+        const toolExecutor = createDocsToolExecutor((message) => {
+            progressCallback?.('tell_user', message);
+            logger.debug('tell_to_user', { message });
+        }, (summary, findings, sources) => {
+            finalResult = { summary, findings, sources };
+            progressCallback?.('complete', summary, { summary, findings, sources });
+            logger.debug('submit_findings', { summary, sourcesCount: sources.length });
+        });
+        try {
+            const messages = [
+                { role: 'system', content: DOCS_SEARCH_SYSTEM_PROMPT },
+                { role: 'user', content: buildDocsSearchUserMessage(input) },
+            ];
+            let iterations = 0;
+            while (!finalResult) {
+                iterations++;
+                if (iterations === SOFT_ITERATION_LIMIT) {
+                    messages.push({
+                        role: 'system',
+                        content: `You have made ${SOFT_ITERATION_LIMIT} tool calls. Please wrap up your search and call submit_findings soon.`,
+                    });
+                    logger.warn('Docs search soft limit reached', { iterations });
+                }
+                if (iterations > HARD_ITERATION_LIMIT) {
+                    logger.error('Docs search hard limit exceeded', { iterations });
+                    return {
+                        success: false,
+                        error: `Search exceeded maximum iterations (${HARD_ITERATION_LIMIT}). Please try a more specific query.`,
+                    };
+                }
+                logger.flow(`Search iteration ${iterations}`);
+                const response = await this.llmClient.chatCompletion({
+                    messages,
+                    tools: DOCS_SEARCH_TOOLS,
+                    temperature: this.config.temperature,
+                    max_tokens: this.config.maxTokens,
+                });
+                const assistantMessage = response.choices[0]?.message;
+                if (!assistantMessage) {
+                    throw new Error('No response from LLM');
+                }
+                messages.push(assistantMessage);
+                if (assistantMessage.tool_calls && assistantMessage.tool_calls.length > 0) {
+                    for (const toolCall of assistantMessage.tool_calls) {
+                        const toolName = toolCall.function.name;
+                        let args;
+                        try {
+                            args = JSON.parse(toolCall.function.arguments);
+                        }
+                        catch {
+                            logger.warn('Failed to parse tool arguments', { toolName });
+                            messages.push({
+                                role: 'tool',
+                                content: 'Error: Invalid tool arguments',
+                                tool_call_id: toolCall.id,
+                            });
+                            continue;
+                        }
+                        progressCallback?.('info', `${toolName}: ${this.formatToolArgs(toolName, args)}`);
+                        const result = await toolExecutor(toolName, args);
+                        messages.push({
+                            role: 'tool',
+                            content: result.success ? (result.result || 'Success') : `Error: ${result.error}`,
+                            tool_call_id: toolCall.id,
+                        });
+                        if (result.terminate) {
+                            break;
+                        }
+                    }
+                }
+                else {
+                    logger.warn('LLM responded without tool calls');
+                    messages.push({
+                        role: 'system',
+                        content: 'You must use tools to search documentation. Call list_directory to explore, or submit_findings to complete.',
+                    });
+                }
+            }
+            const totalElapsed = logger.endTimer('docs-search-total');
+            logger.exit('DocsSearchAgent.execute', { success: true, iterations });
+            return {
+                success: true,
+                result: finalResult ? this.formatFinalResult(finalResult) : 'Error: Search completed without findings.',
+                metadata: {
+                    iterations,
+                    duration: totalElapsed,
+                },
+            };
+        }
+        catch (error) {
+            logger.endTimer('docs-search-total');
+            logger.error('Documentation Search Failed', error instanceof Error ? error : new Error(String(error)));
+            progressCallback?.('complete', 'Search failed', { summary: 'Error occurred', findings: '', sources: [] });
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error in docs search',
+            };
+        }
+    }
+    formatToolArgs(toolName, args) {
+        const reason = args['reason'];
+        switch (toolName) {
+            case 'list_directory':
+                return reason || (args['path'] ? `"${args['path']}"` : '(root)');
+            case 'read_docs_file':
+            case 'preview_file':
+                return reason || `"${args['path']}"`;
+            case 'tell_to_user':
+                return args['message']?.slice(0, 50) || '';
+            case 'submit_findings':
+                return 'Submitting report...';
+            default:
+                return JSON.stringify(args).slice(0, 50);
+        }
+    }
+    formatFinalResult(result) {
+        const parts = [];
+        parts.push(`## Summary\n${result.summary}`);
+        parts.push(`\n## Findings\n${result.findings}`);
+        if (result.sources.length > 0) {
+            parts.push(`\n## Sources`);
+            result.sources.forEach(source => {
+                parts.push(`- ${source}`);
+            });
+        }
+        return parts.join('\n');
+    }
+}
+export function createDocsSearchAgent(llmClient, config) {
+    return new DocsSearchAgent(llmClient, config);
+}
+export async function executeDocsSearchAgent(llmClient, query) {
+    const agent = new DocsSearchAgent(llmClient);
+    return agent.execute(query);
+}
+export async function initializeDocsDirectory() {
+    const fs = await import('fs/promises');
+    const path = await import('path');
+    const os = await import('os');
+    const docsPath = path.join(os.homedir(), '.local-cli', 'docs');
+    try {
+        await fs.mkdir(docsPath, { recursive: true });
+        const readmePath = path.join(docsPath, 'README.md');
+        try {
+            await fs.access(readmePath);
+        }
+        catch {
+            const sampleReadme = `# LOCAL-CLI Documentation
+
+Welcome to the LOCAL-CLI documentation directory!
+
+## Overview
+
+This directory contains local documentation that can be searched by the AI assistant.
+
+## Adding Documentation
+
+Simply place your markdown (.md) files in this directory. The AI will be able to search and reference them.
+
+## Folder Structure
+
+Organize your documentation hierarchically:
+- Create folders for major categories
+- Use sub-folders for specific topics
+- Place .md files at appropriate levels
+
+Example:
+\`\`\`
+~/.local-cli/docs/
+├── README.md
+├── tutorials/
+│   ├── getting-started.md
+│   └── advanced-usage.md
+├── reference/
+│   ├── api.md
+│   └── configuration.md
+└── agent_framework/
+    ├── agno/
+    │   ├── overview.md
+    │   └── examples.md
+    └── langchain/
+        └── setup.md
+\`\`\`
+`;
+            await fs.writeFile(readmePath, sampleReadme, 'utf-8');
+        }
+    }
+    catch (error) {
+        logger.error('Failed to initialize docs directory', error instanceof Error ? error : new Error(String(error)));
+    }
+}
+export async function addDocumentationFile(filename, content) {
+    try {
+        const fs = await import('fs/promises');
+        const pathModule = await import('path');
+        const os = await import('os');
+        const docsPath = pathModule.join(os.homedir(), '.local-cli', 'docs');
+        await fs.mkdir(docsPath, { recursive: true });
+        const sanitizedFilename = pathModule.basename(filename);
+        const filePath = pathModule.join(docsPath, sanitizedFilename);
+        await fs.writeFile(filePath, content, 'utf-8');
+        return { success: true, path: filePath };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to add documentation',
+        };
+    }
+}
+export default DocsSearchAgent;
+//# sourceMappingURL=index.js.map

package/dist/agents/docs-search/index.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,4 @@
+export { BaseAgent, type AgentContext, type AgentResult, type AgentConfig, } from './base/base-agent.js';
+export { PlanningLLM, type PlanningWithDocsResult, } from './planner/index.js';
+export { DocsSearchAgent, createDocsSearchAgent, executeDocsSearchAgent, initializeDocsDirectory, addDocumentationFile, setDocsSearchProgressCallback, type DocsSearchProgressCallback, } from './docs-search/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,6BAA6B,EAC7B,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,4 @@
+export { BaseAgent, } from './base/base-agent.js';
+export { PlanningLLM, } from './planner/index.js';
+export { DocsSearchAgent, createDocsSearchAgent, executeDocsSearchAgent, initializeDocsDirectory, addDocumentationFile, setDocsSearchProgressCallback, } from './docs-search/index.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,SAAS,GAIV,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,WAAW,GAEZ,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,6BAA6B,GAE9B,MAAM,wBAAwB,CAAC"}

package/dist/agents/planner/index.d.ts

@@ -0,0 +1,17 @@
+import { LLMClient } from '../../core/llm/llm-client.js';
+import { Message, PlanningResult } from '../../types/index.js';
+import { AskUserCallback } from '../../tools/llm/simple/user-interaction-tools.js';
+export interface PlanningWithDocsResult extends PlanningResult {
+    docsSearchNeeded: boolean;
+}
+export declare class PlanningLLM {
+    private llmClient;
+    private askUserCallback;
+    constructor(llmClient: LLMClient);
+    setAskUserCallback(callback: AskUserCallback): void;
+    clearAskUserCallback(): void;
+    generateTODOList(userRequest: string, contextMessages?: Message[]): Promise<PlanningResult>;
+    generateTODOListWithDocsDecision(userRequest: string, contextMessages?: Message[]): Promise<PlanningWithDocsResult>;
+}
+export default PlanningLLM;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/planner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/planner/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAY,cAAc,EAAc,MAAM,sBAAsB,CAAC;AAUrF,OAAO,EAEL,eAAe,EAChB,MAAM,kDAAkD,CAAC;AAK1D,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,eAAe,CAAgC;gBAE3C,SAAS,EAAE,SAAS;IAQhC,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAQnD,oBAAoB,IAAI,IAAI;IAatB,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,OAAO,EAAE,GAC1B,OAAO,CAAC,cAAc,CAAC;IAsSpB,gCAAgC,CACpC,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,OAAO,EAAE,GAC1B,OAAO,CAAC,sBAAsB,CAAC;CAuKnC;AAED,eAAe,WAAW,CAAC"}