/**
 * Tool Mocking System - Like Jest's jest.fn() for agent tools
 */
export interface ToolMock {
    name: string;
    handler: (args: Record<string, any>) => any;
    callCount: number;
    calls: Array<{
        args: Record<string, any>;
        timestamp: string;
    }>;
}
export declare class MockToolkit {
    private mocks;
    /**
     * Mock a tool with a custom handler (or default no-op).
     */
    mock(toolName: string, handler?: (args: any) => any): ToolMock;
    /**
     * Mock a tool to return a fixed response once, then passthrough.
     */
    mockOnce(toolName: string, response: any): ToolMock;
    /**
     * Mock a tool to return responses in sequence.
     */
    mockSequence(toolName: string, responses: any[]): ToolMock;
    /**
     * Mock a tool to throw an error.
     */
    mockError(toolName: string, error: string): ToolMock;
    /**
     * Restore one or all mocks.
     */
    restore(toolName?: string): void;
    /**
     * Invoke a mock (used by the runner to intercept tool calls).
     */
    invoke(toolName: string, args: Record<string, any>): {
        mocked: boolean;
        result?: any;
    };
    hasMock(toolName: string): boolean;
    getCallCount(toolName: string): number;
    getCalls(toolName: string): any[];
    getMockedTools(): string[];
}
//# sourceMappingURL=mocks.d.ts.map