@dexto/core 1.3.0 → 1.5.0

package/dist/tools/display-types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Tool Display Types
+ *
+ * Discriminated union types for structured tool result rendering.
+ * These types enable both CLI and WebUI to render tool results with
+ * appropriate formatting (diffs, shell output, search results, etc.)
+ *
+ * Tools return `_display` field in their result, which is preserved
+ * by the sanitizer in `SanitizedToolResult.meta.display`.
+ */
+/**
+ * Discriminated union of all tool display data types.
+ * Switch on `type` field for exhaustive handling.
+ */
+export type ToolDisplayData = DiffDisplayData | ShellDisplayData | SearchDisplayData | FileDisplayData | GenericDisplayData;
+/**
+ * Display data for file edit operations (edit_file, write_file overwrites).
+ * Contains unified diff format for rendering changes.
+ */
+export interface DiffDisplayData {
+    type: 'diff';
+    /** Unified diff string (output of `diff` package's createPatch) */
+    unified: string;
+    /** Path to the file that was modified */
+    filename: string;
+    /** Number of lines added */
+    additions: number;
+    /** Number of lines removed */
+    deletions: number;
+    /** Original file content (optional, for approval preview) */
+    beforeContent?: string;
+    /** New file content (optional, for approval preview) */
+    afterContent?: string;
+}
+/**
+ * Display data for shell command execution (bash_exec).
+ * Contains command metadata and output for structured rendering.
+ */
+export interface ShellDisplayData {
+    type: 'shell';
+    /** The command that was executed */
+    command: string;
+    /** Exit code from the command (0 = success) */
+    exitCode: number;
+    /** Execution duration in milliseconds */
+    duration: number;
+    /** Whether command is running in background */
+    isBackground?: boolean;
+    /** Standard output from the command */
+    stdout?: string;
+    /** Standard error from the command */
+    stderr?: string;
+}
+/**
+ * Display data for search operations (grep_content, glob_files).
+ * Contains structured match results for formatted rendering.
+ */
+export interface SearchDisplayData {
+    type: 'search';
+    /** The search pattern used */
+    pattern: string;
+    /** Array of match results */
+    matches: SearchMatch[];
+    /** Total number of matches found (may exceed displayed matches) */
+    totalMatches: number;
+    /** Whether results were truncated due to limits */
+    truncated: boolean;
+}
+/**
+ * Individual search match result.
+ */
+export interface SearchMatch {
+    /** File path where match was found */
+    file: string;
+    /** Line number of the match (0 for glob results) */
+    line: number;
+    /** Content of the matching line or filename */
+    content: string;
+    /** Optional surrounding context lines */
+    context?: string[];
+}
+/**
+ * Display data for file operations (read_file, write_file create).
+ * Contains file metadata for simple status rendering.
+ */
+export interface FileDisplayData {
+    type: 'file';
+    /** Path to the file */
+    path: string;
+    /** Type of operation performed */
+    operation: 'read' | 'write' | 'create' | 'delete';
+    /** File size in bytes (optional) */
+    size?: number;
+    /** Number of lines read/written (optional) */
+    lineCount?: number;
+    /** Path to backup file if created (optional) */
+    backupPath?: string;
+    /** File content for create operations (used in approval preview) */
+    content?: string;
+}
+/**
+ * Fallback display data for unknown tools or MCP tools.
+ * Renderers should fall back to rendering content[] directly.
+ */
+export interface GenericDisplayData {
+    type: 'generic';
+}
+/**
+ * Type guard for DiffDisplayData.
+ */
+export declare function isDiffDisplay(d: ToolDisplayData): d is DiffDisplayData;
+/**
+ * Type guard for ShellDisplayData.
+ */
+export declare function isShellDisplay(d: ToolDisplayData): d is ShellDisplayData;
+/**
+ * Type guard for SearchDisplayData.
+ */
+export declare function isSearchDisplay(d: ToolDisplayData): d is SearchDisplayData;
+/**
+ * Type guard for FileDisplayData.
+ */
+export declare function isFileDisplay(d: ToolDisplayData): d is FileDisplayData;
+/**
+ * Type guard for GenericDisplayData.
+ */
+export declare function isGenericDisplay(d: ToolDisplayData): d is GenericDisplayData;
+/**
+ * Validates that an unknown value is a valid ToolDisplayData.
+ * Used by sanitizer to safely extract _display from tool results.
+ */
+export declare function isValidDisplayData(d: unknown): d is ToolDisplayData;
+//# sourceMappingURL=display-types.d.ts.map

package/dist/tools/display-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-types.d.ts","sourceRoot":"","sources":["../../src/tools/display-types.ts"],"names":[],"mappings":"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"}

package/dist/tools/display-types.js

@@ -0,0 +1,32 @@
+import "../chunk-PTJYTZNU.js";
+function isDiffDisplay(d) {
+  return d.type === "diff";
+}
+function isShellDisplay(d) {
+  return d.type === "shell";
+}
+function isSearchDisplay(d) {
+  return d.type === "search";
+}
+function isFileDisplay(d) {
+  return d.type === "file";
+}
+function isGenericDisplay(d) {
+  return d.type === "generic";
+}
+const VALID_DISPLAY_TYPES = ["diff", "shell", "search", "file", "generic"];
+function isValidDisplayData(d) {
+  if (d === null || typeof d !== "object") {
+    return false;
+  }
+  const obj = d;
+  return typeof obj.type === "string" && VALID_DISPLAY_TYPES.includes(obj.type);
+}
+export {
+  isDiffDisplay,
+  isFileDisplay,
+  isGenericDisplay,
+  isSearchDisplay,
+  isShellDisplay,
+  isValidDisplayData
+};

package/dist/tools/error-codes.cjs

@@ -25,6 +25,8 @@ 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";
   ToolErrorCode2["CONFIRMATION_CANCELLED"] = "tools_confirmation_cancelled";
@@ -32,6 +34,9 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["TOOL_INVALID_ARGS"] = "tools_invalid_args";
   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,12 +6,17 @@ 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",
     CONFIRMATION_CANCELLED = "tools_confirmation_cancelled",
     TOOL_NOT_FOUND = "tools_tool_not_found",
     TOOL_INVALID_ARGS = "tools_invalid_args",
     TOOL_UNAUTHORIZED = "tools_unauthorized",
-    CONFIG_INVALID = "tools_config_invalid"
+    CONFIG_INVALID = "tools_config_invalid",
+    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,4BAA4B,uCAAuC;IACnE,oBAAoB,+BAA+B;IACnD,sBAAsB,iCAAiC;IAGvD,cAAc,yBAAyB;IACvC,iBAAiB,uBAAuB;IACxC,iBAAiB,uBAAuB;IAGxC,cAAc,yBAAyB;CAC1C"}
+{"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

@@ -1,8 +1,10 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 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";
   ToolErrorCode2["CONFIRMATION_CANCELLED"] = "tools_confirmation_cancelled";
@@ -10,6 +12,9 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["TOOL_INVALID_ARGS"] = "tools_invalid_args";
   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
    */
@@ -74,6 +89,20 @@ class ToolError {
       { toolName, timeoutMs, sessionId }
     );
   }
+  /**
+   * Tool validation failed (pre-execution check)
+   * Used when tool inputs are semantically invalid (e.g., file not found, string not in file)
+   * This should fail before approval, not after.
+   */
+  static validationFailed(toolName, reason, context) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.ToolErrorCode.VALIDATION_FAILED,
+      import_types.ErrorScope.TOOLS,
+      import_types.ErrorType.USER,
+      `Tool '${toolName}' validation failed: ${reason}`,
+      { toolName, reason, ...context }
+    );
+  }
   /**
    * Tool unauthorized access
    */
@@ -158,6 +187,48 @@ class ToolError {
       { toolName, reason }
     );
   }
+  /**
+   * Tool requires features which are currently disabled
+   */
+  static featureDisabled(toolName, missingFeatures, message) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.ToolErrorCode.FEATURE_DISABLED,
+      import_types.ErrorScope.TOOLS,
+      import_types.ErrorType.USER,
+      message,
+      { toolName, missingFeatures },
+      [
+        `Remove '${toolName}' from internalTools in your agent config`,
+        `Or enable required features: ${missingFeatures.map((f) => `${f}.enabled: true`).join(", ")}`
+      ]
+    );
+  }
+  /**
+   * 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
      */
@@ -33,6 +42,15 @@ export declare class ToolError {
         timeoutMs: number;
         sessionId: string | undefined;
     }>;
+    /**
+     * Tool validation failed (pre-execution check)
+     * Used when tool inputs are semantically invalid (e.g., file not found, string not in file)
+     * This should fail before approval, not after.
+     */
+    static validationFailed(toolName: string, reason: string, context?: Record<string, unknown>): DextoRuntimeError<{
+        toolName: string;
+        reason: string;
+    }>;
     /**
      * Tool unauthorized access
      */
@@ -78,5 +96,20 @@ export declare class ToolError {
         toolName: string;
         reason: string;
     }>;
+    /**
+     * Tool requires features which are currently disabled
+     */
+    static featureDisabled(toolName: string, missingFeatures: string[], message: string): DextoRuntimeError<{
+        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;;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;;;;CAShE"}
+{"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

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
 import { ErrorScope, ErrorType } from "../errors/types.js";
 import { ToolErrorCode } from "./error-codes.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
    */
@@ -52,6 +67,20 @@ class ToolError {
       { toolName, timeoutMs, sessionId }
     );
   }
+  /**
+   * Tool validation failed (pre-execution check)
+   * Used when tool inputs are semantically invalid (e.g., file not found, string not in file)
+   * This should fail before approval, not after.
+   */
+  static validationFailed(toolName, reason, context) {
+    return new DextoRuntimeError(
+      ToolErrorCode.VALIDATION_FAILED,
+      ErrorScope.TOOLS,
+      ErrorType.USER,
+      `Tool '${toolName}' validation failed: ${reason}`,
+      { toolName, reason, ...context }
+    );
+  }
   /**
    * Tool unauthorized access
    */
@@ -136,6 +165,48 @@ class ToolError {
       { toolName, reason }
     );
   }
+  /**
+   * Tool requires features which are currently disabled
+   */
+  static featureDisabled(toolName, missingFeatures, message) {
+    return new DextoRuntimeError(
+      ToolErrorCode.FEATURE_DISABLED,
+      ErrorScope.TOOLS,
+      ErrorType.USER,
+      message,
+      { toolName, missingFeatures },
+      [
+        `Remove '${toolName}' from internalTools in your agent config`,
+        `Or enable required features: ${missingFeatures.map((f) => `${f}.enabled: true`).join(", ")}`
+      ]
+    );
+  }
+  /**
+   * 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,31 @@ 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"),
   ...require("./schemas.js")
 });

package/dist/tools/index.d.ts

@@ -5,7 +5,12 @@
  * MCP servers and internal tools.
  */
 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,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

@@ -1,8 +1,19 @@
-import "../chunk-C6A6W6XS.js";
+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

@@ -1,16 +1,10 @@
-import "../../chunk-C6A6W6XS.js";
+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/ask-user-tool.cjs

@@ -29,7 +29,7 @@ const AskUserInputSchema = import_zod.z.object({
     properties: import_zod.z.record(import_zod.z.unknown()),
     required: import_zod.z.array(import_zod.z.string()).optional()
   }).passthrough().describe(
-    'JSON Schema defining the form structure. Must be an object with "type": "object" and "properties" defining form fields. Use "enum" arrays for dropdowns, "boolean" for yes/no, "number"/"integer" for numeric inputs, "string" for text. Include "required" array for mandatory fields.'
+    'JSON Schema defining form fields. Use descriptive property names as labels (e.g., "favorite_team", "World Cup winner country") - NOT generic names like "q1". Use "enum" for dropdowns, "boolean" for yes/no, "number" for numeric inputs, "string" for text. Include "required" array for mandatory fields.'
   )
 }).strict();
 function createAskUserTool(approvalManager) {

package/dist/tools/internal-tools/implementations/ask-user-tool.js

@@ -1,4 +1,4 @@
-import "../../../chunk-C6A6W6XS.js";
+import "../../../chunk-PTJYTZNU.js";
 import { z } from "zod";
 const AskUserInputSchema = z.object({
   question: z.string().describe("The question or prompt to display to the user"),
@@ -7,7 +7,7 @@ const AskUserInputSchema = z.object({
     properties: z.record(z.unknown()),
     required: z.array(z.string()).optional()
   }).passthrough().describe(
-    'JSON Schema defining the form structure. Must be an object with "type": "object" and "properties" defining form fields. Use "enum" arrays for dropdowns, "boolean" for yes/no, "number"/"integer" for numeric inputs, "string" for text. Include "required" array for mandatory fields.'
+    'JSON Schema defining form fields. Use descriptive property names as labels (e.g., "favorite_team", "World Cup winner country") - NOT generic names like "q1". Use "enum" for dropdowns, "boolean" for yes/no, "number" for numeric inputs, "string" for text. Include "required" array for mandatory fields.'
   )
 }).strict();
 function createAskUserTool(approvalManager) {

package/dist/tools/internal-tools/implementations/delegate-to-url-tool.js

@@ -1,4 +1,4 @@
-import "../../../chunk-C6A6W6XS.js";
+import "../../../chunk-PTJYTZNU.js";
 import { z } from "zod";
 import { DextoRuntimeError, ErrorScope, ErrorType } from "../../../errors/index.js";
 const DelegateToUrlInputSchema = z.object({