/**
 * Tool system type definitions for NeuroLink
 * Replaces 'any' types in tool registration and execution
 */
import { z } from "zod";
import type { Result, JsonValue, ErrorInfo } from "./common.js";
/**
 * Tool parameter schema types
 */
export type ToolParameterSchema = z.ZodSchema | Record<string, JsonValue>;
/**
 * Standard tool input parameters
 */
export interface BaseToolArgs {
    [key: string]: JsonValue | undefined;
}
/**
 * Tool execution arguments with specific common patterns
 */
export interface ToolArgs extends BaseToolArgs {
    input?: JsonValue;
    data?: JsonValue;
    options?: JsonValue;
}
/**
 * Tool execution metadata
 */
export interface ToolExecutionMetadata {
    requestId?: string;
    startTime?: number;
    version?: string;
    [key: string]: JsonValue | undefined;
}
/**
 * Tool execution context
 */
export interface ToolContext {
    sessionId?: string;
    userId?: string;
    aiProvider?: string;
    metadata?: ToolExecutionMetadata;
}
/**
 * Tool execution result metadata
 */
export interface ToolResultMetadata {
    toolName?: string;
    executionTime?: number;
    timestamp?: number;
    source?: string;
    version?: string;
    serverId?: string;
}
/**
 * Tool execution result
 */
export interface ToolResult<T = JsonValue> extends Result<T, ErrorInfo> {
    success: boolean;
    data?: T;
    error?: ErrorInfo;
    metadata?: ToolResultMetadata;
}
/**
 * Tool metadata for registration
 */
export interface ToolMetadata {
    category?: string;
    version?: string;
    author?: string;
    tags?: string[];
    documentation?: string;
    [key: string]: JsonValue | undefined;
}
/**
 * Tool definition interface
 */
export interface ToolDefinition<TArgs = ToolArgs, TResult = JsonValue> {
    description: string;
    parameters?: ToolParameterSchema;
    metadata?: ToolMetadata;
    execute: (args: TArgs, context?: ToolContext) => Promise<ToolResult<TResult>> | ToolResult<TResult>;
}
/**
 * Simple tool interface (for SDK)
 */
export interface SimpleTool<TArgs = ToolArgs, TResult = JsonValue> {
    description: string;
    parameters?: z.ZodSchema;
    metadata?: ToolMetadata;
    execute: (args: TArgs, context?: ToolContext) => Promise<TResult> | TResult;
}
/**
 * Tool registry entry
 */
export interface ToolRegistryEntry {
    name: string;
    description: string;
    serverId?: string;
    isImplemented?: boolean;
    parameters?: ToolParameterSchema;
    execute?: ToolDefinition["execute"];
}
/**
 * Tool execution information
 */
export interface ToolExecution {
    toolName: string;
    args: ToolArgs;
    result: ToolResult;
    executionTime: number;
    timestamp: number;
}
/**
 * Available tool information
 */
export interface AvailableTool {
    name: string;
    description: string;
    serverId?: string;
    toolName?: string;
    parameters?: ToolParameterSchema;
}
/**
 * Tool validation options
 */
export interface ToolValidationOptions {
    customValidator?: (toolName: string, args: ToolArgs) => boolean | Promise<boolean>;
    validateSchema?: boolean;
    allowUnknownProperties?: boolean;
}
/**
 * Tool call information (for AI SDK integration)
 */
export interface ToolCall {
    toolName: string;
    parameters: ToolArgs;
    id?: string;
}
/**
 * AI SDK Tool Call format (from Vercel AI SDK)
 */
export interface AiSdkToolCall {
    type: "tool-call";
    toolCallId: string;
    toolName: string;
    args: ToolArgs;
}
/**
 * Tool call result (for AI SDK integration)
 */
export interface ToolCallResult {
    id?: string;
    result: ToolResult;
    formattedForAI: string;
}
/**
 * Type guard for tool result
 */
export declare function isToolResult(value: unknown): value is ToolResult;
/**
 * Type guard for tool definition
 */
export declare function isToolDefinition(value: unknown): value is ToolDefinition;