agentool 0.0.1 → 1.0.0

package/dist/chunk-YPPPGGLA.cjs

@@ -0,0 +1,99 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkMIYA7TNRcjs = require('./chunk-MIYA7TNR.cjs');
+
+
+var _chunkQZ5GS6HWcjs = require('./chunk-QZ5GS6HW.cjs');
+
+// src/glob/index.ts
+var _ai = require('ai');
+var _zod = require('zod');
+
+// src/shared/glob.ts
+var _path = require('path');
+function extractGlobBaseDirectory(pattern) {
+  const globChars = /[*?[{]/;
+  const match = pattern.match(globChars);
+  if (!match || match.index === void 0) {
+    const dir = _path.dirname.call(void 0, pattern);
+    const file = _path.basename.call(void 0, pattern);
+    return { baseDir: dir, relativePattern: file };
+  }
+  const staticPrefix = pattern.slice(0, match.index);
+  const lastSepIndex = Math.max(
+    staticPrefix.lastIndexOf("/"),
+    staticPrefix.lastIndexOf(_path.sep)
+  );
+  if (lastSepIndex === -1) {
+    return { baseDir: "", relativePattern: pattern };
+  }
+  let baseDir = staticPrefix.slice(0, lastSepIndex);
+  const relativePattern = pattern.slice(lastSepIndex + 1);
+  if (baseDir === "" && lastSepIndex === 0) {
+    baseDir = "/";
+  }
+  return { baseDir, relativePattern };
+}
+async function glob(pattern, cwd, options) {
+  const limit = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.limit]), () => ( 100));
+  const offset = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _2 => _2.offset]), () => ( 0));
+  let searchDir = cwd;
+  let searchPattern = pattern;
+  if (_path.isAbsolute.call(void 0, pattern)) {
+    const { baseDir, relativePattern } = extractGlobBaseDirectory(pattern);
+    if (baseDir) {
+      searchDir = baseDir;
+      searchPattern = relativePattern;
+    }
+  }
+  const args = [
+    "--files",
+    "--glob",
+    searchPattern,
+    "--sort=modified",
+    "--hidden",
+    "--no-ignore"
+  ];
+  const allPaths = await _chunkMIYA7TNRcjs.executeRipgrep.call(void 0, args, searchDir, {
+    signal: _optionalChain([options, 'optionalAccess', _3 => _3.signal])
+  });
+  const absolutePaths = allPaths.map(
+    (p) => _path.isAbsolute.call(void 0, p) ? p : _path.join.call(void 0, searchDir, p)
+  );
+  const truncated = absolutePaths.length > offset + limit;
+  const files = absolutePaths.slice(offset, offset + limit);
+  return { files, truncated };
+}
+
+// src/glob/index.ts
+function createGlob(config = {}) {
+  const cwd = _nullishCoalesce(config.cwd, () => ( process.cwd()));
+  return _ai.tool.call(void 0, {
+    description: 'Find files matching a glob pattern. Returns absolute file paths sorted by modification time (newest first). Supports patterns like "**/*.ts", "src/**/*.js", or "*.json".',
+    inputSchema: _zod.z.object({
+      pattern: _zod.z.string().describe("Glob pattern to match files against"),
+      path: _zod.z.string().optional().describe("Directory to search in. Defaults to the working directory.")
+    }),
+    execute: async ({ pattern, path }) => {
+      try {
+        const searchDir = path ? _chunkQZ5GS6HWcjs.expandPath.call(void 0, path, cwd) : cwd;
+        const { files, truncated } = await glob(pattern, searchDir);
+        if (files.length === 0) {
+          return "No files found";
+        }
+        const header = truncated ? `Found ${files.length}+ files (results truncated)` : `Found ${files.length} files`;
+        return `${header}
+${files.join("\n")}`;
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return `Error [glob]: Failed to search for files: ${message}`;
+      }
+    }
+  });
+}
+var glob2 = createGlob();
+
+
+
+
+exports.createGlob = createGlob; exports.glob = glob2;

package/dist/chunk-ZHCMEQJJ.js

@@ -0,0 +1,47 @@
+import {
+  addLineNumbers,
+  readFileInRange
+} from "./chunk-6PQLFDGT.js";
+import {
+  expandPath
+} from "./chunk-I3ONDY7P.js";
+
+// src/read/index.ts
+import { tool } from "ai";
+import { z } from "zod";
+function createRead(config = {}) {
+  const cwd = config.cwd ?? process.cwd();
+  const defaultMaxLines = config.maxLines ?? 2e3;
+  return tool({
+    description: 'Read a file from the local filesystem and return its contents with line numbers. Supports absolute paths, relative paths (resolved against the working directory), and tilde (~) home directory expansion. Returns numbered lines in "lineNumber\\tcontent" format. Use offset and limit to read specific ranges of large files.',
+    inputSchema: z.object({
+      file_path: z.string().describe("The path to the file to read (absolute, relative, or ~/...)"),
+      offset: z.number().optional().describe("0-indexed line number to start reading from (default: 0)"),
+      limit: z.number().optional().describe("Maximum number of lines to return (default: 2000)")
+    }),
+    execute: async ({ file_path, offset, limit }) => {
+      try {
+        const absolutePath = expandPath(file_path, cwd);
+        const result = await readFileInRange(
+          absolutePath,
+          offset ?? 0,
+          limit ?? defaultMaxLines
+        );
+        const numbered = addLineNumbers({
+          content: result.content,
+          startLine: (offset ?? 0) + 1
+        });
+        return numbered;
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error [read]: ${msg}`;
+      }
+    }
+  });
+}
+var read = createRead();
+
+export {
+  createRead,
+  read
+};

package/dist/context-compaction/index.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkFW3UJ622cjs = require('../chunk-FW3UJ622.cjs');
+
+
+
+exports.contextCompaction = _chunkFW3UJ622cjs.contextCompaction; exports.createContextCompaction = _chunkFW3UJ622cjs.createContextCompaction;

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

@@ -0,0 +1,77 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * 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.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 _chunkMXFW3XY6cjs = require('../chunk-MXFW3XY6.cjs');
+require('../chunk-5NW4OGRI.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createEdit = _chunkMXFW3XY6cjs.createEdit; exports.edit = _chunkMXFW3XY6cjs.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;
+}, 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;
+}, 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;
+}, 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;
+}, string>;
+
+export { type EditConfig, createEdit, edit };

package/dist/edit/index.js

@@ -0,0 +1,10 @@
+import {
+  createEdit,
+  edit
+} from "../chunk-S6QEY7UY.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 };