chore: import upstream snapshot with attribution

apps/sim/tools/kalshi/get_event.ts

@@ -0,0 +1,251 @@
+import type { KalshiEvent } from '@/tools/kalshi/types'
+import { buildKalshiUrl, handleKalshiError } from '@/tools/kalshi/types'
+import type { ToolConfig } from '@/tools/types'
+
+export interface KalshiGetEventParams {
+  eventTicker: string // Event ticker
+  withNestedMarkets?: string // 'true' or 'false'
+}
+
+export interface KalshiGetEventResponse {
+  success: boolean
+  output: {
+    event: KalshiEvent
+  }
+}
+
+export const kalshiGetEventTool: ToolConfig<KalshiGetEventParams, KalshiGetEventResponse> = {
+  id: 'kalshi_get_event',
+  name: 'Get Event from Kalshi',
+  description: 'Retrieve details of a specific event by ticker',
+  version: '1.0.0',
+
+  params: {
+    eventTicker: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Event ticker identifier (e.g., "KXBTC-24DEC31", "INX-25JAN03")',
+    },
+    withNestedMarkets: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include nested markets in response (true/false)',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const queryParams = new URLSearchParams()
+      if (params.withNestedMarkets)
+        queryParams.append('with_nested_markets', params.withNestedMarkets)
+
+      const query = queryParams.toString()
+      const url = buildKalshiUrl(`/events/${params.eventTicker.trim()}`)
+      return query ? `${url}?${query}` : url
+    },
+    method: 'GET',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      handleKalshiError(data, response.status, 'get_event')
+    }
+
+    return {
+      success: true,
+      output: {
+        event: data.event,
+      },
+    }
+  },
+
+  outputs: {
+    event: {
+      type: 'object',
+      description: 'Event object with details',
+    },
+  },
+}
+
+/**
+ * V2 Params for Get Event
+ */
+export interface KalshiGetEventV2Params {
+  eventTicker: string
+  withNestedMarkets?: string
+}
+
+/**
+ * V2 Response matching Kalshi API exactly
+ */
+export interface KalshiGetEventV2Response {
+  success: boolean
+  output: {
+    event: {
+      event_ticker: string
+      series_ticker: string
+      title: string
+      sub_title: string | null
+      mutually_exclusive: boolean
+      category: string
+      collateral_return_type: string | null
+      strike_date: string | null
+      strike_period: string | null
+      available_on_brokers: boolean | null
+      product_metadata: Record<string, unknown> | null
+      markets: Array<{
+        ticker: string
+        event_ticker: string
+        market_type: string
+        title: string
+        subtitle: string | null
+        yes_sub_title: string | null
+        no_sub_title: string | null
+        open_time: string
+        close_time: string
+        expiration_time: string
+        status: string
+        yes_bid: number
+        yes_ask: number
+        no_bid: number
+        no_ask: number
+        last_price: number
+        previous_yes_bid: number | null
+        previous_yes_ask: number | null
+        previous_price: number | null
+        volume: number
+        volume_24h: number
+        liquidity: number | null
+        open_interest: number | null
+        result: string | null
+        cap_strike: number | null
+        floor_strike: number | null
+      }> | null
+    }
+  }
+}
+
+export const kalshiGetEventV2Tool: ToolConfig<KalshiGetEventV2Params, KalshiGetEventV2Response> = {
+  id: 'kalshi_get_event_v2',
+  name: 'Get Event from Kalshi V2',
+  description: 'Retrieve details of a specific event by ticker (V2 - exact API response)',
+  version: '2.0.0',
+
+  params: {
+    eventTicker: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Event ticker identifier (e.g., "KXBTC-24DEC31", "INX-25JAN03")',
+    },
+    withNestedMarkets: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include nested markets in response (true/false)',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const queryParams = new URLSearchParams()
+      if (params.withNestedMarkets)
+        queryParams.append('with_nested_markets', params.withNestedMarkets)
+
+      const query = queryParams.toString()
+      const url = buildKalshiUrl(`/events/${params.eventTicker.trim()}`)
+      return query ? `${url}?${query}` : url
+    },
+    method: 'GET',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      handleKalshiError(data, response.status, 'get_event_v2')
+    }
+
+    const event = data.event || {}
+    const markets =
+      event.markets?.map((m: Record<string, unknown>) => ({
+        ticker: m.ticker ?? null,
+        event_ticker: m.event_ticker ?? null,
+        market_type: m.market_type ?? null,
+        title: m.title ?? null,
+        subtitle: m.subtitle ?? null,
+        yes_sub_title: m.yes_sub_title ?? null,
+        no_sub_title: m.no_sub_title ?? null,
+        open_time: m.open_time ?? null,
+        close_time: m.close_time ?? null,
+        expiration_time: m.expiration_time ?? null,
+        status: m.status ?? null,
+        yes_bid: m.yes_bid ?? 0,
+        yes_ask: m.yes_ask ?? 0,
+        no_bid: m.no_bid ?? 0,
+        no_ask: m.no_ask ?? 0,
+        last_price: m.last_price ?? 0,
+        previous_yes_bid: m.previous_yes_bid ?? null,
+        previous_yes_ask: m.previous_yes_ask ?? null,
+        previous_price: m.previous_price ?? null,
+        volume: m.volume ?? 0,
+        volume_24h: m.volume_24h ?? 0,
+        liquidity: m.liquidity ?? null,
+        open_interest: m.open_interest ?? null,
+        result: m.result ?? null,
+        cap_strike: m.cap_strike ?? null,
+        floor_strike: m.floor_strike ?? null,
+      })) ?? null
+
+    return {
+      success: true,
+      output: {
+        event: {
+          event_ticker: event.event_ticker ?? null,
+          series_ticker: event.series_ticker ?? null,
+          title: event.title ?? null,
+          sub_title: event.sub_title ?? null,
+          mutually_exclusive: event.mutually_exclusive ?? false,
+          category: event.category ?? null,
+          collateral_return_type: event.collateral_return_type ?? null,
+          strike_date: event.strike_date ?? null,
+          strike_period: event.strike_period ?? null,
+          available_on_brokers: event.available_on_brokers ?? null,
+          product_metadata: event.product_metadata ?? null,
+          markets,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    event: {
+      type: 'object',
+      description: 'Event object with full details matching Kalshi API response',
+      properties: {
+        event_ticker: { type: 'string', description: 'Event ticker' },
+        series_ticker: { type: 'string', description: 'Series ticker' },
+        title: { type: 'string', description: 'Event title' },
+        sub_title: { type: 'string', description: 'Event subtitle' },
+        mutually_exclusive: { type: 'boolean', description: 'Mutually exclusive markets' },
+        category: { type: 'string', description: 'Event category' },
+        collateral_return_type: { type: 'string', description: 'Collateral return type' },
+        strike_date: { type: 'string', description: 'Strike date' },
+        strike_period: { type: 'string', description: 'Strike period' },
+        available_on_brokers: { type: 'boolean', description: 'Available on brokers' },
+        product_metadata: { type: 'object', description: 'Product metadata' },
+        markets: { type: 'array', description: 'Nested markets (if requested)' },
+      },
+    },
+  },
+}