@dexto/tools-builtins 1.6.0

package/dist/implementations/list-resources-tool.cjs

@@ -0,0 +1,99 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var list_resources_tool_exports = {};
+__export(list_resources_tool_exports, {
+  createListResourcesTool: () => createListResourcesTool
+});
+module.exports = __toCommonJS(list_resources_tool_exports);
+var import_zod = require("zod");
+var import_core = require("@dexto/core");
+const ListResourcesInputSchema = import_zod.z.object({
+  source: import_zod.z.enum(["all", "tool", "user"]).optional().default("all").describe(
+    'Filter by source: "tool" for tool-generated resources, "user" for user-uploaded, "all" for both'
+  ),
+  kind: import_zod.z.enum(["all", "image", "audio", "video", "binary"]).optional().default("all").describe('Filter by type: "image", "audio", "video", "binary", or "all"'),
+  limit: import_zod.z.number().optional().default(50).describe("Maximum number of resources to return (default: 50)")
+}).strict();
+function createListResourcesTool() {
+  return (0, import_core.defineTool)({
+    id: "list_resources",
+    displayName: "List Resources",
+    description: "List available resources (images, files, etc.). Returns resource references that can be used with get_resource to obtain shareable URLs or metadata. Filter by source (tool/user) or kind (image/audio/video/binary).",
+    inputSchema: ListResourcesInputSchema,
+    async execute(input, context) {
+      const { source, kind, limit } = input;
+      const resourceManager = context.services?.resources;
+      if (!resourceManager) {
+        throw import_core.ToolError.configInvalid(
+          "list_resources requires ToolExecutionContext.services.resources"
+        );
+      }
+      try {
+        const blobStore = resourceManager.getBlobStore();
+        const allBlobs = await blobStore.listBlobs();
+        const resources = [];
+        for (const blob of allBlobs) {
+          if (blob.metadata.source === "system") {
+            continue;
+          }
+          if (source !== "all" && blob.metadata.source !== source) {
+            continue;
+          }
+          const mimeType = blob.metadata.mimeType;
+          let resourceKind = "binary";
+          if (mimeType.startsWith("image/")) resourceKind = "image";
+          else if (mimeType.startsWith("audio/")) resourceKind = "audio";
+          else if (mimeType.startsWith("video/")) resourceKind = "video";
+          if (kind !== "all" && resourceKind !== kind) {
+            continue;
+          }
+          resources.push({
+            reference: blob.uri,
+            kind: resourceKind,
+            mimeType: blob.metadata.mimeType,
+            ...blob.metadata.originalName && { filename: blob.metadata.originalName },
+            source: blob.metadata.source || "tool",
+            size: blob.metadata.size,
+            createdAt: blob.metadata.createdAt.toISOString()
+          });
+        }
+        resources.sort(
+          (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+        );
+        const limitedResources = resources.slice(0, limit);
+        return {
+          success: true,
+          count: limitedResources.length,
+          resources: limitedResources,
+          _hint: limitedResources.length > 0 ? "Use get_resource with a reference to get a shareable URL or metadata" : "No resources found matching the criteria"
+        };
+      } catch (error) {
+        return {
+          success: false,
+          error: `Failed to list resources: ${error instanceof Error ? error.message : String(error)}`,
+          resources: []
+        };
+      }
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createListResourcesTool
+});

package/dist/implementations/list-resources-tool.d.cts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { Tool } from '@dexto/core';
+
+declare const ListResourcesInputSchema: z.ZodObject<{
+    source: z.ZodDefault<z.ZodOptional<z.ZodEnum<["all", "tool", "user"]>>>;
+    kind: z.ZodDefault<z.ZodOptional<z.ZodEnum<["all", "image", "audio", "video", "binary"]>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strict", z.ZodTypeAny, {
+    kind: "all" | "image" | "audio" | "video" | "binary";
+    source: "all" | "user" | "tool";
+    limit: number;
+}, {
+    kind?: "all" | "image" | "audio" | "video" | "binary" | undefined;
+    source?: "all" | "user" | "tool" | undefined;
+    limit?: number | undefined;
+}>;
+/**
+ * Create the `list_resources` tool.
+ *
+ * Lists stored resources (backed by the configured BlobStore) and returns references
+ * that can be passed to `get_resource`.
+ * Requires `ToolExecutionContext.services.resources`.
+ */
+declare function createListResourcesTool(): Tool<typeof ListResourcesInputSchema>;
+
+export { createListResourcesTool };

package/dist/implementations/list-resources-tool.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { Tool } from '@dexto/core';
+declare const ListResourcesInputSchema: z.ZodObject<{
+    source: z.ZodDefault<z.ZodOptional<z.ZodEnum<["all", "tool", "user"]>>>;
+    kind: z.ZodDefault<z.ZodOptional<z.ZodEnum<["all", "image", "audio", "video", "binary"]>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strict", z.ZodTypeAny, {
+    kind: "all" | "image" | "audio" | "video" | "binary";
+    source: "user" | "tool" | "all";
+    limit: number;
+}, {
+    kind?: "all" | "image" | "audio" | "video" | "binary" | undefined;
+    source?: "user" | "tool" | "all" | undefined;
+    limit?: number | undefined;
+}>;
+/**
+ * Create the `list_resources` tool.
+ *
+ * Lists stored resources (backed by the configured BlobStore) and returns references
+ * that can be passed to `get_resource`.
+ * Requires `ToolExecutionContext.services.resources`.
+ */
+export declare function createListResourcesTool(): Tool<typeof ListResourcesInputSchema>;
+export {};
+//# sourceMappingURL=list-resources-tool.d.ts.map

package/dist/implementations/list-resources-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-resources-tool.d.ts","sourceRoot":"","sources":["../../src/implementations/list-resources-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAE9D,QAAA,MAAM,wBAAwB;;;;;;;;;;;;EAoBjB,CAAC;AAYd;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAAC,OAAO,wBAAwB,CAAC,CA8E/E"}

package/dist/implementations/list-resources-tool.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { ToolError, defineTool } from "@dexto/core";
+const ListResourcesInputSchema = z.object({
+  source: z.enum(["all", "tool", "user"]).optional().default("all").describe(
+    'Filter by source: "tool" for tool-generated resources, "user" for user-uploaded, "all" for both'
+  ),
+  kind: z.enum(["all", "image", "audio", "video", "binary"]).optional().default("all").describe('Filter by type: "image", "audio", "video", "binary", or "all"'),
+  limit: z.number().optional().default(50).describe("Maximum number of resources to return (default: 50)")
+}).strict();
+function createListResourcesTool() {
+  return defineTool({
+    id: "list_resources",
+    displayName: "List Resources",
+    description: "List available resources (images, files, etc.). Returns resource references that can be used with get_resource to obtain shareable URLs or metadata. Filter by source (tool/user) or kind (image/audio/video/binary).",
+    inputSchema: ListResourcesInputSchema,
+    async execute(input, context) {
+      const { source, kind, limit } = input;
+      const resourceManager = context.services?.resources;
+      if (!resourceManager) {
+        throw ToolError.configInvalid(
+          "list_resources requires ToolExecutionContext.services.resources"
+        );
+      }
+      try {
+        const blobStore = resourceManager.getBlobStore();
+        const allBlobs = await blobStore.listBlobs();
+        const resources = [];
+        for (const blob of allBlobs) {
+          if (blob.metadata.source === "system") {
+            continue;
+          }
+          if (source !== "all" && blob.metadata.source !== source) {
+            continue;
+          }
+          const mimeType = blob.metadata.mimeType;
+          let resourceKind = "binary";
+          if (mimeType.startsWith("image/")) resourceKind = "image";
+          else if (mimeType.startsWith("audio/")) resourceKind = "audio";
+          else if (mimeType.startsWith("video/")) resourceKind = "video";
+          if (kind !== "all" && resourceKind !== kind) {
+            continue;
+          }
+          resources.push({
+            reference: blob.uri,
+            kind: resourceKind,
+            mimeType: blob.metadata.mimeType,
+            ...blob.metadata.originalName && { filename: blob.metadata.originalName },
+            source: blob.metadata.source || "tool",
+            size: blob.metadata.size,
+            createdAt: blob.metadata.createdAt.toISOString()
+          });
+        }
+        resources.sort(
+          (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+        );
+        const limitedResources = resources.slice(0, limit);
+        return {
+          success: true,
+          count: limitedResources.length,
+          resources: limitedResources,
+          _hint: limitedResources.length > 0 ? "Use get_resource with a reference to get a shareable URL or metadata" : "No resources found matching the criteria"
+        };
+      } catch (error) {
+        return {
+          success: false,
+          error: `Failed to list resources: ${error instanceof Error ? error.message : String(error)}`,
+          resources: []
+        };
+      }
+    }
+  });
+}
+export {
+  createListResourcesTool
+};

package/dist/implementations/sleep-tool.cjs

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sleep_tool_exports = {};
+__export(sleep_tool_exports, {
+  createSleepTool: () => createSleepTool
+});
+module.exports = __toCommonJS(sleep_tool_exports);
+var import_zod = require("zod");
+var import_core = require("@dexto/core");
+const SleepInputSchema = import_zod.z.object({
+  ms: import_zod.z.number().int().positive().max(6e5).describe("Milliseconds to sleep (max 10 minutes)")
+}).strict();
+function createSleepTool() {
+  return (0, import_core.defineTool)({
+    id: "sleep",
+    displayName: "Sleep",
+    description: "Pause execution for a specified number of milliseconds.",
+    inputSchema: SleepInputSchema,
+    async execute(input, _context) {
+      const { ms } = input;
+      await new Promise((resolve) => setTimeout(resolve, ms));
+      return { sleptMs: ms };
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSleepTool
+});

package/dist/implementations/sleep-tool.d.cts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { Tool } from '@dexto/core';
+
+declare const SleepInputSchema: z.ZodObject<{
+    ms: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    ms: number;
+}, {
+    ms: number;
+}>;
+/**
+ * Internal tool for sleeping/delaying execution.
+ */
+declare function createSleepTool(): Tool<typeof SleepInputSchema>;
+
+export { createSleepTool };

package/dist/implementations/sleep-tool.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { Tool } from '@dexto/core';
+declare const SleepInputSchema: z.ZodObject<{
+    ms: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    ms: number;
+}, {
+    ms: number;
+}>;
+/**
+ * Internal tool for sleeping/delaying execution.
+ */
+export declare function createSleepTool(): Tool<typeof SleepInputSchema>;
+export {};
+//# sourceMappingURL=sleep-tool.d.ts.map

package/dist/implementations/sleep-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-tool.d.ts","sourceRoot":"","sources":["../../src/implementations/sleep-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAE9D,QAAA,MAAM,gBAAgB;;;;;;EAST,CAAC;AAEd;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAY/D"}

package/dist/implementations/sleep-tool.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { defineTool } from "@dexto/core";
+const SleepInputSchema = z.object({
+  ms: z.number().int().positive().max(6e5).describe("Milliseconds to sleep (max 10 minutes)")
+}).strict();
+function createSleepTool() {
+  return defineTool({
+    id: "sleep",
+    displayName: "Sleep",
+    description: "Pause execution for a specified number of milliseconds.",
+    inputSchema: SleepInputSchema,
+    async execute(input, _context) {
+      const { ms } = input;
+      await new Promise((resolve) => setTimeout(resolve, ms));
+      return { sleptMs: ms };
+    }
+  });
+}
+export {
+  createSleepTool
+};

package/dist/index.cjs

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  BUILTIN_TOOL_NAMES: () => import_builtin_tools_factory2.BUILTIN_TOOL_NAMES,
+  BuiltinToolsConfigSchema: () => import_builtin_tools_factory.BuiltinToolsConfigSchema,
+  builtinToolsFactory: () => import_builtin_tools_factory.builtinToolsFactory
+});
+module.exports = __toCommonJS(index_exports);
+var import_builtin_tools_factory = require("./builtin-tools-factory.js");
+var import_builtin_tools_factory2 = require("./builtin-tools-factory.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BUILTIN_TOOL_NAMES,
+  BuiltinToolsConfigSchema,
+  builtinToolsFactory
+});

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+export { BUILTIN_TOOL_NAMES, BuiltinToolName, BuiltinToolsConfig, BuiltinToolsConfigSchema, builtinToolsFactory } from './builtin-tools-factory.cjs';
+import 'zod';
+import '@dexto/agent-config';

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @dexto/tools-builtins
+ *
+ * Built-in tools shipped with Dexto.
+ * These are always available to an agent and can be enabled/disabled via config.
+ *
+ * Tool IDs:
+ * - ask_user
+ * - delegate_to_url
+ * - list_resources
+ * - get_resource
+ * - invoke_skill
+ */
+export { builtinToolsFactory, BuiltinToolsConfigSchema } from './builtin-tools-factory.js';
+export { BUILTIN_TOOL_NAMES } from './builtin-tools-factory.js';
+export type { BuiltinToolsConfig, BuiltinToolName } from './builtin-tools-factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import { builtinToolsFactory, BuiltinToolsConfigSchema } from "./builtin-tools-factory.js";
+import { BUILTIN_TOOL_NAMES } from "./builtin-tools-factory.js";
+export {
+  BUILTIN_TOOL_NAMES,
+  BuiltinToolsConfigSchema,
+  builtinToolsFactory
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@dexto/tools-builtins",
+  "version": "1.6.0",
+  "description": "Built-in tools factory for Dexto agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "dexto",
+    "tools",
+    "builtins"
+  ],
+  "dependencies": {
+    "undici": "^7.22.0",
+    "zod": "^3.25.0",
+    "@dexto/agent-config": "1.6.0",
+    "@dexto/core": "1.6.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}