@makaio/framework 1.0.0-dev-1781022866275 → 1.0.0-dev-1781023871421

package/dist/index-U-A8eyGT.d.mts

@@ -0,0 +1,1490 @@
+import * as _$zod from "zod";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import { IMakaioBus } from "@makaio/framework/bus";
+import { AIModelMetadata } from "@makaio/framework/contracts";
+import { BaseService } from "@makaio/framework/service-base";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region services/core/src/model-registry/schemas.d.ts
+/**
+ * Provider-specific model override schema.
+ *
+ * Provider entries may override serving-specific model fields, but identity
+ * remains owned by the lab model reference and is resolved at merge time.
+ */
+declare const ProviderModelOverrideSchema: z.ZodObject<{
+  friendlyName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  family: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  contextWindowSize: z.ZodOptional<z.ZodNumber>;
+  supportedReasoningLevels: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+  }, z.core.$strip>>>;
+  metadata: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+      vision: z.ZodOptional<z.ZodBoolean>;
+      toolCalling: z.ZodOptional<z.ZodBoolean>;
+      parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+      structuredOutput: z.ZodOptional<z.ZodBoolean>;
+      pdfUpload: z.ZodOptional<z.ZodBoolean>;
+      speechToText: z.ZodOptional<z.ZodObject<{
+        modes: z.ZodArray<z.ZodEnum<{
+          batch: "batch";
+          streaming: "streaming";
+        }>>;
+        vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>>;
+      textToSpeech: z.ZodOptional<z.ZodObject<{
+        modes: z.ZodArray<z.ZodEnum<{
+          streaming: "streaming";
+          buffered: "buffered";
+        }>>;
+        voiceSelection: z.ZodOptional<z.ZodBoolean>;
+        voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+        outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    pricing: z.ZodOptional<z.ZodObject<{
+      token: z.ZodOptional<z.ZodObject<{
+        inputPerMillion: z.ZodNumber;
+        inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+        cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+        outputPerMillion: z.ZodNumber;
+      }, z.core.$strip>>;
+      request: z.ZodOptional<z.ZodObject<{
+        multiplier: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  canonicalModel: z.ZodOptional<z.ZodString>;
+  name: z.ZodOptional<z.ZodNever>;
+  labId: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>;
+/** Inferred type for provider-specific model overrides. */
+type ProviderModelOverride = z.infer<typeof ProviderModelOverrideSchema>;
+/**
+ * Schema for the complete v2 model registry.
+ *
+ * The v2 format separates lab definitions (canonical model metadata) from
+ * provider overrides (serving-specific fields like pricing and capabilities).
+ * This allows a single lab model to be served by multiple providers with
+ * minimal duplication.
+ */
+declare const ModelRegistrySchema: z.ZodObject<{
+  $schema: z.ZodLiteral<"makaio/model-registry/v2">;
+  updatedAt: z.ZodString;
+  labs: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    models: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      friendlyName: z.ZodOptional<z.ZodString>;
+      family: z.ZodOptional<z.ZodString>;
+      contextWindowSize: z.ZodNumber;
+      labId: z.ZodString;
+      supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+        none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+      }, z.core.$strip>>;
+      metadata: z.ZodOptional<z.ZodObject<{
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        capabilities: z.ZodOptional<z.ZodObject<{
+          vision: z.ZodOptional<z.ZodBoolean>;
+          toolCalling: z.ZodOptional<z.ZodBoolean>;
+          parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+          structuredOutput: z.ZodOptional<z.ZodBoolean>;
+          pdfUpload: z.ZodOptional<z.ZodBoolean>;
+          speechToText: z.ZodOptional<z.ZodObject<{
+            modes: z.ZodArray<z.ZodEnum<{
+              batch: "batch";
+              streaming: "streaming";
+            }>>;
+            vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+          }, z.core.$strip>>;
+          textToSpeech: z.ZodOptional<z.ZodObject<{
+            modes: z.ZodArray<z.ZodEnum<{
+              streaming: "streaming";
+              buffered: "buffered";
+            }>>;
+            voiceSelection: z.ZodOptional<z.ZodBoolean>;
+            voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+            outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        pricing: z.ZodOptional<z.ZodObject<{
+          token: z.ZodOptional<z.ZodObject<{
+            inputPerMillion: z.ZodNumber;
+            inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+            cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+            outputPerMillion: z.ZodNumber;
+          }, z.core.$strip>>;
+          request: z.ZodOptional<z.ZodObject<{
+            multiplier: z.ZodNumber;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  providers: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    models: z.ZodRecord<z.ZodString, z.ZodObject<{
+      friendlyName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      family: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      contextWindowSize: z.ZodOptional<z.ZodNumber>;
+      supportedReasoningLevels: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+      }, z.core.$strip>>>;
+      metadata: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        capabilities: z.ZodOptional<z.ZodObject<{
+          vision: z.ZodOptional<z.ZodBoolean>;
+          toolCalling: z.ZodOptional<z.ZodBoolean>;
+          parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+          structuredOutput: z.ZodOptional<z.ZodBoolean>;
+          pdfUpload: z.ZodOptional<z.ZodBoolean>;
+          speechToText: z.ZodOptional<z.ZodObject<{
+            modes: z.ZodArray<z.ZodEnum<{
+              batch: "batch";
+              streaming: "streaming";
+            }>>;
+            vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+          }, z.core.$strip>>;
+          textToSpeech: z.ZodOptional<z.ZodObject<{
+            modes: z.ZodArray<z.ZodEnum<{
+              streaming: "streaming";
+              buffered: "buffered";
+            }>>;
+            voiceSelection: z.ZodOptional<z.ZodBoolean>;
+            voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+            outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        pricing: z.ZodOptional<z.ZodObject<{
+          token: z.ZodOptional<z.ZodObject<{
+            inputPerMillion: z.ZodNumber;
+            inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+            cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+            outputPerMillion: z.ZodNumber;
+          }, z.core.$strip>>;
+          request: z.ZodOptional<z.ZodObject<{
+            multiplier: z.ZodNumber;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>>;
+      canonicalModel: z.ZodOptional<z.ZodString>;
+      name: z.ZodOptional<z.ZodNever>;
+      labId: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Inferred type for the v2 model registry.
+ */
+type ModelRegistry = z.infer<typeof ModelRegistrySchema>;
+/**
+ * Model registry bus schemas.
+ *
+ * Subjects for model-registry-related bus communication.
+ * Each key becomes a subject identifier as: `modelRegistry.{key}`
+ *
+ * **Bus subjects:**
+ * - `modelRegistry.getForProvider` — Resolve a single model for a provider
+ * - `modelRegistry.getLabModels` — List all canonical models for a lab
+ * - `modelRegistry.getProviderModels` — List all models available from a provider
+ * - `modelRegistry.refresh` — Force refresh from remote registry
+ * - `modelRegistry.changed` — Broadcast that the in-memory registry changed
+ * @example Get models for a provider
+ * ```typescript
+ * const result = await bus.request(ModelRegistrySubjects.getProviderModels, {
+ *   providerId: 'anthropic',
+ * });
+ * ```
+ * @example Force refresh from remote
+ * ```typescript
+ * await bus.request(ModelRegistrySubjects.refresh, {});
+ * ```
+ */
+declare const ModelRegistrySchemas: {
+  /**
+   * Resolve a single model by provider and provider-native model ID.
+   *
+   * Returns the merged model descriptor (lab definition + provider overrides),
+   * or `undefined` if the model is not found for the given provider.
+   */
+  getForProvider: {
+    request: z.ZodObject<{
+      providerId: z.ZodString;
+      model: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      model: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        friendlyName: z.ZodOptional<z.ZodString>;
+        family: z.ZodOptional<z.ZodString>;
+        contextWindowSize: z.ZodNumber;
+        labId: z.ZodString;
+        supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+          none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        }, z.core.$strip>>;
+        metadata: z.ZodOptional<z.ZodObject<{
+          maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+          capabilities: z.ZodOptional<z.ZodObject<{
+            vision: z.ZodOptional<z.ZodBoolean>;
+            toolCalling: z.ZodOptional<z.ZodBoolean>;
+            parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+            structuredOutput: z.ZodOptional<z.ZodBoolean>;
+            pdfUpload: z.ZodOptional<z.ZodBoolean>;
+            speechToText: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            textToSpeech: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: z.ZodOptional<z.ZodBoolean>;
+              voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+              outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          pricing: z.ZodOptional<z.ZodObject<{
+            token: z.ZodOptional<z.ZodObject<{
+              inputPerMillion: z.ZodNumber;
+              inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+              cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+              outputPerMillion: z.ZodNumber;
+            }, z.core.$strip>>;
+            request: z.ZodOptional<z.ZodObject<{
+              multiplier: z.ZodNumber;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * List all canonical model definitions published by a lab.
+   *
+   * Returns the full lab model array without any provider-specific overrides.
+   */
+  getLabModels: {
+    request: z.ZodObject<{
+      labId: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      models: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        friendlyName: z.ZodOptional<z.ZodString>;
+        family: z.ZodOptional<z.ZodString>;
+        contextWindowSize: z.ZodNumber;
+        labId: z.ZodString;
+        supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+          none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        }, z.core.$strip>>;
+        metadata: z.ZodOptional<z.ZodObject<{
+          maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+          capabilities: z.ZodOptional<z.ZodObject<{
+            vision: z.ZodOptional<z.ZodBoolean>;
+            toolCalling: z.ZodOptional<z.ZodBoolean>;
+            parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+            structuredOutput: z.ZodOptional<z.ZodBoolean>;
+            pdfUpload: z.ZodOptional<z.ZodBoolean>;
+            speechToText: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            textToSpeech: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: z.ZodOptional<z.ZodBoolean>;
+              voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+              outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          pricing: z.ZodOptional<z.ZodObject<{
+            token: z.ZodOptional<z.ZodObject<{
+              inputPerMillion: z.ZodNumber;
+              inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+              cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+              outputPerMillion: z.ZodNumber;
+            }, z.core.$strip>>;
+            request: z.ZodOptional<z.ZodObject<{
+              multiplier: z.ZodNumber;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * List all models available from a provider (merged with lab definitions).
+   *
+   * Returns the full merged model list for the provider — lab defaults with
+   * provider-specific overrides applied.
+   */
+  getProviderModels: {
+    request: z.ZodObject<{
+      providerId: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      models: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        friendlyName: z.ZodOptional<z.ZodString>;
+        family: z.ZodOptional<z.ZodString>;
+        contextWindowSize: z.ZodNumber;
+        labId: z.ZodString;
+        supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+          none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        }, z.core.$strip>>;
+        metadata: z.ZodOptional<z.ZodObject<{
+          maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+          capabilities: z.ZodOptional<z.ZodObject<{
+            vision: z.ZodOptional<z.ZodBoolean>;
+            toolCalling: z.ZodOptional<z.ZodBoolean>;
+            parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+            structuredOutput: z.ZodOptional<z.ZodBoolean>;
+            pdfUpload: z.ZodOptional<z.ZodBoolean>;
+            speechToText: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            textToSpeech: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: z.ZodOptional<z.ZodBoolean>;
+              voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+              outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          pricing: z.ZodOptional<z.ZodObject<{
+            token: z.ZodOptional<z.ZodObject<{
+              inputPerMillion: z.ZodNumber;
+              inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+              cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+              outputPerMillion: z.ZodNumber;
+            }, z.core.$strip>>;
+            request: z.ZodOptional<z.ZodObject<{
+              multiplier: z.ZodNumber;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Force refresh of the model registry from remote source.
+   * Fetches latest registry and updates cache.
+   */
+  refresh: {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+      error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Batch-check model availability across multiple providers in a single RPC.
+   *
+   * Accepts an array of provider IDs and a canonical lab model name. Returns a map of
+   * `providerId → resolved ProviderAIModel` containing only the providers
+   * that have the model. Providers absent from the registry or that do not
+   * list the model are omitted from the result.
+   *
+   * Use this subject instead of calling `getForProvider` in a loop — it
+   * collapses N sequential RPCs into a single bus request.
+   * @example
+   * ```typescript
+   * const { matches } = await bus.request(ModelRegistrySubjects.checkModelInProviders, {
+   *   providerIds: ['anthropic', 'openrouter', 'z-ai'],
+   *   model: 'claude-sonnet-4-6',
+   * });
+   * // matches: { anthropic: AIModel, openrouter: AIModel }
+   * ```
+   */
+  checkModelInProviders: {
+    request: z.ZodObject<{
+      providerIds: z.ZodArray<z.ZodString>;
+      model: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      matches: z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        friendlyName: z.ZodOptional<z.ZodString>;
+        family: z.ZodOptional<z.ZodString>;
+        contextWindowSize: z.ZodNumber;
+        labId: z.ZodString;
+        supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+          none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        }, z.core.$strip>>;
+        metadata: z.ZodOptional<z.ZodObject<{
+          maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+          capabilities: z.ZodOptional<z.ZodObject<{
+            vision: z.ZodOptional<z.ZodBoolean>;
+            toolCalling: z.ZodOptional<z.ZodBoolean>;
+            parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+            structuredOutput: z.ZodOptional<z.ZodBoolean>;
+            pdfUpload: z.ZodOptional<z.ZodBoolean>;
+            speechToText: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            textToSpeech: z.ZodOptional<z.ZodObject<{
+              modes: z.ZodArray<z.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: z.ZodOptional<z.ZodBoolean>;
+              voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+              outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          pricing: z.ZodOptional<z.ZodObject<{
+            token: z.ZodOptional<z.ZodObject<{
+              inputPerMillion: z.ZodNumber;
+              inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+              cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+              outputPerMillion: z.ZodNumber;
+            }, z.core.$strip>>;
+            request: z.ZodOptional<z.ZodObject<{
+              multiplier: z.ZodNumber;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+          includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Broadcast that the registry has been refreshed and committed.
+   *
+   * Fire-and-forget event used by consumers that need to rescan registry-backed
+   * capabilities after a successful refresh.
+   */
+  changed: z.ZodObject<{}, z.core.$strip>;
+};
+/**
+ * Type for modelRegistry.getForProvider request.
+ */
+type ModelRegistryGetForProviderRequest = z.infer<typeof ModelRegistrySchemas.getForProvider.request>;
+/**
+ * Type for modelRegistry.getForProvider response.
+ */
+type ModelRegistryGetForProviderResponse = z.infer<typeof ModelRegistrySchemas.getForProvider.response>;
+/**
+ * Type for modelRegistry.getLabModels request.
+ */
+type ModelRegistryGetLabModelsRequest = z.infer<typeof ModelRegistrySchemas.getLabModels.request>;
+/**
+ * Type for modelRegistry.getLabModels response.
+ */
+type ModelRegistryGetLabModelsResponse = z.infer<typeof ModelRegistrySchemas.getLabModels.response>;
+/**
+ * Type for modelRegistry.getProviderModels request.
+ */
+type ModelRegistryGetProviderModelsRequest = z.infer<typeof ModelRegistrySchemas.getProviderModels.request>;
+/**
+ * Type for modelRegistry.getProviderModels response.
+ */
+type ModelRegistryGetProviderModelsResponse = z.infer<typeof ModelRegistrySchemas.getProviderModels.response>;
+/**
+ * Type for modelRegistry.refresh request.
+ */
+type ModelRegistryRefreshRequest = z.infer<typeof ModelRegistrySchemas.refresh.request>;
+/**
+ * Type for modelRegistry.refresh response.
+ */
+type ModelRegistryRefreshResponse = z.infer<typeof ModelRegistrySchemas.refresh.response>;
+/**
+ * Type for modelRegistry.checkModelInProviders request.
+ */
+type ModelRegistryCheckModelInProvidersRequest = z.infer<typeof ModelRegistrySchemas.checkModelInProviders.request>;
+/**
+ * Type for modelRegistry.checkModelInProviders response.
+ */
+type ModelRegistryCheckModelInProvidersResponse = z.infer<typeof ModelRegistrySchemas.checkModelInProviders.response>;
+//#endregion
+//#region services/core/src/model-registry/namespace.d.ts
+/**
+ * Model Registry namespace for accessing model information.
+ *
+ * Provides bus subjects for:
+ * - Resolving a single model for a provider
+ * - Listing all models for a lab or provider
+ * - Refreshing registry from remote source
+ * - Observing registry refresh commits
+ *
+ * Prefix: 'modelRegistry.'
+ * @example
+ * ```typescript
+ * // Get all models for a provider
+ * const result = await bus.request(ModelRegistrySubjects.getProviderModels, {
+ *   providerId: 'anthropic',
+ * });
+ *
+ * // Resolve a single model
+ * const resolved = await bus.request(ModelRegistrySubjects.getForProvider, {
+ *   providerId: 'anthropic',
+ *   model: 'claude-sonnet-4-6',
+ * });
+ *
+ * // Force refresh from remote
+ * await bus.request(ModelRegistrySubjects.refresh, {});
+ *
+ * // Observe committed refreshes
+ * bus.on(ModelRegistrySubjects.changed, () => {
+ *   // Rescan dependent providers
+ * });
+ * ```
+ */
+declare const ModelRegistryNamespace: _$_makaio_core0.BusNamespaceDefinition<"modelRegistry", {
+  getForProvider: {
+    request: _$zod.ZodObject<{
+      providerId: _$zod.ZodString;
+      model: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      model: _$zod.ZodOptional<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  getLabModels: {
+    request: _$zod.ZodObject<{
+      labId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      models: _$zod.ZodArray<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  getProviderModels: {
+    request: _$zod.ZodObject<{
+      providerId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      models: _$zod.ZodArray<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  refresh: {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+      error: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  checkModelInProviders: {
+    request: _$zod.ZodObject<{
+      providerIds: _$zod.ZodArray<_$zod.ZodString>;
+      model: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      matches: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  changed: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+}>;
+/**
+ * Pre-extracted subjects for direct import.
+ * @example
+ * ```typescript
+ * import { ModelRegistrySubjects } from '@makaio/framework/services/model-registry';
+ *
+ * bus.on(ModelRegistrySubjects.getProviderModels, (ctx) => {
+ *   ctx.setResult({ models: resolveModels(ctx.payload.providerId) });
+ * });
+ * ```
+ */
+declare const ModelRegistrySubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"modelRegistry", {
+  getForProvider: {
+    request: _$zod.ZodObject<{
+      providerId: _$zod.ZodString;
+      model: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      model: _$zod.ZodOptional<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  getLabModels: {
+    request: _$zod.ZodObject<{
+      labId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      models: _$zod.ZodArray<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  getProviderModels: {
+    request: _$zod.ZodObject<{
+      providerId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      models: _$zod.ZodArray<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  refresh: {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+      error: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  checkModelInProviders: {
+    request: _$zod.ZodObject<{
+      providerIds: _$zod.ZodArray<_$zod.ZodString>;
+      model: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      matches: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodObject<{
+        name: _$zod.ZodString;
+        friendlyName: _$zod.ZodOptional<_$zod.ZodString>;
+        family: _$zod.ZodOptional<_$zod.ZodString>;
+        contextWindowSize: _$zod.ZodNumber;
+        labId: _$zod.ZodString;
+        supportedReasoningLevels: _$zod.ZodOptional<_$zod.ZodObject<{
+          none: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          low: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          medium: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          high: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+          'extra-high': _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+        }, _$zod_v4_core0.$strip>>;
+        metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+          maxOutputTokens: _$zod.ZodOptional<_$zod.ZodNumber>;
+          capabilities: _$zod.ZodOptional<_$zod.ZodObject<{
+            vision: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            toolCalling: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            parallelToolCalls: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            structuredOutput: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            pdfUpload: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            speechToText: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                batch: "batch";
+                streaming: "streaming";
+              }>>;
+              vocabularyBiasing: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            }, _$zod_v4_core0.$strip>>;
+            textToSpeech: _$zod.ZodOptional<_$zod.ZodObject<{
+              modes: _$zod.ZodArray<_$zod.ZodEnum<{
+                streaming: "streaming";
+                buffered: "buffered";
+              }>>;
+              voiceSelection: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              voiceInstructions: _$zod.ZodOptional<_$zod.ZodBoolean>;
+              outputFormats: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          pricing: _$zod.ZodOptional<_$zod.ZodObject<{
+            token: _$zod.ZodOptional<_$zod.ZodObject<{
+              inputPerMillion: _$zod.ZodNumber;
+              inputCachedPerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              cacheWritePerMillion: _$zod.ZodOptional<_$zod.ZodNumber>;
+              outputPerMillion: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+            request: _$zod.ZodOptional<_$zod.ZodObject<{
+              multiplier: _$zod.ZodNumber;
+            }, _$zod_v4_core0.$strip>>;
+          }, _$zod_v4_core0.$strip>>;
+          includedInSubscription: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  changed: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+}>, "modelRegistry">;
+//#endregion
+//#region services/core/src/model-registry/types.d.ts
+/**
+ * Storage interface for model registry cache persistence.
+ *
+ * Allows for different implementations across environments:
+ * - Browser: localStorage
+ * - Node.js: File system cache
+ * - Testing: In-memory cache
+ * @example Browser localStorage implementation
+ * ```typescript
+ * class LocalStorageRegistryCache implements IModelRegistryCache {
+ *   async get(): Promise<ModelRegistry | null> {
+ *     const data = localStorage.getItem('makaio:model-registry');
+ *     return data ? JSON.parse(data) : null;
+ *   }
+ *
+ *   async set(registry: ModelRegistry): Promise<void> {
+ *     localStorage.setItem('makaio:model-registry', JSON.stringify(registry));
+ *   }
+ * }
+ * ```
+ * @example Node.js file-based implementation
+ * ```typescript
+ * class FileRegistryCache implements IModelRegistryCache {
+ *   async get(): Promise<ModelRegistry | null> {
+ *     try {
+ *       const content = await fs.readFile('~/.makaio/cache/model-registry.json', 'utf-8');
+ *       return JSON.parse(content);
+ *     } catch {
+ *       return null;
+ *     }
+ *   }
+ *
+ *   async set(registry: ModelRegistry): Promise<void> {
+ *     await fs.writeFile('~/.makaio/cache/model-registry.json', JSON.stringify(registry));
+ *   }
+ * }
+ * ```
+ */
+interface IModelRegistryCache {
+  /**
+   * Get the cached model registry.
+   * @returns The cached registry, or null if not cached
+   */
+  get(): Promise<ModelRegistry | null>;
+  /**
+   * Save the model registry to cache.
+   * @param registry - The registry to cache
+   */
+  set(registry: ModelRegistry): Promise<void>;
+}
+/**
+ * Interface for fetching the model registry from a source.
+ *
+ * Allows for different fetch implementations:
+ * - CDN/HTTP fetch (browser/Node)
+ * - Local YAML files
+ * - Bundled seed
+ * - Testing: Mock fetch
+ * @example CDN fetch implementation
+ * ```typescript
+ * class CdnRegistryFetcher implements IModelRegistryFetcher {
+ *   constructor(private readonly registryUrl: string) {}
+ *
+ *   async fetch(): Promise<ModelRegistry> {
+ *     const response = await fetch(this.registryUrl);
+ *     if (!response.ok) {
+ *       throw new Error(`Failed to fetch registry: ${response.statusText}`);
+ *     }
+ *     return parseYaml(await response.text()) as ModelRegistry;
+ *   }
+ * }
+ * ```
+ */
+interface IModelRegistryFetcher {
+  /**
+   * Fetch the model registry from a source.
+   *
+   * Implementations MUST return the result of `ModelRegistrySchema.parse()` —
+   * i.e., a fully validated {@link ModelRegistry}. The service layer trusts
+   * the returned value directly and does not re-validate it, so schema
+   * validation (including the `superRefine` cross-validation) is the
+   * responsibility of the fetcher implementation.
+   * @returns The validated model registry
+   * @throws Error if fetch fails or schema validation fails
+   */
+  fetch(): Promise<ModelRegistry>;
+}
+//#endregion
+//#region services/core/src/model-registry/model-registry-service.d.ts
+/**
+ * Options for creating a ModelRegistryService instance.
+ */
+interface ModelRegistryServiceOptions {
+  /**
+   * The bus instance for registering handlers.
+   */
+  bus: IMakaioBus;
+  /**
+   * Fetcher implementation for retrieving the registry.
+   *
+   * Typically a {@link FallbackRegistryFetcher} chain that composes
+   * user overrides, cached CDN, and bundled static sources.
+   */
+  fetcher: IModelRegistryFetcher;
+}
+/** Error thrown when a provider definition is absent from the loaded model registry. */
+declare class ModelRegistryProviderNotFoundError extends Error {
+  /** Stable provider definition identifier requested from the registry. */
+  readonly providerId: string;
+  /**
+   * Create a provider-not-found registry error.
+   * @param providerId - Stable provider definition identifier that was missing.
+   */
+  constructor(providerId: string);
+}
+/**
+ * Service for managing model registry operations via bus handlers.
+ *
+ * Responsibilities:
+ * - Resolve model registry through the injected fetcher (chain)
+ * - Hold in-memory cache, deduplicate concurrent requests
+ * - Register bus handlers for getForProvider, getLabModels, getProviderModels,
+ *   checkModelInProviders, and refresh
+ * - Emit modelRegistry.changed after a committed refresh
+ * - Follow init/destroy lifecycle pattern with idempotent guards
+ *
+ * Schema validation (including `superRefine` cross-validation) is delegated to
+ * the fetcher chain. The service trusts the registry returned by the fetcher.
+ *
+ * Caching and fallback logic lives in the fetcher chain, not here.
+ * This service only manages in-memory state and bus wiring.
+ * @example
+ * ```typescript
+ * const service = new ModelRegistryService({
+ *   bus: MakaioBus,
+ *   fetcher: new UserOverlayFetcher(
+ *     userModelsDir,
+ *     new FallbackRegistryFetcher([
+ *       new CachedRegistryFetcher(new CdnRegistryFetcher(registryUrl), fileCache),
+ *       new BundledSeedFetcher(seedPath),
+ *     ]),
+ *   ),
+ * });
+ * await service.init();
+ * ```
+ */
+declare class ModelRegistryService extends BaseService {
+  private readonly fetcher;
+  private registry;
+  private labModelIndex;
+  private fetchPromise;
+  private refreshPromise;
+  private fetchGeneration;
+  /**
+   * Creates a new ModelRegistryService instance.
+   * @param options - Service configuration options
+   */
+  constructor(options: ModelRegistryServiceOptions);
+  /**
+   * Register bus handlers for model registry operations.
+   */
+  protected onInit(): void;
+  /**
+   * Clear in-memory registry cache on destroy.
+   */
+  protected onDestroy(): void;
+  /**
+   * Ensure registry is loaded, fetching if necessary.
+   *
+   * Resolution order:
+   * 1. In-memory (this.registry) — instant
+   * 2. Fetcher chain — delegates all source resolution and caching
+   *
+   * Concurrent requests share a single fetch promise to avoid redundant work.
+   * Returns both the registry and a lab model index that is coherent with it.
+   * When the registry was committed (the common case), the cached index is
+   * returned directly. For in-flight stale fetches that committed to a
+   * different generation, the index is built on-demand from the returned
+   * registry so callers always receive a consistent pair.
+   * @returns Registry and coherent lab model index.
+   * @throws Error when the registry cannot be loaded from any configured source.
+   */
+  private ensureRegistryWithIndex;
+  /**
+   * Refresh the registry from the fetcher chain.
+   *
+   * If a registry fetch is already active, refresh joins that fetch instead
+   * of starting a competing one. Otherwise it clears in-memory state so the
+   * full fetcher chain is re-evaluated.
+   * @throws Error if the fetcher chain fails
+   */
+  private refreshRegistry;
+  /**
+   * Await an active registry fetch on behalf of a refresh request.
+   * @param fetchPromise - Active registry fetch to share with the refresh.
+   * @throws Error if the fetcher chain fails or the shared fetch cannot commit.
+   */
+  private awaitActiveFetchForRefresh;
+  /**
+   * Run the single active forced refresh when no registry fetch is in flight.
+   * @throws Error if the fetcher chain fails or the refresh cannot commit.
+   */
+  private runRefresh;
+  /**
+   * Notify subscribers that the committed model registry changed.
+   */
+  private emitRegistryChanged;
+  /**
+   * Start the single active fetch for a registry generation.
+   *
+   * Both initial loads and forced refreshes install the promise returned here
+   * as {@link fetchPromise}. That keeps one owner per generation: concurrent
+   * requests await the same fetch and stale generations cannot clear a newer
+   * active fetch.
+   * @param generation - The generation captured at fetch start.
+   * @returns Parsed model registry and whether it committed for the requested generation.
+   */
+  private startRegistryFetch;
+  /**
+   * Commit a freshly parsed registry if the service generation is still current.
+   *
+   * Generation bumps on destroy() invalidate in-flight fetches and prevent
+   * stale data from repopulating the cache after teardown. Also builds and
+   * caches the lab model index so per-request calls to `getProviderModels` and
+   * `getForProvider` avoid redundant iteration over the full lab list.
+   * @param generation - The generation captured at fetch start.
+   * @param registry - The parsed registry to commit.
+   * @returns True when the registry was committed, false when the result was stale.
+   */
+  private commitRegistry;
+  /**
+   * Resolve a single model for a provider by merging lab definition with provider overrides.
+   * @param registry - The current model registry.
+   * @param index - Lab model index coherent with the registry.
+   * @param providerId - The provider identifier.
+   * @param providerModelId - The provider-native model identifier to resolve.
+   * @returns The merged model descriptor, or `undefined` if not found.
+   */
+  private resolveProviderModel;
+  /**
+   * Resolve the provider offering that corresponds to a canonical lab model name.
+   * @param registry - The current model registry.
+   * @param index - Lab model index coherent with the registry.
+   * @param providerId - The provider identifier.
+   * @param canonicalModelName - Canonical lab model name to check.
+   * @returns The merged provider model descriptor, or `undefined` if not found.
+   */
+  private resolveProviderModelByCanonicalName;
+  /**
+   * Resolve all models for a provider, each merged with its lab definition.
+   * @param registry - The current model registry.
+   * @param index - Lab model index coherent with the registry.
+   * @param providerId - The provider identifier.
+   * @returns Array of merged model descriptors for the provider.
+   * @throws Error when the provider is not present in the registry.
+   */
+  private resolveAllProviderModels;
+  /**
+   * Resolve SDK-safe model descriptors across every provider.
+   * @param registry - The current model registry.
+   * @param index - Lab model index coherent with the registry.
+   * @returns Provider-tagged model descriptors for SDK introspection.
+   */
+  private resolveSupportedModels;
+  /**
+   * Build an index of all lab models keyed by name for efficient lookup.
+   * @param registry - The current model registry.
+   * @returns Map of model name to lab model descriptor.
+   */
+  private buildLabModelIndex;
+  /**
+   * Merge a lab model with provider-specific overrides.
+   *
+   * Provider overrides replace lab values field-by-field.
+   * Metadata merges at the top level, while provider `capabilities`
+   * and `pricing` metadata replace the corresponding lab block whole.
+   * The returned `name` is the provider-native model ID because that is the
+   * identifier callers must send back to the provider API.
+   * @param providerModelId - Provider-native model identifier.
+   * @param labModel - The canonical model definition from the lab.
+   * @param overrides - Provider-specific field overrides.
+   * @returns The merged model descriptor.
+   */
+  private mergeModel;
+  /**
+   * Clone a provider-resolved model descriptor (with required `labId`).
+   *
+   * Delegates structural cloning to {@link cloneModel} and re-spreads `labId`
+   * so TypeScript knows the result is a `ProviderAIModel`.
+   * @param model - Cached provider model descriptor to clone.
+   * @returns A structurally independent provider model descriptor.
+   */
+  private cloneProviderModel;
+  /**
+   * Clone a model descriptor before returning it through in-process bus APIs.
+   * @param model - Cached model descriptor to clone.
+   * @returns A structurally independent model descriptor.
+   */
+  private cloneModel;
+}
+//#endregion
+//#region services/core/src/model-registry/fallback-registry-fetcher.d.ts
+/**
+ * Tries multiple fetchers in order, returning the first successful result.
+ *
+ * Each fetcher is attempted sequentially. On success, returns immediately.
+ * On failure, moves to the next fetcher. If all fetchers fail, throws the
+ * last error encountered.
+ * @example
+ * ```typescript
+ * const fetcher = new FallbackRegistryFetcher([
+ *   new CachedRegistryFetcher(new CdnRegistryFetcher(cdnUrl), fileCache),
+ *   new BundledSeedFetcher(seedPath),
+ * ]);
+ * ```
+ */
+declare class FallbackRegistryFetcher implements IModelRegistryFetcher {
+  private readonly fetchers;
+  /**
+   * Creates a new FallbackRegistryFetcher.
+   * @param fetchers - Ordered list of fetchers to try (first match wins)
+   * @throws Error if fetchers array is empty
+   */
+  constructor(fetchers: IModelRegistryFetcher[]);
+  /**
+   * Try each fetcher in order, returning the first successful result.
+   * @returns The model registry from the first successful fetcher
+   * @throws The last error if all fetchers fail
+   */
+  fetch(): Promise<ModelRegistry>;
+}
+//#endregion
+//#region services/core/src/model-registry/cached-registry-fetcher.d.ts
+/**
+ * Decorator that adds disk/persistent caching around a fetcher.
+ *
+ * On success: caches the result for future use.
+ * On failure: returns cached data if available, otherwise rethrows
+ * so the next fetcher in a fallback chain can be tried.
+ * @example
+ * ```typescript
+ * const cached = new CachedRegistryFetcher(
+ *   new CdnRegistryFetcher('https://example.com/model-registry.yaml'),
+ *   new FileRegistryCache(path.join(makaioHome, 'cache', 'model-registry.json')),
+ * );
+ * ```
+ */
+declare class CachedRegistryFetcher implements IModelRegistryFetcher {
+  private readonly inner;
+  private readonly cache;
+  /**
+   * Creates a new CachedRegistryFetcher.
+   * @param inner - The fetcher to wrap with caching
+   * @param cache - The cache implementation for persistence
+   */
+  constructor(inner: IModelRegistryFetcher, cache: IModelRegistryCache);
+  /**
+   * Fetch from the inner fetcher with cache fallback.
+   * @returns Registry from inner fetcher (fresh) or cache (stale fallback)
+   * @throws Error if inner fetch fails and no cached data exists
+   */
+  fetch(): Promise<ModelRegistry>;
+}
+//#endregion
+//#region services/core/src/model-registry/merge-utils.d.ts
+/**
+ * Merge model metadata with block-level replacement and defensive clone semantics.
+ *
+ * Top-level metadata fields merge field-by-field. When an overlay supplies
+ * `capabilities` or `pricing`, that whole block replaces the base block.
+ * Returned metadata is structurally independent from both inputs.
+ * @param baseMetadata - Metadata supplied by the base model.
+ * @param overlayMetadata - Metadata supplied by the overlay model.
+ * @returns Merged metadata, or undefined when neither side supplies metadata.
+ */
+declare function mergeModelMetadata(baseMetadata: AIModelMetadata | undefined, overlayMetadata: AIModelMetadata | undefined): AIModelMetadata | undefined;
+//#endregion
+export { ModelRegistrySchemas as C, ModelRegistrySchema as S, ProviderModelOverrideSchema as T, ModelRegistryGetLabModelsResponse as _, ModelRegistryService as a, ModelRegistryRefreshRequest as b, IModelRegistryFetcher as c, ModelRegistry as d, ModelRegistryCheckModelInProvidersRequest as f, ModelRegistryGetLabModelsRequest as g, ModelRegistryGetForProviderResponse as h, ModelRegistryProviderNotFoundError as i, ModelRegistryNamespace as l, ModelRegistryGetForProviderRequest as m, CachedRegistryFetcher as n, ModelRegistryServiceOptions as o, ModelRegistryCheckModelInProvidersResponse as p, FallbackRegistryFetcher as r, IModelRegistryCache as s, mergeModelMetadata as t, ModelRegistrySubjects as u, ModelRegistryGetProviderModelsRequest as v, ProviderModelOverride as w, ModelRegistryRefreshResponse as x, ModelRegistryGetProviderModelsResponse as y };