feat(hex): expand API coverage, fix ID trimming, add cursor pagination

apps/sim/tools/hex/cancel_run.ts

@@ -30,7 +30,7 @@ export const cancelRunTool: ToolConfig<HexCancelRunParams, HexCancelRunResponse>
 
   request: {
     url: (params) =>
-      `https://app.hex.tech/api/v1/projects/${params.projectId}/runs/${params.runId}`,
+      `https://app.hex.tech/api/v1/projects/${params.projectId.trim()}/runs/${params.runId.trim()}`,
     method: 'DELETE',
     headers: (params) => ({
       Authorization: `Bearer ${params.apiKey}`,

apps/sim/tools/hex/create_group.ts

@@ -0,0 +1,78 @@
+import type { HexCreateGroupParams, HexCreateGroupResponse } from '@/tools/hex/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const createGroupTool: ToolConfig<HexCreateGroupParams, HexCreateGroupResponse> = {
+  id: 'hex_create_group',
+  name: 'Hex Create Group',
+  description: 'Create a new group in the Hex workspace, optionally with initial members.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Hex API token (Personal or Workspace)',
+    },
+    name: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Name for the new group',
+    },
+    memberUserIds: {
+      type: 'json',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'JSON array of user UUIDs to add as initial group members (e.g., ["uuid1", "uuid2"])',
+    },
+  },
+
+  request: {
+    url: 'https://app.hex.tech/api/v1/groups',
+    method: 'POST',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => {
+      const body: Record<string, unknown> = { name: params.name }
+      if (params.memberUserIds) {
+        let userIds: unknown
+        try {
+          userIds =
+            typeof params.memberUserIds === 'string'
+              ? JSON.parse(params.memberUserIds)
+              : params.memberUserIds
+        } catch {
+          throw new Error('memberUserIds must be a valid JSON array of user UUID strings')
+        }
+        if (!Array.isArray(userIds) || !userIds.every((id) => typeof id === 'string')) {
+          throw new Error('memberUserIds must be a valid JSON array of user UUID strings')
+        }
+        body.members = { users: userIds.map((id: string) => ({ id: id.trim() })) }
+      }
+      return body
+    },
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    return {
+      success: true,
+      output: {
+        id: data.id ?? null,
+        name: data.name ?? null,
+        createdAt: data.createdAt ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    id: { type: 'string', description: 'Newly created group UUID' },
+    name: { type: 'string', description: 'Group name' },
+    createdAt: { type: 'string', description: 'Creation timestamp' },
+  },
+}

apps/sim/tools/hex/deactivate_user.ts

@@ -0,0 +1,60 @@
+import type { HexDeactivateUserParams, HexDeactivateUserResponse } from '@/tools/hex/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const deactivateUserTool: ToolConfig<HexDeactivateUserParams, HexDeactivateUserResponse> = {
+  id: 'hex_deactivate_user',
+  name: 'Hex Deactivate User',
+  description: 'Deactivate a user in the Hex workspace.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Hex API token (Personal or Workspace)',
+    },
+    userId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The UUID of the user to deactivate',
+    },
+  },
+
+  request: {
+    url: (params) => `https://app.hex.tech/api/v1/users/${params.userId.trim()}/deactivate`,
+    method: 'POST',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response, params) => {
+    if (response.status === 204 || response.ok) {
+      return {
+        success: true,
+        output: {
+          success: true,
+          userId: params?.userId ?? '',
+        },
+      }
+    }
+
+    const data = await response.json().catch(() => ({}))
+    return {
+      success: false,
+      output: {
+        success: false,
+        userId: params?.userId ?? '',
+      },
+      error: (data as Record<string, string>).message ?? 'Failed to deactivate user',
+    }
+  },
+
+  outputs: {
+    success: { type: 'boolean', description: 'Whether the user was successfully deactivated' },
+    userId: { type: 'string', description: 'User UUID that was deactivated' },
+  },
+}

apps/sim/tools/hex/delete_group.ts

@@ -0,0 +1,60 @@
+import type { HexDeleteGroupParams, HexDeleteGroupResponse } from '@/tools/hex/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const deleteGroupTool: ToolConfig<HexDeleteGroupParams, HexDeleteGroupResponse> = {
+  id: 'hex_delete_group',
+  name: 'Hex Delete Group',
+  description: 'Delete a group from the Hex workspace.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Hex API token (Personal or Workspace)',
+    },
+    groupId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The UUID of the group to delete',
+    },
+  },
+
+  request: {
+    url: (params) => `https://app.hex.tech/api/v1/groups/${params.groupId.trim()}`,
+    method: 'DELETE',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response, params) => {
+    if (response.status === 204 || response.ok) {
+      return {
+        success: true,
+        output: {
+          success: true,
+          groupId: params?.groupId ?? '',
+        },
+      }
+    }
+
+    const data = await response.json().catch(() => ({}))
+    return {
+      success: false,
+      output: {
+        success: false,
+        groupId: params?.groupId ?? '',
+      },
+      error: (data as Record<string, string>).message ?? 'Failed to delete group',
+    }
+  },
+
+  outputs: {
+    success: { type: 'boolean', description: 'Whether the group was successfully deleted' },
+    groupId: { type: 'string', description: 'Group UUID that was deleted' },
+  },
+}

apps/sim/tools/hex/get_collection.ts

@@ -23,7 +23,7 @@ export const getCollectionTool: ToolConfig<HexGetCollectionParams, HexGetCollect
   },
 
   request: {
-    url: (params) => `https://app.hex.tech/api/v1/collections/${params.collectionId}`,
+    url: (params) => `https://app.hex.tech/api/v1/collections/${params.collectionId.trim()}`,
     method: 'GET',
     headers: (params) => ({
       Authorization: `Bearer ${params.apiKey}`,

apps/sim/tools/hex/get_data_connection.ts

@@ -27,7 +27,8 @@ export const getDataConnectionTool: ToolConfig<
   },
 
   request: {
-    url: (params) => `https://app.hex.tech/api/v1/data-connections/${params.dataConnectionId}`,
+    url: (params) =>
+      `https://app.hex.tech/api/v1/data-connections/${params.dataConnectionId.trim()}`,
     method: 'GET',
     headers: (params) => ({
       Authorization: `Bearer ${params.apiKey}`,

apps/sim/tools/hex/get_group.ts

@@ -23,7 +23,7 @@ export const getGroupTool: ToolConfig<HexGetGroupParams, HexGetGroupResponse> =
   },
 
   request: {
-    url: (params) => `https://app.hex.tech/api/v1/groups/${params.groupId}`,
+    url: (params) => `https://app.hex.tech/api/v1/groups/${params.groupId.trim()}`,
     method: 'GET',
     headers: (params) => ({
       Authorization: `Bearer ${params.apiKey}`,

apps/sim/tools/hex/get_project.ts

@@ -24,7 +24,7 @@ export const getProjectTool: ToolConfig<HexGetProjectParams, HexGetProjectRespon
   },
 
   request: {
-    url: (params) => `https://app.hex.tech/api/v1/projects/${params.projectId}`,
+    url: (params) => `https://app.hex.tech/api/v1/projects/${params.projectId.trim()}`,
     method: 'GET',
     headers: (params) => ({
       Authorization: `Bearer ${params.apiKey}`,

apps/sim/tools/hex/get_project_runs.ts

@@ -40,6 +40,12 @@ export const getProjectRunsTool: ToolConfig<HexGetProjectRunsParams, HexGetProje
       description:
         'Filter by run status: PENDING, RUNNING, ERRORED, COMPLETED, KILLED, UNABLE_TO_ALLOCATE_KERNEL',
     },
+    runTriggerFilter: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by how the run was triggered: ALL, API, SCHEDULED, or APP_REFRESH',
+    },
   },
 
   request: {
@@ -48,8 +54,9 @@ export const getProjectRunsTool: ToolConfig<HexGetProjectRunsParams, HexGetProje
       if (params.limit) searchParams.set('limit', String(params.limit))
       if (params.offset) searchParams.set('offset', String(params.offset))
       if (params.statusFilter) searchParams.set('statusFilter', params.statusFilter)
+      if (params.runTriggerFilter) searchParams.set('runTriggerFilter', params.runTriggerFilter)
       const qs = searchParams.toString()
-      return `https://app.hex.tech/api/v1/projects/${params.projectId}/runs${qs ? `?${qs}` : ''}`
+      return `https://app.hex.tech/api/v1/projects/${params.projectId.trim()}/runs${qs ? `?${qs}` : ''}`
     },
     method: 'GET',
     headers: (params) => ({
@@ -78,6 +85,8 @@ export const getProjectRunsTool: ToolConfig<HexGetProjectRunsParams, HexGetProje
         })),
         total: runs.length,
         traceId: data.traceId ?? null,
+        nextPage: data.nextPage ?? null,
+        previousPage: data.previousPage ?? null,
       },
     }
   },
@@ -111,5 +120,11 @@ export const getProjectRunsTool: ToolConfig<HexGetProjectRunsParams, HexGetProje
     },
     total: { type: 'number', description: 'Total number of runs returned' },
     traceId: { type: 'string', description: 'Top-level trace ID', optional: true },
+    nextPage: { type: 'string', description: 'Cursor for the next page of runs', optional: true },
+    previousPage: {
+      type: 'string',
+      description: 'Cursor for the previous page of runs',
+      optional: true,
+    },
   },
 }

apps/sim/tools/hex/get_queried_tables.ts

@@ -37,7 +37,7 @@ export const getQueriedTablesTool: ToolConfig<
       const searchParams = new URLSearchParams()
       if (params.limit) searchParams.set('limit', String(params.limit))
       const qs = searchParams.toString()
-      return `https://app.hex.tech/api/v1/projects/${params.projectId}/queriedTables${qs ? `?${qs}` : ''}`
+      return `https://app.hex.tech/api/v1/projects/${params.projectId.trim()}/queriedTables${qs ? `?${qs}` : ''}`
     },
     method: 'GET',
     headers: (params) => ({

apps/sim/tools/hex/get_run_status.ts

@@ -31,7 +31,7 @@ export const getRunStatusTool: ToolConfig<HexGetRunStatusParams, HexGetRunStatus
 
   request: {
     url: (params) =>
-      `https://app.hex.tech/api/v1/projects/${params.projectId}/runs/${params.runId}`,
+      `https://app.hex.tech/api/v1/projects/${params.projectId.trim()}/runs/${params.runId.trim()}`,
     method: 'GET',
     headers: (params) => ({
       Authorization: `Bearer ${params.apiKey}`,

apps/sim/tools/hex/index.ts

@@ -1,5 +1,8 @@
 import { cancelRunTool } from '@/tools/hex/cancel_run'
 import { createCollectionTool } from '@/tools/hex/create_collection'
+import { createGroupTool } from '@/tools/hex/create_group'
+import { deactivateUserTool } from '@/tools/hex/deactivate_user'
+import { deleteGroupTool } from '@/tools/hex/delete_group'
 import { getCollectionTool } from '@/tools/hex/get_collection'
 import { getDataConnectionTool } from '@/tools/hex/get_data_connection'
 import { getGroupTool } from '@/tools/hex/get_group'
@@ -13,10 +16,15 @@ import { listGroupsTool } from '@/tools/hex/list_groups'
 import { listProjectsTool } from '@/tools/hex/list_projects'
 import { listUsersTool } from '@/tools/hex/list_users'
 import { runProjectTool } from '@/tools/hex/run_project'
+import { updateCollectionTool } from '@/tools/hex/update_collection'
+import { updateGroupTool } from '@/tools/hex/update_group'
 import { updateProjectTool } from '@/tools/hex/update_project'
 
 export const hexCancelRunTool = cancelRunTool
 export const hexCreateCollectionTool = createCollectionTool
+export const hexCreateGroupTool = createGroupTool
+export const hexDeactivateUserTool = deactivateUserTool
+export const hexDeleteGroupTool = deleteGroupTool
 export const hexGetCollectionTool = getCollectionTool
 export const hexGetDataConnectionTool = getDataConnectionTool
 export const hexGetGroupTool = getGroupTool
@@ -30,4 +38,6 @@ export const hexListGroupsTool = listGroupsTool
 export const hexListProjectsTool = listProjectsTool
 export const hexListUsersTool = listUsersTool
 export const hexRunProjectTool = runProjectTool
+export const hexUpdateCollectionTool = updateCollectionTool
+export const hexUpdateGroupTool = updateGroupTool
 export const hexUpdateProjectTool = updateProjectTool

apps/sim/tools/hex/list_collections.ts

@@ -27,13 +27,27 @@ export const listCollectionsTool: ToolConfig<HexListCollectionsParams, HexListCo
         visibility: 'user-only',
         description: 'Sort by field: NAME',
       },
+      after: {
+        type: 'string',
+        required: false,
+        visibility: 'user-or-llm',
+        description: 'Cursor to fetch the page of results after this value',
+      },
+      before: {
+        type: 'string',
+        required: false,
+        visibility: 'user-or-llm',
+        description: 'Cursor to fetch the page of results before this value',
+      },
     },
 
     request: {
       url: (params) => {
         const searchParams = new URLSearchParams()
         if (params.limit) searchParams.set('limit', String(params.limit))
         if (params.sortBy) searchParams.set('sortBy', params.sortBy)
+        if (params.after) searchParams.set('after', params.after)
+        if (params.before) searchParams.set('before', params.before)
         const qs = searchParams.toString()
         return `https://app.hex.tech/api/v1/collections${qs ? `?${qs}` : ''}`
       },
@@ -63,6 +77,8 @@ export const listCollectionsTool: ToolConfig<HexListCollectionsParams, HexListCo
               : null,
           })),
           total: collections.length,
+          after: data.pagination?.after ?? null,
+          before: data.pagination?.before ?? null,
         },
       }
     },
@@ -90,5 +106,11 @@ export const listCollectionsTool: ToolConfig<HexListCollectionsParams, HexListCo
         },
       },
       total: { type: 'number', description: 'Total number of collections returned' },
+      after: { type: 'string', description: 'Cursor for the next page of results', optional: true },
+      before: {
+        type: 'string',
+        description: 'Cursor for the previous page of results',
+        optional: true,
+      },
     },
   }