llm-agent-cli 2.0.0

package/dist/tools/network.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import type { ToolExecutionContext } from "./types.js";
+export declare const FetchUrlSchema: z.ZodObject<{
+    url: z.ZodString;
+    max_bytes: z.ZodDefault<z.ZodNumber>;
+    timeout_ms: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    max_bytes: number;
+    timeout_ms: number;
+}, {
+    url: string;
+    max_bytes?: number | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export declare function fetch_url(args: z.infer<typeof FetchUrlSchema>, context: ToolExecutionContext): Promise<string>;
+//# sourceMappingURL=network.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/tools/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,cAAc;;;;;;;;;;;;EAgBzB,CAAC;AA+DH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,EACpC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA4DjB"}

package/dist/tools/network.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+export const FetchUrlSchema = z.object({
+    url: z.string().url().describe("HTTP or HTTPS URL to fetch"),
+    max_bytes: z
+        .number()
+        .int()
+        .positive()
+        .max(1_000_000)
+        .default(250_000)
+        .describe("Maximum response bytes to read"),
+    timeout_ms: z
+        .number()
+        .int()
+        .positive()
+        .max(30_000)
+        .default(10_000)
+        .describe("Request timeout in milliseconds"),
+});
+function stripHtmlTags(html) {
+    return html
+        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "")
+        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, "")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+async function readTextWithLimit(response, maxBytes, signal) {
+    if (!response.body) {
+        const fullText = await response.text();
+        if (fullText.length <= maxBytes) {
+            return { text: fullText, truncated: false };
+        }
+        return { text: fullText.slice(0, maxBytes), truncated: true };
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let bytesRead = 0;
+    let text = "";
+    let truncated = false;
+    try {
+        while (true) {
+            if (signal?.aborted) {
+                throw new Error("Fetch aborted by user");
+            }
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (!value)
+                continue;
+            bytesRead += value.byteLength;
+            if (bytesRead > maxBytes) {
+                const overflow = bytesRead - maxBytes;
+                const keepBytes = value.byteLength - overflow;
+                if (keepBytes > 0) {
+                    text += decoder.decode(value.slice(0, keepBytes), { stream: true });
+                }
+                truncated = true;
+                await reader.cancel();
+                break;
+            }
+            text += decoder.decode(value, { stream: true });
+        }
+        text += decoder.decode();
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return { text, truncated };
+}
+export async function fetch_url(args, context) {
+    const parsed = FetchUrlSchema.parse(args);
+    const url = new URL(parsed.url);
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        return "Error fetching URL: only http and https protocols are supported";
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), parsed.timeout_ms);
+    if (context.abortSignal) {
+        context.abortSignal.addEventListener("abort", () => controller.abort(), {
+            once: true,
+        });
+    }
+    try {
+        const response = await fetch(parsed.url, {
+            method: "GET",
+            signal: controller.signal,
+            headers: {
+                "User-Agent": "llm-router-cli-agent/1.0",
+                Accept: "text/plain, text/markdown, text/html;q=0.9, */*;q=0.1",
+            },
+        });
+        if (!response.ok) {
+            return `Error fetching URL: HTTP ${response.status} ${response.statusText}`;
+        }
+        const contentType = response.headers.get("content-type") ?? "unknown";
+        const { text, truncated } = await readTextWithLimit(response, parsed.max_bytes, context.abortSignal);
+        const normalized = contentType.includes("text/html")
+            ? stripHtmlTags(text)
+            : text;
+        const note = truncated
+            ? `\n\n[Content truncated to ${parsed.max_bytes} bytes]`
+            : "";
+        return [
+            `URL: ${parsed.url}`,
+            `Content-Type: ${contentType}`,
+            "",
+            normalized,
+            note,
+        ]
+            .join("\n")
+            .trimEnd();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return `Error fetching URL: ${msg}`;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+//# sourceMappingURL=network.js.map

package/dist/tools/network.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const SearchFilesSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    directory: z.ZodOptional<z.ZodString>;
+    case_sensitive: z.ZodDefault<z.ZodBoolean>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    case_sensitive: boolean;
+    max_results: number;
+    directory?: string | undefined;
+}, {
+    pattern: string;
+    directory?: string | undefined;
+    case_sensitive?: boolean | undefined;
+    max_results?: number | undefined;
+}>;
+export declare const FindFilesSchema: z.ZodObject<{
+    glob_pattern: z.ZodString;
+    directory: z.ZodOptional<z.ZodString>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    max_results: number;
+    glob_pattern: string;
+    directory?: string | undefined;
+}, {
+    glob_pattern: string;
+    directory?: string | undefined;
+    max_results?: number | undefined;
+}>;
+export declare function find_files(args: z.infer<typeof FindFilesSchema>): Promise<string>;
+export declare function search_files(args: z.infer<typeof SearchFilesSchema>): Promise<string>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAiB5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAgB1B,CAAC;AA+JH,wBAAsB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA2CvF;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAkFjB"}

package/dist/tools/search.js

@@ -0,0 +1,263 @@
+import fs from "fs/promises";
+import path from "path";
+import { spawn } from "child_process";
+import { z } from "zod";
+import { isPathIgnored, resolveProtectedPath } from "./security.js";
+export const SearchFilesSchema = z.object({
+    pattern: z.string().min(1).describe("Regex or plain text pattern to search for"),
+    directory: z
+        .string()
+        .optional()
+        .describe("Directory to search in (default: current directory)"),
+    case_sensitive: z
+        .boolean()
+        .default(false)
+        .describe("Whether the search should be case sensitive"),
+    max_results: z
+        .number()
+        .int()
+        .positive()
+        .max(2000)
+        .default(200)
+        .describe("Maximum number of matches to return"),
+});
+export const FindFilesSchema = z.object({
+    glob_pattern: z
+        .string()
+        .min(1)
+        .describe("Glob to match file paths, for example: **/*.ts"),
+    directory: z
+        .string()
+        .optional()
+        .describe("Directory to search in (default: current directory)"),
+    max_results: z
+        .number()
+        .int()
+        .positive()
+        .max(5000)
+        .default(500)
+        .describe("Maximum number of file paths to return"),
+});
+function globToRegex(globPattern) {
+    let out = "";
+    for (let i = 0; i < globPattern.length; i += 1) {
+        const char = globPattern[i];
+        const next = globPattern[i + 1];
+        if (char === "*" && next === "*") {
+            out += ".*";
+            i += 1;
+            continue;
+        }
+        if (char === "*") {
+            out += "[^/]*";
+            continue;
+        }
+        if (char === "?") {
+            out += "[^/]";
+            continue;
+        }
+        if (/[.+^${}()|[\]\\]/.test(char)) {
+            out += `\\${char}`;
+            continue;
+        }
+        out += char;
+    }
+    return new RegExp(`^${out}$`);
+}
+async function walkFiles(rootDir, maxResults) {
+    const results = [];
+    const stack = [rootDir];
+    while (stack.length > 0 && results.length < maxResults) {
+        const current = stack.pop();
+        if (!current)
+            break;
+        let entries;
+        try {
+            entries = await fs.readdir(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (results.length >= maxResults)
+                break;
+            const absPath = path.join(current, entry.name);
+            if (await isPathIgnored(absPath)) {
+                continue;
+            }
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                stack.push(absPath);
+                continue;
+            }
+            if (entry.isFile()) {
+                results.push(absPath);
+            }
+        }
+    }
+    return results;
+}
+async function runRipgrep(pattern, absDirectory, caseSensitive, maxResults) {
+    return new Promise((resolve) => {
+        const args = [
+            "--line-number",
+            "--no-heading",
+            "--color",
+            "never",
+            "--hidden",
+        ];
+        if (!caseSensitive) {
+            args.push("--ignore-case");
+        }
+        args.push("--", pattern, absDirectory);
+        const child = spawn("rg", args, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let buffer = "";
+        const lines = [];
+        let noMatches = false;
+        child.stdout.on("data", (chunk) => {
+            buffer += chunk.toString("utf-8");
+            let newlineIndex = buffer.indexOf("\n");
+            while (newlineIndex !== -1) {
+                const line = buffer.slice(0, newlineIndex).trim();
+                buffer = buffer.slice(newlineIndex + 1);
+                if (line) {
+                    lines.push(line);
+                }
+                if (lines.length >= maxResults) {
+                    child.kill();
+                    break;
+                }
+                newlineIndex = buffer.indexOf("\n");
+            }
+        });
+        child.on("error", () => {
+            resolve({ lines: [], usedRipgrep: false, noMatches: false });
+        });
+        child.on("close", (code) => {
+            if (code === 1)
+                noMatches = true;
+            resolve({ lines, usedRipgrep: true, noMatches });
+        });
+    });
+}
+function splitSearchLine(rawLine) {
+    const firstColon = rawLine.indexOf(":");
+    if (firstColon === -1)
+        return null;
+    const secondColon = rawLine.indexOf(":", firstColon + 1);
+    if (secondColon === -1)
+        return null;
+    return {
+        filePath: rawLine.slice(0, firstColon),
+        lineNumber: rawLine.slice(firstColon + 1, secondColon),
+        lineContent: rawLine.slice(secondColon + 1),
+    };
+}
+export async function find_files(args) {
+    const parsed = FindFilesSchema.parse(args);
+    const directoryArg = parsed.directory ?? ".";
+    try {
+        const absDirectory = await resolveProtectedPath(directoryArg);
+        const regex = globToRegex(parsed.glob_pattern);
+        const allFiles = await walkFiles(absDirectory, parsed.max_results * 5);
+        const matches = [];
+        const shouldMatchBasename = !parsed.glob_pattern.includes("/");
+        for (const absPath of allFiles) {
+            if (matches.length >= parsed.max_results)
+                break;
+            const rel = path
+                .relative(absDirectory, absPath)
+                .split(path.sep)
+                .join("/");
+            const basename = path.posix.basename(rel);
+            const matched = regex.test(rel) ||
+                (shouldMatchBasename && regex.test(basename));
+            if (matched) {
+                matches.push(absPath);
+            }
+        }
+        if (matches.length === 0) {
+            return "No files matched the provided glob pattern.";
+        }
+        const suffix = matches.length >= parsed.max_results
+            ? `\n[Truncated to ${parsed.max_results} matches]`
+            : "";
+        return `${matches.join("\n")}${suffix}`;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return `Error finding files: ${msg}`;
+    }
+}
+export async function search_files(args) {
+    const parsed = SearchFilesSchema.parse(args);
+    const directoryArg = parsed.directory ?? ".";
+    try {
+        const absDirectory = await resolveProtectedPath(directoryArg);
+        const rgResult = await runRipgrep(parsed.pattern, absDirectory, parsed.case_sensitive, parsed.max_results);
+        let formatted = [];
+        if (rgResult.usedRipgrep) {
+            if (rgResult.noMatches || rgResult.lines.length === 0) {
+                return "No matches found.";
+            }
+            for (const line of rgResult.lines) {
+                const parts = splitSearchLine(line);
+                if (!parts)
+                    continue;
+                const absFilePath = path.isAbsolute(parts.filePath)
+                    ? parts.filePath
+                    : path.resolve(absDirectory, parts.filePath);
+                if (await isPathIgnored(absFilePath)) {
+                    continue;
+                }
+                formatted.push(`${absFilePath}:${parts.lineNumber}:${parts.lineContent}`);
+                if (formatted.length >= parsed.max_results)
+                    break;
+            }
+        }
+        else {
+            const files = await walkFiles(absDirectory, 5_000);
+            const needle = parsed.case_sensitive
+                ? parsed.pattern
+                : parsed.pattern.toLowerCase();
+            for (const filePath of files) {
+                if (formatted.length >= parsed.max_results)
+                    break;
+                let content;
+                try {
+                    content = await fs.readFile(filePath, "utf-8");
+                }
+                catch {
+                    continue;
+                }
+                const lines = content.split(/\r?\n/);
+                for (let i = 0; i < lines.length; i += 1) {
+                    const line = lines[i] ?? "";
+                    const haystack = parsed.case_sensitive ? line : line.toLowerCase();
+                    if (haystack.includes(needle)) {
+                        formatted.push(`${filePath}:${i + 1}:${line}`);
+                    }
+                    if (formatted.length >= parsed.max_results)
+                        break;
+                }
+            }
+            if (formatted.length === 0) {
+                return "No matches found.";
+            }
+        }
+        const wasTruncated = formatted.length >= parsed.max_results;
+        const suffix = wasTruncated
+            ? `\n[Truncated to ${parsed.max_results} matches]`
+            : "";
+        return `${formatted.join("\n")}${suffix}`;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return `Error searching files: ${msg}`;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/security.d.ts

@@ -0,0 +1,18 @@
+export type PermissionMode = "safe" | "standard" | "yolo";
+export interface ToolRuntimeConfig {
+    workspaceRoot: string;
+    permissionMode: PermissionMode;
+    maxReadBytes: number;
+    maxToolResultChars: number;
+    maxCommandOutputChars: number;
+    shellTimeoutMs: number;
+}
+export declare function resolveProtectedPath(inputPath: string): Promise<string>;
+export declare function getRuntimeConfig(): ToolRuntimeConfig;
+export declare function setRuntimeConfig(nextConfig: Partial<ToolRuntimeConfig>): void;
+export declare function initializeRuntimeFromEnv(): void;
+export declare function getBlockedCommandReason(command: string): string | null;
+export declare function enforceWritePolicy(actionDescription: string): Promise<void>;
+export declare function enforceCommandPolicy(command: string): Promise<void>;
+export declare function isPathIgnored(absPath: string): Promise<boolean>;
+//# sourceMappingURL=security.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/tools/security.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AA6JD,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB7E;AAED,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAsB7E;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAwB/C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOtE;AAqBD,wBAAsB,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAazE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE"}