@travisennis/acai 0.0.7 → 0.0.9

package/dist/tui/terminal.js

@@ -1,36 +1,120 @@
+import fs from "node:fs";
+import tty from "node:tty";
 /**
  * Real terminal using process.stdin/stdout
+ *
+ * When useTty is true (for piped stdin scenarios), input is read from /dev/tty
+ * instead of process.stdin, allowing interactive input after piped content.
  */
 export class ProcessTerminal {
     wasRaw = false;
     sigintHandler;
-    inputHandler;
-    resizeHandler;
+    boundInputListener;
+    boundResizeListener;
     stopped = false;
+    inExternalMode = false;
+    resumeCallback;
+    inputStream;
+    ttyFd;
+    useTty;
+    constructor(options = {}) {
+        this.useTty = options.useTty ?? false;
+        this.inputStream = process.stdin;
+    }
+    handleSigCont = () => {
+        if (this.inExternalMode) {
+            this.exitExternalMode();
+        }
+    };
     start(onInput, onResize) {
-        this.inputHandler = onInput;
-        this.resizeHandler = onResize;
-        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        if (this.useTty) {
+            try {
+                this.ttyFd = fs.openSync("/dev/tty", "r");
+                this.inputStream = new tty.ReadStream(this.ttyFd);
+            }
+            catch {
+                throw new Error("Cannot open /dev/tty for interactive input");
+            }
+        }
+        else {
+            this.inputStream = process.stdin;
+        }
+        if (!this.inputStream.isTTY || !process.stdout.isTTY) {
             throw new Error("Terminal requires TTY environment");
         }
-        // Save previous state and enable raw mode
-        this.wasRaw = process.stdin.isRaw ?? false;
-        if (process.stdin.setRawMode) {
-            process.stdin.setRawMode(true);
+        this.wasRaw = this.inputStream.isRaw ?? false;
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(true);
         }
-        process.stdin.setEncoding("utf8");
-        process.stdin.resume();
+        this.inputStream.setEncoding("utf8");
+        this.inputStream.resume();
         // Enable bracketed paste mode - terminal will wrap pastes in \x1b[200~ ... \x1b[201~
         process.stdout.write("\x1b[?2004h");
-        // Set up event handlers with proper binding and type conversion
-        process.stdin.on("data", (data) => {
-            this.inputHandler?.(typeof data === "string" ? data : data.toString("utf8"));
+        // Create bound listeners so we can properly remove them later
+        this.boundInputListener = (data) => {
+            onInput(typeof data === "string" ? data : data.toString("utf8"));
+        };
+        this.boundResizeListener = () => {
+            onResize();
+        };
+        this.attachListeners();
+        this.sigintHandler = () => {
+            // Let the custom editor.onCtrlC handler in NewRepl handle Ctrl+C
+            // This prevents a race condition where stop() gets called without the exit message
+        };
+        process.on("SIGINT", this.sigintHandler);
+        process.on("SIGCONT", this.handleSigCont);
+        process.on("SIGTERM", () => this.stop());
+        process.on("SIGHUP", () => this.stop());
+        this.setupCrashCleanup();
+    }
+    attachListeners() {
+        if (this.boundInputListener) {
+            this.inputStream.on("data", this.boundInputListener);
+        }
+        if (this.boundResizeListener) {
+            process.stdout.on("resize", this.boundResizeListener);
+        }
+    }
+    detachListeners() {
+        if (this.boundInputListener) {
+            this.inputStream.removeListener("data", this.boundInputListener);
+        }
+        if (this.boundResizeListener) {
+            process.stdout.removeListener("resize", this.boundResizeListener);
+        }
+    }
+    setupCrashCleanup() {
+        process.on("exit", () => {
+            process.stdout.write("\x1b[?25h");
+            process.stdout.write("\x1b[?2004l");
+            process.stdout.write("\x1b[0m");
+            if (this.inputStream.setRawMode) {
+                this.inputStream.setRawMode(this.wasRaw);
+            }
+            this.closeTtyFd();
         });
-        process.stdout.on("resize", () => {
-            this.resizeHandler?.();
+        process.on("uncaughtException", (error) => {
+            process.stdout.write("\x1b[?25h");
+            process.stdout.write("\x1b[?2004l");
+            process.stdout.write("\x1b[0m");
+            if (this.inputStream.setRawMode) {
+                this.inputStream.setRawMode(this.wasRaw);
+            }
+            this.closeTtyFd();
+            throw error;
         });
-        this.sigintHandler = () => this.stop();
-        process.on("SIGINT", this.sigintHandler);
+    }
+    closeTtyFd() {
+        if (this.ttyFd !== undefined) {
+            try {
+                fs.closeSync(this.ttyFd);
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.ttyFd = undefined;
+        }
     }
     stop() {
         if (this.stopped)
@@ -38,23 +122,25 @@ export class ProcessTerminal {
         this.stopped = true;
         if (this.sigintHandler) {
             process.off("SIGINT", this.sigintHandler);
+            this.sigintHandler = undefined;
         }
         // Disable bracketed paste mode
         process.stdout.write("\x1b[?2004l");
-        // Remove event handlers
-        if (this.inputHandler) {
-            process.stdin.removeListener("data", this.inputHandler);
-            this.inputHandler = undefined;
+        // Remove event handlers using the exact references that were added
+        if (this.boundInputListener) {
+            this.inputStream.removeListener("data", this.boundInputListener);
+            this.boundInputListener = undefined;
         }
-        if (this.resizeHandler) {
-            process.stdout.removeListener("resize", this.resizeHandler);
-            this.resizeHandler = undefined;
+        if (this.boundResizeListener) {
+            process.stdout.removeListener("resize", this.boundResizeListener);
+            this.boundResizeListener = undefined;
         }
-        process.stdin.pause();
+        this.inputStream.pause();
         // Restore raw mode state
-        if (process.stdin.setRawMode) {
-            process.stdin.setRawMode(this.wasRaw);
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(this.wasRaw);
         }
+        this.closeTtyFd();
     }
     write(data) {
         process.stdout.write(data);
@@ -91,4 +177,43 @@ export class ProcessTerminal {
     clearScreen() {
         process.stdout.write("\x1b[2J\x1b[H"); // Clear screen and move to home (1,1)
     }
+    enterExternalMode() {
+        if (this.inExternalMode || this.stopped)
+            return;
+        this.inExternalMode = true;
+        this.detachListeners();
+        this.inputStream.pause();
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(false);
+        }
+        process.stdout.write("\x1b[0m");
+        process.stdout.write("\x1b[?25h");
+        process.stdout.write("\x1b[?2004l");
+    }
+    exitExternalMode() {
+        if (!this.inExternalMode || this.stopped)
+            return;
+        this.inExternalMode = false;
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(true);
+        }
+        this.inputStream.setEncoding("utf8");
+        this.inputStream.resume();
+        process.stdout.write("\x1b[?2004h");
+        process.stdout.write("\x1b[?25l");
+        this.attachListeners();
+        if (this.resumeCallback) {
+            this.resumeCallback();
+        }
+    }
+    background() {
+        this.enterExternalMode();
+        process.kill(process.pid, "SIGSTOP");
+    }
+    isInExternalMode() {
+        return this.inExternalMode;
+    }
+    onResume(callback) {
+        this.resumeCallback = callback;
+    }
 }

package/dist/tui/tui.d.ts

@@ -46,11 +46,13 @@ export declare class TUI extends Container {
     private isRendering;
     private renderAgain;
     private activeModal;
+    onCtrlC?: () => void;
     constructor(terminal: Terminal);
     setFocus(component: Component | null): void;
     start(): void;
     stop(): void;
     requestRender(): void;
+    private inBracketedPaste;
     private handleInput;
     private doRender;
     /**

package/dist/tui/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../source/tui/tui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC/C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,qBAAa,SAAU,YAAW,SAAS;IACzC,QAAQ,EAAE,SAAS,EAAE,CAAM;IAE3B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAOvC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAOhC;AAED;;GAEG;AAGH,qBAAa,GAAI,SAAQ,SAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAsB;gBAE7B,QAAQ,EAAE,QAAQ;IAK9B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAI3C,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAKZ,aAAa,IAAI,IAAI;IAarB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,QAAQ;IAgGhB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK7B;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../source/tui/tui.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC/C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,qBAAa,SAAU,YAAW,SAAS;IACzC,QAAQ,EAAE,SAAS,EAAE,CAAM;IAE3B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAOvC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAGhC;AAED;;GAEG;AAGH,qBAAa,GAAI,SAAQ,SAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAsB;IAElC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;gBAEhB,QAAQ,EAAE,QAAQ;IAK9B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAI3C,KAAK,IAAI,IAAI;IAUb,IAAI,IAAI,IAAI;IAKZ,aAAa,IAAI,IAAI;IAarB,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,WAAW;IA6CnB,OAAO,CAAC,QAAQ;IA0FhB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK7B;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}

package/dist/tui/tui.js

@@ -1,7 +1,7 @@
 /**
  * Minimal TUI implementation with differential rendering
  */
-import { getTerminalSize } from "../terminal/formatting.js";
+import { getTerminalSize, isCtrlC, isCtrlZ, isEscape, } from "../terminal/control.js";
 import style from "../terminal/style.js";
 import { visibleWidth } from "./utils.js";
 export { visibleWidth };
@@ -23,11 +23,7 @@ export class Container {
         this.children = [];
     }
     render(width) {
-        const lines = [];
-        for (const child of this.children) {
-            lines.push(...child.render(width));
-        }
-        return lines;
+        return this.children.flatMap((child) => child.render(width));
     }
 }
 /**
@@ -41,6 +37,7 @@ export class TUI extends Container {
     isRendering = false;
     renderAgain = false;
     activeModal = null;
+    onCtrlC;
     constructor(terminal) {
         super();
         this.terminal = terminal;
@@ -50,6 +47,7 @@ export class TUI extends Container {
     }
     start() {
         this.terminal.start((data) => this.handleInput(data), () => this.requestRender());
+        this.terminal.onResume(() => this.requestRender());
         this.terminal.hideCursor();
         this.requestRender();
     }
@@ -70,15 +68,34 @@ export class TUI extends Container {
             this.doRender();
         });
     }
+    inBracketedPaste = false;
     handleInput(data) {
+        if (data.includes("\x1b[200~")) {
+            this.inBracketedPaste = true;
+        }
+        if (data.includes("\x1b[201~")) {
+            this.inBracketedPaste = false;
+        }
+        // Handle Ctrl+Z - background the process (POSIX only)
+        if (isCtrlZ(data) &&
+            !this.inBracketedPaste &&
+            process.platform !== "win32") {
+            this.terminal.background();
+            return;
+        }
         // Handle Ctrl+C globally - exit the application
-        if (data.charCodeAt(0) === 3) {
+        if (isCtrlC(data)) {
             console.info("\nCtrl+C pressed - exiting...");
-            this.stop();
-            process.exit(0);
+            if (this.onCtrlC) {
+                this.onCtrlC();
+            }
+            else {
+                this.stop();
+                process.exit(0);
+            }
         }
         // Handle Escape key to close modal if one is active
-        if (data === "\x1b" && this.activeModal) {
+        if (isEscape(data) && this.activeModal) {
             this.hideModal();
             return;
         }
@@ -102,39 +119,32 @@ export class TUI extends Container {
             const width = this.terminal.columns;
             // Render all components to get new lines
             const newLines = this.render(width);
-            // Always do full re-render for simplicity and reliability
-            // This ensures that previous content is properly cleared
-            let buffer = "\x1b[?2026h"; // Begin synchronized output
-            buffer += "\x1b[3J\x1b[2J\x1b[H"; // Clear scrollback, screen, and home
-            for (let i = 0; i < newLines.length; i++) {
-                if (i > 0)
-                    buffer += "\r\n";
-                buffer += newLines[i];
-            }
+            // Build output buffer using array join (more efficient than string concat)
+            const bufferParts = [
+                "\x1b[?2026h", // Begin synchronized output
+                "\x1b[3J\x1b[2J\x1b[H", // Clear scrollback, screen, and home
+                newLines.join("\r\n"),
+            ];
             // Render modal on top if active
             if (this.activeModal) {
                 const modalLines = this.activeModal.render(width);
                 // Render backdrop first if modal has backdrop
                 if (this.activeModal.backdrop) {
                     const backdropLine = style.bgRgb(0, 0, 0)(" ".repeat(width));
-                    const { columns } = getTerminalSize(); // 24
-                    for (let i = 0; i < columns; i++) {
-                        // Cover entire terminal
-                        buffer += `\x1b[${i + 1};1H`;
-                        buffer += backdropLine;
+                    const { rows } = getTerminalSize();
+                    for (let i = 0; i < rows; i++) {
+                        bufferParts.push(`\x1b[${i + 1};1H`, backdropLine);
                     }
                 }
                 // Render modal content
                 for (let i = 0; i < modalLines.length; i++) {
                     if (modalLines[i]) {
-                        // Position cursor and overwrite existing content
-                        buffer += `\x1b[${i + 1};1H`;
-                        buffer += modalLines[i];
+                        bufferParts.push(`\x1b[${i + 1};1H`, modalLines[i]);
                     }
                 }
             }
-            buffer += "\x1b[?2026l"; // End synchronized output
-            this.terminal.write(buffer);
+            bufferParts.push("\x1b[?2026l"); // End synchronized output
+            this.terminal.write(bufferParts.join(""));
         }
         finally {
             this.isRendering = false;

package/dist/tui/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../source/tui/utils.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AA4BD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAQ,GACf,MAAM,CA+DR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC7B,MAAM,CASR"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../source/tui/utils.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AA4BD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAQ,GACf,MAAM,CA+DR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC7B,MAAM,CASR"}

package/dist/tui/utils.js

@@ -1,6 +1,5 @@
+import { getSegmenter } from "../terminal/segmenter.js";
 import stringWidth from "../terminal/string-width.js";
-// Grapheme segmenter for proper Unicode iteration (handles emojis, etc.)
-const segmenter = new Intl.Segmenter();
 /**
  * Calculate the visible width of a string in terminal columns.
  * This correctly handles:
@@ -67,7 +66,7 @@ export function truncateToWidth(text, maxWidth, ellipsis = "...") {
             }
             // Segment this non-ANSI portion into graphemes
             const textPortion = text.slice(i, end);
-            for (const seg of segmenter.segment(textPortion)) {
+            for (const seg of getSegmenter().segment(textPortion)) {
                 segments.push({ type: "grapheme", value: seg.segment });
             }
             i = end;

package/dist/utils/filesystem/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../source/utils/filesystem/security.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAsCrD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3E;AAoCD,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAIT;AAGD,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE,EACnC,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CAAO,GACtE,OAAO,CAAC,MAAM,CAAC,CA6HjB;AA8BD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../source/utils/filesystem/security.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAsCrD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3E;AAoCD,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAIT;AAGD,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE,EACnC,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CAAO,GACtE,OAAO,CAAC,MAAM,CAAC,CAiIjB;AA8BD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN"}

package/dist/utils/filesystem/security.js

@@ -116,8 +116,11 @@ export async function validatePath(requestedPath, allowedDirectory, options = {}
             return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
         });
     };
+    // Resolve symlinks in ancestors of the requested path for accurate comparison
+    // This handles cases like /tmp -> /private/tmp on macOS
+    const resolvedRequested = resolveExistingAncestorSync(normalizedRequested);
     // Check intended path is within any allowed directory
-    if (!isWithinAllowed(normalizedRequested)) {
+    if (!isWithinAllowed(resolvedRequested)) {
         throw new Error(`Access denied - path outside allowed directories: ${absolute} not in any of ${allowedDirectories.join(", ")}`);
     }
     let validatedPath;

package/dist/utils/yaml.d.ts

@@ -0,0 +1,11 @@
+type YamlValue = string | number | boolean | null | YamlObject | YamlValue[];
+type YamlObject = {
+    [key: string]: YamlValue;
+};
+export declare function parseYaml(input: string): YamlObject;
+export declare function parseFrontMatter(markdown: string): {
+    data: YamlObject;
+    content: string;
+};
+export {};
+//# sourceMappingURL=yaml.d.ts.map

package/dist/utils/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../source/utils/yaml.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AAC7E,KAAK,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CA0DnD;AA2JD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAClD,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAwBA"}

package/dist/utils/yaml.js

@@ -0,0 +1,207 @@
+export function parseYaml(input) {
+    const lines = input.split("\n");
+    const result = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith("#")) {
+            i++;
+            continue;
+        }
+        // Check for key-value pair
+        const colonIndex = line.indexOf(":");
+        if (colonIndex === -1) {
+            i++;
+            continue;
+        }
+        const indent = getIndent(line);
+        const key = line.slice(0, colonIndex).trim();
+        const afterColon = line.slice(colonIndex + 1).trim();
+        if (afterColon) {
+            // Inline value
+            result[key] = parseValue(afterColon);
+            i++;
+        }
+        else {
+            // Check next line for nested content
+            i++;
+            if (i < lines.length) {
+                const nextLine = lines[i];
+                const nextIndent = getIndent(nextLine);
+                const nextTrimmed = nextLine.trim();
+                if (nextTrimmed.startsWith("-")) {
+                    // Array
+                    const [arr, newIndex] = parseArray(lines, i, nextIndent);
+                    result[key] = arr;
+                    i = newIndex;
+                }
+                else if (nextIndent > indent && nextTrimmed.includes(":")) {
+                    // Nested object
+                    const [obj, newIndex] = parseObject(lines, i, nextIndent);
+                    result[key] = obj;
+                    i = newIndex;
+                }
+                else {
+                    result[key] = null;
+                }
+            }
+            else {
+                result[key] = null;
+            }
+        }
+    }
+    return result;
+}
+function parseObject(lines, start, baseIndent) {
+    const obj = {};
+    let i = start;
+    while (i < lines.length) {
+        const line = lines[i];
+        const indent = getIndent(line);
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            i++;
+            continue;
+        }
+        if (indent < baseIndent) {
+            break;
+        }
+        if (indent === baseIndent) {
+            const colonIndex = line.indexOf(":");
+            if (colonIndex === -1) {
+                i++;
+                continue;
+            }
+            const key = line.slice(0, colonIndex).trim();
+            const afterColon = line.slice(colonIndex + 1).trim();
+            if (afterColon) {
+                obj[key] = parseValue(afterColon);
+                i++;
+            }
+            else {
+                i++;
+                if (i < lines.length) {
+                    const nextLine = lines[i];
+                    const nextIndent = getIndent(nextLine);
+                    const nextTrimmed = nextLine.trim();
+                    if (nextTrimmed.startsWith("-")) {
+                        const [arr, newIndex] = parseArray(lines, i, nextIndent);
+                        obj[key] = arr;
+                        i = newIndex;
+                    }
+                    else if (nextIndent > indent && nextTrimmed.includes(":")) {
+                        const [nested, newIndex] = parseObject(lines, i, nextIndent);
+                        obj[key] = nested;
+                        i = newIndex;
+                    }
+                    else {
+                        obj[key] = null;
+                    }
+                }
+                else {
+                    obj[key] = null;
+                }
+            }
+        }
+        else {
+            i++;
+        }
+    }
+    return [obj, i];
+}
+function parseArray(lines, start, baseIndent) {
+    const arr = [];
+    let i = start;
+    while (i < lines.length) {
+        const line = lines[i];
+        const indent = getIndent(line);
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            i++;
+            continue;
+        }
+        if (indent < baseIndent) {
+            break;
+        }
+        if (indent === baseIndent && trimmed.startsWith("-")) {
+            const afterDash = trimmed.slice(1).trim();
+            if (afterDash) {
+                // Inline array item
+                arr.push(parseValue(afterDash));
+                i++;
+            }
+            else {
+                // Check next line for nested content
+                i++;
+                if (i < lines.length) {
+                    const nextLine = lines[i];
+                    const nextIndent = getIndent(nextLine);
+                    const nextTrimmed = nextLine.trim();
+                    if (nextTrimmed.includes(":")) {
+                        const [obj, newIndex] = parseObject(lines, i, nextIndent);
+                        arr.push(obj);
+                        i = newIndex;
+                    }
+                    else {
+                        i++;
+                    }
+                }
+            }
+        }
+        else {
+            i++;
+        }
+    }
+    return [arr, i];
+}
+function parseValue(value) {
+    // Handle quoted strings
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    // Handle booleans
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    // Handle null
+    if (value === "null" || value === "~")
+        return null;
+    // Handle numbers
+    if (/^-?\d+$/.test(value)) {
+        return Number.parseInt(value, 10);
+    }
+    if (/^-?\d+\.\d+$/.test(value)) {
+        return Number.parseFloat(value);
+    }
+    // Default to string
+    return value;
+}
+function getIndent(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? match[1].length : 0;
+}
+// Helper function to extract and parse Yaml front matter from markdown
+export function parseFrontMatter(markdown) {
+    const lines = markdown.split("\n");
+    if (lines[0] !== "---") {
+        return { data: {}, content: markdown };
+    }
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i] === "---" || lines[i] === "...") {
+            endIndex = i;
+            break;
+        }
+    }
+    if (endIndex === -1) {
+        return { data: {}, content: markdown };
+    }
+    const yamlContent = lines.slice(1, endIndex).join("\n");
+    const data = parseYaml(yamlContent);
+    const content = lines.slice(endIndex + 1).join("\n");
+    return { data, content };
+}

package/dist/utils/zod.d.ts

@@ -1,4 +1,5 @@
 import { ZodType } from "zod";
 export declare function isZodSchema(obj: unknown): obj is ZodType<unknown>;
 export declare function zodToJsonSchema(schema: ZodType<unknown>): Record<string, unknown>;
+export declare const convertNullString: (value: unknown) => unknown;
 //# sourceMappingURL=zod.d.ts.map

package/dist/utils/zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../source/utils/zod.ts"],"names":[],"mappings":"AAAA,OAAU,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEjC,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAEjE;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../source/utils/zod.ts"],"names":[],"mappings":"AAAA,OAAU,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEjC,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAEjE;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAID,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,OAgBlD,CAAC"}

package/dist/utils/zod.js

@@ -5,3 +5,20 @@ export function isZodSchema(obj) {
 export function zodToJsonSchema(schema) {
     return z.toJSONSchema(schema);
 }
+// Many models do not reliably pass null to optional tool fields. Instead they pass "null", "None", "undefined", or empty strings.
+// This function will coerce all of those values into null.
+export const convertNullString = (value) => {
+    if (typeof value === "undefined") {
+        return null;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed.toLowerCase() === "null" ||
+            trimmed.toLowerCase() === "none" ||
+            trimmed.toLowerCase() === "undefined" ||
+            trimmed === "") {
+            return null;
+        }
+    }
+    return value;
+};