agentool 0.0.1 → 1.1.0

package/dist/context-compaction/index.d.ts

@@ -0,0 +1,77 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the context compaction tool.
+ * Extends {@link BaseToolConfig} with summarization options.
+ *
+ * @example
+ * ```typescript
+ * import { createContextCompaction } from 'agentool/context-compaction';
+ *
+ * const compactor = createContextCompaction({
+ *   summarize: async (msgs) => `Summary of ${msgs.length} messages`,
+ *   maxTokens: 2048,
+ * });
+ * ```
+ */
+interface ContextCompactionConfig extends BaseToolConfig {
+    /**
+     * Function that summarizes messages into a shorter form.
+     * Consumer must provide this for compaction to work.
+     */
+    summarize?: (messages: Array<{
+        role: string;
+        content: string;
+    }>) => Promise<string>;
+    /** Maximum tokens target. Defaults to 4096. */
+    maxTokens?: number;
+}
+/**
+ * Create a context compaction tool with the given configuration.
+ * Summarizes conversation history to reduce context size when it
+ * exceeds the token budget (estimated as maxTokens * 4 characters).
+ *
+ * @param config - Configuration including the summarize callback and token budget
+ * @returns An AI SDK tool that compacts conversation messages
+ *
+ * @example
+ * ```typescript
+ * import { createContextCompaction } from 'agentool/context-compaction';
+ *
+ * const compactor = createContextCompaction({
+ *   summarize: async (msgs) => {
+ *     // Call your LLM to summarize
+ *     return 'Condensed summary of the conversation';
+ *   },
+ *   maxTokens: 4096,
+ * });
+ * ```
+ */
+declare function createContextCompaction(config?: ContextCompactionConfig): ai.Tool<{
+    messages: {
+        content: string;
+        role: string;
+    }[];
+    maxTokens?: number | undefined;
+}, string>;
+/**
+ * Default context compaction tool instance with no summarize function.
+ * Configure with {@link createContextCompaction} for full functionality.
+ *
+ * @example
+ * ```typescript
+ * import { contextCompaction } from 'agentool/context-compaction';
+ * // Use directly — will return error if messages exceed budget
+ * // since no summarize function is configured.
+ * ```
+ */
+declare const contextCompaction: ai.Tool<{
+    messages: {
+        content: string;
+        role: string;
+    }[];
+    maxTokens?: number | undefined;
+}, string>;
+
+export { type ContextCompactionConfig, contextCompaction, createContextCompaction };

package/dist/context-compaction/index.js

@@ -0,0 +1,8 @@
+import {
+  contextCompaction,
+  createContextCompaction
+} from "../chunk-K77GC2QI.js";
+export {
+  contextCompaction,
+  createContextCompaction
+};

package/dist/diff/index.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkONBH74ZVcjs = require('../chunk-ONBH74ZV.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createDiff = _chunkONBH74ZVcjs.createDiff; exports.diff = _chunkONBH74ZVcjs.diff;

package/dist/diff/index.d.cts

@@ -0,0 +1,72 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the diff tool.
+ *
+ * @example
+ * ```typescript
+ * import type { DiffConfig } from 'agentool/diff';
+ * const config: DiffConfig = { cwd: '/my/project' };
+ * ```
+ */
+type DiffConfig = BaseToolConfig;
+/**
+ * Creates a diff tool that generates unified diffs between files or strings.
+ *
+ * Supports three modes:
+ * 1. Two file paths: diffs the contents of both files.
+ * 2. Two strings: diffs old_content against new_content.
+ * 3. One file path + string content: reads the file and diffs against
+ *    the provided content.
+ *
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration for the working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createDiff } from 'agentool/diff';
+ *
+ * const diffTool = createDiff({ cwd: '/my/project' });
+ *
+ * // Diff two files
+ * await diffTool.execute(
+ *   { file_path: 'a.txt', other_file_path: 'b.txt' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ *
+ * // Diff two strings
+ * await diffTool.execute(
+ *   { old_content: 'hello\n', new_content: 'world\n' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createDiff(config?: DiffConfig): ai.Tool<{
+    file_path?: string | undefined;
+    other_file_path?: string | undefined;
+    old_content?: string | undefined;
+    new_content?: string | undefined;
+}, string>;
+/**
+ * Default diff tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { diff } from 'agentool/diff';
+ * const result = await diff.execute(
+ *   { old_content: 'hello\n', new_content: 'world\n' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const diff: ai.Tool<{
+    file_path?: string | undefined;
+    other_file_path?: string | undefined;
+    old_content?: string | undefined;
+    new_content?: string | undefined;
+}, string>;
+
+export { type DiffConfig, createDiff, diff };

package/dist/diff/index.d.ts

@@ -0,0 +1,72 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the diff tool.
+ *
+ * @example
+ * ```typescript
+ * import type { DiffConfig } from 'agentool/diff';
+ * const config: DiffConfig = { cwd: '/my/project' };
+ * ```
+ */
+type DiffConfig = BaseToolConfig;
+/**
+ * Creates a diff tool that generates unified diffs between files or strings.
+ *
+ * Supports three modes:
+ * 1. Two file paths: diffs the contents of both files.
+ * 2. Two strings: diffs old_content against new_content.
+ * 3. One file path + string content: reads the file and diffs against
+ *    the provided content.
+ *
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration for the working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createDiff } from 'agentool/diff';
+ *
+ * const diffTool = createDiff({ cwd: '/my/project' });
+ *
+ * // Diff two files
+ * await diffTool.execute(
+ *   { file_path: 'a.txt', other_file_path: 'b.txt' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ *
+ * // Diff two strings
+ * await diffTool.execute(
+ *   { old_content: 'hello\n', new_content: 'world\n' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createDiff(config?: DiffConfig): ai.Tool<{
+    file_path?: string | undefined;
+    other_file_path?: string | undefined;
+    old_content?: string | undefined;
+    new_content?: string | undefined;
+}, string>;
+/**
+ * Default diff tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { diff } from 'agentool/diff';
+ * const result = await diff.execute(
+ *   { old_content: 'hello\n', new_content: 'world\n' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const diff: ai.Tool<{
+    file_path?: string | undefined;
+    other_file_path?: string | undefined;
+    old_content?: string | undefined;
+    new_content?: string | undefined;
+}, string>;
+
+export { type DiffConfig, createDiff, diff };

package/dist/diff/index.js

@@ -0,0 +1,9 @@
+import {
+  createDiff,
+  diff
+} from "../chunk-CGTPF6IS.js";
+import "../chunk-I3ONDY7P.js";
+export {
+  createDiff,
+  diff
+};

package/dist/edit/index.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkZBLQV6UOcjs = require('../chunk-ZBLQV6UO.cjs');
+require('../chunk-5NW4OGRI.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createEdit = _chunkZBLQV6UOcjs.createEdit; exports.edit = _chunkZBLQV6UOcjs.edit;

package/dist/edit/index.d.cts

@@ -0,0 +1,53 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+type EditConfig = BaseToolConfig;
+/**
+ * Creates an edit tool that performs string replacements in files.
+ *
+ * The tool locates `old_string` within the target file and replaces it with
+ * `new_string`. It supports curly-quote fallback matching via
+ * {@link findActualString} and preserves the file's quote style via
+ * {@link preserveQuoteStyle}. Execute never throws; errors are returned as
+ * descriptive strings.
+ *
+ * @param config - Optional configuration for the working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createEdit } from 'agentool/edit';
+ *
+ * const editTool = createEdit({ cwd: '/my/project' });
+ * const result = await editTool.execute(
+ *   { file_path: 'src/index.ts', old_string: 'foo', new_string: 'bar' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createEdit(config?: BaseToolConfig): ai.Tool<{
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}, string>;
+/**
+ * Default edit tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { edit } from 'agentool/edit';
+ * const result = await edit.execute(
+ *   { file_path: 'src/index.ts', old_string: 'foo', new_string: 'bar' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const edit: ai.Tool<{
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}, string>;
+
+export { type EditConfig, createEdit, edit };

package/dist/edit/index.d.ts

@@ -0,0 +1,53 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+type EditConfig = BaseToolConfig;
+/**
+ * Creates an edit tool that performs string replacements in files.
+ *
+ * The tool locates `old_string` within the target file and replaces it with
+ * `new_string`. It supports curly-quote fallback matching via
+ * {@link findActualString} and preserves the file's quote style via
+ * {@link preserveQuoteStyle}. Execute never throws; errors are returned as
+ * descriptive strings.
+ *
+ * @param config - Optional configuration for the working directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createEdit } from 'agentool/edit';
+ *
+ * const editTool = createEdit({ cwd: '/my/project' });
+ * const result = await editTool.execute(
+ *   { file_path: 'src/index.ts', old_string: 'foo', new_string: 'bar' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createEdit(config?: BaseToolConfig): ai.Tool<{
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}, string>;
+/**
+ * Default edit tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { edit } from 'agentool/edit';
+ * const result = await edit.execute(
+ *   { file_path: 'src/index.ts', old_string: 'foo', new_string: 'bar' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const edit: ai.Tool<{
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}, string>;
+
+export { type EditConfig, createEdit, edit };

package/dist/edit/index.js

@@ -0,0 +1,10 @@
+import {
+  createEdit,
+  edit
+} from "../chunk-P6Z5XFDS.js";
+import "../chunk-G3ITTPGX.js";
+import "../chunk-I3ONDY7P.js";
+export {
+  createEdit,
+  edit
+};

package/dist/glob/index.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkYPPPGGLAcjs = require('../chunk-YPPPGGLA.cjs');
+require('../chunk-MIYA7TNR.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createGlob = _chunkYPPPGGLAcjs.createGlob; exports.glob = _chunkYPPPGGLAcjs.glob;

package/dist/glob/index.d.cts

@@ -0,0 +1,47 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Creates a glob tool that finds files matching a pattern.
+ *
+ * Uses ripgrep `--files --glob` under the hood for fast file matching.
+ * Returns absolute paths sorted by modification time (newest first).
+ * 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 { createGlob } from 'agentool/glob';
+ *
+ * const globTool = createGlob({ cwd: '/my/project' });
+ * const result = await globTool.execute(
+ *   { pattern: '**\/*.ts' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createGlob(config?: BaseToolConfig): ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+}, string>;
+/**
+ * Default glob tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { glob } from 'agentool/glob';
+ * const result = await glob.execute(
+ *   { pattern: '**\/*.ts' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+type GlobConfig = BaseToolConfig;
+declare const glob: ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+}, string>;
+
+export { type GlobConfig, createGlob, glob };

package/dist/glob/index.d.ts

@@ -0,0 +1,47 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Creates a glob tool that finds files matching a pattern.
+ *
+ * Uses ripgrep `--files --glob` under the hood for fast file matching.
+ * Returns absolute paths sorted by modification time (newest first).
+ * 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 { createGlob } from 'agentool/glob';
+ *
+ * const globTool = createGlob({ cwd: '/my/project' });
+ * const result = await globTool.execute(
+ *   { pattern: '**\/*.ts' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createGlob(config?: BaseToolConfig): ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+}, string>;
+/**
+ * Default glob tool instance using the current working directory.
+ *
+ * @example
+ * ```typescript
+ * import { glob } from 'agentool/glob';
+ * const result = await glob.execute(
+ *   { pattern: '**\/*.ts' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+type GlobConfig = BaseToolConfig;
+declare const glob: ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+}, string>;
+
+export { type GlobConfig, createGlob, glob };

package/dist/glob/index.js

@@ -0,0 +1,10 @@
+import {
+  createGlob,
+  glob
+} from "../chunk-HZAQRHBT.js";
+import "../chunk-MJCAXASI.js";
+import "../chunk-I3ONDY7P.js";
+export {
+  createGlob,
+  glob
+};

package/dist/grep/index.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkHNP7JDQCcjs = require('../chunk-HNP7JDQC.cjs');
+require('../chunk-MIYA7TNR.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createGrep = _chunkHNP7JDQCcjs.createGrep; exports.grep = _chunkHNP7JDQCcjs.grep;

package/dist/grep/index.d.cts

@@ -0,0 +1,50 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Creates a grep tool that searches file contents using ripgrep.
+ *
+ * Supports three output modes: content, files_with_matches, and count.
+ * 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`.
+ */
+declare function createGrep(config?: BaseToolConfig): ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+    type?: string | undefined;
+    glob?: string | undefined;
+    output_mode?: "content" | "files_with_matches" | "count" | undefined;
+    '-B'?: number | undefined;
+    '-A'?: number | undefined;
+    '-C'?: number | undefined;
+    context?: number | undefined;
+    '-n'?: boolean | undefined;
+    '-i'?: boolean | undefined;
+    head_limit?: number | undefined;
+    offset?: number | undefined;
+    multiline?: boolean | undefined;
+}, string>;
+/**
+ * Default grep tool instance using the current working directory.
+ */
+type GrepConfig = BaseToolConfig;
+declare const grep: ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+    type?: string | undefined;
+    glob?: string | undefined;
+    output_mode?: "content" | "files_with_matches" | "count" | undefined;
+    '-B'?: number | undefined;
+    '-A'?: number | undefined;
+    '-C'?: number | undefined;
+    context?: number | undefined;
+    '-n'?: boolean | undefined;
+    '-i'?: boolean | undefined;
+    head_limit?: number | undefined;
+    offset?: number | undefined;
+    multiline?: boolean | undefined;
+}, string>;
+
+export { type GrepConfig, createGrep, grep };

package/dist/grep/index.d.ts

@@ -0,0 +1,50 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Creates a grep tool that searches file contents using ripgrep.
+ *
+ * Supports three output modes: content, files_with_matches, and count.
+ * 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`.
+ */
+declare function createGrep(config?: BaseToolConfig): ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+    type?: string | undefined;
+    glob?: string | undefined;
+    output_mode?: "content" | "files_with_matches" | "count" | undefined;
+    '-B'?: number | undefined;
+    '-A'?: number | undefined;
+    '-C'?: number | undefined;
+    context?: number | undefined;
+    '-n'?: boolean | undefined;
+    '-i'?: boolean | undefined;
+    head_limit?: number | undefined;
+    offset?: number | undefined;
+    multiline?: boolean | undefined;
+}, string>;
+/**
+ * Default grep tool instance using the current working directory.
+ */
+type GrepConfig = BaseToolConfig;
+declare const grep: ai.Tool<{
+    pattern: string;
+    path?: string | undefined;
+    type?: string | undefined;
+    glob?: string | undefined;
+    output_mode?: "content" | "files_with_matches" | "count" | undefined;
+    '-B'?: number | undefined;
+    '-A'?: number | undefined;
+    '-C'?: number | undefined;
+    context?: number | undefined;
+    '-n'?: boolean | undefined;
+    '-i'?: boolean | undefined;
+    head_limit?: number | undefined;
+    offset?: number | undefined;
+    multiline?: boolean | undefined;
+}, string>;
+
+export { type GrepConfig, createGrep, grep };

package/dist/grep/index.js

@@ -0,0 +1,10 @@
+import {
+  createGrep,
+  grep
+} from "../chunk-UDIG7332.js";
+import "../chunk-MJCAXASI.js";
+import "../chunk-I3ONDY7P.js";
+export {
+  createGrep,
+  grep
+};

package/dist/http-request/index.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkI6KFFQPVcjs = require('../chunk-I6KFFQPV.cjs');
+
+
+
+exports.createHttpRequest = _chunkI6KFFQPVcjs.createHttpRequest; exports.httpRequest = _chunkI6KFFQPVcjs.httpRequest;