protoagent 0.1.13 → 0.1.15

package/dist/utils/path-suggestions.js

@@ -0,0 +1,74 @@
+/**
+ * Path suggestions utility — Find similar paths when a file isn't found.
+ *
+ * Used by read_file and edit_file to suggest alternatives when
+ * the requested path doesn't exist (helps recover from typos).
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import leven from 'leven';
+import { getWorkingDirectory } from './path-validation.js';
+const MAX_DEPTH = 6;
+const MAX_ENTRIES = 200;
+const MAX_CANDIDATES = 50;
+const MAX_SUGGESTIONS = 3;
+/**
+ * Collect all file paths recursively up to MAX_DEPTH.
+ */
+async function collectAllPaths(cwd) {
+    const paths = [];
+    const skipDirs = new Set(['node_modules', '.git', 'dist', 'build', 'coverage']);
+    async function walk(dir, currentPath) {
+        if (paths.length >= MAX_CANDIDATES)
+            return;
+        let entries;
+        try {
+            const dirEntries = await fs.readdir(dir, { withFileTypes: true });
+            entries = dirEntries
+                .filter(e => !skipDirs.has(e.name))
+                .slice(0, MAX_ENTRIES)
+                .map(e => e.name);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (paths.length >= MAX_CANDIDATES)
+                return;
+            const entryPath = currentPath ? `${currentPath}/${entry}` : entry;
+            const fullPath = path.join(dir, entry);
+            paths.push(entryPath);
+            // Continue walking deeper
+            try {
+                const stat = await fs.stat(fullPath);
+                if (stat.isDirectory() && entryPath.split('/').length < MAX_DEPTH) {
+                    await walk(fullPath, entryPath);
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    await walk(cwd, '');
+    return paths;
+}
+/**
+ * Find similar paths when a requested file doesn't exist.
+ * Uses Levenshtein distance to find the closest matches.
+ */
+export async function findSimilarPaths(requestedPath) {
+    const cwd = getWorkingDirectory();
+    // Collect all available paths
+    const allPaths = await collectAllPaths(cwd);
+    // Calculate Levenshtein distance for each path
+    const scored = allPaths.map(candidatePath => ({
+        path: candidatePath,
+        distance: leven(requestedPath.toLowerCase(), candidatePath.toLowerCase()),
+    }));
+    // Sort by distance (lower is better) and take top suggestions
+    scored.sort((a, b) => a.distance - b.distance);
+    return scored
+        .slice(0, MAX_SUGGESTIONS)
+        .map(s => s.path);
+}

package/dist/utils/path-validation.js

@@ -7,14 +7,11 @@
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';
+import isPathInside from 'is-path-inside';
 const workingDirectory = process.cwd();
 let allowedRoots = [];
-function isWithinRoot(targetPath, rootPath) {
-    const relative = path.relative(rootPath, targetPath);
-    return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
-}
 function isAllowedPath(targetPath) {
-    return isWithinRoot(targetPath, workingDirectory) || allowedRoots.some((root) => isWithinRoot(targetPath, root));
+    return isPathInside(targetPath, workingDirectory) || allowedRoots.some((root) => isPathInside(targetPath, root));
 }
 export async function setAllowedPathRoots(roots) {
     const normalizedRoots = await Promise.all(roots.map(async (root) => {

package/dist/utils/tool-display.js

@@ -0,0 +1,53 @@
+// Extract the most meaningful detail from tool args based on tool type
+export function extractToolDetail(tool, args) {
+    switch (tool) {
+        case 'read_file':
+        case 'write_file':
+        case 'edit_file':
+            return typeof args.file_path === 'string' ? args.file_path : '';
+        case 'list_directory':
+            return typeof args.directory_path === 'string' ? args.directory_path : '(current)';
+        case 'search_files':
+            return typeof args.search_term === 'string' ? `"${args.search_term}"` : '';
+        case 'bash':
+            if (typeof args.command !== 'string')
+                return '';
+            const parts = args.command.split(/\s+/);
+            return parts.slice(0, 3).join(' ') + (parts.length > 3 ? '...' : '');
+        case 'todo_write':
+            return Array.isArray(args.todos) ? `${args.todos.length} task(s)` : '';
+        case 'todo_read':
+            return 'read';
+        case 'webfetch':
+            return typeof args.url === 'string' ? new URL(args.url).hostname : '';
+        case 'sub_agent':
+            return 'nested task...';
+        default: {
+            // Fallback: first string argument, truncated to 30 chars
+            const firstEntry = Object.entries(args).find(([, v]) => typeof v === 'string');
+            if (!firstEntry)
+                return '';
+            const value = String(firstEntry[1]);
+            return value.length > 30 ? value.slice(0, 30) + '...' : value;
+        }
+    }
+}
+// Format sub-agent activity: "Sub-agent read_file: src/App.tsx"
+export function formatSubAgentActivity(tool, args) {
+    if (!args || typeof args !== 'object') {
+        return `Sub-agent running ${tool}...`;
+    }
+    const detail = extractToolDetail(tool, args);
+    if (!detail) {
+        return `Sub-agent running ${tool}...`;
+    }
+    return `Sub-agent ${tool.replace(/_/g, ' ')}: ${detail}`;
+}
+// Format tool activity: "read_file src/App.tsx"
+export function formatToolActivity(tool, args) {
+    if (!args || typeof args !== 'object') {
+        return tool;
+    }
+    const detail = extractToolDetail(tool, args);
+    return detail ? `${tool} ${detail}` : tool;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "protoagent",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "files": [
     "dist",
@@ -16,7 +16,9 @@
     "build": "npm run clean && tsc && node -e \"const fs=require('node:fs'); if (fs.existsSync('dist/cli.js')) fs.chmodSync('dist/cli.js', 0o755)\"",
     "build:watch": "tsc --watch",
     "prepack": "npm run build",
-    "docs:dev": "vitepress dev docs",
+    "docs:dev": "concurrently \"npm run docs:dev:worker\" \"npm run docs:dev:docs\" --kill-others",
+    "docs:dev:worker": "cd docs/worker && npm exec wrangler -- dev --port 8787 --ip 0.0.0.0",
+    "docs:dev:docs": "vitepress dev docs --port 5173 --host",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs"
   },
@@ -46,25 +48,30 @@
     "@inkjs/ui": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "commander": "^14.0.1",
+    "diff": "^8.0.4",
     "he": "^1.2.0",
     "html-to-text": "^9.0.5",
     "ink": "^6.8.0",
-    "ink-big-text": "^2.0.0",
+    "is-path-inside": "^4.0.0",
     "jsonc-parser": "^3.3.1",
+    "leven": "^4.1.0",
     "openai": "^5.23.1",
     "react": "^19.1.1",
+    "strip-ansi": "^7.2.0",
     "turndown": "^7.2.2",
     "yaml": "^2.8.2",
-    "yoga-layout": "^3.2.1"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@eslint/js": "^9.36.0",
     "@tailwindcss/postcss": "^4.1.18",
+    "@types/diff": "^7.0.2",
     "@types/he": "^1.2.3",
     "@types/html-to-text": "^9.0.4",
     "@types/node": "^24.5.2",
     "@types/react": "^19.1.15",
     "@types/turndown": "^5.0.6",
+    "concurrently": "^9.1.2",
     "eslint": "^9.36.0",
     "ink-testing-library": "^4.0.0",
     "tailwindcss": "^4.0.0",

package/dist/components/CollapsibleBox.js

@@ -1,27 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Text } from 'ink';
-import { LeftBar } from './LeftBar.js';
-export const CollapsibleBox = ({ title, content, titleColor, dimColor = false, maxPreviewLines = 3, maxPreviewChars = 500, expanded = false, marginBottom = 0, }) => {
-    const lines = content.split('\n');
-    const isTooManyLines = lines.length > maxPreviewLines;
-    const isTooManyChars = content.length > maxPreviewChars;
-    const isLong = isTooManyLines || isTooManyChars;
-    // If content is short, always show it
-    if (!isLong) {
-        return (_jsxs(LeftBar, { color: titleColor ?? 'white', marginBottom: marginBottom, children: [_jsx(Text, { color: titleColor, dimColor: dimColor, bold: true, children: title }), _jsx(Text, { dimColor: dimColor, children: content })] }));
-    }
-    // For long content, show preview or full content
-    let preview;
-    if (expanded) {
-        preview = content;
-    }
-    else {
-        // Truncate by lines first, then by characters
-        const linesTruncated = lines.slice(0, maxPreviewLines).join('\n');
-        preview = linesTruncated.length > maxPreviewChars
-            ? linesTruncated.slice(0, maxPreviewChars)
-            : linesTruncated;
-    }
-    const hasMore = !expanded;
-    return (_jsxs(LeftBar, { color: titleColor ?? 'white', marginBottom: marginBottom, children: [_jsxs(Text, { color: titleColor, dimColor: dimColor, bold: true, children: [expanded ? '▼' : '▶', " ", title] }), _jsx(Text, { dimColor: dimColor, children: preview }), hasMore && _jsx(Text, { dimColor: true, children: "... (use /expand to see all)" })] }));
-};

package/dist/components/ConfigDialog.js

@@ -1,42 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * ConfigDialog — Modal-like dialog for changing config mid-conversation
- *
- * Allows users to update provider, model, or API key without losing chat history.
- */
-import { useState } from 'react';
-import { Box, Text } from 'ink';
-import { PasswordInput, Select } from '@inkjs/ui';
-import { getAllProviders, getProvider } from '../providers.js';
-import { resolveApiKey } from '../config.js';
-export const ConfigDialog = ({ currentConfig, onComplete, onCancel, }) => {
-    const [step, setStep] = useState('select_provider');
-    const [selectedProviderId, setSelectedProviderId] = useState(currentConfig.provider);
-    const [selectedModelId, setSelectedModelId] = useState(currentConfig.model);
-    const providerItems = getAllProviders().flatMap((provider) => provider.models.map((model) => ({
-        label: `${provider.name} - ${model.name}`,
-        value: `${provider.id}:::${model.id}`,
-    })));
-    const currentProvider = getProvider(currentConfig.provider);
-    // Provider selection step
-    if (step === 'select_provider') {
-        return (_jsxs(Box, { flexDirection: "column", marginTop: 1, borderStyle: "round", borderColor: "green", paddingX: 1, children: [_jsx(Text, { color: "green", bold: true, children: "Change Configuration" }), _jsxs(Text, { dimColor: true, children: ["Current: ", currentProvider?.name, " / ", currentConfig.model] }), _jsx(Text, { dimColor: true, children: "Select a new provider and model:" }), _jsx(Box, { marginTop: 1, children: _jsx(Select, { options: providerItems.map((item) => ({ value: item.value, label: item.label })), onChange: (value) => {
-                            const [providerId, modelId] = value.split(':::');
-                            setSelectedProviderId(providerId);
-                            setSelectedModelId(modelId);
-                            setStep('enter_api_key');
-                        } }) })] }));
-    }
-    // API key entry step
-    const provider = getProvider(selectedProviderId);
-    const hasResolvedAuth = Boolean(resolveApiKey({ provider: selectedProviderId, apiKey: undefined }));
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, borderStyle: "round", borderColor: "green", paddingX: 1, children: [_jsx(Text, { color: "green", bold: true, children: "Confirm Configuration" }), _jsxs(Text, { dimColor: true, children: ["Provider: ", provider?.name, " / ", selectedModelId] }), _jsx(Text, { children: hasResolvedAuth ? 'Optional API key (leave empty to keep resolved auth):' : 'Enter your API key:' }), _jsx(PasswordInput, { placeholder: `Paste your ${provider?.apiKeyEnvVar || 'API'} key`, onSubmit: (value) => {
-                    const finalApiKey = value.trim().length > 0 ? value.trim() : currentConfig.apiKey;
-                    const newConfig = {
-                        provider: selectedProviderId,
-                        model: selectedModelId,
-                        ...(finalApiKey?.trim() ? { apiKey: finalApiKey.trim() } : {}),
-                    };
-                    onComplete(newConfig);
-                } })] }));
-};

package/dist/components/ConsolidatedToolMessage.js

@@ -1,34 +0,0 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { Box, Text } from 'ink';
-import { FormattedMessage } from './FormattedMessage.js';
-import { LeftBar } from './LeftBar.js';
-export const ConsolidatedToolMessage = ({ toolCalls, toolResults, expanded = false, }) => {
-    const toolNames = toolCalls.map((toolCall) => toolCall.name);
-    const title = `Called: ${toolNames.join(', ')}`;
-    const containsTodoTool = toolCalls.some((toolCall) => toolCall.name === 'todo_read' || toolCall.name === 'todo_write');
-    const titleColor = containsTodoTool ? 'green' : 'cyan';
-    const isExpanded = expanded || containsTodoTool;
-    if (isExpanded) {
-        return (_jsxs(LeftBar, { color: titleColor, children: [_jsxs(Text, { color: titleColor, bold: true, children: ["\u25BC ", title] }), toolCalls.map((toolCall, idx) => {
-                    const result = toolResults.get(toolCall.id);
-                    if (!result)
-                        return null;
-                    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "cyan", bold: true, children: ["[", result.name, "]:"] }), _jsx(FormattedMessage, { content: result.content })] }, idx));
-                })] }));
-    }
-    const compactLines = toolCalls.flatMap((toolCall) => {
-        const result = toolResults.get(toolCall.id);
-        if (!result)
-            return [];
-        const compactContent = result.content
-            .replace(/\s+/g, ' ')
-            .trim();
-        return [`[${result.name}] ${compactContent}`];
-    });
-    const compactPreview = compactLines.join(' | ');
-    const previewLimit = 180;
-    const preview = compactPreview.length > previewLimit
-        ? `${compactPreview.slice(0, previewLimit).trimEnd()}... (use /expand)`
-        : compactPreview;
-    return (_jsxs(LeftBar, { color: "white", children: [_jsxs(Text, { color: titleColor, dimColor: true, bold: true, children: ["\u25B6 ", title] }), _jsx(Text, { dimColor: true, children: preview })] }));
-};

package/dist/components/FormattedMessage.js

@@ -1,170 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Box, Text } from 'ink';
-import { renderFormattedText } from '../utils/format-message.js';
-import { LeftBar } from './LeftBar.js';
-export const DEFERRED_TABLE_PLACEHOLDER = 'table loading';
-const graphemeSegmenter = typeof Intl !== 'undefined' && 'Segmenter' in Intl
-    ? new Intl.Segmenter(undefined, { granularity: 'grapheme' })
-    : null;
-const COMBINING_MARK_PATTERN = /\p{Mark}/u;
-const ZERO_WIDTH_PATTERN = /[\u200B-\u200D\uFE0E\uFE0F]/u;
-const DOUBLE_WIDTH_PATTERN = /[\u1100-\u115F\u2329\u232A\u2E80-\uA4CF\uAC00-\uD7A3\uF900-\uFAFF\uFE10-\uFE19\uFE30-\uFE6F\uFF00-\uFF60\uFFE0-\uFFE6\u{1F300}-\u{1FAFF}\u{1F900}-\u{1F9FF}\u{1F1E6}-\u{1F1FF}]/u;
-function splitGraphemes(text) {
-    if (!text)
-        return [];
-    if (graphemeSegmenter) {
-        return Array.from(graphemeSegmenter.segment(text), (segment) => segment.segment);
-    }
-    return Array.from(text);
-}
-function getGraphemeWidth(grapheme) {
-    if (!grapheme)
-        return 0;
-    if (ZERO_WIDTH_PATTERN.test(grapheme))
-        return 0;
-    if (COMBINING_MARK_PATTERN.test(grapheme))
-        return 0;
-    if (/^[\u0000-\u001F\u007F-\u009F]$/.test(grapheme))
-        return 0;
-    if (DOUBLE_WIDTH_PATTERN.test(grapheme))
-        return 2;
-    return 1;
-}
-function getTextWidth(text) {
-    return splitGraphemes(text).reduce((width, grapheme) => width + getGraphemeWidth(grapheme), 0);
-}
-function padToWidth(text, width) {
-    const padding = Math.max(0, width - getTextWidth(text));
-    return text + ' '.repeat(padding);
-}
-function parseMarkdownTableToRows(markdown) {
-    const lines = markdown.trim().split('\n');
-    if (lines.length < 3)
-        return null;
-    const parseRow = (row) => row.split('|')
-        .map((cell) => cell.trim())
-        .filter((cell, index, array) => {
-        if (index === 0 && cell === '')
-            return false;
-        if (index === array.length - 1 && cell === '')
-            return false;
-        return true;
-    });
-    const header = parseRow(lines[0]);
-    const separator = parseRow(lines[1]);
-    if (header.length === 0 || separator.length === 0)
-        return null;
-    if (!separator.every((cell) => /^:?-{3,}:?$/.test(cell.replace(/\s+/g, ''))))
-        return null;
-    const rows = lines.slice(2).map(parseRow);
-    return [header, ...rows];
-}
-function renderPreformattedTable(markdown) {
-    const rows = parseMarkdownTableToRows(markdown);
-    if (!rows || rows.length === 0) {
-        return markdown.trim();
-    }
-    const columnCount = Math.max(...rows.map((row) => row.length));
-    const normalizedRows = rows.map((row) => Array.from({ length: columnCount }, (_, index) => row[index] ?? ''));
-    const widths = Array.from({ length: columnCount }, (_, index) => Math.max(...normalizedRows.map((row) => getTextWidth(row[index]))));
-    const formatRow = (row) => row
-        .map((cell, index) => padToWidth(cell, widths[index]))
-        .join('  ')
-        .trimEnd();
-    const header = formatRow(normalizedRows[0]);
-    const divider = widths.map((width) => '-'.repeat(width)).join('  ');
-    const body = normalizedRows.slice(1).map(formatRow);
-    return [header, divider, ...body].join('\n');
-}
-/**
- * FormattedMessage component
- *
- * Parses a markdown string and renders:
- * - Standard text with ANSI formatting
- * - Markdown tables as preformatted monospace text
- * - Code blocks (rendered in a box)
- */
-export const FormattedMessage = ({ content, deferTables = false }) => {
-    if (!content)
-        return null;
-    const lines = content.split('\n');
-    const blocks = [];
-    let currentBlockContent = [];
-    let currentBlockType = 'text';
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const trimmedLine = line.trim();
-        // 1. Handle Code Blocks
-        if (currentBlockType === 'code') {
-            currentBlockContent.push(line);
-            // Check for end of code block
-            if (trimmedLine.startsWith('```')) {
-                blocks.push({ type: 'code', content: currentBlockContent.join('\n') });
-                currentBlockContent = [];
-                currentBlockType = 'text';
-            }
-            continue;
-        }
-        // Start Code Block
-        if (trimmedLine.startsWith('```')) {
-            // Finish pending text block
-            if (currentBlockContent.length > 0) {
-                blocks.push({ type: 'text', content: currentBlockContent.join('\n') });
-            }
-            currentBlockContent = [line];
-            currentBlockType = 'code';
-            continue;
-        }
-        // 2. Handle Tables
-        if (currentBlockType === 'table') {
-            if (trimmedLine.startsWith('|')) {
-                currentBlockContent.push(line);
-                continue;
-            }
-            else {
-                // End of table block found (line doesn't start with |)
-                blocks.push({ type: 'table', content: currentBlockContent.join('\n') });
-                // Reset to text and fall through to re-process this line
-                currentBlockContent = [];
-                currentBlockType = 'text';
-            }
-        }
-        // Start Table Block check
-        // A table start requires a pipe AND a subsequent separator line
-        const isTableStart = trimmedLine.startsWith('|');
-        const nextLine = lines[i + 1];
-        const isNextLineSeparator = nextLine && nextLine.trim().startsWith('|') && nextLine.includes('---');
-        if (isTableStart && isNextLineSeparator) {
-            // Finish pending text block
-            if (currentBlockContent.length > 0) {
-                blocks.push({ type: 'text', content: currentBlockContent.join('\n') });
-            }
-            currentBlockContent = [line];
-            currentBlockType = 'table';
-            continue;
-        }
-        // 3. Handle Text
-        currentBlockContent.push(line);
-    }
-    // Push final block
-    if (currentBlockContent.length > 0) {
-        blocks.push({ type: currentBlockType, content: currentBlockContent.join('\n') });
-    }
-    return (_jsx(Box, { flexDirection: "column", children: blocks.map((block, index) => {
-            if (block.type === 'table') {
-                if (!block.content.trim())
-                    return null;
-                if (deferTables) {
-                    return (_jsx(Box, { marginY: 1, children: _jsx(Text, { dimColor: true, children: DEFERRED_TABLE_PLACEHOLDER }) }, index));
-                }
-                return (_jsx(LeftBar, { color: "gray", marginTop: 1, marginBottom: 1, children: _jsx(Text, { children: renderPreformattedTable(block.content) }) }, index));
-            }
-            if (block.type === 'code') {
-                return (_jsx(LeftBar, { color: "gray", marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: block.content }) }, index));
-            }
-            // Text Block
-            if (!block.content.trim())
-                return null;
-            return (_jsx(Box, { marginBottom: 0, children: _jsx(Text, { children: renderFormattedText(block.content) }) }, index));
-        }) }));
-};