@dexto/core 1.4.0 → 1.5.0

package/dist/tools/index.d.ts

@@ -7,6 +7,10 @@
 export * from './types.js';
 export * from './display-types.js';
 export * from './internal-tools/index.js';
+export { customToolRegistry, type CustomToolProvider, type CustomToolRegistry, type ToolCreationContext, } from './custom-tool-registry.js';
+export { customToolSchemaRegistry } from './custom-tool-schema-registry.js';
 export * from './schemas.js';
+export { ToolError } from './errors.js';
+export { ToolErrorCode } from './error-codes.js';
 export { ToolManager, type InternalToolsOptions } from './tool-manager.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,WAAW,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,2BAA2B,CAAC;AAG1C,OAAO,EACH,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/index.js

@@ -2,8 +2,18 @@ import "../chunk-PTJYTZNU.js";
 export * from "./types.js";
 export * from "./display-types.js";
 export * from "./internal-tools/index.js";
+import {
+  customToolRegistry
+} from "./custom-tool-registry.js";
+import { customToolSchemaRegistry } from "./custom-tool-schema-registry.js";
 export * from "./schemas.js";
+import { ToolError } from "./errors.js";
+import { ToolErrorCode } from "./error-codes.js";
 import { ToolManager } from "./tool-manager.js";
 export {
-  ToolManager
+  ToolError,
+  ToolErrorCode,
+  ToolManager,
+  customToolRegistry,
+  customToolSchemaRegistry
 };

package/dist/tools/internal-tools/constants.cjs

@@ -24,15 +24,9 @@ module.exports = __toCommonJS(constants_exports);
 const INTERNAL_TOOL_NAMES = [
   "search_history",
   "ask_user",
-  "read_file",
-  "glob_files",
-  "grep_content",
-  "write_file",
-  "edit_file",
-  "bash_exec",
-  "bash_output",
-  "kill_process",
-  "delegate_to_url"
+  "delegate_to_url",
+  "list_resources",
+  "get_resource"
 ];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/tools/internal-tools/constants.d.ts

@@ -7,6 +7,6 @@
  * Available internal tool names
  * Must be kept in sync with INTERNAL_TOOL_REGISTRY in registry.ts
  */
-export declare const INTERNAL_TOOL_NAMES: readonly ["search_history", "ask_user", "read_file", "glob_files", "grep_content", "write_file", "edit_file", "bash_exec", "bash_output", "kill_process", "delegate_to_url"];
+export declare const INTERNAL_TOOL_NAMES: readonly ["search_history", "ask_user", "delegate_to_url", "list_resources", "get_resource"];
 export type KnownInternalTool = (typeof INTERNAL_TOOL_NAMES)[number];
 //# sourceMappingURL=constants.d.ts.map

package/dist/tools/internal-tools/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8KAYtB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8FAMtB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tools/internal-tools/constants.js

@@ -2,15 +2,9 @@ import "../../chunk-PTJYTZNU.js";
 const INTERNAL_TOOL_NAMES = [
   "search_history",
   "ask_user",
-  "read_file",
-  "glob_files",
-  "grep_content",
-  "write_file",
-  "edit_file",
-  "bash_exec",
-  "bash_output",
-  "kill_process",
-  "delegate_to_url"
+  "delegate_to_url",
+  "list_resources",
+  "get_resource"
 ];
 export {
   INTERNAL_TOOL_NAMES

package/dist/tools/internal-tools/implementations/get-resource-tool.cjs

@@ -0,0 +1,113 @@
+"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 get_resource_tool_exports = {};
+__export(get_resource_tool_exports, {
+  createGetResourceTool: () => createGetResourceTool
+});
+module.exports = __toCommonJS(get_resource_tool_exports);
+var import_zod = require("zod");
+const GetResourceInputSchema = import_zod.z.object({
+  reference: import_zod.z.string().describe(
+    'The resource reference to access. Formats: "blob:abc123" (from list_resources), "resource_ref:blob:abc123" (from tool annotations)'
+  ),
+  format: import_zod.z.enum(["url", "metadata"]).default("url").describe(
+    'Output format: "url" for a shareable URL (requires remote storage like Supabase), "metadata" for resource information without loading the data'
+  )
+}).strict();
+function createGetResourceTool(resourceManager) {
+  return {
+    id: "get_resource",
+    description: 'Access a stored resource. Use format "url" to get a shareable URL for other agents or external systems (requires remote storage like Supabase). Use format "metadata" to get resource information without loading data. References can be obtained from tool result annotations or list_resources.',
+    inputSchema: GetResourceInputSchema,
+    execute: async (input, _context) => {
+      const { reference, format } = input;
+      try {
+        const blobStore = resourceManager.getBlobStore();
+        const storeType = blobStore.getStoreType();
+        let blobUri = reference;
+        if (blobUri.startsWith("resource_ref:")) {
+          blobUri = blobUri.substring("resource_ref:".length);
+        }
+        if (blobUri.startsWith("@")) {
+          blobUri = blobUri.substring(1);
+        }
+        if (!blobUri.startsWith("blob:")) {
+          blobUri = `blob:${blobUri}`;
+        }
+        const exists = await blobStore.exists(blobUri);
+        if (!exists) {
+          return {
+            success: false,
+            error: `Resource not found: ${reference}`,
+            _hint: "Use list_resources to see available resources"
+          };
+        }
+        if (format === "metadata") {
+          const allBlobs = await blobStore.listBlobs();
+          const blobRef = allBlobs.find((b) => b.uri === blobUri);
+          if (!blobRef) {
+            return {
+              success: false,
+              error: `Resource metadata not found: ${reference}`,
+              _hint: "Use list_resources to see available resources"
+            };
+          }
+          return {
+            success: true,
+            format: "metadata",
+            reference: blobUri,
+            mimeType: blobRef.metadata.mimeType,
+            size: blobRef.metadata.size,
+            filename: blobRef.metadata.originalName,
+            source: blobRef.metadata.source,
+            createdAt: blobRef.metadata.createdAt.toISOString()
+          };
+        }
+        if (storeType === "memory" || storeType === "local") {
+          return {
+            success: false,
+            error: "URL generation not available with local/memory storage",
+            _hint: "Configure remote storage (e.g., Supabase) in your agent config to enable URL sharing. Local storage cannot generate shareable URLs.",
+            storeType
+          };
+        }
+        const blob = await blobStore.retrieve(blobUri, "url");
+        return {
+          success: true,
+          format: "url",
+          url: blob.data,
+          reference: blobUri,
+          mimeType: blob.metadata.mimeType,
+          size: blob.metadata.size,
+          filename: blob.metadata.originalName
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          success: false,
+          error: `Failed to access resource: ${message}`
+        };
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGetResourceTool
+});

package/dist/tools/internal-tools/implementations/get-resource-tool.d.ts

@@ -0,0 +1,30 @@
+import { InternalTool } from '../../types.js';
+import type { ResourceManager } from '../../../resources/manager.js';
+/**
+ * Internal tool for accessing resources.
+ *
+ * This tool provides access to stored resources (images, files, etc.) in formats
+ * suitable for sharing or inspection, without loading binary data into context.
+ *
+ * Formats:
+ * - `url`: Returns a shareable URL. Requires remote storage (e.g., Supabase).
+ *          Local/memory storage does not support URL generation.
+ * - `metadata`: Returns resource information (size, mimeType, filename, etc.)
+ *               without loading the actual data.
+ *
+ * Design principle: Resources exist to keep binary data OUT of the context window.
+ * This tool never returns base64 or raw data - use URLs for sharing instead.
+ *
+ * @example
+ * ```typescript
+ * // Get a shareable URL for an image
+ * get_resource({ reference: 'blob:abc123', format: 'url' })
+ * → { success: true, url: 'https://...', mimeType: 'image/png', ... }
+ *
+ * // Get metadata about a resource
+ * get_resource({ reference: 'blob:abc123', format: 'metadata' })
+ * → { success: true, mimeType: 'image/png', size: 12345, filename: '...', ... }
+ * ```
+ */
+export declare function createGetResourceTool(resourceManager: ResourceManager): InternalTool;
+//# sourceMappingURL=get-resource-tool.d.ts.map

package/dist/tools/internal-tools/implementations/get-resource-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-resource-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/internal-tools/implementations/get-resource-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAyBrE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,eAAe,GAAG,YAAY,CA2GpF"}

package/dist/tools/internal-tools/implementations/get-resource-tool.js

@@ -0,0 +1,90 @@
+import "../../../chunk-PTJYTZNU.js";
+import { z } from "zod";
+const GetResourceInputSchema = z.object({
+  reference: z.string().describe(
+    'The resource reference to access. Formats: "blob:abc123" (from list_resources), "resource_ref:blob:abc123" (from tool annotations)'
+  ),
+  format: z.enum(["url", "metadata"]).default("url").describe(
+    'Output format: "url" for a shareable URL (requires remote storage like Supabase), "metadata" for resource information without loading the data'
+  )
+}).strict();
+function createGetResourceTool(resourceManager) {
+  return {
+    id: "get_resource",
+    description: 'Access a stored resource. Use format "url" to get a shareable URL for other agents or external systems (requires remote storage like Supabase). Use format "metadata" to get resource information without loading data. References can be obtained from tool result annotations or list_resources.',
+    inputSchema: GetResourceInputSchema,
+    execute: async (input, _context) => {
+      const { reference, format } = input;
+      try {
+        const blobStore = resourceManager.getBlobStore();
+        const storeType = blobStore.getStoreType();
+        let blobUri = reference;
+        if (blobUri.startsWith("resource_ref:")) {
+          blobUri = blobUri.substring("resource_ref:".length);
+        }
+        if (blobUri.startsWith("@")) {
+          blobUri = blobUri.substring(1);
+        }
+        if (!blobUri.startsWith("blob:")) {
+          blobUri = `blob:${blobUri}`;
+        }
+        const exists = await blobStore.exists(blobUri);
+        if (!exists) {
+          return {
+            success: false,
+            error: `Resource not found: ${reference}`,
+            _hint: "Use list_resources to see available resources"
+          };
+        }
+        if (format === "metadata") {
+          const allBlobs = await blobStore.listBlobs();
+          const blobRef = allBlobs.find((b) => b.uri === blobUri);
+          if (!blobRef) {
+            return {
+              success: false,
+              error: `Resource metadata not found: ${reference}`,
+              _hint: "Use list_resources to see available resources"
+            };
+          }
+          return {
+            success: true,
+            format: "metadata",
+            reference: blobUri,
+            mimeType: blobRef.metadata.mimeType,
+            size: blobRef.metadata.size,
+            filename: blobRef.metadata.originalName,
+            source: blobRef.metadata.source,
+            createdAt: blobRef.metadata.createdAt.toISOString()
+          };
+        }
+        if (storeType === "memory" || storeType === "local") {
+          return {
+            success: false,
+            error: "URL generation not available with local/memory storage",
+            _hint: "Configure remote storage (e.g., Supabase) in your agent config to enable URL sharing. Local storage cannot generate shareable URLs.",
+            storeType
+          };
+        }
+        const blob = await blobStore.retrieve(blobUri, "url");
+        return {
+          success: true,
+          format: "url",
+          url: blob.data,
+          reference: blobUri,
+          mimeType: blob.metadata.mimeType,
+          size: blob.metadata.size,
+          filename: blob.metadata.originalName
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          success: false,
+          error: `Failed to access resource: ${message}`
+        };
+      }
+    }
+  };
+}
+export {
+  createGetResourceTool
+};

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

@@ -0,0 +1,91 @@
+"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");
+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(resourceManager) {
+  return {
+    id: "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,
+    execute: async (input, _context) => {
+      const { source, kind, limit } = input;
+      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/tools/internal-tools/implementations/list-resources-tool.d.ts

@@ -0,0 +1,24 @@
+import { InternalTool } from '../../types.js';
+import type { ResourceManager } from '../../../resources/manager.js';
+/**
+ * Internal tool for listing available resources.
+ *
+ * This tool allows agents to discover what resources (images, files, etc.) are
+ * available. Use this to find resources that can be accessed with get_resource.
+ *
+ * Resources are stored blobs from:
+ * - Tool results (images generated by tools, screenshots, etc.)
+ * - User uploads (files attached to messages)
+ *
+ * @example
+ * ```typescript
+ * // List all tool-generated images
+ * list_resources({ source: 'tool', kind: 'image' })
+ * → { resources: [{ reference: 'blob:abc123', kind: 'image', ... }] }
+ *
+ * // Get a URL for sharing
+ * get_resource({ reference: 'blob:abc123', format: 'url' })
+ * ```
+ */
+export declare function createListResourcesTool(resourceManager: ResourceManager): InternalTool;
+//# sourceMappingURL=list-resources-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-resources-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/internal-tools/implementations/list-resources-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAqDrE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,eAAe,GAAG,YAAY,CA8EtF"}

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

@@ -0,0 +1,68 @@
+import "../../../chunk-PTJYTZNU.js";
+import { z } from "zod";
+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(resourceManager) {
+  return {
+    id: "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,
+    execute: async (input, _context) => {
+      const { source, kind, limit } = input;
+      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
+};