winhelm-mcp 1.1.0

package/dist/engine/http-client.js

@@ -0,0 +1,93 @@
+/**
+ * Fast HTTP health check ping for local/remote servers
+ */
+export async function pingEndpoint(url, timeoutMs = 5000, expectedStatus) {
+    const start = Date.now();
+    try {
+        const res = await fetch(url, {
+            method: "GET",
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        const latencyMs = Date.now() - start;
+        const isExpected = expectedStatus ? res.status === expectedStatus : res.ok;
+        return {
+            ok: isExpected,
+            status: res.status,
+            statusText: res.statusText,
+            latencyMs,
+            url,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            status: 0,
+            statusText: err?.message || "Connection failed or timed out",
+            latencyMs: Date.now() - start,
+            url,
+        };
+    }
+}
+/**
+ * Execute HTTP request to test APIs, microservices, and web endpoints
+ */
+export async function executeHttpRequest(options) {
+    const { url, method = "GET", headers = {}, body, timeoutMs = 15000 } = options;
+    const start = Date.now();
+    const fetchOptions = {
+        method: method.toUpperCase(),
+        headers: { ...headers },
+        signal: AbortSignal.timeout(timeoutMs),
+    };
+    if (body && !["GET", "HEAD"].includes(method.toUpperCase())) {
+        fetchOptions.body = body;
+        if (!fetchOptions.headers || !fetchOptions.headers["Content-Type"]) {
+            // Auto-detect JSON
+            try {
+                JSON.parse(body);
+                fetchOptions.headers["Content-Type"] = "application/json";
+            }
+            catch {
+                fetchOptions.headers["Content-Type"] = "text/plain";
+            }
+        }
+    }
+    try {
+        const res = await fetch(url, fetchOptions);
+        const durationMs = Date.now() - start;
+        const resHeaders = {};
+        res.headers.forEach((v, k) => {
+            resHeaders[k] = v;
+        });
+        const text = await res.text();
+        let isJson = false;
+        let json = undefined;
+        try {
+            json = JSON.parse(text);
+            isJson = true;
+        }
+        catch {
+            // plain text
+        }
+        return {
+            status: res.status,
+            statusText: res.statusText,
+            durationMs,
+            headers: resHeaders,
+            body: text.length > 50000 ? text.slice(0, 50000) + "\n...[truncated]" : text,
+            isJson,
+            json,
+        };
+    }
+    catch (err) {
+        return {
+            status: 0,
+            statusText: err?.message || "HTTP request failed",
+            durationMs: Date.now() - start,
+            headers: {},
+            body: "",
+            isJson: false,
+        };
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/engine/http-client.js.map

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

package/dist/engine/pdf-generator.d.ts

@@ -0,0 +1,15 @@
+import type { PdfGenerateOptions, PdfGenerateResult } from "../types/index.js";
+/**
+ * Locate system Chromium browser (Edge or Chrome)
+ */
+export declare function findChromiumPath(): string | null;
+/**
+ * Lightweight, robust Markdown to HTML converter with print styling
+ */
+export declare function markdownToHtml(md: string, title?: string): string;
+export declare function sanitizeHref(url: string): string;
+/**
+ * Generate a PDF from a Markdown, HTML, or Text file using native Chromium headless
+ */
+export declare function generatePdf(options: PdfGenerateOptions): Promise<PdfGenerateResult>;
+//# sourceMappingURL=pdf-generator.d.ts.map

package/dist/engine/pdf-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-generator.d.ts","sourceRoot":"","sources":["../../src/engine/pdf-generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI/E;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAiBhD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,MAAM,CA2LrE;AAWD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBhD;AAaD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6EzF"}

package/dist/engine/pdf-generator.js

@@ -0,0 +1,325 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import { existsSync, statSync } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { promisify } from "node:util";
+import { ConfigManager } from "../config/config-manager.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Locate system Chromium browser (Edge or Chrome)
+ */
+export function findChromiumPath() {
+    const localAppData = process.env.LOCALAPPDATA || "";
+    const candidates = [
+        "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
+        "C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe",
+        "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+        "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+        path.join(localAppData, "Google\\Chrome\\Application\\chrome.exe"),
+        path.join(localAppData, "Microsoft\\Edge\\Application\\msedge.exe"),
+    ];
+    for (const p of candidates) {
+        if (existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+/**
+ * Lightweight, robust Markdown to HTML converter with print styling
+ */
+export function markdownToHtml(md, title = "Document") {
+    // Convert Markdown blocks
+    const lines = md.split(/\r?\n/);
+    const htmlParts = [];
+    let inCodeBlock = false;
+    let codeBlockLang = "";
+    let codeBuffer = [];
+    let inList = false;
+    let inTable = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Code blocks
+        if (line.trim().startsWith("```")) {
+            if (inCodeBlock) {
+                const safeLang = escapeHtml(codeBlockLang.replace(/[^\w\-]/g, ""));
+                htmlParts.push(`<pre class="code-block ${safeLang}"><code>${escapeHtml(codeBuffer.join("\n"))}</code></pre>`);
+                codeBuffer = [];
+                inCodeBlock = false;
+            }
+            else {
+                inCodeBlock = true;
+                codeBlockLang = line.trim().slice(3).trim();
+            }
+            continue;
+        }
+        if (inCodeBlock) {
+            codeBuffer.push(line);
+            continue;
+        }
+        // Tables
+        if (line.trim().startsWith("|") && line.trim().endsWith("|")) {
+            if (!inTable) {
+                inTable = true;
+                htmlParts.push("<table>");
+            }
+            // Check if delimiter row
+            if (/^\|[\s\-:|]+\|$/.test(line.trim())) {
+                continue;
+            }
+            const cells = line
+                .trim()
+                .slice(1, -1)
+                .split("|")
+                .map((c) => c.trim());
+            const isHeader = i > 0 && lines[i + 1] && /^\|[\s\-:|]+\|$/.test(lines[i + 1].trim());
+            const tag = isHeader ? "th" : "td";
+            htmlParts.push(`<tr>${cells.map((c) => `<${tag}>${formatInline(c)}</${tag}>`).join("")}</tr>`);
+            continue;
+        }
+        else if (inTable) {
+            inTable = false;
+            htmlParts.push("</table>");
+        }
+        // Lists
+        if (/^\s*[\*\-]\s+(.*)$/.test(line)) {
+            if (!inList) {
+                inList = true;
+                htmlParts.push("<ul>");
+            }
+            const itemText = line.replace(/^\s*[\*\-]\s+/, "");
+            htmlParts.push(`<li>${formatInline(itemText)}</li>`);
+            continue;
+        }
+        else if (inList) {
+            inList = false;
+            htmlParts.push("</ul>");
+        }
+        // Headings
+        if (/^######\s+(.*)$/.test(line)) {
+            htmlParts.push(`<h6>${formatInline(line.replace(/^######\s+/, ""))}</h6>`);
+        }
+        else if (/^#####\s+(.*)$/.test(line)) {
+            htmlParts.push(`<h5>${formatInline(line.replace(/^#####\s+/, ""))}</h5>`);
+        }
+        else if (/^####\s+(.*)$/.test(line)) {
+            htmlParts.push(`<h4>${formatInline(line.replace(/^####\s+/, ""))}</h4>`);
+        }
+        else if (/^###\s+(.*)$/.test(line)) {
+            htmlParts.push(`<h3>${formatInline(line.replace(/^###\s+/, ""))}</h3>`);
+        }
+        else if (/^##\s+(.*)$/.test(line)) {
+            htmlParts.push(`<h2>${formatInline(line.replace(/^##\s+/, ""))}</h2>`);
+        }
+        else if (/^#\s+(.*)$/.test(line)) {
+            htmlParts.push(`<h1>${formatInline(line.replace(/^#\s+/, ""))}</h1>`);
+        }
+        else if (/^>\s*(.*)$/.test(line)) {
+            htmlParts.push(`<blockquote>${formatInline(line.replace(/^>\s*/, ""))}</blockquote>`);
+        }
+        else if (/^---|\*\*\*|___$/.test(line.trim())) {
+            htmlParts.push("<hr />");
+        }
+        else if (line.trim().length > 0) {
+            htmlParts.push(`<p>${formatInline(line)}</p>`);
+        }
+    }
+    if (inList)
+        htmlParts.push("</ul>");
+    if (inTable)
+        htmlParts.push("</table>");
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>${escapeHtml(title)}</title>
+  <style>
+    @page {
+      margin: 15mm 20mm;
+      size: A4 portrait;
+    }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      font-size: 11pt;
+      line-height: 1.6;
+      color: #24292f;
+      background: #ffffff;
+      padding: 0;
+      margin: 0;
+    }
+    h1, h2, h3, h4, h5, h6 {
+      color: #1f2328;
+      margin-top: 1.4em;
+      margin-bottom: 0.6em;
+      font-weight: 600;
+      page-break-after: avoid;
+    }
+    h1 { font-size: 20pt; border-bottom: 1.5px solid #d0d7de; padding-bottom: 0.3em; }
+    h2 { font-size: 15pt; border-bottom: 1px solid #eaeef2; padding-bottom: 0.2em; }
+    h3 { font-size: 13pt; }
+    p, ul, ol { margin-top: 0; margin-bottom: 1em; }
+    ul { padding-left: 2em; }
+    li { margin-bottom: 0.25em; }
+    code {
+      font-family: "Cascadia Code", Consolas, "Courier New", monospace;
+      font-size: 9.5pt;
+      background-color: #f6f8fa;
+      padding: 0.2em 0.4em;
+      border-radius: 4px;
+      border: 1px solid #e1e4e8;
+    }
+    pre.code-block {
+      background-color: #f6f8fa;
+      border: 1px solid #d0d7de;
+      border-radius: 6px;
+      padding: 14px;
+      overflow-x: auto;
+      font-size: 9pt;
+      line-height: 1.45;
+      page-break-inside: avoid;
+    }
+    pre.code-block code {
+      background: none;
+      border: none;
+      padding: 0;
+    }
+    table {
+      border-collapse: collapse;
+      width: 100%;
+      margin: 1em 0;
+      font-size: 10pt;
+      page-break-inside: avoid;
+    }
+    th, td {
+      border: 1px solid #d0d7de;
+      padding: 8px 12px;
+      text-align: left;
+    }
+    th {
+      background-color: #f6f8fa;
+      font-weight: 600;
+    }
+    blockquote {
+      border-left: 4px solid #0969da;
+      margin: 1em 0;
+      padding: 0.5em 1em;
+      color: #57606a;
+      background-color: #f6f8fa;
+    }
+    hr {
+      border: 0;
+      height: 1px;
+      background: #d0d7de;
+      margin: 1.5em 0;
+    }
+  </style>
+</head>
+<body>
+  ${htmlParts.join("\n")}
+</body>
+</html>`;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#039;");
+}
+export function sanitizeHref(url) {
+    const clean = url.trim().replace(/[\u0000-\u001F\u007F-\u009F]/g, "");
+    const normalized = clean.replace(/&#x?[0-9a-f]+;?/gi, (match) => {
+        try {
+            if (match.startsWith("&#x") || match.startsWith("&#X")) {
+                return String.fromCharCode(parseInt(match.slice(3), 16));
+            }
+            else if (match.startsWith("&#")) {
+                return String.fromCharCode(parseInt(match.slice(2), 10));
+            }
+        }
+        catch { }
+        return match;
+    });
+    if (/^(?:javascript|vbscript|data)\s*:/i.test(normalized.trim())) {
+        return "#";
+    }
+    return clean;
+}
+function formatInline(str) {
+    return escapeHtml(str)
+        .replace(/\*\*(.*?)\*\*/g, "<strong>$1</strong>")
+        .replace(/\*(.*?)\*/g, "<em>$1</em>")
+        .replace(/~~(.*?)~~/g, "<del>$1</del>")
+        .replace(/`([^`]+)`/g, "<code>$1</code>")
+        .replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, text, href) => {
+        return `<a href="${sanitizeHref(href)}">${text}</a>`;
+    });
+}
+/**
+ * Generate a PDF from a Markdown, HTML, or Text file using native Chromium headless
+ */
+export async function generatePdf(options) {
+    const configManager = ConfigManager.getInstance();
+    if (configManager.isReadOnly()) {
+        throw new Error("Operation blocked: Server is running in read-only mode.");
+    }
+    const resolvedSource = path.resolve(options.sourcePath);
+    const resolvedPdf = path.resolve(options.pdfPath);
+    if (!existsSync(resolvedSource)) {
+        throw new Error(`Source file not found: ${options.sourcePath}`);
+    }
+    const dstCheck = configManager.isPathAllowed(resolvedPdf);
+    if (!dstCheck.allowed) {
+        throw new Error(dstCheck.reason);
+    }
+    const browserPath = findChromiumPath();
+    if (!browserPath) {
+        throw new Error("No Chromium-based browser (Microsoft Edge or Google Chrome) found on this Windows system.");
+    }
+    // Ensure output directory exists
+    await fs.mkdir(path.dirname(resolvedPdf), { recursive: true });
+    const ext = path.extname(resolvedSource).toLowerCase();
+    let htmlPath = resolvedSource;
+    let tempHtmlPath = null;
+    if (ext === ".md" || ext === ".markdown" || ext === ".txt") {
+        const rawContent = await fs.readFile(resolvedSource, "utf-8");
+        const docTitle = options.title || path.basename(resolvedSource, ext);
+        const htmlContent = markdownToHtml(rawContent, docTitle);
+        tempHtmlPath = path.join(os.tmpdir(), `wincommander_pdf_${Date.now()}_${Math.random().toString(36).slice(2)}.html`);
+        await fs.writeFile(tempHtmlPath, htmlContent, "utf-8");
+        htmlPath = tempHtmlPath;
+    }
+    const args = [
+        "--headless",
+        "--disable-gpu",
+        "--no-pdf-header-footer",
+        "--run-all-compositor-stages-before-draw",
+        `--print-to-pdf=${resolvedPdf}`,
+        htmlPath,
+    ];
+    try {
+        await execFileAsync(browserPath, args, {
+            timeout: 30000,
+            windowsHide: true,
+        });
+        if (!existsSync(resolvedPdf)) {
+            throw new Error(`PDF generation completed but target file was not created at ${resolvedPdf}`);
+        }
+        const stat = statSync(resolvedPdf);
+        return {
+            success: true,
+            pdfPath: resolvedPdf,
+            sourcePath: resolvedSource,
+            sizeBytes: stat.size,
+            browserUsed: path.basename(browserPath),
+        };
+    }
+    finally {
+        if (tempHtmlPath && existsSync(tempHtmlPath)) {
+            await fs.unlink(tempHtmlPath).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=pdf-generator.js.map

package/dist/engine/pdf-generator.js.map

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

package/dist/engine/powershell-runner.d.ts

@@ -0,0 +1,23 @@
+import type { ExecutionResult } from "../types/index.js";
+/**
+ * Check whether PowerShell 7+ (pwsh.exe) is installed on the host system.
+ * Cached in memory after the initial check to eliminate recurring spawn overhead.
+ */
+export declare function isPwshAvailable(): boolean;
+/**
+ * Reset or set pwsh availability cache (useful for testing and mocking)
+ */
+export declare function setPwshAvailableCache(val: boolean | null): void;
+/**
+ * Select preferred PowerShell executable: pwsh.exe if available and preferred, else powershell.exe
+ */
+export declare function getPowerShellExecutable(preferPwsh?: boolean): string;
+export interface PowerShellOptions {
+    cwd?: string;
+    timeoutMs?: number;
+}
+/**
+ * Execute a PowerShell command with UTF-8 encoding, security guard, and timeout protection
+ */
+export declare function runPowerShell(command: string, options?: PowerShellOptions): Promise<ExecutionResult>;
+//# sourceMappingURL=powershell-runner.d.ts.map

package/dist/engine/powershell-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powershell-runner.d.ts","sourceRoot":"","sources":["../../src/engine/powershell-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAezC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,UAAO,GAAG,MAAM,CAKjE;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAmH1B"}

package/dist/engine/powershell-runner.js

@@ -0,0 +1,148 @@
+import { spawn, spawnSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { ConfigManager } from "../config/config-manager.js";
+import { logger } from "../utils/logger.js";
+let cachedPwshAvailable = null;
+/**
+ * Check whether PowerShell 7+ (pwsh.exe) is installed on the host system.
+ * Cached in memory after the initial check to eliminate recurring spawn overhead.
+ */
+export function isPwshAvailable() {
+    if (cachedPwshAvailable !== null) {
+        return cachedPwshAvailable;
+    }
+    try {
+        const res = spawnSync("pwsh.exe", ["-NoProfile", "-Version"], {
+            windowsHide: true,
+            stdio: "ignore",
+            timeout: 2000,
+        });
+        cachedPwshAvailable = res.status === 0;
+    }
+    catch {
+        cachedPwshAvailable = false;
+    }
+    return cachedPwshAvailable;
+}
+/**
+ * Reset or set pwsh availability cache (useful for testing and mocking)
+ */
+export function setPwshAvailableCache(val) {
+    cachedPwshAvailable = val;
+}
+/**
+ * Select preferred PowerShell executable: pwsh.exe if available and preferred, else powershell.exe
+ */
+export function getPowerShellExecutable(preferPwsh = true) {
+    if (preferPwsh && isPwshAvailable()) {
+        return "pwsh.exe";
+    }
+    return "powershell.exe";
+}
+/**
+ * Execute a PowerShell command with UTF-8 encoding, security guard, and timeout protection
+ */
+export function runPowerShell(command, options = {}) {
+    const configManager = ConfigManager.getInstance();
+    const config = configManager.getConfig();
+    // 1. Security Check
+    const check = configManager.isCommandAllowed(command);
+    if (!check.allowed) {
+        const reason = check.reason || "Command blocked by security policy";
+        logger.security(reason, command);
+        return Promise.reject(new Error(reason));
+    }
+    // 2. Validate CWD against allowedDirectories
+    let cwd;
+    if (options.cwd) {
+        const cwdCheck = configManager.isPathAllowed(options.cwd);
+        if (!cwdCheck.allowed && config.allowSystemExecution === false) {
+            const reason = cwdCheck.reason || `Working directory "${options.cwd}" is not permitted`;
+            logger.security(reason, command);
+            return Promise.reject(new Error(reason));
+        }
+        cwd = options.cwd;
+    }
+    else {
+        const currentCwd = process.cwd();
+        const currentCheck = configManager.isPathAllowed(currentCwd);
+        if (currentCheck.allowed) {
+            cwd = currentCwd;
+        }
+        else {
+            const allowed = config.allowedDirectories;
+            if (allowed && allowed.length > 0) {
+                let first = allowed[0].trim();
+                if (/^[a-zA-Z]:?[\\/]?$/.test(first)) {
+                    first = first[0].toUpperCase() + ":\\";
+                }
+                cwd = path.resolve(first);
+            }
+            else {
+                cwd = currentCwd;
+            }
+        }
+    }
+    const timeoutMs = options.timeoutMs || config.defaultTimeoutMs || 60000;
+    const startTime = Date.now();
+    const executionId = randomUUID();
+    return new Promise((resolve, reject) => {
+        // UTF-8 setup preamble for Windows PowerShell to prevent garbled Unicode / Thai characters
+        const utf8Setup = "[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new(); " +
+            "[Console]::InputEncoding = [System.Text.UTF8Encoding]::new(); " +
+            "$OutputEncoding = [System.Text.UTF8Encoding]::new(); ";
+        const fullCommand = utf8Setup + command;
+        const preferPwsh = config.preferPwsh !== false;
+        const executable = getPowerShellExecutable(preferPwsh);
+        const child = spawn(executable, ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", fullCommand], {
+            cwd,
+            windowsHide: true,
+            env: { ...process.env, PYTHONIOENCODING: "utf-8" },
+        });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill("SIGKILL");
+            }
+            catch {
+                // Process might already be dead
+            }
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf-8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf-8");
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            const exitCode = code ?? (timedOut ? -1 : 0);
+            const durationMs = Date.now() - startTime;
+            // Log execution for auditing
+            configManager.logExecution({
+                id: executionId,
+                timestamp: new Date().toISOString(),
+                command,
+                cwd,
+                exitCode,
+                durationMs,
+                timedOut,
+            });
+            resolve({
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                exitCode,
+                timedOut,
+            });
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=powershell-runner.js.map

package/dist/engine/powershell-runner.js.map

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

package/dist/engine/ripgrep.d.ts

@@ -0,0 +1,20 @@
+import type { RipgrepSearchResult } from "../types/index.js";
+/**
+ * Locate ripgrep executable (rg.exe) with multi-path resolution
+ */
+export declare function findRipgrepPath(): string | null;
+export interface RipgrepOptions {
+    query: string;
+    searchPath?: string;
+    filePattern?: string;
+    caseSensitive?: boolean;
+    isRegex?: boolean;
+    page?: number;
+    pageSize?: number;
+    contextLines?: number;
+}
+/**
+ * Execute paginated high-speed codebase search using ripgrep with fallback
+ */
+export declare function searchCodebase(options: RipgrepOptions): Promise<RipgrepSearchResult>;
+//# sourceMappingURL=ripgrep.d.ts.map

package/dist/engine/ripgrep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripgrep.d.ts","sourceRoot":"","sources":["../../src/engine/ripgrep.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM3E;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAoC/C;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,CAAC,CA4I9B"}