feat(integrations): add Kitt enrichment

Author: TheodoreSpeaks

apps/docs/components/icons.tsx

@@ -7445,6 +7445,29 @@ export function KetchIcon(props: SVGProps<SVGSVGElement>) {
   )
 }
 
+/** Kitt robot mark recreated from the official public navbar wordmark. */
+export function KittIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg {...props} viewBox='0 0 24 24' fill='none' xmlns='http://www.w3.org/2000/svg'>
+      <path d='M12 2V5' stroke='currentColor' strokeWidth='1.8' strokeLinecap='round' />
+      <circle cx='12' cy='2' r='1' fill='currentColor' />
+      <rect x='3' y='5' width='18' height='7' rx='3.5' stroke='currentColor' strokeWidth='1.8' />
+      <circle cx='7.5' cy='8.5' r='1.25' fill='currentColor' />
+      <circle cx='16.5' cy='8.5' r='1.25' fill='currentColor' />
+      <path
+        d='M7.5 13.5C7.5 12.67 8.17 12 9 12H15C15.83 12 16.5 12.67 16.5 13.5V18C16.5 18.83 15.83 19.5 15 19.5H9C8.17 19.5 7.5 18.83 7.5 18V13.5Z'
+        fill='currentColor'
+      />
+      <path
+        d='M7.5 14.5L4 13M16.5 14.5L20 13M10 19.5L9.25 22M14 19.5L14.75 22'
+        stroke='currentColor'
+        strokeWidth='1.8'
+        strokeLinecap='round'
+      />
+    </svg>
+  )
+}
+
 export function PolymarketIcon(props: SVGProps<SVGSVGElement>) {
   return (
     <svg {...props} xmlns='http://www.w3.org/2000/svg' viewBox='51 209 123 155'>

apps/docs/components/ui/icon-mapping.ts

@@ -132,6 +132,7 @@ import {
   JupyterIcon,
   KalshiIcon,
   KetchIcon,
+  KittIcon,
   LangsmithIcon,
   LatexIcon,
   LaunchDarklyIcon,
@@ -422,6 +423,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   kalshi: KalshiIcon,
   kalshi_v2: KalshiIcon,
   ketch: KetchIcon,
+  kitt: KittIcon,
   knowledge: PackageSearchIcon,
   langsmith: LangsmithIcon,
   latex: LatexIcon,

apps/docs/content/docs/en/integrations/kitt.mdx

@@ -0,0 +1,63 @@
+---
+title: Kitt
+description: Find and verify B2B email addresses
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="kitt"
+  color="#8064E8"
+/>
+
+## Usage Instructions
+
+Integrate Kitt to find a verified work email from a full name and company domain or to verify an existing B2B email with email-server and identity-server checks.
+
+
+
+## Actions
+
+### Kitt Find Email
+
+Find a verified B2B email address from a full name and company domain or website using Kitt real-time enrichment.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Kitt API key |
+| `fullName` | string | Yes | Full name exactly as listed on LinkedIn or another public directory |
+| `domain` | string | Yes | Company email domain or website |
+| `linkedinStandardProfileURL` | string | No | LinkedIn standard profile URL to improve matching |
+| `strictNameMatches` | boolean | No | Require strict name matching |
+| `customData` | string | No | Caller-defined metadata associated with the request |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `outcome` | string | Kitt result outcome: success or no-results-found for finding; valid, valid-risky, invalid, or unknown for verification |
+| `email` | string | Email address found or verified |
+
+### Kitt Verify Email
+
+Verify a B2B email address using Kitt real-time email-server and identity-server checks.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Kitt API key |
+| `email` | string | Yes | Email address to verify |
+| `treatAliasesAsValid` | boolean | No | Treat forwarding aliases as valid addresses |
+| `customData` | string | No | Caller-defined metadata associated with the request |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `outcome` | string | Kitt result outcome: success or no-results-found for finding; valid, valid-risky, invalid, or unknown for verification |
+| `email` | string | Email address found or verified |
+
+

apps/docs/content/docs/en/integrations/meta.json

@@ -137,6 +137,7 @@
     "jupyter",
     "kalshi",
     "ketch",
+    "kitt",
     "knowledge",
     "langsmith",
     "latex",

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

@@ -24,6 +24,7 @@ import {
   IcypeasIcon,
   JinaAIIcon,
   KimiIcon,
+  KittIcon,
   LeadMagicIcon,
   LinkupIcon,
   MillionVerifierIcon,
@@ -303,6 +304,13 @@ const PROVIDERS: (BYOKManagerProvider & { id: BYOKProviderId })[] = [
     description: 'Email finding and verification',
     placeholder: 'Enter your Icypeas API key',
   },
+  {
+    id: 'kitt',
+    name: 'Kitt',
+    icon: KittIcon,
+    description: 'B2B email finding and verification',
+    placeholder: 'Enter your Kitt API key',
+  },
   {
     id: 'enrow',
     name: 'Enrow',
@@ -385,6 +393,7 @@ const PROVIDER_SECTIONS: BYOKProviderSection[] = [
       'dropcontact',
       'leadmagic',
       'icypeas',
+      'kitt',
       'enrow',
       'zerobounce',
       'neverbounce',

apps/sim/blocks/blocks/kitt.test.ts

@@ -0,0 +1,66 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it } from 'vitest'
+import { KittBlock } from '@/blocks/blocks/kitt'
+
+function mapParams(params: Record<string, unknown>): Record<string, unknown> {
+  const mapper = KittBlock.tools.config.params
+  if (!mapper) throw new Error('Kitt block is missing tools.config.params')
+  return mapper(params)
+}
+
+describe('Kitt block tool wiring', () => {
+  it('selects both registered operation IDs and rejects unknown operations', () => {
+    expect(KittBlock.tools.config.tool({ operation: 'kitt_find_email' })).toBe('kitt_find_email')
+    expect(KittBlock.tools.config.tool({ operation: 'kitt_verify_email' })).toBe(
+      'kitt_verify_email'
+    )
+    expect(() => KittBlock.tools.config.tool({ operation: 'unsupported' })).toThrow(
+      /Unsupported Kitt operation/
+    )
+  })
+
+  it('maps finder fields and coerces the strict-name dropdown during execution', () => {
+    expect(
+      mapParams({
+        operation: 'kitt_find_email',
+        apiKey: 'test-key',
+        fe_fullName: 'Erol Toker',
+        fe_domain: 'trykitt.ai',
+        fe_linkedinStandardProfileURL: 'https://linkedin.com/in/eroltoker',
+        fe_strictNameMatches: 'false',
+        fe_customData: 'crm-123',
+      })
+    ).toEqual({
+      apiKey: 'test-key',
+      fullName: 'Erol Toker',
+      domain: 'trykitt.ai',
+      linkedinStandardProfileURL: 'https://linkedin.com/in/eroltoker',
+      strictNameMatches: false,
+      customData: 'crm-123',
+    })
+  })
+
+  it('maps verifier fields and coerces the alias dropdown during execution', () => {
+    expect(
+      mapParams({
+        operation: 'kitt_verify_email',
+        apiKey: 'test-key',
+        ve_email: 'erol@trykitt.ai',
+        ve_treatAliasesAsValid: 'true',
+        ve_customData: 'crm-456',
+      })
+    ).toEqual({
+      apiKey: 'test-key',
+      email: 'erol@trykitt.ai',
+      treatAliasesAsValid: true,
+      customData: 'crm-456',
+    })
+  })
+
+  it('hides the required API key field on hosted Sim', () => {
+    const apiKey = KittBlock.subBlocks.find((subBlock) => subBlock.id === 'apiKey')
+    expect(apiKey).toMatchObject({ required: true, password: true, hideWhenHosted: true })
+  })
+})