@genesislcap/foundation-ai 14.444.1 → 14.445.1

package/dist/dts/ai-provider.d.ts

@@ -1,3 +1,4 @@
+import { type Container } from '@microsoft/fast-foundation';
 import type { CriteriaInterpretContext } from './interactions';
 import { type AIConfig, type AIStatus, type CriteriaInterpretationResult } from './types';
 import type { ChatMessage, ChatRequestOptions, ChatStreamChunk } from './types/chat.types';
@@ -78,34 +79,144 @@ export interface ResolveAIConfigOptions {
  */
 export declare function resolveAIConfig(options?: ResolveAIConfigOptions): Promise<AIConfig | null>;
 /**
- * The DI token for the AIProvider interface.
+ * One entry in {@link (AIProviderRegistry:interface).listStatuses}. Pairs the
+ * registered name with a status payload (or `null` when the provider doesn't
+ * implement {@link AIProvider.getStatus}).
+ *
+ * @beta
+ */
+export interface AIProviderRegistryStatusEntry {
+    /** The name the provider was registered under. */
+    name: string;
+    /** True when this is the registry's default provider. */
+    isDefault: boolean;
+    /** The provider's `getStatus()` result, or `null` if unavailable. */
+    status: AIStatus | null;
+}
+/**
+ * Registry of named AI providers. Replaces the single-provider DI token —
+ * hosts register one or more named providers and consumers can either ask
+ * for the default or resolve a specific provider by name.
+ *
+ * If no host registration happens, the DI container resolves a built-in
+ * empty registry — every lookup returns a no-op provider.
  *
  * @remarks
- * Register a provider implementation in app bootstrap (e.g. main.ts):
+ * Register from app bootstrap with the {@link registerAIProviders} helper:
  * ```ts
- * Registration.singleton(AIProvider, OpenAIProvider)
+ * registerAIProviders(container, { openai: provider });
+ * // or, for multi-provider:
+ * registerAIProviders(container, { openai, anthropic }, { default: 'openai' });
  * ```
  *
+ * @beta
+ */
+export interface AIProviderRegistry {
+    /** Look up a registered provider by name. Returns `undefined` if no such name is registered. */
+    get(name: string): AIProvider | undefined;
+    /** The default provider — used when an agent doesn't specify one. */
+    default(): AIProvider;
+    /** Name of the default provider. Useful for status display. */
+    defaultName(): string;
+    /** All registered provider names, in registration order. */
+    names(): string[];
+    /**
+     * Returns the status payload for a single named provider, or for the
+     * default when `name` is omitted. Returns `null` when the provider doesn't
+     * implement {@link AIProvider.getStatus} or returns null.
+     */
+    getStatus(name?: string): Promise<AIStatus | null>;
+    /**
+     * Returns statuses for all registered providers in registration order.
+     * Each entry carries the registered name and an `isDefault` flag.
+     */
+    listStatuses(): Promise<AIProviderRegistryStatusEntry[]>;
+}
+/**
+ * Built-in fallback registry. Resolved by the DI container when no host has
+ * registered an {@link (AIProviderRegistry:interface)}. Holds a single
+ * `DefaultAIProvider` (no-op) under the name `'default'`, preserving the
+ * "no host registration → assistant inert" behavior.
+ *
+ * @internal
+ */
+export declare class EmptyAIProviderRegistry implements AIProviderRegistry {
+    private static readonly DEFAULT_NAME;
+    private readonly noopProvider;
+    get(name: string): AIProvider | undefined;
+    default(): AIProvider;
+    defaultName(): string;
+    names(): string[];
+    getStatus(name?: string): Promise<AIStatus | null>;
+    listStatuses(): Promise<AIProviderRegistryStatusEntry[]>;
+}
+/**
+ * Map-backed registry built by {@link registerAIProviders}. Preserves the
+ * insertion order of `providers` for {@link (AIProviderRegistry:interface).names}
+ * and {@link (AIProviderRegistry:interface).listStatuses}.
+ *
  * @internal
  */
-export declare const AIProvider: import("@microsoft/fast-foundation").InterfaceSymbol<AIProvider>;
+export declare class MapBackedAIProviderRegistry implements AIProviderRegistry {
+    private readonly providers;
+    private readonly _defaultName;
+    constructor(providers: Map<string, AIProvider>, defaultName: string);
+    get(name: string): AIProvider | undefined;
+    default(): AIProvider;
+    defaultName(): string;
+    names(): string[];
+    getStatus(name?: string): Promise<AIStatus | null>;
+    listStatuses(): Promise<AIProviderRegistryStatusEntry[]>;
+}
+/**
+ * The DI token for the {@link (AIProviderRegistry:interface)}. When no host
+ * registers a concrete registry, the container resolves the built-in empty
+ * registry (a single no-op provider) so consumers degrade to inert rather
+ * than throwing.
+ *
+ * Prefer the {@link registerAIProviders} helper over registering this token
+ * directly.
+ *
+ * @beta
+ */
+export declare const AIProviderRegistry: import("@microsoft/fast-foundation").InterfaceSymbol<AIProviderRegistry>;
 /**
- * Gets AIProvider from the DI container.
- * When the AI feature flag is disabled (?feature.ai), returns DefaultAIProvider (no-op).
+ * Options for {@link registerAIProviders}.
+ *
+ * @beta
+ */
+export interface RegisterAIProvidersOptions {
+    /**
+     * Name of the provider to use as the default — must be a key in the
+     * `providers` map. Required when more than one provider is registered;
+     * inferred when exactly one is registered.
+     */
+    default?: string;
+}
+/**
+ * Registers one or more named AI providers as an {@link (AIProviderRegistry:interface)}
+ * on the given DI container.
  *
  * @remarks
- * A utility method for host applications that are not using decorators or the DI container.
+ * - With a single provider, the default is inferred — `options.default` may be omitted.
+ * - With multiple providers, `options.default` is required to avoid implicit ordering.
+ * - Throws when `providers` is empty, when the named default isn't present, or
+ *   when multiple providers are passed without an explicit default.
  *
  * @example
  * ```ts
- * import { getAIProvider } from '@genesislcap/foundation-ai';
- * ...
- * private aiProvider = getAIProvider();
- * ...
- * const result = await this.aiProvider.interpretCriteria?.(input, context);
+ * // Single provider — default inferred
+ * registerAIProviders(container, { openai: createAIProvider(openAiConfig) });
+ *
+ * // Multiple providers — explicit default
+ * registerAIProviders(
+ *   container,
+ *   { fast: chromeProvider, deep: anthropicProvider },
+ *   { default: 'deep' },
+ * );
  * ```
  *
  * @beta
  */
-export declare function getAIProvider(): AIProvider;
+export declare function registerAIProviders(container: Container, providers: Record<string, AIProvider>, options?: RegisterAIProvidersOptions): void;
 //# sourceMappingURL=ai-provider.d.ts.map

package/dist/dts/ai-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/ai-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAU/D,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAIb,KAAK,4BAA4B,EAIlC,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI3F;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEvC;;;OAGG;IACH,eAAe,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;OAGG;IACH,IAAI,CAAC,CACH,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;OAGG;IACH,UAAU,CAAC,CACT,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,eAAe,CAAC,CAAC;CACnC;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,UAAU,CA8CrE;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA0C1B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,kEAAwE,CAAC;AAEhG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAM1C"}
+{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/ai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAU/D,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAIb,KAAK,4BAA4B,EAIlC,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI3F;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEvC;;;OAGG;IACH,eAAe,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;OAGG;IACH,IAAI,CAAC,CACH,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;OAGG;IACH,UAAU,CAAC,CACT,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,eAAe,CAAC,CAAC;CACnC;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,UAAU,CA8CrE;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA0C1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,qEAAqE;IACrE,OAAO,IAAI,UAAU,CAAC;IACtB,+DAA+D;IAC/D,WAAW,IAAI,MAAM,CAAC;IACtB,4DAA4D;IAC5D,KAAK,IAAI,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACnD;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,6BAA6B,EAAE,CAAC,CAAC;CAC1D;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IAExD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC,OAAO,IAAI,UAAU;IAIrB,WAAW,IAAI,MAAM;IAIrB,KAAK,IAAI,MAAM,EAAE;IAIX,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAKlD,YAAY,IAAI,OAAO,CAAC,6BAA6B,EAAE,CAAC;CAI/D;AAED;;;;;;GAMG;AACH,qBAAa,2BAA4B,YAAW,kBAAkB;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,MAAM;IAanE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC,OAAO,IAAI,UAAU;IAKrB,WAAW,IAAI,MAAM;IAIrB,KAAK,IAAI,MAAM,EAAE;IAIX,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAMlD,YAAY,IAAI,OAAO,CAAC,6BAA6B,EAAE,CAAC;CAU/D;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,0EAE9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACrC,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAwBN"}

package/dist/dts/index.d.ts

@@ -1,4 +1,5 @@
-export { AIProvider, createAIProvider, getAIProvider, resolveAIConfig } from './ai-provider';
+export { AIProviderRegistry, createAIProvider, registerAIProviders, resolveAIConfig, } from './ai-provider';
+export type { AIProvider, AIProviderRegistryStatusEntry, RegisterAIProvidersOptions, } from './ai-provider';
 export { AnthropicProvider } from './providers/anthropic-provider';
 export { GeminiProvider } from './providers/gemini-provider';
 export { AnthropicTransport } from './transports/anthropic-transport';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACpF,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,4BAA4B,EAC5B,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,UAAU,EACV,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACpF,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,4BAA4B,EAC5B,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/dts/providers/chrome-provider.d.ts

@@ -9,7 +9,7 @@ import type { AIStatus, ChromeAIConfig, CriteriaInterpretationResult } from '../
  * Requires Chrome 138+
  * Configure in app bootstrap:
  * ```ts
- * Registration.instance(AIProvider, new ChromeProvider({ providerType: 'chrome' }))
+ * registerAIProviders(container, { chrome: new ChromeProvider({ providerType: 'chrome' }) });
  * ```
  *
  * @beta

package/dist/esm/ai-provider.js

@@ -1,5 +1,5 @@
 import { __awaiter } from "tslib";
-import { DI } from '@microsoft/fast-foundation';
+import { DI, Registration } from '@microsoft/fast-foundation';
 import { AnthropicProvider } from './providers/anthropic-provider';
 import { ChromeProvider } from './providers/chrome-provider';
 import { DefaultAIProvider } from './providers/default-provider';
@@ -120,38 +120,155 @@ export function resolveAIConfig() {
     });
 }
 /**
- * The DI token for the AIProvider interface.
+ * Built-in fallback registry. Resolved by the DI container when no host has
+ * registered an {@link (AIProviderRegistry:interface)}. Holds a single
+ * `DefaultAIProvider` (no-op) under the name `'default'`, preserving the
+ * "no host registration → assistant inert" behavior.
  *
- * @remarks
- * Register a provider implementation in app bootstrap (e.g. main.ts):
- * ```ts
- * Registration.singleton(AIProvider, OpenAIProvider)
- * ```
+ * @internal
+ */
+export class EmptyAIProviderRegistry {
+    constructor() {
+        this.noopProvider = new DefaultAIProvider();
+    }
+    get(name) {
+        return name === EmptyAIProviderRegistry.DEFAULT_NAME ? this.noopProvider : undefined;
+    }
+    default() {
+        return this.noopProvider;
+    }
+    defaultName() {
+        return EmptyAIProviderRegistry.DEFAULT_NAME;
+    }
+    names() {
+        return [EmptyAIProviderRegistry.DEFAULT_NAME];
+    }
+    getStatus(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            if (name !== undefined && name !== EmptyAIProviderRegistry.DEFAULT_NAME)
+                return null;
+            return (_c = (yield ((_b = (_a = this.noopProvider).getStatus) === null || _b === void 0 ? void 0 : _b.call(_a)))) !== null && _c !== void 0 ? _c : null;
+        });
+    }
+    listStatuses() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const status = (_c = (yield ((_b = (_a = this.noopProvider).getStatus) === null || _b === void 0 ? void 0 : _b.call(_a)))) !== null && _c !== void 0 ? _c : null;
+            return [{ name: EmptyAIProviderRegistry.DEFAULT_NAME, isDefault: true, status }];
+        });
+    }
+}
+EmptyAIProviderRegistry.DEFAULT_NAME = 'default';
+/**
+ * Map-backed registry built by {@link registerAIProviders}. Preserves the
+ * insertion order of `providers` for {@link (AIProviderRegistry:interface).names}
+ * and {@link (AIProviderRegistry:interface).listStatuses}.
  *
  * @internal
  */
-export const AIProvider = DI.createInterface((x) => x.singleton(DefaultAIProvider));
+export class MapBackedAIProviderRegistry {
+    constructor(providers, defaultName) {
+        if (providers.size === 0) {
+            throw new Error('MapBackedAIProviderRegistry: at least one provider is required.');
+        }
+        if (!providers.has(defaultName)) {
+            throw new Error(`MapBackedAIProviderRegistry: default name "${defaultName}" not present in providers.`);
+        }
+        this.providers = providers;
+        this._defaultName = defaultName;
+    }
+    get(name) {
+        return this.providers.get(name);
+    }
+    default() {
+        // Constructor guarantees this lookup succeeds.
+        return this.providers.get(this._defaultName);
+    }
+    defaultName() {
+        return this._defaultName;
+    }
+    names() {
+        return [...this.providers.keys()];
+    }
+    getStatus(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const provider = name === undefined ? this.default() : this.providers.get(name);
+            if (!provider)
+                return null;
+            return (_b = (yield ((_a = provider.getStatus) === null || _a === void 0 ? void 0 : _a.call(provider)))) !== null && _b !== void 0 ? _b : null;
+        });
+    }
+    listStatuses() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const entries = [...this.providers.entries()];
+            return Promise.all(entries.map((_a) => __awaiter(this, [_a], void 0, function* ([name, provider]) {
+                var _b, _c;
+                return ({
+                    name,
+                    isDefault: name === this._defaultName,
+                    status: (_c = (yield ((_b = provider.getStatus) === null || _b === void 0 ? void 0 : _b.call(provider)))) !== null && _c !== void 0 ? _c : null,
+                });
+            })));
+        });
+    }
+}
+/**
+ * The DI token for the {@link (AIProviderRegistry:interface)}. When no host
+ * registers a concrete registry, the container resolves the built-in empty
+ * registry (a single no-op provider) so consumers degrade to inert rather
+ * than throwing.
+ *
+ * Prefer the {@link registerAIProviders} helper over registering this token
+ * directly.
+ *
+ * @beta
+ */
+export const AIProviderRegistry = DI.createInterface((x) => x.singleton(EmptyAIProviderRegistry));
 /**
- * Gets AIProvider from the DI container.
- * When the AI feature flag is disabled (?feature.ai), returns DefaultAIProvider (no-op).
+ * Registers one or more named AI providers as an {@link (AIProviderRegistry:interface)}
+ * on the given DI container.
  *
  * @remarks
- * A utility method for host applications that are not using decorators or the DI container.
+ * - With a single provider, the default is inferred — `options.default` may be omitted.
+ * - With multiple providers, `options.default` is required to avoid implicit ordering.
+ * - Throws when `providers` is empty, when the named default isn't present, or
+ *   when multiple providers are passed without an explicit default.
  *
  * @example
  * ```ts
- * import { getAIProvider } from '@genesislcap/foundation-ai';
- * ...
- * private aiProvider = getAIProvider();
- * ...
- * const result = await this.aiProvider.interpretCriteria?.(input, context);
+ * // Single provider — default inferred
+ * registerAIProviders(container, { openai: createAIProvider(openAiConfig) });
+ *
+ * // Multiple providers — explicit default
+ * registerAIProviders(
+ *   container,
+ *   { fast: chromeProvider, deep: anthropicProvider },
+ *   { default: 'deep' },
+ * );
  * ```
  *
  * @beta
  */
-export function getAIProvider() {
-    if (!isAIFeatureEnabled()) {
-        return new DefaultAIProvider();
+export function registerAIProviders(container, providers, options = {}) {
+    const entries = Object.entries(providers);
+    if (entries.length === 0) {
+        throw new Error('registerAIProviders: at least one provider is required.');
+    }
+    let defaultName;
+    if (options.default !== undefined) {
+        if (!Object.prototype.hasOwnProperty.call(providers, options.default)) {
+            throw new Error(`registerAIProviders: default "${options.default}" is not one of the registered providers (${entries.map(([k]) => k).join(', ')}).`);
+        }
+        defaultName = options.default;
+    }
+    else if (entries.length === 1) {
+        defaultName = entries[0][0];
+    }
+    else {
+        throw new Error(`registerAIProviders: multiple providers registered (${entries.map(([k]) => k).join(', ')}) — must specify { default } to disambiguate.`);
     }
-    return DI.getOrCreateDOMContainer().get(AIProvider);
+    const registry = new MapBackedAIProviderRegistry(new Map(entries), defaultName);
+    container.register(Registration.instance(AIProviderRegistry, registry));
 }

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-export { AIProvider, createAIProvider, getAIProvider, resolveAIConfig } from './ai-provider';
+export { AIProviderRegistry, createAIProvider, registerAIProviders, resolveAIConfig, } from './ai-provider';
 export { AnthropicProvider } from './providers/anthropic-provider';
 export { GeminiProvider } from './providers/gemini-provider';
 export { AnthropicTransport } from './transports/anthropic-transport';

package/dist/esm/providers/chrome-provider.js

@@ -11,7 +11,7 @@ const CHROME_MODEL_NAME = 'Gemini Nano';
  * Requires Chrome 138+
  * Configure in app bootstrap:
  * ```ts
- * Registration.instance(AIProvider, new ChromeProvider({ providerType: 'chrome' }))
+ * registerAIProviders(container, { chrome: new ChromeProvider({ providerType: 'chrome' }) });
  * ```
  *
  * @beta

package/dist/foundation-ai.api.json

@@ -709,6 +709,405 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry:interface",
+          "docComment": "/**\n * Registry of named AI providers. Replaces the single-provider DI token — hosts register one or more named providers and consumers can either ask for the default or resolve a specific provider by name.\n *\n * If no host registration happens, the DI container resolves a built-in empty registry — every lookup returns a no-op provider.\n *\n * @remarks\n *\n * Register from app bootstrap with the {@link registerAIProviders} helper:\n * ```ts\n * registerAIProviders(container, { openai: provider });\n * // or, for multi-provider:\n * registerAIProviders(container, { openai, anthropic }, { default: 'openai' });\n * ```\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AIProviderRegistry "
+            }
+          ],
+          "fileUrlPath": "src/ai-provider.ts",
+          "releaseTag": "Beta",
+          "name": "AIProviderRegistry",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry#default:member(1)",
+              "docComment": "/**\n * The default provider — used when an agent doesn't specify one.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "default(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AIProvider",
+                  "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "default"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry#defaultName:member(1)",
+              "docComment": "/**\n * Name of the default provider. Useful for status display.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "defaultName(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "defaultName"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry#get:member(1)",
+              "docComment": "/**\n * Look up a registered provider by name. Returns `undefined` if no such name is registered.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get(name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AIProvider",
+                  "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "name",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "get"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry#getStatus:member(1)",
+              "docComment": "/**\n * Returns the status payload for a single named provider, or for the default when `name` is omitted. Returns `null` when the provider doesn't implement {@link AIProvider.getStatus} or returns null.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getStatus(name?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AIStatus",
+                  "canonicalReference": "@genesislcap/foundation-ai!AIStatus:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | null>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "name",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "getStatus"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry#listStatuses:member(1)",
+              "docComment": "/**\n * Returns statuses for all registered providers in registration order. Each entry carries the registered name and an `isDefault` flag.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "listStatuses(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AIProviderRegistryStatusEntry",
+                  "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistryStatusEntry:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "listStatuses"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry#names:member(1)",
+              "docComment": "/**\n * All registered provider names, in registration order.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "names(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "names"
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry:var",
+          "docComment": "/**\n * The DI token for the {@link (AIProviderRegistry:interface)}. When no host registers a concrete registry, the container resolves the built-in empty registry (a single no-op provider) so consumers degrade to inert rather than throwing.\n *\n * Prefer the {@link registerAIProviders} helper over registering this token directly.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "AIProviderRegistry: "
+            },
+            {
+              "kind": "Content",
+              "text": "import(\"@microsoft/fast-foundation\")."
+            },
+            {
+              "kind": "Reference",
+              "text": "InterfaceSymbol",
+              "canonicalReference": "@microsoft/fast-foundation!InterfaceSymbol:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderRegistry",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistry:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            }
+          ],
+          "fileUrlPath": "src/ai-provider.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "AIProviderRegistry",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 6
+          }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistryStatusEntry:interface",
+          "docComment": "/**\n * One entry in {@link (AIProviderRegistry:interface).listStatuses}. Pairs the registered name with a status payload (or `null` when the provider doesn't implement {@link AIProvider.getStatus}).\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AIProviderRegistryStatusEntry "
+            }
+          ],
+          "fileUrlPath": "src/ai-provider.ts",
+          "releaseTag": "Beta",
+          "name": "AIProviderRegistryStatusEntry",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistryStatusEntry#isDefault:member",
+              "docComment": "/**\n * True when this is the registry's default provider.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isDefault: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "isDefault",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistryStatusEntry#name:member",
+              "docComment": "/**\n * The name the provider was registered under.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "name",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderRegistryStatusEntry#status:member",
+              "docComment": "/**\n * The provider's `getStatus()` result, or `null` if unavailable.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "status: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AIStatus",
+                  "canonicalReference": "@genesislcap/foundation-ai!AIStatus:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "status",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type",
@@ -5791,35 +6190,6 @@
             }
           ]
         },
-        {
-          "kind": "Function",
-          "canonicalReference": "@genesislcap/foundation-ai!getAIProvider:function(1)",
-          "docComment": "/**\n * Gets AIProvider from the DI container. When the AI feature flag is disabled (?feature.ai), returns DefaultAIProvider (no-op).\n *\n * @remarks\n *\n * A utility method for host applications that are not using decorators or the DI container.\n *\n * @example\n * ```ts\n * import { getAIProvider } from '@genesislcap/foundation-ai';\n * ...\n * private aiProvider = getAIProvider();\n * ...\n * const result = await this.aiProvider.interpretCriteria?.(input, context);\n * ```\n *\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare function getAIProvider(): "
-            },
-            {
-              "kind": "Reference",
-              "text": "AIProvider",
-              "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "fileUrlPath": "src/ai-provider.ts",
-          "returnTypeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "releaseTag": "Beta",
-          "overloadIndex": 1,
-          "parameters": [],
-          "name": "getAIProvider"
-        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/foundation-ai!InteractionRequestOptions:interface",
@@ -6115,6 +6485,144 @@
           },
           "implementsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-ai!registerAIProviders:function(1)",
+          "docComment": "/**\n * Registers one or more named AI providers as an {@link (AIProviderRegistry:interface)} on the given DI container.\n *\n * @remarks\n *\n * - With a single provider, the default is inferred — `options.default` may be omitted. - With multiple providers, `options.default` is required to avoid implicit ordering. - Throws when `providers` is empty, when the named default isn't present, or when multiple providers are passed without an explicit default.\n *\n * @example\n * ```ts\n * // Single provider — default inferred\n * registerAIProviders(container, { openai: createAIProvider(openAiConfig) });\n *\n * // Multiple providers — explicit default\n * registerAIProviders(\n *   container,\n *   { fast: chromeProvider, deep: anthropicProvider },\n *   { default: 'deep' },\n * );\n * ```\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function registerAIProviders(container: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Container",
+              "canonicalReference": "@microsoft/fast-foundation!Container:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", providers: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Record",
+              "canonicalReference": "!Record:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<string, "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProvider",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "RegisterAIProvidersOptions",
+              "canonicalReference": "@genesislcap/foundation-ai!RegisterAIProvidersOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "void"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/ai-provider.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 10,
+            "endIndex": 11
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "container",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "providers",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 9
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "registerAIProviders"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!RegisterAIProvidersOptions:interface",
+          "docComment": "/**\n * Options for {@link registerAIProviders}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface RegisterAIProvidersOptions "
+            }
+          ],
+          "fileUrlPath": "src/ai-provider.ts",
+          "releaseTag": "Beta",
+          "name": "RegisterAIProvidersOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!RegisterAIProvidersOptions#default:member",
+              "docComment": "/**\n * Name of the provider to use as the default — must be a key in the `providers` map. Required when more than one provider is registered; inferred when exactly one is registered.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "default?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "default",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-ai!resolveAIConfig:function(1)",

package/dist/foundation-ai.d.ts

@@ -1,3 +1,4 @@
+import { Container } from '@microsoft/fast-foundation';
 import { InterfaceSymbol } from '@microsoft/fast-foundation';
 
 /**
@@ -69,19 +70,6 @@ export declare interface AIProvider {
     streamChat?(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
 }
 
-/**
- * The DI token for the AIProvider interface.
- *
- * @remarks
- * Register a provider implementation in app bootstrap (e.g. main.ts):
- * ```ts
- * Registration.singleton(AIProvider, OpenAIProvider)
- * ```
- *
- * @internal
- */
-export declare const AIProvider: InterfaceSymbol<AIProvider>;
-
 /**
  * Base provider-level configuration.
  *
@@ -98,6 +86,75 @@ declare interface AIProviderConfig {
     criteriaInstructions?: string;
 }
 
+/**
+ * Registry of named AI providers. Replaces the single-provider DI token —
+ * hosts register one or more named providers and consumers can either ask
+ * for the default or resolve a specific provider by name.
+ *
+ * If no host registration happens, the DI container resolves a built-in
+ * empty registry — every lookup returns a no-op provider.
+ *
+ * @remarks
+ * Register from app bootstrap with the {@link registerAIProviders} helper:
+ * ```ts
+ * registerAIProviders(container, { openai: provider });
+ * // or, for multi-provider:
+ * registerAIProviders(container, { openai, anthropic }, { default: 'openai' });
+ * ```
+ *
+ * @beta
+ */
+export declare interface AIProviderRegistry {
+    /** Look up a registered provider by name. Returns `undefined` if no such name is registered. */
+    get(name: string): AIProvider | undefined;
+    /** The default provider — used when an agent doesn't specify one. */
+    default(): AIProvider;
+    /** Name of the default provider. Useful for status display. */
+    defaultName(): string;
+    /** All registered provider names, in registration order. */
+    names(): string[];
+    /**
+     * Returns the status payload for a single named provider, or for the
+     * default when `name` is omitted. Returns `null` when the provider doesn't
+     * implement {@link AIProvider.getStatus} or returns null.
+     */
+    getStatus(name?: string): Promise<AIStatus | null>;
+    /**
+     * Returns statuses for all registered providers in registration order.
+     * Each entry carries the registered name and an `isDefault` flag.
+     */
+    listStatuses(): Promise<AIProviderRegistryStatusEntry[]>;
+}
+
+/**
+ * The DI token for the {@link (AIProviderRegistry:interface)}. When no host
+ * registers a concrete registry, the container resolves the built-in empty
+ * registry (a single no-op provider) so consumers degrade to inert rather
+ * than throwing.
+ *
+ * Prefer the {@link registerAIProviders} helper over registering this token
+ * directly.
+ *
+ * @beta
+ */
+export declare const AIProviderRegistry: InterfaceSymbol<AIProviderRegistry>;
+
+/**
+ * One entry in {@link (AIProviderRegistry:interface).listStatuses}. Pairs the
+ * registered name with a status payload (or `null` when the provider doesn't
+ * implement {@link AIProvider.getStatus}).
+ *
+ * @beta
+ */
+export declare interface AIProviderRegistryStatusEntry {
+    /** The name the provider was registered under. */
+    name: string;
+    /** True when this is the registry's default provider. */
+    isDefault: boolean;
+    /** The provider's `getStatus()` result, or `null` if unavailable. */
+    status: AIStatus | null;
+}
+
 /**
  * All AI provider identifiers (server, client, unconfigured).
  *
@@ -941,26 +998,6 @@ declare interface GeminiTransportConfig {
     serverEndpoint?: string;
 }
 
-/**
- * Gets AIProvider from the DI container.
- * When the AI feature flag is disabled (?feature.ai), returns DefaultAIProvider (no-op).
- *
- * @remarks
- * A utility method for host applications that are not using decorators or the DI container.
- *
- * @example
- * ```ts
- * import { getAIProvider } from '@genesislcap/foundation-ai';
- * ...
- * private aiProvider = getAIProvider();
- * ...
- * const result = await this.aiProvider.interpretCriteria?.(input, context);
- * ```
- *
- * @beta
- */
-export declare function getAIProvider(): AIProvider;
-
 /**
  * Options passed to `requestInteraction` at call time.
  *
@@ -1024,6 +1061,47 @@ export declare class MalformedFunctionCallError extends Error {
     constructor(finishMessage?: string);
 }
 
+/**
+ * Registers one or more named AI providers as an {@link (AIProviderRegistry:interface)}
+ * on the given DI container.
+ *
+ * @remarks
+ * - With a single provider, the default is inferred — `options.default` may be omitted.
+ * - With multiple providers, `options.default` is required to avoid implicit ordering.
+ * - Throws when `providers` is empty, when the named default isn't present, or
+ *   when multiple providers are passed without an explicit default.
+ *
+ * @example
+ * ```ts
+ * // Single provider — default inferred
+ * registerAIProviders(container, { openai: createAIProvider(openAiConfig) });
+ *
+ * // Multiple providers — explicit default
+ * registerAIProviders(
+ *   container,
+ *   { fast: chromeProvider, deep: anthropicProvider },
+ *   { default: 'deep' },
+ * );
+ * ```
+ *
+ * @beta
+ */
+export declare function registerAIProviders(container: Container, providers: Record<string, AIProvider>, options?: RegisterAIProvidersOptions): void;
+
+/**
+ * Options for {@link registerAIProviders}.
+ *
+ * @beta
+ */
+export declare interface RegisterAIProvidersOptions {
+    /**
+     * Name of the provider to use as the default — must be a key in the
+     * `providers` map. Required when more than one provider is registered;
+     * inferred when exactly one is registered.
+     */
+    default?: string;
+}
+
 /**
  * Resolves AI config, optionally preferring Chrome when available.
  * Use before registering AIProvider. Server URL is derived from API_HOST.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-ai",
   "description": "Genesis Foundation AI - Provider-agnostic AI configuration and shared utilities",
-  "version": "14.444.1",
+  "version": "14.445.1",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -51,17 +51,17 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.444.1",
-    "@genesislcap/genx": "14.444.1",
-    "@genesislcap/rollup-builder": "14.444.1",
-    "@genesislcap/ts-builder": "14.444.1",
-    "@genesislcap/uvu-playwright-builder": "14.444.1",
-    "@genesislcap/vite-builder": "14.444.1",
-    "@genesislcap/webpack-builder": "14.444.1"
+    "@genesislcap/foundation-testing": "14.445.1",
+    "@genesislcap/genx": "14.445.1",
+    "@genesislcap/rollup-builder": "14.445.1",
+    "@genesislcap/ts-builder": "14.445.1",
+    "@genesislcap/uvu-playwright-builder": "14.445.1",
+    "@genesislcap/vite-builder": "14.445.1",
+    "@genesislcap/webpack-builder": "14.445.1"
   },
   "dependencies": {
-    "@genesislcap/foundation-logger": "14.444.1",
-    "@genesislcap/foundation-utils": "14.444.1",
+    "@genesislcap/foundation-logger": "14.445.1",
+    "@genesislcap/foundation-utils": "14.445.1",
     "@microsoft/fast-foundation": "2.50.0"
   },
   "repository": {
@@ -72,5 +72,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "837befe80b4972686cb48fe7d86334c5d819ced6"
+  "gitHead": "893e8b2ffadacaedb39f1935c1979278191b6730"
 }