agentxl 1.0.0 → 1.1.2

package/dist/server/folder-picker.js

@@ -0,0 +1,204 @@
+import { execFile } from "child_process";
+import { existsSync } from "fs";
+import { platform } from "os";
+import { dirname, extname, join } from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function getProjectRoot() {
+    return join(__dirname, "..", "..");
+}
+function getPickerTimeoutMs() {
+    const raw = process.env.AGENTXL_PICK_FOLDER_TIMEOUT_MS?.trim();
+    const parsed = raw ? Number(raw) : NaN;
+    if (Number.isFinite(parsed) && parsed > 0) {
+        return parsed;
+    }
+    // No timeout by default — let the user take as long as they need.
+    // The picker is a blocking dialog; it closes when the user picks or cancels.
+    return 0;
+}
+function toFriendlyPickerError(error) {
+    if (error instanceof Error) {
+        const execError = error;
+        const message = execError.message.toLowerCase();
+        if (execError.killed ||
+            execError.signal === "SIGTERM" ||
+            message.includes("timed out") ||
+            message.includes("timeout")) {
+            return new Error("Native folder picker timed out. Paste the folder path manually instead.");
+        }
+        return error;
+    }
+    return new Error("Failed to open native folder picker");
+}
+function execFileAsync(command, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        execFile(command, args, {
+            windowsHide: true,
+            // 0 means no timeout — let the user take as long as they need.
+            timeout: timeoutMs > 0 ? timeoutMs : 0,
+        }, (error, stdout) => {
+            if (error) {
+                reject(toFriendlyPickerError(error));
+                return;
+            }
+            resolve(stdout.toString());
+        });
+    });
+}
+function getFolderPickerHelperPath() {
+    const override = process.env.AGENTXL_FOLDER_PICKER_HELPER?.trim();
+    if (override) {
+        return override;
+    }
+    const projectRoot = getProjectRoot();
+    const candidates = [
+        join(projectRoot, "bin", "agentxl-folder-picker.exe"),
+        join(projectRoot, "tools", "folder-picker-win", "bin", "Release", "net8.0-windows", "win-x64", "publish", "agentxl-folder-picker.exe"),
+        join(projectRoot, "tools", "folder-picker-win", "bin", "Release", "net8.0-windows", "publish", "agentxl-folder-picker.exe"),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function buildHelperInvocation(helperPath, initialPath) {
+    const helperExt = extname(helperPath).toLowerCase();
+    const args = [];
+    if (initialPath && initialPath.trim().length > 0) {
+        args.push("--initial-path", initialPath.trim());
+    }
+    if ([".js", ".mjs", ".cjs"].includes(helperExt)) {
+        return {
+            command: process.execPath,
+            args: [helperPath, ...args],
+        };
+    }
+    return {
+        command: helperPath,
+        args,
+    };
+}
+function parseHelperResponse(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed) {
+        throw new Error("Folder picker helper returned no output");
+    }
+    const lines = trimmed
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const candidates = Array.from(new Set([lines.at(-1) ?? trimmed, trimmed]));
+    for (const candidate of candidates) {
+        try {
+            const parsed = JSON.parse(candidate);
+            if (parsed && typeof parsed.ok === "boolean") {
+                return parsed;
+            }
+        }
+        catch {
+            // Try next candidate.
+        }
+    }
+    throw new Error("Folder picker helper returned invalid JSON");
+}
+async function pickLocalFolderWithHelper(helperPath, timeoutMs, initialPath) {
+    const invocation = buildHelperInvocation(helperPath, initialPath);
+    const stdout = await execFileAsync(invocation.command, invocation.args, timeoutMs);
+    const response = parseHelperResponse(stdout);
+    if (!response.ok) {
+        throw new Error(response.error || "Folder picker helper failed");
+    }
+    if (response.cancelled) {
+        return null;
+    }
+    const folderPath = typeof response.folderPath === "string" ? response.folderPath.trim() : "";
+    return folderPath.length > 0 ? folderPath : null;
+}
+async function pickLocalFolderWithPowerShell(timeoutMs) {
+    const script = [
+        "Add-Type -AssemblyName System.Windows.Forms",
+        "[System.Windows.Forms.Application]::EnableVisualStyles()",
+        "$dialog = New-Object System.Windows.Forms.FolderBrowserDialog",
+        "$dialog.Description = 'Choose the folder with your supporting documents'",
+        "$dialog.ShowNewFolderButton = $false",
+        "$dialog.UseDescriptionForTitle = $true",
+        "$dialog.RootFolder = [System.Environment+SpecialFolder]::MyDocuments",
+        "if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $dialog.SelectedPath }",
+    ].join("; ");
+    const stdout = await execFileAsync("powershell", ["-NoProfile", "-STA", "-Command", script], timeoutMs);
+    const selected = stdout.trim();
+    return selected.length > 0 ? selected : null;
+}
+/** Detect which folder picker strategy will be used at runtime. */
+export function getFolderPickerStrategy() {
+    const currentPlatform = platform();
+    if (currentPlatform === "win32") {
+        const helperPath = getFolderPickerHelperPath();
+        if (helperPath) {
+            return { platform: "win32", method: "native-helper", helperPath };
+        }
+        return { platform: "win32", method: "powershell", helperPath: null };
+    }
+    if (currentPlatform === "darwin") {
+        return { platform: "darwin", method: "osascript", helperPath: null };
+    }
+    return { platform: currentPlatform, method: "manual-only", helperPath: null };
+}
+export async function pickLocalFolder(initialPath) {
+    const testDelayRaw = process.env.AGENTXL_PICK_FOLDER_TEST_DELAY_MS?.trim();
+    const testDelayMs = testDelayRaw ? Number(testDelayRaw) : NaN;
+    if (Number.isFinite(testDelayMs) && testDelayMs > 0) {
+        await sleep(testDelayMs);
+    }
+    const testError = process.env.AGENTXL_PICK_FOLDER_TEST_ERROR?.trim();
+    if (testError) {
+        throw new Error(testError);
+    }
+    const testPath = process.env.AGENTXL_PICK_FOLDER_TEST_PATH;
+    if (testPath && testPath.trim().length > 0) {
+        return testPath.trim();
+    }
+    const currentPlatform = platform();
+    const timeoutMs = getPickerTimeoutMs();
+    if (currentPlatform === "win32") {
+        const helperPath = getFolderPickerHelperPath();
+        if (helperPath) {
+            try {
+                return await pickLocalFolderWithHelper(helperPath, timeoutMs, initialPath);
+            }
+            catch (error) {
+                const helperError = error instanceof Error ? error.message : "Folder picker helper failed";
+                if (helperError.toLowerCase().includes("timed out")) {
+                    throw error instanceof Error ? error : new Error(helperError);
+                }
+                try {
+                    return await pickLocalFolderWithPowerShell(timeoutMs);
+                }
+                catch (fallbackError) {
+                    const fallbackMessage = fallbackError instanceof Error
+                        ? fallbackError.message
+                        : "PowerShell folder picker fallback failed";
+                    throw new Error(`${helperError}. PowerShell fallback also failed: ${fallbackMessage}`);
+                }
+            }
+        }
+        return pickLocalFolderWithPowerShell(timeoutMs);
+    }
+    if (currentPlatform === "darwin") {
+        const stdout = await execFileAsync("osascript", [
+            "-e",
+            'POSIX path of (choose folder with prompt "Choose the folder with your supporting documents")',
+        ], timeoutMs);
+        const selected = stdout.trim();
+        return selected.length > 0 ? selected.replace(/\/$/, "") : null;
+    }
+    throw new Error("Native folder picker is not supported on this platform yet");
+}
+//# sourceMappingURL=folder-picker.js.map

package/dist/server/folder-picker.js.map

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

package/dist/server/folder-scanner.d.ts

@@ -0,0 +1,43 @@
+export interface FileEntry {
+    /** File name with extension, e.g. "trial-balance.pdf" */
+    name: string;
+    /** Path relative to the linked folder root, e.g. "subfolder/trial-balance.pdf" */
+    relativePath: string;
+    /** Absolute path on disk */
+    absolutePath: string;
+    /** Lowercase extension including dot, e.g. ".pdf" */
+    extension: string;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** Last modified time as ISO string */
+    modifiedAt: string;
+    /** Whether this file type is supported for content extraction */
+    supported: boolean;
+}
+export interface FolderInventory {
+    /** The folder that was scanned */
+    folderPath: string;
+    /** When the scan was performed */
+    scannedAt: string;
+    /** Total number of files found */
+    totalFiles: number;
+    /** Number of supported files */
+    supportedFiles: number;
+    /** All discovered files */
+    files: FileEntry[];
+}
+/**
+ * Recursively scan a folder and build a file inventory.
+ *
+ * @param folderPath - Absolute path to the folder to scan
+ * @returns FolderInventory with all discovered files
+ * @throws Error if the folder does not exist or is not accessible
+ */
+export declare function scanFolder(folderPath: string): FolderInventory;
+/** Save a folder inventory to disk for a given workbook. */
+export declare function saveInventory(workbookId: string, inventory: FolderInventory): void;
+/** Load a previously saved folder inventory. Returns null if not found. */
+export declare function loadInventory(workbookId: string): FolderInventory | null;
+/** Scan a folder, save the inventory, and return it. */
+export declare function scanAndSaveInventory(workbookId: string, folderPath: string): FolderInventory;
+//# sourceMappingURL=folder-scanner.d.ts.map

package/dist/server/folder-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-scanner.d.ts","sourceRoot":"","sources":["../../src/server/folder-scanner.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAmED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAiF9D;AAUD,4DAA4D;AAC5D,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,eAAe,GACzB,IAAI,CAGN;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAMxE;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,eAAe,CAIjB"}

package/dist/server/folder-scanner.js

@@ -0,0 +1,161 @@
+import { readdirSync, statSync, existsSync } from "fs";
+import { join, extname, relative, basename } from "path";
+import { getAgentXLDataDir } from "./workbook-folder-store.js";
+import { writeJsonFileAtomic, readJsonFile } from "./json-store.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** File extensions that AgentXL can extract content from. */
+const SUPPORTED_EXTENSIONS = new Set([
+    ".pdf",
+    ".csv",
+    ".xlsx",
+    ".xls",
+    ".txt",
+    ".md",
+    ".json",
+    ".tsv",
+    ".docx",
+    ".doc",
+]);
+/** Directory names to always skip. */
+const IGNORED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".svn",
+    ".hg",
+    "__pycache__",
+    ".tox",
+    ".venv",
+    "venv",
+    ".env",
+    ".idea",
+    ".vscode",
+    "$RECYCLE.BIN",
+    "System Volume Information",
+    ".DS_Store",
+    "Thumbs.db",
+    ".agentxl-cache",
+]);
+/** Maximum directory depth to recurse into. */
+const MAX_DEPTH = 10;
+/** Maximum number of files to include in the inventory. */
+const MAX_FILES = 10_000;
+// ---------------------------------------------------------------------------
+// Scanner
+// ---------------------------------------------------------------------------
+function isHidden(name) {
+    return name.startsWith(".") && name !== "." && name !== "..";
+}
+function shouldSkipDir(name) {
+    return IGNORED_DIRS.has(name) || isHidden(name);
+}
+function isSupported(ext) {
+    return SUPPORTED_EXTENSIONS.has(ext.toLowerCase());
+}
+/**
+ * Recursively scan a folder and build a file inventory.
+ *
+ * @param folderPath - Absolute path to the folder to scan
+ * @returns FolderInventory with all discovered files
+ * @throws Error if the folder does not exist or is not accessible
+ */
+export function scanFolder(folderPath) {
+    const trimmed = folderPath.trim();
+    if (!trimmed) {
+        throw new Error("Folder path is required");
+    }
+    if (!existsSync(trimmed)) {
+        throw new Error(`Folder does not exist: ${trimmed}`);
+    }
+    const stat = statSync(trimmed);
+    if (!stat.isDirectory()) {
+        throw new Error(`Path is not a directory: ${trimmed}`);
+    }
+    const files = [];
+    function walk(dir, depth) {
+        if (depth > MAX_DEPTH)
+            return;
+        if (files.length >= MAX_FILES)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (files.length >= MAX_FILES)
+                return;
+            const fullPath = join(dir, entry);
+            let entryStat;
+            try {
+                entryStat = statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (entryStat.isDirectory()) {
+                if (!shouldSkipDir(entry)) {
+                    walk(fullPath, depth + 1);
+                }
+                continue;
+            }
+            if (!entryStat.isFile())
+                continue;
+            const ext = extname(entry).toLowerCase();
+            if (!ext && isHidden(entry))
+                continue;
+            files.push({
+                name: basename(entry),
+                relativePath: relative(trimmed, fullPath).replace(/\\/g, "/"),
+                absolutePath: fullPath,
+                extension: ext,
+                sizeBytes: entryStat.size,
+                modifiedAt: entryStat.mtime.toISOString(),
+                supported: isSupported(ext),
+            });
+        }
+    }
+    walk(trimmed, 0);
+    // Sort files: supported first, then alphabetically by relative path
+    files.sort((a, b) => {
+        if (a.supported !== b.supported)
+            return a.supported ? -1 : 1;
+        return a.relativePath.localeCompare(b.relativePath);
+    });
+    const supportedCount = files.filter((f) => f.supported).length;
+    return {
+        folderPath: trimmed,
+        scannedAt: new Date().toISOString(),
+        totalFiles: files.length,
+        supportedFiles: supportedCount,
+        files,
+    };
+}
+// ---------------------------------------------------------------------------
+// Persistence
+// ---------------------------------------------------------------------------
+function getInventoryPath(workbookId) {
+    return join(getAgentXLDataDir(), "inventories", `${workbookId}.json`);
+}
+/** Save a folder inventory to disk for a given workbook. */
+export function saveInventory(workbookId, inventory) {
+    const data = { version: 1, inventory };
+    writeJsonFileAtomic(getInventoryPath(workbookId), data);
+}
+/** Load a previously saved folder inventory. Returns null if not found. */
+export function loadInventory(workbookId) {
+    const parsed = readJsonFile(getInventoryPath(workbookId));
+    if (!parsed || parsed.version !== 1 || !parsed.inventory)
+        return null;
+    return parsed.inventory;
+}
+/** Scan a folder, save the inventory, and return it. */
+export function scanAndSaveInventory(workbookId, folderPath) {
+    const inventory = scanFolder(folderPath);
+    saveInventory(workbookId, inventory);
+    return inventory;
+}
+//# sourceMappingURL=folder-scanner.js.map

package/dist/server/folder-scanner.js.map

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

package/dist/server/http.d.ts

@@ -0,0 +1,19 @@
+/**
+ * HTTP helpers — JSON responses, error responses, body parsing.
+ *
+ * Shared across all route handlers. No domain logic here.
+ */
+import { IncomingMessage, ServerResponse } from "http";
+/** Send a JSON response with CORS headers. */
+export declare function sendJson(res: ServerResponse, status: number, body: Record<string, unknown>): void;
+/** Send a JSON error response. */
+export declare function sendError(res: ServerResponse, status: number, message: string): void;
+/** Read the full request body as a string. */
+export declare function readBody(req: IncomingMessage): Promise<string>;
+/** Parse JSON body, returning null on failure. */
+export declare function parseJsonBody(req: IncomingMessage): Promise<unknown | null>;
+/** Send CORS preflight response. */
+export declare function sendCorsPreflightResponse(res: ServerResponse): void;
+/** Send 405 Method Not Allowed for a known route. */
+export declare function sendMethodNotAllowed(res: ServerResponse, method: string, allowedMethod: string): void;
+//# sourceMappingURL=http.d.ts.map

package/dist/server/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAEvD,8CAA8C;AAC9C,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAUN;AAED,kCAAkC;AAClC,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9D;AAED,kDAAkD;AAClD,wBAAsB,aAAa,CACjC,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAOzB;AAED,oCAAoC;AACpC,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAQnE;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,IAAI,CAWN"}

package/dist/server/http.js

@@ -0,0 +1,62 @@
+/**
+ * HTTP helpers — JSON responses, error responses, body parsing.
+ *
+ * Shared across all route handlers. No domain logic here.
+ */
+/** Send a JSON response with CORS headers. */
+export function sendJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(status, {
+        "Content-Type": "application/json; charset=utf-8",
+        "Access-Control-Allow-Origin": "*",
+        "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+        "Access-Control-Allow-Headers": "Content-Type",
+        "Content-Length": Buffer.byteLength(payload),
+    });
+    res.end(payload);
+}
+/** Send a JSON error response. */
+export function sendError(res, status, message) {
+    sendJson(res, status, { error: message });
+}
+/** Read the full request body as a string. */
+export function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        req.on("error", reject);
+    });
+}
+/** Parse JSON body, returning null on failure. */
+export async function parseJsonBody(req) {
+    try {
+        const raw = await readBody(req);
+        return raw.length > 0 ? JSON.parse(raw) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Send CORS preflight response. */
+export function sendCorsPreflightResponse(res) {
+    res.writeHead(204, {
+        "Access-Control-Allow-Origin": "*",
+        "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+        "Access-Control-Allow-Headers": "Content-Type",
+        "Access-Control-Max-Age": "86400",
+    });
+    res.end();
+}
+/** Send 405 Method Not Allowed for a known route. */
+export function sendMethodNotAllowed(res, method, allowedMethod) {
+    res.writeHead(405, {
+        "Content-Type": "application/json; charset=utf-8",
+        "Access-Control-Allow-Origin": "*",
+        Allow: allowedMethod,
+    });
+    res.end(JSON.stringify({
+        error: `Method ${method} not allowed. Use ${allowedMethod}.`,
+    }));
+}
+//# sourceMappingURL=http.js.map

package/dist/server/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,8CAA8C;AAC9C,MAAM,UAAU,QAAQ,CACtB,GAAmB,EACnB,MAAc,EACd,IAA6B;IAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,iCAAiC;QACjD,6BAA6B,EAAE,GAAG;QAClC,8BAA8B,EAAE,oBAAoB;QACpD,8BAA8B,EAAE,cAAc;QAC9C,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;KAC7C,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACnB,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,SAAS,CACvB,GAAmB,EACnB,MAAc,EACd,OAAe;IAEf,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,QAAQ,CAAC,GAAoB;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,yBAAyB,CAAC,GAAmB;IAC3D,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,6BAA6B,EAAE,GAAG;QAClC,8BAA8B,EAAE,oBAAoB;QACpD,8BAA8B,EAAE,cAAc;QAC9C,wBAAwB,EAAE,OAAO;KAClC,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,EAAE,CAAC;AACZ,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,oBAAoB,CAClC,GAAmB,EACnB,MAAc,EACd,aAAqB;IAErB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,cAAc,EAAE,iCAAiC;QACjD,6BAA6B,EAAE,GAAG;QAClC,KAAK,EAAE,aAAa;KACrB,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CACL,IAAI,CAAC,SAAS,CAAC;QACb,KAAK,EAAE,UAAU,MAAM,qBAAqB,aAAa,GAAG;KAC7D,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/server/index.d.ts

@@ -1,3 +1,17 @@
+/**
+ * AgentXL HTTPS server — thin wiring layer.
+ *
+ * Responsibilities:
+ * - Server lifecycle (start, stop)
+ * - Route dispatch
+ * - Version resolution
+ *
+ * All handler logic lives in:
+ * - src/server/routes/agent.ts
+ * - src/server/routes/folder.ts
+ * - src/server/routes/workbook.ts
+ * - src/server/static.ts
+ */
 import { type CertPair } from "./certs.js";
 /** Enable or disable request logging. */
 export declare function setVerbose(enabled: boolean): void;
@@ -5,11 +19,9 @@ export declare function setVerbose(enabled: boolean): void;
  * Start the HTTPS server.
  *
  * @param port - Port to listen on (default: 3001)
- * @param certs - Optional pre-loaded certificates. If not provided, will call ensureCerts().
+ * @param certs - Optional pre-loaded certificates.
  */
 export declare function startServer(port?: number, certs?: CertPair): Promise<void>;
-/**
- * Stop the HTTPS server gracefully.
- */
+/** Stop the HTTPS server gracefully. */
 export declare function stopServer(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsYxD,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,GAAE,MAAa,EACnB,KAAK,CAAC,EAAE,QAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAWhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiKxD,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,GAAE,MAAa,EACnB,KAAK,CAAC,EAAE,QAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED,wCAAwC;AACxC,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAWhD"}