@anthropic-field/core 0.1.0

package/dist/src/utils/terminalSerializer.js

@@ -0,0 +1,444 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Attribute;
+(function (Attribute) {
+    Attribute[Attribute["inverse"] = 1] = "inverse";
+    Attribute[Attribute["bold"] = 2] = "bold";
+    Attribute[Attribute["italic"] = 4] = "italic";
+    Attribute[Attribute["underline"] = 8] = "underline";
+    Attribute[Attribute["dim"] = 16] = "dim";
+})(Attribute || (Attribute = {}));
+export var ColorMode;
+(function (ColorMode) {
+    ColorMode[ColorMode["DEFAULT"] = 0] = "DEFAULT";
+    ColorMode[ColorMode["PALETTE"] = 1] = "PALETTE";
+    ColorMode[ColorMode["RGB"] = 2] = "RGB";
+})(ColorMode || (ColorMode = {}));
+class Cell {
+    cell = null;
+    x = 0;
+    y = 0;
+    cursorX = 0;
+    cursorY = 0;
+    attributes = 0;
+    fg = 0;
+    bg = 0;
+    fgColorMode = ColorMode.DEFAULT;
+    bgColorMode = ColorMode.DEFAULT;
+    constructor(cell, x, y, cursorX, cursorY) {
+        this.update(cell, x, y, cursorX, cursorY);
+    }
+    update(cell, x, y, cursorX, cursorY) {
+        this.cell = cell;
+        this.x = x;
+        this.y = y;
+        this.cursorX = cursorX;
+        this.cursorY = cursorY;
+        this.attributes = 0;
+        if (!cell) {
+            return;
+        }
+        if (cell.isInverse()) {
+            this.attributes += Attribute.inverse;
+        }
+        if (cell.isBold()) {
+            this.attributes += Attribute.bold;
+        }
+        if (cell.isItalic()) {
+            this.attributes += Attribute.italic;
+        }
+        if (cell.isUnderline()) {
+            this.attributes += Attribute.underline;
+        }
+        if (cell.isDim()) {
+            this.attributes += Attribute.dim;
+        }
+        if (cell.isFgRGB()) {
+            this.fgColorMode = ColorMode.RGB;
+        }
+        else if (cell.isFgPalette()) {
+            this.fgColorMode = ColorMode.PALETTE;
+        }
+        else {
+            this.fgColorMode = ColorMode.DEFAULT;
+        }
+        if (cell.isBgRGB()) {
+            this.bgColorMode = ColorMode.RGB;
+        }
+        else if (cell.isBgPalette()) {
+            this.bgColorMode = ColorMode.PALETTE;
+        }
+        else {
+            this.bgColorMode = ColorMode.DEFAULT;
+        }
+        if (this.fgColorMode === ColorMode.DEFAULT) {
+            this.fg = -1;
+        }
+        else {
+            this.fg = cell.getFgColor();
+        }
+        if (this.bgColorMode === ColorMode.DEFAULT) {
+            this.bg = -1;
+        }
+        else {
+            this.bg = cell.getBgColor();
+        }
+    }
+    isCursor() {
+        return this.x === this.cursorX && this.y === this.cursorY;
+    }
+    getChars() {
+        return this.cell?.getChars() || ' ';
+    }
+    isAttribute(attribute) {
+        return (this.attributes & attribute) !== 0;
+    }
+    equals(other) {
+        return (this.attributes === other.attributes &&
+            this.fg === other.fg &&
+            this.bg === other.bg &&
+            this.fgColorMode === other.fgColorMode &&
+            this.bgColorMode === other.bgColorMode &&
+            this.isCursor() === other.isCursor());
+    }
+}
+export function serializeTerminalToObject(terminal, startLine, endLine) {
+    const buffer = terminal.buffer.active;
+    const cursorX = buffer.cursorX;
+    const cursorY = buffer.cursorY;
+    const defaultFg = '';
+    const defaultBg = '';
+    const result = [];
+    // Reuse cell instances
+    const lastCell = new Cell(null, -1, -1, cursorX, cursorY);
+    const currentCell = new Cell(null, -1, -1, cursorX, cursorY);
+    const effectiveStart = startLine ?? buffer.viewportY;
+    const effectiveEnd = endLine ?? buffer.viewportY + terminal.rows;
+    for (let y = effectiveStart; y < effectiveEnd; y++) {
+        const line = buffer.getLine(y);
+        const currentLine = [];
+        if (!line) {
+            result.push(currentLine);
+            continue;
+        }
+        // Reset lastCell for new line
+        lastCell.update(null, -1, -1, cursorX, cursorY);
+        let currentText = '';
+        for (let x = 0; x < terminal.cols; x++) {
+            const cellData = line.getCell(x);
+            currentCell.update(cellData || null, x, y, cursorX, cursorY);
+            if (x > 0 && !currentCell.equals(lastCell)) {
+                if (currentText) {
+                    const token = {
+                        text: currentText,
+                        bold: lastCell.isAttribute(Attribute.bold),
+                        italic: lastCell.isAttribute(Attribute.italic),
+                        underline: lastCell.isAttribute(Attribute.underline),
+                        dim: lastCell.isAttribute(Attribute.dim),
+                        inverse: lastCell.isAttribute(Attribute.inverse) || lastCell.isCursor(),
+                        fg: convertColorToHex(lastCell.fg, lastCell.fgColorMode, defaultFg),
+                        bg: convertColorToHex(lastCell.bg, lastCell.bgColorMode, defaultBg),
+                    };
+                    currentLine.push(token);
+                }
+                currentText = '';
+            }
+            currentText += currentCell.getChars();
+            // Copy state from currentCell to lastCell. Since we can't easily deep copy
+            // without allocating, we just update lastCell with the same data.
+            lastCell.update(cellData || null, x, y, cursorX, cursorY);
+        }
+        if (currentText) {
+            const token = {
+                text: currentText,
+                bold: lastCell.isAttribute(Attribute.bold),
+                italic: lastCell.isAttribute(Attribute.italic),
+                underline: lastCell.isAttribute(Attribute.underline),
+                dim: lastCell.isAttribute(Attribute.dim),
+                inverse: lastCell.isAttribute(Attribute.inverse) || lastCell.isCursor(),
+                fg: convertColorToHex(lastCell.fg, lastCell.fgColorMode, defaultFg),
+                bg: convertColorToHex(lastCell.bg, lastCell.bgColorMode, defaultBg),
+            };
+            currentLine.push(token);
+        }
+        result.push(currentLine);
+    }
+    return result;
+}
+// ANSI color palette from https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit
+const ANSI_COLORS = [
+    '#000000',
+    '#800000',
+    '#008000',
+    '#808000',
+    '#000080',
+    '#800080',
+    '#008080',
+    '#c0c0c0',
+    '#808080',
+    '#ff0000',
+    '#00ff00',
+    '#ffff00',
+    '#0000ff',
+    '#ff00ff',
+    '#00ffff',
+    '#ffffff',
+    '#000000',
+    '#00005f',
+    '#000087',
+    '#0000af',
+    '#0000d7',
+    '#0000ff',
+    '#005f00',
+    '#005f5f',
+    '#005f87',
+    '#005faf',
+    '#005fd7',
+    '#005fff',
+    '#008700',
+    '#00875f',
+    '#008787',
+    '#0087af',
+    '#0087d7',
+    '#0087ff',
+    '#00af00',
+    '#00af5f',
+    '#00af87',
+    '#00afaf',
+    '#00afd7',
+    '#00afff',
+    '#00d700',
+    '#00d75f',
+    '#00d787',
+    '#00d7af',
+    '#00d7d7',
+    '#00d7ff',
+    '#00ff00',
+    '#00ff5f',
+    '#00ff87',
+    '#00ffaf',
+    '#00ffd7',
+    '#00ffff',
+    '#5f0000',
+    '#5f005f',
+    '#5f0087',
+    '#5f00af',
+    '#5f00d7',
+    '#5f00ff',
+    '#5f5f00',
+    '#5f5f5f',
+    '#5f5f87',
+    '#5f5faf',
+    '#5f5fd7',
+    '#5f5fff',
+    '#5f8700',
+    '#5f875f',
+    '#5f8787',
+    '#5f87af',
+    '#5f87d7',
+    '#5f87ff',
+    '#5faf00',
+    '#5faf5f',
+    '#5faf87',
+    '#5fafaf',
+    '#5fafd7',
+    '#5fafff',
+    '#5fd700',
+    '#5fd75f',
+    '#5fd787',
+    '#5fd7af',
+    '#5fd7d7',
+    '#5fd7ff',
+    '#5fff00',
+    '#5fff5f',
+    '#5fff87',
+    '#5fffaf',
+    '#5fffd7',
+    '#5fffff',
+    '#870000',
+    '#87005f',
+    '#870087',
+    '#8700af',
+    '#8700d7',
+    '#8700ff',
+    '#875f00',
+    '#875f5f',
+    '#875f87',
+    '#875faf',
+    '#875fd7',
+    '#875fff',
+    '#878700',
+    '#87875f',
+    '#878787',
+    '#8787af',
+    '#8787d7',
+    '#8787ff',
+    '#87af00',
+    '#87af5f',
+    '#87af87',
+    '#87afaf',
+    '#87afd7',
+    '#87afff',
+    '#87d700',
+    '#87d75f',
+    '#87d787',
+    '#87d7af',
+    '#87d7d7',
+    '#87d7ff',
+    '#87ff00',
+    '#87ff5f',
+    '#87ff87',
+    '#87ffaf',
+    '#87ffd7',
+    '#87ffff',
+    '#af0000',
+    '#af005f',
+    '#af0087',
+    '#af00af',
+    '#af00d7',
+    '#af00ff',
+    '#af5f00',
+    '#af5f5f',
+    '#af5f87',
+    '#af5faf',
+    '#af5fd7',
+    '#af5fff',
+    '#af8700',
+    '#af875f',
+    '#af8787',
+    '#af87af',
+    '#af87d7',
+    '#af87ff',
+    '#afaf00',
+    '#afaf5f',
+    '#afaf87',
+    '#afafaf',
+    '#afafd7',
+    '#afafff',
+    '#afd700',
+    '#afd75f',
+    '#afd787',
+    '#afd7af',
+    '#afd7d7',
+    '#afd7ff',
+    '#afff00',
+    '#afff5f',
+    '#afff87',
+    '#afffaf',
+    '#afffd7',
+    '#afffff',
+    '#d70000',
+    '#d7005f',
+    '#d70087',
+    '#d700af',
+    '#d700d7',
+    '#d700ff',
+    '#d75f00',
+    '#d75f5f',
+    '#d75f87',
+    '#d75faf',
+    '#d75fd7',
+    '#d75fff',
+    '#d78700',
+    '#d7875f',
+    '#d78787',
+    '#d787af',
+    '#d787d7',
+    '#d787ff',
+    '#d7af00',
+    '#d7af5f',
+    '#d7af87',
+    '#d7afaf',
+    '#d7afd7',
+    '#d7afff',
+    '#d7d700',
+    '#d7d75f',
+    '#d7d787',
+    '#d7d7af',
+    '#d7d7d7',
+    '#d7d7ff',
+    '#d7ff00',
+    '#d7ff5f',
+    '#d7ff87',
+    '#d7ffaf',
+    '#d7ffd7',
+    '#d7ffff',
+    '#ff0000',
+    '#ff005f',
+    '#ff0087',
+    '#ff00af',
+    '#ff00d7',
+    '#ff00ff',
+    '#ff5f00',
+    '#ff5f5f',
+    '#ff5f87',
+    '#ff5faf',
+    '#ff5fd7',
+    '#ff5fff',
+    '#ff8700',
+    '#ff875f',
+    '#ff8787',
+    '#ff87af',
+    '#ff87d7',
+    '#ff87ff',
+    '#ffaf00',
+    '#ffaf5f',
+    '#ffaf87',
+    '#ffafaf',
+    '#ffafd7',
+    '#ffafff',
+    '#ffd700',
+    '#ffd75f',
+    '#ffd787',
+    '#ffd7af',
+    '#ffd7d7',
+    '#ffd7ff',
+    '#ffff00',
+    '#ffff5f',
+    '#ffff87',
+    '#ffffaf',
+    '#ffffd7',
+    '#ffffff',
+    '#080808',
+    '#121212',
+    '#1c1c1c',
+    '#262626',
+    '#303030',
+    '#3a3a3a',
+    '#444444',
+    '#4e4e4e',
+    '#585858',
+    '#626262',
+    '#6c6c6c',
+    '#767676',
+    '#808080',
+    '#8a8a8a',
+    '#949494',
+    '#9e9e9e',
+    '#a8a8a8',
+    '#b2b2b2',
+    '#bcbcbc',
+    '#c6c6c6',
+    '#d0d0d0',
+    '#dadada',
+    '#e4e4e4',
+    '#eeeeee',
+];
+export function convertColorToHex(color, colorMode, defaultColor) {
+    if (colorMode === ColorMode.RGB) {
+        const r = (color >> 16) & 255;
+        const g = (color >> 8) & 255;
+        const b = color & 255;
+        return `#${r.toString(16).padStart(2, '0')}${g
+            .toString(16)
+            .padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+    }
+    if (colorMode === ColorMode.PALETTE) {
+        return ANSI_COLORS[color] || defaultColor;
+    }
+    return defaultColor;
+}
+//# sourceMappingURL=terminalSerializer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminalSerializer.js","sourceRoot":"","sources":["../../../src/utils/terminalSerializer.ts"],"names":[],"mappings":"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T,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,SAAoB,EACpB,YAAoB;IAEpB,IAAI,SAAS,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QAC7B,MAAM,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;QACtB,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;aAC3C,QAAQ,CAAC,EAAE,CAAC;aACZ,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC;IAC5C,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Check if we should simulate a 429 error for the current request
+ */
+export declare function shouldSimulate429(authType?: string): boolean;
+/**
+ * Reset the request counter (useful for tests)
+ */
+export declare function resetRequestCounter(): void;
+/**
+ * Disable 429 simulation after successful fallback
+ */
+export declare function disableSimulationAfterFallback(): void;
+/**
+ * Create a simulated 429 error response
+ */
+export declare function createSimulated429Error(): Error;
+/**
+ * Reset simulation state when switching auth methods
+ */
+export declare function resetSimulationState(): void;
+/**
+ * Enable/disable 429 simulation programmatically (for tests)
+ */
+export declare function setSimulate429(enabled: boolean, afterRequests?: number, forAuthType?: string): void;

package/dist/src/utils/testUtils.js

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Testing utilities for simulating 429 errors in unit tests
+ */
+let requestCounter = 0;
+let simulate429Enabled = false;
+let simulate429AfterRequests = 0;
+let simulate429ForAuthType;
+let fallbackOccurred = false;
+/**
+ * Check if we should simulate a 429 error for the current request
+ */
+export function shouldSimulate429(authType) {
+    if (!simulate429Enabled || fallbackOccurred) {
+        return false;
+    }
+    // If auth type filter is set, only simulate for that auth type
+    if (simulate429ForAuthType && authType !== simulate429ForAuthType) {
+        return false;
+    }
+    requestCounter++;
+    // If afterRequests is set, only simulate after that many requests
+    if (simulate429AfterRequests > 0) {
+        return requestCounter > simulate429AfterRequests;
+    }
+    // Otherwise, simulate for every request
+    return true;
+}
+/**
+ * Reset the request counter (useful for tests)
+ */
+export function resetRequestCounter() {
+    requestCounter = 0;
+}
+/**
+ * Disable 429 simulation after successful fallback
+ */
+export function disableSimulationAfterFallback() {
+    fallbackOccurred = true;
+}
+/**
+ * Create a simulated 429 error response
+ */
+export function createSimulated429Error() {
+    const error = new Error('Rate limit exceeded (simulated)');
+    error.status = 429;
+    return error;
+}
+/**
+ * Reset simulation state when switching auth methods
+ */
+export function resetSimulationState() {
+    fallbackOccurred = false;
+    resetRequestCounter();
+}
+/**
+ * Enable/disable 429 simulation programmatically (for tests)
+ */
+export function setSimulate429(enabled, afterRequests = 0, forAuthType) {
+    simulate429Enabled = enabled;
+    simulate429AfterRequests = afterRequests;
+    simulate429ForAuthType = forAuthType;
+    fallbackOccurred = false; // Reset fallback state when simulation is re-enabled
+    resetRequestCounter();
+}
+//# sourceMappingURL=testUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","sourceRoot":"","sources":["../../../src/utils/testUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AAEH,IAAI,cAAc,GAAG,CAAC,CAAC;AACvB,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAC/B,IAAI,wBAAwB,GAAG,CAAC,CAAC;AACjC,IAAI,sBAA0C,CAAC;AAC/C,IAAI,gBAAgB,GAAG,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,IAAI,CAAC,kBAAkB,IAAI,gBAAgB,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+DAA+D;IAC/D,IAAI,sBAAsB,IAAI,QAAQ,KAAK,sBAAsB,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,cAAc,EAAE,CAAC;IAEjB,kEAAkE;IAClE,IAAI,wBAAwB,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,cAAc,GAAG,wBAAwB,CAAC;IACnD,CAAC;IAED,wCAAwC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,cAAc,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B;IAC5C,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,iCAAiC,CAExD,CAAC;IACF,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,gBAAgB,GAAG,KAAK,CAAC;IACzB,mBAAmB,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,aAAa,GAAG,CAAC,EACjB,WAAoB;IAEpB,kBAAkB,GAAG,OAAO,CAAC;IAC7B,wBAAwB,GAAG,aAAa,CAAC;IACzC,sBAAsB,GAAG,WAAW,CAAC;IACrC,gBAAgB,GAAG,KAAK,CAAC,CAAC,qDAAqD;IAC/E,mBAAmB,EAAE,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely replaces text with literal strings, avoiding ECMAScript GetSubstitution issues.
+ * Escapes $ characters to prevent template interpretation.
+ */
+export declare function safeLiteralReplace(str: string, oldString: string, newString: string): string;
+/**
+ * Checks if a Buffer is likely binary by testing for the presence of a NULL byte.
+ * The presence of a NULL byte is a strong indicator that the data is not plain text.
+ * @param data The Buffer to check.
+ * @param sampleSize The number of bytes from the start of the buffer to test.
+ * @returns True if a NULL byte is found, false otherwise.
+ */
+export declare function isBinary(data: Buffer | null | undefined, sampleSize?: number): boolean;
+/**
+ * Detects the line ending style of a string.
+ * @param content The string content to analyze.
+ * @returns '\r\n' for Windows-style, '\n' for Unix-style.
+ */
+export declare function detectLineEnding(content: string): '\r\n' | '\n';
+/**
+ * Truncates a string to a maximum length, appending a suffix if truncated.
+ * @param str The string to truncate.
+ * @param maxLength The maximum length of the string.
+ * @param suffix The suffix to append if truncated (default: '...[TRUNCATED]').
+ * @returns The truncated string.
+ */
+export declare function truncateString(str: string, maxLength: number, suffix?: string): string;

package/dist/src/utils/textUtils.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely replaces text with literal strings, avoiding ECMAScript GetSubstitution issues.
+ * Escapes $ characters to prevent template interpretation.
+ */
+export function safeLiteralReplace(str, oldString, newString) {
+    if (oldString === '' || !str.includes(oldString)) {
+        return str;
+    }
+    if (!newString.includes('$')) {
+        return str.replaceAll(oldString, newString);
+    }
+    const escapedNewString = newString.replaceAll('$', '$$$$');
+    return str.replaceAll(oldString, escapedNewString);
+}
+/**
+ * Checks if a Buffer is likely binary by testing for the presence of a NULL byte.
+ * The presence of a NULL byte is a strong indicator that the data is not plain text.
+ * @param data The Buffer to check.
+ * @param sampleSize The number of bytes from the start of the buffer to test.
+ * @returns True if a NULL byte is found, false otherwise.
+ */
+export function isBinary(data, sampleSize = 512) {
+    if (!data) {
+        return false;
+    }
+    const sample = data.length > sampleSize ? data.subarray(0, sampleSize) : data;
+    for (const byte of sample) {
+        // The presence of a NULL byte (0x00) is one of the most reliable
+        // indicators of a binary file. Text files should not contain them.
+        if (byte === 0) {
+            return true;
+        }
+    }
+    // If no NULL bytes were found in the sample, we assume it's text.
+    return false;
+}
+/**
+ * Detects the line ending style of a string.
+ * @param content The string content to analyze.
+ * @returns '\r\n' for Windows-style, '\n' for Unix-style.
+ */
+export function detectLineEnding(content) {
+    // If a Carriage Return is found, assume Windows-style endings.
+    // This is a simple but effective heuristic.
+    return content.includes('\r\n') ? '\r\n' : '\n';
+}
+/**
+ * Truncates a string to a maximum length, appending a suffix if truncated.
+ * @param str The string to truncate.
+ * @param maxLength The maximum length of the string.
+ * @param suffix The suffix to append if truncated (default: '...[TRUNCATED]').
+ * @returns The truncated string.
+ */
+export function truncateString(str, maxLength, suffix = '...[TRUNCATED]') {
+    if (str.length <= maxLength) {
+        return str;
+    }
+    return str.slice(0, maxLength) + suffix;
+}
+//# sourceMappingURL=textUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textUtils.js","sourceRoot":"","sources":["../../../src/utils/textUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,SAAiB,EACjB,SAAiB;IAEjB,IAAI,SAAS,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,gBAAgB,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA+B,EAC/B,UAAU,GAAG,GAAG;IAEhB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9E,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,iEAAiE;QACjE,mEAAmE;QACnE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,+DAA+D;IAC/D,4CAA4C;IAC5C,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,SAAiB,EACjB,MAAM,GAAG,gBAAgB;IAEzB,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type ThoughtSummary = {
+    subject: string;
+    description: string;
+};
+/**
+ * Parses a raw thought string into a structured ThoughtSummary object.
+ *
+ * Thoughts are expected to have a bold "subject" part enclosed in double
+ * asterisks (e.g., **Subject**). The rest of the string is considered
+ * the description. This function only parses the first valid subject found.
+ *
+ * @param rawText The raw text of the thought.
+ * @returns A ThoughtSummary object. If no valid subject is found, the entire
+ * string is treated as the description.
+ */
+export declare function parseThought(rawText: string): ThoughtSummary;