agentool 1.0.0 → 1.1.0

package/dist/tool-search/index.d.cts

@@ -0,0 +1,18 @@
+import * as ai from 'ai';
+
+interface ToolSearchConfig {
+    /** Registry of available tools to search through. */
+    tools?: Record<string, {
+        description: string;
+    }>;
+}
+declare function createToolSearch(config?: ToolSearchConfig): ai.Tool<{
+    query: string;
+    max_results: number;
+}, string>;
+declare const toolSearch: ai.Tool<{
+    query: string;
+    max_results: number;
+}, string>;
+
+export { type ToolSearchConfig, createToolSearch, toolSearch };

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

@@ -0,0 +1,18 @@
+import * as ai from 'ai';
+
+interface ToolSearchConfig {
+    /** Registry of available tools to search through. */
+    tools?: Record<string, {
+        description: string;
+    }>;
+}
+declare function createToolSearch(config?: ToolSearchConfig): ai.Tool<{
+    query: string;
+    max_results: number;
+}, string>;
+declare const toolSearch: ai.Tool<{
+    query: string;
+    max_results: number;
+}, string>;
+
+export { type ToolSearchConfig, createToolSearch, toolSearch };

package/dist/tool-search/index.js

@@ -0,0 +1,8 @@
+import {
+  createToolSearch,
+  toolSearch
+} from "../chunk-IRRNYFI5.js";
+export {
+  createToolSearch,
+  toolSearch
+};

package/dist/web-fetch/index.cjs

@@ -1,8 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkU2YMJM25cjs = require('../chunk-U2YMJM25.cjs');
+var _chunk5O55DKOBcjs = require('../chunk-5O55DKOB.cjs');
 
 
 
-exports.createWebFetch = _chunkU2YMJM25cjs.createWebFetch; exports.webFetch = _chunkU2YMJM25cjs.webFetch;
+exports.createWebFetch = _chunk5O55DKOBcjs.createWebFetch; exports.webFetch = _chunk5O55DKOBcjs.webFetch;

package/dist/web-fetch/index.d.cts

@@ -36,7 +36,6 @@ interface WebFetchConfig extends TimeoutConfig {
  */
 declare function createWebFetch(config?: WebFetchConfig): ai.Tool<{
     url: string;
-    prompt?: string | undefined;
 }, string>;
 /**
  * Pre-configured web-fetch tool with default settings.
@@ -50,7 +49,6 @@ declare function createWebFetch(config?: WebFetchConfig): ai.Tool<{
  */
 declare const webFetch: ai.Tool<{
     url: string;
-    prompt?: string | undefined;
 }, string>;
 
 export { type WebFetchConfig, createWebFetch, webFetch };

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

@@ -36,7 +36,6 @@ interface WebFetchConfig extends TimeoutConfig {
  */
 declare function createWebFetch(config?: WebFetchConfig): ai.Tool<{
     url: string;
-    prompt?: string | undefined;
 }, string>;
 /**
  * Pre-configured web-fetch tool with default settings.
@@ -50,7 +49,6 @@ declare function createWebFetch(config?: WebFetchConfig): ai.Tool<{
  */
 declare const webFetch: ai.Tool<{
     url: string;
-    prompt?: string | undefined;
 }, string>;
 
 export { type WebFetchConfig, createWebFetch, webFetch };

package/dist/web-fetch/index.js

@@ -1,7 +1,7 @@
 import {
   createWebFetch,
   webFetch
-} from "../chunk-Y7KOKDFP.js";
+} from "../chunk-4HIATLKI.js";
 export {
   createWebFetch,
   webFetch

package/dist/web-search/index.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkLK6SQH2Gcjs = require('../chunk-LK6SQH2G.cjs');
+
+
+
+exports.createWebSearch = _chunkLK6SQH2Gcjs.createWebSearch; exports.webSearch = _chunkLK6SQH2Gcjs.webSearch;

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

@@ -0,0 +1,21 @@
+import * as ai from 'ai';
+
+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>;
+}
+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 };

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

@@ -0,0 +1,21 @@
+import * as ai from 'ai';
+
+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>;
+}
+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 };

package/dist/web-search/index.js

@@ -0,0 +1,8 @@
+import {
+  createWebSearch,
+  webSearch
+} from "../chunk-44AFQ2B7.js";
+export {
+  createWebSearch,
+  webSearch
+};

package/dist/write/index.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkJCTBB7H2cjs = require('../chunk-JCTBB7H2.cjs');
+var _chunk6DJSWTWQcjs = require('../chunk-6DJSWTWQ.cjs');
 require('../chunk-CAEVLIQB.cjs');
 require('../chunk-QZ5GS6HW.cjs');
 
 
 
-exports.createWrite = _chunkJCTBB7H2cjs.createWrite; exports.write = _chunkJCTBB7H2cjs.write;
+exports.createWrite = _chunk6DJSWTWQcjs.createWrite; exports.write = _chunk6DJSWTWQcjs.write;

package/dist/write/index.js

@@ -1,7 +1,7 @@
 import {
   createWrite,
   write
-} from "../chunk-7QL4BQCH.js";
+} from "../chunk-ECYT46FP.js";
 import "../chunk-6PQLFDGT.js";
 import "../chunk-I3ONDY7P.js";
 export {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agentool",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "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-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-XLD2Y3SS.cjs

@@ -1,136 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/task/index.ts
-var _ai = require('ai');
-var _zod = require('zod');
-var _promises = require('fs/promises');
-var _path = require('path');
-var _crypto = require('crypto');
-function generateId() {
-  return _crypto.randomBytes.call(void 0, 4).toString("hex");
-}
-async function loadTasks(filePath) {
-  try {
-    const data = await _promises.readFile.call(void 0, filePath, "utf-8");
-    return JSON.parse(data);
-  } catch (e) {
-    return [];
-  }
-}
-async function saveTasks(filePath, tasks) {
-  await _promises.mkdir.call(void 0, _path.dirname.call(void 0, filePath), { recursive: true });
-  await _promises.writeFile.call(void 0, 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 = _nullishCoalesce(config.cwd, () => ( process.cwd()));
-  const tasksFile = _nullishCoalesce(config.tasksFile, () => ( _path.join.call(void 0, cwd, ".agentool", "tasks.json")));
-  return _ai.tool.call(void 0, {
-    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: _zod.z.object({
-      action: _zod.z.enum(["create", "get", "update", "list", "delete"]).describe(
-        "The operation to perform"
-      ),
-      id: _zod.z.string().optional().describe(
-        "Task id (required for get, update, delete)"
-      ),
-      subject: _zod.z.string().optional().describe(
-        "Task subject (required for create, optional for update)"
-      ),
-      description: _zod.z.string().optional().describe(
-        "Task description (required for create, optional for update)"
-      ),
-      status: _zod.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: _nullishCoalesce(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();
-
-
-
-
-exports.createTask = createTask; exports.task = task;

package/dist/task/index.cjs

@@ -1,8 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-var _chunkXLD2Y3SScjs = require('../chunk-XLD2Y3SS.cjs');
-
-
-
-exports.createTask = _chunkXLD2Y3SScjs.createTask; exports.task = _chunkXLD2Y3SScjs.task;

package/dist/task/index.d.cts

@@ -1,67 +0,0 @@
-import * as ai from 'ai';
-import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
-
-/**
- * Configuration for the task tool.
- * Extends {@link BaseToolConfig} with an optional tasks file path.
- *
- * @example
- * ```typescript
- * import type { TaskConfig } from 'agentool/task';
- * const config: TaskConfig = { cwd: '/my/project' };
- * ```
- */
-interface TaskConfig extends BaseToolConfig {
-    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
-    tasksFile?: string;
-}
-/**
- * Creates a task tool that provides JSON file-based task tracking.
- *
- * Tasks are stored in a single JSON file with CRUD operations.
- * Each task has an id, subject, description, status, and timestamps.
- * Execute never throws; errors are returned as descriptive strings.
- *
- * @param config - Optional configuration for cwd and tasks file path.
- * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
- *
- * @example
- * ```typescript
- * import { createTask } from 'agentool/task';
- *
- * const taskTool = createTask({ cwd: '/my/project' });
- * const result = await taskTool.execute(
- *   { action: 'create', subject: 'Fix bug', description: 'Fix the login bug' },
- *   { toolCallId: 'id', messages: [] },
- * );
- * ```
- */
-declare function createTask(config?: TaskConfig): ai.Tool<{
-    action: "list" | "delete" | "create" | "get" | "update";
-    status?: "pending" | "in_progress" | "completed" | undefined;
-    description?: string | undefined;
-    id?: string | undefined;
-    subject?: string | undefined;
-}, string>;
-/**
- * Default task tool instance using `.agentool/tasks.json` under the current
- * working directory.
- *
- * @example
- * ```typescript
- * import { task } from 'agentool/task';
- * const result = await task.execute(
- *   { action: 'list' },
- *   { toolCallId: 'id', messages: [] },
- * );
- * ```
- */
-declare const task: ai.Tool<{
-    action: "list" | "delete" | "create" | "get" | "update";
-    status?: "pending" | "in_progress" | "completed" | undefined;
-    description?: string | undefined;
-    id?: string | undefined;
-    subject?: string | undefined;
-}, string>;
-
-export { type TaskConfig, createTask, task };

package/dist/task/index.d.ts

@@ -1,67 +0,0 @@
-import * as ai from 'ai';
-import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
-
-/**
- * Configuration for the task tool.
- * Extends {@link BaseToolConfig} with an optional tasks file path.
- *
- * @example
- * ```typescript
- * import type { TaskConfig } from 'agentool/task';
- * const config: TaskConfig = { cwd: '/my/project' };
- * ```
- */
-interface TaskConfig extends BaseToolConfig {
-    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
-    tasksFile?: string;
-}
-/**
- * Creates a task tool that provides JSON file-based task tracking.
- *
- * Tasks are stored in a single JSON file with CRUD operations.
- * Each task has an id, subject, description, status, and timestamps.
- * Execute never throws; errors are returned as descriptive strings.
- *
- * @param config - Optional configuration for cwd and tasks file path.
- * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
- *
- * @example
- * ```typescript
- * import { createTask } from 'agentool/task';
- *
- * const taskTool = createTask({ cwd: '/my/project' });
- * const result = await taskTool.execute(
- *   { action: 'create', subject: 'Fix bug', description: 'Fix the login bug' },
- *   { toolCallId: 'id', messages: [] },
- * );
- * ```
- */
-declare function createTask(config?: TaskConfig): ai.Tool<{
-    action: "list" | "delete" | "create" | "get" | "update";
-    status?: "pending" | "in_progress" | "completed" | undefined;
-    description?: string | undefined;
-    id?: string | undefined;
-    subject?: string | undefined;
-}, string>;
-/**
- * Default task tool instance using `.agentool/tasks.json` under the current
- * working directory.
- *
- * @example
- * ```typescript
- * import { task } from 'agentool/task';
- * const result = await task.execute(
- *   { action: 'list' },
- *   { toolCallId: 'id', messages: [] },
- * );
- * ```
- */
-declare const task: ai.Tool<{
-    action: "list" | "delete" | "create" | "get" | "update";
-    status?: "pending" | "in_progress" | "completed" | undefined;
-    description?: string | undefined;
-    id?: string | undefined;
-    subject?: string | undefined;
-}, string>;
-
-export { type TaskConfig, createTask, task };

package/dist/task/index.js

@@ -1,8 +0,0 @@
-import {
-  createTask,
-  task
-} from "../chunk-FAEGCFTO.js";
-export {
-  createTask,
-  task
-};