agentool 1.0.0 → 1.1.1

package/dist/web-search/index.d.ts

@@ -0,0 +1,30 @@
+import * as ai from 'ai';
+
+/**
+ * Generate the description prompt for the web-search tool.
+ *
+ * @returns The full description string for the web-search tool.
+ */
+declare function getPrompt(): string;
+
+interface WebSearchConfig {
+    /** Callback to perform the actual search. Users provide their own implementation. */
+    onSearch?: (query: string, opts: {
+        allowed_domains?: string[];
+        blocked_domains?: string[];
+    }) => Promise<string>;
+    /** Override the default tool description. */
+    description?: string;
+}
+declare function createWebSearch(config?: WebSearchConfig): ai.Tool<{
+    query: string;
+    allowed_domains?: string[] | undefined;
+    blocked_domains?: string[] | undefined;
+}, string>;
+declare const webSearch: ai.Tool<{
+    query: string;
+    allowed_domains?: string[] | undefined;
+    blocked_domains?: string[] | undefined;
+}, string>;
+
+export { type WebSearchConfig, createWebSearch, webSearch, getPrompt as webSearchPrompt };

package/dist/web-search/index.js

@@ -0,0 +1,11 @@
+import {
+  createWebSearch,
+  getPrompt,
+  webSearch
+} from "../chunk-CJA76MKM.js";
+import "../chunk-X6ZY2KFU.js";
+export {
+  createWebSearch,
+  webSearch,
+  getPrompt as webSearchPrompt
+};

package/dist/write/index.cjs

@@ -1,10 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkJCTBB7H2cjs = require('../chunk-JCTBB7H2.cjs');
-require('../chunk-CAEVLIQB.cjs');
+
+var _chunkABXTBB2Ncjs = require('../chunk-ABXTBB2N.cjs');
+require('../chunk-BIAODQ2P.cjs');
 require('../chunk-QZ5GS6HW.cjs');
+require('../chunk-KONXT2SF.cjs');
+
 
 
 
-exports.createWrite = _chunkJCTBB7H2cjs.createWrite; exports.write = _chunkJCTBB7H2cjs.write;
+exports.createWrite = _chunkABXTBB2Ncjs.createWrite; exports.write = _chunkABXTBB2Ncjs.write; exports.writePrompt = _chunkABXTBB2Ncjs.getPrompt;

package/dist/write/index.d.cts

@@ -1,7 +1,17 @@
 import * as ai from 'ai';
 import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
 
-type WriteConfig = BaseToolConfig;
+/**
+ * Generate the description prompt for the write tool.
+ *
+ * @returns The full description string for the write tool.
+ */
+declare function getPrompt(): string;
+
+type WriteConfig = BaseToolConfig & {
+    /** Override the default tool description. */
+    description?: string;
+};
 /**
  * Creates a write tool that writes text content to a file.
  *
@@ -23,7 +33,7 @@ type WriteConfig = BaseToolConfig;
  * );
  * ```
  */
-declare function createWrite(config?: BaseToolConfig): ai.Tool<{
+declare function createWrite(config?: WriteConfig): ai.Tool<{
     content: string;
     file_path: string;
 }, string>;
@@ -44,4 +54,4 @@ declare const write: ai.Tool<{
     file_path: string;
 }, string>;
 
-export { type WriteConfig, createWrite, write };
+export { type WriteConfig, createWrite, write, getPrompt as writePrompt };

package/dist/write/index.d.ts

@@ -1,7 +1,17 @@
 import * as ai from 'ai';
 import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
 
-type WriteConfig = BaseToolConfig;
+/**
+ * Generate the description prompt for the write tool.
+ *
+ * @returns The full description string for the write tool.
+ */
+declare function getPrompt(): string;
+
+type WriteConfig = BaseToolConfig & {
+    /** Override the default tool description. */
+    description?: string;
+};
 /**
  * Creates a write tool that writes text content to a file.
  *
@@ -23,7 +33,7 @@ type WriteConfig = BaseToolConfig;
  * );
  * ```
  */
-declare function createWrite(config?: BaseToolConfig): ai.Tool<{
+declare function createWrite(config?: WriteConfig): ai.Tool<{
     content: string;
     file_path: string;
 }, string>;
@@ -44,4 +54,4 @@ declare const write: ai.Tool<{
     file_path: string;
 }, string>;
 
-export { type WriteConfig, createWrite, write };
+export { type WriteConfig, createWrite, write, getPrompt as writePrompt };

package/dist/write/index.js

@@ -1,10 +1,13 @@
 import {
   createWrite,
+  getPrompt,
   write
-} from "../chunk-7QL4BQCH.js";
-import "../chunk-6PQLFDGT.js";
+} from "../chunk-NTGDU5X3.js";
+import "../chunk-PWBVB6MN.js";
 import "../chunk-I3ONDY7P.js";
+import "../chunk-X6ZY2KFU.js";
 export {
   createWrite,
-  write
+  write,
+  getPrompt as writePrompt
 };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agentool",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "type": "module",
-  "description": "16 AI agent tools as standalone Vercel AI SDK modules",
+  "description": "22 AI agent tools as standalone Vercel AI SDK modules",
   "author": "Z-M-Huang",
   "license": "Apache-2.0",
   "repository": {
@@ -89,10 +89,35 @@
       "import": "./dist/diff/index.js",
       "require": "./dist/diff/index.cjs"
     },
-    "./task": {
-      "types": "./dist/task/index.d.ts",
-      "import": "./dist/task/index.js",
-      "require": "./dist/task/index.cjs"
+    "./task-create": {
+      "types": "./dist/task-create/index.d.ts",
+      "import": "./dist/task-create/index.js",
+      "require": "./dist/task-create/index.cjs"
+    },
+    "./task-get": {
+      "types": "./dist/task-get/index.d.ts",
+      "import": "./dist/task-get/index.js",
+      "require": "./dist/task-get/index.cjs"
+    },
+    "./task-update": {
+      "types": "./dist/task-update/index.d.ts",
+      "import": "./dist/task-update/index.js",
+      "require": "./dist/task-update/index.cjs"
+    },
+    "./task-list": {
+      "types": "./dist/task-list/index.d.ts",
+      "import": "./dist/task-list/index.js",
+      "require": "./dist/task-list/index.cjs"
+    },
+    "./web-search": {
+      "types": "./dist/web-search/index.d.ts",
+      "import": "./dist/web-search/index.js",
+      "require": "./dist/web-search/index.cjs"
+    },
+    "./tool-search": {
+      "types": "./dist/tool-search/index.d.ts",
+      "import": "./dist/tool-search/index.js",
+      "require": "./dist/tool-search/index.cjs"
     },
     "./lsp": {
       "types": "./dist/lsp/index.d.ts",

package/dist/chunk-3EPGFWZV.cjs

@@ -1,30 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/ask-user/index.ts
-var _ai = require('ai');
-var _zod = require('zod');
-function createAskUser(config = {}) {
-  return _ai.tool.call(void 0, {
-    description: "Ask the user a question and wait for their response. Use this when you need clarification, confirmation, or additional information from the user before proceeding.",
-    inputSchema: _zod.z.object({
-      question: _zod.z.string().describe("The question to ask the user"),
-      options: _zod.z.array(_zod.z.string()).optional().describe("Optional list of suggested response options")
-    }),
-    execute: async ({ question, options }) => {
-      if (!config.onQuestion) {
-        return "Error [ask-user]: No onQuestion callback configured. Provide an onQuestion function in the tool config to enable user interaction.";
-      }
-      try {
-        const response = await config.onQuestion(question, options);
-        return response;
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        return `Error [ask-user]: Failed to get user response: ${msg}`;
-      }
-    }
-  });
-}
-var askUser = createAskUser();
-
-
-
-
-exports.createAskUser = createAskUser; exports.askUser = askUser;

package/dist/chunk-7QL4BQCH.js

@@ -1,40 +0,0 @@
-import {
-  pathExists,
-  writeTextContent
-} from "./chunk-6PQLFDGT.js";
-import {
-  expandPath
-} from "./chunk-I3ONDY7P.js";
-
-// src/write/index.ts
-import { tool } from "ai";
-import { z } from "zod";
-function createWrite(config = {}) {
-  const cwd = config.cwd ?? process.cwd();
-  return tool({
-    description: "Write text content to a file, creating parent directories as needed. If the file exists it is overwritten. Use this to create new files or replace existing file contents.",
-    inputSchema: z.object({
-      file_path: z.string().describe("Path to the file to write"),
-      content: z.string().describe("Text content to write to the file")
-    }),
-    execute: async ({ file_path, content }) => {
-      try {
-        const absolutePath = expandPath(file_path, cwd);
-        const existed = await pathExists(absolutePath);
-        await writeTextContent(absolutePath, content);
-        const bytes = Buffer.byteLength(content, "utf-8");
-        const verb = existed ? "Updated" : "Created";
-        return `${verb} file: ${absolutePath} (${bytes} bytes)`;
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return `Error [write]: Failed to write file: ${message}`;
-      }
-    }
-  });
-}
-var write = createWrite();
-
-export {
-  createWrite,
-  write
-};

package/dist/chunk-FAEGCFTO.js

@@ -1,136 +0,0 @@
-// src/task/index.ts
-import { tool } from "ai";
-import { z } from "zod";
-import { mkdir, readFile, writeFile } from "fs/promises";
-import { dirname, join } from "path";
-import { randomBytes } from "crypto";
-function generateId() {
-  return randomBytes(4).toString("hex");
-}
-async function loadTasks(filePath) {
-  try {
-    const data = await readFile(filePath, "utf-8");
-    return JSON.parse(data);
-  } catch {
-    return [];
-  }
-}
-async function saveTasks(filePath, tasks) {
-  await mkdir(dirname(filePath), { recursive: true });
-  await writeFile(filePath, JSON.stringify(tasks, null, 2), "utf-8");
-}
-function formatTask(t) {
-  return [
-    `ID: ${t.id}`,
-    `Subject: ${t.subject}`,
-    `Description: ${t.description}`,
-    `Status: ${t.status}`,
-    `Created: ${t.createdAt}`,
-    `Updated: ${t.updatedAt}`
-  ].join("\n");
-}
-function createTask(config = {}) {
-  const cwd = config.cwd ?? process.cwd();
-  const tasksFile = config.tasksFile ?? join(cwd, ".agentool", "tasks.json");
-  return tool({
-    description: "JSON file-based task tracker. Use this to create, get, update, list, and delete tasks. Each task has an id, subject, description, status, and timestamps.",
-    inputSchema: z.object({
-      action: z.enum(["create", "get", "update", "list", "delete"]).describe(
-        "The operation to perform"
-      ),
-      id: z.string().optional().describe(
-        "Task id (required for get, update, delete)"
-      ),
-      subject: z.string().optional().describe(
-        "Task subject (required for create, optional for update)"
-      ),
-      description: z.string().optional().describe(
-        "Task description (required for create, optional for update)"
-      ),
-      status: z.enum(["pending", "in_progress", "completed"]).optional().describe(
-        "Task status (optional for create/update, defaults to pending)"
-      )
-    }),
-    execute: async ({ action, id, subject, description, status }) => {
-      try {
-        switch (action) {
-          case "create":
-            return await createEntry(tasksFile, subject, description, status);
-          case "list":
-            return await listEntries(tasksFile);
-          case "get":
-            return await getEntry(tasksFile, id);
-          case "update":
-            return await updateEntry(tasksFile, id, subject, description, status);
-          case "delete":
-            return await deleteEntry(tasksFile, id);
-          default:
-            return `Error [task]: Unknown action "${String(action)}".`;
-        }
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        return `Error [task]: ${msg}`;
-      }
-    }
-  });
-}
-async function createEntry(filePath, subject, description, status) {
-  if (!subject) return "Error [task]: Subject is required for create action.";
-  if (!description) return "Error [task]: Description is required for create action.";
-  const tasks = await loadTasks(filePath);
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const entry = {
-    id: generateId(),
-    subject,
-    description,
-    status: status ?? "pending",
-    createdAt: now,
-    updatedAt: now
-  };
-  tasks.push(entry);
-  await saveTasks(filePath, tasks);
-  return `Created task ${entry.id}.
-${formatTask(entry)}`;
-}
-async function listEntries(filePath) {
-  const tasks = await loadTasks(filePath);
-  if (tasks.length === 0) return "No tasks found.";
-  return tasks.map(formatTask).join("\n---\n");
-}
-async function getEntry(filePath, id) {
-  if (!id) return "Error [task]: ID is required for get action.";
-  const tasks = await loadTasks(filePath);
-  const found = tasks.find((t) => t.id === id);
-  if (!found) return `Error [task]: Task "${id}" not found.`;
-  return formatTask(found);
-}
-async function updateEntry(filePath, id, subject, description, status) {
-  if (!id) return "Error [task]: ID is required for update action.";
-  const tasks = await loadTasks(filePath);
-  const idx = tasks.findIndex((t) => t.id === id);
-  if (idx === -1) return `Error [task]: Task "${id}" not found.`;
-  const entry = tasks[idx];
-  if (subject) entry.subject = subject;
-  if (description) entry.description = description;
-  if (status) entry.status = status;
-  entry.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  tasks[idx] = entry;
-  await saveTasks(filePath, tasks);
-  return `Updated task ${id}.
-${formatTask(entry)}`;
-}
-async function deleteEntry(filePath, id) {
-  if (!id) return "Error [task]: ID is required for delete action.";
-  const tasks = await loadTasks(filePath);
-  const idx = tasks.findIndex((t) => t.id === id);
-  if (idx === -1) return `Error [task]: Task "${id}" not found.`;
-  tasks.splice(idx, 1);
-  await saveTasks(filePath, tasks);
-  return `Deleted task "${id}".`;
-}
-var task = createTask();
-
-export {
-  createTask,
-  task
-};

package/dist/chunk-HDKXSKMO.js

@@ -1,30 +0,0 @@
-// src/ask-user/index.ts
-import { tool } from "ai";
-import { z } from "zod";
-function createAskUser(config = {}) {
-  return tool({
-    description: "Ask the user a question and wait for their response. Use this when you need clarification, confirmation, or additional information from the user before proceeding.",
-    inputSchema: z.object({
-      question: z.string().describe("The question to ask the user"),
-      options: z.array(z.string()).optional().describe("Optional list of suggested response options")
-    }),
-    execute: async ({ question, options }) => {
-      if (!config.onQuestion) {
-        return "Error [ask-user]: No onQuestion callback configured. Provide an onQuestion function in the tool config to enable user interaction.";
-      }
-      try {
-        const response = await config.onQuestion(question, options);
-        return response;
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        return `Error [ask-user]: Failed to get user response: ${msg}`;
-      }
-    }
-  });
-}
-var askUser = createAskUser();
-
-export {
-  createAskUser,
-  askUser
-};

package/dist/chunk-JCTBB7H2.cjs

@@ -1,40 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
-
-
-var _chunkCAEVLIQBcjs = require('./chunk-CAEVLIQB.cjs');
-
-
-var _chunkQZ5GS6HWcjs = require('./chunk-QZ5GS6HW.cjs');
-
-// src/write/index.ts
-var _ai = require('ai');
-var _zod = require('zod');
-function createWrite(config = {}) {
-  const cwd = _nullishCoalesce(config.cwd, () => ( process.cwd()));
-  return _ai.tool.call(void 0, {
-    description: "Write text content to a file, creating parent directories as needed. If the file exists it is overwritten. Use this to create new files or replace existing file contents.",
-    inputSchema: _zod.z.object({
-      file_path: _zod.z.string().describe("Path to the file to write"),
-      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 _chunkCAEVLIQBcjs.pathExists.call(void 0, absolutePath);
-        await _chunkCAEVLIQBcjs.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 = error instanceof Error ? error.message : String(error);
-        return `Error [write]: Failed to write file: ${message}`;
-      }
-    }
-  });
-}
-var write = createWrite();
-
-
-
-
-exports.createWrite = createWrite; exports.write = write;

package/dist/chunk-MF7CJVIZ.js

@@ -1,40 +0,0 @@
-// src/sleep/index.ts
-import { tool, zodSchema } from "ai";
-import { z } from "zod";
-function createSleep(config = {}) {
-  const maxDuration = config.maxDuration ?? 3e5;
-  return tool({
-    description: "Pause execution for a specified duration. Useful for rate limiting, polling intervals, or waiting for external processes. Maximum duration is 300 seconds (5 minutes).",
-    inputSchema: zodSchema(
-      z.object({
-        durationMs: z.number().describe("Duration to sleep in milliseconds"),
-        reason: z.string().optional().describe("Optional reason for the sleep")
-      })
-    ),
-    execute: async ({ durationMs, reason }) => {
-      try {
-        const clamped = Math.max(0, Math.min(durationMs, maxDuration));
-        const start = Date.now();
-        await new Promise((resolve) => setTimeout(resolve, clamped));
-        const elapsed = Date.now() - start;
-        const parts = [`Slept for ${elapsed}ms`];
-        if (reason) parts.push(`Reason: ${reason}`);
-        if (clamped !== durationMs) {
-          parts.push(
-            `(clamped from ${durationMs}ms to ${clamped}ms, max: ${maxDuration}ms)`
-          );
-        }
-        return parts.join(". ");
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return `Sleep failed: ${message}`;
-      }
-    }
-  });
-}
-var sleep = createSleep();
-
-export {
-  createSleep,
-  sleep
-};

package/dist/chunk-MXFW3XY6.cjs

@@ -1,73 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-var _chunk5NW4OGRIcjs = require('./chunk-5NW4OGRI.cjs');
-
-
-var _chunkQZ5GS6HWcjs = require('./chunk-QZ5GS6HW.cjs');
-
-// src/edit/index.ts
-var _promises = require('fs/promises');
-var _ai = require('ai');
-var _zod = require('zod');
-function createEdit(config = {}) {
-  return _ai.tool.call(void 0, {
-    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.",
-    inputSchema: _zod.z.object({
-      file_path: _zod.z.string().describe("Path to the file to edit"),
-      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().optional().default(false).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 _promises.readFile.call(void 0, resolved, "utf-8");
-        } catch (err) {
-          const msg = err instanceof Error ? err.message : String(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 = _chunk5NW4OGRIcjs.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) {
-          let count = 0;
-          let pos = 0;
-          while (pos < content.length) {
-            const idx = content.indexOf(actualOld, pos);
-            if (idx === -1) break;
-            count++;
-            pos = idx + 1;
-          }
-          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 = _chunk5NW4OGRIcjs.preserveQuoteStyle.call(void 0, old_string, actualOld, new_string);
-        const updated = _chunk5NW4OGRIcjs.applyEditToFile.call(void 0, content, actualOld, styledNew, replace_all);
-        await _promises.writeFile.call(void 0, resolved, updated, "utf-8");
-        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);
-        return `Error [edit]: ${msg}`;
-      }
-    }
-  });
-}
-var edit = createEdit();
-
-
-
-
-exports.createEdit = createEdit; exports.edit = edit;

package/dist/chunk-OXLQ7QVL.cjs

@@ -1,40 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/sleep/index.ts
-var _ai = require('ai');
-var _zod = require('zod');
-function createSleep(config = {}) {
-  const maxDuration = _nullishCoalesce(config.maxDuration, () => ( 3e5));
-  return _ai.tool.call(void 0, {
-    description: "Pause execution for a specified duration. Useful for rate limiting, polling intervals, or waiting for external processes. Maximum duration is 300 seconds (5 minutes).",
-    inputSchema: _ai.zodSchema.call(void 0, 
-      _zod.z.object({
-        durationMs: _zod.z.number().describe("Duration to sleep in milliseconds"),
-        reason: _zod.z.string().optional().describe("Optional reason for the sleep")
-      })
-    ),
-    execute: async ({ durationMs, reason }) => {
-      try {
-        const clamped = Math.max(0, Math.min(durationMs, maxDuration));
-        const start = Date.now();
-        await new Promise((resolve) => setTimeout(resolve, clamped));
-        const elapsed = Date.now() - start;
-        const parts = [`Slept for ${elapsed}ms`];
-        if (reason) parts.push(`Reason: ${reason}`);
-        if (clamped !== durationMs) {
-          parts.push(
-            `(clamped from ${durationMs}ms to ${clamped}ms, max: ${maxDuration}ms)`
-          );
-        }
-        return parts.join(". ");
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return `Sleep failed: ${message}`;
-      }
-    }
-  });
-}
-var sleep = createSleep();
-
-
-
-
-exports.createSleep = createSleep; exports.sleep = sleep;