@agentforge/tools 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1145 @@
+import * as _agentforge_core from '@agentforge/core';
+
+/**
+ * HTTP Client Tool
+ *
+ * Make HTTP requests with support for GET, POST, PUT, DELETE, PATCH methods.
+ */
+/**
+ * HTTP response type
+ */
+interface HttpResponse {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    data: any;
+    url: string;
+    method: string;
+}
+/**
+ * Create HTTP client tool
+ *
+ * @example
+ * ```ts
+ * const result = await httpClient.execute({
+ *   url: 'https://api.example.com/data',
+ *   method: 'GET',
+ *   headers: { 'Authorization': 'Bearer token' }
+ * });
+ * ```
+ */
+declare const httpClient: _agentforge_core.Tool<{
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    params?: Record<string, string> | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: any;
+    timeout?: number | undefined;
+}, HttpResponse>;
+/**
+ * Create a simple GET request tool
+ */
+declare const httpGet: _agentforge_core.Tool<{
+    url: string;
+    params?: Record<string, string> | undefined;
+    headers?: Record<string, string> | undefined;
+}, any>;
+/**
+ * Create a simple POST request tool
+ */
+declare const httpPost: _agentforge_core.Tool<{
+    url: string;
+    headers?: Record<string, string> | undefined;
+    body?: any;
+}, any>;
+
+/**
+ * Web Scraper Tool
+ *
+ * Scrape and extract data from web pages using CSS selectors.
+ */
+/**
+ * Scraper result type
+ */
+interface ScraperResult {
+    url: string;
+    title?: string;
+    text?: string;
+    html?: string;
+    links?: string[];
+    images?: string[];
+    metadata?: Record<string, string>;
+    selected?: any;
+}
+/**
+ * Web scraper tool
+ *
+ * @example
+ * ```ts
+ * const result = await webScraper.execute({
+ *   url: 'https://example.com',
+ *   selector: 'article h1',
+ *   extractText: true
+ * });
+ * ```
+ */
+declare const webScraper: _agentforge_core.Tool<{
+    url: string;
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    extractText?: boolean | undefined;
+    extractHtml?: boolean | undefined;
+    extractLinks?: boolean | undefined;
+    extractImages?: boolean | undefined;
+    extractMetadata?: boolean | undefined;
+}, ScraperResult>;
+
+/**
+ * HTML Parser Tool
+ *
+ * Parse HTML content and extract data using CSS selectors.
+ */
+/**
+ * HTML parser tool
+ *
+ * @example
+ * ```ts
+ * const result = await htmlParser.execute({
+ *   html: '<div class="content"><h1>Title</h1><p>Text</p></div>',
+ *   selector: '.content h1'
+ * });
+ * ```
+ */
+declare const htmlParser: _agentforge_core.Tool<{
+    html: string;
+    selector: string;
+    extractText?: boolean | undefined;
+    extractHtml?: boolean | undefined;
+    extractAttributes?: string[] | undefined;
+}, {
+    count: number;
+    results: any[];
+}>;
+/**
+ * Extract links from HTML
+ */
+declare const extractLinks: _agentforge_core.Tool<{
+    html: string;
+    baseUrl?: string | undefined;
+}, {
+    count: number;
+    links: {
+        text: string;
+        href: string;
+        title?: string;
+    }[];
+}>;
+/**
+ * Extract images from HTML
+ */
+declare const extractImages: _agentforge_core.Tool<{
+    html: string;
+    baseUrl?: string | undefined;
+}, {
+    count: number;
+    images: {
+        src: string;
+        alt?: string;
+        title?: string;
+        width?: string;
+        height?: string;
+    }[];
+}>;
+
+/**
+ * URL Validator and Parser Tool
+ *
+ * Validate, parse, and manipulate URLs.
+ */
+/**
+ * URL validation result
+ */
+interface UrlValidationResult {
+    valid: boolean;
+    url?: string;
+    protocol?: string;
+    hostname?: string;
+    port?: string;
+    pathname?: string;
+    search?: string;
+    hash?: string;
+    origin?: string;
+    error?: string;
+}
+/**
+ * URL validator tool
+ *
+ * @example
+ * ```ts
+ * const result = await urlValidator.execute({
+ *   url: 'https://example.com/path?query=value#hash'
+ * });
+ * ```
+ */
+declare const urlValidator: _agentforge_core.Tool<{
+    url: string;
+}, UrlValidationResult>;
+/**
+ * URL builder tool
+ */
+declare const urlBuilder: _agentforge_core.Tool<{
+    hostname: string;
+    protocol?: string | undefined;
+    port?: string | undefined;
+    pathname?: string | undefined;
+    query?: Record<string, string> | undefined;
+    hash?: string | undefined;
+}, {
+    url: string;
+    components: {
+        protocol: string;
+        hostname: string;
+        port: string;
+        pathname: string;
+        search: string;
+        hash: string;
+        origin: string;
+    };
+}>;
+/**
+ * URL query parser tool
+ */
+declare const urlQueryParser: _agentforge_core.Tool<{
+    input: string;
+}, {
+    params: Record<string, string | string[]>;
+    count: number;
+}>;
+
+/**
+ * JSON Processor Tool
+ *
+ * Parse, validate, transform, and query JSON data.
+ */
+/**
+ * JSON parser tool
+ */
+declare const jsonParser: _agentforge_core.Tool<{
+    json: string;
+    strict?: boolean | undefined;
+}, {
+    success: boolean;
+    data: any;
+    type: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    data?: undefined;
+    type?: undefined;
+}>;
+/**
+ * JSON stringifier tool
+ */
+declare const jsonStringify: _agentforge_core.Tool<{
+    data?: any;
+    pretty?: boolean | undefined;
+    indent?: number | undefined;
+}, {
+    success: boolean;
+    json: string;
+    length: number;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    json?: undefined;
+    length?: undefined;
+}>;
+/**
+ * JSON query tool (using JSONPath-like syntax)
+ */
+declare const jsonQuery: _agentforge_core.Tool<{
+    path: string;
+    data?: any;
+}, {
+    success: boolean;
+    error: string;
+    value?: undefined;
+    type?: undefined;
+} | {
+    success: boolean;
+    value: any;
+    type: string;
+    error?: undefined;
+}>;
+/**
+ * JSON validator tool
+ */
+declare const jsonValidator: _agentforge_core.Tool<{
+    json: string;
+}, {
+    valid: boolean;
+    message: string;
+    error?: undefined;
+} | {
+    valid: boolean;
+    error: string;
+    message?: undefined;
+}>;
+/**
+ * JSON merge tool
+ */
+declare const jsonMerge: _agentforge_core.Tool<{
+    objects: any[];
+    deep?: boolean | undefined;
+}, any>;
+
+/**
+ * CSV Parser Tool
+ *
+ * Parse and generate CSV data.
+ */
+/**
+ * CSV parser tool
+ */
+declare const csvParser: _agentforge_core.Tool<{
+    csv: string;
+    delimiter?: string | undefined;
+    hasHeaders?: boolean | undefined;
+    skipEmptyLines?: boolean | undefined;
+    trim?: boolean | undefined;
+}, {
+    success: boolean;
+    data: any;
+    rowCount: any;
+    columnCount: number;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    data?: undefined;
+    rowCount?: undefined;
+    columnCount?: undefined;
+}>;
+/**
+ * CSV generator tool
+ */
+declare const csvGenerator: _agentforge_core.Tool<{
+    data: Record<string, any>[];
+    delimiter?: string | undefined;
+    includeHeaders?: boolean | undefined;
+    columns?: string[] | undefined;
+}, {
+    success: boolean;
+    csv: string;
+    rowCount: number;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    csv?: undefined;
+    rowCount?: undefined;
+}>;
+/**
+ * CSV to JSON converter
+ */
+declare const csvToJson: _agentforge_core.Tool<{
+    csv: string;
+    pretty?: boolean | undefined;
+    delimiter?: string | undefined;
+}, {
+    success: boolean;
+    json: string;
+    recordCount: any;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    json?: undefined;
+    recordCount?: undefined;
+}>;
+/**
+ * JSON to CSV converter
+ */
+declare const jsonToCsv: _agentforge_core.Tool<{
+    json: string;
+    delimiter?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    csv?: undefined;
+    rowCount?: undefined;
+} | {
+    success: boolean;
+    csv: string;
+    rowCount: number;
+    error?: undefined;
+}>;
+
+/**
+ * XML Parser Tool
+ *
+ * Parse and generate XML data.
+ */
+/**
+ * XML parser tool
+ */
+declare const xmlParser: _agentforge_core.Tool<{
+    xml: string;
+    ignoreAttributes?: boolean | undefined;
+    parseAttributeValue?: boolean | undefined;
+    trimValues?: boolean | undefined;
+}, {
+    success: boolean;
+    data: any;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    data?: undefined;
+}>;
+/**
+ * XML generator tool
+ */
+declare const xmlGenerator: _agentforge_core.Tool<{
+    data?: any;
+    format?: boolean | undefined;
+    rootName?: string | undefined;
+    indentSize?: number | undefined;
+}, {
+    success: boolean;
+    xml: any;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    xml?: undefined;
+}>;
+/**
+ * XML to JSON converter
+ */
+declare const xmlToJson: _agentforge_core.Tool<{
+    xml: string;
+    pretty?: boolean | undefined;
+    ignoreAttributes?: boolean | undefined;
+}, {
+    success: boolean;
+    json: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    json?: undefined;
+}>;
+/**
+ * JSON to XML converter
+ */
+declare const jsonToXml: _agentforge_core.Tool<{
+    json: string;
+    format?: boolean | undefined;
+    rootName?: string | undefined;
+}, {
+    success: boolean;
+    xml: any;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    xml?: undefined;
+}>;
+
+/**
+ * Data Transformer Tool
+ *
+ * Transform, filter, map, and manipulate data structures.
+ */
+/**
+ * Array filter tool
+ */
+declare const arrayFilter: _agentforge_core.Tool<{
+    array: any[];
+    property: string;
+    operator: "equals" | "not-equals" | "greater-than" | "less-than" | "contains" | "starts-with" | "ends-with";
+    value?: any;
+}, {
+    filtered: any[];
+    originalCount: number;
+    filteredCount: number;
+}>;
+/**
+ * Array map tool
+ */
+declare const arrayMap: _agentforge_core.Tool<{
+    array: any[];
+    properties: string[];
+}, {
+    mapped: any[];
+    count: number;
+}>;
+/**
+ * Array sort tool
+ */
+declare const arraySort: _agentforge_core.Tool<{
+    array: any[];
+    property: string;
+    order?: "asc" | "desc" | undefined;
+}, {
+    sorted: any[];
+    count: number;
+}>;
+/**
+ * Array group by tool
+ */
+declare const arrayGroupBy: _agentforge_core.Tool<{
+    array: any[];
+    property: string;
+}, {
+    groups: Record<string, any[]>;
+    groupCount: number;
+    totalItems: number;
+}>;
+/**
+ * Object pick tool
+ */
+declare const objectPick: _agentforge_core.Tool<{
+    object: Record<string, any>;
+    properties: string[];
+}, Record<string, any>>;
+/**
+ * Object omit tool
+ */
+declare const objectOmit: _agentforge_core.Tool<{
+    object: Record<string, any>;
+    properties: string[];
+}, Record<string, any>>;
+
+/**
+ * File Operations Tools
+ *
+ * Tools for reading, writing, and manipulating files.
+ */
+/**
+ * File reader tool
+ */
+declare const fileReader: _agentforge_core.Tool<{
+    path: string;
+    encoding?: "ascii" | "binary" | "base64" | "hex" | "utf-8" | "utf8" | undefined;
+}, {
+    success: boolean;
+    content: string;
+    size: number;
+    path: string;
+    encoding: "ascii" | "binary" | "base64" | "hex" | "utf-8" | "utf8" | undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    content?: undefined;
+    size?: undefined;
+    encoding?: undefined;
+}>;
+/**
+ * File writer tool
+ */
+declare const fileWriter: _agentforge_core.Tool<{
+    path: string;
+    content: string;
+    encoding?: "ascii" | "base64" | "hex" | "utf-8" | "utf8" | undefined;
+    createDirs?: boolean | undefined;
+}, {
+    success: boolean;
+    path: string;
+    size: number;
+    encoding: "ascii" | "base64" | "hex" | "utf-8" | "utf8" | undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    size?: undefined;
+    encoding?: undefined;
+}>;
+/**
+ * File append tool
+ */
+declare const fileAppend: _agentforge_core.Tool<{
+    path: string;
+    content: string;
+    encoding?: "ascii" | "utf-8" | "utf8" | undefined;
+}, {
+    success: boolean;
+    path: string;
+    size: number;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    size?: undefined;
+}>;
+/**
+ * File delete tool
+ */
+declare const fileDelete: _agentforge_core.Tool<{
+    path: string;
+}, {
+    success: boolean;
+    path: string;
+    message: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    message?: undefined;
+}>;
+/**
+ * File exists tool
+ */
+declare const fileExists: _agentforge_core.Tool<{
+    path: string;
+}, {
+    exists: boolean;
+    path: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    size: number;
+    modified: string;
+} | {
+    exists: boolean;
+    path: string;
+    isFile?: undefined;
+    isDirectory?: undefined;
+    size?: undefined;
+    modified?: undefined;
+}>;
+
+/**
+ * Directory Operations Tools
+ *
+ * Tools for working with directories and file listings.
+ */
+/**
+ * Directory listing tool
+ */
+declare const directoryList: _agentforge_core.Tool<{
+    path: string;
+    recursive?: boolean | undefined;
+    includeDetails?: boolean | undefined;
+    extension?: string | undefined;
+}, {
+    success: boolean;
+    path: string;
+    files: any[];
+    count: number;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    files?: undefined;
+    count?: undefined;
+}>;
+/**
+ * Directory create tool
+ */
+declare const directoryCreate: _agentforge_core.Tool<{
+    path: string;
+    recursive?: boolean | undefined;
+}, {
+    success: boolean;
+    path: string;
+    message: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    message?: undefined;
+}>;
+/**
+ * Directory delete tool
+ */
+declare const directoryDelete: _agentforge_core.Tool<{
+    path: string;
+    recursive?: boolean | undefined;
+}, {
+    success: boolean;
+    path: string;
+    message: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    message?: undefined;
+}>;
+/**
+ * File search tool
+ */
+declare const fileSearch: _agentforge_core.Tool<{
+    directory: string;
+    pattern: string;
+    recursive?: boolean | undefined;
+    caseSensitive?: boolean | undefined;
+}, {
+    success: boolean;
+    directory: string;
+    pattern: string;
+    matches: string[];
+    count: number;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    directory: string;
+    pattern?: undefined;
+    matches?: undefined;
+    count?: undefined;
+}>;
+
+/**
+ * Path Utilities Tools
+ *
+ * Tools for working with file paths.
+ */
+/**
+ * Path join tool
+ */
+declare const pathJoin: _agentforge_core.Tool<{
+    segments: string[];
+}, {
+    path: string;
+    segments: string[];
+}>;
+/**
+ * Path resolve tool
+ */
+declare const pathResolve: _agentforge_core.Tool<{
+    paths: string[];
+}, {
+    path: string;
+    isAbsolute: boolean;
+}>;
+/**
+ * Path parse tool
+ */
+declare const pathParse: _agentforge_core.Tool<{
+    path: string;
+}, {
+    root: string;
+    dir: string;
+    base: string;
+    name: string;
+    ext: string;
+    isAbsolute: boolean;
+}>;
+/**
+ * Path basename tool
+ */
+declare const pathBasename: _agentforge_core.Tool<{
+    path: string;
+    removeExtension?: boolean | undefined;
+}, {
+    basename: string;
+    extension: string;
+}>;
+/**
+ * Path dirname tool
+ */
+declare const pathDirname: _agentforge_core.Tool<{
+    path: string;
+}, {
+    dirname: string;
+    basename: string;
+}>;
+/**
+ * Path extension tool
+ */
+declare const pathExtension: _agentforge_core.Tool<{
+    path: string;
+}, {
+    extension: string;
+    hasExtension: boolean;
+    filename: string;
+}>;
+/**
+ * Path relative tool
+ */
+declare const pathRelative: _agentforge_core.Tool<{
+    from: string;
+    to: string;
+}, {
+    relativePath: string;
+    from: string;
+    to: string;
+}>;
+/**
+ * Path normalize tool
+ */
+declare const pathNormalize: _agentforge_core.Tool<{
+    path: string;
+}, {
+    normalized: string;
+    original: string;
+}>;
+
+/**
+ * Date and Time Utility Tools
+ *
+ * Tools for working with dates, times, and timestamps.
+ */
+/**
+ * Current date/time tool
+ */
+declare const currentDateTime: _agentforge_core.Tool<{
+    format?: "custom" | "iso" | "unix" | undefined;
+    customFormat?: string | undefined;
+    timezone?: string | undefined;
+}, {
+    formatted: string | number;
+    iso: string;
+    unix: number;
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+}>;
+/**
+ * Date formatter tool
+ */
+declare const dateFormatter: _agentforge_core.Tool<{
+    date: string;
+    outputFormat: string;
+    inputFormat?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    formatted?: undefined;
+    iso?: undefined;
+} | {
+    success: boolean;
+    formatted: string;
+    iso: string;
+    error?: undefined;
+}>;
+/**
+ * Date arithmetic tool
+ */
+declare const dateArithmetic: _agentforge_core.Tool<{
+    date: string;
+    operation: "add" | "subtract";
+    amount: number;
+    unit: "years" | "months" | "weeks" | "days" | "hours" | "minutes" | "seconds";
+}, {
+    success: boolean;
+    error: string;
+    result?: undefined;
+    unix?: undefined;
+} | {
+    success: boolean;
+    result: string;
+    unix: number;
+    error?: undefined;
+}>;
+/**
+ * Date difference tool
+ */
+declare const dateDifference: _agentforge_core.Tool<{
+    startDate: string;
+    endDate: string;
+    unit?: "days" | "hours" | "minutes" | undefined;
+}, {
+    success: boolean;
+    error: string;
+    difference?: undefined;
+    unit?: undefined;
+    startDate?: undefined;
+    endDate?: undefined;
+} | {
+    success: boolean;
+    difference: number;
+    unit: "days" | "hours" | "minutes" | undefined;
+    startDate: string;
+    endDate: string;
+    error?: undefined;
+}>;
+/**
+ * Date comparison tool
+ */
+declare const dateComparison: _agentforge_core.Tool<{
+    date1: string;
+    date2: string;
+}, {
+    success: boolean;
+    error: string;
+    date1IsBefore?: undefined;
+    date1IsAfter?: undefined;
+    datesAreEqual?: undefined;
+    date1?: undefined;
+    date2?: undefined;
+} | {
+    success: boolean;
+    date1IsBefore: boolean;
+    date1IsAfter: boolean;
+    datesAreEqual: boolean;
+    date1: string;
+    date2: string;
+    error?: undefined;
+}>;
+
+/**
+ * String Utility Tools
+ *
+ * Tools for string manipulation and transformation.
+ */
+/**
+ * String case converter tool
+ */
+declare const stringCaseConverter: _agentforge_core.Tool<{
+    text: string;
+    targetCase: "title" | "lowercase" | "uppercase" | "camel" | "snake" | "kebab" | "pascal";
+}, {
+    original: string;
+    converted: string;
+    targetCase: "title" | "lowercase" | "uppercase" | "camel" | "snake" | "kebab" | "pascal";
+}>;
+/**
+ * String trim tool
+ */
+declare const stringTrim: _agentforge_core.Tool<{
+    text: string;
+    mode?: "both" | "start" | "end" | undefined;
+    characters?: string | undefined;
+}, {
+    original: string;
+    trimmed: string;
+    removed: number;
+}>;
+/**
+ * String replace tool
+ */
+declare const stringReplace: _agentforge_core.Tool<{
+    text: string;
+    search: string;
+    replace: string;
+    global?: boolean | undefined;
+    caseInsensitive?: boolean | undefined;
+}, {
+    original: string;
+    result: string;
+    replacements: number;
+}>;
+/**
+ * String split tool
+ */
+declare const stringSplit: _agentforge_core.Tool<{
+    text: string;
+    delimiter: string;
+    limit?: number | undefined;
+}, {
+    parts: string[];
+    count: number;
+}>;
+/**
+ * String join tool
+ */
+declare const stringJoin: _agentforge_core.Tool<{
+    parts: string[];
+    separator?: string | undefined;
+}, {
+    result: string;
+    partCount: number;
+    length: number;
+}>;
+/**
+ * String substring tool
+ */
+declare const stringSubstring: _agentforge_core.Tool<{
+    text: string;
+    start: number;
+    end?: number | undefined;
+}, {
+    result: string;
+    length: number;
+    start: number;
+    end: number;
+}>;
+/**
+ * String length tool
+ */
+declare const stringLength: _agentforge_core.Tool<{
+    text: string;
+}, {
+    characters: number;
+    words: number;
+    lines: number;
+}>;
+
+/**
+ * Math Operations Tools
+ *
+ * Tools for mathematical calculations and operations.
+ */
+/**
+ * Calculator tool
+ */
+declare const calculator: _agentforge_core.Tool<{
+    a: number;
+    b: number;
+    operation: "add" | "subtract" | "multiply" | "divide" | "power" | "modulo";
+}, {
+    success: boolean;
+    error: string;
+    result?: undefined;
+    operation?: undefined;
+    a?: undefined;
+    b?: undefined;
+} | {
+    success: boolean;
+    result: number;
+    operation: "add" | "subtract" | "multiply" | "divide" | "power" | "modulo";
+    a: number;
+    b: number;
+    error?: undefined;
+}>;
+/**
+ * Math functions tool
+ */
+declare const mathFunctions: _agentforge_core.Tool<{
+    function: "sqrt" | "abs" | "round" | "floor" | "ceil" | "sin" | "cos" | "tan" | "log" | "exp";
+    value: number;
+}, {
+    success: boolean;
+    error: string;
+    result?: undefined;
+    function?: undefined;
+    input?: undefined;
+} | {
+    success: boolean;
+    result: number;
+    function: "sqrt" | "abs" | "round" | "floor" | "ceil" | "sin" | "cos" | "tan" | "log" | "exp";
+    input: number;
+    error?: undefined;
+}>;
+/**
+ * Random number generator tool
+ */
+declare const randomNumber: _agentforge_core.Tool<{
+    integer?: boolean | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+}, {
+    result: number;
+    min: number;
+    max: number;
+    integer: boolean;
+}>;
+/**
+ * Statistics tool
+ */
+declare const statistics: _agentforge_core.Tool<{
+    numbers: number[];
+}, {
+    success: boolean;
+    error: string;
+    count?: undefined;
+    sum?: undefined;
+    average?: undefined;
+    min?: undefined;
+    max?: undefined;
+    median?: undefined;
+    standardDeviation?: undefined;
+    variance?: undefined;
+} | {
+    success: boolean;
+    count: number;
+    sum: number;
+    average: number;
+    min: number;
+    max: number;
+    median: number;
+    standardDeviation: number;
+    variance: number;
+    error?: undefined;
+}>;
+
+/**
+ * Validation Utility Tools
+ *
+ * Tools for validating data formats and types.
+ */
+/**
+ * Email validator tool
+ */
+declare const emailValidator: _agentforge_core.Tool<{
+    email: string;
+}, {
+    valid: boolean;
+    email: string;
+    message: string;
+}>;
+/**
+ * URL validator tool (already exists in web tools, but adding here for completeness)
+ */
+declare const urlValidatorSimple: _agentforge_core.Tool<{
+    url: string;
+}, {
+    valid: boolean;
+    url: string;
+    message: string;
+}>;
+/**
+ * Phone number validator tool
+ */
+declare const phoneValidator: _agentforge_core.Tool<{
+    phone: string;
+    strict?: boolean | undefined;
+}, {
+    valid: boolean;
+    phone: string;
+    message: string;
+}>;
+/**
+ * Credit card validator tool
+ */
+declare const creditCardValidator: _agentforge_core.Tool<{
+    cardNumber: string;
+}, {
+    valid: boolean;
+    message: string;
+    cardNumber?: undefined;
+} | {
+    valid: boolean;
+    cardNumber: string;
+    message: string;
+}>;
+/**
+ * IP address validator tool
+ */
+declare const ipValidator: _agentforge_core.Tool<{
+    ip: string;
+    version?: "v4" | "v6" | "any" | undefined;
+}, {
+    valid: boolean;
+    ip: string;
+    version: string | undefined;
+    message: string;
+}>;
+/**
+ * UUID validator tool
+ */
+declare const uuidValidator: _agentforge_core.Tool<{
+    uuid: string;
+}, {
+    valid: boolean;
+    uuid: string;
+    version: number | undefined;
+    message: string;
+}>;
+
+export { type HttpResponse, type ScraperResult, type UrlValidationResult, arrayFilter, arrayGroupBy, arrayMap, arraySort, calculator, creditCardValidator, csvGenerator, csvParser, csvToJson, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, directoryCreate, directoryDelete, directoryList, emailValidator, extractImages, extractLinks, fileAppend, fileDelete, fileExists, fileReader, fileSearch, fileWriter, htmlParser, httpClient, httpGet, httpPost, ipValidator, jsonMerge, jsonParser, jsonQuery, jsonStringify, jsonToCsv, jsonToXml, jsonValidator, mathFunctions, objectOmit, objectPick, pathBasename, pathDirname, pathExtension, pathJoin, pathNormalize, pathParse, pathRelative, pathResolve, phoneValidator, randomNumber, statistics, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, urlBuilder, urlQueryParser, urlValidator, urlValidatorSimple, uuidValidator, webScraper, xmlGenerator, xmlParser, xmlToJson };