@dexto/core 1.4.0 → 1.5.0

package/dist/tools/custom-tool-registry.js

@@ -0,0 +1,40 @@
+import "../chunk-PTJYTZNU.js";
+import { ToolError } from "./errors.js";
+import { BaseRegistry } from "../providers/base-registry.js";
+import { customToolSchemaRegistry } from "./custom-tool-schema-registry.js";
+const customToolErrorFactory = {
+  alreadyRegistered: (type) => ToolError.customToolProviderAlreadyRegistered(type),
+  notFound: (type, availableTypes) => ToolError.unknownCustomToolProvider(type, availableTypes)
+};
+class CustomToolRegistry extends BaseRegistry {
+  constructor() {
+    super(customToolErrorFactory);
+  }
+  /**
+   * Register a custom tool provider.
+   * Also registers the provider's config schema for early validation.
+   *
+   * @param provider - The custom tool provider to register
+   * @throws Error if a provider with the same type is already registered
+   */
+  register(provider) {
+    super.register(provider);
+    customToolSchemaRegistry.register(provider.type, provider.configSchema);
+  }
+  /**
+   * Unregister a custom tool provider.
+   * Note: This does NOT unregister the schema from customToolSchemaRegistry
+   * to avoid breaking active configs that reference the schema.
+   *
+   * @param type - The provider type to unregister
+   * @returns true if the provider was unregistered, false if it wasn't registered
+   */
+  unregister(type) {
+    return super.unregister(type);
+  }
+}
+const customToolRegistry = new CustomToolRegistry();
+export {
+  CustomToolRegistry,
+  customToolRegistry
+};

package/dist/tools/custom-tool-schema-registry.cjs

@@ -0,0 +1,164 @@
+"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 custom_tool_schema_registry_exports = {};
+__export(custom_tool_schema_registry_exports, {
+  customToolSchemaRegistry: () => customToolSchemaRegistry,
+  getCustomToolSchemaRegistry: () => getCustomToolSchemaRegistry
+});
+module.exports = __toCommonJS(custom_tool_schema_registry_exports);
+var import_zod = require("zod");
+var import_types = require("../logger/v2/types.js");
+const createNoOpLogger = () => {
+  const noOpLogger = {
+    debug: () => {
+    },
+    info: () => {
+    },
+    warn: () => {
+    },
+    error: () => {
+    },
+    silly: () => {
+    },
+    trackException: () => {
+    },
+    setLevel: () => {
+    },
+    getLevel: () => "info",
+    getLogFilePath: () => null,
+    destroy: () => Promise.resolve(),
+    createChild: () => noOpLogger
+  };
+  return noOpLogger;
+};
+class CustomToolSchemaRegistry {
+  schemas = /* @__PURE__ */ new Map();
+  logger;
+  constructor(logger) {
+    this.logger = logger;
+  }
+  /**
+   * Register a provider's config schema.
+   * Called automatically when a custom tool provider is registered.
+   *
+   * @param type Provider type (must match the 'type' field in config)
+   * @param schema Zod schema for the provider's configuration
+   *
+   * @throws Error if schema is already registered for this type
+   */
+  register(type, schema) {
+    if (this.schemas.has(type)) {
+      throw new Error(`Config schema already registered for provider type: ${type}`);
+    }
+    this.schemas.set(type, schema);
+    this.logger.debug(`Registered config schema for provider: ${type}`);
+  }
+  /**
+   * Get a provider's config schema.
+   *
+   * @param type Provider type
+   * @returns The registered schema, or undefined if not found
+   */
+  get(type) {
+    return this.schemas.get(type);
+  }
+  /**
+   * Check if a provider type has a registered schema.
+   *
+   * @param type Provider type
+   * @returns true if schema is registered
+   */
+  has(type) {
+    return this.schemas.has(type);
+  }
+  /**
+   * Get all registered provider types.
+   *
+   * @returns Array of provider type strings
+   */
+  getRegisteredTypes() {
+    return Array.from(this.schemas.keys());
+  }
+  /**
+   * Create a discriminated union schema for all registered providers.
+   * This enables early validation of provider-specific fields at config load time.
+   *
+   * The union is discriminated by the 'type' field, which provides better error
+   * messages when validation fails.
+   *
+   * @returns Discriminated union schema if providers are registered,
+   *          passthrough schema otherwise (for backward compatibility)
+   */
+  createUnionSchema() {
+    const types = this.getRegisteredTypes();
+    if (types.length === 0) {
+      this.logger.debug(
+        "No provider schemas registered - using passthrough schema for custom tools"
+      );
+      return import_zod.z.object({
+        type: import_zod.z.string().describe("Custom tool provider type")
+      }).passthrough().describe(
+        "Custom tool provider configuration (no schemas registered - validation deferred to runtime)"
+      );
+    }
+    const schemas = [];
+    for (const type of types) {
+      const schema = this.get(type);
+      if (schema) {
+        schemas.push(schema);
+      }
+    }
+    if (schemas.length === 0) {
+      this.logger.warn("No schemas found despite having registered types");
+      return import_zod.z.object({
+        type: import_zod.z.string()
+      }).passthrough();
+    }
+    if (schemas.length === 1) {
+      this.logger.debug(`Using single provider schema: ${types[0]}`);
+      return schemas[0];
+    }
+    this.logger.debug(
+      `Creating union schema for ${schemas.length} providers: ${types.join(", ")}`
+    );
+    return import_zod.z.union(schemas);
+  }
+  /**
+   * Clear all registered schemas.
+   * Primarily used for testing.
+   */
+  clear() {
+    this.schemas.clear();
+    this.logger.debug("Cleared all registered provider schemas");
+  }
+}
+let globalInstance;
+function getCustomToolSchemaRegistry(logger) {
+  if (!globalInstance) {
+    const registryLogger = logger ? logger.createChild(import_types.DextoLogComponent.TOOLS) : createNoOpLogger();
+    globalInstance = new CustomToolSchemaRegistry(registryLogger);
+  }
+  return globalInstance;
+}
+const customToolSchemaRegistry = getCustomToolSchemaRegistry();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  customToolSchemaRegistry,
+  getCustomToolSchemaRegistry
+});

package/dist/tools/custom-tool-schema-registry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Custom Tool Schema Registry
+ *
+ * Registry for custom tool provider configuration schemas.
+ * Allows core to validate provider-specific fields at config load time
+ * by building a discriminated union of all registered schemas.
+ *
+ * Architecture:
+ * 1. Providers register their config schemas when they register with customToolRegistry
+ * 2. Core uses this registry to build a discriminated union schema at runtime
+ * 3. Agent config validation uses the union to validate provider-specific fields early
+ *
+ * Benefits:
+ * - Early validation (at config load time, not runtime)
+ * - Type safety (full Zod validation for all provider fields)
+ * - IDE support (TypeScript knows all provider fields)
+ * - Single source of truth (provider schema defines everything)
+ */
+import { z } from 'zod';
+import type { IDextoLogger } from '../logger/v2/types.js';
+declare class CustomToolSchemaRegistry {
+    private schemas;
+    private logger;
+    constructor(logger: IDextoLogger);
+    /**
+     * Register a provider's config schema.
+     * Called automatically when a custom tool provider is registered.
+     *
+     * @param type Provider type (must match the 'type' field in config)
+     * @param schema Zod schema for the provider's configuration
+     *
+     * @throws Error if schema is already registered for this type
+     */
+    register<T extends z.ZodType<any>>(type: string, schema: T): void;
+    /**
+     * Get a provider's config schema.
+     *
+     * @param type Provider type
+     * @returns The registered schema, or undefined if not found
+     */
+    get(type: string): z.ZodType<any> | undefined;
+    /**
+     * Check if a provider type has a registered schema.
+     *
+     * @param type Provider type
+     * @returns true if schema is registered
+     */
+    has(type: string): boolean;
+    /**
+     * Get all registered provider types.
+     *
+     * @returns Array of provider type strings
+     */
+    getRegisteredTypes(): string[];
+    /**
+     * Create a discriminated union schema for all registered providers.
+     * This enables early validation of provider-specific fields at config load time.
+     *
+     * The union is discriminated by the 'type' field, which provides better error
+     * messages when validation fails.
+     *
+     * @returns Discriminated union schema if providers are registered,
+     *          passthrough schema otherwise (for backward compatibility)
+     */
+    createUnionSchema(): z.ZodType<any>;
+    /**
+     * Clear all registered schemas.
+     * Primarily used for testing.
+     */
+    clear(): void;
+}
+/**
+ * Get the global custom tool schema registry instance.
+ * Creates it on first access with the provided logger.
+ *
+ * @param logger Optional logger for the registry (only used on first access)
+ * @returns The global registry instance
+ */
+export declare function getCustomToolSchemaRegistry(logger?: IDextoLogger): CustomToolSchemaRegistry;
+/**
+ * Global custom tool schema registry instance.
+ * Use this for registering and retrieving provider config schemas.
+ */
+export declare const customToolSchemaRegistry: CustomToolSchemaRegistry;
+export {};
+//# sourceMappingURL=custom-tool-schema-registry.d.ts.map

package/dist/tools/custom-tool-schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tool-schema-registry.d.ts","sourceRoot":"","sources":["../../src/tools/custom-tool-schema-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA8B1D,cAAM,wBAAwB;IAC1B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAIhC;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IAQjE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS;IAI7C;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;;;;;;OASG;IACH,iBAAiB,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAsDnC;;;OAGG;IACH,KAAK,IAAI,IAAI;CAIhB;AAMD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,wBAAwB,CAQ3F;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,0BAAgC,CAAC"}

package/dist/tools/custom-tool-schema-registry.js

@@ -0,0 +1,140 @@
+import "../chunk-PTJYTZNU.js";
+import { z } from "zod";
+import { DextoLogComponent } from "../logger/v2/types.js";
+const createNoOpLogger = () => {
+  const noOpLogger = {
+    debug: () => {
+    },
+    info: () => {
+    },
+    warn: () => {
+    },
+    error: () => {
+    },
+    silly: () => {
+    },
+    trackException: () => {
+    },
+    setLevel: () => {
+    },
+    getLevel: () => "info",
+    getLogFilePath: () => null,
+    destroy: () => Promise.resolve(),
+    createChild: () => noOpLogger
+  };
+  return noOpLogger;
+};
+class CustomToolSchemaRegistry {
+  schemas = /* @__PURE__ */ new Map();
+  logger;
+  constructor(logger) {
+    this.logger = logger;
+  }
+  /**
+   * Register a provider's config schema.
+   * Called automatically when a custom tool provider is registered.
+   *
+   * @param type Provider type (must match the 'type' field in config)
+   * @param schema Zod schema for the provider's configuration
+   *
+   * @throws Error if schema is already registered for this type
+   */
+  register(type, schema) {
+    if (this.schemas.has(type)) {
+      throw new Error(`Config schema already registered for provider type: ${type}`);
+    }
+    this.schemas.set(type, schema);
+    this.logger.debug(`Registered config schema for provider: ${type}`);
+  }
+  /**
+   * Get a provider's config schema.
+   *
+   * @param type Provider type
+   * @returns The registered schema, or undefined if not found
+   */
+  get(type) {
+    return this.schemas.get(type);
+  }
+  /**
+   * Check if a provider type has a registered schema.
+   *
+   * @param type Provider type
+   * @returns true if schema is registered
+   */
+  has(type) {
+    return this.schemas.has(type);
+  }
+  /**
+   * Get all registered provider types.
+   *
+   * @returns Array of provider type strings
+   */
+  getRegisteredTypes() {
+    return Array.from(this.schemas.keys());
+  }
+  /**
+   * Create a discriminated union schema for all registered providers.
+   * This enables early validation of provider-specific fields at config load time.
+   *
+   * The union is discriminated by the 'type' field, which provides better error
+   * messages when validation fails.
+   *
+   * @returns Discriminated union schema if providers are registered,
+   *          passthrough schema otherwise (for backward compatibility)
+   */
+  createUnionSchema() {
+    const types = this.getRegisteredTypes();
+    if (types.length === 0) {
+      this.logger.debug(
+        "No provider schemas registered - using passthrough schema for custom tools"
+      );
+      return z.object({
+        type: z.string().describe("Custom tool provider type")
+      }).passthrough().describe(
+        "Custom tool provider configuration (no schemas registered - validation deferred to runtime)"
+      );
+    }
+    const schemas = [];
+    for (const type of types) {
+      const schema = this.get(type);
+      if (schema) {
+        schemas.push(schema);
+      }
+    }
+    if (schemas.length === 0) {
+      this.logger.warn("No schemas found despite having registered types");
+      return z.object({
+        type: z.string()
+      }).passthrough();
+    }
+    if (schemas.length === 1) {
+      this.logger.debug(`Using single provider schema: ${types[0]}`);
+      return schemas[0];
+    }
+    this.logger.debug(
+      `Creating union schema for ${schemas.length} providers: ${types.join(", ")}`
+    );
+    return z.union(schemas);
+  }
+  /**
+   * Clear all registered schemas.
+   * Primarily used for testing.
+   */
+  clear() {
+    this.schemas.clear();
+    this.logger.debug("Cleared all registered provider schemas");
+  }
+}
+let globalInstance;
+function getCustomToolSchemaRegistry(logger) {
+  if (!globalInstance) {
+    const registryLogger = logger ? logger.createChild(DextoLogComponent.TOOLS) : createNoOpLogger();
+    globalInstance = new CustomToolSchemaRegistry(registryLogger);
+  }
+  return globalInstance;
+}
+const customToolSchemaRegistry = getCustomToolSchemaRegistry();
+export {
+  customToolSchemaRegistry,
+  getCustomToolSchemaRegistry
+};

package/dist/tools/error-codes.cjs

@@ -25,6 +25,7 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["EXECUTION_DENIED"] = "tools_execution_denied";
   ToolErrorCode2["EXECUTION_TIMEOUT"] = "tools_execution_timeout";
   ToolErrorCode2["EXECUTION_FAILED"] = "tools_execution_failed";
+  ToolErrorCode2["DIRECTORY_ACCESS_DENIED"] = "tools_directory_access_denied";
   ToolErrorCode2["VALIDATION_FAILED"] = "tools_validation_failed";
   ToolErrorCode2["CONFIRMATION_HANDLER_MISSING"] = "tools_confirmation_handler_missing";
   ToolErrorCode2["CONFIRMATION_TIMEOUT"] = "tools_confirmation_timeout";
@@ -34,6 +35,8 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["TOOL_UNAUTHORIZED"] = "tools_unauthorized";
   ToolErrorCode2["CONFIG_INVALID"] = "tools_config_invalid";
   ToolErrorCode2["FEATURE_DISABLED"] = "tools_feature_disabled";
+  ToolErrorCode2["CUSTOM_TOOL_PROVIDER_UNKNOWN"] = "tools_custom_provider_unknown";
+  ToolErrorCode2["CUSTOM_TOOL_PROVIDER_ALREADY_REGISTERED"] = "tools_custom_provider_already_registered";
   return ToolErrorCode2;
 })(ToolErrorCode || {});
 // Annotate the CommonJS export names for ESM import in node:

package/dist/tools/error-codes.d.ts

@@ -6,6 +6,7 @@ export declare enum ToolErrorCode {
     EXECUTION_DENIED = "tools_execution_denied",
     EXECUTION_TIMEOUT = "tools_execution_timeout",
     EXECUTION_FAILED = "tools_execution_failed",
+    DIRECTORY_ACCESS_DENIED = "tools_directory_access_denied",
     VALIDATION_FAILED = "tools_validation_failed",
     CONFIRMATION_HANDLER_MISSING = "tools_confirmation_handler_missing",
     CONFIRMATION_TIMEOUT = "tools_confirmation_timeout",
@@ -14,6 +15,8 @@ export declare enum ToolErrorCode {
     TOOL_INVALID_ARGS = "tools_invalid_args",
     TOOL_UNAUTHORIZED = "tools_unauthorized",
     CONFIG_INVALID = "tools_config_invalid",
-    FEATURE_DISABLED = "tools_feature_disabled"
+    FEATURE_DISABLED = "tools_feature_disabled",
+    CUSTOM_TOOL_PROVIDER_UNKNOWN = "tools_custom_provider_unknown",
+    CUSTOM_TOOL_PROVIDER_ALREADY_REGISTERED = "tools_custom_provider_already_registered"
 }
 //# sourceMappingURL=error-codes.d.ts.map

package/dist/tools/error-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/tools/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,aAAa;IAErB,gBAAgB,2BAA2B;IAC3C,iBAAiB,4BAA4B;IAC7C,gBAAgB,2BAA2B;IAG3C,iBAAiB,4BAA4B;IAG7C,4BAA4B,uCAAuC;IACnE,oBAAoB,+BAA+B;IACnD,sBAAsB,iCAAiC;IAGvD,cAAc,yBAAyB;IACvC,iBAAiB,uBAAuB;IACxC,iBAAiB,uBAAuB;IAGxC,cAAc,yBAAyB;IACvC,gBAAgB,2BAA2B;CAC9C"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/tools/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,aAAa;IAErB,gBAAgB,2BAA2B;IAC3C,iBAAiB,4BAA4B;IAC7C,gBAAgB,2BAA2B;IAC3C,uBAAuB,kCAAkC;IAGzD,iBAAiB,4BAA4B;IAG7C,4BAA4B,uCAAuC;IACnE,oBAAoB,+BAA+B;IACnD,sBAAsB,iCAAiC;IAGvD,cAAc,yBAAyB;IACvC,iBAAiB,uBAAuB;IACxC,iBAAiB,uBAAuB;IAGxC,cAAc,yBAAyB;IACvC,gBAAgB,2BAA2B;IAG3C,4BAA4B,kCAAkC;IAC9D,uCAAuC,6CAA6C;CACvF"}

package/dist/tools/error-codes.js

@@ -3,6 +3,7 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["EXECUTION_DENIED"] = "tools_execution_denied";
   ToolErrorCode2["EXECUTION_TIMEOUT"] = "tools_execution_timeout";
   ToolErrorCode2["EXECUTION_FAILED"] = "tools_execution_failed";
+  ToolErrorCode2["DIRECTORY_ACCESS_DENIED"] = "tools_directory_access_denied";
   ToolErrorCode2["VALIDATION_FAILED"] = "tools_validation_failed";
   ToolErrorCode2["CONFIRMATION_HANDLER_MISSING"] = "tools_confirmation_handler_missing";
   ToolErrorCode2["CONFIRMATION_TIMEOUT"] = "tools_confirmation_timeout";
@@ -12,6 +13,8 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["TOOL_UNAUTHORIZED"] = "tools_unauthorized";
   ToolErrorCode2["CONFIG_INVALID"] = "tools_config_invalid";
   ToolErrorCode2["FEATURE_DISABLED"] = "tools_feature_disabled";
+  ToolErrorCode2["CUSTOM_TOOL_PROVIDER_UNKNOWN"] = "tools_custom_provider_unknown";
+  ToolErrorCode2["CUSTOM_TOOL_PROVIDER_ALREADY_REGISTERED"] = "tools_custom_provider_already_registered";
   return ToolErrorCode2;
 })(ToolErrorCode || {});
 export {

package/dist/tools/errors.cjs

@@ -61,6 +61,21 @@ class ToolError {
       { toolName, sessionId }
     );
   }
+  /**
+   * Directory access denied by user
+   * Used when a file tool tries to access a path outside allowed directories
+   * and the user denies the directory access approval
+   */
+  static directoryAccessDenied(directory, sessionId) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.ToolErrorCode.DIRECTORY_ACCESS_DENIED,
+      import_types.ErrorScope.TOOLS,
+      import_types.ErrorType.FORBIDDEN,
+      `Access to directory '${directory}' was denied`,
+      { directory, sessionId },
+      "Request access to the directory or work within the allowed working directory"
+    );
+  }
   /**
    * Tool execution timeout
    */
@@ -188,6 +203,32 @@ class ToolError {
       ]
     );
   }
+  /**
+   * Unknown custom tool provider type
+   */
+  static unknownCustomToolProvider(type, availableTypes) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.ToolErrorCode.CUSTOM_TOOL_PROVIDER_UNKNOWN,
+      import_types.ErrorScope.TOOLS,
+      import_types.ErrorType.USER,
+      `Unknown custom tool provider: '${type}'`,
+      { type, availableTypes },
+      `Available types: ${availableTypes.length > 0 ? availableTypes.join(", ") : "none"}`
+    );
+  }
+  /**
+   * Custom tool provider already registered
+   */
+  static customToolProviderAlreadyRegistered(type) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.ToolErrorCode.CUSTOM_TOOL_PROVIDER_ALREADY_REGISTERED,
+      import_types.ErrorScope.TOOLS,
+      import_types.ErrorType.USER,
+      `Custom tool provider '${type}' is already registered`,
+      { type },
+      `Use unregister() first if you want to replace it`
+    );
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/tools/errors.d.ts

@@ -25,6 +25,15 @@ export declare class ToolError {
         toolName: string;
         sessionId: string | undefined;
     }>;
+    /**
+     * Directory access denied by user
+     * Used when a file tool tries to access a path outside allowed directories
+     * and the user denies the directory access approval
+     */
+    static directoryAccessDenied(directory: string, sessionId?: string): DextoRuntimeError<{
+        directory: string;
+        sessionId: string | undefined;
+    }>;
     /**
      * Tool execution timeout
      */
@@ -94,5 +103,13 @@ export declare class ToolError {
         toolName: string;
         missingFeatures: string[];
     }>;
+    /**
+     * Unknown custom tool provider type
+     */
+    static unknownCustomToolProvider(type: string, availableTypes: string[]): DextoRuntimeError;
+    /**
+     * Custom tool provider already registered
+     */
+    static customToolProviderAlreadyRegistered(type: string): DextoRuntimeError;
 }
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;GAGG;AACH,qBAAa,SAAS;IAClB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;;;IAUhC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAU3E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAU3D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAc/E;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;IAU3F;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAUxD;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,QAAQ,EAAE,MAAM;;;IAUlD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAUlF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAUnD;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAAC,QAAQ,EAAE,MAAM;;;IAUnD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM;IAUpC;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAU7D;;OAEG;IACH,MAAM,CAAC,eAAe,CAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,GAChB,iBAAiB,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAaxE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;GAGG;AACH,qBAAa,SAAS;IAClB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;;;IAUhC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAU3E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAU3D;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAWlE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAc/E;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;IAU3F;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAUxD;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,QAAQ,EAAE,MAAM;;;IAUlD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAUlF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAUnD;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAAC,QAAQ,EAAE,MAAM;;;IAUnD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM;IAUpC;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAU7D;;OAEG;IACH,MAAM,CAAC,eAAe,CAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,GAChB,iBAAiB,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAcrE;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,iBAAiB;IAW3F;;OAEG;IACH,MAAM,CAAC,mCAAmC,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;CAU9E"}

package/dist/tools/errors.js

@@ -39,6 +39,21 @@ class ToolError {
       { toolName, sessionId }
     );
   }
+  /**
+   * Directory access denied by user
+   * Used when a file tool tries to access a path outside allowed directories
+   * and the user denies the directory access approval
+   */
+  static directoryAccessDenied(directory, sessionId) {
+    return new DextoRuntimeError(
+      ToolErrorCode.DIRECTORY_ACCESS_DENIED,
+      ErrorScope.TOOLS,
+      ErrorType.FORBIDDEN,
+      `Access to directory '${directory}' was denied`,
+      { directory, sessionId },
+      "Request access to the directory or work within the allowed working directory"
+    );
+  }
   /**
    * Tool execution timeout
    */
@@ -166,6 +181,32 @@ class ToolError {
       ]
     );
   }
+  /**
+   * Unknown custom tool provider type
+   */
+  static unknownCustomToolProvider(type, availableTypes) {
+    return new DextoRuntimeError(
+      ToolErrorCode.CUSTOM_TOOL_PROVIDER_UNKNOWN,
+      ErrorScope.TOOLS,
+      ErrorType.USER,
+      `Unknown custom tool provider: '${type}'`,
+      { type, availableTypes },
+      `Available types: ${availableTypes.length > 0 ? availableTypes.join(", ") : "none"}`
+    );
+  }
+  /**
+   * Custom tool provider already registered
+   */
+  static customToolProviderAlreadyRegistered(type) {
+    return new DextoRuntimeError(
+      ToolErrorCode.CUSTOM_TOOL_PROVIDER_ALREADY_REGISTERED,
+      ErrorScope.TOOLS,
+      ErrorType.USER,
+      `Custom tool provider '${type}' is already registered`,
+      { type },
+      `Use unregister() first if you want to replace it`
+    );
+  }
 }
 export {
   ToolError

package/dist/tools/index.cjs

@@ -19,17 +19,29 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var tools_exports = {};
 __export(tools_exports, {
-  ToolManager: () => import_tool_manager.ToolManager
+  ToolError: () => import_errors.ToolError,
+  ToolErrorCode: () => import_error_codes.ToolErrorCode,
+  ToolManager: () => import_tool_manager.ToolManager,
+  customToolRegistry: () => import_custom_tool_registry.customToolRegistry,
+  customToolSchemaRegistry: () => import_custom_tool_schema_registry.customToolSchemaRegistry
 });
 module.exports = __toCommonJS(tools_exports);
 __reExport(tools_exports, require("./types.js"), module.exports);
 __reExport(tools_exports, require("./display-types.js"), module.exports);
 __reExport(tools_exports, require("./internal-tools/index.js"), module.exports);
+var import_custom_tool_registry = require("./custom-tool-registry.js");
+var import_custom_tool_schema_registry = require("./custom-tool-schema-registry.js");
 __reExport(tools_exports, require("./schemas.js"), module.exports);
+var import_errors = require("./errors.js");
+var import_error_codes = require("./error-codes.js");
 var import_tool_manager = require("./tool-manager.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ToolError,
+  ToolErrorCode,
   ToolManager,
+  customToolRegistry,
+  customToolSchemaRegistry,
   ...require("./types.js"),
   ...require("./display-types.js"),
   ...require("./internal-tools/index.js"),