@polka-codes/core 0.10.13 → 0.10.17

package/dist/tools/utils/replaceInFile.test.js

@@ -0,0 +1,308 @@
+import { describe, expect, it } from 'bun:test';
+import { replaceInFile } from './replaceInFile';
+describe('replaceInFile', () => {
+    it('should perform basic single replacement', async () => {
+        const content = `line1
+line2
+line3`;
+        const diff = `<<<<<<< SEARCH
+line2
+=======
+new line2
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+new line2
+line3`,
+            status: 'all_diff_applied',
+            appliedCount: 1,
+            totalCount: 1,
+        });
+    });
+    it('should handle multiple replacements', async () => {
+        const content = `line1
+line2
+line3
+line2`;
+        const diff = `<<<<<<< SEARCH
+line2
+=======
+new line2
+>>>>>>> REPLACE
+<<<<<<< SEARCH
+line3
+=======
+new line3
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+new line2
+new line3
+line2`,
+            status: 'all_diff_applied',
+            appliedCount: 2,
+            totalCount: 2,
+        });
+    });
+    it('should handle whitespace variations', async () => {
+        const content = `line1
+  line2
+line3`;
+        const diff = `<<<<<<< SEARCH
+line2
+=======
+new line2
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+  new line2
+line3`,
+            status: 'all_diff_applied',
+            appliedCount: 1,
+            totalCount: 1,
+        });
+    });
+    it('should throw error when no blocks found', async () => {
+        const content = `line1
+line2`;
+        const diff = 'invalid format';
+        expect(() => replaceInFile(content, diff)).toThrow('No valid diff blocks found');
+    });
+    it('should return no_diff_applied when search text not found', async () => {
+        const content = `line1
+line2`;
+        const diff = `<<<<<<< SEARCH
+line3
+=======
+new line3
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content,
+            status: 'no_diff_applied',
+            appliedCount: 0,
+            totalCount: 1,
+        });
+    });
+    it('should handle empty file', async () => {
+        const content = '';
+        const diff = `<<<<<<< SEARCH
+line1
+=======
+new line1
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content,
+            status: 'no_diff_applied',
+            appliedCount: 0,
+            totalCount: 1,
+        });
+    });
+    it('should handle empty replacement', async () => {
+        const content = `line1
+line2`;
+        const diff = `<<<<<<< SEARCH
+line2
+=======
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+`,
+            status: 'all_diff_applied',
+            appliedCount: 1,
+            totalCount: 1,
+        });
+    });
+    it('should return some_diff_applied when some search text not found', () => {
+        const content = 'line1\nline2';
+        const diff = `<<<<<<< SEARCH
+line1
+=======
+new line1
+>>>>>>> REPLACE
+<<<<<<< SEARCH
+line3
+=======
+new line3
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: 'new line1\nline2',
+            status: 'some_diff_applied',
+            appliedCount: 1,
+            totalCount: 2,
+        });
+    });
+    it('should handle block with no space before SEARCH', () => {
+        const content = `line1
+line2
+line3`;
+        const diff = `<<<<<<<SEARCH
+line2
+=======
+new line2
+>>>>>>>REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+new line2
+line3`,
+            status: 'all_diff_applied',
+            appliedCount: 1,
+            totalCount: 1,
+        });
+    });
+    it('should handle block with multiple spaces before SEARCH', () => {
+        const content = `line1
+line2
+line3`;
+        const diff = `<<<<<<<  SEARCH
+line2
+=======
+new line2
+>>>>>>>  REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+new line2
+line3`,
+            status: 'all_diff_applied',
+            appliedCount: 1,
+            totalCount: 1,
+        });
+    });
+    it('should handle block with tab before SEARCH', () => {
+        const content = `line1
+line2
+line3`;
+        const diff = `<<<<<<<	SEARCH
+line2
+=======
+new line2
+>>>>>>>	REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+new line2
+line3`,
+            status: 'all_diff_applied',
+            appliedCount: 1,
+            totalCount: 1,
+        });
+    });
+    it('should handle block with mixed whitespace before SEARCH', () => {
+        const content = `line1
+line2
+line3`;
+        const diff = `<<<<<< 	 SEARCH
+line2
+=======
+new line2
+>>>>>> 	 REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+new line2
+line3`,
+            status: 'all_diff_applied',
+            appliedCount: 1,
+            totalCount: 1,
+        });
+    });
+    it('should handle multiple blocks with varying whitespace patterns', () => {
+        const content = `line1
+line2
+line3
+line4`;
+        const diff = `<<<<<<<SEARCH
+line2
+=======
+new line2
+>>>>>>>REPLACE
+<<<<<<< SEARCH
+line3
+=======
+new line3
+>>>>>>> REPLACE
+<<<<<<<  SEARCH
+line4
+=======
+new line4
+>>>>>>>  REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result).toEqual({
+            content: `line1
+new line2
+new line3
+new line4`,
+            status: 'all_diff_applied',
+            appliedCount: 3,
+            totalCount: 3,
+        });
+    });
+    it('should handle whitespace-agnostic replacement with multiple spaces', () => {
+        // Test the bug fix: search text with irregular whitespace should match content with normalized whitespace
+        const content = `function test() {
+  const x = 1
+  return x
+}`;
+        const diff = `<<<<<<< SEARCH
+function test() {
+    const x = 1
+    return x
+}
+=======
+function test() {
+  const y = 2
+  return y
+}
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result.status).toBe('all_diff_applied');
+        expect(result.appliedCount).toBe(1);
+        expect(result.content).toContain('const y = 2');
+        expect(result.content).toContain('return y');
+    });
+    it('should handle whitespace-agnostic replacement with tabs vs spaces', () => {
+        const content = `line1
+	line2
+line3`;
+        const diff = `<<<<<<< SEARCH
+line1
+line2
+line3
+=======
+line1
+new line2
+line3
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result.status).toBe('all_diff_applied');
+        expect(result.appliedCount).toBe(1);
+        expect(result.content).toContain('new line2');
+    });
+    it('should handle whitespace-agnostic replacement with extra newlines', () => {
+        const content = `line1
+
+
+line2
+line3`;
+        const diff = `<<<<<<< SEARCH
+line1
+
+line2
+=======
+line1
+line2
+>>>>>>> REPLACE`;
+        const result = replaceInFile(content, diff);
+        expect(result.status).toBe('all_diff_applied');
+        expect(result.appliedCount).toBe(1);
+    });
+});
+//# sourceMappingURL=replaceInFile.test.js.map

package/dist/tools/utils/replaceInFile.test.js.map

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

package/dist/tools/utils.d.ts

@@ -0,0 +1,10 @@
+export { createProviderErrorResponse as createProviderError } from './response-builders';
+/**
+ * Simplify boolean string preprocessing
+ * Converts 'true'/'false' strings to actual booleans
+ */
+export declare function preprocessBoolean(val: unknown): unknown;
+/**
+ * Create a file content XML element
+ */
+export declare function createFileElement(tagName: string, path: string, content?: string, attrs?: Record<string, string>): string;

package/dist/tools/utils.js

@@ -0,0 +1,27 @@
+// Re-export from response-builders for backward compatibility
+export { createProviderErrorResponse as createProviderError } from './response-builders';
+/**
+ * Simplify boolean string preprocessing
+ * Converts 'true'/'false' strings to actual booleans
+ */
+export function preprocessBoolean(val) {
+    return typeof val === 'string' ? val.toLowerCase() === 'true' : val;
+}
+/**
+ * Create a file content XML element
+ */
+export function createFileElement(tagName, path, content, attrs) {
+    const allAttrs = { path, ...attrs };
+    const attrStr = Object.entries(allAttrs)
+        .map(([k, v]) => ` ${k}="${v}"`)
+        .join('');
+    if (content === undefined) {
+        return `<${tagName}${attrStr} />`;
+    }
+    const isEmpty = content.trim().length === 0;
+    if (isEmpty) {
+        return `<${tagName}${attrStr} is_empty="true" />`;
+    }
+    return `<${tagName}${attrStr}>${content}</${tagName}>`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,OAAO,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAExF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAA;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,IAAY,EAAE,OAAgB,EAAE,KAA8B;IAC/G,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;SAC/B,IAAI,CAAC,EAAE,CAAC,CAAA;IAEX,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,IAAI,OAAO,GAAG,OAAO,KAAK,CAAA;IACnC,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAA;IAC3C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI,OAAO,GAAG,OAAO,qBAAqB,CAAA;IACnD,CAAC;IAED,OAAO,IAAI,OAAO,GAAG,OAAO,IAAI,OAAO,KAAK,OAAO,GAAG,CAAA;AACxD,CAAC"}

package/dist/tools/writeToFile.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { FilesystemProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "writeToFile";
+    readonly description: "Request to write content to a file at the specified path.\n\nWhen to use:\n- Creating new files\n- Completely replacing file contents\n- When you have the complete intended content\n\nWhen NOT to use:\n- For modifying existing files: Use replaceInFile instead\n- For appending content: Use executeCommand with echo >> instead\n- For targeted edits: Use replaceInFile instead\n\nFeatures:\n- Automatically creates any directories needed\n- Overwrites existing files completely\n- Must provide complete file content (no truncation)\n\nIMPORTANT CONSTRAINT:\n- Always provide COMPLETE intended content (no omissions)\n- Ensure no incorrect escape sequences (<, >, &)\n- Ensure no unwanted CDATA tags in content";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, FilesystemProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "writeToFile";
+        readonly description: "Request to write content to a file at the specified path.\n\nWhen to use:\n- Creating new files\n- Completely replacing file contents\n- When you have the complete intended content\n\nWhen NOT to use:\n- For modifying existing files: Use replaceInFile instead\n- For appending content: Use executeCommand with echo >> instead\n- For targeted edits: Use replaceInFile instead\n\nFeatures:\n- Automatically creates any directories needed\n- Overwrites existing files completely\n- Must provide complete file content (no truncation)\n\nIMPORTANT CONSTRAINT:\n- Always provide COMPLETE intended content (no omissions)\n- Ensure no incorrect escape sequences (&lt;, &gt;, &amp;)\n- Ensure no unwanted CDATA tags in content";
+        readonly parameters: z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>;
+    }, FilesystemProvider>;
+    name: "writeToFile";
+    description: "Request to write content to a file at the specified path.\n\nWhen to use:\n- Creating new files\n- Completely replacing file contents\n- When you have the complete intended content\n\nWhen NOT to use:\n- For modifying existing files: Use replaceInFile instead\n- For appending content: Use executeCommand with echo >> instead\n- For targeted edits: Use replaceInFile instead\n\nFeatures:\n- Automatically creates any directories needed\n- Overwrites existing files completely\n- Must provide complete file content (no truncation)\n\nIMPORTANT CONSTRAINT:\n- Always provide COMPLETE intended content (no omissions)\n- Ensure no incorrect escape sequences (&lt;, &gt;, &amp;)\n- Ensure no unwanted CDATA tags in content";
+    parameters: z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/writeToFile.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+import { createProviderError } from './utils';
+export const toolInfo = {
+    name: 'writeToFile',
+    description: `Request to write content to a file at the specified path.
+
+When to use:
+- Creating new files
+- Completely replacing file contents
+- When you have the complete intended content
+
+When NOT to use:
+- For modifying existing files: Use replaceInFile instead
+- For appending content: Use executeCommand with echo >> instead
+- For targeted edits: Use replaceInFile instead
+
+Features:
+- Automatically creates any directories needed
+- Overwrites existing files completely
+- Must provide complete file content (no truncation)
+
+IMPORTANT CONSTRAINT:
+- Always provide COMPLETE intended content (no omissions)
+- Ensure no incorrect escape sequences (<, >, &)
+- Ensure no unwanted CDATA tags in content`,
+    parameters: z
+        .object({
+        path: z.string().describe('The path of the file to write to').meta({ usageValue: 'File path here' }),
+        content: z
+            .string()
+            .describe("The content to write to the file. ALWAYS provide the COMPLETE intended content of the file, without any truncation or omissions. You MUST include ALL parts of the file, even if they haven't been modified.")
+            .meta({ usageValue: 'Your file content here' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Request to write content to a file',
+                input: {
+                    path: 'src/main.js',
+                    content: `import React from 'react';
+
+function App() {
+  return (
+    <div>
+      <h1>Hello, World!</h1>
+    </div>
+  );
+}
+
+export default App;
+`,
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.writeFile) {
+        return createProviderError('write file');
+    }
+    const parsed = toolInfo.parameters.safeParse(args);
+    if (!parsed.success) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: `Invalid arguments for writeToFile: ${parsed.error.message}`,
+            },
+        };
+    }
+    const { path, content } = parsed.data;
+    await provider.writeFile(path, content);
+    return {
+        success: true,
+        message: {
+            type: 'text',
+            value: `<write_to_file_path>${path}</write_to_file_path><status>Success</status>`,
+        },
+    };
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=writeToFile.js.map

package/dist/tools/writeToFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeToFile.js","sourceRoot":"","sources":["../../src/tools/writeToFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAE7C,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;2CAoB4B;IACzC,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;QACpG,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,8MAA8M,CAC/M;aACA,IAAI,CAAC,EAAE,UAAU,EAAE,wBAAwB,EAAE,CAAC;KAClD,CAAC;SACD,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR;gBACE,WAAW,EAAE,oCAAoC;gBACjD,KAAK,EAAE;oBACL,IAAI,EAAE,aAAa;oBACnB,OAAO,EAAE;;;;;;;;;;;CAWpB;iBACU;aACF;SACF;KACF,CAAC;CACuB,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAqD,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAChG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,OAAO,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,sCAAsC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;aACpE;SACF,CAAA;IACH,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAA;IAErC,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAEvC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,uBAAuB,IAAI,+CAA+C;SAClF;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe;IACb,GAAG,QAAQ;IACX,OAAO;CACe,CAAA"}

package/dist/tools/writeToFile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/writeToFile.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it, spyOn } from 'bun:test';
+import { MockProvider } from './provider';
+import writeToFile from './writeToFile';
+describe('writeToFile', () => {
+    it('should write file successfully', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'writeFile').mockResolvedValue();
+        const result = await writeToFile.handler(mockProvider, {
+            path: 'test.txt',
+            content: 'Test content',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.writeFile).toHaveBeenCalledWith('test.txt', 'Test content');
+    });
+    it('should handle directory creation', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'writeFile').mockResolvedValue();
+        const result = await writeToFile.handler(mockProvider, {
+            path: 'new-dir/test.txt',
+            content: 'Test content',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.writeFile).toHaveBeenCalledWith('new-dir/test.txt', 'Test content');
+    });
+    it('should handle write errors', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'writeFile').mockRejectedValue(new Error('Write error'));
+        const result = writeToFile.handler(mockProvider, {
+            path: 'error.txt',
+            content: 'Test content',
+        });
+        expect(result).rejects.toMatchSnapshot();
+        expect(mockProvider.writeFile).toHaveBeenCalledWith('error.txt', 'Test content');
+    });
+    it('should write content with CDATA tags as-is', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'writeFile').mockResolvedValue();
+        const result = await writeToFile.handler(mockProvider, {
+            path: 'cdata.txt',
+            content: '<![CDATA[Test content]]>',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.writeFile).toHaveBeenCalledWith('cdata.txt', '<![CDATA[Test content]]>');
+    });
+});
+//# sourceMappingURL=writeToFile.test.js.map

package/dist/tools/writeToFile.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeToFile.test.js","sourceRoot":"","sources":["../../src/tools/writeToFile.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,WAAW,MAAM,eAAe,CAAA;AAEvC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,iBAAiB,EAAE,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE;YACrD,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,cAAc;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAA;QAChC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,iBAAiB,EAAE,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE;YACrD,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,cAAc;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAA;QAChC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAA;IACzF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAA;QAE5E,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE;YAC/C,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,cAAc;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAA;QACxC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAClF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,iBAAiB,EAAE,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE;YACrD,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0BAA0B;SACpC,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAA;QAChC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAA;IAC9F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export { deepMerge } from './merge';

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+// Generated by polka.codes
+export { deepMerge } from './merge';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA"}

package/dist/utils/merge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Deep merge utility with EXPLICIT path specification
+ *
+ * This utility performs a shallow merge by default, with deep merging
+ * ONLY for paths explicitly specified. This prevents accidental deep
+ * merging of unexpected properties.
+ *
+ * @example
+ * ```typescript
+ * const config = { a: 1, b: { x: 1, y: 2 }, c: { z: 3 } }
+ * const override = { a: 2, b: { x: 10 }, c: 'not-an-object' }
+ *
+ * // Deep merge only 'b', shallow merge everything else
+ * const result = deepMerge(config, override, ['b'])
+ * // Result: { a: 2, b: { x: 10, y: 2 }, c: 'not-an-object' }
+ *
+ * // Note: 'c' was NOT deep merged because it's not in deepPaths
+ * // Note: 'b.x' was updated while 'b.y' was preserved (deep merge)
+ * ```
+ *
+ * @param base - The base object to merge into
+ * @param override - The object with values to override
+ * @param deepPaths - Array of keys that should be deep merged (must be plain objects)
+ * @returns A new object with merged values
+ */
+export declare function deepMerge<T extends object>(base: T, override: Partial<T>, deepPaths: Array<keyof T>): T;

package/dist/utils/merge.js

@@ -0,0 +1,45 @@
+// Generated by polka.codes
+/**
+ * Deep merge utility with EXPLICIT path specification
+ *
+ * This utility performs a shallow merge by default, with deep merging
+ * ONLY for paths explicitly specified. This prevents accidental deep
+ * merging of unexpected properties.
+ *
+ * @example
+ * ```typescript
+ * const config = { a: 1, b: { x: 1, y: 2 }, c: { z: 3 } }
+ * const override = { a: 2, b: { x: 10 }, c: 'not-an-object' }
+ *
+ * // Deep merge only 'b', shallow merge everything else
+ * const result = deepMerge(config, override, ['b'])
+ * // Result: { a: 2, b: { x: 10, y: 2 }, c: 'not-an-object' }
+ *
+ * // Note: 'c' was NOT deep merged because it's not in deepPaths
+ * // Note: 'b.x' was updated while 'b.y' was preserved (deep merge)
+ * ```
+ *
+ * @param base - The base object to merge into
+ * @param override - The object with values to override
+ * @param deepPaths - Array of keys that should be deep merged (must be plain objects)
+ * @returns A new object with merged values
+ */
+export function deepMerge(base, override, deepPaths) {
+    const result = { ...base, ...override };
+    // Explicit deep merge - only merge paths specified in deepPaths
+    for (const path of deepPaths) {
+        const baseValue = base[path];
+        const overrideValue = override[path];
+        // Only merge plain objects (not arrays, dates, null, etc.)
+        if (typeof baseValue === 'object' &&
+            baseValue !== null &&
+            !Array.isArray(baseValue) &&
+            typeof overrideValue === 'object' &&
+            overrideValue !== null &&
+            !Array.isArray(overrideValue)) {
+            result[path] = { ...baseValue, ...overrideValue };
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=merge.js.map

package/dist/utils/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/utils/merge.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS,CAAmB,IAAO,EAAE,QAAoB,EAAE,SAAyB;IAClG,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAA;IAEvC,gEAAgE;IAChE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEpC,2DAA2D;QAC3D,IACE,OAAO,SAAS,KAAK,QAAQ;YAC7B,SAAS,KAAK,IAAI;YAClB,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACzB,OAAO,aAAa,KAAK,QAAQ;YACjC,aAAa,KAAK,IAAI;YACtB,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAC7B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,GAAG,aAAa,EAAiC,CAAA;QAClF,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/workflow/agent.workflow.d.ts

@@ -0,0 +1,39 @@
+import { type ToolSet } from 'ai';
+import { z } from 'zod';
+import type { FullToolInfo, ToolResponse } from '../tool';
+import type { JsonModelMessage, JsonResponseMessage, JsonUserModelMessage } from './json-ai-types';
+import { type ExitReason, type TaskEvent } from './types';
+import type { WorkflowFn } from './workflow';
+export type AgentWorkflowInput = {
+    tools: Readonly<FullToolInfo[]>;
+    maxToolRoundTrips?: number;
+    userMessage: readonly JsonUserModelMessage[];
+    outputSchema?: z.ZodSchema;
+    model?: string;
+} & ({
+    messages: JsonModelMessage[];
+} | {
+    systemPrompt: string;
+});
+export type AgentToolRegistry = {
+    generateText: {
+        input: {
+            messages: JsonModelMessage[];
+            tools: ToolSet;
+            model?: string;
+        };
+        output: JsonResponseMessage[];
+    };
+    taskEvent: {
+        input: TaskEvent;
+        output: void;
+    };
+    invokeTool: {
+        input: {
+            toolName: string;
+            input: unknown;
+        };
+        output: ToolResponse;
+    };
+};
+export declare const agentWorkflow: WorkflowFn<AgentWorkflowInput, ExitReason, AgentToolRegistry>;