@dexto/core 1.4.0 → 1.5.1

package/dist/providers/base-registry.d.ts

@@ -0,0 +1,147 @@
+import { z } from 'zod';
+/**
+ * Base provider interface - all providers must have a type identifier.
+ */
+export interface BaseProvider {
+    /** Unique type identifier for this provider */
+    type: string;
+}
+/**
+ * Provider with config schema - for providers that support validateConfig.
+ */
+export interface ConfigurableProvider extends BaseProvider {
+    /** Zod schema for validating provider configuration */
+    configSchema: z.ZodType<any, any, any>;
+}
+/**
+ * Error factory interface for customizing registry errors.
+ * Each registry can provide its own error implementations.
+ */
+export interface RegistryErrorFactory {
+    /** Called when attempting to register a provider that already exists */
+    alreadyRegistered(type: string): Error;
+    /** Called when looking up a provider that doesn't exist (for validateConfig) */
+    notFound(type: string, availableTypes: string[]): Error;
+}
+/**
+ * Default error factory that throws plain Error instances.
+ * Used when no custom error factory is provided.
+ */
+export declare const defaultErrorFactory: RegistryErrorFactory;
+/**
+ * Generic base registry for provider patterns.
+ *
+ * This class provides common registry functionality used across Dexto's
+ * provider system (blob storage, compression, custom tools, etc.).
+ *
+ * Features:
+ * - Type-safe provider registration and retrieval
+ * - Duplicate registration prevention
+ * - Customizable error handling via error factory
+ * - Optional config validation for providers with schemas
+ *
+ * @template TProvider - The provider type (must extend BaseProvider)
+ *
+ * @example
+ * ```typescript
+ * // Define your provider interface
+ * interface MyProvider extends BaseProvider {
+ *   type: string;
+ *   configSchema: z.ZodType<any>;
+ *   create(config: any): MyInstance;
+ * }
+ *
+ * // Create a registry
+ * class MyRegistry extends BaseRegistry<MyProvider> {
+ *   constructor() {
+ *     super({
+ *       alreadyRegistered: (type) => new MyError(`Provider ${type} exists`),
+ *       notFound: (type, available) => new MyError(`Unknown: ${type}`),
+ *     });
+ *   }
+ * }
+ *
+ * // Use the registry
+ * const registry = new MyRegistry();
+ * registry.register(myProvider);
+ * const provider = registry.get('my-type');
+ * ```
+ */
+export declare class BaseRegistry<TProvider extends BaseProvider> {
+    protected providers: Map<string, TProvider>;
+    protected errorFactory: RegistryErrorFactory;
+    /**
+     * Create a new registry instance.
+     *
+     * @param errorFactory - Optional custom error factory for registry errors.
+     *                       If not provided, uses default Error instances.
+     */
+    constructor(errorFactory?: RegistryErrorFactory);
+    /**
+     * Register a provider.
+     *
+     * @param provider - The provider to register
+     * @throws Error if a provider with the same type is already registered
+     */
+    register(provider: TProvider): void;
+    /**
+     * Unregister a provider.
+     *
+     * @param type - The provider type to unregister
+     * @returns true if the provider was unregistered, false if it wasn't registered
+     */
+    unregister(type: string): boolean;
+    /**
+     * Get a registered provider by type.
+     *
+     * @param type - The provider type identifier
+     * @returns The provider if found, undefined otherwise
+     */
+    get(type: string): TProvider | undefined;
+    /**
+     * Check if a provider is registered.
+     *
+     * @param type - The provider type identifier
+     * @returns true if registered, false otherwise
+     */
+    has(type: string): boolean;
+    /**
+     * Get all registered provider types.
+     *
+     * @returns Array of provider type identifiers
+     */
+    getTypes(): string[];
+    /**
+     * Get all registered providers.
+     *
+     * @returns Array of providers
+     */
+    getAll(): TProvider[];
+    /**
+     * Get the number of registered providers.
+     *
+     * @returns Count of registered providers
+     */
+    get size(): number;
+    /**
+     * Clear all registered providers.
+     * Primarily useful for testing.
+     */
+    clear(): void;
+    /**
+     * Validate a configuration against a provider's schema.
+     *
+     * This method is only available for registries with providers that have
+     * a configSchema property. It:
+     * 1. Extracts the 'type' field to identify the provider
+     * 2. Looks up the provider in the registry
+     * 3. Validates the full config against the provider's schema
+     * 4. Returns the validated configuration
+     *
+     * @param config - Raw configuration object with a 'type' field
+     * @returns Validated configuration object
+     * @throws Error if type is missing, provider not found, or validation fails
+     */
+    validateConfig(config: unknown): any;
+}
+//# sourceMappingURL=base-registry.d.ts.map

package/dist/providers/base-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-registry.d.ts","sourceRoot":"","sources":["../../src/providers/base-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACtD,uDAAuD;IACvD,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,wEAAwE;IACxE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;CAC3D;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,oBAMjC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,YAAY,CAAC,SAAS,SAAS,YAAY;IACpD,SAAS,CAAC,SAAS,yBAAgC;IACnD,SAAS,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE7C;;;;;OAKG;gBACS,YAAY,GAAE,oBAA0C;IAIpE;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAOnC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;;;OAIG;IACH,MAAM,IAAI,SAAS,EAAE;IAIrB;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG;CAqBvC"}

package/dist/providers/base-registry.js

@@ -0,0 +1,123 @@
+import "../chunk-PTJYTZNU.js";
+import { z } from "zod";
+const defaultErrorFactory = {
+  alreadyRegistered: (type) => new Error(`Provider '${type}' is already registered`),
+  notFound: (type, availableTypes) => new Error(
+    `Provider '${type}' not found. Available: ${availableTypes.join(", ") || "none"}`
+  )
+};
+class BaseRegistry {
+  providers = /* @__PURE__ */ new Map();
+  errorFactory;
+  /**
+   * Create a new registry instance.
+   *
+   * @param errorFactory - Optional custom error factory for registry errors.
+   *                       If not provided, uses default Error instances.
+   */
+  constructor(errorFactory = defaultErrorFactory) {
+    this.errorFactory = errorFactory;
+  }
+  /**
+   * Register a provider.
+   *
+   * @param provider - The provider to register
+   * @throws Error if a provider with the same type is already registered
+   */
+  register(provider) {
+    if (this.providers.has(provider.type)) {
+      throw this.errorFactory.alreadyRegistered(provider.type);
+    }
+    this.providers.set(provider.type, provider);
+  }
+  /**
+   * Unregister a provider.
+   *
+   * @param type - The provider type to unregister
+   * @returns true if the provider was unregistered, false if it wasn't registered
+   */
+  unregister(type) {
+    return this.providers.delete(type);
+  }
+  /**
+   * Get a registered provider by type.
+   *
+   * @param type - The provider type identifier
+   * @returns The provider if found, undefined otherwise
+   */
+  get(type) {
+    return this.providers.get(type);
+  }
+  /**
+   * Check if a provider is registered.
+   *
+   * @param type - The provider type identifier
+   * @returns true if registered, false otherwise
+   */
+  has(type) {
+    return this.providers.has(type);
+  }
+  /**
+   * Get all registered provider types.
+   *
+   * @returns Array of provider type identifiers
+   */
+  getTypes() {
+    return Array.from(this.providers.keys());
+  }
+  /**
+   * Get all registered providers.
+   *
+   * @returns Array of providers
+   */
+  getAll() {
+    return Array.from(this.providers.values());
+  }
+  /**
+   * Get the number of registered providers.
+   *
+   * @returns Count of registered providers
+   */
+  get size() {
+    return this.providers.size;
+  }
+  /**
+   * Clear all registered providers.
+   * Primarily useful for testing.
+   */
+  clear() {
+    this.providers.clear();
+  }
+  /**
+   * Validate a configuration against a provider's schema.
+   *
+   * This method is only available for registries with providers that have
+   * a configSchema property. It:
+   * 1. Extracts the 'type' field to identify the provider
+   * 2. Looks up the provider in the registry
+   * 3. Validates the full config against the provider's schema
+   * 4. Returns the validated configuration
+   *
+   * @param config - Raw configuration object with a 'type' field
+   * @returns Validated configuration object
+   * @throws Error if type is missing, provider not found, or validation fails
+   */
+  validateConfig(config) {
+    const typeSchema = z.object({ type: z.string() }).passthrough();
+    const parsed = typeSchema.parse(config);
+    const provider = this.providers.get(parsed.type);
+    if (!provider) {
+      throw this.errorFactory.notFound(parsed.type, this.getTypes());
+    }
+    if (!("configSchema" in provider) || !provider.configSchema) {
+      throw new Error(
+        `Provider '${parsed.type}' does not support config validation (no configSchema)`
+      );
+    }
+    return provider.configSchema.parse(config);
+  }
+}
+export {
+  BaseRegistry,
+  defaultErrorFactory
+};

package/dist/providers/discovery.cjs

@@ -0,0 +1,109 @@
+"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 discovery_exports = {};
+__export(discovery_exports, {
+  getProvidersByCategory: () => getProvidersByCategory,
+  hasProvider: () => hasProvider,
+  listAllProviders: () => listAllProviders
+});
+module.exports = __toCommonJS(discovery_exports);
+var import_blob = require("../storage/blob/index.js");
+var import_database = require("../storage/database/index.js");
+var import_compaction = require("../context/compaction/index.js");
+var import_custom_tool_registry = require("../tools/custom-tool-registry.js");
+var import_constants = require("../tools/internal-tools/constants.js");
+var import_registry = require("../tools/internal-tools/registry.js");
+function listAllProviders() {
+  const blobProviders = import_blob.blobStoreRegistry.getProviders().map((provider) => {
+    const info = {
+      type: provider.type,
+      category: "blob"
+    };
+    if (provider.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const compactionProviders = import_compaction.compactionRegistry.getAll().map((provider) => {
+    const info = {
+      type: provider.type,
+      category: "compaction"
+    };
+    if (provider.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const customToolProviders = import_custom_tool_registry.customToolRegistry.getTypes().map((type) => {
+    const provider = import_custom_tool_registry.customToolRegistry.get(type);
+    const info = {
+      type,
+      category: "customTools"
+    };
+    if (provider?.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const databaseProviders = import_database.databaseRegistry.getProviders().map((provider) => {
+    const info = {
+      type: provider.type,
+      category: "database"
+    };
+    if (provider.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const internalTools = import_constants.INTERNAL_TOOL_NAMES.map((name) => ({
+    name,
+    description: import_registry.INTERNAL_TOOL_REGISTRY[name].description
+  }));
+  return {
+    blob: blobProviders,
+    database: databaseProviders,
+    compaction: compactionProviders,
+    customTools: customToolProviders,
+    internalTools
+  };
+}
+function getProvidersByCategory(category) {
+  const allProviders = listAllProviders();
+  return allProviders[category];
+}
+function hasProvider(category, type) {
+  switch (category) {
+    case "blob":
+      return import_blob.blobStoreRegistry.has(type);
+    case "database":
+      return import_database.databaseRegistry.has(type);
+    case "compaction":
+      return import_compaction.compactionRegistry.has(type);
+    case "customTools":
+      return import_custom_tool_registry.customToolRegistry.has(type);
+    default:
+      return false;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getProvidersByCategory,
+  hasProvider,
+  listAllProviders
+});

package/dist/providers/discovery.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Information about a registered provider.
+ */
+export interface DiscoveredProvider {
+    /** Provider type identifier (e.g., 'local', 's3', 'reactive-overflow') */
+    type: string;
+    /** Provider category */
+    category: 'blob' | 'database' | 'compaction' | 'customTools';
+    /** Optional metadata about the provider */
+    metadata?: {
+        displayName?: string;
+        description?: string;
+        [key: string]: any;
+    } | undefined;
+}
+/**
+ * Information about an internal tool for discovery.
+ */
+export interface InternalToolDiscovery {
+    /** Tool name identifier (e.g., 'search_history', 'ask_user') */
+    name: string;
+    /** Human-readable description of what the tool does */
+    description: string;
+}
+/**
+ * Discovery result with providers grouped by category.
+ */
+export interface ProviderDiscovery {
+    /** Blob storage providers */
+    blob: DiscoveredProvider[];
+    /** Database providers */
+    database: DiscoveredProvider[];
+    /** Compaction strategy providers */
+    compaction: DiscoveredProvider[];
+    /** Custom tool providers */
+    customTools: DiscoveredProvider[];
+    /** Internal tools available for configuration */
+    internalTools: InternalToolDiscovery[];
+}
+/**
+ * Provider category type.
+ */
+export type ProviderCategory = 'blob' | 'database' | 'compaction' | 'customTools';
+/**
+ * List all registered providers across all registries.
+ *
+ * This function is useful for debugging and building UIs that need to display
+ * available providers. It queries all provider registries and returns a
+ * comprehensive view of what's currently registered.
+ *
+ * @returns Object with providers grouped by category
+ *
+ * @example
+ * ```typescript
+ * const providers = listAllProviders();
+ * console.log('Available blob providers:', providers.blob);
+ * console.log('Available compaction providers:', providers.compaction);
+ * console.log('Available custom tool providers:', providers.customTools);
+ * ```
+ */
+export declare function listAllProviders(): ProviderDiscovery;
+/**
+ * Get all providers for a specific category.
+ *
+ * @param category - The provider category to query
+ * @returns Array of provider information for the specified category
+ *
+ * @example
+ * ```typescript
+ * const blobProviders = getProvidersByCategory('blob');
+ * blobProviders.forEach(p => {
+ *   console.log(`${p.type}: ${p.metadata?.displayName}`);
+ * });
+ * ```
+ */
+export declare function getProvidersByCategory(category: ProviderCategory): DiscoveredProvider[];
+/**
+ * Check if a specific provider exists in a category.
+ *
+ * @param category - The provider category to check
+ * @param type - The provider type identifier
+ * @returns True if the provider is registered, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (hasProvider('blob', 's3')) {
+ *   console.log('S3 blob storage is available');
+ * }
+ *
+ * if (hasProvider('compaction', 'reactive-overflow')) {
+ *   console.log('Reactive overflow compaction is available');
+ * }
+ * ```
+ */
+export declare function hasProvider(category: ProviderCategory, type: string): boolean;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/providers/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/providers/discovery.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;IAE7D,2CAA2C;IAC3C,QAAQ,CAAC,EACH;QACI,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,GACD,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6BAA6B;IAC7B,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAE3B,yBAAyB;IACzB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAE/B,oCAAoC;IACpC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAEjC,4BAA4B;IAC5B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAElC,iDAAiD;IACjD,aAAa,EAAE,qBAAqB,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;AAElF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CA+DpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,EAAE,CAGvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAa7E"}

package/dist/providers/discovery.js

@@ -0,0 +1,84 @@
+import "../chunk-PTJYTZNU.js";
+import { blobStoreRegistry } from "../storage/blob/index.js";
+import { databaseRegistry } from "../storage/database/index.js";
+import { compactionRegistry } from "../context/compaction/index.js";
+import { customToolRegistry } from "../tools/custom-tool-registry.js";
+import { INTERNAL_TOOL_NAMES } from "../tools/internal-tools/constants.js";
+import { INTERNAL_TOOL_REGISTRY } from "../tools/internal-tools/registry.js";
+function listAllProviders() {
+  const blobProviders = blobStoreRegistry.getProviders().map((provider) => {
+    const info = {
+      type: provider.type,
+      category: "blob"
+    };
+    if (provider.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const compactionProviders = compactionRegistry.getAll().map((provider) => {
+    const info = {
+      type: provider.type,
+      category: "compaction"
+    };
+    if (provider.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const customToolProviders = customToolRegistry.getTypes().map((type) => {
+    const provider = customToolRegistry.get(type);
+    const info = {
+      type,
+      category: "customTools"
+    };
+    if (provider?.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const databaseProviders = databaseRegistry.getProviders().map((provider) => {
+    const info = {
+      type: provider.type,
+      category: "database"
+    };
+    if (provider.metadata) {
+      info.metadata = provider.metadata;
+    }
+    return info;
+  });
+  const internalTools = INTERNAL_TOOL_NAMES.map((name) => ({
+    name,
+    description: INTERNAL_TOOL_REGISTRY[name].description
+  }));
+  return {
+    blob: blobProviders,
+    database: databaseProviders,
+    compaction: compactionProviders,
+    customTools: customToolProviders,
+    internalTools
+  };
+}
+function getProvidersByCategory(category) {
+  const allProviders = listAllProviders();
+  return allProviders[category];
+}
+function hasProvider(category, type) {
+  switch (category) {
+    case "blob":
+      return blobStoreRegistry.has(type);
+    case "database":
+      return databaseRegistry.has(type);
+    case "compaction":
+      return compactionRegistry.has(type);
+    case "customTools":
+      return customToolRegistry.has(type);
+    default:
+      return false;
+  }
+}
+export {
+  getProvidersByCategory,
+  hasProvider,
+  listAllProviders
+};

package/dist/providers/index.cjs

@@ -0,0 +1,24 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var providers_exports = {};
+module.exports = __toCommonJS(providers_exports);
+__reExport(providers_exports, require("./base-registry.js"), module.exports);
+__reExport(providers_exports, require("./discovery.js"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./base-registry.js"),
+  ...require("./discovery.js")
+});

package/dist/providers/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Provider Infrastructure
+ *
+ * This module provides:
+ * 1. BaseRegistry - Generic base class for building type-safe provider registries
+ * 2. Discovery API - Utilities for querying registered providers across all registries
+ *
+ * Useful for:
+ * - Building custom provider registries with consistent behavior
+ * - Debugging: See what providers are available at runtime
+ * - UIs: Build dynamic interfaces that show available providers
+ * - Configuration validation: Check if required providers are registered
+ *
+ * @example
+ * ```typescript
+ * import { BaseRegistry, listAllProviders, hasProvider } from '@dexto/core';
+ *
+ * // Create a custom registry
+ * class MyRegistry extends BaseRegistry<MyProvider> {
+ *   constructor() {
+ *     super(myErrorFactory);
+ *   }
+ * }
+ *
+ * // List all providers
+ * const providers = listAllProviders();
+ * console.log('Blob providers:', providers.blob);
+ * ```
+ */
+export * from './base-registry.js';
+export * from './discovery.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,2 @@
+export * from "./base-registry.js";
+export * from "./discovery.js";

package/dist/resources/reference-parser.cjs

@@ -140,9 +140,9 @@ function formatResourceContent(resourceUri, resourceName, content) {
   contentParts.push(`
 --- Content from resource: ${resourceName} (${resourceUri}) ---`);
   for (const item of content.contents) {
-    if (item.text && typeof item.text === "string") {
+    if ("text" in item && item.text && typeof item.text === "string") {
       contentParts.push(item.text);
-    } else if (item.blob) {
+    } else if ("blob" in item && item.blob) {
       const blobSize = typeof item.blob === "string" ? item.blob.length : "unknown";
       contentParts.push(`[Binary content: ${item.mimeType || "unknown"}, ${blobSize} bytes]`);
     }
@@ -172,7 +172,7 @@ async function expandMessageReferences(message, availableResources, resourceRead
       const resource = availableResources[ref.resourceUri];
       let isImageResource = false;
       for (const item of content.contents) {
-        if (item.blob && item.mimeType && item.mimeType.startsWith("image/") && typeof item.blob === "string") {
+        if ("blob" in item && item.blob && item.mimeType && item.mimeType.startsWith("image/") && typeof item.blob === "string") {
           extractedImages.push({
             image: item.blob,
             mimeType: item.mimeType,

package/dist/resources/reference-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference-parser.d.ts","sourceRoot":"","sources":["../../src/resources/reference-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAK7E,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,eAAe,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;IAC1C,eAAe,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAMD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAuB5E;AAED,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,kBAAkB,EAAE,WAAW,GAChC,iBAAiB,EAAE,CAmCrB;AAiGD,wBAAgB,qBAAqB,CACjC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC5B,MAAM,CAaR;AAED,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,WAAW,EAC/B,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,GAC7D,OAAO,CAAC,uBAAuB,CAAC,CA8ElC"}
+{"version":3,"file":"reference-parser.d.ts","sourceRoot":"","sources":["../../src/resources/reference-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAK7E,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,eAAe,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;IAC1C,eAAe,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAMD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAuB5E;AAED,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,kBAAkB,EAAE,WAAW,GAChC,iBAAiB,EAAE,CAmCrB;AAiGD,wBAAgB,qBAAqB,CACjC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC5B,MAAM,CAaR;AAED,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,WAAW,EAC/B,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,GAC7D,OAAO,CAAC,uBAAuB,CAAC,CA+ElC"}