@slates/provider-handler 1.0.0-rc.39 → 1.0.0-rc.40

package/dist/index.cjs

@@ -158,7 +158,7 @@ var getActionWithType = (slate, type, actionId) => {
   }
   return action;
 };
-var mapAction = (_slate, a) => {
+var mapAction = (slate, a) => {
   let base = {
     id: a.key,
     name: a.name,
@@ -175,11 +175,13 @@ var mapAction = (_slate, a) => {
     outputSchema: toJsonSchema(a.outputSchema)
   };
   if (a.type === "tool") {
+    let toolCategoryIds = slate.getToolCategoryKeys?.(a.key) ?? [];
     return {
       ...base,
       type: "action.tool",
       capabilities: {},
-      isPublic: a.isPublic
+      isPublic: a.isPublic,
+      ...toolCategoryIds.length ? { toolCategoryIds } : {}
     };
   }
   return {
@@ -246,6 +248,20 @@ var getWebhookManualRegistration = (group) => {
   }
   return group.webhook.manualRegistration;
 };
+var mapToolCategory = (category) => ({
+  id: category.key,
+  name: category.name,
+  description: category.description,
+  imageUrl: category.imageUrl
+});
+var getExposedToolCategories = (slate, includeAdapterActions) => {
+  let exposedCategoryKeys = new Set(
+    getExposedActions(slate, includeAdapterActions).filter((action) => action.type === "tool").flatMap((action) => slate.getToolCategoryKeys?.(action.key) ?? [])
+  );
+  return (slate.toolCategories ?? []).filter(
+    (category) => exposedCategoryKeys.has(category.key)
+  );
+};
 var mapTriggerGroup = (group) => ({
   id: group.key,
   name: group.name,
@@ -590,7 +606,8 @@ var createProviderHandler = (slate, listeners) => (0, import_proto.createSlatesP
         liveInvocation: true
       },
       provider: {
-        triggerGroups: (slate.triggerGroups?.length ?? 0) > 0 && (slate.actions ?? []).every(isMappableTrigger)
+        triggerGroups: (slate.triggerGroups?.length ?? 0) > 0 && (slate.actions ?? []).every(isMappableTrigger),
+        toolCategories: (slate.toolCategories?.length ?? 0) > 0
       }
     }
   }));
@@ -1041,6 +1058,14 @@ var createProviderHandler = (slate, listeners) => (0, import_proto.createSlatesP
       triggerGroups: getExposedTriggerGroups(slate, supportsAdapters()).map(mapTriggerGroup)
     };
   });
+  manager.onRequest("slates/tool_categories.list", async () => {
+    getContextBasic();
+    return {
+      toolCategories: getExposedToolCategories(slate, supportsAdapters()).map(
+        mapToolCategory
+      )
+    };
+  });
   manager.onRequest("slates/trigger_group.get", async ({ params }) => {
     getContextBasic();
     let triggerGroup = getTriggerGroup(slate, params.triggerGroupId);

package/dist/index.module.js

@@ -142,7 +142,7 @@ var getActionWithType = (slate, type, actionId) => {
   }
   return action;
 };
-var mapAction = (_slate, a) => {
+var mapAction = (slate, a) => {
   let base = {
     id: a.key,
     name: a.name,
@@ -159,11 +159,13 @@ var mapAction = (_slate, a) => {
     outputSchema: toJsonSchema(a.outputSchema)
   };
   if (a.type === "tool") {
+    let toolCategoryIds = slate.getToolCategoryKeys?.(a.key) ?? [];
     return {
       ...base,
       type: "action.tool",
       capabilities: {},
-      isPublic: a.isPublic
+      isPublic: a.isPublic,
+      ...toolCategoryIds.length ? { toolCategoryIds } : {}
     };
   }
   return {
@@ -230,6 +232,20 @@ var getWebhookManualRegistration = (group) => {
   }
   return group.webhook.manualRegistration;
 };
+var mapToolCategory = (category) => ({
+  id: category.key,
+  name: category.name,
+  description: category.description,
+  imageUrl: category.imageUrl
+});
+var getExposedToolCategories = (slate, includeAdapterActions) => {
+  let exposedCategoryKeys = new Set(
+    getExposedActions(slate, includeAdapterActions).filter((action) => action.type === "tool").flatMap((action) => slate.getToolCategoryKeys?.(action.key) ?? [])
+  );
+  return (slate.toolCategories ?? []).filter(
+    (category) => exposedCategoryKeys.has(category.key)
+  );
+};
 var mapTriggerGroup = (group) => ({
   id: group.key,
   name: group.name,
@@ -574,7 +590,8 @@ var createProviderHandler = (slate, listeners) => createSlatesProviderProtoHandl
         liveInvocation: true
       },
       provider: {
-        triggerGroups: (slate.triggerGroups?.length ?? 0) > 0 && (slate.actions ?? []).every(isMappableTrigger)
+        triggerGroups: (slate.triggerGroups?.length ?? 0) > 0 && (slate.actions ?? []).every(isMappableTrigger),
+        toolCategories: (slate.toolCategories?.length ?? 0) > 0
       }
     }
   }));
@@ -1025,6 +1042,14 @@ var createProviderHandler = (slate, listeners) => createSlatesProviderProtoHandl
       triggerGroups: getExposedTriggerGroups(slate, supportsAdapters()).map(mapTriggerGroup)
     };
   });
+  manager.onRequest("slates/tool_categories.list", async () => {
+    getContextBasic();
+    return {
+      toolCategories: getExposedToolCategories(slate, supportsAdapters()).map(
+        mapToolCategory
+      )
+    };
+  });
   manager.onRequest("slates/trigger_group.get", async ({ params }) => {
     getContextBasic();
     let triggerGroup = getTriggerGroup(slate, params.triggerGroupId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slates/provider-handler",
-  "version": "1.0.0-rc.39",
+  "version": "1.0.0-rc.40",
   "publishConfig": {
     "access": "public"
   },
@@ -32,8 +32,8 @@
   },
   "dependencies": {
     "@lowerdeck/error": "^1.1.0",
-    "@slates/proto": "1.0.0-rc.24",
-    "@slates/provider": "1.0.0-rc.29",
+    "@slates/proto": "1.0.0-rc.25",
+    "@slates/provider": "1.0.0-rc.30",
     "p-queue": "^6.6.2",
     "zod": "^4.2.1"
   },

package/src/index.ts

@@ -30,6 +30,7 @@ import {
   getAuthMethod,
   getExposedAction,
   getExposedActions,
+  getExposedToolCategories,
   getExposedTriggerGroups,
   getTriggerGroup,
   getWebhookAutoRegistration,
@@ -38,6 +39,7 @@ import {
   mapAction,
   mapAdapter,
   mapAuthMethod,
+  mapToolCategory,
   mapTriggerGroup
 } from './spec';
 import { State } from './state';
@@ -415,7 +417,8 @@ export let createProviderHandler = <ConfigType extends {}, AuthType extends {}>(
         provider: {
           triggerGroups:
             (slate.triggerGroups?.length ?? 0) > 0 &&
-            (slate.actions ?? []).every(isMappableTrigger)
+            (slate.actions ?? []).every(isMappableTrigger),
+          toolCategories: (slate.toolCategories?.length ?? 0) > 0
         }
       }
     }));
@@ -928,6 +931,16 @@ export let createProviderHandler = <ConfigType extends {}, AuthType extends {}>(
       };
     });
 
+    manager.onRequest('slates/tool_categories.list', async () => {
+      getContextBasic();
+
+      return {
+        toolCategories: getExposedToolCategories(slate, supportsAdapters()).map(
+          mapToolCategory
+        )
+      };
+    });
+
     manager.onRequest('slates/trigger_group.get', async ({ params }) => {
       getContextBasic();
       let triggerGroup = getTriggerGroup(slate, params.triggerGroupId);

package/src/spec.test.ts

@@ -4,13 +4,15 @@ import { z } from 'zod';
 import {
   getExposedAction,
   getExposedActions,
+  getExposedToolCategories,
   getExposedTriggerGroups,
   getMappableAction,
   getTriggersForGroup,
   isMappableTrigger,
   mapAction,
   mapAdapter,
-  mapAuthMethod
+  mapAuthMethod,
+  mapToolCategory
 } from './spec';
 
 let baseAction = {
@@ -61,6 +63,36 @@ describe('mapAction', () => {
     let mapped = mapAction({} as any, validTrigger);
     expect(mapped).toMatchObject({ type: 'action.trigger', triggerGroupId: 'my_group' });
   });
+
+  it('includes the tool categories a tool belongs to', () => {
+    let slate = { getToolCategoryKeys: () => ['crm', 'reporting'] } as any;
+
+    expect(mapAction(slate, toolAction)).toMatchObject({
+      type: 'action.tool',
+      toolCategoryIds: ['crm', 'reporting']
+    });
+  });
+
+  it('omits categories for tools without any, including on slates that predate them', () => {
+    expect(mapAction({ getToolCategoryKeys: () => [] } as any, toolAction)).not.toHaveProperty(
+      'toolCategoryIds'
+    );
+    expect(mapAction({} as any, toolAction)).not.toHaveProperty('toolCategoryIds');
+  });
+});
+
+describe('mapToolCategory', () => {
+  it('maps the category key to the protocol id', () => {
+    expect(
+      mapToolCategory({ key: 'crm', name: 'CRM', description: 'Records' } as any)
+    ).toEqual({ id: 'crm', name: 'CRM', description: 'Records', imageUrl: undefined });
+  });
+
+  it('includes the category image when one is set', () => {
+    expect(
+      mapToolCategory({ key: 'crm', name: 'CRM', imageUrl: 'https://cdn.test/crm.svg' } as any)
+    ).toMatchObject({ id: 'crm', imageUrl: 'https://cdn.test/crm.svg' });
+  });
 });
 
 describe('getTriggersForGroup', () => {
@@ -129,6 +161,29 @@ describe('adapter exposure', () => {
     expect(getExposedAction(slate, 'adapter_tool', true)).toBe(adapterTool);
   });
 
+  it('only exposes tool categories that contain an exposed tool', () => {
+    let providerCategory = { key: 'provider_category', name: 'Provider' };
+    let adapterCategory = { key: 'adapter_category', name: 'Adapter' };
+    let emptyCategory = { key: 'empty_category', name: 'Empty' };
+    let categorizedSlate = {
+      ...slate,
+      toolCategories: [providerCategory, adapterCategory, emptyCategory],
+      getToolCategoryKeys: (key: string) =>
+        key === 'provider_tool'
+          ? ['provider_category']
+          : key === 'adapter_tool'
+            ? ['adapter_category']
+            : []
+    } as any;
+
+    expect(getExposedToolCategories(categorizedSlate, false)).toEqual([providerCategory]);
+    expect(getExposedToolCategories(categorizedSlate, true)).toEqual([
+      providerCategory,
+      adapterCategory
+    ]);
+    expect(getExposedToolCategories(slate, true)).toEqual([]);
+  });
+
   it('only exposes trigger groups that contain an exposed trigger', () => {
     expect(getExposedTriggerGroups(slate, false)).toEqual([providerGroup]);
     expect(getExposedTriggerGroups(slate, true)).toEqual([providerGroup, adapterGroup]);

package/src/spec.ts

@@ -3,12 +3,14 @@ import type {
   SlateAuthenticationMethod,
   SlatesAction,
   SlateAdapter as SlatesAdapter,
+  SlatesToolCategory,
   SlatesTriggerGroup
 } from '@slates/proto';
 import {
   type Slate,
   type SlateAdapter,
   SlateDefaultPollingIntervalSeconds,
+  type SlateToolCategory,
   type SlateTrigger
 } from '@slates/provider';
 import z from 'zod';
@@ -124,7 +126,7 @@ export let getActionWithType = <
 };
 
 export let mapAction = <ConfigType extends {}, AuthType extends {}>(
-  _slate: Slate<ConfigType, AuthType>,
+  slate: Slate<ConfigType, AuthType>,
   a: ReturnType<typeof getAction<ConfigType, AuthType>>
 ): SlatesAction => {
   let base = {
@@ -145,11 +147,14 @@ export let mapAction = <ConfigType extends {}, AuthType extends {}>(
   };
 
   if (a.type === 'tool') {
+    let toolCategoryIds = slate.getToolCategoryKeys?.(a.key) ?? [];
+
     return {
       ...base,
       type: 'action.tool',
       capabilities: {},
-      isPublic: a.isPublic
+      isPublic: a.isPublic,
+      ...(toolCategoryIds.length ? { toolCategoryIds } : {})
     };
   }
 
@@ -269,6 +274,29 @@ export let getWebhookManualRegistration = <ConfigType extends {}, AuthType exten
   return group.webhook.manualRegistration;
 };
 
+export let mapToolCategory = (category: SlateToolCategory): SlatesToolCategory => ({
+  id: category.key,
+  name: category.name,
+  description: category.description,
+  imageUrl: category.imageUrl
+});
+
+// Like trigger groups, a category is only listed when the hub can see one of its tools.
+export let getExposedToolCategories = <ConfigType extends {}, AuthType extends {}>(
+  slate: Slate<ConfigType, AuthType>,
+  includeAdapterActions: boolean
+) => {
+  let exposedCategoryKeys = new Set(
+    getExposedActions(slate, includeAdapterActions)
+      .filter(action => action.type === 'tool')
+      .flatMap(action => slate.getToolCategoryKeys?.(action.key) ?? [])
+  );
+
+  return (slate.toolCategories ?? []).filter(category =>
+    exposedCategoryKeys.has(category.key)
+  );
+};
+
 export let mapTriggerGroup = <ConfigType extends {}, AuthType extends {}>(
   group: ReturnType<typeof getTriggerGroup<ConfigType, AuthType>>
 ): SlatesTriggerGroup => ({