agentool 0.0.1 → 1.1.0

package/dist/http-request/index.d.cts

@@ -0,0 +1,60 @@
+import * as ai from 'ai';
+import { T as TimeoutConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the HTTP request tool.
+ * Extends {@link TimeoutConfig} with optional default headers
+ * applied to every request.
+ *
+ * @example
+ * ```typescript
+ * const config: HttpRequestConfig = {
+ *   timeout: 10000,
+ *   defaultHeaders: { Authorization: 'Bearer token' },
+ * };
+ * ```
+ */
+interface HttpRequestConfig extends TimeoutConfig {
+    /** Headers merged into every request (per-request headers take precedence). */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Factory that creates an HTTP request tool with the given configuration.
+ * The returned tool uses native `fetch()` and returns raw status, headers,
+ * and body -- no markdown conversion.
+ *
+ * @param config - Optional configuration (timeout, default headers).
+ * @returns An AI SDK tool instance for making HTTP requests.
+ *
+ * @example
+ * ```typescript
+ * import { createHttpRequest } from 'agentool/http-request';
+ * const myTool = createHttpRequest({ timeout: 5000 });
+ * ```
+ */
+declare function createHttpRequest(config?: HttpRequestConfig): ai.Tool<{
+    url: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}, string>;
+/**
+ * Pre-configured HTTP request tool with default settings.
+ * Uses a 30 000 ms timeout and no default headers.
+ *
+ * @example
+ * ```typescript
+ * import { httpRequest } from 'agentool/http-request';
+ * // Register directly with your AI SDK agent
+ * ```
+ */
+declare const httpRequest: ai.Tool<{
+    url: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}, string>;
+
+export { type HttpRequestConfig, createHttpRequest, httpRequest };

package/dist/http-request/index.d.ts

@@ -0,0 +1,60 @@
+import * as ai from 'ai';
+import { T as TimeoutConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the HTTP request tool.
+ * Extends {@link TimeoutConfig} with optional default headers
+ * applied to every request.
+ *
+ * @example
+ * ```typescript
+ * const config: HttpRequestConfig = {
+ *   timeout: 10000,
+ *   defaultHeaders: { Authorization: 'Bearer token' },
+ * };
+ * ```
+ */
+interface HttpRequestConfig extends TimeoutConfig {
+    /** Headers merged into every request (per-request headers take precedence). */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Factory that creates an HTTP request tool with the given configuration.
+ * The returned tool uses native `fetch()` and returns raw status, headers,
+ * and body -- no markdown conversion.
+ *
+ * @param config - Optional configuration (timeout, default headers).
+ * @returns An AI SDK tool instance for making HTTP requests.
+ *
+ * @example
+ * ```typescript
+ * import { createHttpRequest } from 'agentool/http-request';
+ * const myTool = createHttpRequest({ timeout: 5000 });
+ * ```
+ */
+declare function createHttpRequest(config?: HttpRequestConfig): ai.Tool<{
+    url: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}, string>;
+/**
+ * Pre-configured HTTP request tool with default settings.
+ * Uses a 30 000 ms timeout and no default headers.
+ *
+ * @example
+ * ```typescript
+ * import { httpRequest } from 'agentool/http-request';
+ * // Register directly with your AI SDK agent
+ * ```
+ */
+declare const httpRequest: ai.Tool<{
+    url: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}, string>;
+
+export { type HttpRequestConfig, createHttpRequest, httpRequest };

package/dist/http-request/index.js

@@ -0,0 +1,8 @@
+import {
+  createHttpRequest,
+  httpRequest
+} from "../chunk-LPV5CN2K.js";
+export {
+  createHttpRequest,
+  httpRequest
+};

package/dist/index.cjs

@@ -0,0 +1,133 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkIEX4NOVNcjs = require('./chunk-IEX4NOVN.cjs');
+
+
+
+var _chunk5TDZF4IMcjs = require('./chunk-5TDZF4IM.cjs');
+
+
+
+var _chunkI6KFFQPVcjs = require('./chunk-I6KFFQPV.cjs');
+
+
+
+var _chunkFW3UJ622cjs = require('./chunk-FW3UJ622.cjs');
+
+
+
+var _chunk3EPGFWZVcjs = require('./chunk-3EPGFWZV.cjs');
+
+
+
+var _chunkOXLQ7QVLcjs = require('./chunk-OXLQ7QVL.cjs');
+
+
+
+var _chunkFV2R5FFQcjs = require('./chunk-FV2R5FFQ.cjs');
+
+
+
+var _chunk3VO6NETRcjs = require('./chunk-3VO6NETR.cjs');
+
+
+
+var _chunkONBH74ZVcjs = require('./chunk-ONBH74ZV.cjs');
+
+
+
+var _chunk56CL4JCWcjs = require('./chunk-56CL4JCW.cjs');
+
+
+
+var _chunk4HXAKPQHcjs = require('./chunk-4HXAKPQH.cjs');
+
+
+
+var _chunkZFQZWXOIcjs = require('./chunk-ZFQZWXOI.cjs');
+
+
+
+var _chunkHNUL2CIDcjs = require('./chunk-HNUL2CID.cjs');
+require('./chunk-L5JH4I77.cjs');
+
+
+
+var _chunkLK6SQH2Gcjs = require('./chunk-LK6SQH2G.cjs');
+
+
+
+var _chunkSUSAPI5Wcjs = require('./chunk-SUSAPI5W.cjs');
+
+
+
+var _chunkHNP7JDQCcjs = require('./chunk-HNP7JDQC.cjs');
+
+
+
+var _chunkYPPPGGLAcjs = require('./chunk-YPPPGGLA.cjs');
+require('./chunk-MIYA7TNR.cjs');
+
+
+
+var _chunkOM2UFTGScjs = require('./chunk-OM2UFTGS.cjs');
+
+
+
+var _chunkZBLQV6UOcjs = require('./chunk-ZBLQV6UO.cjs');
+require('./chunk-5NW4OGRI.cjs');
+
+
+
+var _chunk6DJSWTWQcjs = require('./chunk-6DJSWTWQ.cjs');
+require('./chunk-CAEVLIQB.cjs');
+require('./chunk-QZ5GS6HW.cjs');
+
+
+
+var _chunk5O55DKOBcjs = require('./chunk-5O55DKOB.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.askUser = _chunk3EPGFWZVcjs.askUser; exports.bash = _chunkSUSAPI5Wcjs.bash; exports.contextCompaction = _chunkFW3UJ622cjs.contextCompaction; exports.createAskUser = _chunk3EPGFWZVcjs.createAskUser; exports.createBash = _chunkSUSAPI5Wcjs.createBash; exports.createContextCompaction = _chunkFW3UJ622cjs.createContextCompaction; exports.createDiff = _chunkONBH74ZVcjs.createDiff; exports.createEdit = _chunkZBLQV6UOcjs.createEdit; exports.createGlob = _chunkYPPPGGLAcjs.createGlob; exports.createGrep = _chunkHNP7JDQCcjs.createGrep; exports.createHttpRequest = _chunkI6KFFQPVcjs.createHttpRequest; exports.createLsp = _chunk5TDZF4IMcjs.createLsp; exports.createMemory = _chunkFV2R5FFQcjs.createMemory; exports.createMultiEdit = _chunk3VO6NETRcjs.createMultiEdit; exports.createRead = _chunkOM2UFTGScjs.createRead; exports.createSleep = _chunkOXLQ7QVLcjs.createSleep; exports.createTaskCreate = _chunk56CL4JCWcjs.createTaskCreate; exports.createTaskGet = _chunk4HXAKPQHcjs.createTaskGet; exports.createTaskList = _chunkHNUL2CIDcjs.createTaskList; exports.createTaskUpdate = _chunkZFQZWXOIcjs.createTaskUpdate; exports.createToolSearch = _chunkIEX4NOVNcjs.createToolSearch; exports.createWebFetch = _chunk5O55DKOBcjs.createWebFetch; exports.createWebSearch = _chunkLK6SQH2Gcjs.createWebSearch; exports.createWrite = _chunk6DJSWTWQcjs.createWrite; exports.diff = _chunkONBH74ZVcjs.diff; exports.edit = _chunkZBLQV6UOcjs.edit; exports.glob = _chunkYPPPGGLAcjs.glob; exports.grep = _chunkHNP7JDQCcjs.grep; exports.httpRequest = _chunkI6KFFQPVcjs.httpRequest; exports.lsp = _chunk5TDZF4IMcjs.lsp; exports.memory = _chunkFV2R5FFQcjs.memory; exports.multiEdit = _chunk3VO6NETRcjs.multiEdit; exports.read = _chunkOM2UFTGScjs.read; exports.sleep = _chunkOXLQ7QVLcjs.sleep; exports.taskCreate = _chunk56CL4JCWcjs.taskCreate; exports.taskGet = _chunk4HXAKPQHcjs.taskGet; exports.taskList = _chunkHNUL2CIDcjs.taskList; exports.taskUpdate = _chunkZFQZWXOIcjs.taskUpdate; exports.toolSearch = _chunkIEX4NOVNcjs.toolSearch; exports.webFetch = _chunk5O55DKOBcjs.webFetch; exports.webSearch = _chunkLK6SQH2Gcjs.webSearch; exports.write = _chunk6DJSWTWQcjs.write;

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+export { BashConfig, bash, createBash } from './bash/index.cjs';
+export { GrepConfig, createGrep, grep } from './grep/index.cjs';
+export { GlobConfig, createGlob, glob } from './glob/index.cjs';
+export { ReadConfig, createRead, read } from './read/index.cjs';
+export { EditConfig, createEdit, edit } from './edit/index.cjs';
+export { WriteConfig, createWrite, write } from './write/index.cjs';
+export { WebFetchConfig, createWebFetch, webFetch } from './web-fetch/index.cjs';
+export { MemoryConfig, createMemory, memory } from './memory/index.cjs';
+export { MultiEditConfig, createMultiEdit, multiEdit } from './multi-edit/index.cjs';
+export { DiffConfig, createDiff, diff } from './diff/index.cjs';
+export { TaskCreateConfig, createTaskCreate, taskCreate } from './task-create/index.cjs';
+export { TaskGetConfig, createTaskGet, taskGet } from './task-get/index.cjs';
+export { TaskUpdateConfig, createTaskUpdate, taskUpdate } from './task-update/index.cjs';
+export { TaskListConfig, createTaskList, taskList } from './task-list/index.cjs';
+export { WebSearchConfig, createWebSearch, webSearch } from './web-search/index.cjs';
+export { ToolSearchConfig, createToolSearch, toolSearch } from './tool-search/index.cjs';
+export { LspConfig, createLsp, lsp } from './lsp/index.cjs';
+export { HttpRequestConfig, createHttpRequest, httpRequest } from './http-request/index.cjs';
+export { ContextCompactionConfig, contextCompaction, createContextCompaction } from './context-compaction/index.cjs';
+export { AskUserConfig, askUser, createAskUser } from './ask-user/index.cjs';
+export { SleepConfig, createSleep, sleep } from './sleep/index.cjs';
+export { B as BaseToolConfig, T as TimeoutConfig, a as ToolResult } from './types-3QPDuCXN.cjs';
+import 'ai';

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { BashConfig, bash, createBash } from './bash/index.js';
+export { GrepConfig, createGrep, grep } from './grep/index.js';
+export { GlobConfig, createGlob, glob } from './glob/index.js';
+export { ReadConfig, createRead, read } from './read/index.js';
+export { EditConfig, createEdit, edit } from './edit/index.js';
+export { WriteConfig, createWrite, write } from './write/index.js';
+export { WebFetchConfig, createWebFetch, webFetch } from './web-fetch/index.js';
+export { MemoryConfig, createMemory, memory } from './memory/index.js';
+export { MultiEditConfig, createMultiEdit, multiEdit } from './multi-edit/index.js';
+export { DiffConfig, createDiff, diff } from './diff/index.js';
+export { TaskCreateConfig, createTaskCreate, taskCreate } from './task-create/index.js';
+export { TaskGetConfig, createTaskGet, taskGet } from './task-get/index.js';
+export { TaskUpdateConfig, createTaskUpdate, taskUpdate } from './task-update/index.js';
+export { TaskListConfig, createTaskList, taskList } from './task-list/index.js';
+export { WebSearchConfig, createWebSearch, webSearch } from './web-search/index.js';
+export { ToolSearchConfig, createToolSearch, toolSearch } from './tool-search/index.js';
+export { LspConfig, createLsp, lsp } from './lsp/index.js';
+export { HttpRequestConfig, createHttpRequest, httpRequest } from './http-request/index.js';
+export { ContextCompactionConfig, contextCompaction, createContextCompaction } from './context-compaction/index.js';
+export { AskUserConfig, askUser, createAskUser } from './ask-user/index.js';
+export { SleepConfig, createSleep, sleep } from './sleep/index.js';
+export { B as BaseToolConfig, T as TimeoutConfig, a as ToolResult } from './types-3QPDuCXN.js';
+import 'ai';

package/dist/index.js

@@ -0,0 +1,133 @@
+import {
+  createToolSearch,
+  toolSearch
+} from "./chunk-IRRNYFI5.js";
+import {
+  createLsp,
+  lsp
+} from "./chunk-XAQGZ374.js";
+import {
+  createHttpRequest,
+  httpRequest
+} from "./chunk-LPV5CN2K.js";
+import {
+  contextCompaction,
+  createContextCompaction
+} from "./chunk-K77GC2QI.js";
+import {
+  askUser,
+  createAskUser
+} from "./chunk-HDKXSKMO.js";
+import {
+  createSleep,
+  sleep
+} from "./chunk-MF7CJVIZ.js";
+import {
+  createMemory,
+  memory
+} from "./chunk-VLNDEVKS.js";
+import {
+  createMultiEdit,
+  multiEdit
+} from "./chunk-EA3YV7ZG.js";
+import {
+  createDiff,
+  diff
+} from "./chunk-CGTPF6IS.js";
+import {
+  createTaskCreate,
+  taskCreate
+} from "./chunk-LTE5NG4D.js";
+import {
+  createTaskGet,
+  taskGet
+} from "./chunk-VXZ4RKJI.js";
+import {
+  createTaskUpdate,
+  taskUpdate
+} from "./chunk-S7IVHOA6.js";
+import {
+  createTaskList,
+  taskList
+} from "./chunk-TMW3XKKJ.js";
+import "./chunk-E6NBEYZD.js";
+import {
+  createWebSearch,
+  webSearch
+} from "./chunk-44AFQ2B7.js";
+import {
+  bash,
+  createBash
+} from "./chunk-4YI2H55A.js";
+import {
+  createGrep,
+  grep
+} from "./chunk-UDIG7332.js";
+import {
+  createGlob,
+  glob
+} from "./chunk-HZAQRHBT.js";
+import "./chunk-MJCAXASI.js";
+import {
+  createRead,
+  read
+} from "./chunk-ACGW44YT.js";
+import {
+  createEdit,
+  edit
+} from "./chunk-P6Z5XFDS.js";
+import "./chunk-G3ITTPGX.js";
+import {
+  createWrite,
+  write
+} from "./chunk-ECYT46FP.js";
+import "./chunk-6PQLFDGT.js";
+import "./chunk-I3ONDY7P.js";
+import {
+  createWebFetch,
+  webFetch
+} from "./chunk-4HIATLKI.js";
+export {
+  askUser,
+  bash,
+  contextCompaction,
+  createAskUser,
+  createBash,
+  createContextCompaction,
+  createDiff,
+  createEdit,
+  createGlob,
+  createGrep,
+  createHttpRequest,
+  createLsp,
+  createMemory,
+  createMultiEdit,
+  createRead,
+  createSleep,
+  createTaskCreate,
+  createTaskGet,
+  createTaskList,
+  createTaskUpdate,
+  createToolSearch,
+  createWebFetch,
+  createWebSearch,
+  createWrite,
+  diff,
+  edit,
+  glob,
+  grep,
+  httpRequest,
+  lsp,
+  memory,
+  multiEdit,
+  read,
+  sleep,
+  taskCreate,
+  taskGet,
+  taskList,
+  taskUpdate,
+  toolSearch,
+  webFetch,
+  webSearch,
+  write
+};

package/dist/lsp/index.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunk5TDZF4IMcjs = require('../chunk-5TDZF4IM.cjs');
+
+
+
+
+exports.createLsp = _chunk5TDZF4IMcjs.createLsp; exports.executeLspOperation = _chunk5TDZF4IMcjs.executeLspOperation; exports.lsp = _chunk5TDZF4IMcjs.lsp;

package/dist/lsp/index.d.cts

@@ -0,0 +1,35 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+interface LspServerConfig {
+    command: string;
+    args?: string[];
+}
+interface LspConfig extends BaseToolConfig {
+    servers?: Record<string, LspServerConfig>;
+    timeout?: number;
+}
+interface LspRequest {
+    operation: string;
+    filePath: string;
+    line?: number;
+    character?: number;
+    cwd: string;
+}
+declare function executeLspOperation(serverConfig: LspServerConfig, params: LspRequest, timeoutMs: number): Promise<string>;
+/** Creates an LSP tool that performs language server operations. */
+declare function createLsp(config?: LspConfig): ai.Tool<{
+    operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+    filePath: string;
+    line: number;
+    character: number;
+}, string>;
+/** Default LSP tool instance with no servers configured. */
+declare const lsp: ai.Tool<{
+    operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+    filePath: string;
+    line: number;
+    character: number;
+}, string>;
+
+export { type LspConfig, type LspServerConfig, createLsp, executeLspOperation, lsp };

package/dist/lsp/index.d.ts

@@ -0,0 +1,35 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+interface LspServerConfig {
+    command: string;
+    args?: string[];
+}
+interface LspConfig extends BaseToolConfig {
+    servers?: Record<string, LspServerConfig>;
+    timeout?: number;
+}
+interface LspRequest {
+    operation: string;
+    filePath: string;
+    line?: number;
+    character?: number;
+    cwd: string;
+}
+declare function executeLspOperation(serverConfig: LspServerConfig, params: LspRequest, timeoutMs: number): Promise<string>;
+/** Creates an LSP tool that performs language server operations. */
+declare function createLsp(config?: LspConfig): ai.Tool<{
+    operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+    filePath: string;
+    line: number;
+    character: number;
+}, string>;
+/** Default LSP tool instance with no servers configured. */
+declare const lsp: ai.Tool<{
+    operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+    filePath: string;
+    line: number;
+    character: number;
+}, string>;
+
+export { type LspConfig, type LspServerConfig, createLsp, executeLspOperation, lsp };

package/dist/lsp/index.js

@@ -0,0 +1,10 @@
+import {
+  createLsp,
+  executeLspOperation,
+  lsp
+} from "../chunk-XAQGZ374.js";
+export {
+  createLsp,
+  executeLspOperation,
+  lsp
+};

package/dist/memory/index.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkFV2R5FFQcjs = require('../chunk-FV2R5FFQ.cjs');
+require('../chunk-QZ5GS6HW.cjs');
+
+
+
+exports.createMemory = _chunkFV2R5FFQcjs.createMemory; exports.memory = _chunkFV2R5FFQcjs.memory;

package/dist/memory/index.d.cts

@@ -0,0 +1,63 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.cjs';
+
+/**
+ * Configuration for the memory tool.
+ * Extends {@link BaseToolConfig} with an optional memory directory path.
+ *
+ * @example
+ * ```typescript
+ * import type { MemoryConfig } from 'agentool/memory';
+ * const config: MemoryConfig = { memoryDir: '/my/project/.agentool/memory' };
+ * ```
+ */
+interface MemoryConfig extends BaseToolConfig {
+    /** Directory for memory files. Defaults to `<cwd>/.agentool/memory`. */
+    memoryDir?: string;
+}
+/**
+ * Creates a memory tool that provides file-based key-value storage.
+ *
+ * Memory entries are stored as individual `.md` files inside the configured
+ * memory directory. Keys are sanitized to prevent path traversal.
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration for cwd and memory directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createMemory } from 'agentool/memory';
+ *
+ * const memTool = createMemory({ cwd: '/my/project' });
+ * const result = await memTool.execute(
+ *   { action: 'write', key: 'notes', content: 'Hello' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createMemory(config?: MemoryConfig): ai.Tool<{
+    action: "read" | "write" | "list" | "delete";
+    content?: string | undefined;
+    key?: string | undefined;
+}, string>;
+/**
+ * Default memory tool instance using `.agentool/memory` under the current
+ * working directory.
+ *
+ * @example
+ * ```typescript
+ * import { memory } from 'agentool/memory';
+ * const result = await memory.execute(
+ *   { action: 'list' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const memory: ai.Tool<{
+    action: "read" | "write" | "list" | "delete";
+    content?: string | undefined;
+    key?: string | undefined;
+}, string>;
+
+export { type MemoryConfig, createMemory, memory };

package/dist/memory/index.d.ts

@@ -0,0 +1,63 @@
+import * as ai from 'ai';
+import { B as BaseToolConfig } from '../types-3QPDuCXN.js';
+
+/**
+ * Configuration for the memory tool.
+ * Extends {@link BaseToolConfig} with an optional memory directory path.
+ *
+ * @example
+ * ```typescript
+ * import type { MemoryConfig } from 'agentool/memory';
+ * const config: MemoryConfig = { memoryDir: '/my/project/.agentool/memory' };
+ * ```
+ */
+interface MemoryConfig extends BaseToolConfig {
+    /** Directory for memory files. Defaults to `<cwd>/.agentool/memory`. */
+    memoryDir?: string;
+}
+/**
+ * Creates a memory tool that provides file-based key-value storage.
+ *
+ * Memory entries are stored as individual `.md` files inside the configured
+ * memory directory. Keys are sanitized to prevent path traversal.
+ * Execute never throws; errors are returned as descriptive strings.
+ *
+ * @param config - Optional configuration for cwd and memory directory.
+ * @returns A Vercel AI SDK tool with `description`, `parameters`, and `execute`.
+ *
+ * @example
+ * ```typescript
+ * import { createMemory } from 'agentool/memory';
+ *
+ * const memTool = createMemory({ cwd: '/my/project' });
+ * const result = await memTool.execute(
+ *   { action: 'write', key: 'notes', content: 'Hello' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare function createMemory(config?: MemoryConfig): ai.Tool<{
+    action: "read" | "write" | "list" | "delete";
+    content?: string | undefined;
+    key?: string | undefined;
+}, string>;
+/**
+ * Default memory tool instance using `.agentool/memory` under the current
+ * working directory.
+ *
+ * @example
+ * ```typescript
+ * import { memory } from 'agentool/memory';
+ * const result = await memory.execute(
+ *   { action: 'list' },
+ *   { toolCallId: 'id', messages: [] },
+ * );
+ * ```
+ */
+declare const memory: ai.Tool<{
+    action: "read" | "write" | "list" | "delete";
+    content?: string | undefined;
+    key?: string | undefined;
+}, string>;
+
+export { type MemoryConfig, createMemory, memory };

package/dist/memory/index.js

@@ -0,0 +1,9 @@
+import {
+  createMemory,
+  memory
+} from "../chunk-VLNDEVKS.js";
+import "../chunk-I3ONDY7P.js";
+export {
+  createMemory,
+  memory
+};