@agentforge/tools 0.12.4 → 0.12.6

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import * as _agentforge_core from '@agentforge/core';
 import { LogLevel, HumanRequestPriority } from '@agentforge/core';
 import { z } from 'zod';
+import { Session } from 'neo4j-driver';
 
 /**
  * HTTP Tools Types
@@ -1096,10 +1097,68 @@ interface SlackClientConfig {
 /**
  * Default Slack tools using environment variables
  */
-declare const sendSlackMessage: _agentforge_core.Tool<unknown, unknown>;
-declare const notifySlack: _agentforge_core.Tool<unknown, unknown>;
-declare const getSlackChannels: _agentforge_core.Tool<unknown, unknown>;
-declare const getSlackMessages: _agentforge_core.Tool<unknown, unknown>;
+declare const sendSlackMessage: _agentforge_core.Tool<{
+    message: string;
+    channel: string;
+}, {
+    success: boolean;
+    data?: {
+        channel: string | undefined;
+        message: string;
+        timestamp: string | undefined;
+        message_id: string | undefined;
+    } | undefined;
+    error?: string;
+}>;
+declare const notifySlack: _agentforge_core.Tool<{
+    message: string;
+    channel: string;
+    mentions?: string[] | undefined;
+}, {
+    success: boolean;
+    data?: {
+        channel: string | undefined;
+        message: string;
+        mentions: string[];
+        timestamp: string | undefined;
+        notification_id: string | undefined;
+    } | undefined;
+    error?: string;
+}>;
+declare const getSlackChannels: _agentforge_core.Tool<{
+    include_private?: boolean | undefined;
+}, {
+    success: boolean;
+    data?: {
+        count: number;
+        channels: {
+            id: string | undefined;
+            name: string | undefined;
+            is_private: boolean;
+            num_members: number;
+        }[];
+    } | undefined;
+    error?: string;
+}>;
+declare const getSlackMessages: _agentforge_core.Tool<{
+    channel: string;
+    limit?: number | undefined;
+}, {
+    success: boolean;
+    data?: {
+        channel: string;
+        count: number;
+        messages: {
+            user: string;
+            text: string;
+            timestamp: string | undefined;
+            thread_ts: string | undefined;
+            type: string | undefined;
+            subtype: string | undefined;
+        }[];
+    } | undefined;
+    error?: string;
+}>;
 /**
  * Export all Slack tools
  *
@@ -1107,7 +1166,65 @@ declare const getSlackMessages: _agentforge_core.Tool<unknown, unknown>;
  * - 2 write tools: send-slack-message, notify-slack
  * - 2 read tools: get-slack-channels, get-slack-messages
  */
-declare const slackTools: _agentforge_core.Tool<unknown, unknown>[];
+declare const slackTools: (_agentforge_core.Tool<{
+    message: string;
+    channel: string;
+}, {
+    success: boolean;
+    data?: {
+        channel: string | undefined;
+        message: string;
+        timestamp: string | undefined;
+        message_id: string | undefined;
+    } | undefined;
+    error?: string;
+}> | _agentforge_core.Tool<{
+    message: string;
+    channel: string;
+    mentions?: string[] | undefined;
+}, {
+    success: boolean;
+    data?: {
+        channel: string | undefined;
+        message: string;
+        mentions: string[];
+        timestamp: string | undefined;
+        notification_id: string | undefined;
+    } | undefined;
+    error?: string;
+}> | _agentforge_core.Tool<{
+    include_private?: boolean | undefined;
+}, {
+    success: boolean;
+    data?: {
+        count: number;
+        channels: {
+            id: string | undefined;
+            name: string | undefined;
+            is_private: boolean;
+            num_members: number;
+        }[];
+    } | undefined;
+    error?: string;
+}> | _agentforge_core.Tool<{
+    channel: string;
+    limit?: number | undefined;
+}, {
+    success: boolean;
+    data?: {
+        channel: string;
+        count: number;
+        messages: {
+            user: string;
+            text: string;
+            timestamp: string | undefined;
+            thread_ts: string | undefined;
+            type: string | undefined;
+            subtype: string | undefined;
+        }[];
+    } | undefined;
+    error?: string;
+}>)[];
 /**
  * Create Slack tools with custom configuration
  *
@@ -1145,10 +1262,68 @@ declare const slackTools: _agentforge_core.Tool<unknown, unknown>[];
  * ```
  */
 declare function createSlackTools(config?: SlackToolsConfig): {
-    sendMessage: _agentforge_core.Tool<unknown, unknown>;
-    notify: _agentforge_core.Tool<unknown, unknown>;
-    getChannels: _agentforge_core.Tool<unknown, unknown>;
-    getMessages: _agentforge_core.Tool<unknown, unknown>;
+    sendMessage: _agentforge_core.Tool<{
+        message: string;
+        channel: string;
+    }, {
+        success: boolean;
+        data?: {
+            channel: string | undefined;
+            message: string;
+            timestamp: string | undefined;
+            message_id: string | undefined;
+        } | undefined;
+        error?: string;
+    }>;
+    notify: _agentforge_core.Tool<{
+        message: string;
+        channel: string;
+        mentions?: string[] | undefined;
+    }, {
+        success: boolean;
+        data?: {
+            channel: string | undefined;
+            message: string;
+            mentions: string[];
+            timestamp: string | undefined;
+            notification_id: string | undefined;
+        } | undefined;
+        error?: string;
+    }>;
+    getChannels: _agentforge_core.Tool<{
+        include_private?: boolean | undefined;
+    }, {
+        success: boolean;
+        data?: {
+            count: number;
+            channels: {
+                id: string | undefined;
+                name: string | undefined;
+                is_private: boolean;
+                num_members: number;
+            }[];
+        } | undefined;
+        error?: string;
+    }>;
+    getMessages: _agentforge_core.Tool<{
+        channel: string;
+        limit?: number | undefined;
+    }, {
+        success: boolean;
+        data?: {
+            channel: string;
+            count: number;
+            messages: {
+                user: string;
+                text: string;
+                timestamp: string | undefined;
+                thread_ts: string | undefined;
+                type: string | undefined;
+                subtype: string | undefined;
+            }[];
+        } | undefined;
+        error?: string;
+    }>;
 };
 
 /**
@@ -1192,13 +1367,35 @@ interface ConfluenceAuth {
 /**
  * Default Confluence tools using environment variables
  */
-declare const searchConfluence: _agentforge_core.Tool<unknown, unknown>;
-declare const getConfluencePage: _agentforge_core.Tool<unknown, unknown>;
-declare const listConfluenceSpaces: _agentforge_core.Tool<unknown, unknown>;
-declare const getSpacePages: _agentforge_core.Tool<unknown, unknown>;
-declare const createConfluencePage: _agentforge_core.Tool<unknown, unknown>;
-declare const updateConfluencePage: _agentforge_core.Tool<unknown, unknown>;
-declare const archiveConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+declare const searchConfluence: _agentforge_core.Tool<{
+    query: string;
+    limit?: number | undefined;
+}, string>;
+declare const getConfluencePage: _agentforge_core.Tool<{
+    page_id: string;
+}, string>;
+declare const listConfluenceSpaces: _agentforge_core.Tool<{
+    limit?: number | undefined;
+}, string>;
+declare const getSpacePages: _agentforge_core.Tool<{
+    space_key: string;
+    limit?: number | undefined;
+}, string>;
+declare const createConfluencePage: _agentforge_core.Tool<{
+    title: string;
+    content: string;
+    space_key: string;
+    parent_page_id?: string | undefined;
+}, string>;
+declare const updateConfluencePage: _agentforge_core.Tool<{
+    title: string;
+    content: string;
+    page_id: string;
+}, string>;
+declare const archiveConfluencePage: _agentforge_core.Tool<{
+    page_id: string;
+    reason?: string | undefined;
+}, string>;
 /**
  * Export all Confluence tools
  *
@@ -1206,7 +1403,29 @@ declare const archiveConfluencePage: _agentforge_core.Tool<unknown, unknown>;
  * - 4 read tools: search, get-page, list-spaces, get-space-pages
  * - 3 write tools: create-page, update-page, archive-page
  */
-declare const confluenceTools: _agentforge_core.Tool<unknown, unknown>[];
+declare const confluenceTools: (_agentforge_core.Tool<{
+    query: string;
+    limit?: number | undefined;
+}, string> | _agentforge_core.Tool<{
+    page_id: string;
+}, string> | _agentforge_core.Tool<{
+    limit?: number | undefined;
+}, string> | _agentforge_core.Tool<{
+    space_key: string;
+    limit?: number | undefined;
+}, string> | _agentforge_core.Tool<{
+    title: string;
+    content: string;
+    space_key: string;
+    parent_page_id?: string | undefined;
+}, string> | _agentforge_core.Tool<{
+    title: string;
+    content: string;
+    page_id: string;
+}, string> | _agentforge_core.Tool<{
+    page_id: string;
+    reason?: string | undefined;
+}, string>)[];
 /**
  * Create Confluence tools with custom configuration
  *
@@ -1240,13 +1459,35 @@ declare const confluenceTools: _agentforge_core.Tool<unknown, unknown>[];
  * ```
  */
 declare function createConfluenceTools(config?: ConfluenceToolsConfig): {
-    searchConfluence: _agentforge_core.Tool<unknown, unknown>;
-    getConfluencePage: _agentforge_core.Tool<unknown, unknown>;
-    listConfluenceSpaces: _agentforge_core.Tool<unknown, unknown>;
-    getSpacePages: _agentforge_core.Tool<unknown, unknown>;
-    createConfluencePage: _agentforge_core.Tool<unknown, unknown>;
-    updateConfluencePage: _agentforge_core.Tool<unknown, unknown>;
-    archiveConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+    searchConfluence: _agentforge_core.Tool<{
+        query: string;
+        limit?: number | undefined;
+    }, string>;
+    getConfluencePage: _agentforge_core.Tool<{
+        page_id: string;
+    }, string>;
+    listConfluenceSpaces: _agentforge_core.Tool<{
+        limit?: number | undefined;
+    }, string>;
+    getSpacePages: _agentforge_core.Tool<{
+        space_key: string;
+        limit?: number | undefined;
+    }, string>;
+    createConfluencePage: _agentforge_core.Tool<{
+        title: string;
+        content: string;
+        space_key: string;
+        parent_page_id?: string | undefined;
+    }, string>;
+    updateConfluencePage: _agentforge_core.Tool<{
+        title: string;
+        content: string;
+        page_id: string;
+    }, string>;
+    archiveConfluencePage: _agentforge_core.Tool<{
+        page_id: string;
+        reason?: string | undefined;
+    }, string>;
 };
 
 /**
@@ -2608,6 +2849,1831 @@ declare function createTransformerTools(config?: TransformerToolsConfig): (_agen
     properties: string[];
 }, Record<string, any>>)[];
 
+/**
+ * Neo4j Tools Types
+ *
+ * Type definitions and schemas for Neo4j graph database tools.
+ */
+
+/**
+ * Neo4j connection configuration
+ */
+interface Neo4jConfig {
+    uri: string;
+    username: string;
+    password: string;
+    database?: string;
+    maxConnectionPoolSize?: number;
+    connectionTimeout?: number;
+}
+/**
+ * Neo4j query schema
+ */
+declare const neo4jQuerySchema: z.ZodObject<{
+    cypher: z.ZodString;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    database: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    cypher: string;
+    parameters?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    cypher: string;
+    parameters?: Record<string, any> | undefined;
+    database?: string | undefined;
+}>;
+/**
+ * Neo4j get schema input schema
+ */
+declare const neo4jGetSchemaSchema: z.ZodObject<{
+    database: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    database?: string | undefined;
+}, {
+    database?: string | undefined;
+}>;
+/**
+ * Neo4j find nodes schema
+ */
+declare const neo4jFindNodesSchema: z.ZodObject<{
+    label: z.ZodString;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    label: string;
+    properties?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    label: string;
+    limit?: number | undefined;
+    properties?: Record<string, any> | undefined;
+    database?: string | undefined;
+}>;
+/**
+ * Neo4j traverse schema
+ */
+declare const neo4jTraverseSchema: z.ZodObject<{
+    startNodeId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    relationshipType: z.ZodOptional<z.ZodString>;
+    direction: z.ZodDefault<z.ZodEnum<["outgoing", "incoming", "both"]>>;
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    startNodeId: string | number;
+    direction: "outgoing" | "incoming" | "both";
+    maxDepth: number;
+    database?: string | undefined;
+    relationshipType?: string | undefined;
+}, {
+    startNodeId: string | number;
+    limit?: number | undefined;
+    database?: string | undefined;
+    relationshipType?: string | undefined;
+    direction?: "outgoing" | "incoming" | "both" | undefined;
+    maxDepth?: number | undefined;
+}>;
+/**
+ * Neo4j vector search schema
+ */
+declare const neo4jVectorSearchSchema: z.ZodObject<{
+    indexName: z.ZodString;
+    queryVector: z.ZodArray<z.ZodNumber, "many">;
+    limit: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    indexName: string;
+    queryVector: number[];
+    database?: string | undefined;
+}, {
+    indexName: string;
+    queryVector: number[];
+    limit?: number | undefined;
+    database?: string | undefined;
+}>;
+/**
+ * Neo4j vector search with embedding schema
+ */
+declare const neo4jVectorSearchWithEmbeddingSchema: z.ZodObject<{
+    indexName: z.ZodString;
+    queryText: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+    database: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    indexName: string;
+    queryText: string;
+    database?: string | undefined;
+    model?: string | undefined;
+}, {
+    indexName: string;
+    queryText: string;
+    limit?: number | undefined;
+    database?: string | undefined;
+    model?: string | undefined;
+}>;
+/**
+ * Neo4j create node with embedding schema
+ */
+declare const neo4jCreateNodeWithEmbeddingSchema: z.ZodObject<{
+    label: z.ZodString;
+    properties: z.ZodRecord<z.ZodString, z.ZodAny>;
+    textProperty: z.ZodString;
+    embeddingProperty: z.ZodDefault<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    database: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    properties: Record<string, any>;
+    label: string;
+    textProperty: string;
+    embeddingProperty: string;
+    database?: string | undefined;
+    model?: string | undefined;
+}, {
+    properties: Record<string, any>;
+    label: string;
+    textProperty: string;
+    database?: string | undefined;
+    model?: string | undefined;
+    embeddingProperty?: string | undefined;
+}>;
+/**
+ * Neo4j node result
+ */
+interface Neo4jNode {
+    identity: string | number;
+    labels: string[];
+    properties: Record<string, any>;
+}
+/**
+ * Neo4j relationship result
+ */
+interface Neo4jRelationship {
+    identity: string | number;
+    type: string;
+    start: string | number;
+    end: string | number;
+    properties: Record<string, any>;
+}
+/**
+ * Neo4j path result
+ */
+interface Neo4jPath {
+    start: Neo4jNode;
+    end: Neo4jNode;
+    segments: Array<{
+        start: Neo4jNode;
+        relationship: Neo4jRelationship;
+        end: Neo4jNode;
+    }>;
+    length: number;
+}
+/**
+ * Neo4j schema information
+ */
+interface Neo4jSchema {
+    nodeLabels: string[];
+    relationshipTypes: string[];
+    propertyKeys: string[];
+    constraints: Array<{
+        label?: string;
+        type: string;
+        properties: string[];
+    }>;
+    indexes: Array<{
+        label?: string;
+        type: string;
+        properties: string[];
+    }>;
+}
+/**
+ * Neo4j tools configuration
+ */
+interface Neo4jToolsConfig {
+    uri?: string;
+    username?: string;
+    password?: string;
+    database?: string;
+    maxConnectionPoolSize?: number;
+    connectionTimeout?: number;
+}
+
+/**
+ * Neo4j Connection Pool Management
+ *
+ * Manages Neo4j driver connections with pooling and health checks.
+ */
+
+/**
+ * Neo4j connection pool singleton
+ */
+declare class Neo4jConnectionPool {
+    private driver;
+    private config;
+    /**
+     * Initialize the connection pool
+     */
+    initialize(config: Neo4jConfig): Promise<void>;
+    /**
+     * Verify connectivity to Neo4j
+     */
+    verifyConnectivity(): Promise<void>;
+    /**
+     * Get a session for executing queries
+     */
+    getSession(database?: string): Session;
+    /**
+     * Execute a query with automatic session management
+     */
+    executeQuery<T = any>(cypher: string, parameters?: Record<string, any>, database?: string): Promise<T[]>;
+    /**
+     * Execute a read query
+     */
+    executeReadQuery<T = any>(cypher: string, parameters?: Record<string, any>, database?: string): Promise<T[]>;
+    /**
+     * Execute a write query
+     */
+    executeWriteQuery<T = any>(cypher: string, parameters?: Record<string, any>, database?: string): Promise<T[]>;
+    /**
+     * Check if driver is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Neo4jConfig | null;
+    /**
+     * Close the connection pool
+     */
+    close(): Promise<void>;
+}
+/**
+ * Global connection pool instance
+ */
+declare const neo4jPool: Neo4jConnectionPool;
+/**
+ * Initialize Neo4j connection from environment variables
+ */
+declare function initializeFromEnv(): Promise<void>;
+
+/**
+ * Embedding Generation Types
+ *
+ * Types and interfaces for embedding generation providers
+ */
+/**
+ * Supported embedding providers
+ */
+type EmbeddingProvider = 'openai' | 'cohere' | 'huggingface' | 'voyage' | 'ollama';
+/**
+ * Configuration for embedding generation
+ */
+interface EmbeddingConfig {
+    provider: EmbeddingProvider;
+    model: string;
+    apiKey: string;
+    dimensions?: number;
+}
+/**
+ * Result from embedding generation
+ */
+interface EmbeddingResult {
+    embedding: number[];
+    model: string;
+    dimensions: number;
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Batch embedding result
+ */
+interface BatchEmbeddingResult {
+    embeddings: number[][];
+    model: string;
+    dimensions: number;
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Base interface for embedding providers
+ */
+interface IEmbeddingProvider {
+    readonly name: EmbeddingProvider;
+    readonly defaultModel: string;
+    /**
+     * Check if provider is available (API key configured)
+     */
+    isAvailable(): boolean;
+    /**
+     * Generate embedding for a single text
+     */
+    generateEmbedding(text: string, model?: string): Promise<EmbeddingResult>;
+    /**
+     * Generate embeddings for multiple texts (batch)
+     */
+    generateBatchEmbeddings(texts: string[], model?: string): Promise<BatchEmbeddingResult>;
+}
+/**
+ * Retry configuration for embedding API calls
+ */
+interface EmbeddingRetryConfig {
+    maxRetries: number;
+    initialDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+}
+
+/**
+ * Embedding Utilities
+ *
+ * Utility functions for embedding generation
+ */
+
+/**
+ * Default retry configuration for embedding API calls
+ */
+declare const DEFAULT_RETRY_CONFIG: EmbeddingRetryConfig;
+/**
+ * Check if error is retryable (network errors, timeouts, 5xx errors, rate limits)
+ */
+declare function isRetryableError(error: any): boolean;
+/**
+ * Retry an async function with exponential backoff
+ */
+declare function retryWithBackoff<T>(fn: () => Promise<T>, config?: EmbeddingRetryConfig): Promise<T>;
+/**
+ * Get OpenAI API key from environment
+ */
+declare function getOpenAIApiKey(): string | undefined;
+/**
+ * Get Cohere API key from environment
+ */
+declare function getCohereApiKey(): string | undefined;
+/**
+ * Get HuggingFace API key from environment
+ */
+declare function getHuggingFaceApiKey(): string | undefined;
+/**
+ * Get Voyage AI API key from environment
+ */
+declare function getVoyageApiKey(): string | undefined;
+/**
+ * Get Ollama base URL from environment (defaults to localhost)
+ */
+declare function getOllamaBaseUrl(): string;
+/**
+ * Get embedding provider from environment (defaults to 'openai')
+ */
+declare function getEmbeddingProvider(): string;
+/**
+ * Get embedding model from environment
+ */
+declare function getEmbeddingModel(): string | undefined;
+/**
+ * Validate text for embedding generation
+ */
+declare function validateText(text: string): void;
+/**
+ * Validate batch of texts
+ */
+declare function validateBatch(texts: string[]): void;
+
+/**
+ * Embedding Manager
+ *
+ * Manages embedding generation across different providers
+ */
+
+/**
+ * Singleton embedding manager
+ */
+declare class EmbeddingManager {
+    private provider;
+    private config;
+    /**
+     * Initialize with configuration
+     */
+    initialize(config: EmbeddingConfig): void;
+    /**
+     * Initialize from environment variables
+     */
+    initializeFromEnv(): void;
+    /**
+     * Check if manager is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get current provider
+     */
+    getProvider(): IEmbeddingProvider;
+    /**
+     * Get current configuration
+     */
+    getConfig(): EmbeddingConfig;
+    /**
+     * Generate embedding for a single text
+     */
+    generateEmbedding(text: string, model?: string): Promise<EmbeddingResult>;
+    /**
+     * Generate embeddings for multiple texts (batch)
+     */
+    generateBatchEmbeddings(texts: string[], model?: string): Promise<BatchEmbeddingResult>;
+    /**
+     * Get default model for a provider
+     */
+    private getDefaultModel;
+    /**
+     * Create a provider instance
+     */
+    private createProvider;
+    /**
+     * Reset the manager (for testing)
+     */
+    reset(): void;
+}
+/**
+ * Singleton instance
+ */
+declare const embeddingManager: EmbeddingManager;
+/**
+ * Initialize embedding manager from environment variables
+ */
+declare function initializeEmbeddings(): void;
+/**
+ * Initialize embedding manager with custom configuration
+ */
+declare function initializeEmbeddingsWithConfig(config: EmbeddingConfig): void;
+/**
+ * Generate embedding for a single text
+ */
+declare function generateEmbedding(text: string, model?: string): Promise<EmbeddingResult>;
+/**
+ * Generate embeddings for multiple texts (batch)
+ */
+declare function generateBatchEmbeddings(texts: string[], model?: string): Promise<BatchEmbeddingResult>;
+
+/**
+ * OpenAI Embedding Provider
+ *
+ * Generate embeddings using OpenAI's embedding models.
+ * Requires OPENAI_API_KEY environment variable.
+ * Get your API key at: https://platform.openai.com/api-keys
+ */
+
+/**
+ * OpenAI embedding provider implementation
+ */
+declare class OpenAIEmbeddingProvider implements IEmbeddingProvider {
+    readonly name: "openai";
+    readonly defaultModel = "text-embedding-3-small";
+    private apiKey;
+    private readonly baseURL;
+    constructor(apiKey?: string);
+    /**
+     * Check if OpenAI is available (API key is set)
+     */
+    isAvailable(): boolean;
+    /**
+     * Generate embedding for a single text
+     */
+    generateEmbedding(text: string, model?: string): Promise<EmbeddingResult>;
+    /**
+     * Generate embeddings for multiple texts (batch)
+     */
+    generateBatchEmbeddings(texts: string[], model?: string): Promise<BatchEmbeddingResult>;
+}
+
+/**
+ * Neo4j Query Tool
+ *
+ * Execute arbitrary Cypher queries against Neo4j database.
+ */
+/**
+ * Create Neo4j query tool
+ */
+declare function createNeo4jQueryTool(): _agentforge_core.Tool<{
+    cypher: string;
+    parameters?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    data: any[];
+    recordCount: number;
+    summary: {
+        query: string;
+        parameters: Record<string, any> | undefined;
+        counters: {
+            nodesCreated: number;
+            nodesDeleted: number;
+            relationshipsCreated: number;
+            relationshipsDeleted: number;
+            propertiesSet: number;
+        };
+    };
+    error?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+}>;
+
+/**
+ * Neo4j Get Schema Tool
+ *
+ * Introspect the Neo4j graph schema to understand structure.
+ */
+/**
+ * Create Neo4j get schema tool
+ */
+declare function createNeo4jGetSchemaTool(): _agentforge_core.Tool<{
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    schema?: undefined;
+    summary?: undefined;
+} | {
+    success: boolean;
+    schema: {
+        nodeLabels: any[];
+        relationshipTypes: any[];
+        propertyKeys: any[];
+        constraints: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+        indexes: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+    };
+    summary: {
+        totalLabels: number;
+        totalRelationshipTypes: number;
+        totalPropertyKeys: number;
+        totalConstraints: number;
+        totalIndexes: number;
+    };
+    error?: undefined;
+}>;
+
+/**
+ * Neo4j Find Nodes Tool
+ *
+ * Find nodes by label and properties.
+ */
+/**
+ * Create Neo4j find nodes tool
+ */
+declare function createNeo4jFindNodesTool(): _agentforge_core.Tool<{
+    label: string;
+    limit?: number | undefined;
+    properties?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    nodes?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    nodes: any[];
+    count: number;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit?: undefined;
+    };
+    nodes?: undefined;
+    count?: undefined;
+}>;
+
+/**
+ * Neo4j Traverse Tool
+ *
+ * Traverse the graph from a starting node following relationships.
+ */
+/**
+ * Create Neo4j traverse tool
+ */
+declare function createNeo4jTraverseTool(): _agentforge_core.Tool<{
+    startNodeId: string | number;
+    limit?: number | undefined;
+    database?: string | undefined;
+    relationshipType?: string | undefined;
+    direction?: "outgoing" | "incoming" | "both" | undefined;
+    maxDepth?: number | undefined;
+}, {
+    success: boolean;
+    error: string;
+    paths?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    paths: {
+        start: any;
+        end: any;
+        relationships: any;
+        depth: any;
+    }[];
+    count: number;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth?: undefined;
+    };
+    paths?: undefined;
+    count?: undefined;
+}>;
+
+/**
+ * Neo4j Vector Search Tool
+ *
+ * Perform semantic search using vector indexes for GraphRAG applications.
+ */
+/**
+ * Create Neo4j vector search tool
+ */
+declare function createNeo4jVectorSearchTool(): _agentforge_core.Tool<{
+    indexName: string;
+    queryVector: number[];
+    limit?: number | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+}>;
+
+/**
+ * Neo4j Vector Search with Embedding Tool
+ *
+ * Perform semantic search by automatically generating embeddings from text.
+ * This tool combines embedding generation with vector search for easier GraphRAG.
+ */
+/**
+ * Create Neo4j vector search with embedding tool
+ */
+declare function createNeo4jVectorSearchWithEmbeddingTool(): _agentforge_core.Tool<{
+    indexName: string;
+    queryText: string;
+    limit?: number | undefined;
+    database?: string | undefined;
+    model?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+    embedding?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    embedding: {
+        model: string;
+        dimensions: number;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel?: undefined;
+        vectorDimension?: undefined;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+    embedding?: undefined;
+}>;
+
+/**
+ * Neo4j Create Node with Embedding Tool
+ *
+ * Create a node with automatic embedding generation from text content.
+ * This tool simplifies GraphRAG setup by handling embedding generation automatically.
+ */
+/**
+ * Create Neo4j create node with embedding tool
+ */
+declare function createNeo4jCreateNodeWithEmbeddingTool(): _agentforge_core.Tool<{
+    properties: Record<string, any>;
+    label: string;
+    textProperty: string;
+    database?: string | undefined;
+    model?: string | undefined;
+    embeddingProperty?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    node?: undefined;
+    nodeId?: undefined;
+    embedding?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    node: any;
+    nodeId: any;
+    embedding: {
+        model: string;
+        dimensions: number;
+        property: string;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    message: string;
+    error?: undefined;
+}>;
+
+/**
+ * Default Neo4j query tool instance
+ */
+declare const neo4jQuery: _agentforge_core.Tool<{
+    cypher: string;
+    parameters?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    data: any[];
+    recordCount: number;
+    summary: {
+        query: string;
+        parameters: Record<string, any> | undefined;
+        counters: {
+            nodesCreated: number;
+            nodesDeleted: number;
+            relationshipsCreated: number;
+            relationshipsDeleted: number;
+            propertiesSet: number;
+        };
+    };
+    error?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+}>;
+/**
+ * Default Neo4j get schema tool instance
+ */
+declare const neo4jGetSchema: _agentforge_core.Tool<{
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    schema?: undefined;
+    summary?: undefined;
+} | {
+    success: boolean;
+    schema: {
+        nodeLabels: any[];
+        relationshipTypes: any[];
+        propertyKeys: any[];
+        constraints: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+        indexes: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+    };
+    summary: {
+        totalLabels: number;
+        totalRelationshipTypes: number;
+        totalPropertyKeys: number;
+        totalConstraints: number;
+        totalIndexes: number;
+    };
+    error?: undefined;
+}>;
+/**
+ * Default Neo4j find nodes tool instance
+ */
+declare const neo4jFindNodes: _agentforge_core.Tool<{
+    label: string;
+    limit?: number | undefined;
+    properties?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    nodes?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    nodes: any[];
+    count: number;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit?: undefined;
+    };
+    nodes?: undefined;
+    count?: undefined;
+}>;
+/**
+ * Default Neo4j traverse tool instance
+ */
+declare const neo4jTraverse: _agentforge_core.Tool<{
+    startNodeId: string | number;
+    limit?: number | undefined;
+    database?: string | undefined;
+    relationshipType?: string | undefined;
+    direction?: "outgoing" | "incoming" | "both" | undefined;
+    maxDepth?: number | undefined;
+}, {
+    success: boolean;
+    error: string;
+    paths?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    paths: {
+        start: any;
+        end: any;
+        relationships: any;
+        depth: any;
+    }[];
+    count: number;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth?: undefined;
+    };
+    paths?: undefined;
+    count?: undefined;
+}>;
+/**
+ * Default Neo4j vector search tool instance
+ */
+declare const neo4jVectorSearch: _agentforge_core.Tool<{
+    indexName: string;
+    queryVector: number[];
+    limit?: number | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+}>;
+/**
+ * Default Neo4j vector search with embedding tool instance
+ */
+declare const neo4jVectorSearchWithEmbedding: _agentforge_core.Tool<{
+    indexName: string;
+    queryText: string;
+    limit?: number | undefined;
+    database?: string | undefined;
+    model?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+    embedding?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    embedding: {
+        model: string;
+        dimensions: number;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel?: undefined;
+        vectorDimension?: undefined;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+    embedding?: undefined;
+}>;
+/**
+ * Default Neo4j create node with embedding tool instance
+ */
+declare const neo4jCreateNodeWithEmbedding: _agentforge_core.Tool<{
+    properties: Record<string, any>;
+    label: string;
+    textProperty: string;
+    database?: string | undefined;
+    model?: string | undefined;
+    embeddingProperty?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    node?: undefined;
+    nodeId?: undefined;
+    embedding?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    node: any;
+    nodeId: any;
+    embedding: {
+        model: string;
+        dimensions: number;
+        property: string;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    message: string;
+    error?: undefined;
+}>;
+/**
+ * All Neo4j tools (including embedding-enabled tools)
+ */
+declare const neo4jTools: (_agentforge_core.Tool<{
+    cypher: string;
+    parameters?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    data: any[];
+    recordCount: number;
+    summary: {
+        query: string;
+        parameters: Record<string, any> | undefined;
+        counters: {
+            nodesCreated: number;
+            nodesDeleted: number;
+            relationshipsCreated: number;
+            relationshipsDeleted: number;
+            propertiesSet: number;
+        };
+    };
+    error?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+}> | _agentforge_core.Tool<{
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    schema?: undefined;
+    summary?: undefined;
+} | {
+    success: boolean;
+    schema: {
+        nodeLabels: any[];
+        relationshipTypes: any[];
+        propertyKeys: any[];
+        constraints: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+        indexes: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+    };
+    summary: {
+        totalLabels: number;
+        totalRelationshipTypes: number;
+        totalPropertyKeys: number;
+        totalConstraints: number;
+        totalIndexes: number;
+    };
+    error?: undefined;
+}> | _agentforge_core.Tool<{
+    label: string;
+    limit?: number | undefined;
+    properties?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    nodes?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    nodes: any[];
+    count: number;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit?: undefined;
+    };
+    nodes?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    startNodeId: string | number;
+    limit?: number | undefined;
+    database?: string | undefined;
+    relationshipType?: string | undefined;
+    direction?: "outgoing" | "incoming" | "both" | undefined;
+    maxDepth?: number | undefined;
+}, {
+    success: boolean;
+    error: string;
+    paths?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    paths: {
+        start: any;
+        end: any;
+        relationships: any;
+        depth: any;
+    }[];
+    count: number;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth?: undefined;
+    };
+    paths?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    indexName: string;
+    queryVector: number[];
+    limit?: number | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    indexName: string;
+    queryText: string;
+    limit?: number | undefined;
+    database?: string | undefined;
+    model?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+    embedding?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    embedding: {
+        model: string;
+        dimensions: number;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel?: undefined;
+        vectorDimension?: undefined;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+    embedding?: undefined;
+}> | _agentforge_core.Tool<{
+    properties: Record<string, any>;
+    label: string;
+    textProperty: string;
+    database?: string | undefined;
+    model?: string | undefined;
+    embeddingProperty?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    node?: undefined;
+    nodeId?: undefined;
+    embedding?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    node: any;
+    nodeId: any;
+    embedding: {
+        model: string;
+        dimensions: number;
+        property: string;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    message: string;
+    error?: undefined;
+}>)[];
+/**
+ * Core Neo4j tools (without embedding features)
+ */
+declare const neo4jCoreTools: (_agentforge_core.Tool<{
+    cypher: string;
+    parameters?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    data: any[];
+    recordCount: number;
+    summary: {
+        query: string;
+        parameters: Record<string, any> | undefined;
+        counters: {
+            nodesCreated: number;
+            nodesDeleted: number;
+            relationshipsCreated: number;
+            relationshipsDeleted: number;
+            propertiesSet: number;
+        };
+    };
+    error?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+}> | _agentforge_core.Tool<{
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    schema?: undefined;
+    summary?: undefined;
+} | {
+    success: boolean;
+    schema: {
+        nodeLabels: any[];
+        relationshipTypes: any[];
+        propertyKeys: any[];
+        constraints: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+        indexes: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+    };
+    summary: {
+        totalLabels: number;
+        totalRelationshipTypes: number;
+        totalPropertyKeys: number;
+        totalConstraints: number;
+        totalIndexes: number;
+    };
+    error?: undefined;
+}> | _agentforge_core.Tool<{
+    label: string;
+    limit?: number | undefined;
+    properties?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    nodes?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    nodes: any[];
+    count: number;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit?: undefined;
+    };
+    nodes?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    startNodeId: string | number;
+    limit?: number | undefined;
+    database?: string | undefined;
+    relationshipType?: string | undefined;
+    direction?: "outgoing" | "incoming" | "both" | undefined;
+    maxDepth?: number | undefined;
+}, {
+    success: boolean;
+    error: string;
+    paths?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    paths: {
+        start: any;
+        end: any;
+        relationships: any;
+        depth: any;
+    }[];
+    count: number;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth?: undefined;
+    };
+    paths?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    indexName: string;
+    queryVector: number[];
+    limit?: number | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+}>)[];
+/**
+ * Create Neo4j tools with custom configuration
+ */
+declare function createNeo4jTools(config?: Neo4jToolsConfig, includeEmbeddingTools?: boolean): (_agentforge_core.Tool<{
+    cypher: string;
+    parameters?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    data: any[];
+    recordCount: number;
+    summary: {
+        query: string;
+        parameters: Record<string, any> | undefined;
+        counters: {
+            nodesCreated: number;
+            nodesDeleted: number;
+            relationshipsCreated: number;
+            relationshipsDeleted: number;
+            propertiesSet: number;
+        };
+    };
+    error?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: string;
+    data?: undefined;
+    recordCount?: undefined;
+    summary?: undefined;
+}> | _agentforge_core.Tool<{
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    schema?: undefined;
+    summary?: undefined;
+} | {
+    success: boolean;
+    schema: {
+        nodeLabels: any[];
+        relationshipTypes: any[];
+        propertyKeys: any[];
+        constraints: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+        indexes: {
+            name: any;
+            type: any;
+            entityType: any;
+            labelsOrTypes: any;
+            properties: any;
+        }[];
+    };
+    summary: {
+        totalLabels: number;
+        totalRelationshipTypes: number;
+        totalPropertyKeys: number;
+        totalConstraints: number;
+        totalIndexes: number;
+    };
+    error?: undefined;
+}> | _agentforge_core.Tool<{
+    label: string;
+    limit?: number | undefined;
+    properties?: Record<string, any> | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    nodes?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    nodes: any[];
+    count: number;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        label: string;
+        properties: Record<string, any> | undefined;
+        limit?: undefined;
+    };
+    nodes?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    startNodeId: string | number;
+    limit?: number | undefined;
+    database?: string | undefined;
+    relationshipType?: string | undefined;
+    direction?: "outgoing" | "incoming" | "both" | undefined;
+    maxDepth?: number | undefined;
+}, {
+    success: boolean;
+    error: string;
+    paths?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    paths: {
+        start: any;
+        end: any;
+        relationships: any;
+        depth: any;
+    }[];
+    count: number;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        startNodeId: string | number;
+        relationshipType: string | undefined;
+        direction: "outgoing" | "incoming" | "both" | undefined;
+        maxDepth?: undefined;
+    };
+    paths?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    indexName: string;
+    queryVector: number[];
+    limit?: number | undefined;
+    database?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        indexName: string;
+        vectorDimension: number;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+}> | _agentforge_core.Tool<{
+    indexName: string;
+    queryText: string;
+    limit?: number | undefined;
+    database?: string | undefined;
+    model?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    results?: undefined;
+    count?: undefined;
+    query?: undefined;
+    embedding?: undefined;
+} | {
+    success: boolean;
+    results: {
+        node: any;
+        score: any;
+    }[];
+    count: number;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel: string;
+        vectorDimension: number;
+        limit: number | undefined;
+    };
+    embedding: {
+        model: string;
+        dimensions: number;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    query: {
+        text: string;
+        indexName: string;
+        embeddingModel?: undefined;
+        vectorDimension?: undefined;
+        limit?: undefined;
+    };
+    results?: undefined;
+    count?: undefined;
+    embedding?: undefined;
+}> | _agentforge_core.Tool<{
+    properties: Record<string, any>;
+    label: string;
+    textProperty: string;
+    database?: string | undefined;
+    model?: string | undefined;
+    embeddingProperty?: string | undefined;
+}, {
+    success: boolean;
+    error: string;
+    node?: undefined;
+    nodeId?: undefined;
+    embedding?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    node: any;
+    nodeId: any;
+    embedding: {
+        model: string;
+        dimensions: number;
+        property: string;
+        usage: {
+            promptTokens: number;
+            totalTokens: number;
+        } | undefined;
+    };
+    message: string;
+    error?: undefined;
+}>)[];
+/**
+ * Initialize Neo4j tools from environment variables
+ *
+ * Required environment variables:
+ * - NEO4J_URI: Neo4j connection URI (e.g., bolt://localhost:7687)
+ * - NEO4J_USER: Neo4j username
+ * - NEO4J_PASSWORD: Neo4j password
+ *
+ * Optional environment variables:
+ * - NEO4J_DATABASE: Database name (defaults to 'neo4j')
+ *
+ * For embedding-enabled tools, also set:
+ * - OPENAI_API_KEY: OpenAI API key for embedding generation
+ * - EMBEDDING_MODEL: Embedding model to use (defaults to 'text-embedding-3-small')
+ * - EMBEDDING_PROVIDER: Embedding provider (defaults to 'openai')
+ */
+declare function initializeNeo4jTools(): Promise<void>;
+
 /**
  * File Operations Types
  *
@@ -5369,4 +7435,4 @@ declare const askHumanTool: _agentforge_core.Tool<{
     suggestions?: string[] | undefined;
 }, AskHumanOutput>;
 
-export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, type CalculatorInput, CalculatorSchema, type ConfluenceAuth, type ConfluenceToolsConfig, type CreditCardValidatorInput, CreditCardValidatorSchema, type CsvToolsConfig, type CurrentDateTimeInput, CurrentDateTimeSchema, type DateArithmeticInput, DateArithmeticSchema, type DateComparisonInput, DateComparisonSchema, type DateDifferenceInput, DateDifferenceSchema, type DateFormatterInput, DateFormatterSchema, type DateTimeConfig, type DirectoryOperationsConfig, DuckDuckGoProvider, type EmailValidatorInput, EmailValidatorSchema, type FileOperationsConfig, type HtmlParserToolsConfig, HttpMethod, type HttpResponse, type HttpToolsConfig, type IpValidatorInput, IpValidatorSchema, type JsonToolsConfig, type MathFunctionsInput, MathFunctionsSchema, type MathOperationsConfig, type PathUtilitiesConfig, type PhoneValidatorInput, PhoneValidatorSchema, type RandomNumberInput, RandomNumberSchema, type RetryConfig, type ScraperResult, type ScraperToolsConfig, type SearchProvider, type SearchResult, SerperProvider, type SlackClientConfig, type SlackToolsConfig, type StatisticsInput, StatisticsSchema, type StringCaseConverterInput, StringCaseConverterSchema, type StringJoinInput, StringJoinSchema, type StringLengthInput, StringLengthSchema, type StringReplaceInput, StringReplaceSchema, type StringSplitInput, StringSplitSchema, type StringSubstringInput, StringSubstringSchema, type StringTrimInput, StringTrimSchema, type StringUtilitiesConfig, type TransformerToolsConfig, type UrlValidationResult, type UrlValidatorSimpleInput, UrlValidatorSimpleSchema, type UrlValidatorToolsConfig, type UuidValidatorInput, UuidValidatorSchema, type ValidationConfig, type WebSearchInput, type WebSearchOutput, type XmlToolsConfig, archiveConfluencePage, arrayFilter, arrayFilterSchema, arrayGroupBy, arrayGroupBySchema, arrayMap, arrayMapSchema, arraySort, arraySortSchema, askHumanTool, calculator, confluenceTools, createArrayFilterTool, createArrayGroupByTool, createArrayMapTool, createArraySortTool, createAskHumanTool, createCalculatorTool, createConfluencePage, createConfluenceTools, createCreditCardValidatorTool, createCsvGeneratorTool, createCsvParserTool, createCsvToJsonTool, createCsvTools, createCurrentDateTimeTool, createDateArithmeticTool, createDateComparisonTool, createDateDifferenceTool, createDateFormatterTool, createDateTimeTools, createDirectoryCreateTool, createDirectoryDeleteTool, createDirectoryListTool, createDirectoryOperationTools, createDuckDuckGoProvider, createEmailValidatorTool, createExtractImagesTool, createExtractLinksTool, createFileAppendTool, createFileDeleteTool, createFileExistsTool, createFileOperationTools, createFileReaderTool, createFileSearchTool, createFileWriterTool, createHtmlParserTool, createHtmlParserTools, createHttpTools, createIpValidatorTool, createJsonMergeTool, createJsonParserTool, createJsonQueryTool, createJsonStringifyTool, createJsonToCsvTool, createJsonToXmlTool, createJsonTools, createJsonValidatorTool, createMathFunctionsTool, createMathOperationTools, createObjectOmitTool, createObjectPickTool, createPathBasenameTool, createPathDirnameTool, createPathExtensionTool, createPathJoinTool, createPathNormalizeTool, createPathParseTool, createPathRelativeTool, createPathResolveTool, createPathUtilityTools, createPhoneValidatorTool, createRandomNumberTool, createScraperTools, createSerperProvider, createSlackTools, createStatisticsTool, createStringCaseConverterTool, createStringJoinTool, createStringLengthTool, createStringReplaceTool, createStringSplitTool, createStringSubstringTool, createStringTrimTool, createStringUtilityTools, createTransformerTools, createUrlBuilderTool, createUrlQueryParserTool, createUrlValidatorSimpleTool, createUrlValidatorTool, createUrlValidatorTools, createUuidValidatorTool, createValidationTools, createWebScraperTool, createXmlGeneratorTool, createXmlParserTool, createXmlToJsonTool, createXmlTools, creditCardValidator, csvGenerator, csvGeneratorSchema, csvParser, csvParserSchema, csvToJson, csvToJsonSchema, csvTools, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, dateTimeTools, directoryCreate, directoryCreateSchema, directoryDelete, directoryDeleteSchema, directoryList, directoryListSchema, directoryOperationTools, emailValidator, extractImages, extractImagesSchema, extractLinks, extractLinksSchema, fileAppend, fileAppendSchema, fileDelete, fileDeleteSchema, fileExists, fileExistsSchema, fileOperationTools, fileReader, fileReaderSchema, fileSearch, fileSearchSchema, fileWriter, fileWriterSchema, getConfluencePage, getSlackChannels, getSlackMessages, getSpacePages, htmlParser, htmlParserSchema, htmlParserTools, httpClient, httpGet, httpGetSchema, httpPost, httpPostSchema, httpRequestSchema, httpTools, ipValidator, jsonMerge, jsonMergeSchema, jsonParser, jsonParserSchema, jsonQuery, jsonQuerySchema, jsonStringify, jsonStringifySchema, jsonToCsv, jsonToCsvSchema, jsonToXml, jsonToXmlSchema, jsonTools, jsonValidator, jsonValidatorSchema, listConfluenceSpaces, mathFunctions, mathOperationTools, notifySlack, objectOmit, objectOmitSchema, objectPick, objectPickSchema, pathBasename, pathBasenameSchema, pathDirname, pathDirnameSchema, pathExtension, pathExtensionSchema, pathJoin, pathJoinSchema, pathNormalize, pathNormalizeSchema, pathParse, pathParseSchema, pathRelative, pathRelativeSchema, pathResolve, pathResolveSchema, pathUtilityTools, phoneValidator, randomNumber, scraperTools, searchConfluence, searchResultSchema, sendSlackMessage, slackTools, statistics, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, stringUtilityTools, transformerTools, updateConfluencePage, urlBuilder, urlBuilderSchema, urlQueryParser, urlQueryParserSchema, urlValidator, urlValidatorSchema, urlValidatorSimple, urlValidatorTools, uuidValidator, validationTools, webScraper, webScraperSchema, webSearch, webSearchOutputSchema, webSearchSchema, xmlGenerator, xmlGeneratorSchema, xmlParser, xmlParserSchema, xmlToJson, xmlToJsonSchema, xmlTools };
+export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, type BatchEmbeddingResult, type CalculatorInput, CalculatorSchema, type ConfluenceAuth, type ConfluenceToolsConfig, type CreditCardValidatorInput, CreditCardValidatorSchema, type CsvToolsConfig, type CurrentDateTimeInput, CurrentDateTimeSchema, DEFAULT_RETRY_CONFIG, type DateArithmeticInput, DateArithmeticSchema, type DateComparisonInput, DateComparisonSchema, type DateDifferenceInput, DateDifferenceSchema, type DateFormatterInput, DateFormatterSchema, type DateTimeConfig, type DirectoryOperationsConfig, DuckDuckGoProvider, type EmailValidatorInput, EmailValidatorSchema, type EmbeddingConfig, EmbeddingManager, type EmbeddingProvider, type EmbeddingResult, type EmbeddingRetryConfig, type FileOperationsConfig, type HtmlParserToolsConfig, HttpMethod, type HttpResponse, type HttpToolsConfig, type IEmbeddingProvider, type IpValidatorInput, IpValidatorSchema, type JsonToolsConfig, type MathFunctionsInput, MathFunctionsSchema, type MathOperationsConfig, type Neo4jConfig, type Neo4jNode, type Neo4jPath, type Neo4jRelationship, type Neo4jSchema, type Neo4jToolsConfig, OpenAIEmbeddingProvider, type PathUtilitiesConfig, type PhoneValidatorInput, PhoneValidatorSchema, type RandomNumberInput, RandomNumberSchema, type RetryConfig, type ScraperResult, type ScraperToolsConfig, type SearchProvider, type SearchResult, SerperProvider, type SlackClientConfig, type SlackToolsConfig, type StatisticsInput, StatisticsSchema, type StringCaseConverterInput, StringCaseConverterSchema, type StringJoinInput, StringJoinSchema, type StringLengthInput, StringLengthSchema, type StringReplaceInput, StringReplaceSchema, type StringSplitInput, StringSplitSchema, type StringSubstringInput, StringSubstringSchema, type StringTrimInput, StringTrimSchema, type StringUtilitiesConfig, type TransformerToolsConfig, type UrlValidationResult, type UrlValidatorSimpleInput, UrlValidatorSimpleSchema, type UrlValidatorToolsConfig, type UuidValidatorInput, UuidValidatorSchema, type ValidationConfig, type WebSearchInput, type WebSearchOutput, type XmlToolsConfig, archiveConfluencePage, arrayFilter, arrayFilterSchema, arrayGroupBy, arrayGroupBySchema, arrayMap, arrayMapSchema, arraySort, arraySortSchema, askHumanTool, calculator, confluenceTools, createArrayFilterTool, createArrayGroupByTool, createArrayMapTool, createArraySortTool, createAskHumanTool, createCalculatorTool, createConfluencePage, createConfluenceTools, createCreditCardValidatorTool, createCsvGeneratorTool, createCsvParserTool, createCsvToJsonTool, createCsvTools, createCurrentDateTimeTool, createDateArithmeticTool, createDateComparisonTool, createDateDifferenceTool, createDateFormatterTool, createDateTimeTools, createDirectoryCreateTool, createDirectoryDeleteTool, createDirectoryListTool, createDirectoryOperationTools, createDuckDuckGoProvider, createEmailValidatorTool, createExtractImagesTool, createExtractLinksTool, createFileAppendTool, createFileDeleteTool, createFileExistsTool, createFileOperationTools, createFileReaderTool, createFileSearchTool, createFileWriterTool, createHtmlParserTool, createHtmlParserTools, createHttpTools, createIpValidatorTool, createJsonMergeTool, createJsonParserTool, createJsonQueryTool, createJsonStringifyTool, createJsonToCsvTool, createJsonToXmlTool, createJsonTools, createJsonValidatorTool, createMathFunctionsTool, createMathOperationTools, createNeo4jCreateNodeWithEmbeddingTool, createNeo4jFindNodesTool, createNeo4jGetSchemaTool, createNeo4jQueryTool, createNeo4jTools, createNeo4jTraverseTool, createNeo4jVectorSearchTool, createNeo4jVectorSearchWithEmbeddingTool, createObjectOmitTool, createObjectPickTool, createPathBasenameTool, createPathDirnameTool, createPathExtensionTool, createPathJoinTool, createPathNormalizeTool, createPathParseTool, createPathRelativeTool, createPathResolveTool, createPathUtilityTools, createPhoneValidatorTool, createRandomNumberTool, createScraperTools, createSerperProvider, createSlackTools, createStatisticsTool, createStringCaseConverterTool, createStringJoinTool, createStringLengthTool, createStringReplaceTool, createStringSplitTool, createStringSubstringTool, createStringTrimTool, createStringUtilityTools, createTransformerTools, createUrlBuilderTool, createUrlQueryParserTool, createUrlValidatorSimpleTool, createUrlValidatorTool, createUrlValidatorTools, createUuidValidatorTool, createValidationTools, createWebScraperTool, createXmlGeneratorTool, createXmlParserTool, createXmlToJsonTool, createXmlTools, creditCardValidator, csvGenerator, csvGeneratorSchema, csvParser, csvParserSchema, csvToJson, csvToJsonSchema, csvTools, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, dateTimeTools, directoryCreate, directoryCreateSchema, directoryDelete, directoryDeleteSchema, directoryList, directoryListSchema, directoryOperationTools, emailValidator, embeddingManager, extractImages, extractImagesSchema, extractLinks, extractLinksSchema, fileAppend, fileAppendSchema, fileDelete, fileDeleteSchema, fileExists, fileExistsSchema, fileOperationTools, fileReader, fileReaderSchema, fileSearch, fileSearchSchema, fileWriter, fileWriterSchema, generateBatchEmbeddings, generateEmbedding, getCohereApiKey, getConfluencePage, getEmbeddingModel, getEmbeddingProvider, getHuggingFaceApiKey, getOllamaBaseUrl, getOpenAIApiKey, getSlackChannels, getSlackMessages, getSpacePages, getVoyageApiKey, htmlParser, htmlParserSchema, htmlParserTools, httpClient, httpGet, httpGetSchema, httpPost, httpPostSchema, httpRequestSchema, httpTools, initializeEmbeddings, initializeEmbeddingsWithConfig, initializeFromEnv, initializeNeo4jTools, ipValidator, isRetryableError, jsonMerge, jsonMergeSchema, jsonParser, jsonParserSchema, jsonQuery, jsonQuerySchema, jsonStringify, jsonStringifySchema, jsonToCsv, jsonToCsvSchema, jsonToXml, jsonToXmlSchema, jsonTools, jsonValidator, jsonValidatorSchema, listConfluenceSpaces, mathFunctions, mathOperationTools, neo4jCoreTools, neo4jCreateNodeWithEmbedding, neo4jCreateNodeWithEmbeddingSchema, neo4jFindNodes, neo4jFindNodesSchema, neo4jGetSchema, neo4jGetSchemaSchema, neo4jPool, neo4jQuery, neo4jQuerySchema, neo4jTools, neo4jTraverse, neo4jTraverseSchema, neo4jVectorSearch, neo4jVectorSearchSchema, neo4jVectorSearchWithEmbedding, neo4jVectorSearchWithEmbeddingSchema, notifySlack, objectOmit, objectOmitSchema, objectPick, objectPickSchema, pathBasename, pathBasenameSchema, pathDirname, pathDirnameSchema, pathExtension, pathExtensionSchema, pathJoin, pathJoinSchema, pathNormalize, pathNormalizeSchema, pathParse, pathParseSchema, pathRelative, pathRelativeSchema, pathResolve, pathResolveSchema, pathUtilityTools, phoneValidator, randomNumber, retryWithBackoff, scraperTools, searchConfluence, searchResultSchema, sendSlackMessage, slackTools, statistics, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, stringUtilityTools, transformerTools, updateConfluencePage, urlBuilder, urlBuilderSchema, urlQueryParser, urlQueryParserSchema, urlValidator, urlValidatorSchema, urlValidatorSimple, urlValidatorTools, uuidValidator, validateBatch, validateText, validationTools, webScraper, webScraperSchema, webSearch, webSearchOutputSchema, webSearchSchema, xmlGenerator, xmlGeneratorSchema, xmlParser, xmlParserSchema, xmlToJson, xmlToJsonSchema, xmlTools };