agentool 1.1.0 → 1.1.1

package/dist/{chunk-I6KFFQPV.cjs → chunk-5T3SQYI4.cjs}

@@ -1,9 +1,38 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/http-request/index.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/http-request/index.ts
 var _ai = require('ai');
 var _zod = require('zod');
+
+// src/http-request/prompt.ts
+function getPrompt(config = {}) {
+  const timeout = _nullishCoalesce(config.timeout, () => ( 3e4));
+  return `Make an HTTP request to a URL. Returns the raw response status, headers, and body as JSON.
+
+Supports GET, POST, PUT, PATCH, DELETE, and HEAD methods.
+
+## When to Use
+- For API interactions: REST calls, webhook triggers, service health checks
+- When you need full control over HTTP method, headers, and request body
+- When you need the raw response (status codes, headers) not just content
+
+## When NOT to Use
+- To read a web page for its content \u2014 use the web fetch tool instead (it converts HTML to markdown)
+- To search the web \u2014 use the web search tool instead
+
+## Usage Guidelines
+- Default timeout: ${timeout}ms. Override with the timeout parameter.
+- Request body is sent for POST, PUT, and PATCH methods
+- Response is returned as JSON with status, statusText, headers, and body fields
+- Default headers from config are merged with per-request headers (per-request takes precedence)`;
+}
+
+// src/http-request/index.ts
 function createHttpRequest(config = {}) {
   return _ai.tool.call(void 0, {
-    description: "Make an HTTP request to a URL. Returns the response status, headers, and body. Use this for API interactions, webhook calls, and service health checks. Unlike web-fetch, this returns raw response data without markdown conversion.",
+    description: _nullishCoalesce(config.description, () => ( getPrompt(config))),
     inputSchema: _zod.z.object({
       method: _zod.z.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"]).describe("HTTP method"),
       url: _zod.z.string().describe("The URL to send the request to"),
@@ -44,7 +73,7 @@ function createHttpRequest(config = {}) {
         if (error instanceof Error && error.name === "AbortError") {
           return `Error [http-request]: Request timed out after ${effectiveTimeout}ms for ${method} ${url}. Try increasing the timeout or verify the server is responsive.`;
         }
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
         return `Error [http-request]: ${method} ${url} failed: ${msg}. Verify the URL is correct and the server is reachable.`;
       }
     }
@@ -55,4 +84,5 @@ var httpRequest = createHttpRequest();
 
 
 
-exports.createHttpRequest = createHttpRequest; exports.httpRequest = httpRequest;
+
+exports.getPrompt = getPrompt; exports.createHttpRequest = createHttpRequest; exports.httpRequest = httpRequest;

package/dist/chunk-6ULQG2W2.cjs

@@ -0,0 +1,99 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+
+
+var _chunkYTPZHJDCcjs = require('./chunk-YTPZHJDC.cjs');
+
+
+
+var _chunkBIAODQ2Pcjs = require('./chunk-BIAODQ2P.cjs');
+
+
+var _chunkQZ5GS6HWcjs = require('./chunk-QZ5GS6HW.cjs');
+
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/edit/index.ts
+var _ai = require('ai');
+var _zod = require('zod');
+
+// src/edit/prompt.ts
+function getPrompt() {
+  return `Perform an exact string replacement in a file. Locates old_string and replaces it with new_string.
+
+Supports absolute paths, relative paths, and tilde (~) expansion. Includes curly-quote fallback matching and quote-style preservation.
+
+## When to Use
+- To make targeted changes to existing files
+- To rename variables, update configuration values, or fix bugs
+- Prefer this over the file writing tool for modifying existing files \u2014 it only changes what you specify
+
+## When NOT to Use
+- To create a new file from scratch \u2014 use the file writing tool instead
+- To make many changes at once \u2014 consider the multi-edit tool for batch operations
+
+## Usage Guidelines
+- The edit will fail if \`old_string\` is not found in the file
+- When \`replace_all\` is false (default), \`old_string\` must appear exactly once in the file. If it appears multiple times, provide more surrounding context to make it unique, or set \`replace_all: true\`
+- Use \`replace_all: true\` for renaming a variable or string across the entire file
+- Preserve exact indentation (tabs/spaces) from the original file in both old_string and new_string
+- old_string and new_string must be different`;
+}
+
+// src/edit/index.ts
+function createEdit(config = {}) {
+  return _ai.tool.call(void 0, {
+    description: _nullishCoalesce(config.description, () => ( getPrompt())),
+    inputSchema: _zod.z.object({
+      file_path: _zod.z.string().describe("The absolute path to the file to modify"),
+      old_string: _zod.z.string().describe("The exact string to find and replace"),
+      new_string: _zod.z.string().describe("The replacement string"),
+      replace_all: _zod.z.boolean().default(false).optional().describe("Replace all occurrences (default: false)")
+    }),
+    execute: async ({ file_path, old_string, new_string, replace_all }) => {
+      try {
+        const resolved = _chunkQZ5GS6HWcjs.expandPath.call(void 0, file_path, config.cwd);
+        let content;
+        try {
+          content = await _chunkBIAODQ2Pcjs.readTextContent.call(void 0, resolved);
+        } catch (err) {
+          const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, err);
+          return `Error [edit]: Cannot read file "${resolved}": ${msg}`;
+        }
+        if (old_string === new_string) {
+          return "Error [edit]: old_string and new_string are identical \u2014 nothing to change.";
+        }
+        const actualOld = _chunkYTPZHJDCcjs.findActualString.call(void 0, content, old_string);
+        if (actualOld === null) {
+          const preview = content.slice(0, 200);
+          return `Error [edit]: old_string not found in "${resolved}". File starts with:
+${preview}`;
+        }
+        if (!replace_all) {
+          const count = _chunkYTPZHJDCcjs.countOccurrences.call(void 0, content, actualOld);
+          if (count > 1) {
+            return `Error [edit]: old_string appears ${count} times in "${resolved}". Use replace_all to replace every occurrence, or provide a more specific string.`;
+          }
+        }
+        const styledNew = _chunkYTPZHJDCcjs.preserveQuoteStyle.call(void 0, old_string, actualOld, new_string);
+        const updated = _chunkYTPZHJDCcjs.applyEditToFile.call(void 0, content, actualOld, styledNew, replace_all);
+        await _chunkBIAODQ2Pcjs.writeTextContent.call(void 0, resolved, updated);
+        const snippet = styledNew.length > 0 ? styledNew.slice(0, 200) : "(deletion)";
+        return `Successfully edited "${resolved}". Replacement snippet:
+${snippet}`;
+      } catch (error) {
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
+        return `Error [edit]: ${msg}`;
+      }
+    }
+  });
+}
+var edit = createEdit();
+
+
+
+
+
+exports.getPrompt = getPrompt; exports.createEdit = createEdit; exports.edit = edit;

package/dist/chunk-ABXTBB2N.cjs

@@ -0,0 +1,67 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+var _chunkBIAODQ2Pcjs = require('./chunk-BIAODQ2P.cjs');
+
+
+var _chunkQZ5GS6HWcjs = require('./chunk-QZ5GS6HW.cjs');
+
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/write/index.ts
+var _ai = require('ai');
+var _zod = require('zod');
+
+// src/write/prompt.ts
+function getPrompt() {
+  return `Write text content to a file, creating parent directories as needed. If the file already exists it is overwritten entirely.
+
+Supports absolute paths, relative paths, and tilde (~) expansion.
+
+## When to Use
+- To create new files that don't exist yet
+- To completely rewrite an existing file's content
+- When the changes are so extensive that targeted editing would be impractical
+
+## When NOT to Use
+- To make small, targeted changes to an existing file \u2014 use the file editing tool instead (it only changes what you specify and is less error-prone)
+- Prefer the editing tool for modifications; reserve this tool for creating new files or complete rewrites
+
+## Usage Guidelines
+- This tool overwrites the entire file \u2014 make sure you include all desired content, not just the changes
+- Parent directories are created automatically if they don't exist
+- Read the existing file first before overwriting it, so you don't accidentally lose content`;
+}
+
+// src/write/index.ts
+function createWrite(config = {}) {
+  const cwd = _nullishCoalesce(config.cwd, () => ( process.cwd()));
+  return _ai.tool.call(void 0, {
+    description: _nullishCoalesce(config.description, () => ( getPrompt())),
+    inputSchema: _zod.z.object({
+      file_path: _zod.z.string().describe("The absolute path to the file to write (must be absolute, not relative)"),
+      content: _zod.z.string().describe("Text content to write to the file")
+    }),
+    execute: async ({ file_path, content }) => {
+      try {
+        const absolutePath = _chunkQZ5GS6HWcjs.expandPath.call(void 0, file_path, cwd);
+        const existed = await _chunkBIAODQ2Pcjs.pathExists.call(void 0, absolutePath);
+        await _chunkBIAODQ2Pcjs.writeTextContent.call(void 0, absolutePath, content);
+        const bytes = Buffer.byteLength(content, "utf-8");
+        const verb = existed ? "Updated" : "Created";
+        return `${verb} file: ${absolutePath} (${bytes} bytes)`;
+      } catch (error) {
+        const message = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
+        return `Error [write]: Failed to write file: ${message}`;
+      }
+    }
+  });
+}
+var write = createWrite();
+
+
+
+
+
+exports.getPrompt = getPrompt; exports.createWrite = createWrite; exports.write = write;

package/dist/{chunk-CAEVLIQB.cjs → chunk-BIAODQ2P.cjs}

@@ -25,6 +25,18 @@ async function pathExists(path) {
     return false;
   }
 }
+async function readTextContent(filePath) {
+  return _promises.readFile.call(void 0, filePath, "utf-8");
+}
+async function listDirectory(dirPath) {
+  return _promises.readdir.call(void 0, dirPath);
+}
+async function removeFile(filePath) {
+  await _promises.unlink.call(void 0, filePath);
+}
+async function getFileStats(filePath) {
+  return _promises.stat.call(void 0, filePath);
+}
 async function readFileInRange(filePath, offset = 0, maxLines) {
   const stats = await _promises.stat.call(void 0, filePath);
   if (stats.isDirectory()) {
@@ -114,4 +126,8 @@ function readFileInRangeStreaming(filePath, offset, maxLines) {
 
 
 
-exports.addLineNumbers = addLineNumbers; exports.writeTextContent = writeTextContent; exports.pathExists = pathExists; exports.readFileInRange = readFileInRange;
+
+
+
+
+exports.addLineNumbers = addLineNumbers; exports.writeTextContent = writeTextContent; exports.pathExists = pathExists; exports.readTextContent = readTextContent; exports.listDirectory = listDirectory; exports.removeFile = removeFile; exports.getFileStats = getFileStats; exports.readFileInRange = readFileInRange;

package/dist/chunk-CJA76MKM.js

@@ -0,0 +1,59 @@
+import {
+  extractErrorMessage
+} from "./chunk-X6ZY2KFU.js";
+
+// src/web-search/index.ts
+import { tool } from "ai";
+import { z } from "zod";
+
+// src/web-search/prompt.ts
+function getPrompt() {
+  return `Search the web for information using a search query. Results can be filtered by allowed or blocked domains.
+
+Requires an onSearch callback to be configured \u2014 the application provides the actual search implementation.
+
+## When to Use
+- To find current information beyond the model's training data
+- To look up documentation, recent news, or real-time data
+- To verify facts or find authoritative sources
+
+## When NOT to Use
+- To read a specific URL whose address you already know \u2014 use the web fetch tool instead
+- To search file contents in the local codebase \u2014 use the dedicated content search tool instead
+
+## Usage Guidelines
+- After answering a question using search results, include a "Sources:" section listing the relevant URLs
+- Use the current year when searching for recent information or documentation
+- Use \`allowed_domains\` to restrict results to specific sites (e.g., ["docs.python.org"])
+- Use \`blocked_domains\` to exclude specific sites from results`;
+}
+
+// src/web-search/index.ts
+function createWebSearch(config = {}) {
+  return tool({
+    description: config.description ?? getPrompt(),
+    inputSchema: z.object({
+      query: z.string().min(2).describe("The search query to use"),
+      allowed_domains: z.array(z.string()).optional().describe("Only include search results from these domains"),
+      blocked_domains: z.array(z.string()).optional().describe("Never include search results from these domains")
+    }),
+    execute: async ({ query, allowed_domains, blocked_domains }) => {
+      try {
+        if (!config.onSearch) {
+          return "Error [web-search]: No search callback configured. Provide onSearch via createWebSearch({ onSearch: async (query, opts) => ... })";
+        }
+        return await config.onSearch(query, { allowed_domains, blocked_domains });
+      } catch (error) {
+        const msg = extractErrorMessage(error);
+        return `Error [web-search]: ${msg}`;
+      }
+    }
+  });
+}
+var webSearch = createWebSearch();
+
+export {
+  getPrompt,
+  createWebSearch,
+  webSearch
+};

package/dist/chunk-CM3VRCNX.cjs

@@ -0,0 +1,59 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/web-search/index.ts
+var _ai = require('ai');
+var _zod = require('zod');
+
+// src/web-search/prompt.ts
+function getPrompt() {
+  return `Search the web for information using a search query. Results can be filtered by allowed or blocked domains.
+
+Requires an onSearch callback to be configured \u2014 the application provides the actual search implementation.
+
+## When to Use
+- To find current information beyond the model's training data
+- To look up documentation, recent news, or real-time data
+- To verify facts or find authoritative sources
+
+## When NOT to Use
+- To read a specific URL whose address you already know \u2014 use the web fetch tool instead
+- To search file contents in the local codebase \u2014 use the dedicated content search tool instead
+
+## Usage Guidelines
+- After answering a question using search results, include a "Sources:" section listing the relevant URLs
+- Use the current year when searching for recent information or documentation
+- Use \`allowed_domains\` to restrict results to specific sites (e.g., ["docs.python.org"])
+- Use \`blocked_domains\` to exclude specific sites from results`;
+}
+
+// src/web-search/index.ts
+function createWebSearch(config = {}) {
+  return _ai.tool.call(void 0, {
+    description: _nullishCoalesce(config.description, () => ( getPrompt())),
+    inputSchema: _zod.z.object({
+      query: _zod.z.string().min(2).describe("The search query to use"),
+      allowed_domains: _zod.z.array(_zod.z.string()).optional().describe("Only include search results from these domains"),
+      blocked_domains: _zod.z.array(_zod.z.string()).optional().describe("Never include search results from these domains")
+    }),
+    execute: async ({ query, allowed_domains, blocked_domains }) => {
+      try {
+        if (!config.onSearch) {
+          return "Error [web-search]: No search callback configured. Provide onSearch via createWebSearch({ onSearch: async (query, opts) => ... })";
+        }
+        return await config.onSearch(query, { allowed_domains, blocked_domains });
+      } catch (error) {
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
+        return `Error [web-search]: ${msg}`;
+      }
+    }
+  });
+}
+var webSearch = createWebSearch();
+
+
+
+
+
+exports.getPrompt = getPrompt; exports.createWebSearch = createWebSearch; exports.webSearch = webSearch;

package/dist/{chunk-SUSAPI5W.cjs → chunk-CXBWF5ON.cjs}

@@ -1,4 +1,8 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/bash/index.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/bash/index.ts
 var _ai = require('ai');
 var _zod = require('zod');
 
@@ -103,12 +107,54 @@ async function executeShell(command, options) {
   });
 }
 
+// src/bash/prompt.ts
+function getPrompt(config = {}) {
+  const timeout = _nullishCoalesce(config.timeout, () => ( 12e4));
+  const timeoutMin = timeout / 6e4;
+  const shell = _nullishCoalesce(config.shell, () => ( "$SHELL or /bin/bash"));
+  return `Execute a shell command and return its output (stdout, stderr, exit code).
+
+Runs the command in ${shell} with \`-c\`. The working directory persists between calls.
+
+## When to Use
+- Build commands, git operations, system administration, installing packages
+- Running scripts, compiling code, process management
+- Any shell task that doesn't have a dedicated tool available
+
+## When NOT to Use
+- Reading file contents \u2014 use the dedicated file reading tool instead
+- Searching file contents \u2014 use the dedicated content search tool instead
+- Finding files by name/pattern \u2014 use the dedicated file search tool instead
+- Editing files \u2014 use the dedicated file editing tool instead
+- Writing new files \u2014 use the dedicated file writing tool instead
+Prefer dedicated tools over shell equivalents (e.g., don't use cat, head, tail, sed, awk, grep, find, or echo when a dedicated tool exists). Dedicated tools provide better output formatting and permission handling.
+
+## Usage Guidelines
+- Default timeout: ${timeout}ms (${timeoutMin} minutes). Override with the timeout parameter.
+- Timeout escalation: SIGTERM first, then SIGKILL after 5-second grace period.
+- Output is capped at 10 MB per stream (stdout/stderr).
+- Always quote file paths containing spaces with double quotes.
+- When issuing multiple commands:
+  - Independent commands: make separate tool calls in parallel.
+  - Sequential with dependency: chain with \`&&\`.
+  - Sequential ignoring failures: chain with \`;\`.
+  - Do NOT use newlines to separate commands.
+- Avoid unnecessary \`sleep\` commands:
+  - Don't sleep between commands that can run immediately.
+  - Don't retry failing commands in a sleep loop \u2014 diagnose the root cause.
+  - If you must sleep, keep it short (1-5 seconds).
+- For git commands:
+  - Prefer creating new commits rather than amending existing ones.
+  - Never skip hooks (--no-verify) unless the user explicitly requests it.
+  - Before destructive operations (reset --hard, push --force), consider safer alternatives.`;
+}
+
 // src/bash/index.ts
 function createBash(config = {}) {
   const cwd = _nullishCoalesce(config.cwd, () => ( process.cwd()));
   const timeout = _nullishCoalesce(config.timeout, () => ( 12e4));
   return _ai.tool.call(void 0, {
-    description: "Execute a shell command and return its output. Runs the command in a bash shell with the configured working directory. Returns stdout, stderr, and exit code. Use this for running build commands, git operations, system administration, and any other shell tasks.",
+    description: _nullishCoalesce(config.description, () => ( getPrompt(config))),
     inputSchema: _zod.z.object({
       command: _zod.z.string().describe("The shell command to execute"),
       timeout: _zod.z.number().optional().describe("Timeout in milliseconds (default: 120000)"),
@@ -128,7 +174,7 @@ ${result.stderr}`);
         if (result.exitCode !== 0) parts.push(`Exit code: ${result.exitCode}`);
         return parts.length > 0 ? parts.join("\n") : `Command completed with exit code ${result.exitCode}`;
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
         return `Error [bash]: Failed to execute command: ${msg}`;
       }
     }
@@ -139,4 +185,5 @@ var bash = createBash();
 
 
 
-exports.createBash = createBash; exports.bash = bash;
+
+exports.getPrompt = getPrompt; exports.createBash = createBash; exports.bash = bash;

package/dist/{chunk-5O55DKOB.cjs → chunk-G6ZVJA4V.cjs}

@@ -1,4 +1,8 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/web-fetch/index.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/web-fetch/index.ts
 var _ai = require('ai');
 var _zod = require('zod');
 
@@ -73,10 +77,31 @@ async function fetchUrl(url, options) {
   };
 }
 
+// src/web-fetch/prompt.ts
+function getPrompt(config = {}) {
+  const timeout = _nullishCoalesce(config.timeout, () => ( 3e4));
+  return `Fetch a URL and return its content. HTML pages are automatically converted to markdown for easier reading. JSON and other text content is returned as-is.
+
+## When to Use
+- To retrieve and read web page content, documentation, or articles
+- To fetch API responses, JSON data, or raw text from URLs
+- To check what a web page contains
+
+## When NOT to Use
+- For API interactions that need custom HTTP methods (POST, PUT, DELETE) \u2014 use the dedicated HTTP request tool instead
+- For searching the web \u2014 use the dedicated web search tool instead
+
+## Usage Guidelines
+- Content is truncated at 100,000 characters to manage context size
+- The URL must be a fully-formed valid URL (e.g., https://example.com)
+- Timeout: ${timeout}ms
+- This tool is read-only \u2014 it does not modify any files or state`;
+}
+
 // src/web-fetch/index.ts
 function createWebFetch(config = {}) {
   return _ai.tool.call(void 0, {
-    description: "Fetch a URL and return its content. HTML pages are automatically converted to markdown for easier reading. JSON and other text content is returned as-is. Content is truncated at 100,000 characters to manage context size.",
+    description: _nullishCoalesce(config.description, () => ( getPrompt(config))),
     inputSchema: _zod.z.object({
       url: _zod.z.string().url().describe("The URL to fetch")
     }),
@@ -98,7 +123,7 @@ function createWebFetch(config = {}) {
         parts.push(result.content);
         return parts.join("\n");
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
         return `Error [web-fetch]: Failed to fetch ${url}: ${msg}`;
       }
     }
@@ -109,4 +134,5 @@ var webFetch = createWebFetch();
 
 
 
-exports.createWebFetch = createWebFetch; exports.webFetch = webFetch;
+
+exports.getPrompt = getPrompt; exports.createWebFetch = createWebFetch; exports.webFetch = webFetch;

package/dist/{chunk-P6Z5XFDS.js → chunk-GPHCXS2S.js}

@@ -1,19 +1,51 @@
 import {
   applyEditToFile,
+  countOccurrences,
   findActualString,
   preserveQuoteStyle
-} from "./chunk-G3ITTPGX.js";
+} from "./chunk-4MXDQEPA.js";
+import {
+  readTextContent,
+  writeTextContent
+} from "./chunk-PWBVB6MN.js";
 import {
   expandPath
 } from "./chunk-I3ONDY7P.js";
+import {
+  extractErrorMessage
+} from "./chunk-X6ZY2KFU.js";
 
 // src/edit/index.ts
-import { readFile, writeFile } from "fs/promises";
 import { tool } from "ai";
 import { z } from "zod";
+
+// src/edit/prompt.ts
+function getPrompt() {
+  return `Perform an exact string replacement in a file. Locates old_string and replaces it with new_string.
+
+Supports absolute paths, relative paths, and tilde (~) expansion. Includes curly-quote fallback matching and quote-style preservation.
+
+## When to Use
+- To make targeted changes to existing files
+- To rename variables, update configuration values, or fix bugs
+- Prefer this over the file writing tool for modifying existing files \u2014 it only changes what you specify
+
+## When NOT to Use
+- To create a new file from scratch \u2014 use the file writing tool instead
+- To make many changes at once \u2014 consider the multi-edit tool for batch operations
+
+## Usage Guidelines
+- The edit will fail if \`old_string\` is not found in the file
+- When \`replace_all\` is false (default), \`old_string\` must appear exactly once in the file. If it appears multiple times, provide more surrounding context to make it unique, or set \`replace_all: true\`
+- Use \`replace_all: true\` for renaming a variable or string across the entire file
+- Preserve exact indentation (tabs/spaces) from the original file in both old_string and new_string
+- old_string and new_string must be different`;
+}
+
+// src/edit/index.ts
 function createEdit(config = {}) {
   return tool({
-    description: "Perform an exact string replacement in a file. Locates old_string in the file and replaces it with new_string. Supports curly-quote fallback matching. When replace_all is false (default), old_string must appear exactly once.",
+    description: config.description ?? getPrompt(),
     inputSchema: z.object({
       file_path: z.string().describe("The absolute path to the file to modify"),
       old_string: z.string().describe("The exact string to find and replace"),
@@ -25,9 +57,9 @@ function createEdit(config = {}) {
         const resolved = expandPath(file_path, config.cwd);
         let content;
         try {
-          content = await readFile(resolved, "utf-8");
+          content = await readTextContent(resolved);
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = extractErrorMessage(err);
           return `Error [edit]: Cannot read file "${resolved}": ${msg}`;
         }
         if (old_string === new_string) {
@@ -40,26 +72,19 @@ function createEdit(config = {}) {
 ${preview}`;
         }
         if (!replace_all) {
-          let count = 0;
-          let pos = 0;
-          while (pos < content.length) {
-            const idx = content.indexOf(actualOld, pos);
-            if (idx === -1) break;
-            count++;
-            pos = idx + 1;
-          }
+          const count = countOccurrences(content, actualOld);
           if (count > 1) {
             return `Error [edit]: old_string appears ${count} times in "${resolved}". Use replace_all to replace every occurrence, or provide a more specific string.`;
           }
         }
         const styledNew = preserveQuoteStyle(old_string, actualOld, new_string);
         const updated = applyEditToFile(content, actualOld, styledNew, replace_all);
-        await writeFile(resolved, updated, "utf-8");
+        await writeTextContent(resolved, updated);
         const snippet = styledNew.length > 0 ? styledNew.slice(0, 200) : "(deletion)";
         return `Successfully edited "${resolved}". Replacement snippet:
 ${snippet}`;
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = extractErrorMessage(error);
         return `Error [edit]: ${msg}`;
       }
     }
@@ -68,6 +93,7 @@ ${snippet}`;
 var edit = createEdit();
 
 export {
+  getPrompt,
   createEdit,
   edit
 };