ibkr-agent-gateway 0.5.2

Unofficial local-first CLI and MCP gateway for Interactive Brokers workflows.
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

//! Provider compatibility harnesses and snapshots.

pub mod anthropic;
pub mod generic_mcp;
pub mod openai;

use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

/// Provider under compatibility test.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ProviderName {
    /// Generic MCP client or inspector.
    GenericMcp,
    /// OpenAI remote MCP.
    OpenAi,
    /// Anthropic MCP connector.
    Anthropic,
    /// Cursor local MCP client.
    Cursor,
    /// Continue local MCP client.
    Continue,
}

/// MCP client kind.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ClientKind {
    /// MCP inspector.
    Inspector,
    /// Remote MCP connector.
    RemoteConnector,
    /// Local IDE client.
    LocalIde,
}

/// MCP transport kind.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum CompatTransport {
    /// Local stdio MCP.
    Stdio,
    /// Remote Streamable HTTP MCP.
    Http,
}

/// Authentication mode used by the provider/client.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum CompatAuthMode {
    /// Local config scopes.
    LocalConfig,
    /// OAuth/OIDC bearer token.
    OAuthBearer,
}

/// Provider compatibility target.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct ProviderTarget {
    /// Provider name.
    pub provider: ProviderName,
    /// Client kind.
    pub client_kind: ClientKind,
    /// MCP transport.
    pub mcp_transport: CompatTransport,
    /// Auth mode.
    pub auth_mode: CompatAuthMode,
    /// Enabled feature labels.
    pub enabled_features: Vec<String>,
}

/// One compatibility scenario.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct CompatibilityScenario {
    /// Scenario id.
    pub scenario_id: String,
    /// Provider target.
    pub provider_target: ProviderTarget,
    /// Tool name.
    pub tool_name: String,
    /// Input fixture.
    pub input_fixture: serde_json::Value,
    /// Expected response shape label.
    pub expected_shape: String,
    /// Expected auth behavior label.
    pub expected_auth_behavior: String,
}

/// Redaction report for provider-facing payloads.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct RedactionReport {
    /// Checked field paths.
    pub checked_fields: Vec<String>,
    /// Leaks found.
    pub leaks_found: Vec<String>,
    /// Redaction labels.
    pub redactions: Vec<String>,
    /// Secret scan result.
    pub secret_scan_result: String,
}

/// Compatibility snapshot.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct CompatibilitySnapshot {
    /// Snapshot id.
    pub snapshot_id: String,
    /// Scenario id.
    pub scenario_id: String,
    /// Tool schema hash.
    pub tool_schema_hash: String,
    /// Response hash.
    pub response_hash: String,
    /// Redaction report.
    pub redaction_report: RedactionReport,
    /// Creation timestamp label.
    pub created_at: String,
}