@knocklabs/agent-toolkit 0.1.1 → 0.1.2

package/dist/lib/tools/environments.js

@@ -0,0 +1,52 @@
+// 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)
+  };
+};
+
+// src/lib/tools/environments.ts
+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.
+  `,
+  execute: (knockClient) => async (params) => {
+    const allEnvironments = [];
+    for await (const environment of knockClient.environments.list()) {
+      allEnvironments.push(environment);
+    }
+    return allEnvironments;
+  }
+});
+var environments = {
+  listEnvironments
+};
+var permissions = {
+  read: ["listEnvironments"]
+};
+export {
+  environments,
+  permissions
+};
+//# sourceMappingURL=environments.js.map

package/dist/lib/tools/environments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/knock-tool.ts","../../../src/lib/tools/environments.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","import { Environment } from \"@knocklabs/mgmt/resources/environments.js\";\nimport { KnockTool } from \"../knock-tool.js\";\n\nconst listEnvironments = KnockTool({\n  method: \"list_environments\",\n  name: \"List environments\",\n  description: `\n  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.\n  `,\n  execute: (knockClient) => async (params) => {\n    const allEnvironments: Environment[] = [];\n    for await (const environment of knockClient.environments.list()) {\n      allEnvironments.push(environment);\n    }\n    return allEnvironments;\n  },\n});\n\nexport const environments = {\n  listEnvironments,\n};\n\nexport const permissions = {\n  read: [\"listEnvironments\"],\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;;;ACtFA,IAAM,mBAAmB,UAAU;AAAA,EACjC,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,aAAa;AAAA;AAAA;AAAA,EAGb,SAAS,CAAC,gBAAgB,OAAO,WAAW;AAC1C,UAAM,kBAAiC,CAAC;AACxC,qBAAiB,eAAe,YAAY,aAAa,KAAK,GAAG;AAC/D,sBAAgB,KAAK,WAAW;AAAA,IAClC;AACA,WAAO;AAAA,EACT;AACF,CAAC;AAEM,IAAM,eAAe;AAAA,EAC1B;AACF;AAEO,IAAM,cAAc;AAAA,EACzB,MAAM,CAAC,kBAAkB;AAC3B;","names":[]}

package/dist/lib/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { f as allTools, t as toolPermissions, e as tools } from '../../types-B-9pppCQ.js';
+import 'zod';
+import '@knocklabs/node';
+import '@knocklabs/mgmt';