@knocklabs/agent-toolkit 0.1.5 → 0.1.7

package/dist/{chunk-RPKDXX4O.js → chunk-3CUTEODM.js}

@@ -25,18 +25,26 @@ var KnockTool = (args) => {
 };
 
 // src/lib/tools/channels.ts
+function serializeChannelResponse(channel) {
+  return {
+    key: channel.key,
+    name: channel.name,
+    type: channel.type,
+    provider: channel.provider
+  };
+}
 var listChannels = KnockTool({
   method: "list_channels",
   name: "List channels",
   description: `
-  Returns a list of all of the channels configured in the account. Each channel returns information about the type of channel it is (email, sms, push, etc), and the provider that's used to power the channel.
+  Returns a list of all of the channels configured in the account. Each channel returns information about the type of channel it is (email, sms, push, etc), and the provider that's used to power the channel. Channels can be used across all environments.
 
   Use this tool when you need to know about the channels configured in the Knock account, like when configuring a workflow.
   `,
   execute: (knockClient) => async (params) => {
     const allChannels = [];
     for await (const channel of knockClient.channels.list()) {
-      allChannels.push(channel);
+      allChannels.push(serializeChannelResponse(channel));
     }
     return allChannels;
   }
@@ -57,7 +65,7 @@ var listCommits = KnockTool({
   Returns all commits available in the environment. Use this tool when you are asked to see what changes are available to be deployed.
   `,
   parameters: z2.object({
-    environment: z2.string().describe(
+    environment: z2.string().optional().describe(
       "(string): The environment to list commits for. Defaults to `development`."
     ),
     promoted: z2.boolean().describe(
@@ -75,14 +83,17 @@ var commitAllChanges = KnockTool({
   method: "commit_all_changes",
   name: "Commit all changes",
   description: `
-  Commit all pending changes to the current environment. Use this tool when you are asked to save all changes to the current environment. This can only be used in the development environment.
+  Commit all pending changes. This can only be used in the development environment.
   `,
   parameters: z2.object({
-    message: z2.string().describe("(string): The message to include in the commit.")
+    environment: z2.string().optional().describe(
+      "(string): The environment to commit all changes to. Defaults to `development`."
+    ),
+    message: z2.string().optional().describe("(string): The message to include in the commit.")
   }),
   execute: (knockClient, config) => async (params) => {
     return await knockClient.commits.commitAll({
-      environment: config.environment ?? "development",
+      environment: params.environment ?? config.environment ?? "development",
       commit_message: params.message
     });
   }
@@ -91,9 +102,7 @@ var promoteAllCommits = KnockTool({
   method: "promote_all_commits",
   name: "Promote all commits",
   description: `
-  Promote all commits to the next environment. Use this tool when you are asked to deploy all changes. 
-
-  When not specified, the \`toEnvironment\` will default to the environment that comes after the environment specified in the config.
+  Promote all commits to the next environment. Use this tool when you are asked to deploy all changes.
   `,
   parameters: z2.object({
     toEnvironment: z2.string().describe("(string): The environment to promote all commits to.")
@@ -116,6 +125,12 @@ var permissions2 = {
 
 // src/lib/tools/email-layouts.ts
 import { z as z3 } from "zod";
+function serializeEmailLayoutResponse(emailLayout) {
+  return {
+    key: emailLayout.key,
+    name: emailLayout.name
+  };
+}
 var listEmailLayouts = KnockTool({
   method: "list_email_layouts",
   name: "List email layouts",
@@ -123,7 +138,7 @@ var listEmailLayouts = KnockTool({
   
   Use this tool when building a workflow that is building an email notification when you need to know the available email layouts.`,
   parameters: z3.object({
-    environment: z3.string().describe(
+    environment: z3.string().optional().describe(
       "(string): The environment to list email layouts for. Defaults to `development`."
     )
   }),
@@ -132,7 +147,7 @@ var listEmailLayouts = KnockTool({
     for await (const emailLayout of knockClient.emailLayouts.list({
       environment: params.environment ?? config.environment ?? "development"
     })) {
-      allEmailLayouts.push(emailLayout);
+      allEmailLayouts.push(serializeEmailLayoutResponse(emailLayout));
     }
     return allEmailLayouts;
   }
@@ -145,16 +160,22 @@ var permissions3 = {
 };
 
 // src/lib/tools/environments.ts
+function serializeEnvironmentResponse(environment) {
+  return {
+    slug: environment.slug,
+    name: environment.name
+  };
+}
 var listEnvironments = KnockTool({
   method: "list_environments",
   name: "List environments",
   description: `
-  Lists all environments available, returning the slug, name, and the order of each environment. Use this tool when you need to see what environments are available to deploy to.
+  Lists all environments available, returning the slug and name of each environment. Use this tool when you need to see what environments are available.
   `,
   execute: (knockClient) => async (params) => {
     const allEnvironments = [];
     for await (const environment of knockClient.environments.list()) {
-      allEnvironments.push(environment);
+      allEnvironments.push(serializeEnvironmentResponse(environment));
     }
     return allEnvironments;
   }
@@ -175,10 +196,13 @@ var getMessageContent = KnockTool({
   Retrieves the complete contents of a single message, specified by the messageId. The message contents includes the rendered template that was sent to the recipient. Use this tool when you want to surface information about the emails, SMS, and push notifications that were sent to a user.
   `,
   parameters: z4.object({
+    environment: z4.string().optional().describe(
+      "(string): The environment to retrieve the message from. Defaults to `development`."
+    ),
     messageId: z4.string().describe("(string): The messageId of the message to retrieve.")
   }),
   execute: (knockClient) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.messages.getContent(params.messageId);
   }
 });
@@ -191,12 +215,20 @@ var permissions5 = {
 
 // src/lib/tools/message-types.ts
 import { z as z5 } from "zod";
+function serializeMessageTypeResponse(messageType) {
+  return {
+    key: messageType.key,
+    name: messageType.name,
+    description: messageType.description,
+    variants: messageType.variants.map((variant) => variant.key)
+  };
+}
 var listMessageTypes = KnockTool({
   method: "list_message_types",
   name: "List message types",
   description: "List all message types available for the environment. Each message type returns the schema, which includes information about the variants and the fields available per-variant. Use this tool when you need to understand the different message types that are available for the environment for use in Guides.",
   parameters: z5.object({
-    environment: z5.string().describe(
+    environment: z5.string().optional().describe(
       "(string): The environment to list message types for. Defaults to `development`."
     )
   }),
@@ -205,7 +237,7 @@ var listMessageTypes = KnockTool({
     for await (const messageType of knockClient.messageTypes.list({
       environment: params.environment ?? config.environment ?? "development"
     })) {
-      allMessageTypes.push(messageType);
+      allMessageTypes.push(serializeMessageTypeResponse(messageType));
     }
     return allMessageTypes;
   }
@@ -288,26 +320,9 @@ var createOrUpdateMessageType = KnockTool({
                     "value": "warning",
                     "label": "Warning",
                   },
-                  {
-                    "value": "success",
-                    "label": "Success",
-                  },
-                  {
-                    "value": "info",
-                    "label": "Info",
-                  },
-                  {
-                    "value": "error",
-                    "label": "Error",
-                  },
                 ]
               },
             },
-            {
-              "key": "title",
-              "type": "text",
-              "label": "Title",
-            },
             {
               "key": "description",
               "type": "markdown",
@@ -326,6 +341,9 @@ var createOrUpdateMessageType = KnockTool({
   </example>
   `,
   parameters: z5.object({
+    environment: z5.string().optional().describe(
+      "(string): The environment to create or update the message type in. Defaults to `development`."
+    ),
     messageTypeKey: z5.string().describe("(string): The key of the message type to create or update."),
     name: z5.string().describe("(string): The name of the message type."),
     description: z5.string().optional().describe("(string): The description of the message type."),
@@ -341,10 +359,10 @@ var createOrUpdateMessageType = KnockTool({
           z5.object({
             key: z5.string().describe("(string): The key of the field."),
             type: z5.string().describe(
-              "(string): The type of the field. One of `text`, `textarea`, `button`, `markdown`, `select`, `multi_select`."
+              "(string): The type of the field. One of `text`, `textarea`, `button`, `markdown`, `select`, `multi_select`, `image`."
             ),
             label: z5.string().describe("(string): The label of the field."),
-            settings: z5.object({}).describe("(object): The settings of the field.")
+            settings: z5.object({}).optional().describe("(object): The settings of the field.")
           })
         ).describe("(array): The fields of the variant.")
       })
@@ -378,10 +396,13 @@ var listObjects = KnockTool({
   name: "List objects",
   description: "List all objects in a single collection. Objects are used to model custom collections in Knock that are NOT users or tenants. Use this tool when you need to return a paginated list of objects in a single collection.",
   parameters: z6.object({
+    environment: z6.string().optional().describe(
+      "(string): The environment to list objects from. Defaults to `development`."
+    ),
     collection: z6.string().describe("(string): The collection to list objects from.")
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.objects.list(params.collection);
   }
 });
@@ -390,11 +411,14 @@ var getObject = KnockTool({
   name: "Get object",
   description: "Get an object wihin a collection. Returns information about the object including any custom properties. Use this tool when you need to retrieve an object to understand it's properties.",
   parameters: z6.object({
+    environment: z6.string().optional().describe(
+      "(string): The environment to get the object from. Defaults to `development`."
+    ),
     collection: z6.string().describe("(string): The collection to get the object from."),
     objectId: z6.string().describe("(string): The ID of the object to get.")
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.objects.get(params.collection, params.objectId);
   }
 });
@@ -405,12 +429,15 @@ var createOrUpdateObject = KnockTool({
   
   Use this tool when you need to create a new object, or update an existing custom-object. Custom objects can be used to subscribe users' to as lists, and also send non-user facing notifications to.`,
   parameters: z6.object({
+    environment: z6.string().optional().describe(
+      "(string): The environment to create or update the object in. Defaults to `development`."
+    ),
     collection: z6.string().describe("(string): The collection to create or update the object in."),
     objectId: z6.string().describe("(string): The ID of the object to create or update."),
-    properties: z6.record(z6.string(), z6.any()).describe("(object): The properties to set on the object.")
+    properties: z6.record(z6.string(), z6.any()).optional().describe("(object): The properties to set on the object.")
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.objects.set(
       params.collection,
       params.objectId,
@@ -418,20 +445,6 @@ var createOrUpdateObject = KnockTool({
     );
   }
 });
-var deleteObject = KnockTool({
-  method: "delete_object",
-  name: "Delete object",
-  description: `Delete an object from a specific collection. Use this tool when you need to remove an object from the system.`,
-  parameters: z6.object({
-    collection: z6.string().describe("(string): The collection to delete the object from."),
-    objectId: z6.string().describe("(string): The ID of the object to delete.")
-  }),
-  execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
-    await publicClient.objects.delete(params.collection, params.objectId);
-    return { success: true };
-  }
-});
 var subscribeUsersToObject = KnockTool({
   method: "subscribe_users_to_object",
   name: "Subscribe users to object",
@@ -443,6 +456,9 @@ var subscribeUsersToObject = KnockTool({
   Before using this tool, you should create the object in the collection using the createOrUpdateObject tool.
   `,
   parameters: z6.object({
+    environment: z6.string().optional().describe(
+      "(string): The environment to subscribe the user to. Defaults to `development`."
+    ),
     collection: z6.string().describe("(string): The collection to subscribe the user to."),
     objectId: z6.string().describe("(string): The ID of the object to subscribe the user to."),
     userIds: z6.array(z6.string()).describe(
@@ -450,7 +466,7 @@ var subscribeUsersToObject = KnockTool({
     )
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.objects.addSubscriptions(
       params.collection,
       params.objectId,
@@ -467,6 +483,9 @@ var unsubscribeUsersFromObject = KnockTool({
   
   Use this tool when you need to unsubscribe one or more users from an object where you will then trigger workflows for those lists of users to send notifications to.`,
   parameters: z6.object({
+    environment: z6.string().optional().describe(
+      "(string): The environment to unsubscribe the user from. Defaults to `development`."
+    ),
     collection: z6.string().describe("(string): The collection to unsubscribe the user from."),
     objectId: z6.string().describe("(string): The ID of the object to unsubscribe the user from."),
     userIds: z6.array(z6.string()).describe(
@@ -474,7 +493,7 @@ var unsubscribeUsersFromObject = KnockTool({
     )
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.objects.deleteSubscriptions(
       params.collection,
       params.objectId,
@@ -488,7 +507,6 @@ var objects = {
   listObjects,
   getObject,
   createOrUpdateObject,
-  deleteObject,
   subscribeUsersToObject,
   unsubscribeUsersFromObject
 };
@@ -496,7 +514,6 @@ var permissions7 = {
   read: ["listObjects", "getObject"],
   manage: [
     "createOrUpdateObject",
-    "deleteObject",
     "subscribeUsersToObject",
     "unsubscribeUsersFromObject"
   ]
@@ -504,14 +521,22 @@ var permissions7 = {
 
 // src/lib/tools/partials.ts
 import { z as z7 } from "zod";
+function serializePartial(partial) {
+  return {
+    key: partial.key,
+    type: partial.type,
+    name: partial.name,
+    description: partial.description
+  };
+}
 var listPartials = KnockTool({
   method: "list_partials",
   name: "List partials",
-  description: `List all partials within the environment given. Partials provide common building blocks for notification templates. Returns information about the partial, including the name and the key.
-    
-    Use this tool when you need to know the available partials for the environment, like when building a notification template and wanting to use a partial to build the template.`,
+  description: `
+  List all partials within the environment given. Partials provide common building blocks for notification templates. Returns information about the partial, including the name and the key.  
+  Use this tool when you need to know the available partials for the environment, like when building a notification template and wanting to use a partial to build the template.`,
   parameters: z7.object({
-    environment: z7.string().describe(
+    environment: z7.string().optional().describe(
       "(string): The environment to list partials for. Defaults to `development`."
     )
   }),
@@ -520,7 +545,7 @@ var listPartials = KnockTool({
     for await (const partial of knockClient.partials.list({
       environment: params.environment ?? config.environment ?? "development"
     })) {
-      allPartials.push(partial);
+      allPartials.push(serializePartial(partial));
     }
     return allPartials;
   }
@@ -543,13 +568,34 @@ var getTenant = KnockTool({
   Use this tool when you need to lookup the information about a tenant, including name, and if there are any custom properties set.
   `,
   parameters: z8.object({
+    environment: z8.string().optional().describe(
+      "(string): The environment to retrieve the tenant from. Defaults to `development`."
+    ),
     tenantId: z8.string().describe("(string): The ID of the tenant to retrieve.")
   }),
   execute: (knockClient) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.tenants.get(params.tenantId);
   }
 });
+var listTenants = KnockTool({
+  method: "list_tenants",
+  name: "List tenants",
+  description: `
+  Retrieves a list of tenants. Tenants in Knock are used to model organizations, teams, and other groups of users. They are a special type of object. 
+  
+  Use this tool when you need to list all tenants in an environment.
+  `,
+  parameters: z8.object({
+    environment: z8.string().optional().describe(
+      "(string): The environment to retrieve the tenants from. Defaults to `development`."
+    )
+  }),
+  execute: (knockClient) => async (params) => {
+    const publicClient = await knockClient.publicApi(params.environment);
+    return await publicClient.tenants.list();
+  }
+});
 var setTenant = KnockTool({
   method: "set_tenant",
   name: "Set tenant",
@@ -559,47 +605,105 @@ var setTenant = KnockTool({
   Use this tool when you need to create a new tenant, or update an existing tenant's properties.
   `,
   parameters: z8.object({
+    environment: z8.string().optional().describe(
+      "(string): The environment to set the tenant in. Defaults to `development`."
+    ),
     tenantId: z8.string().describe("(string): The ID of the tenant to update."),
-    name: z8.string().describe("(string): The name of the tenant."),
-    properties: z8.record(z8.string(), z8.any()).describe("(object): The properties to set on the tenant.")
+    name: z8.string().optional().describe("(string): The name of the tenant."),
+    properties: z8.record(z8.string(), z8.any()).optional().describe("(object): The properties to set on the tenant.")
   }),
   execute: (knockClient) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.tenants.set(params.tenantId, {
       name: params.name,
       ...params.properties
     });
   }
 });
-var deleteTenant = KnockTool({
-  method: "delete_tenant",
-  name: "Delete tenant",
-  description: `
-  Deletes a tenant. Tenants in Knock are used to model organizations, teams, and other groups of users. They are a special type of object.
-  
-  Use this tool when you've been asked to remove a tenant from the system.
-  `,
-  parameters: z8.object({
-    tenantId: z8.string().describe("(string): The ID of the tenant to delete.")
-  }),
-  execute: (knockClient) => async (params) => {
-    const publicClient = await knockClient.publicApi();
-    await publicClient.tenants.delete(params.tenantId);
-    return { success: true };
-  }
-});
 var tenants = {
   getTenant,
-  setTenant,
-  deleteTenant
+  listTenants,
+  setTenant
 };
 var permissions9 = {
-  read: ["getTenant"],
-  manage: ["setTenant", "deleteTenant"]
+  read: ["getTenant", "listTenants"],
+  manage: ["setTenant"]
 };
 
 // src/lib/tools/users.ts
 import { z as z9 } from "zod";
+
+// src/lib/utils.ts
+function filterTools(tools2, pattern) {
+  if (!pattern) {
+    throw new Error("No pattern provided");
+  }
+  if (pattern === "*") {
+    return Object.values(tools2).flatMap((category2) => Object.values(category2));
+  }
+  const [category, tool] = pattern.split(".");
+  if (category === "*" && tool === "*") {
+    return Object.values(tools2).flatMap((category2) => Object.values(category2));
+  }
+  if (category && !tools2[category]) {
+    throw new Error(`Tool category ${category} not found`);
+  }
+  if (category && tool === "*") {
+    return Object.values(tools2[category]);
+  }
+  if (category && tool && !tools2[category][tool]) {
+    throw new Error(`Tool ${pattern} not found`);
+  }
+  return [tools2[category][tool]];
+}
+function getToolsWithPermissions(category, categoryPermissions) {
+  const toolsInCategory = tools[category];
+  const toolPermissionsInCategory = toolPermissions[category];
+  return Object.entries(categoryPermissions).reduce(
+    (acc, [permissionType, hasPermission]) => {
+      if (hasPermission) {
+        return acc.concat(
+          toolPermissionsInCategory[permissionType].map(
+            (toolName) => toolsInCategory[toolName]
+          )
+        );
+      }
+      return acc;
+    },
+    []
+  );
+}
+function getToolsByPermissionsInCategories(config) {
+  return Object.keys(config.permissions).reduce(
+    (acc, category) => {
+      const categoryKey = category;
+      const categoryPermissions = config.permissions[categoryKey];
+      if (tools[categoryKey] && categoryPermissions) {
+        const tools2 = getToolsWithPermissions(categoryKey, categoryPermissions);
+        return { ...acc, [categoryKey]: tools2 };
+      }
+      return acc;
+    },
+    {}
+  );
+}
+function serializeMessageResponse(message) {
+  return {
+    id: message.id,
+    status: message.status,
+    engagement_statuses: message.engagement_statuses,
+    data: message.data,
+    metadata: message.metadata
+  };
+}
+
+// src/lib/tools/users.ts
+function maybeHideUserData(user, hideUserData = false) {
+  if (hideUserData) {
+    return { id: user.id };
+  }
+  return user;
+}
 var getUser = KnockTool({
   method: "get_user",
   name: "Get user",
@@ -609,11 +713,15 @@ var getUser = KnockTool({
    If the userId is not provided, it will use the userId from the config.
    `,
   parameters: z9.object({
-    userId: z9.string().describe("(string): The userId of the User to retrieve.")
+    environment: z9.string().optional().describe(
+      "(string): The environment to retrieve the user from. Defaults to `development`."
+    ),
+    userId: z9.string().optional().describe("(string): The userId of the User to retrieve.")
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
-    return await publicClient.users.get(params.userId ?? config.userId);
+    const publicClient = await knockClient.publicApi(params.environment);
+    const user = await publicClient.users.get(params.userId ?? config.userId);
+    return maybeHideUserData(user, config.hideUserData);
   }
 });
 var createOrUpdateUser = KnockTool({
@@ -627,37 +735,29 @@ var createOrUpdateUser = KnockTool({
   If the userId is not provided, it will use the userId from the config.
   `,
   parameters: z9.object({
-    userId: z9.string().describe("(string): The userId of the User to update."),
-    email: z9.string().describe("(string): The email of the User to update."),
-    name: z9.string().describe("(string): The name of the User to update."),
-    phoneNumber: z9.string().describe("(string): The phone number of the User to update."),
-    customProperties: z9.record(z9.string(), z9.any()).describe(
+    environment: z9.string().optional().describe(
+      "(string): The environment to create or update the user in. Defaults to `development`."
+    ),
+    userId: z9.string().optional().describe("(string): The userId of the User to update."),
+    email: z9.string().optional().describe("(string): The email of the User to update."),
+    name: z9.string().optional().describe("(string): The name of the User to update."),
+    phoneNumber: z9.string().optional().describe("(string): The phone number of the User to update."),
+    customProperties: z9.record(z9.string(), z9.any()).optional().describe(
       "(object): A dictionary of custom properties to update for the User."
     )
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
-    return await publicClient.users.identify(params.userId, {
-      email: params.email,
-      name: params.name,
-      phone_number: params.phoneNumber,
-      ...params.customProperties ?? {}
-    });
-  }
-});
-var deleteUser = KnockTool({
-  method: "delete_user",
-  name: "Delete user",
-  description: `
-  Deletes a user. Use this tool when you've been asked to remove a user from the system.
-  `,
-  parameters: z9.object({
-    userId: z9.string().describe("(string): The userId of the User to delete.")
-  }),
-  execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
-    await publicClient.users.delete(params.userId);
-    return { success: true };
+    const publicClient = await knockClient.publicApi(params.environment);
+    const user = await publicClient.users.identify(
+      params.userId ?? config.userId,
+      {
+        email: params.email,
+        name: params.name,
+        phone_number: params.phoneNumber,
+        ...params.customProperties ?? {}
+      }
+    );
+    return maybeHideUserData(user, config.hideUserData);
   }
 });
 var getUserPreferences = KnockTool({
@@ -669,15 +769,18 @@ var getUserPreferences = KnockTool({
   If the userId is not provided, it will use the userId from the config. 
   `,
   parameters: z9.object({
-    userId: z9.string().describe(
+    environment: z9.string().optional().describe(
+      "(string): The environment to retrieve the user preferences from. Defaults to `development`."
+    ),
+    userId: z9.string().optional().describe(
       "(string): The userId of the User to retrieve Preferences for."
     ),
-    preferenceSetId: z9.string().describe(
+    preferenceSetId: z9.string().optional().describe(
       "(string): The preferenceSetId of the User to retrieve preferences for. Defaults to `default`."
     )
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.users.getPreferences(
       params.userId ?? config.userId,
       {
@@ -722,19 +825,22 @@ var setUserPreferences = KnockTool({
   </examples>
   `,
   parameters: z9.object({
-    userId: z9.string().describe("(string): The userId of the User to update preferences for."),
-    workflows: z9.record(z9.string(), z9.any()).describe(
+    environment: z9.string().optional().describe(
+      "(string): The environment to set the user preferences in. Defaults to `development`."
+    ),
+    userId: z9.string().optional().describe("(string): The userId of the User to update preferences for."),
+    workflows: z9.record(z9.string(), z9.any()).optional().describe(
       "(object): The workflows to update where the key is the workflow key, and the value of the object is an object that contains a `channel_types` key with a boolean value for each channel type."
     ),
-    categories: z9.record(z9.string(), z9.any()).describe(
+    categories: z9.record(z9.string(), z9.any()).optional().describe(
       "(object): The categories to update where the key is the category key, and the value of the object is an object that contains a `channel_types` key with a boolean value for each channel type."
     ),
-    channel_types: z9.record(z9.string(), z9.boolean()).describe(
+    channel_types: z9.record(z9.string(), z9.boolean()).optional().describe(
       "(object): The channel types to update where the key is the channel type, and the value of the object is a boolean value."
     )
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     const existingPreferences = await publicClient.users.getPreferences(
       params.userId ?? config.userId,
       {
@@ -771,46 +877,58 @@ var getUserMessages = KnockTool({
   If the userId is not provided, it will use the userId from the config.
   `,
   parameters: z9.object({
-    userId: z9.string().describe("(string): The userId of the User to retrieve messages for."),
-    workflowRunId: z9.string().describe(
+    environment: z9.string().optional().describe(
+      "(string): The environment to retrieve the user messages from. Defaults to `development`."
+    ),
+    userId: z9.string().optional().describe("(string): The userId of the User to retrieve messages for."),
+    workflowRunId: z9.string().optional().describe(
       "(string): The workflowRunId of the User to retrieve. Use this when you want to retrieve messages sent from a workflow trigger."
     )
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
-    return await publicClient.users.getMessages(
+    const publicClient = await knockClient.publicApi(params.environment);
+    const messages2 = await publicClient.users.getMessages(
       params.userId ?? config.userId,
       {
         workflow_run_id: params.workflowRunId
       }
     );
+    return messages2.items.map(serializeMessageResponse);
   }
 });
 var users = {
   getUser,
-  deleteUser,
   createOrUpdateUser,
   getUserPreferences,
   setUserPreferences,
   getUserMessages
 };
 var permissions10 = {
-  read: ["getUser", "getUserPreferences", "getUserMessages"],
-  manage: ["createOrUpdateUser", "deleteUser", "setUserPreferences"]
+  read: ["getUser", "getUserMessages", "getUserPreferences"],
+  manage: ["createOrUpdateUser", "setUserPreferences"]
 };
 
 // src/lib/tools/workflows.ts
 import { z as z10 } from "zod";
+function serializeWorkflowResponse(workflow) {
+  return {
+    key: workflow.key,
+    name: workflow.name,
+    description: workflow.description,
+    categories: workflow.categories,
+    schema: workflow.trigger_data_json_schema
+  };
+}
 var listWorkflows = KnockTool({
   method: "list_workflows",
   name: "List workflows",
   description: `
-  List all workflows available for the given environment. Returns structural information about the workflows, including the key, name, description, and categories. Will also return the steps that make up the workflow. 
+  List all workflows available for the given environment. Returns structural information about the workflows, including the key, name, description, and categories.
 
-  Use this tool when you need to understand which workflows are available to be called. 
+  Use this tool when you need to understand which workflows are available to be called.
   `,
   parameters: z10.object({
-    environment: z10.string().describe(
+    environment: z10.string().optional().describe(
       "(string): The environment to list workflows for. Defaults to `development`."
     )
   }),
@@ -820,35 +938,61 @@ var listWorkflows = KnockTool({
       environment: params.environment ?? config.environment ?? "development"
     };
     for await (const workflow of knockClient.workflows.list(listParams)) {
-      allWorkflows.push(workflow);
+      allWorkflows.push(serializeWorkflowResponse(workflow));
     }
     return allWorkflows;
   }
 });
+var getWorkflow = KnockTool({
+  method: "get_workflow",
+  name: "Get workflow",
+  description: `
+  Get a workflow by key. Returns structural information about the workflow, including the key, name, description, and categories.
+  `,
+  parameters: z10.object({
+    environment: z10.string().optional().describe(
+      "(string): The environment to get the workflow for. Defaults to `development`."
+    ),
+    workflowKey: z10.string().describe("(string): The key of the workflow to get.")
+  }),
+  execute: (knockClient, config) => async (params) => {
+    const workflow = await knockClient.workflows.retrieve(params.workflowKey, {
+      environment: params.environment ?? config.environment ?? "development"
+    });
+    return serializeWorkflowResponse(workflow);
+  }
+});
 var triggerWorkflow = KnockTool({
   method: "trigger_workflow",
   name: "Trigger workflow",
   description: `
-  Trigger a workflow for one or more recipients.
+  Trigger a workflow for one or more recipients, which may produce one or more messages for each recipient depending on the workflow's steps.
 
   Use this tool when you need to trigger a workflow to send a notification across the channels configured for the workflow. The workflow must be committed in the environment for you to trigger it.
 
   When recipients aren't provided, the workflow will be triggered for the current user specified in the config.
+
+  Returns the workflow run ID, which can be used to lookup messages produced by the workflow.
   `,
   parameters: z10.object({
+    environment: z10.string().optional().describe(
+      "(string): The environment to trigger the workflow in. Defaults to `development`."
+    ),
     workflowKey: z10.string().describe("(string): The key of the workflow to trigger."),
-    recipients: z10.array(z10.string()).describe("(array): The recipients to trigger the workflow for."),
-    data: z10.record(z10.string(), z10.any()).describe("(object): Data to pass to the workflow."),
-    tenant: z10.record(z10.string(), z10.any()).describe(
+    recipients: z10.array(z10.string()).optional().describe(
+      "(array): The recipients to trigger the workflow for. This is an array of user IDs."
+    ),
+    data: z10.record(z10.string(), z10.any()).optional().describe("(object): Data to pass to the workflow."),
+    tenant: z10.record(z10.string(), z10.any()).optional().describe(
       "(object): The tenant to trigger the workflow for. Must contain an id if being sent."
     )
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     const result = await publicClient.workflows.trigger(params.workflowKey, {
-      recipients: params.recipients,
+      recipients: params.recipients ?? [config.userId] ?? [],
       data: params.data,
-      tenant: params.tenant
+      tenant: params.tenant ?? config.tenantId
     });
     return result.workflow_run_id;
   }
@@ -878,12 +1022,12 @@ var createEmailWorkflow = KnockTool({
   Once you've created the workflow, you should ask if you should commit the changes to the environment.
   `,
   parameters: z10.object({
-    environment: z10.string().describe(
+    environment: z10.string().optional().describe(
       "(string): The environment to create the workflow in. Defaults to `development`."
     ),
     workflowKey: z10.string().describe("(string): The key of the workflow."),
     name: z10.string().describe("(string): The name of the workflow."),
-    categories: z10.array(z10.string()).describe("(array): The categories to add to the workflow."),
+    categories: z10.array(z10.string()).optional().describe("(array): The categories to add to the workflow."),
     subject: z10.string().describe("(string): The subject of the email."),
     body: z10.string().describe("(string): The body of the email.")
   }),
@@ -923,10 +1067,11 @@ var createEmailWorkflow = KnockTool({
         ]
       }
     };
-    return await knockClient.workflows.upsert(
+    const result = await knockClient.workflows.upsert(
       params.workflowKey,
       workflowParams
     );
+    return serializeWorkflowResponse(result.workflow);
   }
 });
 var createOneOffWorkflowSchedule = KnockTool({
@@ -944,6 +1089,9 @@ var createOneOffWorkflowSchedule = KnockTool({
   - In two weeks, send a survey to a user
   `,
   parameters: z10.object({
+    environment: z10.string().optional().describe(
+      "(string): The environment to create the workflow in. Defaults to `development`."
+    ),
     workflowKey: z10.string().describe("(string): The key of the workflow to schedule."),
     userId: z10.string().describe(
       "(string): The userId of the user to schedule the workflow for."
@@ -951,10 +1099,10 @@ var createOneOffWorkflowSchedule = KnockTool({
     scheduledAt: z10.string().describe(
       "(string): The date and time to schedule the workflow for. Must be in ISO 8601 format."
     ),
-    data: z10.record(z10.string(), z10.any()).describe("(object): Data to pass to the workflow.")
+    data: z10.record(z10.string(), z10.any()).optional().describe("(object): Data to pass to the workflow.")
   }),
   execute: (knockClient, config) => async (params) => {
-    const publicClient = await knockClient.publicApi();
+    const publicClient = await knockClient.publicApi(params.environment);
     return await publicClient.workflows.createSchedules(params.workflowKey, {
       recipients: [params.userId ?? config.userId],
       scheduled_at: params.scheduledAt,
@@ -964,20 +1112,50 @@ var createOneOffWorkflowSchedule = KnockTool({
 });
 var workflows = {
   listWorkflows,
+  getWorkflow,
   triggerWorkflow,
   createEmailWorkflow,
   createOneOffWorkflowSchedule
 };
 var permissions11 = {
-  read: ["listWorkflows"],
+  read: ["listWorkflows", "getWorkflow"],
   manage: ["createEmailWorkflow", "createOneOffWorkflowSchedule"],
-  trigger: ["triggerWorkflow"]
+  run: ["triggerWorkflow"]
+};
+
+// src/lib/tools/documentation.ts
+import { z as z11 } from "zod";
+var searchDocumentation = KnockTool({
+  method: "search_documentation",
+  name: "Search documentation",
+  description: "Search the Knock documentation for a given query",
+  parameters: z11.object({
+    query: z11.string().describe("The query to search the documentation for")
+  }),
+  execute: () => async (params) => {
+    const response = await fetch(`https://docs.knock.app/api/search`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ query: params.query })
+    });
+    const data = await response.json();
+    return data;
+  }
+});
+var documentation = {
+  searchDocumentation
+};
+var permissions12 = {
+  read: ["searchDocumentation"]
 };
 
 // src/lib/tools/index.ts
 var tools = {
   channels,
   commits,
+  documentation,
   emailLayouts,
   environments,
   messages,
@@ -991,6 +1169,7 @@ var tools = {
 var allTools = {
   ...channels,
   ...commits,
+  ...documentation,
   ...emailLayouts,
   ...environments,
   ...messageTypes,
@@ -1004,6 +1183,7 @@ var allTools = {
 var toolPermissions = {
   channels: permissions,
   commits: permissions2,
+  documentation: permissions12,
   emailLayouts: permissions3,
   environments: permissions4,
   messages: permissions5,
@@ -1018,6 +1198,7 @@ var toolPermissions = {
 export {
   tools,
   allTools,
-  toolPermissions
+  filterTools,
+  getToolsByPermissionsInCategories
 };
-//# sourceMappingURL=chunk-RPKDXX4O.js.map
+//# sourceMappingURL=chunk-3CUTEODM.js.map