chore: import upstream snapshot with attribution

apps/sim/tools/kalshi/get_order.ts

@@ -0,0 +1,248 @@
+import type { KalshiAuthParams, KalshiOrder } from '@/tools/kalshi/types'
+import { buildKalshiAuthHeaders, buildKalshiUrl, handleKalshiError } from '@/tools/kalshi/types'
+import type { ToolConfig } from '@/tools/types'
+
+export interface KalshiGetOrderParams extends KalshiAuthParams {
+  orderId: string // Order ID to retrieve (required)
+}
+
+export interface KalshiGetOrderResponse {
+  success: boolean
+  output: {
+    order: KalshiOrder
+  }
+}
+
+export const kalshiGetOrderTool: ToolConfig<KalshiGetOrderParams, KalshiGetOrderResponse> = {
+  id: 'kalshi_get_order',
+  name: 'Get Order from Kalshi',
+  description: 'Retrieve details of a specific order by ID from Kalshi',
+  version: '1.0.0',
+
+  params: {
+    keyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Your Kalshi API Key ID',
+    },
+    privateKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Your RSA Private Key (PEM format)',
+    },
+    orderId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Order ID to retrieve (e.g., "abc123-def456-ghi789")',
+    },
+  },
+
+  request: {
+    url: (params) => buildKalshiUrl(`/portfolio/orders/${params.orderId.trim()}`),
+    method: 'GET',
+    headers: (params) => {
+      const path = `/trade-api/v2/portfolio/orders/${params.orderId.trim()}`
+      return buildKalshiAuthHeaders(params.keyId, params.privateKey, 'GET', path)
+    },
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      handleKalshiError(data, response.status, 'get_order')
+    }
+
+    return {
+      success: true,
+      output: {
+        order: data.order,
+      },
+    }
+  },
+
+  outputs: {
+    order: {
+      type: 'object',
+      description: 'Order object with details',
+    },
+  },
+}
+
+export interface KalshiGetOrderV2Params extends KalshiAuthParams {
+  orderId: string // Order ID to retrieve (required)
+}
+
+export interface KalshiGetOrderV2Response {
+  success: boolean
+  output: {
+    order: {
+      order_id: string
+      user_id: string | null
+      client_order_id: string | null
+      ticker: string
+      side: string
+      action: string
+      type: string
+      status: string
+      yes_price: number | null
+      no_price: number | null
+      yes_price_dollars: string | null
+      no_price_dollars: string | null
+      fill_count: number | null
+      fill_count_fp: string | null
+      remaining_count: number | null
+      remaining_count_fp: string | null
+      initial_count: number | null
+      initial_count_fp: string | null
+      taker_fees: number | null
+      maker_fees: number | null
+      taker_fees_dollars: string | null
+      maker_fees_dollars: string | null
+      taker_fill_cost: number | null
+      maker_fill_cost: number | null
+      taker_fill_cost_dollars: string | null
+      maker_fill_cost_dollars: string | null
+      queue_position: number | null
+      expiration_time: string | null
+      created_time: string | null
+      last_update_time: string | null
+      self_trade_prevention_type: string | null
+      order_group_id: string | null
+      cancel_order_on_pause: boolean | null
+    }
+  }
+}
+
+export const kalshiGetOrderV2Tool: ToolConfig<KalshiGetOrderV2Params, KalshiGetOrderV2Response> = {
+  id: 'kalshi_get_order_v2',
+  name: 'Get Order from Kalshi V2',
+  description: 'Retrieve details of a specific order by ID from Kalshi (V2 with full API response)',
+  version: '2.0.0',
+
+  params: {
+    keyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Your Kalshi API Key ID',
+    },
+    privateKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Your RSA Private Key (PEM format)',
+    },
+    orderId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Order ID to retrieve (e.g., "abc123-def456-ghi789")',
+    },
+  },
+
+  request: {
+    url: (params) => buildKalshiUrl(`/portfolio/orders/${params.orderId.trim()}`),
+    method: 'GET',
+    headers: (params) => {
+      const path = `/trade-api/v2/portfolio/orders/${params.orderId.trim()}`
+      return buildKalshiAuthHeaders(params.keyId, params.privateKey, 'GET', path)
+    },
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      handleKalshiError(data, response.status, 'get_order_v2')
+    }
+
+    const order = data.order || {}
+
+    return {
+      success: true,
+      output: {
+        order: {
+          order_id: order.order_id ?? null,
+          user_id: order.user_id ?? null,
+          client_order_id: order.client_order_id ?? null,
+          ticker: order.ticker ?? null,
+          side: order.side ?? null,
+          action: order.action ?? null,
+          type: order.type ?? null,
+          status: order.status ?? null,
+          yes_price: order.yes_price ?? null,
+          no_price: order.no_price ?? null,
+          yes_price_dollars: order.yes_price_dollars ?? null,
+          no_price_dollars: order.no_price_dollars ?? null,
+          fill_count: order.fill_count ?? null,
+          fill_count_fp: order.fill_count_fp ?? null,
+          remaining_count: order.remaining_count ?? null,
+          remaining_count_fp: order.remaining_count_fp ?? null,
+          initial_count: order.initial_count ?? null,
+          initial_count_fp: order.initial_count_fp ?? null,
+          taker_fees: order.taker_fees ?? null,
+          maker_fees: order.maker_fees ?? null,
+          taker_fees_dollars: order.taker_fees_dollars ?? null,
+          maker_fees_dollars: order.maker_fees_dollars ?? null,
+          taker_fill_cost: order.taker_fill_cost ?? null,
+          maker_fill_cost: order.maker_fill_cost ?? null,
+          taker_fill_cost_dollars: order.taker_fill_cost_dollars ?? null,
+          maker_fill_cost_dollars: order.maker_fill_cost_dollars ?? null,
+          queue_position: order.queue_position ?? null,
+          expiration_time: order.expiration_time ?? null,
+          created_time: order.created_time ?? null,
+          last_update_time: order.last_update_time ?? null,
+          self_trade_prevention_type: order.self_trade_prevention_type ?? null,
+          order_group_id: order.order_group_id ?? null,
+          cancel_order_on_pause: order.cancel_order_on_pause ?? null,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    order: {
+      type: 'object',
+      description: 'Order object with full API response fields',
+      properties: {
+        order_id: { type: 'string', description: 'Order ID' },
+        user_id: { type: 'string', description: 'User ID' },
+        client_order_id: { type: 'string', description: 'Client order ID' },
+        ticker: { type: 'string', description: 'Market ticker' },
+        side: { type: 'string', description: 'Order side (yes/no)' },
+        action: { type: 'string', description: 'Action (buy/sell)' },
+        type: { type: 'string', description: 'Order type (limit/market)' },
+        status: { type: 'string', description: 'Order status (resting/canceled/executed)' },
+        yes_price: { type: 'number', description: 'Yes price in cents' },
+        no_price: { type: 'number', description: 'No price in cents' },
+        yes_price_dollars: { type: 'string', description: 'Yes price in dollars' },
+        no_price_dollars: { type: 'string', description: 'No price in dollars' },
+        fill_count: { type: 'number', description: 'Filled contract count' },
+        fill_count_fp: { type: 'string', description: 'Filled count (fixed-point)' },
+        remaining_count: { type: 'number', description: 'Remaining contracts' },
+        remaining_count_fp: { type: 'string', description: 'Remaining count (fixed-point)' },
+        initial_count: { type: 'number', description: 'Initial contract count' },
+        initial_count_fp: { type: 'string', description: 'Initial count (fixed-point)' },
+        taker_fees: { type: 'number', description: 'Taker fees in cents' },
+        maker_fees: { type: 'number', description: 'Maker fees in cents' },
+        taker_fees_dollars: { type: 'string', description: 'Taker fees in dollars' },
+        maker_fees_dollars: { type: 'string', description: 'Maker fees in dollars' },
+        taker_fill_cost: { type: 'number', description: 'Taker fill cost in cents' },
+        maker_fill_cost: { type: 'number', description: 'Maker fill cost in cents' },
+        taker_fill_cost_dollars: { type: 'string', description: 'Taker fill cost in dollars' },
+        maker_fill_cost_dollars: { type: 'string', description: 'Maker fill cost in dollars' },
+        queue_position: { type: 'number', description: 'Queue position (deprecated)' },
+        expiration_time: { type: 'string', description: 'Order expiration time' },
+        created_time: { type: 'string', description: 'Order creation time' },
+        last_update_time: { type: 'string', description: 'Last update time' },
+        self_trade_prevention_type: { type: 'string', description: 'Self-trade prevention type' },
+        order_group_id: { type: 'string', description: 'Order group ID' },
+        cancel_order_on_pause: { type: 'boolean', description: 'Cancel on market pause' },
+      },
+    },
+  },
+}