@knocklabs/agent-toolkit 0.5.3 → 0.5.4

package/dist/ai-sdk/index.d.ts

@@ -1,9 +1,12 @@
 import { ToolSet, Tool } from 'ai';
 import { a as DeferredToolCall, b as DeferredToolCallConfig, K as KnockOutboundWebhookEvent, D as DeferredToolCallInteractionResult } from '../types-kR5zfaEk.js';
-import { ToolkitConfig, ToolCategory } from '../types.js';
+import { T as ToolkitConfig, a as ToolCategory } from '../index-qFGypkX3.js';
 import { ToolInvocation } from '@ai-sdk/ui-utils';
 import '@knocklabs/mgmt/resources.js';
 import '@knocklabs/node/resources.js';
+import 'zod';
+import '@knocklabs/mgmt';
+import '@knocklabs/node';
 
 /**
  * Convert a deferred tool call to a tool invocation. Useful when building an assistant

package/dist/ai-sdk/index.js

@@ -5,11 +5,11 @@ import {
 } from "../chunk-X3LAGKQW.js";
 import {
   createKnockClient
-} from "../chunk-BT6KDK3Z.js";
+} from "../chunk-YOH7QKTM.js";
 import {
   getToolMap,
   getToolsByPermissionsInCategories
-} from "../chunk-CRW3ZMHM.js";
+} from "../chunk-7U5HNTEY.js";
 import "../chunk-G3PMV62Z.js";
 
 // src/ai-sdk/tool-converter.ts

package/dist/{chunk-CRW3ZMHM.js → chunk-7U5HNTEY.js}

@@ -2251,11 +2251,13 @@ var toolPermissions = {
 };
 
 export {
+  KnockTool,
   tools,
   allTools,
+  toolPermissions,
   createWorkflowTools,
   filterTools,
   getToolsByPermissionsInCategories,
   getToolMap
 };
-//# sourceMappingURL=chunk-CRW3ZMHM.js.map
+//# sourceMappingURL=chunk-7U5HNTEY.js.map

package/dist/{chunk-LLIVREQ2.js → chunk-HIHS5S2N.js}

@@ -1,14 +1,14 @@
 import {
   allTools,
   createWorkflowTools
-} from "./chunk-CRW3ZMHM.js";
+} from "./chunk-7U5HNTEY.js";
 
 // 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.5.3" });
+    super({ name: "Knock", version: "0.5.4" });
     tools.forEach((tool) => {
       const toolParams = tool.parameters ?? z.object({});
       this.tool(
@@ -44,4 +44,4 @@ var createKnockMcpServer = async (params) => {
 export {
   createKnockMcpServer
 };
-//# sourceMappingURL=chunk-LLIVREQ2.js.map
+//# sourceMappingURL=chunk-HIHS5S2N.js.map

package/dist/{chunk-BT6KDK3Z.js → chunk-YOH7QKTM.js}

@@ -5,7 +5,7 @@ import { Knock } from "@knocklabs/node";
 // package.json
 var package_default = {
   name: "@knocklabs/agent-toolkit",
-  version: "0.5.3",
+  version: "0.5.4",
   description: "A toolkit for working with Knock in Agent workflows.",
   main: "src/index.js",
   scripts: {
@@ -52,6 +52,10 @@ var package_default = {
     },
     "./types": {
       types: "./dist/types.d.ts"
+    },
+    "./core": {
+      types: "./dist/core/index.d.ts",
+      default: "./dist/core/index.js"
     }
   },
   bin: {
@@ -151,4 +155,4 @@ var createKnockClient = (config) => {
 export {
   createKnockClient
 };
-//# sourceMappingURL=chunk-BT6KDK3Z.js.map
+//# sourceMappingURL=chunk-YOH7QKTM.js.map

package/dist/chunk-YOH7QKTM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/knock-client.ts","../package.json"],"sourcesContent":["import KnockMgmt from \"@knocklabs/mgmt\";\nimport { Knock } from \"@knocklabs/node\";\n\nimport pkg from \"../../package.json\";\nimport { Config } from \"../types.js\";\n\nconst serviceTokensToApiClients: Record<string, Record<string, Knock>> = {};\n\ntype KnockClient = ReturnType<typeof createKnockClient>;\n\n// Include a custom header to identify all client requests in the API logs\nconst knockClientHeaders = {\n  \"X-Knock-Client\": `knock/agent-toolkit@${pkg.version}`,\n};\n\nconst createKnockClient = (config: Config) => {\n  const serviceToken = config.serviceToken ?? process.env.KNOCK_SERVICE_TOKEN;\n\n  if (!serviceToken) {\n    throw new Error(\n      \"Service token is required. Please set the `serviceToken` property in the config or the `KNOCK_SERVICE_TOKEN` environment variable.\"\n    );\n  }\n\n  const client = new KnockMgmt({\n    serviceToken,\n    defaultHeaders: knockClientHeaders,\n  });\n\n  return Object.assign(client, {\n    publicApi: async (environmentSlug?: string): Promise<Knock> => {\n      const environment =\n        environmentSlug ?? config.environment ?? \"development\";\n\n      // If the client already exists for this service token and environment, return it\n      if (serviceTokensToApiClients?.[serviceToken]?.[environment]) {\n        return serviceTokensToApiClients[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({\n        apiKey: api_key,\n        defaultHeaders: knockClientHeaders,\n      });\n\n      // Store the client in the cache\n      if (!serviceTokensToApiClients[serviceToken]) {\n        serviceTokensToApiClients[serviceToken] = {};\n      }\n\n      serviceTokensToApiClients[serviceToken][environment] = knock;\n\n      return knock;\n    },\n  });\n};\n\nexport { createKnockClient, type KnockClient };\n","{\n  \"name\": \"@knocklabs/agent-toolkit\",\n  \"version\": \"0.5.4\",\n  \"description\": \"A toolkit for working with Knock in Agent workflows.\",\n  \"main\": \"src/index.js\",\n  \"scripts\": {\n    \"build\": \"tsup --env.NODE_ENV production\",\n    \"clean\": \"rimraf ./dist\",\n    \"dev\": \"tsup --watch\",\n    \"lint\": \"eslint src --ext .ts,.tsx\",\n    \"lint:fix\": \"eslint src --ext .ts,.tsx --fix\",\n    \"format\": \"prettier --write \\\"src/**/*.{ts,tsx}\\\"\",\n    \"format:check\": \"prettier --check \\\"src/**/*.{ts,tsx}\\\"\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"release\": \"npm run build && npm run release:publish && changeset tag\",\n    \"release:publish\": \"npm publish --access public --tolerate-republish\"\n  },\n  \"author\": \"Knock\",\n  \"license\": \"MIT\",\n  \"sideEffects\": false,\n  \"type\": \"module\",\n  \"exports\": {\n    \"./openai\": {\n      \"types\": \"./dist/openai/index.d.ts\",\n      \"default\": \"./dist/openai/index.js\"\n    },\n    \"./ai-sdk\": {\n      \"types\": \"./dist/ai-sdk/index.d.ts\",\n      \"default\": \"./dist/ai-sdk/index.js\"\n    },\n    \"./langchain\": {\n      \"types\": \"./dist/langchain/index.d.ts\",\n      \"default\": \"./dist/langchain/index.js\"\n    },\n    \"./mastra\": {\n      \"types\": \"./dist/mastra/index.d.ts\",\n      \"default\": \"./dist/mastra/index.js\"\n    },\n    \"./modelcontextprotocol\": {\n      \"types\": \"./dist/modelcontextprotocol/index.d.ts\",\n      \"default\": \"./dist/modelcontextprotocol/index.js\"\n    },\n    \"./human-in-the-loop\": {\n      \"types\": \"./dist/human-in-the-loop/index.d.ts\",\n      \"default\": \"./dist/human-in-the-loop/index.js\"\n    },\n    \"./types\": {\n      \"types\": \"./dist/types.d.ts\"\n    },\n    \"./core\": {\n      \"types\": \"./dist/core/index.d.ts\",\n      \"default\": \"./dist/core/index.js\"\n    }\n  },\n  \"bin\": {\n    \"local-mcp\": \"dist/modelcontextprotocol/local-server.js\"\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"dependencies\": {\n    \"@knocklabs/mgmt\": \"^0.2.0\",\n    \"@knocklabs/node\": \"^1.10.3\",\n    \"@modelcontextprotocol/sdk\": \"^1.7.0\",\n    \"@sentry/node\": \"^10.5.0\",\n    \"json-schema-to-zod\": \"^2.6.1\",\n    \"uuid\": \"^11.1.0\",\n    \"yargs\": \"^17.7.2\",\n    \"zod\": \"^3.24.2\",\n    \"zod-to-json-schema\": \"^3.24.5\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"^2.28.1\",\n    \"@eslint/js\": \"^9.24.0\",\n    \"@langchain/core\": \"^0.3.45\",\n    \"@types/node\": \"^22.13.10\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@typescript-eslint/eslint-plugin\": \"^8.29.1\",\n    \"@typescript-eslint/parser\": \"^8.29.1\",\n    \"ai\": \"^4.2.8\",\n    \"eslint\": \"^9.24.0\",\n    \"eslint-config-prettier\": \"^10.1.2\",\n    \"eslint-import-resolver-typescript\": \"^4.3.2\",\n    \"eslint-plugin-import\": \"^2.31.0\",\n    \"eslint-plugin-prettier\": \"^5.2.6\",\n    \"openai\": \"^4.90.0\",\n    \"prettier\": \"^3.5.3\",\n    \"rimraf\": \"^6.0.1\",\n    \"ts-node\": \"^10.9.2\",\n    \"tsup\": \"^8.4.0\",\n    \"typescript\": \"^5.8.2\",\n    \"typescript-eslint\": \"^8.29.1\",\n    \"vitest\": \"^1.3.1\"\n  },\n  \"peerDependencies\": {\n    \"@mastra/core\": \"^0.10.3\",\n    \"ai\": \"^4.0.0\",\n    \"openai\": \"^4.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"ai\": {\n      \"optional\": true\n    }\n  },\n  \"engines\": {\n    \"node\": \">=20\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export { C as Config, K as KnockClient, b as KnockTool, g as KnockToolDefinition, b as KnockToolType, T as ToolkitConfig, d as allTools, f as createKnockClient, e as toolPermissions, t as tools } from '../index-qFGypkX3.js';
+import 'zod';
+import '@knocklabs/mgmt';
+import '@knocklabs/node';

package/dist/core/index.js

@@ -0,0 +1,18 @@
+import {
+  createKnockClient
+} from "../chunk-YOH7QKTM.js";
+import {
+  KnockTool,
+  allTools,
+  toolPermissions,
+  tools
+} from "../chunk-7U5HNTEY.js";
+import "../chunk-G3PMV62Z.js";
+export {
+  KnockTool,
+  allTools,
+  createKnockClient,
+  toolPermissions,
+  tools
+};
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/human-in-the-loop.d.ts

@@ -1,8 +1,8 @@
 import * as _knocklabs_node_resources_workflows_mjs from '@knocklabs/node/resources/workflows.mjs';
-import { Config } from './types.js';
-import { K as KnockClient } from './knock-client-BH7Juvis.js';
+import { K as KnockClient, C as Config } from './index-qFGypkX3.js';
 import { K as KnockOutboundWebhookEvent, D as DeferredToolCallInteractionResult, a as DeferredToolCall, b as DeferredToolCallConfig } from './types-kR5zfaEk.js';
 export { c as DeferredToolCallWorkflowData } from './types-kR5zfaEk.js';
+import 'zod';
 import '@knocklabs/mgmt';
 import '@knocklabs/node';
 import '@knocklabs/mgmt/resources.js';

package/dist/index-qFGypkX3.d.ts

@@ -0,0 +1,272 @@
+import { ZodObject } from 'zod';
+import KnockMgmt from '@knocklabs/mgmt';
+import { Knock } from '@knocklabs/node';
+
+type KnockClient = ReturnType<typeof createKnockClient>;
+declare const createKnockClient: (config: Config) => KnockMgmt & {
+    publicApi: (environmentSlug?: string) => Promise<Knock>;
+};
+
+interface KnockToolDefinition {
+    /**
+     * The method name of the tool. This is a machine-readable string.
+     */
+    method: string;
+    /**
+     * The name of the tool. This can be used to reference the tool in the code.
+     * A descriptive LLM-readable string.
+     */
+    name: string;
+    /**
+     * A descriptive prompt explaining the tool's purpose, including examples where useful.
+     */
+    description: string;
+    /**
+     * A descriptive prompt explaining the tool's purpose, usage and input parameters.
+     * Ths is intended to be used by the underlying LLM.
+     */
+    fullDescription: string;
+    /**
+     * The Zod schema for the input parameters of the tool
+     */
+    parameters?: ZodObject<any>;
+    /**
+     * The actual implementation of the tool.
+     */
+    execute: (knockClient: KnockClient, config: Config) => (input: any) => Promise<unknown>;
+}
+interface KnockTool extends Omit<KnockToolDefinition, "execute"> {
+    bindExecute: (knockClient: KnockClient, config: Config) => (input: any) => Promise<unknown>;
+}
+declare const KnockTool: (args: Omit<KnockToolDefinition, "fullDescription">) => KnockTool;
+
+declare const tools: {
+    channels: {
+        listChannels: KnockTool;
+    };
+    commits: {
+        listCommits: KnockTool;
+        commitAllChanges: KnockTool;
+        promoteAllCommits: KnockTool;
+    };
+    documentation: {
+        searchDocumentation: KnockTool;
+    };
+    emailLayouts: {
+        getEmailLayout: KnockTool;
+        listEmailLayouts: KnockTool;
+        createOrUpdateEmailLayout: KnockTool;
+    };
+    environments: {
+        listEnvironments: KnockTool;
+    };
+    guides: {
+        listGuides: KnockTool;
+        getGuide: KnockTool;
+        createOrUpdateGuide: KnockTool;
+    };
+    messages: {
+        getMessage: KnockTool;
+        getMessageContent: KnockTool;
+        getMessageDeliveryLogs: KnockTool;
+        getMessageEvents: KnockTool;
+    };
+    messageTypes: {
+        listMessageTypes: KnockTool;
+        createOrUpdateMessageType: KnockTool;
+    };
+    objects: {
+        listObjects: KnockTool;
+        getObject: KnockTool;
+        createOrUpdateObject: KnockTool;
+        subscribeUsersToObject: KnockTool;
+        unsubscribeUsersFromObject: KnockTool;
+    };
+    partials: {
+        getPartial: KnockTool;
+        listPartials: KnockTool;
+        createOrUpdatePartial: KnockTool;
+    };
+    tenants: {
+        getTenant: KnockTool;
+        listTenants: KnockTool;
+        createOrUpdateTenant: KnockTool;
+    };
+    users: {
+        getUser: KnockTool;
+        createOrUpdateUser: KnockTool;
+        getUserPreferences: KnockTool;
+        setUserPreferences: KnockTool;
+        getUserMessages: KnockTool;
+    };
+    workflows: {
+        createOneOffWorkflowSchedule: KnockTool;
+        createOrUpdateEmailStepInWorkflow: KnockTool;
+        createOrUpdateSmsStepInWorkflow: KnockTool;
+        createOrUpdatePushStepInWorkflow: KnockTool;
+        createOrUpdateInAppFeedStepInWorkflow: KnockTool;
+        createOrUpdateChatStepInWorkflow: KnockTool;
+        createOrUpdateDelayStepInWorkflow: KnockTool;
+        createOrUpdateBatchStepInWorkflow: KnockTool;
+        listWorkflows: KnockTool;
+        getWorkflow: KnockTool;
+        triggerWorkflow: KnockTool;
+        createWorkflow: KnockTool;
+    };
+};
+declare const allTools: {
+    createOneOffWorkflowSchedule: KnockTool;
+    createOrUpdateEmailStepInWorkflow: KnockTool;
+    createOrUpdateSmsStepInWorkflow: KnockTool;
+    createOrUpdatePushStepInWorkflow: KnockTool;
+    createOrUpdateInAppFeedStepInWorkflow: KnockTool;
+    createOrUpdateChatStepInWorkflow: KnockTool;
+    createOrUpdateDelayStepInWorkflow: KnockTool;
+    createOrUpdateBatchStepInWorkflow: KnockTool;
+    listWorkflows: KnockTool;
+    getWorkflow: KnockTool;
+    triggerWorkflow: KnockTool;
+    createWorkflow: KnockTool;
+    getUser: KnockTool;
+    createOrUpdateUser: KnockTool;
+    getUserPreferences: KnockTool;
+    setUserPreferences: KnockTool;
+    getUserMessages: KnockTool;
+    getTenant: KnockTool;
+    listTenants: KnockTool;
+    createOrUpdateTenant: KnockTool;
+    getPartial: KnockTool;
+    listPartials: KnockTool;
+    createOrUpdatePartial: KnockTool;
+    listObjects: KnockTool;
+    getObject: KnockTool;
+    createOrUpdateObject: KnockTool;
+    subscribeUsersToObject: KnockTool;
+    unsubscribeUsersFromObject: KnockTool;
+    getMessage: KnockTool;
+    getMessageContent: KnockTool;
+    getMessageDeliveryLogs: KnockTool;
+    getMessageEvents: KnockTool;
+    listMessageTypes: KnockTool;
+    createOrUpdateMessageType: KnockTool;
+    listGuides: KnockTool;
+    getGuide: KnockTool;
+    createOrUpdateGuide: KnockTool;
+    listEnvironments: KnockTool;
+    getEmailLayout: KnockTool;
+    listEmailLayouts: KnockTool;
+    createOrUpdateEmailLayout: KnockTool;
+    searchDocumentation: KnockTool;
+    listCommits: KnockTool;
+    commitAllChanges: KnockTool;
+    promoteAllCommits: KnockTool;
+    listChannels: KnockTool;
+};
+declare const toolPermissions: {
+    channels: {
+        read: string[];
+    };
+    commits: {
+        read: string[];
+        manage: string[];
+    };
+    documentation: {
+        read: string[];
+    };
+    emailLayouts: {
+        read: string[];
+        manage: string[];
+    };
+    environments: {
+        read: string[];
+    };
+    guides: {
+        read: string[];
+        manage: string[];
+    };
+    messages: {
+        read: string[];
+    };
+    messageTypes: {
+        read: string[];
+        manage: string[];
+    };
+    objects: {
+        read: string[];
+        manage: string[];
+    };
+    partials: {
+        read: string[];
+        manage: string[];
+    };
+    tenants: {
+        read: string[];
+        manage: string[];
+    };
+    users: {
+        read: string[];
+        manage: string[];
+    };
+    workflows: {
+        read: string[];
+        manage: string[];
+        trigger: never[];
+    };
+};
+
+interface Config {
+    /**
+     * The token to use to authenticate with the service. If not provided, the `serviceToken`
+     * will be resolved from `KNOCK_SERVICE_TOKEN` environment variable.
+     */
+    serviceToken?: string | undefined;
+    /**
+     * When set calls will be made as this user.
+     */
+    userId?: string | undefined;
+    /**
+     * When set calls will be made in this tenant context.
+     */
+    tenantId?: string | undefined;
+    /**
+     * The environment to use as the basis for the API calls. When not defined, will default to
+     * the `development` environment.
+     */
+    environment?: string | undefined;
+    /**
+     * Whether to hide user data from LLM responses. When true, the LLM will not have access to user
+     * data and only the ID will be returned. Defaults to `false`.
+     */
+    hideUserData?: boolean | undefined;
+}
+type TransformPermissions<T> = {
+    [K in keyof T]?: {
+        [P in keyof T[K]]?: boolean;
+    };
+};
+interface ToolkitConfig extends Config {
+    /**
+     * The permissions to use for the toolkit.
+     */
+    permissions: Omit<TransformPermissions<typeof toolPermissions>, "workflows"> & {
+        workflows?: {
+            /**
+             * Whether to allow reading workflows.
+             */
+            read?: boolean | undefined;
+            /**
+             * Whether to allow managing workflows.
+             */
+            manage?: boolean | undefined;
+            /**
+             * Optionally specify a list of workflow keys to turn into workflow trigger tools
+             *
+             * If true, all workflows will be allowed.
+             */
+            trigger?: string[] | undefined;
+        };
+    };
+}
+type ToolCategory = keyof typeof toolPermissions;
+
+export { type Config as C, type KnockClient as K, type ToolkitConfig as T, type ToolCategory as a, KnockTool as b, type TransformPermissions as c, allTools as d, toolPermissions as e, createKnockClient as f, type KnockToolDefinition as g, tools as t };

package/dist/langchain/index.d.ts

@@ -1,5 +1,8 @@
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { ToolkitConfig, ToolCategory } from '../types.js';
+import { T as ToolkitConfig, a as ToolCategory } from '../index-qFGypkX3.js';
+import 'zod';
+import '@knocklabs/mgmt';
+import '@knocklabs/node';
 
 type KnockToolkit = {
     getAllTools: () => DynamicStructuredTool[];

package/dist/langchain/index.js

@@ -1,10 +1,10 @@
 import {
   createKnockClient
-} from "../chunk-BT6KDK3Z.js";
+} from "../chunk-YOH7QKTM.js";
 import {
   getToolMap,
   getToolsByPermissionsInCategories
-} from "../chunk-CRW3ZMHM.js";
+} from "../chunk-7U5HNTEY.js";
 import {
   __commonJS,
   __export,

package/dist/mastra/index.d.ts

@@ -1,6 +1,8 @@
 import { Tool } from '@mastra/core/tools';
 import { z } from 'zod';
-import { ToolkitConfig, ToolCategory } from '../types.js';
+import { T as ToolkitConfig, a as ToolCategory } from '../index-qFGypkX3.js';
+import '@knocklabs/mgmt';
+import '@knocklabs/node';
 
 type KnockToolkit = {
     getAllTools: () => Tool<z.ZodObject<any, any>>[];

package/dist/mastra/index.js

@@ -1,10 +1,10 @@
 import {
   createKnockClient
-} from "../chunk-BT6KDK3Z.js";
+} from "../chunk-YOH7QKTM.js";
 import {
   getToolMap,
   getToolsByPermissionsInCategories
-} from "../chunk-CRW3ZMHM.js";
+} from "../chunk-7U5HNTEY.js";
 import "../chunk-G3PMV62Z.js";
 
 // src/mastra/tool-converter.ts

package/dist/modelcontextprotocol/index.d.ts

@@ -1,43 +1,9 @@
-import { K as KnockClient } from '../knock-client-BH7Juvis.js';
-import { ZodObject } from 'zod';
-import { Config } from '../types.js';
+import { K as KnockClient, C as Config, b as KnockTool } from '../index-qFGypkX3.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import 'zod';
 import '@knocklabs/mgmt';
 import '@knocklabs/node';
 
-interface KnockToolDefinition {
-    /**
-     * The method name of the tool. This is a machine-readable string.
-     */
-    method: string;
-    /**
-     * The name of the tool. This can be used to reference the tool in the code.
-     * A descriptive LLM-readable string.
-     */
-    name: string;
-    /**
-     * A descriptive prompt explaining the tool's purpose, including examples where useful.
-     */
-    description: string;
-    /**
-     * A descriptive prompt explaining the tool's purpose, usage and input parameters.
-     * Ths is intended to be used by the underlying LLM.
-     */
-    fullDescription: string;
-    /**
-     * The Zod schema for the input parameters of the tool
-     */
-    parameters?: ZodObject<any>;
-    /**
-     * The actual implementation of the tool.
-     */
-    execute: (knockClient: KnockClient, config: Config) => (input: any) => Promise<unknown>;
-}
-interface KnockTool extends Omit<KnockToolDefinition, "execute"> {
-    bindExecute: (knockClient: KnockClient, config: Config) => (input: any) => Promise<unknown>;
-}
-declare const KnockTool: (args: Omit<KnockToolDefinition, "fullDescription">) => KnockTool;
-
 declare class KnockMcpServer extends McpServer {
     constructor(knockClient: KnockClient, config: Config, tools: KnockTool[]);
 }

package/dist/modelcontextprotocol/index.js

@@ -1,7 +1,7 @@
 import {
   createKnockMcpServer
-} from "../chunk-LLIVREQ2.js";
-import "../chunk-CRW3ZMHM.js";
+} from "../chunk-HIHS5S2N.js";
+import "../chunk-7U5HNTEY.js";
 import "../chunk-G3PMV62Z.js";
 export {
   createKnockMcpServer

package/dist/modelcontextprotocol/local-server.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import {
-  createKnockMcpServer
-} from "../chunk-LLIVREQ2.js";
 import {
   createKnockClient
-} from "../chunk-BT6KDK3Z.js";
+} from "../chunk-YOH7QKTM.js";
+import {
+  createKnockMcpServer
+} from "../chunk-HIHS5S2N.js";
 import {
   filterTools,
   tools
-} from "../chunk-CRW3ZMHM.js";
+} from "../chunk-7U5HNTEY.js";
 import "../chunk-G3PMV62Z.js";
 
 // src/modelcontextprotocol/local-server.ts

package/dist/openai/index.d.ts

@@ -1,5 +1,8 @@
 import { ChatCompletionTool, ChatCompletionMessageToolCall, ChatCompletionToolMessageParam } from 'openai/resources.mjs';
-import { ToolkitConfig, ToolCategory } from '../types.js';
+import { T as ToolkitConfig, a as ToolCategory } from '../index-qFGypkX3.js';
+import 'zod';
+import '@knocklabs/mgmt';
+import '@knocklabs/node';
 
 type KnockToolkit = {
     getAllTools: () => ChatCompletionTool[];

package/dist/openai/index.js

@@ -1,10 +1,10 @@
 import {
   createKnockClient
-} from "../chunk-BT6KDK3Z.js";
+} from "../chunk-YOH7QKTM.js";
 import {
   getToolMap,
   getToolsByPermissionsInCategories
-} from "../chunk-CRW3ZMHM.js";
+} from "../chunk-7U5HNTEY.js";
 import "../chunk-G3PMV62Z.js";
 
 // src/openai/tool-converter.ts

package/dist/types.d.ts

@@ -1,108 +1,4 @@
-declare const toolPermissions: {
-    channels: {
-        read: string[];
-    };
-    commits: {
-        read: string[];
-        manage: string[];
-    };
-    documentation: {
-        read: string[];
-    };
-    emailLayouts: {
-        read: string[];
-        manage: string[];
-    };
-    environments: {
-        read: string[];
-    };
-    guides: {
-        read: string[];
-        manage: string[];
-    };
-    messages: {
-        read: string[];
-    };
-    messageTypes: {
-        read: string[];
-        manage: string[];
-    };
-    objects: {
-        read: string[];
-        manage: string[];
-    };
-    partials: {
-        read: string[];
-        manage: string[];
-    };
-    tenants: {
-        read: string[];
-        manage: string[];
-    };
-    users: {
-        read: string[];
-        manage: string[];
-    };
-    workflows: {
-        read: string[];
-        manage: string[];
-        trigger: never[];
-    };
-};
-
-interface Config {
-    /**
-     * The token to use to authenticate with the service. If not provided, the `serviceToken`
-     * will be resolved from `KNOCK_SERVICE_TOKEN` environment variable.
-     */
-    serviceToken?: string | undefined;
-    /**
-     * When set calls will be made as this user.
-     */
-    userId?: string | undefined;
-    /**
-     * When set calls will be made in this tenant context.
-     */
-    tenantId?: string | undefined;
-    /**
-     * The environment to use as the basis for the API calls. When not defined, will default to
-     * the `development` environment.
-     */
-    environment?: string | undefined;
-    /**
-     * Whether to hide user data from LLM responses. When true, the LLM will not have access to user
-     * data and only the ID will be returned. Defaults to `false`.
-     */
-    hideUserData?: boolean | undefined;
-}
-type TransformPermissions<T> = {
-    [K in keyof T]?: {
-        [P in keyof T[K]]?: boolean;
-    };
-};
-interface ToolkitConfig extends Config {
-    /**
-     * The permissions to use for the toolkit.
-     */
-    permissions: Omit<TransformPermissions<typeof toolPermissions>, "workflows"> & {
-        workflows?: {
-            /**
-             * Whether to allow reading workflows.
-             */
-            read?: boolean | undefined;
-            /**
-             * Whether to allow managing workflows.
-             */
-            manage?: boolean | undefined;
-            /**
-             * Optionally specify a list of workflow keys to turn into workflow trigger tools
-             *
-             * If true, all workflows will be allowed.
-             */
-            trigger?: string[] | undefined;
-        };
-    };
-}
-type ToolCategory = keyof typeof toolPermissions;
-
-export type { Config, ToolCategory, ToolkitConfig, TransformPermissions };
+export { C as Config, a as ToolCategory, T as ToolkitConfig, c as TransformPermissions } from './index-qFGypkX3.js';
+import 'zod';
+import '@knocklabs/mgmt';
+import '@knocklabs/node';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/agent-toolkit",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "A toolkit for working with Knock in Agent workflows.",
   "main": "src/index.js",
   "scripts": {
@@ -47,6 +47,10 @@
     },
     "./types": {
       "types": "./dist/types.d.ts"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
     }
   },
   "bin": {

package/dist/chunk-BT6KDK3Z.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/knock-client.ts","../package.json"],"sourcesContent":["import KnockMgmt from \"@knocklabs/mgmt\";\nimport { Knock } from \"@knocklabs/node\";\n\nimport pkg from \"../../package.json\";\nimport { Config } from \"../types.js\";\n\nconst serviceTokensToApiClients: Record<string, Record<string, Knock>> = {};\n\ntype KnockClient = ReturnType<typeof createKnockClient>;\n\n// Include a custom header to identify all client requests in the API logs\nconst knockClientHeaders = {\n  \"X-Knock-Client\": `knock/agent-toolkit@${pkg.version}`,\n};\n\nconst createKnockClient = (config: Config) => {\n  const serviceToken = config.serviceToken ?? process.env.KNOCK_SERVICE_TOKEN;\n\n  if (!serviceToken) {\n    throw new Error(\n      \"Service token is required. Please set the `serviceToken` property in the config or the `KNOCK_SERVICE_TOKEN` environment variable.\"\n    );\n  }\n\n  const client = new KnockMgmt({\n    serviceToken,\n    defaultHeaders: knockClientHeaders,\n  });\n\n  return Object.assign(client, {\n    publicApi: async (environmentSlug?: string): Promise<Knock> => {\n      const environment =\n        environmentSlug ?? config.environment ?? \"development\";\n\n      // If the client already exists for this service token and environment, return it\n      if (serviceTokensToApiClients?.[serviceToken]?.[environment]) {\n        return serviceTokensToApiClients[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({\n        apiKey: api_key,\n        defaultHeaders: knockClientHeaders,\n      });\n\n      // Store the client in the cache\n      if (!serviceTokensToApiClients[serviceToken]) {\n        serviceTokensToApiClients[serviceToken] = {};\n      }\n\n      serviceTokensToApiClients[serviceToken][environment] = knock;\n\n      return knock;\n    },\n  });\n};\n\nexport { createKnockClient, type KnockClient };\n","{\n  \"name\": \"@knocklabs/agent-toolkit\",\n  \"version\": \"0.5.3\",\n  \"description\": \"A toolkit for working with Knock in Agent workflows.\",\n  \"main\": \"src/index.js\",\n  \"scripts\": {\n    \"build\": \"tsup --env.NODE_ENV production\",\n    \"clean\": \"rimraf ./dist\",\n    \"dev\": \"tsup --watch\",\n    \"lint\": \"eslint src --ext .ts,.tsx\",\n    \"lint:fix\": \"eslint src --ext .ts,.tsx --fix\",\n    \"format\": \"prettier --write \\\"src/**/*.{ts,tsx}\\\"\",\n    \"format:check\": \"prettier --check \\\"src/**/*.{ts,tsx}\\\"\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"release\": \"npm run build && npm run release:publish && changeset tag\",\n    \"release:publish\": \"npm publish --access public --tolerate-republish\"\n  },\n  \"author\": \"Knock\",\n  \"license\": \"MIT\",\n  \"sideEffects\": false,\n  \"type\": \"module\",\n  \"exports\": {\n    \"./openai\": {\n      \"types\": \"./dist/openai/index.d.ts\",\n      \"default\": \"./dist/openai/index.js\"\n    },\n    \"./ai-sdk\": {\n      \"types\": \"./dist/ai-sdk/index.d.ts\",\n      \"default\": \"./dist/ai-sdk/index.js\"\n    },\n    \"./langchain\": {\n      \"types\": \"./dist/langchain/index.d.ts\",\n      \"default\": \"./dist/langchain/index.js\"\n    },\n    \"./mastra\": {\n      \"types\": \"./dist/mastra/index.d.ts\",\n      \"default\": \"./dist/mastra/index.js\"\n    },\n    \"./modelcontextprotocol\": {\n      \"types\": \"./dist/modelcontextprotocol/index.d.ts\",\n      \"default\": \"./dist/modelcontextprotocol/index.js\"\n    },\n    \"./human-in-the-loop\": {\n      \"types\": \"./dist/human-in-the-loop/index.d.ts\",\n      \"default\": \"./dist/human-in-the-loop/index.js\"\n    },\n    \"./types\": {\n      \"types\": \"./dist/types.d.ts\"\n    }\n  },\n  \"bin\": {\n    \"local-mcp\": \"dist/modelcontextprotocol/local-server.js\"\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"dependencies\": {\n    \"@knocklabs/mgmt\": \"^0.2.0\",\n    \"@knocklabs/node\": \"^1.10.3\",\n    \"@modelcontextprotocol/sdk\": \"^1.7.0\",\n    \"@sentry/node\": \"^10.5.0\",\n    \"json-schema-to-zod\": \"^2.6.1\",\n    \"uuid\": \"^11.1.0\",\n    \"yargs\": \"^17.7.2\",\n    \"zod\": \"^3.24.2\",\n    \"zod-to-json-schema\": \"^3.24.5\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"^2.28.1\",\n    \"@eslint/js\": \"^9.24.0\",\n    \"@langchain/core\": \"^0.3.45\",\n    \"@types/node\": \"^22.13.10\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@typescript-eslint/eslint-plugin\": \"^8.29.1\",\n    \"@typescript-eslint/parser\": \"^8.29.1\",\n    \"ai\": \"^4.2.8\",\n    \"eslint\": \"^9.24.0\",\n    \"eslint-config-prettier\": \"^10.1.2\",\n    \"eslint-import-resolver-typescript\": \"^4.3.2\",\n    \"eslint-plugin-import\": \"^2.31.0\",\n    \"eslint-plugin-prettier\": \"^5.2.6\",\n    \"openai\": \"^4.90.0\",\n    \"prettier\": \"^3.5.3\",\n    \"rimraf\": \"^6.0.1\",\n    \"ts-node\": \"^10.9.2\",\n    \"tsup\": \"^8.4.0\",\n    \"typescript\": \"^5.8.2\",\n    \"typescript-eslint\": \"^8.29.1\",\n    \"vitest\": \"^1.3.1\"\n  },\n  \"peerDependencies\": {\n    \"@mastra/core\": \"^0.10.3\",\n    \"ai\": \"^4.0.0\",\n    \"openai\": \"^4.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"ai\": {\n      \"optional\": true\n    }\n  },\n  \"engines\": {\n    \"node\": \">=20\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/knock-client-BH7Juvis.d.ts

@@ -1,10 +0,0 @@
-import KnockMgmt from '@knocklabs/mgmt';
-import { Knock } from '@knocklabs/node';
-import { Config } from './types.js';
-
-type KnockClient = ReturnType<typeof createKnockClient>;
-declare const createKnockClient: (config: Config) => KnockMgmt & {
-    publicApi: (environmentSlug?: string) => Promise<Knock>;
-};
-
-export type { KnockClient as K };