agentool 0.0.1 → 1.1.0

package/dist/multi-edit/index.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk3VO6NETRcjs = require('../chunk-3VO6NETR.cjs');
+require('../chunk-5NW4OGRI.cjs');
+require('../chunk-CAEVLIQB.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createMultiEdit = _chunk3VO6NETRcjs.createMultiEdit; exports.multiEdit = _chunk3VO6NETRcjs.multiEdit;

package/dist/multi-edit/index.d.cts

@@ -0,0 +1,72 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the multi-edit tool.
+ *
+ * @example
+ * ```typescript
+ * import type { MultiEditConfig } from 'agentool/multi-edit';
+ * const config: MultiEditConfig = { cwd: '/my/project' };
+ * ```
+ */
+type MultiEditConfig = BaseToolConfig;
+/**
+ * Creates a multi-edit tool that atomically applies multiple string
+ * replacements to a single file.
+ *
+ * All edits are validated and applied in memory first. The file is only
+ * written when every edit succeeds. If any edit fails (not found or
+ * non-unique), the file is left unchanged and an error is returned.
+ *
+ * @param config - Optional configuration for the working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createMultiEdit } from 'agentool/multi-edit';
+ *
+ * const multiEditTool = createMultiEdit({ cwd: '/my/project' });
+ * const result = await multiEditTool.execute(
+ *   {
+ *     file_path: 'src/index.ts',
+ *     edits: [
+ *       { old_string: 'foo', new_string: 'bar' },
+ *       { old_string: 'baz', new_string: 'qux' },
+ *     ],
+ *   },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createMultiEdit(config?: MultiEditConfig): ai.Tool<{
+    file_path: string;
+    edits: {
+        old_string: string;
+        new_string: string;
+    }[];
+}, string>;
+/**
+ * Default multi-edit tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { multiEdit } from 'agentool/multi-edit';
+ * const result = await multiEdit.execute(
+ *   {
+ *     file_path: 'file.txt',
+ *     edits: [{ old_string: 'a', new_string: 'b' }],
+ *   },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const multiEdit: ai.Tool<{
+    file_path: string;
+    edits: {
+        old_string: string;
+        new_string: string;
+    }[];
+}, string>;
+
+export { type MultiEditConfig, createMultiEdit, multiEdit };

package/dist/multi-edit/index.d.ts

@@ -0,0 +1,72 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the multi-edit tool.
+ *
+ * @example
+ * ```typescript
+ * import type { MultiEditConfig } from 'agentool/multi-edit';
+ * const config: MultiEditConfig = { cwd: '/my/project' };
+ * ```
+ */
+type MultiEditConfig = BaseToolConfig;
+/**
+ * Creates a multi-edit tool that atomically applies multiple string
+ * replacements to a single file.
+ *
+ * All edits are validated and applied in memory first. The file is only
+ * written when every edit succeeds. If any edit fails (not found or
+ * non-unique), the file is left unchanged and an error is returned.
+ *
+ * @param config - Optional configuration for the working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createMultiEdit } from 'agentool/multi-edit';
+ *
+ * const multiEditTool = createMultiEdit({ cwd: '/my/project' });
+ * const result = await multiEditTool.execute(
+ *   {
+ *     file_path: 'src/index.ts',
+ *     edits: [
+ *       { old_string: 'foo', new_string: 'bar' },
+ *       { old_string: 'baz', new_string: 'qux' },
+ *     ],
+ *   },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createMultiEdit(config?: MultiEditConfig): ai.Tool<{
+    file_path: string;
+    edits: {
+        old_string: string;
+        new_string: string;
+    }[];
+}, string>;
+/**
+ * Default multi-edit tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { multiEdit } from 'agentool/multi-edit';
+ * const result = await multiEdit.execute(
+ *   {
+ *     file_path: 'file.txt',
+ *     edits: [{ old_string: 'a', new_string: 'b' }],
+ *   },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const multiEdit: ai.Tool<{
+    file_path: string;
+    edits: {
+        old_string: string;
+        new_string: string;
+    }[];
+}, string>;
+
+export { type MultiEditConfig, createMultiEdit, multiEdit };

package/dist/multi-edit/index.js

@@ -0,0 +1,11 @@
+import {
+  createMultiEdit,
+  multiEdit
+} from "../chunk-EA3YV7ZG.js";
+import "../chunk-G3ITTPGX.js";
+import "../chunk-6PQLFDGT.js";
+import "../chunk-I3ONDY7P.js";
+export {
+  createMultiEdit,
+  multiEdit
+};

package/dist/read/index.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkOM2UFTGScjs = require('../chunk-OM2UFTGS.cjs');
+require('../chunk-CAEVLIQB.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createRead = _chunkOM2UFTGScjs.createRead; exports.read = _chunkOM2UFTGScjs.read;

package/dist/read/index.d.cts

@@ -0,0 +1,67 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the read tool.
+ * Extends {@link BaseToolConfig} with an optional maximum line count.
+ *
+ * @example
+ * ```typescript
+ * import type { ReadConfig } from 'agentool/read';
+ * const config: ReadConfig = { cwd: '/my/project', maxLines: 500 };
+ * ```
+ */
+interface ReadConfig extends BaseToolConfig {
+    /**
+     * Maximum number of lines to return when no explicit limit is given.
+     * @default 2000
+     */
+    maxLines?: number;
+}
+/**
+ * Creates a read tool that reads file contents with line numbers.
+ *
+ * The tool resolves the given path (supporting `~` and relative paths),
+ * reads the requested range of lines, and returns the content with
+ * `cat -n` style line numbers. It never throws; errors are returned as
+ * descriptive strings.
+ *
+ * @param config - Optional configuration for cwd and max lines.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createRead } from 'agentool/read';
+ *
+ * const readTool = createRead({ cwd: '/my/project' });
+ * const result = await readTool.execute(
+ *   { file_path: 'src/index.ts' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createRead(config?: ReadConfig): ai.Tool<{
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, string>;
+/**
+ * Default read tool instance using the current working directory
+ * and a 2000-line default limit.
+ *
+ * @example
+ * ```typescript
+ * import { read } from 'agentool/read';
+ * const result = await read.execute(
+ *   { file_path: '/tmp/file.txt' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const read: ai.Tool<{
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, string>;
+
+export { type ReadConfig, createRead, read };

package/dist/read/index.d.ts

@@ -0,0 +1,67 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the read tool.
+ * Extends {@link BaseToolConfig} with an optional maximum line count.
+ *
+ * @example
+ * ```typescript
+ * import type { ReadConfig } from 'agentool/read';
+ * const config: ReadConfig = { cwd: '/my/project', maxLines: 500 };
+ * ```
+ */
+interface ReadConfig extends BaseToolConfig {
+    /**
+     * Maximum number of lines to return when no explicit limit is given.
+     * @default 2000
+     */
+    maxLines?: number;
+}
+/**
+ * Creates a read tool that reads file contents with line numbers.
+ *
+ * The tool resolves the given path (supporting `~` and relative paths),
+ * reads the requested range of lines, and returns the content with
+ * `cat -n` style line numbers. It never throws; errors are returned as
+ * descriptive strings.
+ *
+ * @param config - Optional configuration for cwd and max lines.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createRead } from 'agentool/read';
+ *
+ * const readTool = createRead({ cwd: '/my/project' });
+ * const result = await readTool.execute(
+ *   { file_path: 'src/index.ts' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createRead(config?: ReadConfig): ai.Tool<{
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, string>;
+/**
+ * Default read tool instance using the current working directory
+ * and a 2000-line default limit.
+ *
+ * @example
+ * ```typescript
+ * import { read } from 'agentool/read';
+ * const result = await read.execute(
+ *   { file_path: '/tmp/file.txt' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const read: ai.Tool<{
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, string>;
+
+export { type ReadConfig, createRead, read };

package/dist/read/index.js

@@ -0,0 +1,10 @@
+import {
+  createRead,
+  read
+} from "../chunk-ACGW44YT.js";
+import "../chunk-6PQLFDGT.js";
+import "../chunk-I3ONDY7P.js";
+export {
+  createRead,
+  read
+};

package/dist/sleep/index.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkOXLQ7QVLcjs = require('../chunk-OXLQ7QVL.cjs');
+
+
+
+exports.createSleep = _chunkOXLQ7QVLcjs.createSleep; exports.sleep = _chunkOXLQ7QVLcjs.sleep;

package/dist/sleep/index.d.cts

@@ -0,0 +1,60 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the sleep tool.
+ * Extends {@link BaseToolConfig} with an optional maximum duration cap.
+ *
+ * @example
+ * ```typescript
+ * import type { SleepConfig } from 'agentool/sleep';
+ * const config: SleepConfig = { maxDuration: 60000 };
+ * ```
+ */
+interface SleepConfig extends BaseToolConfig {
+    /**
+     * Maximum allowed sleep duration in milliseconds.
+     * Requested durations exceeding this value are clamped.
+     * @default 300000 (5 minutes)
+     */
+    maxDuration?: number;
+}
+/**
+ * Creates a sleep tool that pauses execution for a specified duration.
+ *
+ * The tool clamps the requested duration to `[0, maxDuration]` and reports
+ * the actual elapsed time. It never throws; errors are returned as strings.
+ *
+ * @param config - Optional configuration with a custom max duration.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createSleep } from 'agentool/sleep';
+ *
+ * // Default max of 300 000 ms
+ * const sleepTool = createSleep();
+ *
+ * // Custom max of 10 seconds
+ * const shortSleep = createSleep({ maxDuration: 10000 });
+ * ```
+ */
+declare function createSleep(config?: SleepConfig): ai.Tool<{
+    durationMs: number;
+    reason?: string | undefined;
+}, string>;
+/**
+ * Default sleep tool instance with a 300 000 ms (5-minute) maximum duration.
+ *
+ * @example
+ * ```typescript
+ * import { sleep } from 'agentool/sleep';
+ * const result = await sleep.execute({ durationMs: 1000, reason: 'rate limit' });
+ * ```
+ */
+declare const sleep: ai.Tool<{
+    durationMs: number;
+    reason?: string | undefined;
+}, string>;
+
+export { type SleepConfig, createSleep, sleep };

package/dist/sleep/index.d.ts

@@ -0,0 +1,60 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the sleep tool.
+ * Extends {@link BaseToolConfig} with an optional maximum duration cap.
+ *
+ * @example
+ * ```typescript
+ * import type { SleepConfig } from 'agentool/sleep';
+ * const config: SleepConfig = { maxDuration: 60000 };
+ * ```
+ */
+interface SleepConfig extends BaseToolConfig {
+    /**
+     * Maximum allowed sleep duration in milliseconds.
+     * Requested durations exceeding this value are clamped.
+     * @default 300000 (5 minutes)
+     */
+    maxDuration?: number;
+}
+/**
+ * Creates a sleep tool that pauses execution for a specified duration.
+ *
+ * The tool clamps the requested duration to `[0, maxDuration]` and reports
+ * the actual elapsed time. It never throws; errors are returned as strings.
+ *
+ * @param config - Optional configuration with a custom max duration.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createSleep } from 'agentool/sleep';
+ *
+ * // Default max of 300 000 ms
+ * const sleepTool = createSleep();
+ *
+ * // Custom max of 10 seconds
+ * const shortSleep = createSleep({ maxDuration: 10000 });
+ * ```
+ */
+declare function createSleep(config?: SleepConfig): ai.Tool<{
+    durationMs: number;
+    reason?: string | undefined;
+}, string>;
+/**
+ * Default sleep tool instance with a 300 000 ms (5-minute) maximum duration.
+ *
+ * @example
+ * ```typescript
+ * import { sleep } from 'agentool/sleep';
+ * const result = await sleep.execute({ durationMs: 1000, reason: 'rate limit' });
+ * ```
+ */
+declare const sleep: ai.Tool<{
+    durationMs: number;
+    reason?: string | undefined;
+}, string>;
+
+export { type SleepConfig, createSleep, sleep };

package/dist/sleep/index.js

@@ -0,0 +1,8 @@
+import {
+  createSleep,
+  sleep
+} from "../chunk-MF7CJVIZ.js";
+export {
+  createSleep,
+  sleep
+};

package/dist/task-create/index.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk56CL4JCWcjs = require('../chunk-56CL4JCW.cjs');
+require('../chunk-L5JH4I77.cjs');
+
+
+
+exports.createTaskCreate = _chunk56CL4JCWcjs.createTaskCreate; exports.taskCreate = _chunk56CL4JCWcjs.taskCreate;

package/dist/task-create/index.d.cts

@@ -0,0 +1,19 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+interface TaskCreateConfig extends BaseToolConfig {
+    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
+    tasksFile?: string;
+}
+declare function createTaskCreate(config?: TaskCreateConfig): ai.Tool<{
+    description: string;
+    subject: string;
+    metadata?: Record<string, unknown> | undefined;
+}, string>;
+declare const taskCreate: ai.Tool<{
+    description: string;
+    subject: string;
+    metadata?: Record<string, unknown> | undefined;
+}, string>;
+
+export { type TaskCreateConfig, createTaskCreate, taskCreate };

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

@@ -0,0 +1,19 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+interface TaskCreateConfig extends BaseToolConfig {
+    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
+    tasksFile?: string;
+}
+declare function createTaskCreate(config?: TaskCreateConfig): ai.Tool<{
+    description: string;
+    subject: string;
+    metadata?: Record<string, unknown> | undefined;
+}, string>;
+declare const taskCreate: ai.Tool<{
+    description: string;
+    subject: string;
+    metadata?: Record<string, unknown> | undefined;
+}, string>;
+
+export { type TaskCreateConfig, createTaskCreate, taskCreate };

package/dist/task-create/index.js

@@ -0,0 +1,9 @@
+import {
+  createTaskCreate,
+  taskCreate
+} from "../chunk-LTE5NG4D.js";
+import "../chunk-E6NBEYZD.js";
+export {
+  createTaskCreate,
+  taskCreate
+};

package/dist/task-get/index.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk4HXAKPQHcjs = require('../chunk-4HXAKPQH.cjs');
+require('../chunk-L5JH4I77.cjs');
+
+
+
+exports.createTaskGet = _chunk4HXAKPQHcjs.createTaskGet; exports.taskGet = _chunk4HXAKPQHcjs.taskGet;

package/dist/task-get/index.d.cts

@@ -0,0 +1,15 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+interface TaskGetConfig extends BaseToolConfig {
+    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
+    tasksFile?: string;
+}
+declare function createTaskGet(config?: TaskGetConfig): ai.Tool<{
+    taskId: string;
+}, string>;
+declare const taskGet: ai.Tool<{
+    taskId: string;
+}, string>;
+
+export { type TaskGetConfig, createTaskGet, taskGet };

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

@@ -0,0 +1,15 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+interface TaskGetConfig extends BaseToolConfig {
+    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
+    tasksFile?: string;
+}
+declare function createTaskGet(config?: TaskGetConfig): ai.Tool<{
+    taskId: string;
+}, string>;
+declare const taskGet: ai.Tool<{
+    taskId: string;
+}, string>;
+
+export { type TaskGetConfig, createTaskGet, taskGet };

package/dist/task-get/index.js

@@ -0,0 +1,9 @@
+import {
+  createTaskGet,
+  taskGet
+} from "../chunk-VXZ4RKJI.js";
+import "../chunk-E6NBEYZD.js";
+export {
+  createTaskGet,
+  taskGet
+};

package/dist/task-list/index.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkHNUL2CIDcjs = require('../chunk-HNUL2CID.cjs');
+require('../chunk-L5JH4I77.cjs');
+
+
+
+exports.createTaskList = _chunkHNUL2CIDcjs.createTaskList; exports.taskList = _chunkHNUL2CIDcjs.taskList;

package/dist/task-list/index.d.cts

@@ -0,0 +1,11 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+interface TaskListConfig extends BaseToolConfig {
+    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
+    tasksFile?: string;
+}
+declare function createTaskList(config?: TaskListConfig): ai.Tool<{}, string>;
+declare const taskList: ai.Tool<{}, string>;
+
+export { type TaskListConfig, createTaskList, taskList };

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

@@ -0,0 +1,11 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+interface TaskListConfig extends BaseToolConfig {
+    /** Path to the tasks JSON file. Defaults to `<cwd>/.agentool/tasks.json`. */
+    tasksFile?: string;
+}
+declare function createTaskList(config?: TaskListConfig): ai.Tool<{}, string>;
+declare const taskList: ai.Tool<{}, string>;
+
+export { type TaskListConfig, createTaskList, taskList };

package/dist/task-list/index.js

@@ -0,0 +1,9 @@
+import {
+  createTaskList,
+  taskList
+} from "../chunk-TMW3XKKJ.js";
+import "../chunk-E6NBEYZD.js";
+export {
+  createTaskList,
+  taskList
+};

package/dist/task-update/index.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkZFQZWXOIcjs = require('../chunk-ZFQZWXOI.cjs');
+require('../chunk-L5JH4I77.cjs');
+
+
+
+exports.createTaskUpdate = _chunkZFQZWXOIcjs.createTaskUpdate; exports.taskUpdate = _chunkZFQZWXOIcjs.taskUpdate;

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

@@ -0,0 +1,31 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+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 };