converge-provider 3.2.0

LLM provider implementations for Converge
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

// Copyright 2024-2026 Reflective Labs
// SPDX-License-Identifier: MIT

//! Tool abstractions for MCP, `OpenAPI`, and GraphQL integration.
//!
//! This module provides a unified interface for tool discovery, definition,
//! and execution across multiple sources:
//!
//! - **MCP (Model Context Protocol)**: Connect to MCP servers via stdio/HTTP
//! - **`OpenAPI`**: Convert `OpenAPI` specs to tool definitions
//! - **GraphQL**: Introspect GraphQL schemas for tool discovery
//!
//! # Core Types
//!
//! - [`ToolDefinition`]: Describes a tool's interface (name, schema, source)
//! - [`ToolCall`]: A request to invoke a tool
//! - [`ToolResult`]: The outcome of a tool invocation
//! - [`ToolSource`]: Where the tool came from (MCP, `OpenAPI`, GraphQL, inline)

mod definition;
mod error;
mod registry;

// Integration modules
pub mod config;
pub mod graphql;
pub mod mcp;
pub mod openapi;

// Re-exports
pub use definition::{
    GraphQlOperationType, InputSchema, ToolCall, ToolDefinition, ToolResult, ToolResultContent,
    ToolSource,
};
pub use error::{ToolError, ToolErrorKind};
pub use registry::{SourceFilter, ToolHandler, ToolRegistry};

// Convenience re-exports from submodules
pub use config::{
    GraphQlConfig, InlineToolConfig, McpServerConfig, McpTransportType, OpenApiConfig, ToolsConfig,
    ToolsConfigError, build_registry_from_config, load_tools_config, parse_tools_config,
};
pub use graphql::GraphQlConverter;
pub use mcp::{McpClient, McpClientBuilder, McpTransport};
pub use openapi::OpenApiConverter;

/// Tool format for tool definitions injected into prompts.
#[derive(Debug, Clone, Copy, Default)]
pub enum ToolFormat {
    #[default]
    Anthropic,
    OpenAi,
    Generic,
}