@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/utils/resolveTextSearchTarget.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs';
+import path from 'path';
+import { isNodeError } from './errors.js';
+import { validatePathWithinWorkspace } from './pathValidation.js';
+export function resolveTextSearchTarget(targetDir, workspaceRoots, relativePath) {
+    if (!relativePath) {
+        return { kind: 'all-workspaces' };
+    }
+    const targetPath = path.resolve(targetDir, relativePath);
+    const pathError = validatePathWithinWorkspace(workspaceRoots, targetPath, 'Path');
+    if (pathError) {
+        throw new Error('Path validation failed: ' + pathError);
+    }
+    let stats;
+    try {
+        stats = fs.statSync(targetPath);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            throw new Error(`Path does not exist: ${targetPath}`);
+        }
+        if (isNodeError(error) && error.code === 'EACCES') {
+            throw new Error(`Permission denied: ${targetPath}`);
+        }
+        throw new Error(`Failed to access path stats for ${targetPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (stats.isDirectory()) {
+        return { kind: 'directory', searchDir: targetPath };
+    }
+    if (stats.isFile()) {
+        return {
+            kind: 'file',
+            filePath: targetPath,
+            parentDir: path.dirname(targetPath),
+            basename: path.basename(targetPath),
+        };
+    }
+    throw new Error(`Path is neither a file nor a directory: ${targetPath}`);
+}
+//# sourceMappingURL=resolveTextSearchTarget.js.map

package/dist/src/utils/resolveTextSearchTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTextSearchTarget.js","sourceRoot":"","sources":["../../../src/utils/resolveTextSearchTarget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAYlE,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,cAAiC,EACjC,YAAqB;IAErB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,2BAA2B,CAC3C,cAAc,EACd,UAAU,EACV,MAAM,CACP,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,mCAAmC,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3G,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACnB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2CAA2C,UAAU,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/src/utils/retry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface RetryOptions {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    shouldRetryOnError: (error: Error, retryFetchErrors?: boolean) => boolean;
+    retryFetchErrors?: boolean;
+    signal?: AbortSignal;
+}
+export declare function isNetworkTransientError(error: unknown): boolean;
+export declare function getErrorStatus(error: unknown): number | undefined;
+export declare function isRetryableError(error: Error | unknown, retryFetchErrors?: boolean): boolean;
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;

package/dist/src/utils/retry.js

@@ -0,0 +1,185 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const DEFAULT_RETRY_OPTIONS = {
+    maxAttempts: 5,
+    initialDelayMs: 5000,
+    maxDelayMs: 30000,
+    shouldRetryOnError: isRetryableError,
+};
+const TRANSIENT_ERROR_PHRASES = [
+    'connection error',
+    'connection terminated',
+    'terminated',
+    'connection reset',
+    'socket hang up',
+    'socket hung up',
+    'socket closed',
+    'socket timeout',
+    'network timeout',
+    'network error',
+    'request aborted',
+    'request timeout',
+    'stream closed',
+    'stream prematurely closed',
+    'read econnreset',
+    'write econnreset',
+];
+const TRANSIENT_ERROR_REGEXES = [
+    /econn(reset|refused|aborted)/i,
+    /etimedout/i,
+    /und_err_(socket|connect|headers_timeout|body_timeout)/i,
+    /tcp connection.*(reset|closed)/i,
+];
+const TRANSIENT_ERROR_CODES = new Set([
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ECONNABORTED',
+    'ENETUNREACH',
+    'EHOSTUNREACH',
+    'ENOTFOUND',
+    'ETIMEDOUT',
+    'EPIPE',
+    'EAI_AGAIN',
+    'UND_ERR_SOCKET',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'UND_ERR_HEADERS_TIMEOUT',
+    'UND_ERR_BODY_TIMEOUT',
+]);
+function createAbortError() {
+    const error = new Error('The operation was aborted');
+    error.name = 'AbortError';
+    return error;
+}
+async function delay(ms, signal) {
+    if (signal?.aborted === true) {
+        throw createAbortError();
+    }
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(resolve, ms);
+        const onAbort = () => {
+            clearTimeout(timeout);
+            reject(createAbortError());
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function collectErrorDetails(error) {
+    const messages = [];
+    const codes = [];
+    const stack = [error];
+    const visited = new Set();
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (current === null || current === undefined) {
+            continue;
+        }
+        if (typeof current === 'string') {
+            messages.push(current);
+            continue;
+        }
+        if (typeof current !== 'object' || visited.has(current)) {
+            continue;
+        }
+        visited.add(current);
+        const errorObject = current;
+        if (typeof errorObject.message === 'string') {
+            messages.push(errorObject.message);
+        }
+        if (typeof errorObject.code === 'string') {
+            codes.push(errorObject.code);
+        }
+        for (const nested of [
+            errorObject.cause,
+            errorObject.originalError,
+            errorObject.error,
+        ]) {
+            if (nested !== undefined && nested !== null && nested !== current) {
+                stack.push(nested);
+            }
+        }
+    }
+    return { messages, codes };
+}
+export function isNetworkTransientError(error) {
+    const { messages, codes } = collectErrorDetails(error);
+    const lowerMessages = messages.map((msg) => msg.toLowerCase());
+    if (lowerMessages.some((msg) => TRANSIENT_ERROR_PHRASES.some((phrase) => msg.includes(phrase)))) {
+        return true;
+    }
+    if (messages.some((msg) => TRANSIENT_ERROR_REGEXES.some((regex) => regex.test(msg)))) {
+        return true;
+    }
+    return codes
+        .map((code) => code.toUpperCase())
+        .some((code) => TRANSIENT_ERROR_CODES.has(code));
+}
+export function getErrorStatus(error) {
+    if (typeof error === 'object' && error !== null) {
+        if ('status' in error && typeof error.status === 'number') {
+            return error.status;
+        }
+        if ('response' in error &&
+            typeof error.response === 'object' &&
+            error.response !== null) {
+            const response = error.response;
+            if (typeof response.status === 'number') {
+                return response.status;
+            }
+        }
+    }
+    return undefined;
+}
+export function isRetryableError(error, retryFetchErrors) {
+    if (isNetworkTransientError(error)) {
+        return true;
+    }
+    if (retryFetchErrors === true) {
+        const { messages } = collectErrorDetails(error);
+        if (messages.some((msg) => msg.toLowerCase().includes('fetch failed'))) {
+            return true;
+        }
+    }
+    const status = getErrorStatus(error);
+    return (status === 401 ||
+        status === 403 ||
+        status === 429 ||
+        (status !== undefined && status >= 500 && status < 600));
+}
+export async function retryWithBackoff(fn, options) {
+    if (options?.signal?.aborted === true) {
+        throw createAbortError();
+    }
+    const { maxAttempts, initialDelayMs, maxDelayMs, shouldRetryOnError, retryFetchErrors, signal, } = {
+        ...DEFAULT_RETRY_OPTIONS,
+        ...options,
+    };
+    let currentDelay = initialDelayMs;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        if (signal?.aborted === true) {
+            throw createAbortError();
+        }
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw error;
+            }
+            if (attempt >= maxAttempts ||
+                !shouldRetryOnError(error, retryFetchErrors)) {
+                throw error;
+            }
+            await delay(currentDelay, signal);
+            currentDelay = Math.min(maxDelayMs, currentDelay * 2);
+        }
+    }
+    throw lastError instanceof Error
+        ? lastError
+        : new Error('Retry attempts exhausted');
+}
+//# sourceMappingURL=retry.js.map

package/dist/src/utils/retry.js.map

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

package/dist/src/utils/ripgrepPathResolver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Check if ripgrep is available on the system.
+ * This is a non-throwing wrapper around getRipgrepPath that returns a boolean.
+ * Results are cached for performance.
+ *
+ * @returns true if ripgrep is available, false otherwise
+ */
+export declare function isRipgrepAvailable(): Promise<boolean>;
+/**
+ * Clear the ripgrep availability cache.
+ * Useful for testing or when configuration changes.
+ */
+export declare function clearRipgrepAvailabilityCache(): void;
+export declare function getRipgrepPath(): Promise<string>;
+/**
+ * Create Windows-specific symlink or copy if needed
+ */
+export declare function ensureWindowsShortcut(source: string, target: string): boolean;

package/dist/src/utils/ripgrepPathResolver.js

@@ -0,0 +1,179 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { debugLogger } from './debugLogger.js';
+/**
+ * Cross-platform ripgrep path resolution
+ * Implements the robust solution described in issue 483
+ */
+let ripgrepAvailabilityCache = null;
+/**
+ * Check if ripgrep is available on the system.
+ * This is a non-throwing wrapper around getRipgrepPath that returns a boolean.
+ * Results are cached for performance.
+ *
+ * @returns true if ripgrep is available, false otherwise
+ */
+export async function isRipgrepAvailable() {
+    if (ripgrepAvailabilityCache !== null) {
+        return ripgrepAvailabilityCache;
+    }
+    try {
+        await getRipgrepPath();
+        ripgrepAvailabilityCache = true;
+        return true;
+    }
+    catch {
+        ripgrepAvailabilityCache = false;
+        return false;
+    }
+}
+/**
+ * Clear the ripgrep availability cache.
+ * Useful for testing or when configuration changes.
+ */
+export function clearRipgrepAvailabilityCache() {
+    ripgrepAvailabilityCache = null;
+}
+async function tryPackagedRipgrep() {
+    try {
+        const { rgPath } = await import('@lvce-editor/ripgrep');
+        if (fs.existsSync(rgPath)) {
+            return rgPath;
+        }
+    }
+    catch {
+        // Package not available or binary doesn't exist
+    }
+    return null;
+}
+async function trySystemRipgrep(isWindows) {
+    try {
+        const { execSync } = await import('child_process');
+        const checkCmd = isWindows ? 'where rg' : 'which rg';
+        const systemPath = execSync(checkCmd, { encoding: 'utf8' }).trim();
+        if (fs.existsSync(systemPath)) {
+            return systemPath;
+        }
+    }
+    catch {
+        // System ripgrep not found
+    }
+    return null;
+}
+function findFirstExistingPath(paths) {
+    for (const p of paths) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+}
+function tryWindowsPaths() {
+    const envPaths = [
+        path.join(
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: env var fallback for path
+        process.env.PROGRAMFILES || 'C:\\Program Files', 'ripgrep', 'rg.exe'),
+        path.join(
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: env var fallback for path
+        process.env['PROGRAMFILES(X86)'] || 'C:\\Program Files (x86)', 'ripgrep', 'rg.exe'),
+    ];
+    const result = findFirstExistingPath(envPaths);
+    if (result)
+        return result;
+    const commonPaths = [
+        'C:\\Program Files\\ripgrep\\rg.exe',
+        'C:\\Program Files (x86)\\ripgrep\\rg.exe',
+        'C:\\tools\\ripgrep\\rg.exe',
+    ];
+    return findFirstExistingPath(commonPaths);
+}
+function tryUnixPaths() {
+    const unixPaths = [
+        '/usr/local/bin/rg',
+        '/usr/bin/rg',
+        '/opt/homebrew/bin/rg',
+        '/home/linuxbrew/.linuxbrew/bin/rg',
+    ];
+    return findFirstExistingPath(unixPaths);
+}
+function tryBundledPath(isWindows) {
+    const projectRoot = process.cwd();
+    const pkgEntrypoint = process.pkg?.entrypoint;
+    const nodeModulesExists = fs.existsSync(path.join(projectRoot, 'node_modules'));
+    const isBundled = 
+    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: string property may be empty, check node_modules as fallback
+    Boolean(pkgEntrypoint || !nodeModulesExists);
+    if (isBundled) {
+        const bundleDir = path.join(projectRoot, 'bundle');
+        const bundledRgPath = path.join(bundleDir, isWindows ? 'rg.exe' : 'rg');
+        if (fs.existsSync(bundledRgPath)) {
+            return bundledRgPath;
+        }
+    }
+    return null;
+}
+export async function getRipgrepPath() {
+    const isWindows = os.platform() === 'win32';
+    const packaged = await tryPackagedRipgrep();
+    if (packaged)
+        return packaged;
+    const system = await trySystemRipgrep(isWindows);
+    if (system)
+        return system;
+    if (isWindows) {
+        const windowsResult = tryWindowsPaths();
+        if (windowsResult)
+            return windowsResult;
+    }
+    else {
+        const unixResult = tryUnixPaths();
+        if (unixResult)
+            return unixResult;
+    }
+    const bundled = tryBundledPath(isWindows);
+    if (bundled)
+        return bundled;
+    throw new Error(`ripgrep not found. Please install @lvce-editor/ripgrep or system ripgrep.\n` +
+        `Installation options:\n` +
+        `- npm install @lvce-editor/ripgrep\n` +
+        `- brew install ripgrep (macOS)\n` +
+        `- choco install ripgrep (Windows)\n` +
+        `- apt install ripgrep (Ubuntu/Debian)`);
+}
+/**
+ * Create Windows-specific symlink or copy if needed
+ */
+export function ensureWindowsShortcut(source, target) {
+    if (os.platform() !== 'win32') {
+        return false;
+    }
+    try {
+        // On Windows, try creating a hard link first
+        if (fs.existsSync(source) && !fs.existsSync(target)) {
+            // Create target directory if it doesn't exist
+            const targetDir = path.dirname(target);
+            if (!fs.existsSync(targetDir)) {
+                fs.mkdirSync(targetDir, { recursive: true });
+            }
+            try {
+                fs.linkSync(source, target);
+                return true;
+            }
+            catch {
+                // Hard link failed (common on Windows without admin); copy instead.
+                fs.copyFileSync(source, target);
+                return true;
+            }
+        }
+    }
+    catch (error) {
+        debugLogger.warn('Failed to create Windows shortcut for ripgrep:', error);
+    }
+    return false;
+}
+//# sourceMappingURL=ripgrepPathResolver.js.map

package/dist/src/utils/ripgrepPathResolver.js.map

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

package/dist/src/utils/safeJsonStringify.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely stringifies an object to JSON, replacing circular references.
+ */
+export declare function safeJsonStringify(obj: unknown, space?: string | number): string;

package/dist/src/utils/safeJsonStringify.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely stringifies an object to JSON, replacing circular references.
+ */
+export function safeJsonStringify(obj, space) {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (_key, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        return value;
+    }, space);
+}
+//# sourceMappingURL=safeJsonStringify.js.map

package/dist/src/utils/safeJsonStringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJsonStringify.js","sourceRoot":"","sources":["../../../src/utils/safeJsonStringify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAY,EACZ,KAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,OAAO,IAAI,CAAC,SAAS,CACnB,GAAG,EACH,CAAC,IAAI,EAAE,KAAc,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO,YAAY,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EACD,KAAK,CACN,CAAC;AACJ,CAAC"}

package/dist/src/utils/schemaValidator.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P11
+ * @requirement:REQ-PKG-BOUNDARY
+ */
+/**
+ * Package-local SchemaValidator utility for tool parameter validation.
+ * Zero core imports — uses ajv directly.
+ */
+export declare class SchemaValidator {
+    static validate(schema: unknown | undefined, data: unknown): string | null;
+    private static formatPath;
+    private static formatErrors;
+}