chore: import upstream snapshot with attribution

apps/sim/tools/context_dev/get_brand.ts

@@ -0,0 +1,91 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
+import type { ContextDevBrandResponse, ContextDevGetBrandParams } from '@/tools/context_dev/types'
+import { BRAND_OUTPUT_PROPERTIES } from '@/tools/context_dev/types'
+import {
+  appendParam,
+  CONTEXT_DEV_BASE_URL,
+  CREDIT_OUTPUTS,
+  contextDevHeaders,
+  parseContextDevResponse,
+  transformBrandResponse,
+} from '@/tools/context_dev/utils'
+import type { ToolConfig } from '@/tools/types'
+
+export const contextDevGetBrandTool: ToolConfig<ContextDevGetBrandParams, ContextDevBrandResponse> =
+  {
+    id: 'context_dev_get_brand',
+    name: 'Context.dev Get Brand',
+    description:
+      'Retrieve brand data for a domain: logos, colors, backdrops, socials, address, and industry.',
+    version: '1.0.0',
+
+    hosting: contextDevHosting<ContextDevGetBrandParams>(),
+
+    params: {
+      domain: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'The domain to retrieve brand data for (e.g., "airbnb.com")',
+      },
+      forceLanguage: {
+        type: 'string',
+        required: false,
+        visibility: 'user-or-llm',
+        description: 'Override the detected language with a supported language code',
+      },
+      maxSpeed: {
+        type: 'boolean',
+        required: false,
+        visibility: 'user-or-llm',
+        description: 'Skip time-consuming operations for a faster response (default: false)',
+      },
+      maxAgeMs: {
+        type: 'number',
+        required: false,
+        visibility: 'user-or-llm',
+        description: 'Cache max age in milliseconds (86400000-31536000000, default: 7776000000)',
+      },
+      timeoutMS: {
+        type: 'number',
+        required: false,
+        visibility: 'user-or-llm',
+        description: 'Request timeout in milliseconds (1000-300000)',
+      },
+      apiKey: {
+        type: 'string',
+        required: true,
+        visibility: 'user-only',
+        description: 'Context.dev API key',
+      },
+    },
+
+    request: {
+      method: 'GET',
+      url: (params) => {
+        const url = new URL(`${CONTEXT_DEV_BASE_URL}/brand/retrieve`)
+        appendParam(url.searchParams, 'domain', params.domain)
+        appendParam(url.searchParams, 'force_language', params.forceLanguage)
+        appendParam(url.searchParams, 'maxSpeed', params.maxSpeed)
+        appendParam(url.searchParams, 'maxAgeMs', params.maxAgeMs)
+        appendParam(url.searchParams, 'timeoutMS', params.timeoutMS)
+        return url.toString()
+      },
+      headers: (params) => contextDevHeaders(params.apiKey),
+    },
+
+    transformResponse: async (response: Response) => {
+      const data = await parseContextDevResponse(response)
+      return { success: true, output: transformBrandResponse(data) }
+    },
+
+    outputs: {
+      status: { type: 'string', description: 'Retrieval status' },
+      brand: {
+        type: 'object',
+        description: 'Brand data object',
+        properties: BRAND_OUTPUT_PROPERTIES,
+      },
+      ...CREDIT_OUTPUTS,
+    },
+  }