@mastra/core 0.20.2 → 0.21.0-alpha.1

package/dist/llm/model/provider-registry.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Runtime provider registry loader
+ * Loads provider data from JSON file and exports typed interfaces
+ */
+import type { ProviderConfig } from './gateways/base.js';
+import type { Provider, ModelForProvider, ModelRouterModelId, ProviderModels } from './provider-types.generated.js';
+export type { Provider, ModelForProvider, ModelRouterModelId, ProviderModels };
+export declare const PROVIDER_REGISTRY: Record<Provider, ProviderConfig>;
+export declare const PROVIDER_MODELS: ProviderModels;
+/**
+ * Parse a model string to extract provider and model ID
+ * Examples:
+ *   "openai/gpt-4o" -> { provider: "openai", modelId: "gpt-4o" }
+ *   "fireworks/accounts/etc/model" -> { provider: "fireworks", modelId: "accounts/etc/model" }
+ *   "gpt-4o" -> { provider: null, modelId: "gpt-4o" }
+ */
+export declare function parseModelString(modelString: string): {
+    provider: string | null;
+    modelId: string;
+};
+/**
+ * Get provider configuration by provider ID
+ */
+export declare function getProviderConfig(providerId: string): ProviderConfig | undefined;
+/**
+ * Check if a provider is registered
+ */
+export declare function isProviderRegistered(providerId: string): boolean;
+/**
+ * Get all registered provider IDs
+ */
+export declare function getRegisteredProviders(): string[];
+/**
+ * Type guard to check if a string is a valid OpenAI-compatible model ID
+ */
+export declare function isValidModelId(modelId: string): modelId is ModelRouterModelId;
+export interface GatewayRegistryOptions {
+    /**
+     * Enable dynamic loading from file system instead of using static bundled registry.
+     * Required for syncGateways() and auto-refresh to work.
+     * Defaults to true when MASTRA_DEV=true, false otherwise.
+     */
+    useDynamicLoading?: boolean;
+}
+/**
+ * GatewayRegistry - Manages dynamic loading and refreshing of provider data from gateways
+ * Singleton class that handles runtime updates to the provider registry
+ */
+export declare class GatewayRegistry {
+    private static instance;
+    private lastRefreshTime;
+    private refreshInterval;
+    private isRefreshing;
+    private useDynamicLoading;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(options?: GatewayRegistryOptions): GatewayRegistry;
+    /**
+     * Sync providers from all gateways
+     * Requires dynamic loading to be enabled (useDynamicLoading=true).
+     * @param forceRefresh - Force refresh even if recently synced
+     * @param writeToSrc - Write to src/ directory in addition to dist/ (useful for manual generation in repo)
+     */
+    syncGateways(forceRefresh?: boolean, writeToSrc?: boolean): Promise<void>;
+    /**
+     * Get the last refresh time (from memory or disk cache)
+     */
+    getLastRefreshTime(): Date | null;
+    /**
+     * Start auto-refresh on an interval
+     * Requires dynamic loading to be enabled (useDynamicLoading=true).
+     * @param intervalMs - Interval in milliseconds (default: 1 hour)
+     */
+    startAutoRefresh(intervalMs?: number): void;
+    /**
+     * Stop auto-refresh
+     */
+    stopAutoRefresh(): void;
+    /**
+     * Get provider configuration by ID
+     */
+    getProviderConfig(providerId: string): ProviderConfig | undefined;
+    /**
+     * Check if a provider is registered
+     */
+    isProviderRegistered(providerId: string): boolean;
+    /**
+     * Get all registered providers
+     */
+    getProviders(): Record<string, ProviderConfig>;
+    /**
+     * Get all models
+     */
+    getModels(): Record<string, string[]>;
+}
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/llm/model/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../../src/llm/model/provider-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpH,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC;AAoG/E,eAAO,MAAM,iBAAiB,EA2BxB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AAEvC,eAAO,MAAM,eAAe,gBA2B1B,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqBlG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAIjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,kBAAkB,CAG7E;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAU;IAEnC,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe;IAOrE;;;;;OAKG;IACG,YAAY,CAAC,YAAY,UAAQ,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiE3E;;OAEG;IACH,kBAAkB,IAAI,IAAI,GAAG,IAAI;IAIjC;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,SAAiB,GAAG,IAAI;IAgDnD;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKjE;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAKjD;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAK9C;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAGtC"}