neoctl 0.1.0

package/dist/tools/builtins/grep-tool.d.ts

@@ -0,0 +1,56 @@
+import type { Tool } from "../tool.js";
+export interface GrepToolInput {
+    query: string;
+    path?: string;
+    glob?: string[];
+    caseMode: "smart" | "sensitive" | "insensitive";
+    fixedStrings: boolean;
+    includeHidden: boolean;
+    contextLines: number;
+    maxResults: number;
+    maxColumns: number;
+}
+export interface GrepMatch {
+    file: string;
+    line: number;
+    column?: number;
+    text: string;
+    textTruncated?: {
+        originalLength: number;
+        maxChars: number;
+    };
+    submatches: Array<{
+        start: number;
+        end: number;
+        text: string;
+    }>;
+    contextBefore?: GrepContextLine[];
+    contextAfter?: GrepContextLine[];
+}
+export interface GrepContextLine {
+    file: string;
+    line: number;
+    text: string;
+    textTruncated?: {
+        originalLength: number;
+        maxChars: number;
+    };
+}
+export interface GrepToolOutput {
+    query: string;
+    cwd: string;
+    grepPath: string;
+    returnedMatches: number;
+    totalMatchesKnown: number | null;
+    truncated: boolean;
+    matches: GrepMatch[];
+    transportTruncation?: {
+        reason: "resultSize";
+        originalLength: number;
+        matchesBeforeTransport: number;
+        omittedMatches: number;
+        maxChars: number;
+    };
+    errors?: string[];
+}
+export declare const grepTool: Tool<GrepToolInput>;

package/dist/tools/builtins/grep-tool.js

@@ -0,0 +1,320 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { resolveBundledRipgrepBinary } from "./ripgrep-binary.js";
+export const grepTool = {
+    name: "grep",
+    aliases: ["rg"],
+    description: "Grep files with the bundled ripgrep binary. Accepts absolute paths and cwd-relative paths. It does not exclude heavy directories by default; pass explicit negated glob filters such as !node_modules/** when you want to skip them.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Regex pattern or literal text to look for." },
+            path: { type: "string", description: "Absolute or cwd-relative file/directory to grep. Defaults to the current working directory." },
+            glob: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional ripgrep glob filters such as src/**/*.ts, !dist/**, or !node_modules/**.",
+            },
+            caseMode: { type: "string", enum: ["smart", "sensitive", "insensitive"], description: "Case handling mode." },
+            fixedStrings: { type: "boolean", description: "Treat query as literal text instead of a regex." },
+            includeHidden: { type: "boolean", description: "Include hidden files and directories while still respecting ignore files." },
+            contextLines: { type: "integer", description: "Number of context lines around each match, 0-5." },
+            maxResults: { type: "integer", description: "Maximum total matches to return, 1-200." },
+            maxColumns: { type: "integer", description: "Maximum line width before ripgrep truncates a line, 80-1000." },
+        },
+        required: ["query"],
+        additionalProperties: false,
+    },
+    metadata: {
+        readOnly: true,
+        concurrent: true,
+        visible: true,
+        maxResultSizeChars: 24000,
+        searchHint: "grep files with bundled ripgrep",
+    },
+    mapResult(result) {
+        return shrinkGrepOutputForTransport(result.output, 21000);
+    },
+    validate(input) {
+        const record = input;
+        return {
+            query: record.query ?? "",
+            path: record.path,
+            glob: record.glob,
+            caseMode: record.caseMode ?? "smart",
+            fixedStrings: record.fixedStrings ?? false,
+            includeHidden: record.includeHidden ?? false,
+            contextLines: record.contextLines ?? 0,
+            maxResults: record.maxResults ?? 50,
+            maxColumns: record.maxColumns ?? 300,
+        };
+    },
+    validateInput(input) {
+        if (!input.query.trim())
+            return { ok: false, message: "grep.query cannot be empty" };
+        if (input.path !== undefined && !input.path.trim())
+            return { ok: false, message: "grep.path cannot be empty" };
+        if (!Number.isInteger(input.contextLines) || input.contextLines < 0 || input.contextLines > 5) {
+            return { ok: false, message: "grep.contextLines must be between 0 and 5" };
+        }
+        if (!Number.isInteger(input.maxResults) || input.maxResults < 1 || input.maxResults > 200) {
+            return { ok: false, message: "grep.maxResults must be between 1 and 200" };
+        }
+        if (!Number.isInteger(input.maxColumns) || input.maxColumns < 80 || input.maxColumns > 1000) {
+            return { ok: false, message: "grep.maxColumns must be between 80 and 1000" };
+        }
+        if (input.glob?.some((glob) => !glob.trim()))
+            return { ok: false, message: "grep.glob entries cannot be empty" };
+        return { ok: true, value: input };
+    },
+    isConcurrencySafe() {
+        return true;
+    },
+    async call(input, context, options) {
+        const { executablePath, platformKey } = resolveBundledRipgrepBinary();
+        const root = workingDirectory(context);
+        const target = path.resolve(root, input.path ?? ".");
+        const stat = await fs.stat(target).catch(() => undefined);
+        if (!stat)
+            return { ok: false, output: { error: `grep.path does not exist: ${target}` } };
+        options.onProgress?.({ toolName: "grep", message: `Searching with bundled rg (${platformKey})` });
+        return runRipgrep(executablePath, root, target, input);
+    },
+};
+function workingDirectory(context) {
+    const snapshot = context.appState.snapshot();
+    return path.resolve(snapshot.cwd ?? process.cwd());
+}
+async function runRipgrep(executablePath, root, target, input) {
+    const args = buildArgs(input, target);
+    const state = {
+        matches: [],
+        errors: [],
+        pendingContext: [],
+        maxResults: input.maxResults,
+        maxContextLines: input.contextLines,
+        truncated: false,
+        stopped: false,
+        overflowedMaxResults: false,
+    };
+    let stderr = "";
+    let stdoutBuffer = "";
+    const child = spawn(executablePath, args, { cwd: root, windowsHide: true });
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+        if (state.stopped)
+            return;
+        stdoutBuffer += chunk;
+        let newline = stdoutBuffer.indexOf("\n");
+        while (newline >= 0) {
+            const line = stdoutBuffer.slice(0, newline).trim();
+            stdoutBuffer = stdoutBuffer.slice(newline + 1);
+            if (line)
+                handleJsonLine(line, root, state);
+            if (shouldStopGrep(state)) {
+                state.stopped = true;
+                child.kill();
+                break;
+            }
+            newline = stdoutBuffer.indexOf("\n");
+        }
+    });
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", (chunk) => {
+        stderr = `${stderr}${chunk}`.slice(-12000);
+    });
+    return new Promise((resolve) => {
+        child.on("error", (error) => {
+            resolve({ ok: false, output: { error: error.message } });
+        });
+        child.on("close", (code) => {
+            const remaining = stdoutBuffer.trim();
+            if (remaining && !state.stopped)
+                handleJsonLine(remaining, root, state);
+            const matches = state.matches.slice(0, input.maxResults);
+            const truncated = state.truncated || state.matches.length > input.maxResults;
+            const output = {
+                query: input.query,
+                cwd: root,
+                grepPath: target,
+                returnedMatches: matches.length,
+                totalMatchesKnown: truncated ? null : matches.length,
+                truncated,
+                matches,
+                errors: state.errors.length ? state.errors : undefined,
+            };
+            if (code === 0 || code === 1 || truncated) {
+                resolve({ ok: true, output, summary: `${matches.length}${truncated ? "+" : ""} match(es)` });
+                return;
+            }
+            resolve({ ok: false, output: { ...output, error: stderr.trim() || `rg exited with code ${code}` } });
+        });
+    });
+}
+function buildArgs(input, target) {
+    const args = ["--json", "--color=never", "--line-number", "--column", "--with-filename", "--max-columns", String(input.maxColumns)];
+    if (input.caseMode === "smart")
+        args.push("--smart-case");
+    if (input.caseMode === "insensitive")
+        args.push("--ignore-case");
+    if (input.fixedStrings)
+        args.push("--fixed-strings");
+    if (input.includeHidden)
+        args.push("--hidden");
+    if (input.contextLines > 0)
+        args.push("--context", String(input.contextLines));
+    for (const glob of input.glob ?? [])
+        args.push("--glob", glob);
+    args.push("--", input.query, target);
+    return args;
+}
+function handleJsonLine(line, root, state) {
+    try {
+        const event = JSON.parse(line);
+        if (event.type === "match") {
+            if (state.matches.length >= state.maxResults) {
+                state.truncated = true;
+                state.overflowedMaxResults = true;
+                return;
+            }
+            const match = mapMatchEvent(event, root);
+            if (state.pendingContext.length) {
+                match.contextBefore = state.pendingContext.slice(-state.maxContextLines);
+                state.pendingContext = [];
+            }
+            state.matches.push(match);
+            if (state.matches.length >= state.maxResults)
+                state.truncated = true;
+            return;
+        }
+        if (event.type === "context" && state.maxContextLines > 0) {
+            const context = mapContextEvent(event, root);
+            const lastMatch = state.matches[state.matches.length - 1];
+            if (!lastMatch) {
+                state.pendingContext = [...state.pendingContext, context].slice(-state.maxContextLines);
+                return;
+            }
+            const contextAfter = [...(lastMatch.contextAfter ?? []), context].slice(0, state.maxContextLines);
+            lastMatch.contextAfter = contextAfter;
+        }
+    }
+    catch (error) {
+        state.errors.push(error instanceof Error ? error.message : String(error));
+    }
+}
+function mapMatchEvent(event, root) {
+    const text = normalizeLine(event.data.lines.text);
+    return {
+        file: relativeEventPath(root, event),
+        line: event.data.line_number,
+        column: event.data.submatches[0]?.start + 1,
+        text,
+        submatches: event.data.submatches.map((submatch) => ({
+            start: submatch.start,
+            end: submatch.end,
+            text: submatch.match.text,
+        })),
+    };
+}
+function mapContextEvent(event, root) {
+    return {
+        file: relativeEventPath(root, event),
+        line: event.data.line_number,
+        text: normalizeLine(event.data.lines.text),
+    };
+}
+function relativeEventPath(root, event) {
+    return path.relative(root, event.data.path.text) || event.data.path.text;
+}
+function normalizeLine(text) {
+    return text.replace(/[\r\n]+$/, "");
+}
+function shouldStopGrep(state) {
+    if (!state.truncated)
+        return false;
+    if (state.overflowedMaxResults)
+        return true;
+    if (state.maxContextLines === 0)
+        return true;
+    const lastMatch = state.matches[state.matches.length - 1];
+    return (lastMatch?.contextAfter?.length ?? 0) >= state.maxContextLines;
+}
+function shrinkGrepOutputForTransport(output, maxChars) {
+    if (!isGrepOutput(output))
+        return output;
+    const boundedOutput = boundLongGrepLines(output);
+    const serialized = JSON.stringify(boundedOutput);
+    if (serialized.length <= maxChars)
+        return boundedOutput;
+    const originalMatches = boundedOutput.matches;
+    const transportTruncation = {
+        reason: "resultSize",
+        originalLength: serialized.length,
+        matchesBeforeTransport: originalMatches.length,
+        omittedMatches: originalMatches.length,
+        maxChars,
+    };
+    const compacted = {
+        ...boundedOutput,
+        returnedMatches: 0,
+        matches: [],
+        truncated: true,
+        totalMatchesKnown: boundedOutput.truncated ? boundedOutput.totalMatchesKnown : originalMatches.length,
+        transportTruncation,
+    };
+    for (let count = originalMatches.length; count >= 0; count -= 1) {
+        compacted.matches = originalMatches.slice(0, count);
+        compacted.returnedMatches = compacted.matches.length;
+        compacted.transportTruncation = {
+            reason: transportTruncation.reason,
+            originalLength: transportTruncation.originalLength,
+            matchesBeforeTransport: transportTruncation.matchesBeforeTransport,
+            maxChars: transportTruncation.maxChars,
+            omittedMatches: originalMatches.length - count,
+        };
+        const candidate = JSON.stringify(compacted);
+        if (candidate.length <= maxChars)
+            return compacted;
+    }
+    return compacted;
+}
+function isGrepOutput(output) {
+    return typeof output === "object" && output !== null && Array.isArray(output.matches);
+}
+function boundLongGrepLines(output) {
+    return {
+        ...output,
+        matches: output.matches.map((match) => ({
+            ...match,
+            ...truncateTextField(match.text, MAX_MATCH_TEXT_CHARS),
+            submatches: match.submatches.map((submatch) => ({
+                ...submatch,
+                text: truncatePlainText(submatch.text, MAX_SUBMATCH_TEXT_CHARS),
+            })),
+            contextBefore: match.contextBefore?.map(truncateContextLine),
+            contextAfter: match.contextAfter?.map(truncateContextLine),
+        })),
+    };
+}
+function truncateContextLine(line) {
+    return {
+        ...line,
+        ...truncateTextField(line.text, MAX_CONTEXT_TEXT_CHARS),
+    };
+}
+function truncateTextField(text, maxChars) {
+    if (text.length <= maxChars)
+        return { text };
+    return {
+        text: `${text.slice(0, maxChars)}...[truncated ${text.length - maxChars} chars]`,
+        textTruncated: { originalLength: text.length, maxChars },
+    };
+}
+function truncatePlainText(text, maxChars) {
+    return text.length <= maxChars ? text : `${text.slice(0, maxChars)}...[truncated ${text.length - maxChars} chars]`;
+}
+const MAX_MATCH_TEXT_CHARS = 4000;
+const MAX_CONTEXT_TEXT_CHARS = 2000;
+const MAX_SUBMATCH_TEXT_CHARS = 500;
+//# sourceMappingURL=grep-tool.js.map

package/dist/tools/builtins/grep-tool.js.map

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

package/dist/tools/builtins/ripgrep-binary.d.ts

@@ -0,0 +1,6 @@
+export interface RipgrepBinaryResolution {
+    executablePath: string;
+    platformKey: string;
+}
+export declare function resolveBundledRipgrepBinary(env?: NodeJS.ProcessEnv): RipgrepBinaryResolution;
+export declare function ripgrepPlatformKey(): string;

package/dist/tools/builtins/ripgrep-binary.js

@@ -0,0 +1,51 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+export function resolveBundledRipgrepBinary(env = process.env) {
+    const platformKey = ripgrepPlatformKey();
+    const executable = process.platform === "win32" ? "rg.exe" : "rg";
+    const override = env.AGENT_RG_PATH;
+    if (override) {
+        const executablePath = path.resolve(override);
+        assertExecutableExists(executablePath, "AGENT_RG_PATH");
+        return { executablePath, platformKey };
+    }
+    for (const root of candidateRoots(env)) {
+        const executablePath = path.join(root, "vendor", "ripgrep", platformKey, executable);
+        if (fs.existsSync(executablePath))
+            return { executablePath, platformKey };
+    }
+    throw new Error(`Bundled ripgrep binary not found for ${platformKey}. Run npm run vendor:rg before using the grep tool.`);
+}
+export function ripgrepPlatformKey() {
+    const key = `${process.platform}-${process.arch}`;
+    switch (key) {
+        case "win32-x64":
+        case "win32-arm64":
+        case "linux-x64":
+        case "linux-arm64":
+        case "darwin-x64":
+        case "darwin-arm64":
+            return key;
+        default:
+            throw new Error(`Unsupported ripgrep platform: ${key}`);
+    }
+}
+function candidateRoots(env) {
+    const electronProcess = process;
+    const roots = [
+        env.AGENT_VENDOR_DIR,
+        process.cwd(),
+        path.resolve(moduleDir, "../../.."),
+        electronProcess.resourcesPath,
+        path.dirname(process.execPath),
+    ].filter((value) => Boolean(value));
+    return [...new Set(roots.map((root) => path.resolve(root)))];
+}
+function assertExecutableExists(executablePath, source) {
+    if (!fs.existsSync(executablePath)) {
+        throw new Error(`${source} points to a missing ripgrep binary: ${executablePath}`);
+    }
+}
+//# sourceMappingURL=ripgrep-binary.js.map

package/dist/tools/builtins/ripgrep-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripgrep-binary.js","sourceRoot":"","sources":["../../../src/tools/builtins/ripgrep-binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,2BAA2B,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9E,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC;IAEnC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,sBAAsB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;QACxD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QACrF,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,IAAI,KAAK,CACb,wCAAwC,WAAW,qDAAqD,CACzG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAClD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,cAAc;YACjB,OAAO,GAAG,CAAC;QACb;YACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAsB;IAC5C,MAAM,eAAe,GAAG,OAAsD,CAAC;IAC/E,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,gBAAgB;QACpB,OAAO,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC;QACnC,eAAe,CAAC,aAAa;QAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;KAC/B,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,sBAAsB,CAAC,cAAsB,EAAE,MAAc;IACpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,wCAAwC,cAAc,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

package/dist/tools/builtins/search-providers.d.ts

@@ -0,0 +1,49 @@
+export type SearchProviderName = "exa" | (string & {});
+export interface SearchToolInput {
+    query: string;
+    numResults: number;
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    startPublishedDate?: string;
+    endPublishedDate?: string;
+}
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    published?: string;
+    author?: string;
+    highlights?: string[];
+    text?: string;
+    score?: number;
+    raw?: Record<string, unknown>;
+}
+export interface SearchProviderResult {
+    provider: string;
+    query: string;
+    results: WebSearchResult[];
+    raw?: unknown;
+}
+export interface SearchProvider {
+    readonly name: SearchProviderName;
+    search(input: SearchToolInput, signal?: AbortSignal): Promise<SearchProviderResult>;
+}
+export interface SearchProviderConfig {
+    provider?: string;
+    exa?: ExaSearchProviderConfig;
+}
+export interface ExaSearchProviderConfig {
+    mcpUrl?: string;
+    toolName?: string;
+    timeoutMs?: number;
+}
+export declare const DEFAULT_SEARCH_PROVIDER = "exa";
+export declare const DEFAULT_EXA_MCP_URL = "https://mcp.exa.ai/mcp";
+export declare const DEFAULT_EXA_MCP_TOOL_NAME = "web_search_exa";
+export declare const DEFAULT_SEARCH_TIMEOUT_MS = 30000;
+export declare class SearchProviderError extends Error {
+    readonly provider: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, provider: string, cause?: unknown | undefined);
+}
+export declare function createSearchProvider(config?: SearchProviderConfig, env?: NodeJS.ProcessEnv): SearchProvider;
+export declare function createExaSearchProvider(config?: ExaSearchProviderConfig): SearchProvider;