agentool 0.0.1 → 1.1.0

package/dist/task-update/index.d.ts

@@ -0,0 +1,31 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+interface TaskUpdateConfig extends BaseToolConfig {
+    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
+    tasksFile?: string;
+}
+declare function createTaskUpdate(config?: TaskUpdateConfig): ai.Tool<{
+    taskId: string;
+    status?: "pending" | "in_progress" | "completed" | "deleted" | undefined;
+    description?: string | undefined;
+    subject?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    owner?: string | undefined;
+    activeForm?: string | undefined;
+    addBlocks?: string[] | undefined;
+    addBlockedBy?: string[] | undefined;
+}, string>;
+declare const taskUpdate: ai.Tool<{
+    taskId: string;
+    status?: "pending" | "in_progress" | "completed" | "deleted" | undefined;
+    description?: string | undefined;
+    subject?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    owner?: string | undefined;
+    activeForm?: string | undefined;
+    addBlocks?: string[] | undefined;
+    addBlockedBy?: string[] | undefined;
+}, string>;
+
+export { type TaskUpdateConfig, createTaskUpdate, taskUpdate };

package/dist/task-update/index.js

@@ -0,0 +1,9 @@
+import {
+  createTaskUpdate,
+  taskUpdate
+} from "../chunk-S7IVHOA6.js";
+import "../chunk-E6NBEYZD.js";
+export {
+  createTaskUpdate,
+  taskUpdate
+};

package/dist/tool-search/index.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkIEX4NOVNcjs = require('../chunk-IEX4NOVN.cjs');
+
+
+
+exports.createToolSearch = _chunkIEX4NOVNcjs.createToolSearch; exports.toolSearch = _chunkIEX4NOVNcjs.toolSearch;

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/types-3QPDuCXN.d.cts

@@ -0,0 +1,45 @@
+/**
+ * Base configuration shared by all agentool tools.
+ * Every tool's factory function accepts a config extending this type.
+ *
+ * @example
+ * ```typescript
+ * import type { BaseToolConfig } from 'agentool';
+ * const config: BaseToolConfig = { cwd: '/my/project' };
+ * ```
+ */
+interface BaseToolConfig {
+    /**
+     * Working directory for file operations.
+     * Defaults to process.cwd() when not specified.
+     */
+    cwd?: string;
+}
+/**
+ * Result returned by tool execute functions.
+ * Tools always return strings -- never throw.
+ * Error results include operation, error type, and remediation.
+ *
+ * @example
+ * ```typescript
+ * import type { ToolResult } from 'agentool';
+ * const result: ToolResult = 'Found 3 matches in src/index.ts';
+ * ```
+ */
+type ToolResult = string;
+/**
+ * Configuration for tools that support timeouts.
+ * Extends {@link BaseToolConfig} with an optional timeout duration.
+ *
+ * @example
+ * ```typescript
+ * import type { TimeoutConfig } from 'agentool';
+ * const config: TimeoutConfig = { cwd: '/project', timeout: 30000 };
+ * ```
+ */
+interface TimeoutConfig extends BaseToolConfig {
+    /** Timeout in milliseconds. Defaults vary by tool. */
+    timeout?: number;
+}
+
+export type { BaseToolConfig as B, TimeoutConfig as T, ToolResult as a };

package/dist/types-3QPDuCXN.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base configuration shared by all agentool tools.
+ * Every tool's factory function accepts a config extending this type.
+ *
+ * @example
+ * ```typescript
+ * import type { BaseToolConfig } from 'agentool';
+ * const config: BaseToolConfig = { cwd: '/my/project' };
+ * ```
+ */
+interface BaseToolConfig {
+    /**
+     * Working directory for file operations.
+     * Defaults to process.cwd() when not specified.
+     */
+    cwd?: string;
+}
+/**
+ * Result returned by tool execute functions.
+ * Tools always return strings -- never throw.
+ * Error results include operation, error type, and remediation.
+ *
+ * @example
+ * ```typescript
+ * import type { ToolResult } from 'agentool';
+ * const result: ToolResult = 'Found 3 matches in src/index.ts';
+ * ```
+ */
+type ToolResult = string;
+/**
+ * Configuration for tools that support timeouts.
+ * Extends {@link BaseToolConfig} with an optional timeout duration.
+ *
+ * @example
+ * ```typescript
+ * import type { TimeoutConfig } from 'agentool';
+ * const config: TimeoutConfig = { cwd: '/project', timeout: 30000 };
+ * ```
+ */
+interface TimeoutConfig extends BaseToolConfig {
+    /** Timeout in milliseconds. Defaults vary by tool. */
+    timeout?: number;
+}
+
+export type { BaseToolConfig as B, TimeoutConfig as T, ToolResult as a };

package/dist/web-fetch/index.cjs

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

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

@@ -0,0 +1,54 @@
+import * as ai from 'ai';
+import { T as TimeoutConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the web-fetch tool.
+ * Extends {@link TimeoutConfig} with optional content-length cap and user-agent.
+ *
+ * @example
+ * ```typescript
+ * const config: WebFetchConfig = {
+ *   timeout: 10000,
+ *   maxContentLength: 5 * 1024 * 1024,
+ *   userAgent: 'my-agent/1.0',
+ * };
+ * ```
+ */
+interface WebFetchConfig extends TimeoutConfig {
+    /** Maximum response body size in bytes. Passed to {@link fetchUrl}. */
+    maxContentLength?: number;
+    /** Custom User-Agent header sent with every request. */
+    userAgent?: string;
+}
+/**
+ * Factory that creates a web-fetch tool with the given configuration.
+ * The returned tool fetches a URL, automatically converts HTML to markdown
+ * via turndown, and truncates content at 100 000 characters.
+ *
+ * @param config - Optional configuration (timeout, max content length, user agent).
+ * @returns An AI SDK tool instance for fetching web pages.
+ *
+ * @example
+ * ```typescript
+ * import { createWebFetch } from 'agentool/web-fetch';
+ * const myTool = createWebFetch({ timeout: 5000 });
+ * ```
+ */
+declare function createWebFetch(config?: WebFetchConfig): ai.Tool<{
+    url: string;
+}, string>;
+/**
+ * Pre-configured web-fetch tool with default settings.
+ * Uses a 30 000 ms timeout, no content-length cap override, and no custom user-agent.
+ *
+ * @example
+ * ```typescript
+ * import { webFetch } from 'agentool/web-fetch';
+ * // Register directly with your AI SDK agent
+ * ```
+ */
+declare const webFetch: ai.Tool<{
+    url: string;
+}, string>;
+
+export { type WebFetchConfig, createWebFetch, webFetch };

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

@@ -0,0 +1,54 @@
+import * as ai from 'ai';
+import { T as TimeoutConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the web-fetch tool.
+ * Extends {@link TimeoutConfig} with optional content-length cap and user-agent.
+ *
+ * @example
+ * ```typescript
+ * const config: WebFetchConfig = {
+ *   timeout: 10000,
+ *   maxContentLength: 5 * 1024 * 1024,
+ *   userAgent: 'my-agent/1.0',
+ * };
+ * ```
+ */
+interface WebFetchConfig extends TimeoutConfig {
+    /** Maximum response body size in bytes. Passed to {@link fetchUrl}. */
+    maxContentLength?: number;
+    /** Custom User-Agent header sent with every request. */
+    userAgent?: string;
+}
+/**
+ * Factory that creates a web-fetch tool with the given configuration.
+ * The returned tool fetches a URL, automatically converts HTML to markdown
+ * via turndown, and truncates content at 100 000 characters.
+ *
+ * @param config - Optional configuration (timeout, max content length, user agent).
+ * @returns An AI SDK tool instance for fetching web pages.
+ *
+ * @example
+ * ```typescript
+ * import { createWebFetch } from 'agentool/web-fetch';
+ * const myTool = createWebFetch({ timeout: 5000 });
+ * ```
+ */
+declare function createWebFetch(config?: WebFetchConfig): ai.Tool<{
+    url: string;
+}, string>;
+/**
+ * Pre-configured web-fetch tool with default settings.
+ * Uses a 30 000 ms timeout, no content-length cap override, and no custom user-agent.
+ *
+ * @example
+ * ```typescript
+ * import { webFetch } from 'agentool/web-fetch';
+ * // Register directly with your AI SDK agent
+ * ```
+ */
+declare const webFetch: ai.Tool<{
+    url: string;
+}, string>;
+
+export { type WebFetchConfig, createWebFetch, webFetch };

package/dist/web-fetch/index.js

@@ -0,0 +1,8 @@
+import {
+  createWebFetch,
+  webFetch
+} 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

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

package/dist/write/index.d.cts

@@ -0,0 +1,47 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+type WriteConfig = BaseToolConfig;
+/**
+ * Creates a write tool that writes text content to a file.
+ *
+ * The tool creates parent directories as needed (mkdir -p behavior).
+ * If the file already exists it is overwritten, not appended.
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration with a custom working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createWrite } from 'agentool/write';
+ *
+ * const writeTool = createWrite({ cwd: '/my/project' });
+ * const result = await writeTool.execute(
+ *   { file_path: 'src/index.ts', content: 'export {}' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createWrite(config?: BaseToolConfig): ai.Tool<{
+    content: string;
+    file_path: string;
+}, string>;
+/**
+ * Default write tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { write } from 'agentool/write';
+ * const result = await write.execute(
+ *   { file_path: '/tmp/hello.txt', content: 'hello' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const write: ai.Tool<{
+    content: string;
+    file_path: string;
+}, string>;
+
+export { type WriteConfig, createWrite, write };

package/dist/write/index.d.ts

@@ -0,0 +1,47 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+type WriteConfig = BaseToolConfig;
+/**
+ * Creates a write tool that writes text content to a file.
+ *
+ * The tool creates parent directories as needed (mkdir -p behavior).
+ * If the file already exists it is overwritten, not appended.
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration with a custom working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createWrite } from 'agentool/write';
+ *
+ * const writeTool = createWrite({ cwd: '/my/project' });
+ * const result = await writeTool.execute(
+ *   { file_path: 'src/index.ts', content: 'export {}' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createWrite(config?: BaseToolConfig): ai.Tool<{
+    content: string;
+    file_path: string;
+}, string>;
+/**
+ * Default write tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { write } from 'agentool/write';
+ * const result = await write.execute(
+ *   { file_path: '/tmp/hello.txt', content: 'hello' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const write: ai.Tool<{
+    content: string;
+    file_path: string;
+}, string>;
+
+export { type WriteConfig, createWrite, write };

package/dist/write/index.js

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