@knocklabs/agent-toolkit 0.1.2 → 0.1.3

package/dist/chunk-TOBLV65T.js

@@ -0,0 +1,30 @@
+// src/lib/knock-tool.ts
+import { z } from "zod";
+var trimLines = (text) => text.split("\n").map((l) => l.trim()).filter(Boolean).join("\n");
+var KnockTool = (args) => {
+  const { execute, ...restOfArgs } = args;
+  const parameters = restOfArgs.parameters ? restOfArgs.parameters : z.object({});
+  const schemaEntries = Object.entries(parameters.shape);
+  const argsStr = schemaEntries.length === 0 ? "Takes no arguments" : schemaEntries.map(([key, value]) => {
+    return `- ${key}: ${value.description || ""}`;
+  }).join("\n");
+  const fullDescription = trimLines(`
+  Tool name:
+  ${args.name}
+  Description:
+  ${args.description}.
+  Arguments:
+  ${argsStr}
+  `);
+  return {
+    ...restOfArgs,
+    parameters,
+    fullDescription,
+    bindExecute: (knockClient, config) => execute(knockClient, config)
+  };
+};
+
+export {
+  KnockTool
+};
+//# sourceMappingURL=chunk-TOBLV65T.js.map

package/dist/chunk-TOBLV65T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/knock-tool.ts"],"sourcesContent":["import type { ZodObject } from \"zod\";\nimport { z } from \"zod\";\nimport { Config } from \"../types.js\";\nimport { KnockClient } from \"./knock-client.js\";\n\nexport interface KnockToolDefinition {\n  /**\n   * The method name of the tool. This is a machine-readable string.\n   */\n  method: string;\n  /**\n   * The name of the tool. This can be used to reference the tool in the code.\n   * A descriptive LLM-readable string.\n   */\n  name: string;\n\n  /**\n   * A descriptive prompt explaining the tool's purpose, including examples where useful.\n   */\n  description: string;\n\n  /**\n   * A descriptive prompt explaining the tool's purpose, usage and input parameters.\n   * Ths is intended to be used by the underlying LLM.\n   */\n  fullDescription: string;\n\n  /**\n   * The Zod schema for the input parameters of the tool\n   */\n  parameters?: ZodObject<any>;\n  /**\n   * The actual implementation of the tool.\n   */\n  execute: (\n    knockClient: KnockClient,\n    config: Config\n  ) => (input: any) => Promise<unknown>;\n}\n\nexport interface KnockTool extends Omit<KnockToolDefinition, \"execute\"> {\n  bindExecute: (\n    knockClient: KnockClient,\n    config: Config\n  ) => (input: any) => Promise<unknown>;\n}\n\nconst trimLines = (text: string) =>\n  text\n    .split(\"\\n\")\n    .map((l) => l.trim())\n    .filter(Boolean)\n    .join(\"\\n\");\n\nexport const KnockTool = (\n  args: Omit<KnockToolDefinition, \"fullDescription\">\n): KnockTool => {\n  const { execute, ...restOfArgs } = args;\n  const parameters = restOfArgs.parameters\n    ? restOfArgs.parameters\n    : z.object({});\n\n  const schemaEntries = Object.entries(parameters.shape);\n\n  const argsStr =\n    schemaEntries.length === 0\n      ? \"Takes no arguments\"\n      : schemaEntries\n          .map(([key, value]) => {\n            return `- ${key}: ${(value as any).description || \"\"}`;\n          })\n          .join(\"\\n\");\n\n  const fullDescription = trimLines(`\n  Tool name:\n  ${args.name}\n  Description:\n  ${args.description}.\n  Arguments:\n  ${argsStr}\n  `);\n\n  return {\n    ...restOfArgs,\n    parameters,\n    fullDescription,\n    bindExecute: (knockClient: KnockClient, config: Config) =>\n      execute(knockClient, config),\n  };\n};\n"],"mappings":";AACA,SAAS,SAAS;AA8ClB,IAAM,YAAY,CAAC,SACjB,KACG,MAAM,IAAI,EACV,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO,EACd,KAAK,IAAI;AAEP,IAAM,YAAY,CACvB,SACc;AACd,QAAM,EAAE,SAAS,GAAG,WAAW,IAAI;AACnC,QAAM,aAAa,WAAW,aAC1B,WAAW,aACX,EAAE,OAAO,CAAC,CAAC;AAEf,QAAM,gBAAgB,OAAO,QAAQ,WAAW,KAAK;AAErD,QAAM,UACJ,cAAc,WAAW,IACrB,uBACA,cACG,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AACrB,WAAO,KAAK,GAAG,KAAM,MAAc,eAAe,EAAE;AAAA,EACtD,CAAC,EACA,KAAK,IAAI;AAElB,QAAM,kBAAkB,UAAU;AAAA;AAAA,IAEhC,KAAK,IAAI;AAAA;AAAA,IAET,KAAK,WAAW;AAAA;AAAA,IAEhB,OAAO;AAAA,GACR;AAED,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA,aAAa,CAAC,aAA0B,WACtC,QAAQ,aAAa,MAAM;AAAA,EAC/B;AACF;","names":[]}

package/dist/chunk-VJFA3ZVW.js

@@ -0,0 +1,210 @@
+import {
+  KnockTool
+} from "./chunk-TOBLV65T.js";
+
+// src/lib/tools/users.ts
+import { z } from "zod";
+var getUser = KnockTool({
+  method: "get_user",
+  name: "Get user",
+  description: `
+   Retrieves the complete user object for the given userId, including email, name, phone number, and any custom properties. Use this tool when you need to retrieve a user's complete profile.
+
+   If the userId is not provided, it will use the userId from the config.
+   `,
+  parameters: z.object({
+    userId: z.string().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);
+  }
+});
+var createOrUpdateUser = KnockTool({
+  method: "create_or_update_user",
+  name: "Create or update user",
+  description: `
+  Creates a new user if they don't exist, or updates the user object for the given userId, including email, name, phone number, and any custom properties.
+  
+  Use this tool when you need to update a user's profile.
+
+  If the userId is not provided, it will use the userId from the config.
+  `,
+  parameters: z.object({
+    userId: z.string().describe("(string): The userId of the User to update."),
+    email: z.string().describe("(string): The email of the User to update."),
+    name: z.string().describe("(string): The name of the User to update."),
+    phoneNumber: z.string().describe("(string): The phone number of the User to update."),
+    customProperties: z.record(z.string(), z.any()).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: z.object({
+    userId: z.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 };
+  }
+});
+var getUserPreferences = KnockTool({
+  method: "get_user_preferences",
+  name: "Get user preferences",
+  description: `
+  Retrieves the user's notification preferences for the given userId.
+
+  If the userId is not provided, it will use the userId from the config. 
+  `,
+  parameters: z.object({
+    userId: z.string().describe(
+      "(string): The userId of the User to retrieve Preferences for."
+    ),
+    preferenceSetId: z.string().describe(
+      "(string): The preferenceSetId of the User to retrieve preferences for. Defaults to `default`."
+    )
+  }),
+  execute: (knockClient, config) => async (params) => {
+    const publicClient = await knockClient.publicApi();
+    return await publicClient.users.getPreferences(
+      params.userId ?? config.userId,
+      {
+        preferenceSet: params.preferenceSetId ?? "default"
+      }
+    );
+  }
+});
+var setUserPreferences = KnockTool({
+  method: "set_user_preferences",
+  name: "Set user preferences",
+  description: `
+  Overwrites the user's notification preferences for the given userId. Allows setting per-workflow, per-category, or per-channel notification preferences. Use this tool when you are asked to update a user's notification preferences.
+
+  If the userId is not provided, it will use the userId from the config.
+
+  Instructions:
+
+  - You must ALWAYS provide a full preference set to this tool.
+  - When setting per-workflow preferences, the key in the object should be the workflow key.
+  - Workflow and category preferences should always have channel types underneath.
+  - The channel types available to you are: email, sms, push, chat, and in_app_feed.
+  - To turn OFF a preference, you must set it to false.
+  - To turn ON a preference, you must set it to true.
+
+  <examples>
+    <example>
+      <description>
+        Update the user's preferences to turn off email notifications for the "welcome" workflow.
+      </description>
+      <input>
+        {
+          "workflows": {
+            "welcome": {
+              "channel_types": {
+                "email": false
+              }
+            }
+          }
+        }
+    </example>
+  </examples>
+  `,
+  parameters: z.object({
+    userId: z.string().describe("(string): The userId of the User to update preferences for."),
+    workflows: z.record(z.string(), z.any()).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: z.record(z.string(), z.any()).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: z.record(z.string(), z.boolean()).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 existingPreferences = await publicClient.users.getPreferences(
+      params.userId ?? config.userId,
+      {
+        preferenceSet: "default"
+      }
+    );
+    const updatedPreferences = {
+      ...existingPreferences,
+      workflows: {
+        ...existingPreferences.workflows,
+        ...params.workflows
+      },
+      categories: {
+        ...existingPreferences.categories,
+        ...params.categories
+      },
+      channel_types: {
+        ...existingPreferences.channel_types,
+        ...params.channel_types
+      }
+    };
+    return await publicClient.users.setPreferences(
+      params.userId ?? config.userId,
+      updatedPreferences
+    );
+  }
+});
+var getUserMessages = KnockTool({
+  method: "get_user_messages",
+  name: "Get user messages",
+  description: `
+  Retrieves the messages that this user has received from the service. Use this tool when you need information about the notifications that the user has received, including if the message has been read, seen, or interacted with. This will return a list of messages across all of the channels.
+
+  If the userId is not provided, it will use the userId from the config.
+  `,
+  parameters: z.object({
+    userId: z.string().describe("(string): The userId of the User to retrieve messages for."),
+    workflowRunId: z.string().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(
+      params.userId ?? config.userId,
+      {
+        workflow_run_id: params.workflowRunId
+      }
+    );
+  }
+});
+var users = {
+  getUser,
+  deleteUser,
+  createOrUpdateUser,
+  getUserPreferences,
+  setUserPreferences,
+  getUserMessages
+};
+var permissions = {
+  read: ["getUser", "getUserPreferences", "getUserMessages"],
+  manage: ["createOrUpdateUser", "deleteUser", "setUserPreferences"]
+};
+
+export {
+  users,
+  permissions
+};
+//# sourceMappingURL=chunk-VJFA3ZVW.js.map

package/dist/chunk-VJFA3ZVW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/tools/users.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { KnockTool } from \"../knock-tool.js\";\n\nconst getUser = KnockTool({\n  method: \"get_user\",\n  name: \"Get user\",\n  description: `\n   Retrieves the complete user object for the given userId, including email, name, phone number, and any custom properties. Use this tool when you need to retrieve a user's complete profile.\n\n   If the userId is not provided, it will use the userId from the config.\n   `,\n  parameters: z.object({\n    userId: z\n      .string()\n      .describe(\"(string): The userId of the User to retrieve.\"),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n\n    return await publicClient.users.get(params.userId ?? config.userId);\n  },\n});\n\nconst createOrUpdateUser = KnockTool({\n  method: \"create_or_update_user\",\n  name: \"Create or update user\",\n  description: `\n  Creates a new user if they don't exist, or updates the user object for the given userId, including email, name, phone number, and any custom properties.\n  \n  Use this tool when you need to update a user's profile.\n\n  If the userId is not provided, it will use the userId from the config.\n  `,\n  parameters: z.object({\n    userId: z.string().describe(\"(string): The userId of the User to update.\"),\n    email: z.string().describe(\"(string): The email of the User to update.\"),\n    name: z.string().describe(\"(string): The name of the User to update.\"),\n    phoneNumber: z\n      .string()\n      .describe(\"(string): The phone number of the User to update.\"),\n    customProperties: z\n      .record(z.string(), z.any())\n      .describe(\n        \"(object): A dictionary of custom properties to update for the User.\"\n      ),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n\n    return await publicClient.users.identify(params.userId, {\n      email: params.email,\n      name: params.name,\n      phone_number: params.phoneNumber,\n      ...(params.customProperties ?? {}),\n    });\n  },\n});\n\nconst deleteUser = KnockTool({\n  method: \"delete_user\",\n  name: \"Delete user\",\n  description: `\n  Deletes a user. Use this tool when you've been asked to remove a user from the system.\n  `,\n  parameters: z.object({\n    userId: z.string().describe(\"(string): The userId of the User to delete.\"),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n    await publicClient.users.delete(params.userId);\n    return { success: true };\n  },\n});\n\nconst getUserPreferences = KnockTool({\n  method: \"get_user_preferences\",\n  name: \"Get user preferences\",\n  description: `\n  Retrieves the user's notification preferences for the given userId.\n\n  If the userId is not provided, it will use the userId from the config. \n  `,\n  parameters: z.object({\n    userId: z\n      .string()\n      .describe(\n        \"(string): The userId of the User to retrieve Preferences for.\"\n      ),\n    preferenceSetId: z\n      .string()\n      .describe(\n        \"(string): The preferenceSetId of the User to retrieve preferences for. Defaults to `default`.\"\n      ),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n\n    return await publicClient.users.getPreferences(\n      params.userId ?? config.userId,\n      {\n        preferenceSet: params.preferenceSetId ?? \"default\",\n      }\n    );\n  },\n});\n\nconst setUserPreferences = KnockTool({\n  method: \"set_user_preferences\",\n  name: \"Set user preferences\",\n  description: `\n  Overwrites the user's notification preferences for the given userId. Allows setting per-workflow, per-category, or per-channel notification preferences. Use this tool when you are asked to update a user's notification preferences.\n\n  If the userId is not provided, it will use the userId from the config.\n\n  Instructions:\n\n  - You must ALWAYS provide a full preference set to this tool.\n  - When setting per-workflow preferences, the key in the object should be the workflow key.\n  - Workflow and category preferences should always have channel types underneath.\n  - The channel types available to you are: email, sms, push, chat, and in_app_feed.\n  - To turn OFF a preference, you must set it to false.\n  - To turn ON a preference, you must set it to true.\n\n  <examples>\n    <example>\n      <description>\n        Update the user's preferences to turn off email notifications for the \"welcome\" workflow.\n      </description>\n      <input>\n        {\n          \"workflows\": {\n            \"welcome\": {\n              \"channel_types\": {\n                \"email\": false\n              }\n            }\n          }\n        }\n    </example>\n  </examples>\n  `,\n  parameters: z.object({\n    userId: z\n      .string()\n      .describe(\"(string): The userId of the User to update preferences for.\"),\n    workflows: z\n      .record(z.string(), z.any())\n      .describe(\n        \"(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.\"\n      ),\n    categories: z\n      .record(z.string(), z.any())\n      .describe(\n        \"(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.\"\n      ),\n    channel_types: z\n      .record(z.string(), z.boolean())\n      .describe(\n        \"(object): The channel types to update where the key is the channel type, and the value of the object is a boolean value.\"\n      ),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n\n    const existingPreferences = await publicClient.users.getPreferences(\n      params.userId ?? config.userId,\n      {\n        preferenceSet: \"default\",\n      }\n    );\n\n    const updatedPreferences = {\n      ...existingPreferences,\n      workflows: {\n        ...existingPreferences.workflows,\n        ...params.workflows,\n      },\n      categories: {\n        ...existingPreferences.categories,\n        ...params.categories,\n      },\n      channel_types: {\n        ...existingPreferences.channel_types,\n        ...params.channel_types,\n      },\n    };\n\n    return await publicClient.users.setPreferences(\n      params.userId ?? config.userId,\n      updatedPreferences\n    );\n  },\n});\n\nconst getUserMessages = KnockTool({\n  method: \"get_user_messages\",\n  name: \"Get user messages\",\n  description: `\n  Retrieves the messages that this user has received from the service. Use this tool when you need information about the notifications that the user has received, including if the message has been read, seen, or interacted with. This will return a list of messages across all of the channels.\n\n  If the userId is not provided, it will use the userId from the config.\n  `,\n  parameters: z.object({\n    userId: z\n      .string()\n      .describe(\"(string): The userId of the User to retrieve messages for.\"),\n    workflowRunId: z\n      .string()\n      .describe(\n        \"(string): The workflowRunId of the User to retrieve. Use this when you want to retrieve messages sent from a workflow trigger.\"\n      ),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n\n    return await publicClient.users.getMessages(\n      params.userId ?? config.userId,\n      {\n        workflow_run_id: params.workflowRunId,\n      }\n    );\n  },\n});\n\nexport const users = {\n  getUser,\n  deleteUser,\n  createOrUpdateUser,\n  getUserPreferences,\n  setUserPreferences,\n  getUserMessages,\n};\n\nexport const permissions = {\n  read: [\"getUser\", \"getUserPreferences\", \"getUserMessages\"],\n  manage: [\"createOrUpdateUser\", \"deleteUser\", \"setUserPreferences\"],\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-WB4XCCUS.js

@@ -0,0 +1,19 @@
+// src/openai/tool-converter.ts
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+function knockToolToChatCompletionTool(knockTool) {
+  return {
+    type: "function",
+    function: {
+      // NOTE: We use the method here as the function name as it's machine readable.
+      name: knockTool.method,
+      description: knockTool.description,
+      parameters: zodToJsonSchema(knockTool.parameters ?? z.object({}))
+    }
+  };
+}
+
+export {
+  knockToolToChatCompletionTool
+};
+//# sourceMappingURL=chunk-WB4XCCUS.js.map

package/dist/chunk-WB4XCCUS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/openai/tool-converter.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { KnockTool } from \"../lib/knock-tool.js\";\nimport { ChatCompletionTool } from \"openai/resources.mjs\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\n\n/**\n * Convert a KnockTool to a ChatCompletionTool, ready to be used with the OpenAI API.\n *\n * @param knockTool - The KnockTool to convert\n * @returns The converted ChatCompletionTool\n */\nexport function knockToolToChatCompletionTool(\n  knockTool: KnockTool\n): ChatCompletionTool {\n  return {\n    type: \"function\",\n    function: {\n      // NOTE: We use the method here as the function name as it's machine readable.\n      name: knockTool.method,\n      description: knockTool.description,\n      parameters: zodToJsonSchema(knockTool.parameters ?? z.object({})),\n    },\n  };\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAGlB,SAAS,uBAAuB;AAQzB,SAAS,8BACd,WACoB;AACpB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA;AAAA,MAER,MAAM,UAAU;AAAA,MAChB,aAAa,UAAU;AAAA,MACvB,YAAY,gBAAgB,UAAU,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;AAAA,IAClE;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-XRQWR3LY.js

@@ -0,0 +1,184 @@
+import {
+  KnockTool
+} from "./chunk-TOBLV65T.js";
+
+// src/lib/tools/workflows.ts
+import { z } from "zod";
+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. 
+
+  Use this tool when you need to understand which workflows are available to be called. 
+  `,
+  parameters: z.object({
+    environment: z.string().describe(
+      "(string): The environment to list workflows for. Defaults to `development`."
+    )
+  }),
+  execute: (knockClient, config) => async (params) => {
+    const allWorkflows = [];
+    const listParams = {
+      environment: params.environment ?? config.environment ?? "development"
+    };
+    for await (const workflow of knockClient.workflows.list(listParams)) {
+      allWorkflows.push(workflow);
+    }
+    return allWorkflows;
+  }
+});
+var triggerWorkflow = KnockTool({
+  method: "trigger_workflow",
+  name: "Trigger workflow",
+  description: `
+  Trigger a workflow for one or more recipients.
+
+  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.
+  `,
+  parameters: z.object({
+    workflowKey: z.string().describe("(string): The key of the workflow to trigger."),
+    recipients: z.array(z.string()).describe("(array): The recipients to trigger the workflow for."),
+    data: z.record(z.string(), z.any()).describe("(object): Data to pass to the workflow."),
+    tenant: z.record(z.string(), z.any()).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 result = await publicClient.workflows.trigger(params.workflowKey, {
+      recipients: params.recipients,
+      data: params.data,
+      tenant: params.tenant
+    });
+    return result.workflow_run_id;
+  }
+});
+var createEmailWorkflow = KnockTool({
+  method: "create_email_workflow",
+  name: "Create email workflow",
+  description: `
+  Creates a simple email workflow with a single step that sends an email to the recipient. Use this tool when you need to need to create an email notification, and you don't need to specify any additional steps. You can only create workflows in the development environment.
+
+  The content of the email you supply should ONLY ever be in markdown format for simplicity. You can supply dynamic variables to the subject and body of the email using the liquid template language.
+
+  When writing markdown, be sure to use headings (##) to separate sections of the email. Use an informal writing style, and avoid using complex language.
+
+  The following variables are available to use in the email subject and body:
+
+  - \`recipient.name\`: The name of the recipient.
+  - \`recipient.email\`: The email of the recipient.
+  - \`recipient.phone_number\`: The phone number of the recipient.
+  - \`tenant.id\`: The id of the tenant.
+  - \`tenant.name\`: The name of the tenant.
+
+  You can supply any other dynamic variables by referencing them under the \`data\` key in the \`data\` parameter when triggering the workflow. You add those like \`{{ data.variable_name }}\`.
+
+  You can also supply a list of categories to the workflow. These are used to categorize workflows for notification preferences. Categories should be supplied as lowercase strings in kebab case.
+
+  Once you've created the workflow, you should ask if you should commit the changes to the environment.
+  `,
+  parameters: z.object({
+    environment: z.string().describe(
+      "(string): The environment to create the workflow in. Defaults to `development`."
+    ),
+    workflowKey: z.string().describe("(string): The key of the workflow."),
+    name: z.string().describe("(string): The name of the workflow."),
+    categories: z.array(z.string()).describe("(array): The categories to add to the workflow."),
+    subject: z.string().describe("(string): The subject of the email."),
+    body: z.string().describe("(string): The body of the email.")
+  }),
+  execute: (knockClient, config) => async (params) => {
+    const emailChannelsPage = await knockClient.channels.list();
+    const emailChannels = emailChannelsPage.entries.filter(
+      (channel) => channel.type === "email"
+    );
+    if (emailChannels.length === 0) {
+      throw new Error("No email channels found");
+    }
+    const workflowParams = {
+      environment: params.environment ?? config.environment ?? "development",
+      workflow: {
+        name: params.name,
+        categories: params.categories ?? [],
+        steps: [
+          {
+            type: "channel",
+            channel_key: emailChannels[0].key,
+            template: {
+              settings: {
+                layout_key: "default"
+              },
+              subject: params.subject,
+              visual_blocks: [
+                // @ts-ignore
+                {
+                  type: "markdown",
+                  content: params.body
+                }
+              ]
+            },
+            name: "Email",
+            ref: "email_1"
+          }
+        ]
+      }
+    };
+    return await knockClient.workflows.upsert(
+      params.workflowKey,
+      workflowParams
+    );
+  }
+});
+var createOneOffWorkflowSchedule = KnockTool({
+  method: "create_one_off_workflow_schedule",
+  name: "Create one-off workflow schedule",
+  description: `
+  Create a one-off workflow schedule for a user. Use this tool when you need to schedule the execution of a workflow for a specific user in the future, like to power a delayed notification.
+  
+  Schedules can accept a set of data that will be passed to the workflow trigger when it is executed. When the userId is not provided, the schedule will be created for the current user specified in the config.
+
+  Examples:
+  
+  - In three days, send a welcome email to a user
+  - In one hour, send a password reset email to a user
+  - In two weeks, send a survey to a user
+  `,
+  parameters: z.object({
+    workflowKey: z.string().describe("(string): The key of the workflow to schedule."),
+    userId: z.string().describe(
+      "(string): The userId of the user to schedule the workflow for."
+    ),
+    scheduledAt: z.string().describe(
+      "(string): The date and time to schedule the workflow for. Must be in ISO 8601 format."
+    ),
+    data: z.record(z.string(), z.any()).describe("(object): Data to pass to the workflow.")
+  }),
+  execute: (knockClient, config) => async (params) => {
+    const publicClient = await knockClient.publicApi();
+    return await publicClient.workflows.createSchedules(params.workflowKey, {
+      recipients: [params.userId ?? config.userId],
+      scheduled_at: params.scheduledAt,
+      data: params.data
+    });
+  }
+});
+var workflows = {
+  listWorkflows,
+  triggerWorkflow,
+  createEmailWorkflow,
+  createOneOffWorkflowSchedule
+};
+var permissions = {
+  read: ["listWorkflows"],
+  manage: ["createEmailWorkflow", "createOneOffWorkflowSchedule"],
+  trigger: ["triggerWorkflow"]
+};
+
+export {
+  workflows,
+  permissions
+};
+//# sourceMappingURL=chunk-XRQWR3LY.js.map

package/dist/chunk-XRQWR3LY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/tools/workflows.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { KnockTool } from \"../knock-tool.js\";\nimport {\n  Workflow,\n  WorkflowUpsertParams,\n} from \"@knocklabs/mgmt/resources/index.js\";\n\nconst listWorkflows = KnockTool({\n  method: \"list_workflows\",\n  name: \"List workflows\",\n  description: `\n  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. \n\n  Use this tool when you need to understand which workflows are available to be called. \n  `,\n  parameters: z.object({\n    environment: z\n      .string()\n      .describe(\n        \"(string): The environment to list workflows for. Defaults to `development`.\"\n      ),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const allWorkflows: Workflow[] = [];\n    const listParams = {\n      environment: params.environment ?? config.environment ?? \"development\",\n    };\n\n    for await (const workflow of knockClient.workflows.list(listParams)) {\n      allWorkflows.push(workflow);\n    }\n    return allWorkflows;\n  },\n});\n\nconst triggerWorkflow = KnockTool({\n  method: \"trigger_workflow\",\n  name: \"Trigger workflow\",\n  description: `\n  Trigger a workflow for one or more recipients.\n\n  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.\n\n  When recipients aren't provided, the workflow will be triggered for the current user specified in the config.\n  `,\n  parameters: z.object({\n    workflowKey: z\n      .string()\n      .describe(\"(string): The key of the workflow to trigger.\"),\n    recipients: z\n      .array(z.string())\n      .describe(\"(array): The recipients to trigger the workflow for.\"),\n    data: z\n      .record(z.string(), z.any())\n      .describe(\"(object): Data to pass to the workflow.\"),\n    tenant: z\n      .record(z.string(), z.any())\n      .describe(\n        \"(object): The tenant to trigger the workflow for. Must contain an id if being sent.\"\n      ),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n\n    const result = await publicClient.workflows.trigger(params.workflowKey, {\n      recipients: params.recipients,\n      data: params.data,\n      tenant: params.tenant,\n    });\n\n    return result.workflow_run_id;\n  },\n});\n\nconst createEmailWorkflow = KnockTool({\n  method: \"create_email_workflow\",\n  name: \"Create email workflow\",\n  description: `\n  Creates a simple email workflow with a single step that sends an email to the recipient. Use this tool when you need to need to create an email notification, and you don't need to specify any additional steps. You can only create workflows in the development environment.\n\n  The content of the email you supply should ONLY ever be in markdown format for simplicity. You can supply dynamic variables to the subject and body of the email using the liquid template language.\n\n  When writing markdown, be sure to use headings (##) to separate sections of the email. Use an informal writing style, and avoid using complex language.\n\n  The following variables are available to use in the email subject and body:\n\n  - \\`recipient.name\\`: The name of the recipient.\n  - \\`recipient.email\\`: The email of the recipient.\n  - \\`recipient.phone_number\\`: The phone number of the recipient.\n  - \\`tenant.id\\`: The id of the tenant.\n  - \\`tenant.name\\`: The name of the tenant.\n\n  You can supply any other dynamic variables by referencing them under the \\`data\\` key in the \\`data\\` parameter when triggering the workflow. You add those like \\`{{ data.variable_name }}\\`.\n\n  You can also supply a list of categories to the workflow. These are used to categorize workflows for notification preferences. Categories should be supplied as lowercase strings in kebab case.\n\n  Once you've created the workflow, you should ask if you should commit the changes to the environment.\n  `,\n  parameters: z.object({\n    environment: z\n      .string()\n      .describe(\n        \"(string): The environment to create the workflow in. Defaults to `development`.\"\n      ),\n    workflowKey: z.string().describe(\"(string): The key of the workflow.\"),\n    name: z.string().describe(\"(string): The name of the workflow.\"),\n    categories: z\n      .array(z.string())\n      .describe(\"(array): The categories to add to the workflow.\"),\n    subject: z.string().describe(\"(string): The subject of the email.\"),\n    body: z.string().describe(\"(string): The body of the email.\"),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const emailChannelsPage = await knockClient.channels.list();\n    const emailChannels = emailChannelsPage.entries.filter(\n      (channel) => channel.type === \"email\"\n    );\n\n    if (emailChannels.length === 0) {\n      throw new Error(\"No email channels found\");\n    }\n\n    const workflowParams: WorkflowUpsertParams = {\n      environment: params.environment ?? config.environment ?? \"development\",\n      workflow: {\n        name: params.name,\n        categories: params.categories ?? [],\n        steps: [\n          {\n            type: \"channel\",\n            channel_key: emailChannels[0].key,\n            template: {\n              settings: {\n                layout_key: \"default\",\n              },\n              subject: params.subject,\n              visual_blocks: [\n                // @ts-ignore\n                {\n                  type: \"markdown\",\n                  content: params.body,\n                },\n              ],\n            },\n            name: \"Email\",\n            ref: \"email_1\",\n          },\n        ],\n      },\n    };\n\n    return await knockClient.workflows.upsert(\n      params.workflowKey,\n      workflowParams\n    );\n  },\n});\n\nconst createOneOffWorkflowSchedule = KnockTool({\n  method: \"create_one_off_workflow_schedule\",\n  name: \"Create one-off workflow schedule\",\n  description: `\n  Create a one-off workflow schedule for a user. Use this tool when you need to schedule the execution of a workflow for a specific user in the future, like to power a delayed notification.\n  \n  Schedules can accept a set of data that will be passed to the workflow trigger when it is executed. When the userId is not provided, the schedule will be created for the current user specified in the config.\n\n  Examples:\n  \n  - In three days, send a welcome email to a user\n  - In one hour, send a password reset email to a user\n  - In two weeks, send a survey to a user\n  `,\n  parameters: z.object({\n    workflowKey: z\n      .string()\n      .describe(\"(string): The key of the workflow to schedule.\"),\n    userId: z\n      .string()\n      .describe(\n        \"(string): The userId of the user to schedule the workflow for.\"\n      ),\n    scheduledAt: z\n      .string()\n      .describe(\n        \"(string): The date and time to schedule the workflow for. Must be in ISO 8601 format.\"\n      ),\n    data: z\n      .record(z.string(), z.any())\n      .describe(\"(object): Data to pass to the workflow.\"),\n  }),\n  execute: (knockClient, config) => async (params) => {\n    const publicClient = await knockClient.publicApi();\n\n    return await publicClient.workflows.createSchedules(params.workflowKey, {\n      recipients: [params.userId ?? config.userId],\n      scheduled_at: params.scheduledAt,\n      data: params.data,\n    });\n  },\n});\n\nexport const workflows = {\n  listWorkflows,\n  triggerWorkflow,\n  createEmailWorkflow,\n  createOneOffWorkflowSchedule,\n};\n\nexport const permissions = {\n  read: [\"listWorkflows\"],\n  manage: [\"createEmailWorkflow\", \"createOneOffWorkflowSchedule\"],\n  trigger: [\"triggerWorkflow\"],\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-XUYE3AGB.js

@@ -0,0 +1,27 @@
+// src/modelcontextprotocol/adapter.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+var KnockMcpServer = class extends McpServer {
+  constructor(knockClient, config, tools) {
+    super({ name: "Knock", version: "0.1.0" });
+    tools.forEach((tool) => {
+      const toolParams = tool.parameters ?? z.object({});
+      this.tool(
+        tool.name,
+        tool.description,
+        toolParams.shape,
+        async (arg) => {
+          const res = await tool.bindExecute(knockClient, config)(arg);
+          return {
+            content: [{ type: "text", text: JSON.stringify(res) }]
+          };
+        }
+      );
+    });
+  }
+};
+
+export {
+  KnockMcpServer
+};
+//# sourceMappingURL=chunk-XUYE3AGB.js.map

package/dist/chunk-XUYE3AGB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modelcontextprotocol/adapter.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { KnockTool } from \"../lib/knock-tool.js\";\nimport { Config } from \"../types.js\";\nimport { KnockClient } from \"../lib/knock-client.js\";\n\nexport class KnockMcpServer extends McpServer {\n  constructor(knockClient: KnockClient, config: Config, tools: KnockTool[]) {\n    super({ name: \"Knock\", version: \"0.1.0\" });\n\n    tools.forEach((tool) => {\n      const toolParams = tool.parameters ?? z.object({});\n\n      this.tool(\n        tool.name,\n        tool.description,\n        toolParams.shape,\n        async (arg: unknown) => {\n          const res = await tool.bindExecute(knockClient, config)(arg);\n\n          return {\n            content: [{ type: \"text\" as const, text: JSON.stringify(res) }],\n          };\n        }\n      );\n    });\n  }\n}\n"],"mappings":";AAAA,SAAS,iBAAiB;AAC1B,SAAS,SAAS;AAKX,IAAM,iBAAN,cAA6B,UAAU;AAAA,EAC5C,YAAY,aAA0B,QAAgB,OAAoB;AACxE,UAAM,EAAE,MAAM,SAAS,SAAS,QAAQ,CAAC;AAEzC,UAAM,QAAQ,CAAC,SAAS;AACtB,YAAM,aAAa,KAAK,cAAc,EAAE,OAAO,CAAC,CAAC;AAEjD,WAAK;AAAA,QACH,KAAK;AAAA,QACL,KAAK;AAAA,QACL,WAAW;AAAA,QACX,OAAO,QAAiB;AACtB,gBAAM,MAAM,MAAM,KAAK,YAAY,aAAa,MAAM,EAAE,GAAG;AAE3D,iBAAO;AAAA,YACL,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,KAAK,UAAU,GAAG,EAAE,CAAC;AAAA,UAChE;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/lib/knock-client.js

@@ -1,27 +1,6 @@
-// src/lib/knock-client.ts
-import { Knock } from "@knocklabs/node";
-import KnockMgmt from "@knocklabs/mgmt";
-var serviceTokensToApiClients = {};
-var createKnockClient = (config) => {
-  const client = new KnockMgmt({
-    serviceToken: config.serviceToken
-  });
-  return Object.assign(client, {
-    publicApi: async (_environment) => {
-      const environment = _environment ?? config.environment ?? "development";
-      if (serviceTokensToApiClients?.[config.serviceToken]?.[environment]) {
-        return serviceTokensToApiClients[config.serviceToken][environment];
-      }
-      const { api_key } = await client.apiKeys.exchange({ environment });
-      const knock = new Knock(api_key);
-      if (!serviceTokensToApiClients[config.serviceToken]) {
-        serviceTokensToApiClients[config.serviceToken] = {};
-      }
-      serviceTokensToApiClients[config.serviceToken][environment] = knock;
-      return knock;
-    }
-  });
-};
+import {
+  createKnockClient
+} from "../chunk-3LZK6RH6.js";
 export {
   createKnockClient
 };

package/dist/lib/knock-client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/knock-client.ts"],"sourcesContent":["import { Knock } from \"@knocklabs/node\";\nimport KnockMgmt from \"@knocklabs/mgmt\";\nimport { Config } from \"../types.js\";\n\nconst serviceTokensToApiClients: Record<string, Record<string, Knock>> = {};\n\ntype KnockClient = ReturnType<typeof createKnockClient>;\n\nconst createKnockClient = (config: Config) => {\n  const client = new KnockMgmt({\n    serviceToken: config.serviceToken,\n  });\n\n  return Object.assign(client, {\n    publicApi: async (_environment?: string): Promise<Knock> => {\n      const environment = _environment ?? config.environment ?? \"development\";\n\n      // If the client already exists for this service token and environment, return it\n      if (serviceTokensToApiClients?.[config.serviceToken]?.[environment]) {\n        return serviceTokensToApiClients[config.serviceToken][environment];\n      }\n\n      // Otherwise, fetch a public API key for this service token and environment\n      const { api_key } = await client.apiKeys.exchange({ environment });\n\n      // Create a new Knock client with the public API key\n      const knock = new Knock(api_key);\n\n      // Store the client in the cache\n      if (!serviceTokensToApiClients[config.serviceToken]) {\n        serviceTokensToApiClients[config.serviceToken] = {};\n      }\n\n      serviceTokensToApiClients[config.serviceToken][environment] = knock;\n\n      return knock;\n    },\n  });\n};\n\nexport { createKnockClient, type KnockClient };\n"],"mappings":";AAAA,SAAS,aAAa;AACtB,OAAO,eAAe;AAGtB,IAAM,4BAAmE,CAAC;AAI1E,IAAM,oBAAoB,CAAC,WAAmB;AAC5C,QAAM,SAAS,IAAI,UAAU;AAAA,IAC3B,cAAc,OAAO;AAAA,EACvB,CAAC;AAED,SAAO,OAAO,OAAO,QAAQ;AAAA,IAC3B,WAAW,OAAO,iBAA0C;AAC1D,YAAM,cAAc,gBAAgB,OAAO,eAAe;AAG1D,UAAI,4BAA4B,OAAO,YAAY,IAAI,WAAW,GAAG;AACnE,eAAO,0BAA0B,OAAO,YAAY,EAAE,WAAW;AAAA,MACnE;AAGA,YAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,QAAQ,SAAS,EAAE,YAAY,CAAC;AAGjE,YAAM,QAAQ,IAAI,MAAM,OAAO;AAG/B,UAAI,CAAC,0BAA0B,OAAO,YAAY,GAAG;AACnD,kCAA0B,OAAO,YAAY,IAAI,CAAC;AAAA,MACpD;AAEA,gCAA0B,OAAO,YAAY,EAAE,WAAW,IAAI;AAE9D,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/lib/knock-tool.js

@@ -1,28 +1,6 @@
-// src/lib/knock-tool.ts
-import { z } from "zod";
-var trimLines = (text) => text.split("\n").map((l) => l.trim()).filter(Boolean).join("\n");
-var KnockTool = (args) => {
-  const { execute, ...restOfArgs } = args;
-  const parameters = restOfArgs.parameters ? restOfArgs.parameters : z.object({});
-  const schemaEntries = Object.entries(parameters.shape);
-  const argsStr = schemaEntries.length === 0 ? "Takes no arguments" : schemaEntries.map(([key, value]) => {
-    return `- ${key}: ${value.description || ""}`;
-  }).join("\n");
-  const fullDescription = trimLines(`
-  Tool name:
-  ${args.name}
-  Description:
-  ${args.description}.
-  Arguments:
-  ${argsStr}
-  `);
-  return {
-    ...restOfArgs,
-    parameters,
-    fullDescription,
-    bindExecute: (knockClient, config) => execute(knockClient, config)
-  };
-};
+import {
+  KnockTool
+} from "../chunk-TOBLV65T.js";
 export {
   KnockTool
 };

package/dist/lib/knock-tool.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/knock-tool.ts"],"sourcesContent":["import type { ZodObject } from \"zod\";\nimport { z } from \"zod\";\nimport { Config } from \"../types.js\";\nimport { KnockClient } from \"./knock-client.js\";\n\nexport interface KnockToolDefinition {\n  /**\n   * The method name of the tool. This is a machine-readable string.\n   */\n  method: string;\n  /**\n   * The name of the tool. This can be used to reference the tool in the code.\n   * A descriptive LLM-readable string.\n   */\n  name: string;\n\n  /**\n   * A descriptive prompt explaining the tool's purpose, including examples where useful.\n   */\n  description: string;\n\n  /**\n   * A descriptive prompt explaining the tool's purpose, usage and input parameters.\n   * Ths is intended to be used by the underlying LLM.\n   */\n  fullDescription: string;\n\n  /**\n   * The Zod schema for the input parameters of the tool\n   */\n  parameters?: ZodObject<any>;\n  /**\n   * The actual implementation of the tool.\n   */\n  execute: (\n    knockClient: KnockClient,\n    config: Config\n  ) => (input: any) => Promise<unknown>;\n}\n\nexport interface KnockTool extends Omit<KnockToolDefinition, \"execute\"> {\n  bindExecute: (\n    knockClient: KnockClient,\n    config: Config\n  ) => (input: any) => Promise<unknown>;\n}\n\nconst trimLines = (text: string) =>\n  text\n    .split(\"\\n\")\n    .map((l) => l.trim())\n    .filter(Boolean)\n    .join(\"\\n\");\n\nexport const KnockTool = (\n  args: Omit<KnockToolDefinition, \"fullDescription\">\n): KnockTool => {\n  const { execute, ...restOfArgs } = args;\n  const parameters = restOfArgs.parameters\n    ? restOfArgs.parameters\n    : z.object({});\n\n  const schemaEntries = Object.entries(parameters.shape);\n\n  const argsStr =\n    schemaEntries.length === 0\n      ? \"Takes no arguments\"\n      : schemaEntries\n          .map(([key, value]) => {\n            return `- ${key}: ${(value as any).description || \"\"}`;\n          })\n          .join(\"\\n\");\n\n  const fullDescription = trimLines(`\n  Tool name:\n  ${args.name}\n  Description:\n  ${args.description}.\n  Arguments:\n  ${argsStr}\n  `);\n\n  return {\n    ...restOfArgs,\n    parameters,\n    fullDescription,\n    bindExecute: (knockClient: KnockClient, config: Config) =>\n      execute(knockClient, config),\n  };\n};\n"],"mappings":";AACA,SAAS,SAAS;AA8ClB,IAAM,YAAY,CAAC,SACjB,KACG,MAAM,IAAI,EACV,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO,EACd,KAAK,IAAI;AAEP,IAAM,YAAY,CACvB,SACc;AACd,QAAM,EAAE,SAAS,GAAG,WAAW,IAAI;AACnC,QAAM,aAAa,WAAW,aAC1B,WAAW,aACX,EAAE,OAAO,CAAC,CAAC;AAEf,QAAM,gBAAgB,OAAO,QAAQ,WAAW,KAAK;AAErD,QAAM,UACJ,cAAc,WAAW,IACrB,uBACA,cACG,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AACrB,WAAO,KAAK,GAAG,KAAM,MAAc,eAAe,EAAE;AAAA,EACtD,CAAC,EACA,KAAK,IAAI;AAElB,QAAM,kBAAkB,UAAU;AAAA;AAAA,IAEhC,KAAK,IAAI;AAAA;AAAA,IAET,KAAK,WAAW;AAAA;AAAA,IAEhB,OAAO;AAAA,GACR;AAED,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA,aAAa,CAAC,aAA0B,WACtC,QAAQ,aAAa,MAAM;AAAA,EAC/B;AACF;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}