import { BaseNonAgenticProvider, ExecuteToolFnOptions, ExecuteToolModifiers, McpServerGetResponse, McpUrlResponse, Tool } from "@composio/core";
import { AiTextGenerationToolInput } from "@cloudflare/workers-types";

//#region src/index.d.ts
type AiToolCollection = Record<string, AiTextGenerationToolInput>;
declare class CloudflareProvider extends BaseNonAgenticProvider<AiToolCollection, AiTextGenerationToolInput, McpServerGetResponse> {
  readonly name = "cloudflare";
  /**
   * Creates a new instance of the CloudflareProvider.
   *
   * This provider enables integration with Cloudflare AI,
   * allowing Composio tools to be used with Cloudflare Workers AI.
   *
   * @example
   * ```typescript
   *
   * // Use with Composio
   * const composio = new Composio({
   *   apiKey: 'your-api-key',
   *   provider: new CloudflareProvider()
   * });
   *
   * // Use the provider to wrap tools for Cloudflare AI
   * const cloudflareTools = provider.wrapTools(composioTools);
   * ```
   */
  constructor();
  /**
   * Transform MCP URL response into Anthropic-specific format.
   * By default, Anthropic uses the standard format (same as default),
   * but this method is here to show providers can customize if needed.
   *
   * @param data - The MCP URL response data
   * @returns Standard MCP server response format
   */
  wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse;
  /**
   * Wraps a Composio tool in the Cloudflare AI format.
   *
   * This method transforms a Composio tool definition into the format
   * expected by Cloudflare's AI API for function calling.
   *
   * @param tool - The Composio tool to wrap
   * @returns The wrapped tool in Cloudflare AI format
   *
   * @example
   * ```typescript
   * // Wrap a single tool for use with Cloudflare AI
   * const composioTool = {
   *   slug: 'SEARCH_TOOL',
   *   description: 'Search for information',
   *   inputParameters: {
   *     type: 'object',
   *     properties: {
   *       query: { type: 'string', description: 'Search query' }
   *     },
   *     required: ['query']
   *   }
   * };
   *
   * const cloudflareTool = provider.wrapTool(composioTool);
   * ```
   */
  wrapTool(tool: Tool): AiTextGenerationToolInput;
  /**
   * Wraps a list of Composio tools in the Cloudflare AI format.
   *
   * This method transforms multiple Composio tool definitions into the format
   * expected by Cloudflare's AI API for function calling, organizing them
   * into a dictionary keyed by tool slug.
   *
   * @param tools - Array of Composio tools to wrap
   * @returns Dictionary of wrapped tools in Cloudflare AI format
   *
   * @example
   * ```typescript
   * // Wrap multiple tools for use with Cloudflare AI
   * const composioTools = [
   *   {
   *     slug: 'SEARCH_TOOL',
   *     description: 'Search for information',
   *     inputParameters: {
   *       type: 'object',
   *       properties: {
   *         query: { type: 'string' }
   *       },
   *       required: ['query']
   *     }
   *   },
   *   {
   *     slug: 'WEATHER_TOOL',
   *     description: 'Get weather information',
   *     inputParameters: {
   *       type: 'object',
   *       properties: {
   *         location: { type: 'string' }
   *       },
   *       required: ['location']
   *     }
   *   }
   * ];
   *
   * const cloudflareTools = provider.wrapTools(composioTools);
   *
   * // Use with Cloudflare Workers AI
   * // In your Cloudflare Worker:
   * const ai = new Ai(env.AI);
   *
   * const response = await ai.run('@cf/meta/llama-3-8b-instruct', {
   *   messages: [{ role: 'user', content: 'How is the weather in New York?' }],
   *   tools: cloudflareTools
   * });
   * ```
   */
  wrapTools(tools: Tool[]): AiToolCollection;
  /**
   * Executes a tool call from Cloudflare AI.
   *
   * This method processes a function call from Cloudflare's AI API,
   * executes the corresponding Composio tool, and returns the result.
   *
   * @param userId - The user ID for authentication and tracking
   * @param tool - The tool call object with name and arguments
   * @param options - Optional execution options like connected account ID
   * @param modifiers - Optional execution modifiers for tool behavior
   * @returns The result of the tool execution as a JSON string
   *
   * @example
   * ```typescript
   * // Execute a tool call from Cloudflare AI
   * const toolCall = {
   *   name: 'SEARCH_TOOL',
   *   arguments: {
   *     query: 'composio documentation'
   *   }
   * };
   *
   * const result = await provider.executeToolCall(
   *   'user123',
   *   toolCall,
   *   { connectedAccountId: 'conn_xyz456' }
   * );
   *
   * // Parse the result and use it in your application
   * const searchResults = JSON.parse(result);
   * console.log(searchResults);
   *
   * // You can also use the result to continue the conversation
   * // In your Cloudflare Worker:
   * const ai = new Ai(env.AI);
   *
   * await ai.run('@cf/meta/llama-3-8b-instruct', {
   *   messages: [
   *     { role: 'user', content: 'Search for Composio' },
   *     { role: 'assistant', content: '', tool_calls: [{ name: 'SEARCH_TOOL', arguments: JSON.stringify({ query: 'composio documentation' }) }] },
   *     { role: 'tool', tool_call_id: '1', content: result }
   *   ],
   *   tools: cloudflareTools
   * });
   * ```
   */
  executeToolCall(userId: string, tool: {
    name: string;
    arguments: unknown;
  }, options: ExecuteToolFnOptions, modifiers?: ExecuteToolModifiers): Promise<string>;
}
//#endregion
export { CloudflareProvider };