@office-ai/aioncli-core 0.2.3 → 0.18.4

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

@@ -0,0 +1,176 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { Terminal } from '@xterm/headless';
+import { serializeTerminalToObject, convertColorToHex, ColorMode, } from './terminalSerializer.js';
+const RED_FG = '\x1b[31m';
+const RESET = '\x1b[0m';
+function writeToTerminal(terminal, data) {
+    return new Promise((resolve) => {
+        terminal.write(data, resolve);
+    });
+}
+describe('terminalSerializer', () => {
+    describe('serializeTerminalToObject', () => {
+        it('should handle an empty terminal', () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            const result = serializeTerminalToObject(terminal);
+            expect(result).toHaveLength(24);
+            result.forEach((line) => {
+                // Expect each line to be either empty or contain a single token with spaces
+                if (line.length > 0) {
+                    expect(line[0].text.trim()).toBe('');
+                }
+            });
+        });
+        it('should serialize a single line of text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, 'Hello, world!');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].text).toContain('Hello, world!');
+        });
+        it('should serialize multiple lines of text', async () => {
+            const terminal = new Terminal({
+                cols: 7,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, 'Line 1\r\nLine 2');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].text).toBe('Line 1 ');
+            expect(result[1][0].text).toBe('Line 2');
+        });
+        it('should handle bold text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[1mBold text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].bold).toBe(true);
+            expect(result[0][0].text).toBe('Bold text');
+        });
+        it('should handle italic text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[3mItalic text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].italic).toBe(true);
+            expect(result[0][0].text).toBe('Italic text');
+        });
+        it('should handle underlined text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[4mUnderlined text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].underline).toBe(true);
+            expect(result[0][0].text).toBe('Underlined text');
+        });
+        it('should handle dim text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[2mDim text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].dim).toBe(true);
+            expect(result[0][0].text).toBe('Dim text');
+        });
+        it('should handle inverse text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[7mInverse text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].inverse).toBe(true);
+            expect(result[0][0].text).toBe('Inverse text');
+        });
+        it('should handle foreground colors', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, `${RED_FG}Red text${RESET}`);
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].fg).toBe('#800000');
+            expect(result[0][0].text).toBe('Red text');
+        });
+        it('should handle background colors', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[42mGreen background\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].bg).toBe('#008000');
+            expect(result[0][0].text).toBe('Green background');
+        });
+        it('should handle RGB colors', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[38;2;100;200;50mRGB text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].fg).toBe('#64c832');
+            expect(result[0][0].text).toBe('RGB text');
+        });
+        it('should handle a combination of styles', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[1;31;42mStyled text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].bold).toBe(true);
+            expect(result[0][0].fg).toBe('#800000');
+            expect(result[0][0].bg).toBe('#008000');
+            expect(result[0][0].text).toBe('Styled text');
+        });
+    });
+    describe('convertColorToHex', () => {
+        it('should convert RGB color to hex', () => {
+            const color = (100 << 16) | (200 << 8) | 50;
+            const hex = convertColorToHex(color, ColorMode.RGB, '#000000');
+            expect(hex).toBe('#64c832');
+        });
+        it('should convert palette color to hex', () => {
+            const hex = convertColorToHex(1, ColorMode.PALETTE, '#000000');
+            expect(hex).toBe('#800000');
+        });
+        it('should return default color for ColorMode.DEFAULT', () => {
+            const hex = convertColorToHex(0, ColorMode.DEFAULT, '#ffffff');
+            expect(hex).toBe('#ffffff');
+        });
+        it('should return default color for invalid palette index', () => {
+            const hex = convertColorToHex(999, ColorMode.PALETTE, '#000000');
+            expect(hex).toBe('#000000');
+        });
+    });
+});
+//# sourceMappingURL=terminalSerializer.test.js.map

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

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

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

@@ -3,6 +3,11 @@
  * 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.

package/dist/src/utils/textUtils.js

@@ -3,6 +3,20 @@
  * 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.

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

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

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { safeLiteralReplace } from './textUtils.js';
+describe('safeLiteralReplace', () => {
+    it('returns original string when oldString empty or not found', () => {
+        expect(safeLiteralReplace('abc', '', 'X')).toBe('abc');
+        expect(safeLiteralReplace('abc', 'z', 'X')).toBe('abc');
+    });
+    it('fast path when newString has no $', () => {
+        expect(safeLiteralReplace('abc', 'b', 'X')).toBe('aXc');
+    });
+    it('treats $ literally', () => {
+        expect(safeLiteralReplace('foo', 'foo', "bar$'baz")).toBe("bar$'baz");
+    });
+    it("does not interpret replacement patterns like $&, $', $` and $1", () => {
+        expect(safeLiteralReplace('hello', 'hello', '$&-replacement')).toBe('$&-replacement');
+        expect(safeLiteralReplace('mid', 'mid', 'new$`content')).toBe('new$`content');
+        expect(safeLiteralReplace('test', 'test', '$1$2value')).toBe('$1$2value');
+    });
+    it('preserves end-of-line $ in regex-like text', () => {
+        const current = "| select('match', '^[sv]d[a-z]$')";
+        const oldStr = "'^[sv]d[a-z]$'";
+        const newStr = "'^[sv]d[a-z]$' # updated";
+        const expected = "| select('match', '^[sv]d[a-z]$' # updated)";
+        expect(safeLiteralReplace(current, oldStr, newStr)).toBe(expected);
+    });
+    it('handles multiple $ characters', () => {
+        expect(safeLiteralReplace('x', 'x', '$$$')).toBe('$$$');
+    });
+    it('preserves pre-escaped $$ literally', () => {
+        expect(safeLiteralReplace('x', 'x', '$$value')).toBe('$$value');
+    });
+    it('handles complex malicious patterns from PR #7871', () => {
+        const original = 'The price is PRICE.';
+        const result = safeLiteralReplace(original, 'PRICE', "$& Wow, that's a lot! $'");
+        expect(result).toBe("The price is $& Wow, that's a lot! $'.");
+    });
+    it('handles multiple replacements correctly', () => {
+        const text = 'Replace FOO and FOO again';
+        const result = safeLiteralReplace(text, 'FOO', '$100');
+        expect(result).toBe('Replace $100 and $100 again');
+    });
+    it('preserves $ at different positions', () => {
+        expect(safeLiteralReplace('test', 'test', '$')).toBe('$');
+        expect(safeLiteralReplace('test', 'test', 'prefix$')).toBe('prefix$');
+        expect(safeLiteralReplace('test', 'test', '$suffix')).toBe('$suffix');
+    });
+    it('handles edge case with $$$$', () => {
+        expect(safeLiteralReplace('x', 'x', '$$$$')).toBe('$$$$');
+    });
+    it('handles newString with only dollar signs', () => {
+        expect(safeLiteralReplace('abc', 'b', '$$')).toBe('a$$c');
+    });
+});
+//# sourceMappingURL=textUtils.test.js.map

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

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

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;

package/dist/src/utils/thoughtUtils.js

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const START_DELIMITER = '**';
+const END_DELIMITER = '**';
+/**
+ * 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 function parseThought(rawText) {
+    const startIndex = rawText.indexOf(START_DELIMITER);
+    if (startIndex === -1) {
+        // No start delimiter found, the whole text is the description.
+        return { subject: '', description: rawText.trim() };
+    }
+    const endIndex = rawText.indexOf(END_DELIMITER, startIndex + START_DELIMITER.length);
+    if (endIndex === -1) {
+        // Start delimiter found but no end delimiter, so it's not a valid subject.
+        // Treat the entire string as the description.
+        return { subject: '', description: rawText.trim() };
+    }
+    const subject = rawText
+        .substring(startIndex + START_DELIMITER.length, endIndex)
+        .trim();
+    // The description is everything before the start delimiter and after the end delimiter.
+    const description = (rawText.substring(0, startIndex) +
+        rawText.substring(endIndex + END_DELIMITER.length)).trim();
+    return { subject, description };
+}
+//# sourceMappingURL=thoughtUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thoughtUtils.js","sourceRoot":"","sources":["../../../src/utils/thoughtUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,+DAA+D;QAC/D,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAC9B,aAAa,EACb,UAAU,GAAG,eAAe,CAAC,MAAM,CACpC,CAAC;IACF,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,2EAA2E;QAC3E,8CAA8C;QAC9C,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,OAAO;SACpB,SAAS,CAAC,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC;SACxD,IAAI,EAAE,CAAC;IAEV,wFAAwF;IACxF,MAAM,WAAW,GAAG,CAClB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC;QAChC,OAAO,CAAC,SAAS,CAAC,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CACnD,CAAC,IAAI,EAAE,CAAC;IAET,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/thoughtUtils.test.js

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { parseThought } from './thoughtUtils.js';
+describe('parseThought', () => {
+    it.each([
+        {
+            name: 'a standard thought with subject and description',
+            rawText: '**Subject:** This is the description.',
+            expected: {
+                subject: 'Subject:',
+                description: 'This is the description.',
+            },
+        },
+        {
+            name: 'leading and trailing whitespace in the raw string',
+            rawText: '  **Subject** description with spaces   ',
+            expected: { subject: 'Subject', description: 'description with spaces' },
+        },
+        {
+            name: 'whitespace surrounding the subject content',
+            rawText: '** Subject  **',
+            expected: { subject: 'Subject', description: '' },
+        },
+        {
+            name: 'a thought with only a subject',
+            rawText: '**Only Subject**',
+            expected: { subject: 'Only Subject', description: '' },
+        },
+        {
+            name: 'a thought with only a description (no subject)',
+            rawText: 'This is just a description.',
+            expected: { subject: '', description: 'This is just a description.' },
+        },
+        {
+            name: 'an empty string input',
+            rawText: '',
+            expected: { subject: '', description: '' },
+        },
+        {
+            name: 'newlines within the subject and description',
+            rawText: '**Multi-line\nSubject**\nHere is a description\nspread across lines.',
+            expected: {
+                subject: 'Multi-line\nSubject',
+                description: 'Here is a description\nspread across lines.',
+            },
+        },
+        {
+            name: 'only the first subject if multiple are present',
+            rawText: '**First** some text **Second**',
+            expected: { subject: 'First', description: 'some text **Second**' },
+        },
+        {
+            name: 'text before and after the subject',
+            rawText: 'Prefix text **Subject** Suffix text.',
+            expected: {
+                subject: 'Subject',
+                description: 'Prefix text  Suffix text.',
+            },
+        },
+        {
+            name: 'an unclosed subject tag',
+            rawText: 'Text with **an unclosed subject',
+            expected: { subject: '', description: 'Text with **an unclosed subject' },
+        },
+        {
+            name: 'an empty subject tag',
+            rawText: 'A thought with **** in the middle.',
+            expected: { subject: '', description: 'A thought with  in the middle.' },
+        },
+    ])('should correctly parse $name', ({ rawText, expected }) => {
+        expect(parseThought(rawText)).toEqual(expected);
+    });
+});
+//# sourceMappingURL=thoughtUtils.test.js.map

package/dist/src/utils/thoughtUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thoughtUtils.test.js","sourceRoot":"","sources":["../../../src/utils/thoughtUtils.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,IAAI,CAAC;QACN;YACE,IAAI,EAAE,iDAAiD;YACvD,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE;gBACR,OAAO,EAAE,UAAU;gBACnB,WAAW,EAAE,0BAA0B;aACxC;SACF;QACD;YACE,IAAI,EAAE,mDAAmD;YACzD,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE;SACzE;QACD;YACE,IAAI,EAAE,4CAA4C;YAClD,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE;SAClD;QACD;YACE,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,EAAE;SACvD;QACD;YACE,IAAI,EAAE,gDAAgD;YACtD,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACtE;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;SAC3C;QACD;YACE,IAAI,EAAE,6CAA6C;YACnD,OAAO,EACL,sEAAsE;YACxE,QAAQ,EAAE;gBACR,OAAO,EAAE,qBAAqB;gBAC9B,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD;YACE,IAAI,EAAE,gDAAgD;YACtD,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE;SACpE;QACD;YACE,IAAI,EAAE,mCAAmC;YACzC,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE;gBACR,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,2BAA2B;aACzC;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE;SAC1E;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE;SACzE;KACF,CAAC,CAAC,8BAA8B,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC3D,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/utils/tool-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AnyDeclarativeTool, AnyToolInvocation } from '../index.js';
+/**
+ * Checks if a tool invocation matches any of a list of patterns.
+ *
+ * @param toolOrToolName The tool object or the name of the tool being invoked.
+ * @param invocation The invocation object for the tool or the command invoked.
+ * @param patterns A list of patterns to match against.
+ *   Patterns can be:
+ *   - A tool name (e.g., "ReadFileTool") to match any invocation of that tool.
+ *   - A tool name with a prefix (e.g., "ShellTool(git status)") to match
+ *     invocations where the arguments start with that prefix.
+ * @returns True if the invocation matches any pattern, false otherwise.
+ */
+export declare function doesToolInvocationMatch(toolOrToolName: AnyDeclarativeTool | string, invocation: AnyToolInvocation | string, patterns: string[]): boolean;

package/dist/src/utils/tool-utils.js

@@ -0,0 +1,67 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isTool } from '../index.js';
+import { SHELL_TOOL_NAMES } from './shell-utils.js';
+/**
+ * Checks if a tool invocation matches any of a list of patterns.
+ *
+ * @param toolOrToolName The tool object or the name of the tool being invoked.
+ * @param invocation The invocation object for the tool or the command invoked.
+ * @param patterns A list of patterns to match against.
+ *   Patterns can be:
+ *   - A tool name (e.g., "ReadFileTool") to match any invocation of that tool.
+ *   - A tool name with a prefix (e.g., "ShellTool(git status)") to match
+ *     invocations where the arguments start with that prefix.
+ * @returns True if the invocation matches any pattern, false otherwise.
+ */
+export function doesToolInvocationMatch(toolOrToolName, invocation, patterns) {
+    let toolNames;
+    if (isTool(toolOrToolName)) {
+        toolNames = [toolOrToolName.name, toolOrToolName.constructor.name];
+    }
+    else {
+        toolNames = [toolOrToolName];
+    }
+    if (toolNames.some((name) => SHELL_TOOL_NAMES.includes(name))) {
+        toolNames = [...new Set([...toolNames, ...SHELL_TOOL_NAMES])];
+    }
+    for (const pattern of patterns) {
+        const openParen = pattern.indexOf('(');
+        if (openParen === -1) {
+            // No arguments, just a tool name
+            if (toolNames.includes(pattern)) {
+                return true;
+            }
+            continue;
+        }
+        const patternToolName = pattern.substring(0, openParen);
+        if (!toolNames.includes(patternToolName)) {
+            continue;
+        }
+        if (!pattern.endsWith(')')) {
+            continue;
+        }
+        const argPattern = pattern.substring(openParen + 1, pattern.length - 1);
+        let command;
+        if (typeof invocation === 'string') {
+            command = invocation;
+        }
+        else {
+            if (!('command' in invocation.params)) {
+                // This invocation has no command - nothing to check.
+                continue;
+            }
+            command = String(invocation.params.command);
+        }
+        if (toolNames.some((name) => SHELL_TOOL_NAMES.includes(name))) {
+            if (command === argPattern || command.startsWith(argPattern + ' ')) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=tool-utils.js.map

package/dist/src/utils/tool-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-utils.js","sourceRoot":"","sources":["../../../src/utils/tool-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,cAA2C,EAC3C,UAAsC,EACtC,QAAkB;IAElB,IAAI,SAAmB,CAAC;IACxB,IAAI,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QAC3B,SAAS,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,CAAC,cAAwB,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9D,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACrB,iCAAiC;YACjC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAExE,IAAI,OAAe,CAAC;QACpB,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,GAAG,UAAU,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtC,qDAAqD;gBACrD,SAAS;YACX,CAAC;YACD,OAAO,GAAG,MAAM,CAAE,UAAU,CAAC,MAA8B,CAAC,OAAO,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9D,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,EAAE,CAAC;gBACnE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/utils/tool-utils.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/tool-utils.test.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { expect, describe, it } from 'vitest';
+import { doesToolInvocationMatch } from './tool-utils.js';
+import { ReadFileTool } from '../tools/read-file.js';
+describe('doesToolInvocationMatch', () => {
+    it('should not match a partial command prefix', () => {
+        const invocation = {
+            params: { command: 'git commitsomething' },
+        };
+        const patterns = ['ShellTool(git commit)'];
+        const result = doesToolInvocationMatch('run_shell_command', invocation, patterns);
+        expect(result).toBe(false);
+    });
+    it('should match an exact command', () => {
+        const invocation = {
+            params: { command: 'git status' },
+        };
+        const patterns = ['ShellTool(git status)'];
+        const result = doesToolInvocationMatch('run_shell_command', invocation, patterns);
+        expect(result).toBe(true);
+    });
+    it('should match a command with an alias', () => {
+        const invocation = {
+            params: { command: 'wc -l' },
+        };
+        const patterns = ['ShellTool(wc)'];
+        const result = doesToolInvocationMatch('ShellTool', invocation, patterns);
+        expect(result).toBe(true);
+    });
+    it('should match a command that is a prefix', () => {
+        const invocation = {
+            params: { command: 'git status -v' },
+        };
+        const patterns = ['ShellTool(git status)'];
+        const result = doesToolInvocationMatch('run_shell_command', invocation, patterns);
+        expect(result).toBe(true);
+    });
+    describe('for non-shell tools', () => {
+        const readFileTool = new ReadFileTool({});
+        const invocation = {
+            params: { file: 'test.txt' },
+        };
+        it('should match by tool name', () => {
+            const patterns = ['read_file'];
+            const result = doesToolInvocationMatch(readFileTool, invocation, patterns);
+            expect(result).toBe(true);
+        });
+        it('should match by tool class name', () => {
+            const patterns = ['ReadFileTool'];
+            const result = doesToolInvocationMatch(readFileTool, invocation, patterns);
+            expect(result).toBe(true);
+        });
+        it('should not match if neither name is in the patterns', () => {
+            const patterns = ['some_other_tool', 'AnotherToolClass'];
+            const result = doesToolInvocationMatch(readFileTool, invocation, patterns);
+            expect(result).toBe(false);
+        });
+        it('should match by tool name when passed as a string', () => {
+            const patterns = ['read_file'];
+            const result = doesToolInvocationMatch('read_file', invocation, patterns);
+            expect(result).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=tool-utils.test.js.map

package/dist/src/utils/tool-utils.test.js.map

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