Class: SchwabMCP::Tools::ReplaceOrderTool

Inherits:
MCP::Tool
  • Object
show all
Extended by:
Loggable
Defined in:
lib/schwab_mcp/tools/replace_order_tool.rb

Class Method Summary collapse

Methods included from Loggable

log_debug, log_error, log_fatal, log_info, log_warn, logger

Class Method Details

.call(server_context:, **params) ⇒ Object 



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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/schwab_mcp/tools/replace_order_tool.rb', line 89

def self.call(server_context:, **params)
  log_info("Replacing order #{params[:order_id]} with #{params[:strategy_type]} order for account name: #{params[:account_name]}")

  unless params[:account_name].end_with?("_ACCOUNT")
    log_error("Invalid account name format: #{params[:account_name]}")
    return MCP::Tool::Response.new([{
                                     type: "text",
                                     text: "**Error**: Account name must end with '_ACCOUNT'. Example: 'TRADING_BROKERAGE_ACCOUNT'"
                                   }])
  end

  begin
    validate_strategy_params(params)
    client = SchwabClientFactory.create_client
    return SchwabClientFactory.client_error_response unless client

     = (client, params[:account_name])
    return  if .is_a?(MCP::Tool::Response)

    order_builder = SchwabRb::Orders::OrderFactory.build(
      strategy_type: params[:strategy_type],
      price: params[:price],
      quantity: params[:quantity] || 1,
      order_instruction: (params[:order_instruction] || "open").to_sym,
      credit_debit: (params[:credit_debit] || "credit").to_sym,
      # Iron Condor params
      put_short_symbol: params[:put_short_symbol],
      put_long_symbol: params[:put_long_symbol],
      call_short_symbol: params[:call_short_symbol],
      call_long_symbol: params[:call_long_symbol],
      # Vertical spread params
      short_leg_symbol: params[:short_leg_symbol],
      long_leg_symbol: params[:long_leg_symbol],
      # Single option params
      symbol: params[:symbol]
    )

    log_debug("Making replace order API request for order ID: #{params[:order_id]}")
    response = client.replace_order(account_name: params[:account_name], order_id: params[:order_id], order: order_builder)

    if response && (200..299).include?(response.status)
      log_info("Successfully replaced order #{params[:order_id]} with #{params[:strategy_type]} order (HTTP #{response.status})")
      formatted_response = format_replace_order_response(response, params)
      MCP::Tool::Response.new([{
                                type: "text",
                                text: formatted_response
                              }])
    elsif response
      log_error("Order replacement failed with HTTP status #{response.status}")
      error_details = extract_error_details(response)
      MCP::Tool::Response.new([{
                                type: "text",
                                text: "**Error**: Order replacement failed (HTTP #{response.status})\n\n#{error_details}"
                              }])
    else
      log_warn("Empty response from Schwab API for order replacement")
      MCP::Tool::Response.new([{
                                type: "text",
                                text: "**No Data**: Empty response from Schwab API for order replacement"
                              }])
    end
  rescue StandardError => e
    log_error("Error replacing order #{params[:order_id]} with #{params[:strategy_type]} order: #{e.message}")
    log_debug("Backtrace: #{e.backtrace.first(5).join('\n')}")
    MCP::Tool::Response.new([{
                              type: "text",
                              text: "**Error** replacing order #{params[:order_id]} with #{params[:strategy_type]} order: #{e.message}\n\n#{e.backtrace.first(3).join('\n')}"
                            }])
  end
end

.extract_error_details(response) ⇒ Object 



264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
 
# File 'lib/schwab_mcp/tools/replace_order_tool.rb', line 264

def self.extract_error_details(response)
  if response.body && !response.body.empty?
    begin
      parsed = JSON.parse(response.body)
      redacted_data = Redactor.redact(parsed)
      "**Error Details:**\n\n```json\n#{JSON.pretty_generate(redacted_data)}\n```"
    rescue JSON::ParserError
      "**Error Details:**\n\n```\n#{response.body}\n```"
    end
  else
    "No additional error details provided."
  end
rescue StandardError => e
  log_debug("Error extracting error details: #{e.message}")
  "Could not extract error details."
end

.extract_order_id_from_response(response) ⇒ Object 



250
251
252
253
254
255
256
257
258
259
260
261
262
 
# File 'lib/schwab_mcp/tools/replace_order_tool.rb', line 250

def self.extract_order_id_from_response(response)
  # Schwab API typically returns the new order ID in the Location header
  # Format: https://api.schwabapi.com/trader/v1/accounts/{accountHash}/orders/{orderId}
  location = response.headers["Location"] || response.headers["location"]
  return nil unless location

  # Extract order ID from the URL path
  match = location.match(%r{/orders/(\d+)$})
  match ? match[1] : nil
rescue StandardError => e
  log_debug("Could not extract order ID from response: #{e.message}")
  nil
end

.format_replace_order_response(response, params) ⇒ Object 



200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
 
# File 'lib/schwab_mcp/tools/replace_order_tool.rb', line 200

def self.format_replace_order_response(response, params)
  strategy = params[:strategy_type].to_s.upcase
  strategy_summary = case strategy
  when 'IRON_CONDOR'
    "**Iron Condor Order Replaced**\n" \
    "- Put Short: #{params[:put_short_symbol]}\n" \
    "- Put Long: #{params[:put_long_symbol]}\n" \
    "- Call Short: #{params[:call_short_symbol]}\n" \
    "- Call Long: #{params[:call_long_symbol]}\n"
  when 'VERTICAL'
    "**Vertical Spread Order Replaced**\n" \
    "- Short Leg: #{params[:short_leg_symbol]}\n" \
    "- Long Leg: #{params[:long_leg_symbol]}\n"
  when 'SINGLE'
    "**Single Option Order Replaced**\n" \
    "- Symbol: #{params[:symbol]}\n"
  end

  friendly_name = params[:account_name].gsub("_ACCOUNT", "").split("_").map(&:capitalize).join(" ")

  order_details = "**Replacement Order Details:**\n" \
                 "- Original Order ID: #{params[:order_id]}\n" \
                 "- Strategy: #{params[:strategy_type]}\n" \
                 "- Action: #{params[:order_instruction] || "open"}\n" \
                 "- Quantity: #{params[:quantity] || 1}\n" \
                 "- Price: $#{params[:price]}\n" \
                 "- Account: #{friendly_name} (#{params[:account_name]})\n\n"

  new_order_id = extract_order_id_from_response(response)
  order_id_info = new_order_id ? "**New Order ID**: #{new_order_id}\n\n" : ""

  response_info = if response.body && !response.body.empty?
                    begin
                      parsed = JSON.parse(response.body)
                      redacted_data = Redactor.redact(parsed)
                      "**Schwab API Response:**\n\n```json\n#{JSON.pretty_generate(redacted_data)}\n```"
                    rescue JSON::ParserError
                      "**Schwab API Response:**\n\n```\n#{response.body}\n```"
                    end
                  else
                    "**Status**: Order replaced successfully (HTTP #{response.status})\n\n" \
                    "The original order has been canceled and a new order has been created."
                  end

  "#{strategy_summary}\n#{order_details}#{order_id_info}#{response_info}"
rescue StandardError => e
  log_error("Error formatting response: #{e.message}")
  "**Order Status**: #{response.status}\n\n**Raw Response**: #{response.body}"
end

.resolve_account_details(client, account_name) ⇒ Object 



160
161
162
163
164
165
166
167
168
169
170
171
172
 
# File 'lib/schwab_mcp/tools/replace_order_tool.rb', line 160

def self.(client, )
  available_accounts = client.
  unless available_accounts.include?()
    log_error("Account name '#{}' not found in configured accounts")
    return MCP::Tool::Response.new([{
                                     type: "text",
                                     text: "**Error**: Account name '#{}' not found in configured accounts.\n\nAvailable accounts: #{available_accounts.join(", ")}\n\nTo configure: Add the account to your schwab_rb configuration file."
                                   }])
  end

  log_debug("Using account name: #{}")
  
end

.validate_strategy_params(params) ⇒ Object 



174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
 
# File 'lib/schwab_mcp/tools/replace_order_tool.rb', line 174

def self.validate_strategy_params(params)
  strategy = params[:strategy_type].to_s.upcase
  case strategy
  when 'IRON_CONDOR'
    required_fields = %i[put_short_symbol put_long_symbol call_short_symbol call_long_symbol]
    missing_fields = required_fields.select { |field| params[field].nil? || params[field].empty? }
    unless missing_fields.empty?
      raise ArgumentError, "Iron condor strategy requires: #{missing_fields.join(", ")}"
    end
  when 'VERTICAL'
    required_fields = %i[short_leg_symbol long_leg_symbol]
    missing_fields = required_fields.select { |field| params[field].nil? || params[field].empty? }
    unless missing_fields.empty?
      raise ArgumentError, "#{params[:strategy_type]} strategy requires: #{missing_fields.join(", ")}"
    end
  when 'SINGLE'
    required_fields = %i[symbol]
    missing_fields = required_fields.select { |field| params[field].nil? || params[field].empty? }
    unless missing_fields.empty?
      raise ArgumentError, "#{params[:strategy_type]} strategy requires: #{missing_fields.join(", ")}"
    end
  else
    raise ArgumentError, "Unsupported strategy type: #{params[:strategy_type]}"
  end
end