@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/tool-formatters.js

@@ -0,0 +1,516 @@
+/**
+ * Tool Result Formatters
+ *
+ * Extracts content, summary, and success from tool results.
+ * Each tool type has its own formatter to produce human-readable output.
+ */
+/**
+ * Format tool result for display.
+ * Handles the agent's structured result format.
+ */
+export function formatToolResult(toolName, result) {
+    // Handle structured results from @compilr-dev/agents
+    // Format: { success: boolean, result: { content: string, ... } }
+    if (typeof result === 'object' && result !== null) {
+        const obj = result;
+        // Check for success/result wrapper
+        const success = obj.success !== false;
+        const innerResult = (obj.result ?? obj);
+        // Extract content based on tool type
+        let content = '';
+        let summary = '';
+        const toolLower = toolName.toLowerCase();
+        if (toolLower === 'bash' || toolLower === 'bash_output') {
+            ({ content, summary } = formatBash(innerResult));
+        }
+        else if (toolLower === 'read_file' || toolLower === 'read') {
+            ({ content, summary } = formatReadFile(innerResult));
+        }
+        else if (toolLower === 'write_file' || toolLower === 'write') {
+            ({ content, summary } = formatWriteFile());
+        }
+        else if (toolLower === 'edit') {
+            ({ content, summary } = formatEdit(innerResult));
+        }
+        else if (toolLower === 'glob') {
+            ({ content, summary } = formatGlob(innerResult));
+        }
+        else if (toolLower === 'grep') {
+            ({ content, summary } = formatGrep(innerResult));
+        }
+        else if (toolLower === 'backlog_read' || toolLower === 'workitem_query') {
+            ({ content, summary } = formatBacklogRead(innerResult));
+        }
+        else if (toolLower === 'git_status') {
+            ({ content, summary } = formatGitStatus(innerResult));
+        }
+        else if (toolLower === 'git_diff') {
+            ({ content, summary } = formatGitDiff(innerResult));
+        }
+        else if (toolLower === 'git_commit') {
+            ({ content, summary } = formatGitCommit(innerResult));
+        }
+        else if (toolLower === 'git_log') {
+            ({ content, summary } = formatGitLog(innerResult));
+        }
+        else if (toolLower === 'git_branch') {
+            ({ content, summary } = formatGitBranch(innerResult));
+        }
+        else if (toolLower === 'run_tests') {
+            ({ content, summary } = formatRunTests(innerResult));
+        }
+        else if (toolLower === 'run_lint') {
+            ({ content, summary } = formatRunLint(innerResult));
+        }
+        else if (toolLower === 'detect_project') {
+            ({ content, summary } = formatDetectProject(innerResult));
+        }
+        else if (toolLower === 'find_project_root') {
+            ({ content, summary } = formatFindProjectRoot(innerResult));
+        }
+        else if (toolLower === 'backlog_write' || toolLower.startsWith('workitem_')) {
+            ({ content, summary } = formatBacklogWrite(innerResult));
+        }
+        else if (toolLower.startsWith('anchor_')) {
+            ({ content, summary } = formatAnchor(innerResult));
+        }
+        else if (toolLower === 'kill_shell') {
+            ({ content, summary } = formatKillShell(innerResult));
+        }
+        else if (toolLower === 'project_get') {
+            ({ content, summary } = formatProjectGet(innerResult));
+        }
+        else if (toolLower === 'project_create') {
+            ({ content, summary } = formatProjectCreate(innerResult));
+        }
+        else if (toolLower === 'project_update') {
+            ({ content, summary } = formatProjectUpdate(innerResult));
+        }
+        else if (toolLower === 'project_list') {
+            ({ content, summary } = formatProjectList(innerResult));
+        }
+        else if (toolLower.startsWith('project_document_')) {
+            ({ content, summary } = formatProjectDocument(toolLower, innerResult));
+        }
+        else if (toolLower === 'task') {
+            ({ content, summary } = formatTask(innerResult));
+        }
+        else {
+            // Generic handling
+            ({ content, summary } = formatGeneric(innerResult));
+        }
+        return { content, summary, success };
+    }
+    // Fallback for string results
+    const content = String(result);
+    const lines = content.split('\n').filter((l) => l.length > 0);
+    return {
+        content,
+        summary: lines.length > 0 ? lines[0].slice(0, 60) : 'Completed',
+        success: true,
+    };
+}
+// =============================================================================
+// Individual Formatters
+// =============================================================================
+function formatBash(result) {
+    const rawStdout = result.stdout;
+    const rawStderr = result.stderr;
+    const stdout = (typeof rawStdout === 'string' ? rawStdout : '').trim();
+    const stderr = (typeof rawStderr === 'string' ? rawStderr : '').trim();
+    const exitCode = typeof result.exitCode === 'number' ? result.exitCode : 0;
+    // Filter out common locale warnings from stderr
+    const filteredStderr = stderr.split('\n')
+        .filter((line) => !line.includes('setlocale') && !line.includes('LC_ALL'))
+        .join('\n').trim();
+    const content = stdout || filteredStderr;
+    const lines = content.split('\n').filter((l) => l.length > 0);
+    let summary;
+    if (exitCode !== 0) {
+        summary = `Exit code: ${String(exitCode)}`;
+    }
+    else if (lines.length > 0) {
+        summary = lines.length === 1 ? lines[0].slice(0, 60) : `${String(lines.length)} lines`;
+    }
+    else {
+        summary = 'Completed';
+    }
+    return { content, summary };
+}
+function formatReadFile(result) {
+    const rawContent = result.content;
+    const content = typeof rawContent === 'string' ? rawContent : '';
+    const lines = content.split('\n').filter((l) => l.length > 0);
+    return { content, summary: `Read ${String(lines.length)} lines` };
+}
+function formatWriteFile() {
+    return { content: '', summary: 'File written' };
+}
+function formatEdit(result) {
+    const rawDiff = result.diff;
+    const rawContent = result.content;
+    const content = typeof rawDiff === 'string' ? rawDiff : typeof rawContent === 'string' ? rawContent : '';
+    return { content, summary: 'File edited' };
+}
+function formatGlob(result) {
+    const rawFiles = result.files ?? result.content;
+    if (Array.isArray(rawFiles)) {
+        const content = rawFiles.join('\n');
+        return { content, summary: `Found ${String(rawFiles.length)} files` };
+    }
+    else if (typeof rawFiles === 'string') {
+        const content = rawFiles;
+        const count = content.split('\n').filter((l) => l.length > 0).length;
+        return { content, summary: `Found ${String(count)} files` };
+    }
+    return { content: '', summary: 'No files found' };
+}
+function formatGrep(result) {
+    const rawMatches = result.matches ?? result.content;
+    if (Array.isArray(rawMatches)) {
+        const content = rawMatches.join('\n');
+        return { content, summary: `Found ${String(rawMatches.length)} matches` };
+    }
+    else if (typeof rawMatches === 'string') {
+        const content = rawMatches;
+        const count = content.split('\n').filter((l) => l.length > 0).length;
+        return { content, summary: `Found ${String(count)} matches` };
+    }
+    return { content: '', summary: 'No matches found' };
+}
+function formatBacklogRead(result) {
+    const items = result.items;
+    const total = result.total;
+    if (Array.isArray(items)) {
+        if (items.length === 0) {
+            return { content: '', summary: 'No items' };
+        }
+        // Build content with item summaries
+        const itemLines = items.slice(0, 10).map((item) => {
+            const id = item.id || '?';
+            const title = (item.title || 'Untitled').slice(0, 50);
+            const status = item.status || '?';
+            const priority = item.priority ? ` [${item.priority}]` : '';
+            return `${id}: ${title} (${status})${priority}`;
+        });
+        if (items.length > 10) {
+            itemLines.push(`... and ${String(items.length - 10)} more`);
+        }
+        return { content: itemLines.join('\n'), summary: `${String(total ?? items.length)} items` };
+    }
+    return { content: '', summary: 'No items' };
+}
+function formatGitStatus(result) {
+    const branch = result.branch;
+    const isClean = result.isClean;
+    const staged = result.staged;
+    const modified = result.modified;
+    const untracked = result.untracked;
+    if (isClean) {
+        return { content: '', summary: `${branch || 'unknown'} (clean)` };
+    }
+    const parts = [];
+    if (staged?.length)
+        parts.push(`${String(staged.length)} staged`);
+    if (modified?.length)
+        parts.push(`${String(modified.length)} modified`);
+    if (untracked?.length)
+        parts.push(`${String(untracked.length)} untracked`);
+    const summary = `${branch || 'unknown'}: ${parts.join(', ')}`;
+    // Build detailed content
+    const lines = [];
+    if (staged?.length) {
+        lines.push('Staged:');
+        staged.slice(0, 5).forEach((f) => lines.push(`  + ${f.path}`));
+        if (staged.length > 5)
+            lines.push(`  ... and ${String(staged.length - 5)} more`);
+    }
+    if (modified?.length) {
+        lines.push('Modified:');
+        modified.slice(0, 5).forEach((f) => lines.push(`  M ${f.path}`));
+        if (modified.length > 5)
+            lines.push(`  ... and ${String(modified.length - 5)} more`);
+    }
+    if (untracked?.length) {
+        lines.push('Untracked:');
+        untracked.slice(0, 5).forEach((f) => lines.push(`  ? ${f.path}`));
+        if (untracked.length > 5)
+            lines.push(`  ... and ${String(untracked.length - 5)} more`);
+    }
+    return { content: lines.join('\n'), summary };
+}
+function formatGitDiff(result) {
+    const files = result.files;
+    const stats = result.stats;
+    const diff = result.diff;
+    if (!files?.length) {
+        return { content: '', summary: 'No changes' };
+    }
+    const ins = stats?.insertions ?? 0;
+    const del = stats?.deletions ?? 0;
+    const summary = `${String(files.length)} file(s), +${String(ins)} -${String(del)}`;
+    const content = diff || files.map((f) => f.path).join('\n');
+    return { content, summary };
+}
+function formatGitCommit(result) {
+    const shortHash = result.shortHash;
+    const branch = result.branch;
+    const filesCount = result.filesCommitted;
+    const message = result.message;
+    const msgPreview = (message || '').slice(0, 40);
+    const filesInfo = filesCount ? ` (${String(filesCount)} files)` : '';
+    const summary = `[${branch || '?'}] ${shortHash || '?'}: ${msgPreview}${filesInfo}`;
+    return { content: '', summary };
+}
+function formatGitLog(result) {
+    const commits = result.commits;
+    if (!commits?.length) {
+        return { content: '', summary: 'No commits' };
+    }
+    const summary = `${String(commits.length)} commit(s)`;
+    const lines = commits.slice(0, 10).map((c) => `${c.shortHash || '?'} ${(c.subject || '').slice(0, 50)}`);
+    if (commits.length > 10)
+        lines.push(`... and ${String(commits.length - 10)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatGitBranch(result) {
+    const current = result.current;
+    const branches = result.branches;
+    const message = result.message;
+    if (message) {
+        return { content: '', summary: message };
+    }
+    if (branches?.length) {
+        const summary = `${String(branches.length)} branch(es), current: ${current || '?'}`;
+        const content = branches.map((b) => `${b.current ? '* ' : '  '}${b.name}`).join('\n');
+        return { content, summary };
+    }
+    return { content: '', summary: current ? `On branch ${current}` : 'Unknown' };
+}
+function formatRunTests(result) {
+    const exitCode = result.exitCode;
+    const passed = result.passed;
+    const failed = result.failed;
+    const skipped = result.skipped;
+    const framework = result.framework;
+    const output = result.output;
+    const parts = [];
+    if (passed !== undefined)
+        parts.push(`${String(passed)} passed`);
+    if (failed !== undefined)
+        parts.push(`${String(failed)} failed`);
+    if (skipped !== undefined)
+        parts.push(`${String(skipped)} skipped`);
+    let summary;
+    if (parts.length > 0) {
+        summary = parts.join(', ');
+    }
+    else {
+        summary = exitCode === 0 ? 'Tests passed' : `Tests failed (exit ${String(exitCode)})`;
+    }
+    if (framework)
+        summary = `[${framework}] ${summary}`;
+    return { content: output || '', summary };
+}
+function formatRunLint(result) {
+    const exitCode = result.exitCode;
+    const errors = result.errors;
+    const warnings = result.warnings;
+    const linter = result.linter;
+    const output = result.output;
+    const parts = [];
+    if (errors !== undefined)
+        parts.push(`${String(errors)} error(s)`);
+    if (warnings !== undefined)
+        parts.push(`${String(warnings)} warning(s)`);
+    let summary;
+    if (parts.length > 0) {
+        summary = parts.join(', ');
+    }
+    else {
+        summary = exitCode === 0 ? 'Lint passed' : `Lint failed (exit ${String(exitCode)})`;
+    }
+    if (linter)
+        summary = `[${linter}] ${summary}`;
+    return { content: output || '', summary };
+}
+function formatDetectProject(result) {
+    const primary = result.primary;
+    const types = result.types;
+    const packageManager = result.packageManager;
+    const testFramework = result.testFramework;
+    const summary = primary || (types?.length ? types.join(', ') : 'Unknown project');
+    const details = [];
+    if (packageManager)
+        details.push(`Package manager: ${packageManager}`);
+    if (testFramework)
+        details.push(`Test framework: ${testFramework}`);
+    if (result.linter)
+        details.push(`Linter: ${result.linter}`);
+    if (result.buildTool)
+        details.push(`Build tool: ${result.buildTool}`);
+    return { content: details.join('\n'), summary };
+}
+function formatFindProjectRoot(result) {
+    const root = result.root;
+    const foundMarker = result.foundMarker;
+    const summary = root || 'Not found';
+    const content = foundMarker ? `Found via: ${foundMarker}` : '';
+    return { content, summary };
+}
+function formatBacklogWrite(result) {
+    const action = result.action;
+    const itemId = result.itemId;
+    const message = result.message;
+    const summary = message || (itemId ? `${action || 'Done'}: ${itemId}` : (action || 'Done'));
+    return { content: '', summary };
+}
+function formatAnchor(result) {
+    const message = result.message;
+    const id = result.id;
+    const anchors = result.anchors;
+    let summary;
+    if (message) {
+        summary = message;
+    }
+    else if (id) {
+        summary = `Anchor: ${id}`;
+    }
+    else if (anchors?.length) {
+        summary = `${String(anchors.length)} anchor(s)`;
+    }
+    else {
+        summary = 'Done';
+    }
+    const content = anchors ? anchors.map((a) => `[${a.id}] ${a.content.slice(0, 50)}`).join('\n') : '';
+    return { content, summary };
+}
+function formatKillShell(result) {
+    const message = result.message;
+    return { content: '', summary: message || 'Shell terminated' };
+}
+function formatProjectGet(result) {
+    const project = result.project;
+    if (!project) {
+        const message = result.message;
+        return { content: '', summary: message || 'No project found' };
+    }
+    const name = project.displayName || project.name || 'Unknown';
+    const status = project.status || '';
+    const type = project.type || '';
+    const path = project.path || '';
+    const summary = `${name} (${type || 'project'})`;
+    const details = [];
+    if (status)
+        details.push(`Status: ${status}`);
+    if (path)
+        details.push(`Path: ${path}`);
+    if (project.lifecycleState)
+        details.push(`Stage: ${project.lifecycleState}`);
+    if (project.framework)
+        details.push(`Framework: ${project.framework}`);
+    if (project.language)
+        details.push(`Language: ${project.language}`);
+    return { content: details.join('\n'), summary };
+}
+function formatProjectCreate(result) {
+    const project = result.project;
+    const message = result.message;
+    if (project) {
+        const name = project.displayName || project.name || 'Unknown';
+        return { content: '', summary: message || `Created project: ${name}` };
+    }
+    return { content: '', summary: message || 'Project created' };
+}
+function formatProjectUpdate(result) {
+    const project = result.project;
+    const message = result.message;
+    if (project) {
+        const name = project.displayName || project.name || 'Unknown';
+        return { content: '', summary: message || `Updated project: ${name}` };
+    }
+    return { content: '', summary: message || 'Project updated' };
+}
+function formatProjectList(result) {
+    const projects = result.projects;
+    const total = result.total;
+    if (!projects?.length) {
+        return { content: '', summary: 'No projects found' };
+    }
+    const summary = `${String(total ?? projects.length)} project(s)`;
+    const lines = projects.slice(0, 10).map((p) => {
+        const name = p.displayName || p.name || '?';
+        const status = p.status ? ` [${p.status}]` : '';
+        const type = p.type ? ` (${p.type})` : '';
+        return `${name}${type}${status}`;
+    });
+    if (projects.length > 10)
+        lines.push(`... and ${String(projects.length - 10)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatProjectDocument(toolName, result) {
+    const action = toolName.replace('project_document_', '');
+    // Handle document_get - return the document
+    if (action === 'get') {
+        const document = result.document;
+        if (!document) {
+            return { content: '', summary: 'Document not found' };
+        }
+        const docType = document.docType || 'unknown';
+        const content = document.content || '';
+        const preview = content.length > 200 ? content.slice(0, 200) + '...' : content;
+        return { content: preview, summary: `Document: ${docType}` };
+    }
+    // Handle document_list - return list of documents
+    if (action === 'list') {
+        const documents = result.documents;
+        if (!documents?.length) {
+            return { content: '', summary: 'No documents found' };
+        }
+        const summary = `${String(documents.length)} document(s)`;
+        const lines = documents.map((d) => d.docType || '?');
+        return { content: lines.join('\n'), summary };
+    }
+    // Handle document_add/delete - simple confirmation
+    const message = result.message;
+    const docType = result.docType;
+    if (message) {
+        return { content: '', summary: message };
+    }
+    if (action === 'add') {
+        return { content: '', summary: docType ? `Added document: ${docType}` : 'Document added' };
+    }
+    if (action === 'delete') {
+        return { content: '', summary: docType ? `Deleted document: ${docType}` : 'Document deleted' };
+    }
+    return { content: '', summary: 'Done' };
+}
+function formatTask(result) {
+    const response = result.response;
+    const agentType = result.agentType;
+    const iterations = result.iterations;
+    const toolCalls = result.toolCalls;
+    // Build summary: [agentType] N iterations, M tool calls
+    const parts = [];
+    if (iterations !== undefined) {
+        parts.push(`${String(iterations)} iteration${iterations === 1 ? '' : 's'}`);
+    }
+    if (toolCalls !== undefined) {
+        parts.push(`${String(toolCalls)} tool call${toolCalls === 1 ? '' : 's'}`);
+    }
+    let summary = agentType ? `[${agentType}] ` : '';
+    summary += parts.length > 0 ? parts.join(', ') : 'Done';
+    // Content is the response text
+    const content = response || '';
+    return { content, summary };
+}
+function formatGeneric(result) {
+    const content = typeof result.content === 'string'
+        ? result.content
+        : typeof result.output === 'string'
+            ? result.output
+            : JSON.stringify(result);
+    const lines = content.split('\n').filter((l) => l.length > 0);
+    const summary = lines.length > 0 ? lines[0].slice(0, 60) : 'Completed';
+    return { content, summary };
+}

package/dist/ui/tools-overlay-v2.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Tools Overlay V2
+ *
+ * Displays available agent tools in a categorized, searchable list.
+ * Uses TabbedListOverlayV2 for the new Overlay interface.
+ *
+ * Features:
+ * - Tabs: All, Files, Code, Git, Project, Agent
+ * - Search with / toggle
+ * - Detail view for full tool information
+ * - Works with TerminalUI's overlay management
+ */
+import { TabbedListOverlayV2, BaseScreen } from './base/index.js';
+export interface ToolParameter {
+    name: string;
+    type: string;
+    description?: string;
+    required: boolean;
+}
+export interface ToolPermissionInfo {
+    level: 'once' | 'always' | 'session';
+    description: string;
+}
+export interface ToolInfo {
+    name: string;
+    description?: string;
+    parameters?: ToolParameter[];
+    permission?: ToolPermissionInfo;
+}
+export interface ToolsOverlayV2Options {
+    /** List of available tools */
+    tools: ToolInfo[];
+}
+export interface ToolsOverlayV2Result {
+    /** Whether the overlay was dismissed without action */
+    dismissed: boolean;
+}
+/**
+ * Tools overlay using the new Overlay interface.
+ * Displays available tools in a searchable, tabbed list.
+ */
+export declare class ToolsOverlayV2 extends TabbedListOverlayV2<ToolInfo, ToolsOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "tools-overlay-v2";
+    constructor(options: ToolsOverlayV2Options);
+    protected createDetailScreen(tool: ToolInfo): BaseScreen | null;
+}