agentx-sdk 0.1.0

package/dist/tools/builtin/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/tools/builtin/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,eAAe,GAAG,OAAO,CAAC;AAChC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,QAAQ;AAEpC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;CACjG,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mDAAmD;QAChE,UAAU,EAAE,UAAU;QACtB,aAAa,EAAE,IAAI,EAAE,gDAAgD;QACrE,SAAS,EAAE,eAAe;QAE1B,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,MAAmB;YACjD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAqC,CAAC;YACnE,MAAM,gBAAgB,GAAG,OAAO,IAAI,eAAe,CAAC;YAEpD,OAAO,IAAI,OAAO,CAAkD,CAAC,OAAO,EAAE,EAAE;gBAC9E,IAAI,CAAC,OAAO,EAAE;oBACZ,OAAO,EAAE,gBAAgB;oBACzB,SAAS,EAAE,UAAU;oBACrB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS;oBACrC,MAAM;iBACP,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBAC3B,MAAM,GAAG,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;oBAC/C,MAAM,GAAG,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;oBAE/C,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;wBACzC,MAAM,KAAK,GAAa,EAAE,CAAC;wBAC3B,IAAI,GAAG;4BAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACzB,IAAI,GAAG;4BAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACzB,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;4BAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBAC5C,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC;wBAEvC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;wBACtD,OAAO;oBACT,CAAC;oBAED,MAAM,KAAK,GAAa,EAAE,CAAC;oBAC3B,IAAI,GAAG;wBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACzB,IAAI,GAAG;wBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;oBACxC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;wBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBAE5C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5B,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/file-edit.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export declare function createFileEditTool(): AgentTool;
+//# sourceMappingURL=file-edit.d.ts.map

package/dist/tools/builtin/file-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/file-edit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AASxE,wBAAgB,kBAAkB,IAAI,SAAS,CA6C9C"}

package/dist/tools/builtin/file-edit.js

@@ -0,0 +1,50 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { z } from 'zod';
+const FileEditParams = z.object({
+    file_path: z.string().describe('Absolute path to the file to edit'),
+    old_string: z.string().describe('Exact string to find and replace'),
+    new_string: z.string().describe('Replacement string'),
+    replace_all: z.boolean().optional().describe('Replace all occurrences. Default: false (must be unique).'),
+});
+export function createFileEditTool() {
+    return {
+        name: 'Edit',
+        description: 'Find and replace exact strings in a file. By default, old_string must be unique in the file.',
+        parameters: FileEditParams,
+        getFilePath: (args) => args.file_path,
+        async execute(rawArgs) {
+            const { file_path, old_string, new_string, replace_all } = rawArgs;
+            let content;
+            try {
+                content = await readFile(file_path, 'utf-8');
+            }
+            catch (error) {
+                return { content: `Cannot read file: ${file_path} — ${error.message}`, isError: true };
+            }
+            if (!content.includes(old_string)) {
+                return { content: `old_string not found in ${file_path}. Make sure it matches exactly.`, isError: true };
+            }
+            if (!replace_all) {
+                const count = content.split(old_string).length - 1;
+                if (count > 1) {
+                    return {
+                        content: `old_string found ${count} multiple times in ${file_path}. Use replace_all: true or provide more context to make it unique.`,
+                        isError: true,
+                    };
+                }
+            }
+            const updated = replace_all
+                ? content.split(old_string).join(new_string)
+                : content.replace(old_string, new_string);
+            try {
+                await writeFile(file_path, updated, 'utf-8');
+            }
+            catch (error) {
+                return { content: `Cannot write file: ${file_path} — ${error.message}`, isError: true };
+            }
+            const replacements = replace_all ? content.split(old_string).length - 1 : 1;
+            return `Successfully edited ${file_path} (${replacements} replacement${replacements > 1 ? 's' : ''})`;
+        },
+    };
+}
+//# sourceMappingURL=file-edit.js.map

package/dist/tools/builtin/file-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.js","sourceRoot":"","sources":["../../../src/tools/builtin/file-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACnE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACnE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACrD,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;CAC1G,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,8FAA8F;QAC3G,UAAU,EAAE,cAAc;QAC1B,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAE,IAA8B,CAAC,SAAS;QAEhE,KAAK,CAAC,OAAO,CAAC,OAAgB;YAC5B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAyC,CAAC;YAErG,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,qBAAqB,SAAS,MAAO,KAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACpG,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,OAAO,EAAE,OAAO,EAAE,2BAA2B,SAAS,iCAAiC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3G,CAAC;YAED,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACd,OAAO;wBACL,OAAO,EAAE,oBAAoB,KAAK,sBAAsB,SAAS,oEAAoE;wBACrI,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,WAAW;gBACzB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;gBAC5C,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,sBAAsB,SAAS,MAAO,KAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACrG,CAAC;YAED,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5E,OAAO,uBAAuB,SAAS,KAAK,YAAY,eAAe,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QACxG,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/file-read.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export declare function createFileReadTool(): AgentTool;
+//# sourceMappingURL=file-read.d.ts.map

package/dist/tools/builtin/file-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/file-read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAWxE,wBAAgB,kBAAkB,IAAI,SAAS,CA0C9C"}

package/dist/tools/builtin/file-read.js

@@ -0,0 +1,47 @@
+import { readFile, stat } from 'node:fs/promises';
+import { z } from 'zod';
+const MAX_FILE_SIZE = 1_000_000; // 1MB
+const DEFAULT_LIMIT = 2000;
+const FileReadParams = z.object({
+    file_path: z.string().describe('Absolute path to the file to read'),
+    offset: z.number().optional().describe('Line number to start reading from (1-based)'),
+    limit: z.number().optional().describe('Number of lines to read. Default: 2000'),
+});
+export function createFileReadTool() {
+    return {
+        name: 'Read',
+        description: 'Read file contents with line numbers. Supports partial reads with offset and limit.',
+        parameters: FileReadParams,
+        isConcurrencySafe: true,
+        isReadOnly: true,
+        getFilePath: (args) => args.file_path,
+        async execute(rawArgs) {
+            const { file_path, offset, limit } = rawArgs;
+            try {
+                const fileStat = await stat(file_path);
+                if (fileStat.size > MAX_FILE_SIZE) {
+                    return { content: `File too large (${fileStat.size} bytes). Use offset/limit to read portions.`, isError: true };
+                }
+                const content = await readFile(file_path, 'utf-8');
+                const allLines = content.split('\n');
+                const startLine = Math.max(1, offset ?? 1);
+                const lineLimit = limit ?? DEFAULT_LIMIT;
+                const endLine = Math.min(allLines.length, startLine + lineLimit - 1);
+                const numbered = allLines
+                    .slice(startLine - 1, endLine)
+                    .map((line, i) => `${String(startLine + i).padStart(6)}\t${line}`)
+                    .join('\n');
+                const total = allLines.length;
+                const showing = endLine - startLine + 1;
+                const header = showing < total
+                    ? `Showing lines ${startLine}-${endLine} of ${total}:\n`
+                    : '';
+                return `${header}${numbered}`;
+            }
+            catch (error) {
+                return { content: `Cannot read file: ${file_path} — ${error.message}`, isError: true };
+            }
+        },
+    };
+}
+//# sourceMappingURL=file-read.js.map

package/dist/tools/builtin/file-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.js","sourceRoot":"","sources":["../../../src/tools/builtin/file-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,MAAM;AACvC,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACrF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,qFAAqF;QAClG,UAAU,EAAE,cAAc;QAC1B,iBAAiB,EAAE,IAAI;QACvB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAE,IAA8B,CAAC,SAAS;QAEhE,KAAK,CAAC,OAAO,CAAC,OAAgB;YAC5B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAyC,CAAC;YAE/E,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvC,IAAI,QAAQ,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;oBAClC,OAAO,EAAE,OAAO,EAAE,mBAAmB,QAAQ,CAAC,IAAI,6CAA6C,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACnH,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAErC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;gBAC3C,MAAM,SAAS,GAAG,KAAK,IAAI,aAAa,CAAC;gBACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;gBAErE,MAAM,QAAQ,GAAG,QAAQ;qBACtB,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC;qBAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;qBACjE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;gBAC9B,MAAM,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC;gBACxC,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK;oBAC5B,CAAC,CAAC,iBAAiB,SAAS,IAAI,OAAO,OAAO,KAAK,KAAK;oBACxD,CAAC,CAAC,EAAE,CAAC;gBAEP,OAAO,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,qBAAqB,SAAS,MAAO,KAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACpG,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/file-write.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export declare function createFileWriteTool(): AgentTool;
+//# sourceMappingURL=file-write.d.ts.map

package/dist/tools/builtin/file-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/file-write.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAOxE,wBAAgB,mBAAmB,IAAI,SAAS,CAqB/C"}

package/dist/tools/builtin/file-write.js

@@ -0,0 +1,29 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { z } from 'zod';
+const FileWriteParams = z.object({
+    file_path: z.string().describe('Absolute path to the file to write'),
+    content: z.string().describe('Content to write to the file'),
+});
+export function createFileWriteTool() {
+    return {
+        name: 'Write',
+        description: 'Write content to a file. Creates parent directories if needed. Overwrites existing files.',
+        parameters: FileWriteParams,
+        isDestructive: true,
+        getFilePath: (args) => args.file_path,
+        async execute(rawArgs) {
+            const { file_path, content } = rawArgs;
+            try {
+                await mkdir(dirname(file_path), { recursive: true });
+                await writeFile(file_path, content, 'utf-8');
+                const bytes = Buffer.byteLength(content, 'utf-8');
+                return `Successfully wrote ${bytes} bytes to ${file_path}`;
+            }
+            catch (error) {
+                return { content: `Cannot write file: ${file_path} — ${error.message}`, isError: true };
+            }
+        },
+    };
+}
+//# sourceMappingURL=file-write.js.map

package/dist/tools/builtin/file-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.js","sourceRoot":"","sources":["../../../src/tools/builtin/file-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2FAA2F;QACxG,UAAU,EAAE,eAAe;QAC3B,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAE,IAA8B,CAAC,SAAS;QAEhE,KAAK,CAAC,OAAO,CAAC,OAAgB;YAC5B,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAA0C,CAAC;YAE1E,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrD,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAClD,OAAO,sBAAsB,KAAK,aAAa,SAAS,EAAE,CAAC;YAC7D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,sBAAsB,SAAS,MAAO,KAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACrG,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/glob.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export declare function createGlobTool(): AgentTool;
+//# sourceMappingURL=glob.d.ts.map

package/dist/tools/builtin/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/glob.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAuBxE,wBAAgB,cAAc,IAAI,SAAS,CAiD1C"}

package/dist/tools/builtin/glob.js

@@ -0,0 +1,67 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { matchGlob } from '../../skills/skill-glob.js';
+const MAX_RESULTS = 100;
+const GlobParams = z.object({
+    pattern: z.string().describe('Glob pattern to match (e.g. "**/*.ts", "src/*.js")'),
+    path: z.string().optional().describe('Directory to search in. Defaults to cwd.'),
+});
+async function walkDir(dir, results) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walkDir(full, results);
+        }
+        else {
+            results.push(full);
+        }
+    }
+}
+export function createGlobTool() {
+    return {
+        name: 'Glob',
+        description: 'Fast file pattern matching. Returns matching file paths sorted by modification time.',
+        parameters: GlobParams,
+        isConcurrencySafe: true,
+        isReadOnly: true,
+        async execute(rawArgs, _signal) {
+            const { pattern, path: searchPath } = rawArgs;
+            const baseDir = searchPath || process.cwd();
+            const allFiles = [];
+            try {
+                await walkDir(baseDir, allFiles);
+            }
+            catch {
+                return { content: `Cannot read directory: ${baseDir}`, isError: true };
+            }
+            // Match against pattern (relative paths)
+            const matched = allFiles.filter(f => {
+                const relative = f.slice(baseDir.length + 1);
+                return matchGlob(pattern, relative);
+            });
+            if (matched.length === 0) {
+                return `No files found matching "${pattern}" in ${baseDir}`;
+            }
+            // Sort by mtime (newest first)
+            const withStats = await Promise.all(matched.slice(0, MAX_RESULTS * 2).map(async (f) => {
+                try {
+                    const s = await stat(f);
+                    return { path: f, mtimeMs: s.mtimeMs };
+                }
+                catch {
+                    return { path: f, mtimeMs: 0 };
+                }
+            }));
+            withStats.sort((a, b) => b.mtimeMs - a.mtimeMs);
+            const limited = withStats.slice(0, MAX_RESULTS);
+            const lines = limited.map(f => f.path);
+            const truncated = matched.length > MAX_RESULTS;
+            return lines.join('\n') + (truncated ? `\n\n[${matched.length - MAX_RESULTS} more files not shown]` : '');
+        },
+    };
+}
+//# sourceMappingURL=glob.js.map

package/dist/tools/builtin/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../src/tools/builtin/glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IAClF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACjF,CAAC,CAAC;AAEH,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,OAAiB;IACnD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,sFAAsF;QACnG,UAAU,EAAE,UAAU;QACtB,iBAAiB,EAAE,IAAI;QACvB,UAAU,EAAE,IAAI;QAEhB,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,OAAoB;YAClD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAqC,CAAC;YAC5E,MAAM,OAAO,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAE5C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,OAAO,EAAE,0BAA0B,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACzE,CAAC;YAED,yCAAyC;YACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAClC,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC7C,OAAO,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,4BAA4B,OAAO,QAAQ,OAAO,EAAE,CAAC;YAC9D,CAAC;YAED,+BAA+B;YAC/B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAC,CAAC,EAAC,EAAE;gBAC9C,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;oBACxB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;gBACzC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gBACjC,CAAC;YACH,CAAC,CAAC,CACH,CAAC;YACF,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;YAEhD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;YAE/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,MAAM,GAAG,WAAW,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5G,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/grep.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export declare function createGrepTool(): AgentTool;
+//# sourceMappingURL=grep.d.ts.map

package/dist/tools/builtin/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/grep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAmCxE,wBAAgB,cAAc,IAAI,SAAS,CAsD1C"}

package/dist/tools/builtin/grep.js

@@ -0,0 +1,94 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { matchGlob } from '../../skills/skill-glob.js';
+const DEFAULT_MAX_RESULTS = 50;
+const GrepParams = z.object({
+    pattern: z.string().describe('Regex pattern to search for'),
+    path: z.string().optional().describe('Directory to search in. Defaults to cwd.'),
+    glob: z.string().optional().describe('Glob pattern to filter files (e.g. "*.ts")'),
+    max_results: z.number().optional().describe('Max matching lines to return. Default: 50.'),
+});
+async function collectFiles(dir, globPattern) {
+    const results = [];
+    async function walk(d) {
+        let entries;
+        try {
+            entries = await readdir(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            const full = join(d, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+            }
+            else {
+                if (globPattern) {
+                    const relative = full.slice(dir.length + 1);
+                    if (!matchGlob(globPattern, relative) && !matchGlob(globPattern, entry.name))
+                        continue;
+                }
+                results.push(full);
+            }
+        }
+    }
+    await walk(dir);
+    return results;
+}
+export function createGrepTool() {
+    return {
+        name: 'Grep',
+        description: 'Search file contents using regex. Returns matching lines with file paths and line numbers.',
+        parameters: GrepParams,
+        isConcurrencySafe: true,
+        isReadOnly: true,
+        async execute(rawArgs, signal) {
+            const { pattern, path: searchPath, glob: globFilter, max_results } = rawArgs;
+            const baseDir = searchPath || process.cwd();
+            const maxResults = max_results ?? DEFAULT_MAX_RESULTS;
+            let regex;
+            try {
+                regex = new RegExp(pattern, 'g');
+            }
+            catch (e) {
+                return { content: `Invalid regex: ${String(e)}`, isError: true };
+            }
+            const files = await collectFiles(baseDir, globFilter);
+            const matches = [];
+            for (const file of files) {
+                if (matches.length >= maxResults)
+                    break;
+                if (signal.aborted)
+                    break;
+                try {
+                    const s = await stat(file);
+                    if (s.size > 1_000_000)
+                        continue; // skip files > 1MB
+                    const content = await readFile(file, 'utf-8');
+                    const lines = content.split('\n');
+                    for (let i = 0; i < lines.length; i++) {
+                        if (matches.length >= maxResults)
+                            break;
+                        regex.lastIndex = 0;
+                        if (regex.test(lines[i])) {
+                            const relative = file.slice(baseDir.length + 1) || file;
+                            matches.push(`${relative}:${i + 1}:${lines[i]}`);
+                        }
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+            if (matches.length === 0) {
+                return `No matches found for "${pattern}" in ${baseDir}`;
+            }
+            return matches.join('\n');
+        },
+    };
+}
+//# sourceMappingURL=grep.js.map

package/dist/tools/builtin/grep.js.map

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

package/dist/tools/builtin/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Builtin tools — opt-in tools that ship with the SDK.
+ *
+ * Usage:
+ *   import { builtinTools } from 'agentx-sdk';
+ *   agent.addTool(builtinTools.fileRead());
+ *   // or: builtinTools.all().forEach(t => agent.addTool(t));
+ */
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+import { createGlobTool } from './glob.js';
+import { createGrepTool } from './grep.js';
+import { createFileReadTool } from './file-read.js';
+import { createFileWriteTool } from './file-write.js';
+import { createFileEditTool } from './file-edit.js';
+import { createBashTool } from './bash.js';
+import { createWebFetchTool } from './web-fetch.js';
+import { createAskUserTool } from './ask-user.js';
+export declare const builtinTools: {
+    /** File pattern search (**, *, ?) */
+    glob: typeof createGlobTool;
+    /** Content search via regex */
+    grep: typeof createGrepTool;
+    /** Read file contents with line numbers */
+    fileRead: typeof createFileReadTool;
+    /** Write/create files */
+    fileWrite: typeof createFileWriteTool;
+    /** Find/replace edit in files */
+    fileEdit: typeof createFileEditTool;
+    /** Shell command execution */
+    bash: typeof createBashTool;
+    /** Fetch URL content */
+    webFetch: typeof createWebFetchTool;
+    /** Ask user a question (requires callback) */
+    askUser: typeof createAskUserTool;
+    /** All tools except askUser (which needs a callback) */
+    all(): AgentTool[];
+    /** File operation tools: read + write + edit + glob + grep */
+    fileOps(): AgentTool[];
+};
+export { createGlobTool } from './glob.js';
+export { createGrepTool } from './grep.js';
+export { createFileReadTool } from './file-read.js';
+export { createFileWriteTool } from './file-write.js';
+export { createFileEditTool } from './file-edit.js';
+export { createBashTool } from './bash.js';
+export { createWebFetchTool } from './web-fetch.js';
+export { createAskUserTool } from './ask-user.js';
+export type { AskUserOptions } from './ask-user.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAA0C,MAAM,eAAe,CAAC;AAE1F,eAAO,MAAM,YAAY;IACvB,qCAAqC;;IAErC,+BAA+B;;IAE/B,2CAA2C;;IAE3C,yBAAyB;;IAEzB,iCAAiC;;IAEjC,8BAA8B;;IAE9B,wBAAwB;;IAExB,8CAA8C;;IAG9C,wDAAwD;WACjD,SAAS,EAAE;IAYlB,8DAA8D;eACnD,SAAS,EAAE;CASvB,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/builtin/index.js

@@ -0,0 +1,65 @@
+/**
+ * Builtin tools — opt-in tools that ship with the SDK.
+ *
+ * Usage:
+ *   import { builtinTools } from 'agentx-sdk';
+ *   agent.addTool(builtinTools.fileRead());
+ *   // or: builtinTools.all().forEach(t => agent.addTool(t));
+ */
+import { createGlobTool } from './glob.js';
+import { createGrepTool } from './grep.js';
+import { createFileReadTool } from './file-read.js';
+import { createFileWriteTool } from './file-write.js';
+import { createFileEditTool } from './file-edit.js';
+import { createBashTool } from './bash.js';
+import { createWebFetchTool } from './web-fetch.js';
+import { createAskUserTool } from './ask-user.js';
+export const builtinTools = {
+    /** File pattern search (**, *, ?) */
+    glob: createGlobTool,
+    /** Content search via regex */
+    grep: createGrepTool,
+    /** Read file contents with line numbers */
+    fileRead: createFileReadTool,
+    /** Write/create files */
+    fileWrite: createFileWriteTool,
+    /** Find/replace edit in files */
+    fileEdit: createFileEditTool,
+    /** Shell command execution */
+    bash: createBashTool,
+    /** Fetch URL content */
+    webFetch: createWebFetchTool,
+    /** Ask user a question (requires callback) */
+    askUser: createAskUserTool,
+    /** All tools except askUser (which needs a callback) */
+    all() {
+        return [
+            createGlobTool(),
+            createGrepTool(),
+            createFileReadTool(),
+            createFileWriteTool(),
+            createFileEditTool(),
+            createBashTool(),
+            createWebFetchTool(),
+        ];
+    },
+    /** File operation tools: read + write + edit + glob + grep */
+    fileOps() {
+        return [
+            createFileReadTool(),
+            createFileWriteTool(),
+            createFileEditTool(),
+            createGlobTool(),
+            createGrepTool(),
+        ];
+    },
+};
+export { createGlobTool } from './glob.js';
+export { createGrepTool } from './grep.js';
+export { createFileReadTool } from './file-read.js';
+export { createFileWriteTool } from './file-write.js';
+export { createFileEditTool } from './file-edit.js';
+export { createBashTool } from './bash.js';
+export { createWebFetchTool } from './web-fetch.js';
+export { createAskUserTool } from './ask-user.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAA0C,MAAM,eAAe,CAAC;AAE1F,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,qCAAqC;IACrC,IAAI,EAAE,cAAc;IACpB,+BAA+B;IAC/B,IAAI,EAAE,cAAc;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,kBAAkB;IAC5B,yBAAyB;IACzB,SAAS,EAAE,mBAAmB;IAC9B,iCAAiC;IACjC,QAAQ,EAAE,kBAAkB;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,cAAc;IACpB,wBAAwB;IACxB,QAAQ,EAAE,kBAAkB;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,iBAAiB;IAE1B,wDAAwD;IACxD,GAAG;QACD,OAAO;YACL,cAAc,EAAE;YAChB,cAAc,EAAE;YAChB,kBAAkB,EAAE;YACpB,mBAAmB,EAAE;YACrB,kBAAkB,EAAE;YACpB,cAAc,EAAE;YAChB,kBAAkB,EAAE;SACrB,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,OAAO;QACL,OAAO;YACL,kBAAkB,EAAE;YACpB,mBAAmB,EAAE;YACrB,kBAAkB,EAAE;YACpB,cAAc,EAAE;YAChB,cAAc,EAAE;SACjB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/builtin/web-fetch.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export declare function createWebFetchTool(): AgentTool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/builtin/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/web-fetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAwBxE,wBAAgB,kBAAkB,IAAI,SAAS,CAwC9C"}

package/dist/tools/builtin/web-fetch.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+const DEFAULT_MAX_CHARS = 50_000;
+const WebFetchParams = z.object({
+    url: z.string().describe('URL to fetch'),
+    max_chars: z.number().optional().describe('Max characters to return. Default: 50000.'),
+});
+/** Strip HTML tags and collapse whitespace. */
+function stripHtml(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[\s\S]*?<\/style>/gi, '')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export function createWebFetchTool() {
+    return {
+        name: 'WebFetch',
+        description: 'Fetch content from a URL. Returns text content (HTML is stripped to plain text).',
+        parameters: WebFetchParams,
+        isConcurrencySafe: true,
+        isReadOnly: true,
+        async execute(rawArgs, signal) {
+            const { url, max_chars } = rawArgs;
+            const maxChars = max_chars ?? DEFAULT_MAX_CHARS;
+            try {
+                const response = await fetch(url, {
+                    signal,
+                    headers: { 'User-Agent': 'AgentX-SDK/1.0' },
+                    redirect: 'follow',
+                });
+                if (!response.ok) {
+                    return { content: `HTTP ${response.status}: ${response.statusText}`, isError: true };
+                }
+                const contentType = response.headers.get('content-type') ?? '';
+                let text = await response.text();
+                if (contentType.includes('text/html')) {
+                    text = stripHtml(text);
+                }
+                if (text.length > maxChars) {
+                    text = text.slice(0, maxChars) + `\n\n[truncated — ${text.length - maxChars} characters omitted]`;
+                }
+                return text || '(empty response)';
+            }
+            catch (error) {
+                return { content: `Fetch failed: ${error.message}`, isError: true };
+            }
+        },
+    };
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/builtin/web-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.js","sourceRoot":"","sources":["../../../src/tools/builtin/web-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACvF,CAAC,CAAC;AAEH,+CAA+C;AAC/C,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI;SACR,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;SAC1C,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;SACxC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,kFAAkF;QAC/F,UAAU,EAAE,cAAc;QAC1B,iBAAiB,EAAE,IAAI;QACvB,UAAU,EAAE,IAAI;QAEhB,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,MAAmB;YACjD,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAyC,CAAC;YACrE,MAAM,QAAQ,GAAG,SAAS,IAAI,iBAAiB,CAAC;YAEhD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAChC,MAAM;oBACN,OAAO,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE;oBAC3C,QAAQ,EAAE,QAAQ;iBACnB,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,OAAO,EAAE,OAAO,EAAE,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACvF,CAAC;gBAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBAC/D,IAAI,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAEjC,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBACtC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC;gBAED,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,oBAAoB,IAAI,CAAC,MAAM,GAAG,QAAQ,sBAAsB,CAAC;gBACpG,CAAC;gBAED,OAAO,IAAI,IAAI,kBAAkB,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,iBAAkB,KAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACjF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/json-schema-to-zod.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Deep JSON Schema → Zod converter.
+ *
+ * Converts JSON Schema objects (as returned by MCP servers) to Zod schemas
+ * for validation in the ToolExecutor pipeline.
+ *
+ * Supports: primitives, nested objects, arrays, enums, anyOf/oneOf,
+ * nullable, descriptions, required fields. Max recursion depth: 10.
+ */
+import { z } from 'zod';
+type JsonSchema = {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    nullable?: boolean;
+    description?: string;
+    default?: unknown;
+    [key: string]: unknown;
+};
+/**
+ * Convert a JSON Schema to a Zod schema.
+ * Returns `z.object({}).passthrough()` for undefined/empty input.
+ */
+export declare function jsonSchemaToZod(schema?: JsonSchema | null, depth?: number): z.ZodTypeAny;
+export {};
+//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/tools/json-schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.d.ts","sourceRoot":"","sources":["../../src/tools/json-schema-to-zod.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,KAAK,SAAI,GAAG,CAAC,CAAC,UAAU,CA2DnF"}