@travisennis/acai 0.0.12 → 0.0.14

package/dist/tools/grep.js

@@ -1,608 +0,0 @@
-import { execFile, } from "node:child_process";
-import { inspect } from "node:util";
-import { z } from "zod";
-import style from "../terminal/style.js";
-import { toDisplayPath } from "../utils/filesystem/path-display.js";
-import { convertNullString } from "../utils/zod.js";
-// default limit
-const DEFAULT_MAX_RESULTS = 100;
-export const GrepTool = {
-    name: "Grep",
-};
-const inputSchema = z.object({
-    pattern: z
-        .string()
-        .describe("The search pattern (regex by default, or fixed-string if literal=true or auto-detected as unbalanced)"),
-    path: z.string().describe("The path to search in"),
-    recursive: z
-        .preprocess((val) => convertNullString(val), z.coerce.boolean().nullable())
-        .default(null)
-        .describe("Search recursively. (default: true))"),
-    ignoreCase: z
-        .preprocess((val) => convertNullString(val), z.coerce.boolean().nullable())
-        .default(null)
-        .describe("Use case-sensitive search. (default: false)"),
-    filePattern: z
-        .preprocess((val) => convertNullString(val), z.coerce.string().nullable())
-        .default(null)
-        .describe("Glob pattern to filter files (e.g., '*.ts', '**/*.test.js'). (Default: no filtering)"),
-    contextLines: z
-        .preprocess((val) => convertNullString(val), z.coerce.number().nullable())
-        .default(null)
-        .describe("The number of context lines needed in search results. (Default: 0)"),
-    searchIgnored: z
-        .preprocess((val) => convertNullString(val), z.coerce.boolean().nullable())
-        .default(null)
-        .describe("Search ignored files. (Default: false)"),
-    literal: z
-        .preprocess((val) => convertNullString(val), z.coerce.boolean().nullable())
-        .default(null)
-        .describe("Pass true for fixed-string search (-F), false for regex, (Default: auto-detects unbalanced patterns like mismatched parentheses/brackets.)"),
-    maxResults: z
-        .preprocess((val) => convertNullString(val), z.coerce.number().nullable())
-        .default(null)
-        .describe("Maximum number of matches to return. Set to 0 for no limit. (Default: 100)"),
-});
-export const createGrepTool = () => {
-    return {
-        toolDef: {
-            description: "Search file contents using ripgrep.",
-            inputSchema,
-        },
-        display({ pattern, path, filePattern, recursive, ignoreCase, contextLines, }) {
-            // grok doesn't follow my instructions
-            const safeFilePattern = filePattern === "null" || filePattern === "undefined"
-                ? null
-                : filePattern;
-            // Enhanced tool-init with detailed search parameters
-            const displayPath = toDisplayPath(path);
-            let initMessage = `${style.cyan(inspect(pattern))} in ${style.cyan(displayPath)}`;
-            if (safeFilePattern) {
-                initMessage += ` ${style.dim(`(filter: ${safeFilePattern})`)}`;
-            }
-            if (recursive === false) {
-                initMessage += ` ${style.dim("(non-recursive)")}`;
-            }
-            if (ignoreCase) {
-                initMessage += ` ${style.dim("(case-insensitive)")}`;
-            }
-            if (contextLines && contextLines > 0) {
-                initMessage += ` ${style.dim(`(with ${contextLines} context line${contextLines === 1 ? "" : "s"})`)}`;
-            }
-            return initMessage;
-        },
-        async execute({ pattern, path, recursive, ignoreCase, filePattern, contextLines, searchIgnored, literal, maxResults, }, { abortSignal }) {
-            if (abortSignal?.aborted) {
-                throw new Error("Grep search aborted");
-            }
-            // Validate path - default to cwd if not provided
-            const effectivePath = typeof path === "string" && path.trim() !== "" ? path : process.cwd();
-            try {
-                // Compute likelyUnbalancedRegex once and pass through
-                const isLikelyUnbalanced = likelyUnbalancedRegex(pattern);
-                let effectiveLiteral = null;
-                if (literal === true) {
-                    effectiveLiteral = true;
-                }
-                else if (literal === false) {
-                    effectiveLiteral = false;
-                }
-                else {
-                    effectiveLiteral = isLikelyUnbalanced;
-                }
-                const effectiveMaxResults = maxResults ?? DEFAULT_MAX_RESULTS;
-                const safeFilePattern = filePattern === "null" || filePattern === "undefined"
-                    ? null
-                    : filePattern;
-                const grepResult = await grepFilesStructured(pattern, effectivePath, {
-                    recursive,
-                    ignoreCase,
-                    filePattern: safeFilePattern,
-                    contextLines,
-                    searchIgnored,
-                    literal: effectiveLiteral,
-                    maxResults: effectiveMaxResults,
-                    likelyUnbalanced: isLikelyUnbalanced,
-                }, abortSignal);
-                return grepResult.rawOutput;
-            }
-            catch (error) {
-                const errorMessage = error.message;
-                let userFriendlyError = `Error searching for "${pattern}" in ${effectivePath}: ${errorMessage}`;
-                if (errorMessage.includes("No such file or directory")) {
-                    userFriendlyError = `Path not found: "${effectivePath}"`;
-                    if (filePattern) {
-                        userFriendlyError += ` with file pattern "${filePattern}"`;
-                    }
-                    userFriendlyError += " - check if the path exists and is accessible";
-                }
-                else if (errorMessage.includes("permission denied")) {
-                    userFriendlyError = `Permission denied accessing "${effectivePath}"`;
-                }
-                else if (errorMessage.includes("Regex parse error")) {
-                    userFriendlyError = `Invalid search pattern "${pattern}" - try using literal=true for fixed-string search`;
-                }
-                throw new Error(userFriendlyError);
-            }
-        },
-    };
-};
-/**
- * Skips past a character class [...], handling escaped characters.
- * Returns the new index after the character class.
- */
-function skipCharacterClass(pattern, startIndex) {
-    let i = startIndex + 1;
-    while (i < pattern.length && pattern[i] !== "]") {
-        if (pattern[i] === "\\")
-            i++;
-        i++;
-    }
-    return i;
-}
-/**
- * Checks if a character is valid inside braces (digits 0-9 or comma).
- */
-function isValidBraceChar(c) {
-    return (c >= "0" && c <= "9") || c === ",";
-}
-/**
- * Checks if empty braces have a preceding atom.
- * Empty braces with no preceding atom are treated as literal.
- */
-function hasPrecedingAtom(pattern, startIndex) {
-    if (startIndex === 0)
-        return false;
-    const prev = pattern[startIndex - 1];
-    return /\S/.test(prev);
-}
-/**
- * Parses and validates the content inside braces {..}.
- * Returns true if the brace content is invalid.
- */
-function isInvalidBraceContent(pattern, startIndex) {
-    const j = startIndex + 1;
-    // Find closing brace and check for invalid characters
-    let hasDigits = false;
-    let k = j;
-    while (k < pattern.length && pattern[k] !== "}") {
-        if (!isValidBraceChar(pattern[k])) {
-            return true;
-        }
-        if (pattern[k] >= "0" && pattern[k] <= "9") {
-            hasDigits = true;
-        }
-        k++;
-    }
-    // No closing brace found
-    if (k >= pattern.length) {
-        return true;
-    }
-    // Empty braces {} with preceding atom are invalid
-    if (!hasDigits && hasPrecedingAtom(pattern, startIndex)) {
-        return true;
-    }
-    return false;
-}
-/**
- * Check for invalid repetition operators (e.g., {n}, {n,}, {n,m}) outside of character classes.
- * Returns true if any invalid repetition operators are found.
- */
-function hasInvalidRepetition(pattern) {
-    for (let i = 0; i < pattern.length; i++) {
-        const ch = pattern[i];
-        if (ch === "\\") {
-            i++; // Skip the next character (escaped)
-            continue;
-        }
-        if (ch === "[") {
-            i = skipCharacterClass(pattern, i);
-            continue;
-        }
-        // Unmatched closing brace is invalid
-        if (ch === "}") {
-            return true;
-        }
-        // Handle opening brace
-        if (ch === "{") {
-            if (isInvalidBraceContent(pattern, i)) {
-                return true;
-            }
-            i = findClosingBrace(pattern, i);
-        }
-    }
-    return false;
-}
-/**
- * Finds the index of the closing brace matching an opening brace.
- * Returns the index of the closing brace, or the last index of pattern if not found.
- */
-function findClosingBrace(pattern, startIndex) {
-    let j = startIndex + 1;
-    while (j < pattern.length && pattern[j] !== "}") {
-        j++;
-    }
-    return j;
-}
-/**
- * Count bracket/paren/brace pairs in a regex pattern, excluding character classes.
- */
-function countBrackets(pattern) {
-    const counts = {
-        openParen: 0,
-        closeParen: 0,
-        openBracket: 0,
-        closeBracket: 0,
-        openBrace: 0,
-        closeBrace: 0,
-    };
-    let escaped = false;
-    let inCharacterClass = false;
-    for (let i = 0; i < pattern.length; i++) {
-        const ch = pattern[i];
-        if (escaped) {
-            escaped = false;
-            continue;
-        }
-        if (ch === "\\") {
-            escaped = true;
-            continue;
-        }
-        // Track character class boundaries
-        if (ch === "[" && !inCharacterClass) {
-            inCharacterClass = true;
-            counts.openBracket++;
-            continue;
-        }
-        if (ch === "]" && inCharacterClass) {
-            inCharacterClass = false;
-            counts.closeBracket++;
-            continue;
-        }
-        // Only count brackets/parens/braces outside of character classes
-        if (!inCharacterClass) {
-            switch (ch) {
-                case "(":
-                    counts.openParen++;
-                    break;
-                case ")":
-                    counts.closeParen++;
-                    break;
-                case "{":
-                    counts.openBrace++;
-                    break;
-                case "}":
-                    counts.closeBrace++;
-                    break;
-                default:
-                    break;
-            }
-        }
-    }
-    return counts;
-}
-/**
- * Check if a pattern contains regex metacharacters.
- * Returns true if the pattern likely needs regex mode.
- */
-function containsRegexMetacharacters(pattern) {
-    // Regex metacharacters: ^ $ . * + ? [ ] ( ) { } | \
-    const metacharacterPattern = /[\^$.*+?[\](){}|\\]/;
-    return metacharacterPattern.test(pattern);
-}
-export function likelyUnbalancedRegex(pattern) {
-    // First check: unbalanced brackets/parentheses/braces = likely a typo, use literal
-    const counts = countBrackets(pattern);
-    // Check for unbalanced brackets, parentheses, and braces
-    const hasUnbalancedBrackets = counts.openBracket !== counts.closeBracket;
-    const hasUnbalancedParens = counts.openParen !== counts.closeParen;
-    const hasUnbalancedBraces = counts.openBrace !== counts.closeBrace;
-    // Also check for invalid repetition operators
-    const hasInvalidRepetitionFlag = hasInvalidRepetition(pattern);
-    // If pattern has unbalanced syntax, treat as literal (user probably meant to type literal)
-    if (hasUnbalancedBrackets ||
-        hasUnbalancedParens ||
-        hasUnbalancedBraces ||
-        hasInvalidRepetitionFlag) {
-        return true;
-    }
-    // Second check: if pattern has regex metacharacters, treat as regex (return false)
-    // This allows ripgrep to handle the pattern as a proper regex
-    if (containsRegexMetacharacters(pattern)) {
-        return false;
-    }
-    // Default: simple alphanumeric strings should use literal mode
-    return true;
-}
-/**
- * Build grep command args array directly
- *
- * @param pattern - The regex pattern to search for
- * @param path - The path to search in
- * @param options - Additional options for the grep command
- * @returns The args array for the grep command
- */
-export function buildGrepArgs(pattern, path, options = {}) {
-    const effectiveRecursive = options.recursive === null ? true : options.recursive;
-    const effectiveIgnoreCase = options.ignoreCase === null ? false : options.ignoreCase;
-    const effectiveSearchIgnored = options.searchIgnored === null ? false : options.searchIgnored;
-    const effectiveFilePattern = options.filePattern;
-    const effectiveContextLines = options.contextLines;
-    // Use the pre-computed likelyUnbalanced result if available
-    let effectiveLiteral;
-    if (options.literal === true) {
-        effectiveLiteral = true;
-    }
-    else if (options.literal === false) {
-        effectiveLiteral = false;
-    }
-    else if (options.likelyUnbalanced !== undefined) {
-        effectiveLiteral = options.likelyUnbalanced;
-    }
-    else {
-        effectiveLiteral = likelyUnbalancedRegex(pattern);
-    }
-    const args = ["--json"];
-    if (effectiveRecursive === false) {
-        args.push("--max-depth=0");
-    }
-    if (effectiveIgnoreCase) {
-        args.push("--ignore-case");
-    }
-    if (effectiveContextLines !== null && effectiveContextLines !== undefined) {
-        args.push(`--context=${effectiveContextLines}`);
-    }
-    if (effectiveFilePattern !== null && effectiveFilePattern !== undefined) {
-        args.push(`--glob=${effectiveFilePattern}`);
-    }
-    if (effectiveSearchIgnored) {
-        args.push("--no-ignore");
-    }
-    if (effectiveLiteral) {
-        args.push("-F");
-    }
-    // Use ripgrep's --max-count flag to limit matches per file for efficiency
-    // This helps prevent any single file from dominating results
-    if (options.maxResults !== null &&
-        options.maxResults !== undefined &&
-        options.maxResults > 0) {
-        // Use a reasonable per-file limit (max 100 per file) to balance efficiency and completeness
-        const perFileLimit = Math.min(options.maxResults, 100);
-        args.push(`--max-count=${perFileLimit}`);
-    }
-    args.push(pattern);
-    args.push(path);
-    return args;
-}
-/**
- * Parse ripgrep JSON output and extract structured match information
- */
-export function parseRipgrepJsonOutput(content) {
-    if (!content || content.trim() === "") {
-        return [];
-    }
-    const parsed = [];
-    const lines = content.trim().split("\n");
-    for (const line of lines) {
-        if (!line.trim()) {
-            continue;
-        }
-        try {
-            const rgResult = JSON.parse(line);
-            // Handle different ripgrep message types
-            if (rgResult.type === "match") {
-                const data = rgResult.data;
-                parsed.push({
-                    file: data.path?.text ?? data.path?.bytes?.toString(),
-                    line: data.line_number ?? 0,
-                    content: data.lines?.text ?? data.line ?? "",
-                    isMatch: true,
-                    lineNumber: data.line_number,
-                    absolutePath: data.absolute_path?.text ?? data.absolute_path?.bytes?.toString(),
-                    submatches: data.submatches?.map((sm) => ({
-                        start: sm.start,
-                        end: sm.end,
-                        text: sm.text,
-                    })),
-                });
-            }
-            else if (rgResult.type === "context") {
-                const data = rgResult.data;
-                parsed.push({
-                    file: data.path?.text ?? data.path?.bytes?.toString(),
-                    line: data.line_number ?? 0,
-                    content: data.lines?.text ?? data.line ?? "",
-                    isMatch: false,
-                    isContext: true,
-                    lineNumber: data.line_number,
-                    absolutePath: data.absolute_path?.text ?? data.absolute_path?.bytes?.toString(),
-                });
-            }
-            // Ignore other message types like "begin", "end", "summary"
-        }
-        catch { }
-    }
-    return parsed;
-}
-/**
- * Convert parsed JSON matches back to legacy line-number format for backwards compatibility
- */
-function matchesToLegacyFormat(matches) {
-    const lines = [];
-    for (const match of matches) {
-        const lineNum = match.lineNumber ?? match.line;
-        const file = match.file ?? match.absolutePath;
-        if (file) {
-            if (match.isMatch) {
-                lines.push(`${file}:${lineNum}:${match.content}`);
-            }
-            else if (match.isContext) {
-                lines.push(`${file}-${lineNum}-${match.content}`);
-            }
-        }
-        else {
-            if (match.isMatch) {
-                lines.push(`${lineNum}:${match.content}`);
-            }
-            else if (match.isContext) {
-                lines.push(`${lineNum}-${match.content}`);
-            }
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * Count actual matches (excluding context lines)
- */
-export function countActualMatches(parsed) {
-    return parsed.filter((match) => match.isMatch && !match.isContext).length;
-}
-/**
- * Count context lines
- */
-export function countContextLines(parsed) {
-    return parsed.filter((match) => match.isContext).length;
-}
-function isContextNearKeptMatch(matches, index, indicesToKeep, contextWindow) {
-    for (let j = index - 1; j >= Math.max(0, index - contextWindow); j--) {
-        if (matches[j].isMatch && !matches[j].isContext && indicesToKeep.has(j)) {
-            return true;
-        }
-    }
-    for (let j = index + 1; j < Math.min(matches.length, index + contextWindow + 1); j++) {
-        if (matches[j].isMatch && !matches[j].isContext && indicesToKeep.has(j)) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Truncate matches to a maximum number of results, preserving context lines for kept matches
- */
-export function truncateMatches(matches, maxResults) {
-    if (!maxResults || maxResults <= 0) {
-        return { truncated: matches, isTruncated: false };
-    }
-    // Find indices of actual matches (excluding context lines)
-    const matchIndices = [];
-    for (let i = 0; i < matches.length; i++) {
-        if (matches[i].isMatch && !matches[i].isContext) {
-            matchIndices.push(i);
-        }
-    }
-    if (matchIndices.length <= maxResults) {
-        return { truncated: matches, isTruncated: false };
-    }
-    // Get the indices of matches we want to keep
-    const indicesToKeep = new Set();
-    for (let i = 0; i < maxResults; i++) {
-        indicesToKeep.add(matchIndices[i]);
-    }
-    // Build truncated result: include all kept matches AND their associated context lines
-    const truncated = [];
-    let matchesKept = 0;
-    const contextWindow = 3; // Include up to 3 context lines around each match
-    for (let i = 0; i < matches.length; i++) {
-        const match = matches[i];
-        if (match.isMatch && !match.isContext) {
-            // This is an actual match
-            if (matchesKept < maxResults) {
-                truncated.push(match);
-                matchesKept++;
-            }
-            else {
-            }
-        }
-        else if (match.isContext) {
-            if (isContextNearKeptMatch(matches, i, indicesToKeep, contextWindow)) {
-                truncated.push(match);
-            }
-        }
-        else {
-            // Other types, include them
-            truncated.push(match);
-        }
-    }
-    return {
-        truncated,
-        isTruncated: true,
-    };
-}
-export async function grepFilesStructured(pattern, path, options = {}, abortSignal) {
-    try {
-        const args = buildGrepArgs(pattern, path, options);
-        // Use execFile for async execution with proper abort signal handling
-        const rawOutput = await new Promise((resolve, reject) => {
-            const child = execFile("rg", args, {
-                encoding: "utf-8",
-                stdio: ["pipe", "pipe", "pipe"],
-            });
-            let stdout = "";
-            let stderr = "";
-            child.stdout?.on("data", (data) => {
-                stdout += data;
-            });
-            child.stderr?.on("data", (data) => {
-                stderr += data;
-            });
-            child.on("close", (code) => {
-                if (code === 0 || code === 1) {
-                    resolve(stdout);
-                }
-                else {
-                    reject(new Error(stderr || `ripgrep exited with code ${code}`));
-                }
-            });
-            child.on("error", (err) => {
-                reject(err);
-            });
-            if (abortSignal) {
-                abortSignal.addEventListener("abort", () => {
-                    child.kill("SIGTERM");
-                    reject(new Error("Grep search aborted"));
-                });
-            }
-        });
-        // Parse JSON output from ripgrep
-        const parsedMatches = parseRipgrepJsonOutput(rawOutput);
-        // If JSON parsing resulted in no matches, check if it's a "no matches" case
-        // (ripgrep --json returns empty for no matches)
-        const hasMatches = parsedMatches.length > 0;
-        const matchCount = countActualMatches(parsedMatches);
-        // Use the maxResults from options (which will be set by the execute function)
-        const maxResults = options.maxResults;
-        const { truncated, isTruncated } = truncateMatches(parsedMatches, maxResults);
-        const displayedCount = countActualMatches(truncated);
-        const displayedContextCount = countContextLines(truncated);
-        // Convert to legacy format for backwards compatibility
-        const legacyOutput = matchesToLegacyFormat(truncated);
-        const finalOutput = legacyOutput || "No matches found.";
-        return {
-            rawOutput: finalOutput,
-            parsedMatches: truncated,
-            matchCount,
-            displayedCount,
-            contextCount: displayedContextCount,
-            hasMatches,
-            isTruncated,
-        };
-    }
-    catch (error) {
-        const execError = error;
-        const exitCode = execError.code;
-        if (exitCode === "1") {
-            return {
-                rawOutput: "No matches found.",
-                parsedMatches: [],
-                matchCount: 0,
-                contextCount: 0,
-                hasMatches: false,
-            };
-        }
-        if (exitCode === "2") {
-            const stderrStr = execError.message;
-            throw new Error(`Regex parse error in pattern "${pattern}": ${stderrStr}`);
-        }
-        throw new Error(`Error executing ripgrep: ${execError.message}`);
-    }
-}

package/dist/tools/ls.d.ts

@@ -1,26 +0,0 @@
-import { z } from "zod";
-import type { WorkspaceContext } from "../index.ts";
-import type { ToolExecutionOptions } from "./types.ts";
-export declare const LsTool: {
-    name: "LS";
-};
-declare const inputSchema: z.ZodObject<{
-    path: z.ZodOptional<z.ZodString>;
-    limit: z.ZodDefault<z.ZodPreprocess<z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
-}, z.core.$strip>;
-type LsInputSchema = z.infer<typeof inputSchema>;
-export declare const createLsTool: (options: {
-    workspace: WorkspaceContext;
-}) => Promise<{
-    toolDef: {
-        description: string;
-        inputSchema: z.ZodObject<{
-            path: z.ZodOptional<z.ZodString>;
-            limit: z.ZodDefault<z.ZodPreprocess<z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
-        }, z.core.$strip>;
-    };
-    display({ path: providedPath, limit }: LsInputSchema): string;
-    execute({ path: providedPath, limit }: LsInputSchema, { abortSignal }: ToolExecutionOptions): Promise<string>;
-}>;
-export {};
-//# sourceMappingURL=ls.d.ts.map

package/dist/tools/ls.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../source/tools/ls.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,MAAM;;CAElB,CAAC;AAEF,QAAA,MAAM,WAAW;;;iBASf,CAAC;AAEH,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAIjD,eAAO,MAAM,YAAY,GAAU,SAAS;IAC1C,SAAS,EAAE,gBAAgB,CAAC;CAC7B;;;;;;;;2CAU0C,aAAa;2CAOnB,aAAa,mBAC3B,oBAAoB,GACpC,OAAO,CAAC,MAAM,CAAC;EA6DrB,CAAC"}