@dexto/core 1.4.0 → 1.5.1

package/dist/systemPrompt/registry.d.ts

@@ -3,7 +3,7 @@ import { DynamicContributorContext } from './types.js';
  * This file contains the registry of all the functions that can generate dynamic prompt pieces at runtime.
  */
 export type DynamicPromptGenerator = (context: DynamicContributorContext) => Promise<string>;
-export declare const PROMPT_GENERATOR_SOURCES: readonly ["dateTime", "resources"];
+export declare const PROMPT_GENERATOR_SOURCES: readonly ["date", "resources"];
 export type PromptGeneratorSource = (typeof PROMPT_GENERATOR_SOURCES)[number];
 export declare const PROMPT_GENERATOR_REGISTRY: Record<PromptGeneratorSource, DynamicPromptGenerator>;
 export declare function getPromptGenerator(source: PromptGeneratorSource): DynamicPromptGenerator | undefined;

package/dist/systemPrompt/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAG7F,eAAO,MAAM,wBAAwB,oCAAqC,CAAC;AAE3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG9E,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAG3F,CAAC;AAGF,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,qBAAqB,GAC9B,sBAAsB,GAAG,SAAS,CAEpC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAG7F,eAAO,MAAM,wBAAwB,gCAAiC,CAAC;AAEvE,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG9E,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAG3F,CAAC;AAGF,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,qBAAqB,GAC9B,sBAAsB,GAAG,SAAS,CAEpC"}

package/dist/systemPrompt/registry.js

@@ -1,8 +1,8 @@
 import "../chunk-PTJYTZNU.js";
 import * as handlers from "./in-built-prompts.js";
-const PROMPT_GENERATOR_SOURCES = ["dateTime", "resources"];
+const PROMPT_GENERATOR_SOURCES = ["date", "resources"];
 const PROMPT_GENERATOR_REGISTRY = {
-  dateTime: handlers.getCurrentDateTime,
+  date: handlers.getCurrentDate,
   resources: handlers.getResourceData
 };
 function getPromptGenerator(source) {

package/dist/systemPrompt/schemas.cjs

@@ -96,10 +96,10 @@ const ContributorConfigSchema = import_zod.z.discriminatedUnion(
 const SystemPromptContributorsSchema = import_zod.z.object({
   contributors: import_zod.z.array(ContributorConfigSchema).min(1).default([
     {
-      id: "dateTime",
+      id: "date",
       type: "dynamic",
       priority: 10,
-      source: "dateTime",
+      source: "date",
       enabled: true
     },
     {

package/dist/systemPrompt/schemas.d.ts

@@ -24,18 +24,18 @@ export declare const ContributorConfigSchema: z.ZodDiscriminatedUnion<"type", [z
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 } & {
     type: z.ZodLiteral<"dynamic">;
-    source: z.ZodEnum<["dateTime", "resources"]>;
+    source: z.ZodEnum<["date", "resources"]>;
 }, "strict", z.ZodTypeAny, {
     type: "dynamic";
     enabled: boolean;
     id: string;
-    source: "resources" | "dateTime";
     priority: number;
+    source: "date" | "resources";
 }, {
     type: "dynamic";
     id: string;
-    source: "resources" | "dateTime";
     priority: number;
+    source: "date" | "resources";
     enabled?: boolean | undefined;
 }>, z.ZodObject<{
     id: z.ZodString;
@@ -118,18 +118,18 @@ export declare const SystemPromptContributorsSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     } & {
         type: z.ZodLiteral<"dynamic">;
-        source: z.ZodEnum<["dateTime", "resources"]>;
+        source: z.ZodEnum<["date", "resources"]>;
     }, "strict", z.ZodTypeAny, {
         type: "dynamic";
         enabled: boolean;
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
     }, {
         type: "dynamic";
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
         enabled?: boolean | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -195,8 +195,8 @@ export declare const SystemPromptContributorsSchema: z.ZodObject<{
         type: "dynamic";
         enabled: boolean;
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
     } | {
         type: "file";
         options: {
@@ -221,8 +221,8 @@ export declare const SystemPromptContributorsSchema: z.ZodObject<{
     } | {
         type: "dynamic";
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
         enabled?: boolean | undefined;
     } | {
         type: "file";
@@ -273,18 +273,18 @@ export declare const SystemPromptConfigSchema: z.ZodBranded<z.ZodUnion<[z.ZodEff
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     } & {
         type: z.ZodLiteral<"dynamic">;
-        source: z.ZodEnum<["dateTime", "resources"]>;
+        source: z.ZodEnum<["date", "resources"]>;
     }, "strict", z.ZodTypeAny, {
         type: "dynamic";
         enabled: boolean;
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
     }, {
         type: "dynamic";
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
         enabled?: boolean | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -350,8 +350,8 @@ export declare const SystemPromptConfigSchema: z.ZodBranded<z.ZodUnion<[z.ZodEff
         type: "dynamic";
         enabled: boolean;
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
     } | {
         type: "file";
         options: {
@@ -376,8 +376,8 @@ export declare const SystemPromptConfigSchema: z.ZodBranded<z.ZodUnion<[z.ZodEff
     } | {
         type: "dynamic";
         id: string;
-        source: "resources" | "dateTime";
         priority: number;
+        source: "date" | "resources";
         enabled?: boolean | undefined;
     } | {
         type: "file";

package/dist/systemPrompt/schemas.js

@@ -62,10 +62,10 @@ const ContributorConfigSchema = z.discriminatedUnion(
 const SystemPromptContributorsSchema = z.object({
   contributors: z.array(ContributorConfigSchema).min(1).default([
     {
-      id: "dateTime",
+      id: "date",
       type: "dynamic",
       priority: 10,
-      source: "dateTime",
+      source: "date",
       enabled: true
     },
     {

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

@@ -0,0 +1,64 @@
+"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_registry_exports = {};
+__export(custom_tool_registry_exports, {
+  CustomToolRegistry: () => CustomToolRegistry,
+  customToolRegistry: () => customToolRegistry
+});
+module.exports = __toCommonJS(custom_tool_registry_exports);
+var import_errors = require("./errors.js");
+var import_base_registry = require("../providers/base-registry.js");
+var import_custom_tool_schema_registry = require("./custom-tool-schema-registry.js");
+const customToolErrorFactory = {
+  alreadyRegistered: (type) => import_errors.ToolError.customToolProviderAlreadyRegistered(type),
+  notFound: (type, availableTypes) => import_errors.ToolError.unknownCustomToolProvider(type, availableTypes)
+};
+class CustomToolRegistry extends import_base_registry.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);
+    import_custom_tool_schema_registry.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();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CustomToolRegistry,
+  customToolRegistry
+});

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

@@ -0,0 +1,126 @@
+import type { InternalTool } from './types.js';
+import type { IDextoLogger } from '../logger/v2/types.js';
+import type { DextoAgent } from '../agent/DextoAgent.js';
+import { z } from 'zod';
+import { BaseRegistry } from '../providers/base-registry.js';
+/**
+ * Context passed to custom tool providers when creating tools.
+ * Provides access to the agent instance for bidirectional communication.
+ *
+ * **Bidirectional Services Pattern:**
+ * Some services need both:
+ * - Agent → Service: LLM calls tools that invoke service methods
+ * - Service → Agent: Service emits events that trigger agent invocation
+ *
+ * Implementation pattern:
+ * ```typescript
+ * create: (config, context) => {
+ *     const service = new MyService(config, context.logger);
+ *
+ *     // Wire up Service → Agent communication
+ *     service.on('event', async (data) => {
+ *         await context.agent.sendMessage({
+ *             role: 'user',
+ *             content: data.prompt,
+ *         });
+ *     });
+ *
+ *     // Return Agent → Service tools
+ *     return [createMyTool(service)];
+ * }
+ * ```
+ *
+ * **Future Consideration:**
+ * For complex event routing or decoupled architectures, consider using an Event Bus pattern
+ * where services emit events to a central bus and the agent/app subscribes. This would
+ * provide better separation of concerns at the cost of more indirection and complexity.
+ */
+export interface ToolCreationContext {
+    logger: IDextoLogger;
+    agent: DextoAgent;
+    /**
+     * Optional services available to custom tool providers.
+     *
+     * Core services (provided by agent):
+     * - approvalManager: For tools that need approval flows
+     * - storageManager: For tools that need persistence
+     * - resourceManager: For tools that need resource access
+     * - searchService: For tools that need search capabilities
+     *
+     * External tool providers can add their own services using the index signature.
+     */
+    services?: {
+        searchService?: any;
+        approvalManager?: any;
+        resourceManager?: any;
+        storageManager?: import('../storage/index.js').StorageManager;
+        [key: string]: any;
+    };
+}
+/**
+ * Custom tool provider interface.
+ * Allows external code to register tool providers that create one or more tools.
+ * Mirrors the BlobStoreProvider pattern for consistency.
+ *
+ * @template TType - The provider type discriminator (must match config.type)
+ * @template TConfig - The provider configuration type (must include { type: TType })
+ */
+export interface CustomToolProvider<TType extends string = string, TConfig extends {
+    type: TType;
+} = any> {
+    /** Unique type identifier matching the discriminator in config */
+    type: TType;
+    /** Zod schema for runtime validation of provider configuration */
+    configSchema: z.ZodType<TConfig, any, any>;
+    /**
+     * Factory function to create tools from validated configuration
+     * @param config - Validated configuration matching configSchema
+     * @param context - Tool creation context with logger and optional services
+     * @returns Array of tools to register
+     */
+    create(config: TConfig, context: ToolCreationContext): InternalTool[];
+    /** Optional metadata for display and categorization */
+    metadata?: {
+        displayName: string;
+        description: string;
+        category?: string;
+    };
+}
+/**
+ * Registry for custom tool providers.
+ * Mirrors BlobStoreRegistry pattern for consistency across Dexto provider system.
+ *
+ * Custom tool providers can be registered from external code (CLI, apps, examples)
+ * and are validated at runtime using their Zod schemas.
+ *
+ * Extends BaseRegistry for common registry functionality.
+ *
+ * When a provider is registered, its config schema is also registered in the
+ * customToolSchemaRegistry for early validation at config load time.
+ */
+export declare class CustomToolRegistry extends BaseRegistry<CustomToolProvider> {
+    constructor();
+    /**
+     * 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: CustomToolProvider): void;
+    /**
+     * 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: string): boolean;
+}
+/**
+ * Global singleton instance of the custom tool registry.
+ * Custom tool providers should be registered at application startup.
+ */
+export declare const customToolRegistry: CustomToolRegistry;
+//# sourceMappingURL=custom-tool-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/custom-tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAA6B,MAAM,+BAA+B,CAAC;AAGxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE;QACP,aAAa,CAAC,EAAE,GAAG,CAAC;QACpB,eAAe,CAAC,EAAE,GAAG,CAAC;QACtB,eAAe,CAAC,EAAE,GAAG,CAAC;QACtB,cAAc,CAAC,EAAE,OAAO,qBAAqB,EAAE,cAAc,CAAC;QAC9D,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,CAAC;CACL;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAC/B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,OAAO,SAAS;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG,GAAG;IAErC,kEAAkE;IAClE,IAAI,EAAE,KAAK,CAAC;IAEZ,kEAAkE;IAClE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,EAAE,CAAC;IAEtE,uDAAuD;IACvD,QAAQ,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AAYD;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,YAAY,CAAC,kBAAkB,CAAC;;IAKpE;;;;;;OAMG;IACM,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAQrD;;;;;;;OAOG;IACM,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAK7C;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

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