updated docs and types

Author: waleedlatif1

apps/docs/content/docs/en/tools/enrich.mdx

@@ -123,7 +123,9 @@ Retrieve basic LinkedIn profile information from an email address. A lighter ver
 | `title` | string | Job title |
 | `location` | string | Location |
 | `company` | string | Current company |
+| `companyLocation` | string | Company location |
 | `companyLinkedIn` | string | Company LinkedIn URL |
+| `profileId` | string | LinkedIn profile ID |
 | `schoolName` | string | School name |
 | `schoolUrl` | string | School URL |
 | `linkedInUrl` | string | LinkedIn profile URL |
@@ -597,7 +599,7 @@ Search for employees within specific companies by location and job title.
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Enrich API key |
-| `companyIds` | json | Yes | Array of company IDs to search within |
+| `companyIds` | json | No | Array of company IDs to search within |
 | `country` | string | No | Country filter \(e.g., United States\) |
 | `city` | string | No | City filter \(e.g., San Francisco\) |
 | `state` | string | No | State filter \(e.g., California\) |
@@ -788,7 +790,7 @@ Get comments on a LinkedIn post.
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Enrich API key |
 | `postUrn` | string | Yes | LinkedIn activity URN \(e.g., urn:li:activity:7191163324208705536\) |
-| `page` | number | Yes | Page number \(starts at 1\) |
+| `page` | number | No | Page number \(starts at 1, default: 1\) |
 
 #### Output
 
@@ -840,6 +842,11 @@ Get a person
 |   ↳ `commentary` | string | Activity text content |
 |   ↳ `linkedInUrl` | string | Link to activity |
 |   ↳ `timeElapsed` | string | Time elapsed since activity |
+|   ↳ `numReactions` | number | Total number of reactions |
+|   ↳ `author` | object | Activity author info |
+|     ↳ `name` | string | Author name |
+|     ↳ `profileId` | string | Profile ID |
+|     ↳ `profilePicture` | string | Profile picture URL |
 |   ↳ `reactionBreakdown` | object | Reactions |
 |     ↳ `likes` | number | Likes |
 |     ↳ `empathy` | number | Empathy reactions |

apps/sim/blocks/blocks/enrich.ts

@@ -271,7 +271,6 @@ export const EnrichBlock: BlockConfig = {
       type: 'code',
       placeholder: '[12345, 67890]',
       condition: { field: 'operation', value: 'search_company_employees' },
-      required: { field: 'operation', value: 'search_company_employees' },
     },
     {
       id: 'country',
@@ -310,13 +309,31 @@ export const EnrichBlock: BlockConfig = {
       placeholder: '["germany", "france"]',
       condition: { field: 'operation', value: 'search_similar_companies' },
     },
+    {
+      id: 'employeeSizeType',
+      title: 'Employee Size Filter Type',
+      type: 'dropdown',
+      options: [
+        { label: 'Range', id: 'RANGE' },
+        { label: 'Exact', id: 'EXACT' },
+      ],
+      condition: { field: 'operation', value: 'search_similar_companies' },
+      mode: 'advanced',
+    },
     {
       id: 'employeeSizeRange',
       title: 'Employee Size Range (JSON)',
       type: 'code',
       placeholder: '[{"start": 50, "end": 200}]',
       condition: { field: 'operation', value: 'search_similar_companies' },
     },
+    {
+      id: 'num',
+      title: 'Results Per Page',
+      type: 'short-input',
+      placeholder: '10',
+      condition: { field: 'operation', value: 'search_similar_companies' },
+    },
 
     {
       id: 'filters',
@@ -418,6 +435,14 @@ export const EnrichBlock: BlockConfig = {
       condition: { field: 'operation', value: 'search_company_activities' },
       required: { field: 'operation', value: 'search_company_activities' },
     },
+    {
+      id: 'offset',
+      title: 'Offset',
+      type: 'short-input',
+      placeholder: '0',
+      condition: { field: 'operation', value: 'search_company_activities' },
+      mode: 'advanced',
+    },
 
     {
       id: 'hash',
@@ -446,6 +471,7 @@ export const EnrichBlock: BlockConfig = {
           'search_post_comments',
         ],
       },
+      required: { field: 'operation', value: 'sales_pointer_people' },
     },
     {
       id: 'pageSize',
@@ -502,70 +528,7 @@ export const EnrichBlock: BlockConfig = {
       'enrich_search_logo',
     ],
     config: {
-      tool: (params) => {
-        switch (params.operation) {
-          case 'check_credits':
-            return 'enrich_check_credits'
-          case 'email_to_profile':
-            return 'enrich_email_to_profile'
-          case 'email_to_person_lite':
-            return 'enrich_email_to_person_lite'
-          case 'linkedin_profile':
-            return 'enrich_linkedin_profile'
-          case 'find_email':
-            return 'enrich_find_email'
-          case 'linkedin_to_work_email':
-            return 'enrich_linkedin_to_work_email'
-          case 'linkedin_to_personal_email':
-            return 'enrich_linkedin_to_personal_email'
-          case 'phone_finder':
-            return 'enrich_phone_finder'
-          case 'email_to_phone':
-            return 'enrich_email_to_phone'
-          case 'verify_email':
-            return 'enrich_verify_email'
-          case 'disposable_email_check':
-            return 'enrich_disposable_email_check'
-          case 'email_to_ip':
-            return 'enrich_email_to_ip'
-          case 'ip_to_company':
-            return 'enrich_ip_to_company'
-          case 'company_lookup':
-            return 'enrich_company_lookup'
-          case 'company_funding':
-            return 'enrich_company_funding'
-          case 'company_revenue':
-            return 'enrich_company_revenue'
-          case 'search_people':
-            return 'enrich_search_people'
-          case 'search_company':
-            return 'enrich_search_company'
-          case 'search_company_employees':
-            return 'enrich_search_company_employees'
-          case 'search_similar_companies':
-            return 'enrich_search_similar_companies'
-          case 'sales_pointer_people':
-            return 'enrich_sales_pointer_people'
-          case 'search_posts':
-            return 'enrich_search_posts'
-          case 'get_post_details':
-            return 'enrich_get_post_details'
-          case 'search_post_reactions':
-            return 'enrich_search_post_reactions'
-          case 'search_post_comments':
-            return 'enrich_search_post_comments'
-          case 'search_people_activities':
-            return 'enrich_search_people_activities'
-          case 'search_company_activities':
-            return 'enrich_search_company_activities'
-          case 'reverse_hash_lookup':
-            return 'enrich_reverse_hash_lookup'
-          case 'search_logo':
-            return 'enrich_search_logo'
-          default:
-            throw new Error(`Invalid Enrich operation: ${params.operation}`)
-        }
-      },
+      tool: (params) => `enrich_${params.operation}`,
       params: (params) => {
         const { operation, ...rest } = params
         const parsedParams: Record<string, any> = { ...rest }
@@ -631,8 +594,18 @@ export const EnrichBlock: BlockConfig = {
           parsedParams.url = rest.domain
         }
 
-        if (parsedParams.page) parsedParams.page = Number(parsedParams.page)
+        if (parsedParams.page) {
+          const pageNum = Number(parsedParams.page)
+          if (operation === 'search_people' || operation === 'search_company') {
+            parsedParams.currentPage = pageNum
+            parsedParams.page = undefined
+          } else {
+            parsedParams.page = pageNum
+          }
+        }
         if (parsedParams.pageSize) parsedParams.pageSize = Number(parsedParams.pageSize)
+        if (parsedParams.num) parsedParams.num = Number(parsedParams.num)
+        if (parsedParams.offset) parsedParams.offset = Number(parsedParams.offset)
         if (parsedParams.staffCountMin)
           parsedParams.staffCountMin = Number(parsedParams.staffCountMin)
         if (parsedParams.staffCountMax)

apps/sim/hooks/queries/usage-history.ts

@@ -55,7 +55,9 @@ export const emailToPersonLiteTool: ToolConfig<
         title: data.title ?? null,
         location: data.location ?? null,
         company: data.company ?? null,
+        companyLocation: data.company_location ?? data.companyLocation ?? null,
         companyLinkedIn: data.company_linkedin ?? data.companyLinkedIn ?? null,
+        profileId: data.profile_id ?? data.profileId ?? null,
         schoolName: data.school_name ?? data.schoolName ?? null,
         schoolUrl: data.school_url ?? data.schoolUrl ?? null,
         linkedInUrl: data.linkedin_url ?? data.linkedInUrl ?? null,
@@ -106,11 +108,21 @@ export const emailToPersonLiteTool: ToolConfig<
       description: 'Current company',
       optional: true,
     },
+    companyLocation: {
+      type: 'string',
+      description: 'Company location',
+      optional: true,
+    },
     companyLinkedIn: {
       type: 'string',
       description: 'Company LinkedIn URL',
       optional: true,
     },
+    profileId: {
+      type: 'string',
+      description: 'LinkedIn profile ID',
+      optional: true,
+    },
     schoolName: {
       type: 'string',
       description: 'School name',

apps/sim/tools/enrich/email_to_person_lite.ts

@@ -51,22 +51,28 @@ export const emailToProfileTool: ToolConfig<
   transformResponse: async (response: Response) => {
     const data = await response.json()
 
+    // API returns positions nested under data.positions.positionHistory
     const positionHistory =
-      data.positionHistory?.map((pos: any) => ({
+      data.positions?.positionHistory?.map((pos: any) => ({
         title: pos.title ?? '',
-        company: pos.companyName ?? pos.company ?? '',
-        startDate: pos.startDate ?? null,
-        endDate: pos.endDate ?? null,
-        location: pos.location ?? null,
+        company: pos.company?.companyName ?? '',
+        startDate: pos.startEndDate?.start
+          ? `${pos.startEndDate.start.year}-${pos.startEndDate.start.month ?? 1}`
+          : null,
+        endDate: pos.startEndDate?.end
+          ? `${pos.startEndDate.end.year}-${pos.startEndDate.end.month ?? 1}`
+          : null,
+        location: pos.company?.companyLocation ?? null,
       })) ?? []
 
+    // API returns education nested under data.schools.educationHistory
     const education =
-      data.schools?.map((edu: any) => ({
-        school: edu.schoolName ?? edu.school ?? '',
-        degree: edu.degree ?? null,
+      data.schools?.educationHistory?.map((edu: any) => ({
+        school: edu.school?.schoolName ?? '',
+        degree: edu.degreeName ?? null,
         fieldOfStudy: edu.fieldOfStudy ?? null,
-        startDate: edu.startDate ?? null,
-        endDate: edu.endDate ?? null,
+        startDate: edu.startEndDate?.start?.year ? String(edu.startEndDate.start.year) : null,
+        endDate: edu.startEndDate?.end?.year ? String(edu.startEndDate.end.year) : null,
       })) ?? []
 
     const certifications =

apps/sim/tools/enrich/email_to_profile.ts

@@ -22,7 +22,7 @@ export const searchCompanyEmployeesTool: ToolConfig<
     },
     companyIds: {
       type: 'json',
-      required: true,
+      required: false,
       visibility: 'user-or-llm',
       description: 'Array of company IDs to search within',
     },
@@ -72,10 +72,9 @@ export const searchCompanyEmployeesTool: ToolConfig<
       'Content-Type': 'application/json',
     }),
     body: (params) => {
-      const body: Record<string, any> = {
-        companyIds: params.companyIds,
-      }
+      const body: Record<string, any> = {}
 
+      if (params.companyIds) body.companyIds = params.companyIds
       if (params.country) body.country = params.country
       if (params.city) body.city = params.city
       if (params.state) body.state = params.state