@animus-labs/cortex 0.2.0

package/dist/tools/glob.js

@@ -0,0 +1,268 @@
+/**
+ * Glob tool: find files by name pattern matching.
+ *
+ * Uses fast-glob for pattern matching and sorts results by
+ * modification time (newest first). Respects .gitignore rules.
+ *
+ * Reference: docs/cortex/tools/glob.md
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { Type } from 'typebox';
+import { readGitignorePatterns, DEFAULT_IGNORE_PATTERNS, } from './shared/gitignore.js';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+export const GlobParams = Type.Object({
+    pattern: Type.String({ description: 'Glob pattern to match files against (e.g., "**/*.ts", "src/**/*.test.js")' }),
+    path: Type.Optional(Type.String({ description: 'Directory to search in. Default: current working directory.' })),
+});
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_RESULTS = 100;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Recursively walk a directory and collect files matching a glob pattern.
+ * Uses Node.js built-in fs for simplicity (fast-glob would be used in production).
+ *
+ * This implementation is a simplified glob matcher. It supports:
+ * - `*` (match any characters except /)
+ * - `**` (match any path segment)
+ * - `?` (match single character)
+ * - `{a,b}` (alternation)
+ * - `[abc]` (character class)
+ */
+function globPatternToRegex(pattern) {
+    let regex = '';
+    let i = 0;
+    while (i < pattern.length) {
+        const char = pattern[i];
+        if (char === '*') {
+            if (pattern[i + 1] === '*') {
+                // ** matches any path segment
+                if (pattern[i + 2] === '/' || pattern[i + 2] === undefined) {
+                    regex += '(?:.+/)?';
+                    i += pattern[i + 2] === '/' ? 3 : 2;
+                    continue;
+                }
+            }
+            // * matches anything except /
+            regex += '[^/]*';
+            i++;
+        }
+        else if (char === '?') {
+            regex += '[^/]';
+            i++;
+        }
+        else if (char === '{') {
+            // Find the closing brace
+            const closeIdx = pattern.indexOf('}', i);
+            if (closeIdx === -1) {
+                regex += '\\{';
+                i++;
+            }
+            else {
+                const alternatives = pattern.slice(i + 1, closeIdx).split(',');
+                regex += '(?:' + alternatives.map(escapeRegexPart).join('|') + ')';
+                i = closeIdx + 1;
+            }
+        }
+        else if (char === '[') {
+            const closeIdx = pattern.indexOf(']', i);
+            if (closeIdx === -1) {
+                regex += '\\[';
+                i++;
+            }
+            else {
+                regex += pattern.slice(i, closeIdx + 1);
+                i = closeIdx + 1;
+            }
+        }
+        else if (char === '.') {
+            regex += '\\.';
+            i++;
+        }
+        else {
+            regex += char;
+            i++;
+        }
+    }
+    return new RegExp(`^${regex}$`);
+}
+function escapeRegexPart(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Check if a path matches any of the ignore patterns.
+ */
+function isIgnored(relativePath, ignorePatterns) {
+    const parts = relativePath.split('/');
+    for (const pattern of ignorePatterns) {
+        // Direct directory/file name match
+        const cleanPattern = pattern.endsWith('/') ? pattern.slice(0, -1) : pattern;
+        // Check if any path component matches
+        if (!cleanPattern.includes('/')) {
+            if (parts.some((part) => {
+                if (cleanPattern.includes('*') || cleanPattern.includes('?')) {
+                    return globPatternToRegex(cleanPattern).test(part);
+                }
+                return part === cleanPattern;
+            })) {
+                return true;
+            }
+        }
+        else {
+            // Full path pattern match
+            if (globPatternToRegex(cleanPattern).test(relativePath)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Walk a directory tree and collect file paths.
+ */
+async function walkDirectory(dir, baseDir, ignorePatterns) {
+    const results = [];
+    let entries;
+    try {
+        entries = await fs.promises.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        // Skip directories we can't read
+        return results;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        const relativePath = path.relative(baseDir, fullPath).split(path.sep).join('/');
+        // Check ignore patterns
+        if (isIgnored(relativePath, ignorePatterns)) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            const subResults = await walkDirectory(fullPath, baseDir, ignorePatterns);
+            results.push(...subResults);
+        }
+        else if (entry.isFile()) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+export function createGlobTool(config) {
+    const respectGitignore = config.respectGitignore ?? true;
+    return {
+        name: 'Glob',
+        description: 'Find files by name pattern. Returns paths sorted by modification time (newest first).',
+        parameters: GlobParams,
+        async execute(params) {
+            const searchPath = params.path ? path.resolve(params.path) : path.resolve(config.defaultCwd);
+            const startTime = Date.now();
+            // Verify search path exists
+            try {
+                const stat = await fs.promises.stat(searchPath);
+                if (!stat.isDirectory()) {
+                    return {
+                        content: [{ type: 'text', text: `Directory does not exist: ${searchPath}` }],
+                        details: {
+                            totalCount: 0,
+                            truncated: false,
+                            durationMs: Date.now() - startTime,
+                            searchPath,
+                        },
+                    };
+                }
+            }
+            catch {
+                return {
+                    content: [{ type: 'text', text: `Directory does not exist: ${searchPath}` }],
+                    details: {
+                        totalCount: 0,
+                        truncated: false,
+                        durationMs: Date.now() - startTime,
+                        searchPath,
+                    },
+                };
+            }
+            // Collect ignore patterns
+            let ignorePatterns;
+            if (respectGitignore) {
+                const gitignorePatterns = await readGitignorePatterns(searchPath);
+                ignorePatterns = gitignorePatterns.length > 0
+                    ? [...DEFAULT_IGNORE_PATTERNS, ...gitignorePatterns]
+                    : DEFAULT_IGNORE_PATTERNS;
+            }
+            else {
+                ignorePatterns = [];
+            }
+            // Walk directory tree
+            const allFiles = await walkDirectory(searchPath, searchPath, ignorePatterns);
+            // Convert glob pattern to regex for filtering
+            const pattern = params.pattern;
+            let regex;
+            try {
+                regex = globPatternToRegex(pattern);
+            }
+            catch {
+                return {
+                    content: [{ type: 'text', text: `Invalid glob pattern: ${pattern}` }],
+                    details: {
+                        totalCount: 0,
+                        truncated: false,
+                        durationMs: Date.now() - startTime,
+                        searchPath,
+                    },
+                };
+            }
+            // Filter files by pattern
+            const matchingFiles = allFiles.filter((filePath) => {
+                const relativePath = path.relative(searchPath, filePath).split(path.sep).join('/');
+                return regex.test(relativePath);
+            });
+            // Sort by modification time (newest first)
+            const filesWithMtime = await Promise.all(matchingFiles.map(async (filePath) => {
+                try {
+                    const stat = await fs.promises.stat(filePath);
+                    return { filePath, mtime: stat.mtimeMs };
+                }
+                catch {
+                    return { filePath, mtime: 0 };
+                }
+            }));
+            filesWithMtime.sort((a, b) => b.mtime - a.mtime);
+            const totalCount = filesWithMtime.length;
+            const truncated = totalCount > MAX_RESULTS;
+            const resultFiles = filesWithMtime.slice(0, MAX_RESULTS);
+            // Normalize paths to forward slashes in output
+            const outputPaths = resultFiles.map((f) => f.filePath.split(path.sep).join('/'));
+            const durationMs = Date.now() - startTime;
+            let text;
+            if (outputPaths.length === 0) {
+                text = 'No files matched the pattern.';
+            }
+            else {
+                text = outputPaths.join('\n');
+                if (truncated) {
+                    text += `\n\n[Showing ${MAX_RESULTS} of ${totalCount} matches. Use a more specific pattern to narrow results.]`;
+                }
+            }
+            return {
+                content: [{ type: 'text', text }],
+                details: {
+                    totalCount,
+                    truncated,
+                    durationMs,
+                    searchPath,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=glob.js.map

package/dist/tools/glob.js.map

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

package/dist/tools/grep.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Grep tool: search file contents using regex.
+ *
+ * Uses the bundled ripgrep (rg) binary from @vscode/ripgrep as the
+ * primary search engine. Falls back to a pure Node.js regex search
+ * if the rg binary is unavailable (e.g., postinstall failed).
+ *
+ * Three output modes: files_with_matches, content, count.
+ * Pagination via offset + head_limit.
+ *
+ * Reference: docs/cortex/tools/grep.md
+ */
+import { Type, type Static } from 'typebox';
+import type { ToolContentDetails } from '../types.js';
+export declare const GrepParams: Type.TObject<{
+    pattern: Type.TString;
+    path: Type.TOptional<Type.TString>;
+    glob: Type.TOptional<Type.TString>;
+    type: Type.TOptional<Type.TString>;
+    output_mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"files_with_matches">, Type.TLiteral<"content">, Type.TLiteral<"count">]>>;
+    context: Type.TOptional<Type.TNumber>;
+    '-i': Type.TOptional<Type.TBoolean>;
+    head_limit: Type.TOptional<Type.TNumber>;
+    offset: Type.TOptional<Type.TNumber>;
+    multiline: Type.TOptional<Type.TBoolean>;
+}>;
+export type GrepParamsType = Static<typeof GrepParams>;
+export interface GrepDetails {
+    totalFiles: number;
+    totalMatches: number;
+    durationMs: number;
+    /** True when results were capped by head_limit. Output size limiting is handled by the agent's result-persistence interceptor. */
+    truncated: boolean;
+    usingFallback: boolean;
+}
+export interface GrepToolConfig {
+    /** Default search directory when no path param is given. */
+    defaultCwd: string;
+    /** Whether to respect .gitignore. Default: true. */
+    respectGitignore?: boolean | undefined;
+}
+export declare function createGrepTool(config: GrepToolConfig): {
+    name: string;
+    description: string;
+    parameters: typeof GrepParams;
+    execute: (params: GrepParamsType) => Promise<ToolContentDetails<GrepDetails>>;
+};
+/**
+ * Reset the cached ripgrep path. Used by tests to force re-detection.
+ * @internal
+ */
+export declare function _resetRipgrepCache(): void;
+//# sourceMappingURL=grep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAUtD,eAAO,MAAM,UAAU;;;;;;;;;;;EAiCrB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAMvD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kIAAkI;IAClI,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AA4CD,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAipBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;CAC/E,CAuBA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}