agentool 0.0.1 → 1.1.0

package/dist/ask-user/index.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk3EPGFWZVcjs = require('../chunk-3EPGFWZV.cjs');
+
+
+
+exports.askUser = _chunk3EPGFWZVcjs.askUser; exports.createAskUser = _chunk3EPGFWZVcjs.createAskUser;

package/dist/ask-user/index.d.cts

@@ -0,0 +1,68 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the ask-user tool.
+ * Extends {@link BaseToolConfig} with an optional callback for receiving user input.
+ *
+ * @example
+ * ```typescript
+ * import type { AskUserConfig } from 'agentool/ask-user';
+ * const config: AskUserConfig = {
+ *   onQuestion: async (question) => prompt(question) ?? '',
+ * };
+ * ```
+ */
+interface AskUserConfig extends BaseToolConfig {
+    /**
+     * Callback invoked when the tool needs user input.
+     * Must be provided for the tool to work.
+     *
+     * @param question - The question to present to the user
+     * @param options - Optional list of suggested response options
+     * @returns The user's response string
+     */
+    onQuestion?: (question: string, options?: string[]) => Promise<string>;
+}
+/**
+ * Creates an ask-user tool instance with the given configuration.
+ * The tool pauses agent execution and prompts the user for input via the
+ * configured {@link AskUserConfig.onQuestion} callback.
+ *
+ * Execute never throws. Errors are returned as descriptive strings.
+ *
+ * @param config - Tool configuration with optional onQuestion callback
+ * @returns An AI SDK tool that asks the user a question and returns their response
+ *
+ * @example
+ * ```typescript
+ * import { createAskUser } from 'agentool/ask-user';
+ * const askUser = createAskUser({
+ *   onQuestion: async (q, opts) => {
+ *     console.log(q, opts);
+ *     return 'user reply';
+ *   },
+ * });
+ * ```
+ */
+declare function createAskUser(config?: AskUserConfig): ai.Tool<{
+    question: string;
+    options?: string[] | undefined;
+}, string>;
+/**
+ * Default ask-user tool instance with no callback configured.
+ * Calling execute on this instance returns an error string prompting the
+ * consumer to provide an {@link AskUserConfig.onQuestion} callback.
+ *
+ * @example
+ * ```typescript
+ * import { askUser } from 'agentool/ask-user';
+ * // Typically you'd use createAskUser() with a callback instead.
+ * ```
+ */
+declare const askUser: ai.Tool<{
+    question: string;
+    options?: string[] | undefined;
+}, string>;
+
+export { type AskUserConfig, askUser, createAskUser };

package/dist/ask-user/index.d.ts

@@ -0,0 +1,68 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the ask-user tool.
+ * Extends {@link BaseToolConfig} with an optional callback for receiving user input.
+ *
+ * @example
+ * ```typescript
+ * import type { AskUserConfig } from 'agentool/ask-user';
+ * const config: AskUserConfig = {
+ *   onQuestion: async (question) => prompt(question) ?? '',
+ * };
+ * ```
+ */
+interface AskUserConfig extends BaseToolConfig {
+    /**
+     * Callback invoked when the tool needs user input.
+     * Must be provided for the tool to work.
+     *
+     * @param question - The question to present to the user
+     * @param options - Optional list of suggested response options
+     * @returns The user's response string
+     */
+    onQuestion?: (question: string, options?: string[]) => Promise<string>;
+}
+/**
+ * Creates an ask-user tool instance with the given configuration.
+ * The tool pauses agent execution and prompts the user for input via the
+ * configured {@link AskUserConfig.onQuestion} callback.
+ *
+ * Execute never throws. Errors are returned as descriptive strings.
+ *
+ * @param config - Tool configuration with optional onQuestion callback
+ * @returns An AI SDK tool that asks the user a question and returns their response
+ *
+ * @example
+ * ```typescript
+ * import { createAskUser } from 'agentool/ask-user';
+ * const askUser = createAskUser({
+ *   onQuestion: async (q, opts) => {
+ *     console.log(q, opts);
+ *     return 'user reply';
+ *   },
+ * });
+ * ```
+ */
+declare function createAskUser(config?: AskUserConfig): ai.Tool<{
+    question: string;
+    options?: string[] | undefined;
+}, string>;
+/**
+ * Default ask-user tool instance with no callback configured.
+ * Calling execute on this instance returns an error string prompting the
+ * consumer to provide an {@link AskUserConfig.onQuestion} callback.
+ *
+ * @example
+ * ```typescript
+ * import { askUser } from 'agentool/ask-user';
+ * // Typically you'd use createAskUser() with a callback instead.
+ * ```
+ */
+declare const askUser: ai.Tool<{
+    question: string;
+    options?: string[] | undefined;
+}, string>;
+
+export { type AskUserConfig, askUser, createAskUser };

package/dist/ask-user/index.js

@@ -0,0 +1,8 @@
+import {
+  askUser,
+  createAskUser
+} from "../chunk-HDKXSKMO.js";
+export {
+  askUser,
+  createAskUser
+};

package/dist/bash/index.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkSUSAPI5Wcjs = require('../chunk-SUSAPI5W.cjs');
+
+
+
+exports.bash = _chunkSUSAPI5Wcjs.bash; exports.createBash = _chunkSUSAPI5Wcjs.createBash;

package/dist/bash/index.d.cts

@@ -0,0 +1,63 @@
+import * as ai from 'ai';
+import { T as TimeoutConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the bash tool.
+ * Extends {@link TimeoutConfig} with an optional shell binary path.
+ *
+ * @example
+ * ```typescript
+ * import type { BashConfig } from 'agentool/bash';
+ * const config: BashConfig = { cwd: '/my/project', timeout: 30000, shell: '/bin/zsh' };
+ * ```
+ */
+interface BashConfig extends TimeoutConfig {
+    /** Shell binary to use. Defaults to `$SHELL` or `/bin/bash`. */
+    shell?: string;
+}
+/**
+ * Creates a bash tool that executes shell commands via {@link executeShell}.
+ *
+ * The tool spawns the configured shell with `-c` and the given command string.
+ * Timeout escalation follows SIGTERM then SIGKILL after a 5-second grace period.
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration for cwd, timeout, and shell binary.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createBash } from 'agentool/bash';
+ *
+ * const bashTool = createBash({ cwd: '/my/project', timeout: 60000 });
+ * const result = await bashTool.execute(
+ *   { command: 'ls -la' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createBash(config?: BashConfig): ai.Tool<{
+    command: string;
+    timeout?: number | undefined;
+    description?: string | undefined;
+}, string>;
+/**
+ * Default bash tool instance using the current working directory,
+ * a 120-second timeout, and the system default shell.
+ *
+ * @example
+ * ```typescript
+ * import { bash } from 'agentool/bash';
+ * const result = await bash.execute(
+ *   { command: 'echo hello' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const bash: ai.Tool<{
+    command: string;
+    timeout?: number | undefined;
+    description?: string | undefined;
+}, string>;
+
+export { type BashConfig, bash, createBash };

package/dist/bash/index.d.ts

@@ -0,0 +1,63 @@
+import * as ai from 'ai';
+import { T as TimeoutConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the bash tool.
+ * Extends {@link TimeoutConfig} with an optional shell binary path.
+ *
+ * @example
+ * ```typescript
+ * import type { BashConfig } from 'agentool/bash';
+ * const config: BashConfig = { cwd: '/my/project', timeout: 30000, shell: '/bin/zsh' };
+ * ```
+ */
+interface BashConfig extends TimeoutConfig {
+    /** Shell binary to use. Defaults to `$SHELL` or `/bin/bash`. */
+    shell?: string;
+}
+/**
+ * Creates a bash tool that executes shell commands via {@link executeShell}.
+ *
+ * The tool spawns the configured shell with `-c` and the given command string.
+ * Timeout escalation follows SIGTERM then SIGKILL after a 5-second grace period.
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration for cwd, timeout, and shell binary.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createBash } from 'agentool/bash';
+ *
+ * const bashTool = createBash({ cwd: '/my/project', timeout: 60000 });
+ * const result = await bashTool.execute(
+ *   { command: 'ls -la' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createBash(config?: BashConfig): ai.Tool<{
+    command: string;
+    timeout?: number | undefined;
+    description?: string | undefined;
+}, string>;
+/**
+ * Default bash tool instance using the current working directory,
+ * a 120-second timeout, and the system default shell.
+ *
+ * @example
+ * ```typescript
+ * import { bash } from 'agentool/bash';
+ * const result = await bash.execute(
+ *   { command: 'echo hello' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const bash: ai.Tool<{
+    command: string;
+    timeout?: number | undefined;
+    description?: string | undefined;
+}, string>;
+
+export { type BashConfig, bash, createBash };

package/dist/bash/index.js

@@ -0,0 +1,8 @@
+import {
+  bash,
+  createBash
+} from "../chunk-4YI2H55A.js";
+export {
+  bash,
+  createBash
+};

package/dist/chunk-3EPGFWZV.cjs

@@ -0,0 +1,30 @@
+"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-3VO6NETR.cjs

@@ -0,0 +1,79 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+
+var _chunk5NW4OGRIcjs = require('./chunk-5NW4OGRI.cjs');
+
+
+var _chunkCAEVLIQBcjs = require('./chunk-CAEVLIQB.cjs');
+
+
+var _chunkQZ5GS6HWcjs = require('./chunk-QZ5GS6HW.cjs');
+
+// src/multi-edit/index.ts
+var _promises = require('fs/promises');
+var _ai = require('ai');
+var _zod = require('zod');
+function countOccurrences(text, search) {
+  if (search.length === 0) return 0;
+  let count = 0;
+  let pos = 0;
+  while ((pos = text.indexOf(search, pos)) !== -1) {
+    count++;
+    pos += search.length;
+  }
+  return count;
+}
+function createMultiEdit(config = {}) {
+  const cwd = _nullishCoalesce(config.cwd, () => ( process.cwd()));
+  return _ai.tool.call(void 0, {
+    description: "Atomically apply multiple text edits to a single file. All edits succeed together or none are applied (rollback on failure). Each edit replaces one occurrence of old_string with new_string. Edits are applied sequentially in the order provided.",
+    inputSchema: _zod.z.object({
+      file_path: _zod.z.string().describe("Path to the file to edit (absolute or relative to cwd)"),
+      edits: _zod.z.array(
+        _zod.z.object({
+          old_string: _zod.z.string().describe("The exact string to find and replace"),
+          new_string: _zod.z.string().describe("The replacement string")
+        })
+      ).describe("Ordered list of edits to apply atomically")
+    }),
+    execute: async ({ file_path, edits }) => {
+      try {
+        if (edits.length === 0) {
+          return "No edits provided. File unchanged.";
+        }
+        const resolvedPath = _chunkQZ5GS6HWcjs.expandPath.call(void 0, file_path, cwd);
+        const originalContent = await _promises.readFile.call(void 0, resolvedPath, "utf-8");
+        let content = originalContent;
+        for (let i = 0; i < edits.length; i++) {
+          const edit = edits[i];
+          const actualOldString = _chunk5NW4OGRIcjs.findActualString.call(void 0, content, edit.old_string);
+          if (actualOldString === null) {
+            return `Error [multi-edit]: Edit ${i + 1}/${edits.length} failed \u2014 old_string not found in file. No edits were applied. File: ${resolvedPath}`;
+          }
+          const occurrences = countOccurrences(content, actualOldString);
+          if (occurrences > 1) {
+            return `Error [multi-edit]: Edit ${i + 1}/${edits.length} failed \u2014 old_string matches ${occurrences} locations (must be unique). No edits were applied. File: ${resolvedPath}`;
+          }
+          const styledNewString = _chunk5NW4OGRIcjs.preserveQuoteStyle.call(void 0, 
+            edit.old_string,
+            actualOldString,
+            edit.new_string
+          );
+          content = _chunk5NW4OGRIcjs.applyEditToFile.call(void 0, content, actualOldString, styledNewString);
+        }
+        await _chunkCAEVLIQBcjs.writeTextContent.call(void 0, resolvedPath, content);
+        return `Successfully applied ${edits.length} edit${edits.length === 1 ? "" : "s"} to ${resolvedPath}`;
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error [multi-edit]: ${msg}`;
+      }
+    }
+  });
+}
+var multiEdit = createMultiEdit();
+
+
+
+
+exports.createMultiEdit = createMultiEdit; exports.multiEdit = multiEdit;

package/dist/chunk-44AFQ2B7.js

@@ -0,0 +1,30 @@
+// src/web-search/index.ts
+import { tool } from "ai";
+import { z } from "zod";
+function createWebSearch(config = {}) {
+  return tool({
+    description: "Search the web for information using a search query. Results can be filtered by allowed or blocked domains.",
+    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 = error instanceof Error ? error.message : String(error);
+        return `Error [web-search]: ${msg}`;
+      }
+    }
+  });
+}
+var webSearch = createWebSearch();
+
+export {
+  createWebSearch,
+  webSearch
+};

package/dist/chunk-4HIATLKI.js

@@ -0,0 +1,112 @@
+// src/web-fetch/index.ts
+import { tool } from "ai";
+import { z } from "zod";
+
+// src/shared/fetch.ts
+var MAX_MARKDOWN_LENGTH = 1e5;
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_MAX_CONTENT_LENGTH = 10 * 1024 * 1024;
+var turndownPromise;
+function getTurndownService() {
+  return turndownPromise ??= import("turndown").then((m) => {
+    const Turndown = m.default;
+    return new Turndown();
+  });
+}
+function composeSignal(timeoutMs, userSignal) {
+  const timeoutSignal = AbortSignal.timeout(timeoutMs);
+  if (!userSignal) {
+    return timeoutSignal;
+  }
+  return AbortSignal.any([timeoutSignal, userSignal]);
+}
+async function fetchUrl(url, options) {
+  const timeoutMs = options?.timeout ?? DEFAULT_TIMEOUT_MS;
+  const maxBytes = options?.maxContentLength ?? DEFAULT_MAX_CONTENT_LENGTH;
+  const signal = composeSignal(timeoutMs, options?.signal);
+  const headers = {
+    Accept: "text/markdown, text/html, */*"
+  };
+  if (options?.userAgent) {
+    headers["User-Agent"] = options.userAgent;
+  }
+  const response = await fetch(url, { signal, headers });
+  const chunks = [];
+  let totalBytes = 0;
+  if (response.body) {
+    const reader = response.body.getReader();
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      totalBytes += value.byteLength;
+      if (totalBytes > maxBytes) {
+        await reader.cancel();
+        throw new Error(
+          `Response body exceeds maxContentLength (${maxBytes} bytes)`
+        );
+      }
+      chunks.push(value);
+    }
+  }
+  const rawBuffer = Buffer.concat(chunks);
+  const byteLength = rawBuffer.length;
+  const contentType = response.headers.get("content-type") ?? "";
+  const textContent = rawBuffer.toString("utf-8");
+  let content;
+  if (contentType.includes("text/html")) {
+    const td = await getTurndownService();
+    content = td.turndown(textContent);
+  } else {
+    content = textContent;
+  }
+  let truncated = false;
+  if (content.length > MAX_MARKDOWN_LENGTH) {
+    content = content.slice(0, MAX_MARKDOWN_LENGTH);
+    truncated = true;
+  }
+  return {
+    content,
+    contentType,
+    statusCode: response.status,
+    byteLength,
+    truncated
+  };
+}
+
+// src/web-fetch/index.ts
+function createWebFetch(config = {}) {
+  return tool({
+    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.",
+    inputSchema: z.object({
+      url: z.string().url().describe("The URL to fetch")
+    }),
+    execute: async ({ url }) => {
+      try {
+        const result = await fetchUrl(url, {
+          timeout: config.timeout ?? 3e4,
+          maxContentLength: config.maxContentLength,
+          userAgent: config.userAgent
+        });
+        const parts = [];
+        parts.push(`URL: ${url}`);
+        parts.push(`Status: ${result.statusCode}`);
+        parts.push(`Content-Type: ${result.contentType}`);
+        if (result.truncated) {
+          parts.push("(Content truncated to 100,000 characters)");
+        }
+        parts.push("");
+        parts.push(result.content);
+        return parts.join("\n");
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error [web-fetch]: Failed to fetch ${url}: ${msg}`;
+      }
+    }
+  });
+}
+var webFetch = createWebFetch();
+
+export {
+  createWebFetch,
+  webFetch
+};

package/dist/chunk-4HXAKPQH.cjs

@@ -0,0 +1,36 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+var _chunkL5JH4I77cjs = require('./chunk-L5JH4I77.cjs');
+
+// src/task-get/index.ts
+var _ai = require('ai');
+var _zod = require('zod');
+var _path = require('path');
+function createTaskGet(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: "Retrieve a task by its ID to see full details.",
+    inputSchema: _zod.z.object({
+      taskId: _zod.z.string().describe("The ID of the task to retrieve")
+    }),
+    execute: async ({ taskId }) => {
+      try {
+        const tasks = await _chunkL5JH4I77cjs.loadTasks.call(void 0, tasksFile);
+        const found = tasks.find((t) => t.id === taskId);
+        if (!found) return `Error [task-get]: Task "${taskId}" not found.`;
+        return _chunkL5JH4I77cjs.formatTask.call(void 0, found);
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error [task-get]: ${msg}`;
+      }
+    }
+  });
+}
+var taskGet = createTaskGet();
+
+
+
+
+exports.createTaskGet = createTaskGet; exports.taskGet = taskGet;