feat(context-dev): add Context.dev to hosted key rotation pool

apps/sim/.env.example

@@ -77,6 +77,9 @@ API_ENCRYPTION_KEY=your_api_encryption_key # Use `openssl rand -hex 32` to gener
 # PEOPLEDATALABS_API_KEY_COUNT=2 # Number of People Data Labs keys for hosted PDL blocks
 # PEOPLEDATALABS_API_KEY_1= # People Data Labs API key #1
 # PEOPLEDATALABS_API_KEY_2= # People Data Labs API key #2
+# CONTEXT_DEV_API_KEY_COUNT=2 # Number of Context.dev keys for hosted Context.dev blocks
+# CONTEXT_DEV_API_KEY_1= # Context.dev API key #1
+# CONTEXT_DEV_API_KEY_2= # Context.dev API key #2
 
 # File Storage (Optional - defaults to local disk; use S3 or Azure Blob for production)
 # AWS_REGION=us-east-1 # Required with S3_BUCKET_NAME to enable S3. Use "auto" for Cloudflare R2

apps/sim/app/workspace/[workspaceId]/settings/components/byok/byok.tsx

@@ -6,6 +6,7 @@ import {
  AnthropicIcon,
  BasetenIcon,
  BrandfetchIcon,
+ ContextDevIcon,
  DatagmaIcon,
  DropcontactIcon,
  EnrowIcon,
@@ -124,6 +125,13 @@ const PROVIDERS: (BYOKManagerProvider & { id: BYOKProviderId })[] = [
  description: 'AI-powered search and research',
  placeholder: 'Enter your Exa API key',
  },
+ {
+ id: 'context_dev',
+ name: 'Context.dev',
+ icon: ContextDevIcon,
+ description: 'Web scraping, crawling, search, and brand intelligence',
+ placeholder: 'Enter your Context.dev API key',
+ },
  {
  id: 'serper',
  name: 'Serper',
@@ -291,6 +299,7 @@ const PROVIDER_SECTIONS: BYOKProviderSection[] = [
  ids: [
  'firecrawl',
  'exa',
+ 'context_dev',
  'serper',
  'linkup',
  'parallel_ai',

apps/sim/blocks/blocks/context_dev.ts

@@ -540,6 +540,7 @@ Do not include any explanations, markdown formatting, or other text outside the
  placeholder: 'Enter your Context.dev API key',
  password: true,
  required: true,
+ hideWhenHosted: true,
  },
  ],
  tools: {

apps/sim/lib/api/contracts/byok-keys.ts

@@ -14,6 +14,7 @@ export const byokProviderIdSchema = z.enum([
  'falai',
  'firecrawl',
  'exa',
+ 'context_dev',
  'serper',
  'linkup',
  'perplexity',

apps/sim/tools/context_dev/classify_naics.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevClassifyNaicsParams,
  ContextDevClassifyNaicsResponse,
@@ -22,6 +23,8 @@ export const contextDevClassifyNaicsTool: ToolConfig<
  description: 'Classify a brand into NAICS industry codes from its domain or company name.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevClassifyNaicsParams>(),
+
  params: {
  input: {
  type: 'string',

apps/sim/tools/context_dev/classify_sic.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevClassifySicParams,
  ContextDevClassifySicResponse,
@@ -22,6 +23,8 @@ export const contextDevClassifySicTool: ToolConfig<
  description: 'Classify a brand into SIC industry codes from its domain or company name.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevClassifySicParams>(),
+
  params: {
  input: {
  type: 'string',

apps/sim/tools/context_dev/crawl.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type { ContextDevCrawlParams, ContextDevCrawlResponse } from '@/tools/context_dev/types'
 import { CRAWL_RESULT_OUTPUT_PROPERTIES } from '@/tools/context_dev/types'
 import {
@@ -15,6 +16,8 @@ export const contextDevCrawlTool: ToolConfig<ContextDevCrawlParams, ContextDevCr
  description: 'Crawl an entire website and return each discovered page as clean markdown.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevCrawlParams>(),
+
  params: {
  url: {
  type: 'string',

apps/sim/tools/context_dev/extract.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type { ContextDevExtractParams, ContextDevExtractResponse } from '@/tools/context_dev/types'
 import {
  CONTEXT_DEV_BASE_URL,
@@ -15,6 +16,8 @@ export const contextDevExtractTool: ToolConfig<ContextDevExtractParams, ContextD
  description: 'Crawl a website and extract structured data matching a provided JSON schema.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevExtractParams>(),
+
  params: {
  url: {
  type: 'string',

apps/sim/tools/context_dev/extract_product.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevExtractProductParams,
  ContextDevExtractProductResponse,
@@ -21,6 +22,8 @@ export const contextDevExtractProductTool: ToolConfig<
  description: 'Detect and extract structured product details from a single product page URL.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevExtractProductParams>(),
+
  params: {
  url: {
  type: 'string',

apps/sim/tools/context_dev/extract_products.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevExtractProductsParams,
  ContextDevExtractProductsResponse,
@@ -21,6 +22,8 @@ export const contextDevExtractProductsTool: ToolConfig<
  description: "Extract the product catalog from a brand's website by domain (beta).",
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevExtractProductsParams>(),
+
  params: {
  domain: {
  type: 'string',

apps/sim/tools/context_dev/get_brand.ts

@@ -1,3 +1,4 @@
+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 {
@@ -18,6 +19,8 @@ export const contextDevGetBrandTool: ToolConfig<ContextDevGetBrandParams, Contex
  'Retrieve brand data for a domain: logos, colors, backdrops, socials, address, and industry.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevGetBrandParams>(),
+
  params: {
  domain: {
  type: 'string',

apps/sim/tools/context_dev/get_brand_by_email.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevBrandResponse,
  ContextDevGetBrandByEmailParams,
@@ -23,6 +24,8 @@ export const contextDevGetBrandByEmailTool: ToolConfig<
  'Retrieve brand data from a work email address. Free/disposable emails are rejected (422).',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevGetBrandByEmailParams>(),
+
  params: {
  email: {
  type: 'string',

apps/sim/tools/context_dev/get_brand_by_name.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevBrandResponse,
  ContextDevGetBrandByNameParams,
@@ -23,6 +24,8 @@ export const contextDevGetBrandByNameTool: ToolConfig<
  'Retrieve brand data by company name: logos, colors, socials, address, and industry.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevGetBrandByNameParams>(),
+
  params: {
  name: {
  type: 'string',

apps/sim/tools/context_dev/get_brand_by_ticker.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevBrandResponse,
  ContextDevGetBrandByTickerParams,
@@ -22,6 +23,8 @@ export const contextDevGetBrandByTickerTool: ToolConfig<
  description: 'Retrieve brand data for a public company by its stock ticker symbol.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevGetBrandByTickerParams>(),
+
  params: {
  ticker: {
  type: 'string',

apps/sim/tools/context_dev/get_brand_simplified.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevGetBrandSimplifiedParams,
  ContextDevGetBrandSimplifiedResponse,
@@ -22,6 +23,8 @@ export const contextDevGetBrandSimplifiedTool: ToolConfig<
  description: 'Retrieve essential brand data for a domain: title, colors, logos, and backdrops.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevGetBrandSimplifiedParams>(),
+
  params: {
  domain: {
  type: 'string',

apps/sim/tools/context_dev/hosting.test.ts

@@ -0,0 +1,54 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it } from 'vitest'
+import { contextDevClassifyNaicsTool } from '@/tools/context_dev/classify_naics'
+import { contextDevGetBrandTool } from '@/tools/context_dev/get_brand'
+import { CONTEXT_DEV_CREDIT_USD } from '@/tools/context_dev/hosting'
+import { contextDevScrapeMarkdownTool } from '@/tools/context_dev/scrape_markdown'
+import { contextDevScreenshotTool } from '@/tools/context_dev/screenshot'
+import type { ToolConfig } from '@/tools/types'
+
+function cost(tool: ToolConfig<any, any>, params: any, output: Record<string, unknown>) {
+ const pricing = tool.hosting?.pricing
+ if (!pricing || pricing.type !== 'custom') throw new Error('Expected custom pricing')
+ const result = pricing.getCost(params, output)
+ return typeof result === 'number' ? { cost: result } : result
+}
+
+describe('Context.dev hosted key pricing', () => {
+ it('declares hosting with the shared env prefix and BYOK provider on every tool', () => {
+ for (const tool of [
+ contextDevScrapeMarkdownTool,
+ contextDevScreenshotTool,
+ contextDevGetBrandTool,
+ contextDevClassifyNaicsTool,
+ ]) {
+ expect(tool.hosting?.envKeyPrefix).toBe('CONTEXT_DEV_API_KEY')
+ expect(tool.hosting?.byokProviderId).toBe('context_dev')
+ }
+ })
+
+ it('charges the reported credits at the per-credit rate for a 1-credit scrape', () => {
+ expect(cost(contextDevScrapeMarkdownTool, {}, { creditsConsumed: 1 }).cost).toBeCloseTo(
+ CONTEXT_DEV_CREDIT_USD
+ )
+ })
+
+ it('charges the reported credits at the per-credit rate for a 5-credit screenshot', () => {
+ expect(cost(contextDevScreenshotTool, {}, { creditsConsumed: 5 }).cost).toBeCloseTo(
+ 5 * CONTEXT_DEV_CREDIT_USD
+ )
+ })
+
+ it('charges the reported credits at the per-credit rate for a 10-credit brand lookup', () => {
+ expect(cost(contextDevGetBrandTool, {}, { creditsConsumed: 10 }).cost).toBeCloseTo(
+ 10 * CONTEXT_DEV_CREDIT_USD
+ )
+ })
+
+ it('charges zero when the response has no credit accounting', () => {
+ expect(cost(contextDevClassifyNaicsTool, {}, { creditsConsumed: null }).cost).toBe(0)
+ expect(cost(contextDevClassifyNaicsTool, {}, {}).cost).toBe(0)
+ })
+})

apps/sim/tools/context_dev/hosting.ts

@@ -0,0 +1,42 @@
+import type { ToolHostingConfig } from '@/tools/types'
+
+/**
+ * Env var prefix for Context.dev hosted keys. Provide keys as
+ * `CONTEXT_DEV_API_KEY_COUNT` plus `CONTEXT_DEV_API_KEY_1..N`.
+ */
+export const CONTEXT_DEV_API_KEY_PREFIX = 'CONTEXT_DEV_API_KEY'
+
+/**
+ * Dollar cost of a single Context.dev credit.
+ *
+ * Estimated from the $25/month Developer plan (10,000 credits = $0.0025/credit)
+ * — https://www.context.dev/pricing. Endpoints cost 1, 5, or 10 credits
+ * depending on operation; actual usage is read from each response's
+ * `key_metadata.credits_consumed` rather than hardcoded per endpoint.
+ */
+export const CONTEXT_DEV_CREDIT_USD = 0.0025
+
+/**
+ * Build a Context.dev `hosting` config. Every Context.dev response reports the
+ * exact credits consumed via `key_metadata.credits_consumed`, already surfaced
+ * on tool output as `creditsConsumed` by `extractCreditMetadata` — so cost is
+ * read directly from the response rather than estimated per endpoint.
+ */
+export function contextDevHosting<P>(): ToolHostingConfig<P> {
+ return {
+ envKeyPrefix: CONTEXT_DEV_API_KEY_PREFIX,
+ apiKeyParam: 'apiKey',
+ byokProviderId: 'context_dev',
+ pricing: {
+ type: 'custom',
+ getCost: (_params, output) => {
+ const credits = (output.creditsConsumed as number | null) ?? 0
+ return { cost: credits * CONTEXT_DEV_CREDIT_USD, metadata: { credits } }
+ },
+ },
+ rateLimit: {
+ mode: 'per_request',
+ requestsPerMinute: 60,
+ },
+ }
+}

apps/sim/tools/context_dev/identify_transaction.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevBrandResponse,
  ContextDevIdentifyTransactionParams,
@@ -23,6 +24,8 @@ export const contextDevIdentifyTransactionTool: ToolConfig<
  'Identify the brand behind a raw bank/card transaction descriptor and return its brand data.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevIdentifyTransactionParams>(),
+
  params: {
  transactionInfo: {
  type: 'string',

apps/sim/tools/context_dev/map.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type { ContextDevMapParams, ContextDevMapResponse } from '@/tools/context_dev/types'
 import {
  appendParam,
@@ -15,6 +16,8 @@ export const contextDevMapTool: ToolConfig<ContextDevMapParams, ContextDevMapRes
  description: 'Build a sitemap of a domain and return every discovered page URL.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevMapParams>(),
+
  params: {
  domain: {
  type: 'string',

apps/sim/tools/context_dev/prefetch_by_email.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevPrefetchByEmailParams,
  ContextDevPrefetchResponse,
@@ -21,6 +22,8 @@ export const contextDevPrefetchByEmailTool: ToolConfig<
  "Queue an email's domain for brand-data prefetching to reduce later latency (subscribers; 0 credits). Free/disposable emails are rejected.",
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevPrefetchByEmailParams>(),
+
  params: {
  email: {
  type: 'string',

apps/sim/tools/context_dev/prefetch_domain.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevPrefetchDomainParams,
  ContextDevPrefetchResponse,
@@ -21,6 +22,8 @@ export const contextDevPrefetchDomainTool: ToolConfig<
  'Queue a domain for brand-data prefetching to reduce latency on later requests (subscribers; 0 credits).',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevPrefetchDomainParams>(),
+
  params: {
  domain: {
  type: 'string',

apps/sim/tools/context_dev/scrape_fonts.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevScrapeFontsParams,
  ContextDevScrapeFontsResponse,
@@ -22,6 +23,8 @@ export const contextDevScrapeFontsTool: ToolConfig<
  description: 'Extract the font families, usage stats, and font files used by a domain.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevScrapeFontsParams>(),
+
  params: {
  domain: {
  type: 'string',

apps/sim/tools/context_dev/scrape_html.ts

@@ -1,3 +1,4 @@
+import { contextDevHosting } from '@/tools/context_dev/hosting'
 import type {
  ContextDevScrapeHtmlParams,
  ContextDevScrapeHtmlResponse,
@@ -21,6 +22,8 @@ export const contextDevScrapeHtmlTool: ToolConfig<
  description: 'Scrape any URL and return the raw HTML content of the page.',
  version: '1.0.0',
 
+ hosting: contextDevHosting<ContextDevScrapeHtmlParams>(),
+
  params: {
  url: {
  type: 'string',