@dexto/core 1.4.0 → 1.5.1

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"),

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"}