@genesislcap/ai-assistant 14.444.1 → 14.445.1

package/dist/dts/state/ai-assistant-slice.d.ts

@@ -1,4 +1,4 @@
-import type { ChatInputDuringExecutionMode, ChatMessage } from '@genesislcap/foundation-ai';
+import type { AIProviderRegistryStatusEntry, ChatInputDuringExecutionMode, ChatMessage } from '@genesislcap/foundation-ai';
 import type { PayloadAction } from '@genesislcap/foundation-redux';
 import type { AgentConfig } from '../config/config';
 import type { AiAssistantAnimation, AiAssistantState, SuggestionsState } from '../main/main.types';
@@ -36,6 +36,17 @@ export interface AiAssistantSessionState {
     sessionCostUsd: number;
     /** Active model id (e.g. `claude-sonnet-4-6`), resolved on connect. */
     activeModel: string | undefined;
+    /**
+     * Name of the AI provider used on the most recent turn — drives "current"
+     * marker in the settings panel. `undefined` until the first turn runs.
+     */
+    activeProviderName: string | undefined;
+    /**
+     * Snapshot of every registered provider's status, in registration order.
+     * Populated on connect (or on settings-open if not yet loaded) and reused
+     * for the lifetime of the session — provider registration is static.
+     */
+    providerStatuses: AIProviderRegistryStatusEntry[];
     activeAgent: Omit<AgentConfig, 'toolHandlers'> | undefined;
     /**
      * Name of the agent the user has pinned via the picker. `null` means the
@@ -87,6 +98,8 @@ export declare const aiAssistantSlice: import("@reduxjs/toolkit").Slice<AiAssist
     setContextLimit(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<number | undefined>): void;
     setSessionCostUsd(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<number>): void;
     setActiveModel(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string | undefined>): void;
+    setActiveProviderName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string | undefined>): void;
+    setProviderStatuses(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<AIProviderRegistryStatusEntry[]>): void;
     setActiveAgent(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<Omit<AgentConfig, "toolHandlers"> | undefined>): void;
     setPinnedAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string | null>): void;
     setFlowOwnerAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string | null>): void;

package/dist/dts/state/ai-assistant-slice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-assistant-slice.d.ts","sourceRoot":"","sources":["../../../src/state/ai-assistant-slice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnG;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,IAAI,EAAE,4BAA4B,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,wBAAwB,EAAE,OAAO,CAAC;IAClC,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;IAC1C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;IAC3D;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;;;OAOG;IACH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,eAAO,MAAM,mBAAmB,EAAE,uBAoBjC,CAAC;AAEF,eAAO,MAAM,gBAAgB;uFAIE,aAAa,CAAC,WAAW,EAAE,CAAC;oFAG/B,aAAa,CAAC,gBAAgB,CAAC;4FAGvB,aAAa,CAAC,OAAO,CAAC;gGAGlB,aAAa,CAAC,OAAO,CAAC;uGAGf,aAAa,CAAC,OAAO,CAAC;gGAG7B,aAAa,CAAC,oBAAoB,EAAE,CAAC;+FAGtC,aAAa,CAAC,gBAAgB,CAAC;4FAGlC,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC;2FAGlC,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC;6FAG/B,aAAa,CAAC,MAAM,CAAC;0FAGxB,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC;0FAGjC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;8FAGxD,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC;iGAGzB,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC;8FAG/B,aAAa,CAAC,OAAO,CAAC;yFAG3B,aAAa,CAAC,MAAM,CAAC;gGAGd,aAAa,CAAC,WAAW,EAAE,CAAC;+FAG7B,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC;4FAG/B,aAAa,CAAC,aAAa,CAAC;+FAGzB,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;oCAKlE,CAAC"}
+{"version":3,"file":"ai-assistant-slice.d.ts","sourceRoot":"","sources":["../../../src/state/ai-assistant-slice.ts"],"names":[],"mappings":"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"}

package/dist/dts/state/session-store.d.ts

@@ -12,6 +12,8 @@ declare function makeStore(devTools: boolean | undefined): import("@genesislcap/
     setContextLimit(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<number | undefined>): void;
     setSessionCostUsd(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<number>): void;
     setActiveModel(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string | undefined>): void;
+    setActiveProviderName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string | undefined>): void;
+    setProviderStatuses(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<import("@genesislcap/foundation-ai").AIProviderRegistryStatusEntry[]>): void;
     setActiveAgent(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<Omit<import("..").AgentConfig, "toolHandlers"> | undefined>): void;
     setPinnedAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string | null>): void;
     setFlowOwnerAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string | null>): void;

package/dist/dts/state/session-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/state/session-store.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAIvD,iBAAS,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;wCAM/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAMnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/state/session-store.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAIvD,iBAAS,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;wCAM/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAMnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/dts/utils/sum-costs.d.ts

@@ -0,0 +1,13 @@
+import type { ChatMessage } from '@genesislcap/foundation-ai';
+/**
+ * Sum the `cost` field across a message list, recursing into each tool call's
+ * `subAgentTrace` so LLM calls made by sub-agents (potentially on a different
+ * provider with different rates) contribute to the total.
+ *
+ * Returns 0 when no messages carry a cost — providers that don't report usage
+ * metadata (e.g. Chrome built-in) are skipped silently.
+ *
+ * @internal
+ */
+export declare function sumCosts(messages: readonly ChatMessage[]): number;
+//# sourceMappingURL=sum-costs.d.ts.map

package/dist/dts/utils/sum-costs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sum-costs.d.ts","sourceRoot":"","sources":["../../../src/utils/sum-costs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CASjE"}

package/dist/dts/utils/sum-costs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sum-costs.test.d.ts.map

package/dist/dts/utils/sum-costs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sum-costs.test.d.ts","sourceRoot":"","sources":["../../../src/utils/sum-costs.test.ts"],"names":[],"mappings":""}

package/dist/esm/components/chat-driver/chat-driver.js

@@ -1,6 +1,7 @@
 import { __awaiter } from "tslib";
 import { MalformedFunctionCallError } from '@genesislcap/foundation-ai';
 import { agenticActivityBus } from '../../channel/ai-activity-bus';
+import { resolveChatProvider } from '../../config/validate-providers';
 import { applyHistoryCap } from '../../utils/history-transform';
 import { logger } from '../../utils/logger';
 import { TOOL_FOLD_SYMBOL } from '../../utils/tool-fold';
@@ -26,9 +27,9 @@ const HANDOFF_TOOL_RESULT_PLACEHOLDER = 'Handoff to another specialist — routi
  * @beta
  */
 export class ChatDriver extends EventTarget {
-    constructor(aiProvider, toolHandlers = {}, toolDefinitions = [], systemPrompt, primerHistory, maxToolIterations = DEFAULT_MAX_TOOL_ITERATIONS, maxFoldOperations = DEFAULT_MAX_FOLD_OPERATIONS, maxTurnSnapshots = DEFAULT_MAX_TURN_SNAPSHOTS) {
+    constructor(providerRegistry, toolHandlers = {}, toolDefinitions = [], systemPrompt, primerHistory, maxToolIterations = DEFAULT_MAX_TOOL_ITERATIONS, maxFoldOperations = DEFAULT_MAX_FOLD_OPERATIONS, maxTurnSnapshots = DEFAULT_MAX_TURN_SNAPSHOTS) {
         super();
-        this.aiProvider = aiProvider;
+        this.providerRegistry = providerRegistry;
         this.maxToolIterations = maxToolIterations;
         this.history = [];
         this.busy = false;
@@ -59,6 +60,12 @@ export class ChatDriver extends EventTarget {
         this.turnSnapshots = [];
         /** Monotonic counter that survives agent swaps — useful for cross-referencing with history. */
         this.globalTurnIndex = 0;
+        /**
+         * Caches validated provider lookups per name within the current agent. Cleared
+         * by `applyAgent` so each new agent's static/function-resolved names are
+         * validated fresh.
+         */
+        this.resolvedProviderCache = new Map();
         if (typeof toolHandlers === 'function') {
             this.toolHandlersFactory = toolHandlers;
             this.toolHandlers = {};
@@ -117,10 +124,71 @@ export class ChatDriver extends EventTarget {
             typeof config.displayName === 'string' ? config.displayName : config.name;
         this.debugSnapshotter = config.getDebugSnapshot;
         this.subAgentsMap = new Map(((_c = config.subAgents) !== null && _c !== void 0 ? _c : []).map((s) => [s.name, s]));
+        this.activeProviderInput = config.provider;
+        this.resolvedProviderCache.clear();
+        this.lastResolvedProviderName = undefined;
+        // Static validation: resolve the name now so unknown-provider and missing-
+        // capability errors fire at agent swap rather than on the first LLM call.
+        // Function-form `provider` is validated lazily inside `resolveProviderForTurn`.
+        if (typeof config.provider === 'string') {
+            this.resolveProviderByName(config.provider, config.name);
+        }
         // Reset fold state when agent changes — each specialist starts fresh
         this.foldStack = [];
         this.consecutiveFoldOps = 0;
     }
+    /**
+     * Returns the most recently resolved provider name. Falls back to the
+     * registry's default when no per-turn resolution has happened yet.
+     */
+    getActiveProviderName() {
+        var _a;
+        return (_a = this.lastResolvedProviderName) !== null && _a !== void 0 ? _a : this.providerRegistry.defaultName();
+    }
+    /**
+     * Resolve a named provider against the registry. Cached per-agent so
+     * repeated lookups during one agent's lifetime don't re-validate.
+     * Validation lives in `resolveChatProvider`; this wrapper just adds the
+     * cache.
+     */
+    resolveProviderByName(name, agentName) {
+        const cached = this.resolvedProviderCache.get(name);
+        if (cached)
+            return cached;
+        const provider = resolveChatProvider(this.providerRegistry, name, agentName);
+        this.resolvedProviderCache.set(name, provider);
+        return provider;
+    }
+    /**
+     * Resolve the provider to use for the current turn. Walks the agent's
+     * `provider` selector (static or function form) or falls back to the
+     * registry default. Dispatches `provider-changed` when the resolved name
+     * differs from the last dispatched value.
+     */
+    resolveProviderForTurn(ctx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            let provider;
+            let resolvedName;
+            if (this.activeProviderInput === undefined) {
+                provider = this.providerRegistry.default();
+                resolvedName = this.providerRegistry.defaultName();
+            }
+            else {
+                const name = typeof this.activeProviderInput === 'function'
+                    ? yield this.activeProviderInput(ctx)
+                    : this.activeProviderInput;
+                provider = this.resolveProviderByName(name, (_a = this.activeAgentName) !== null && _a !== void 0 ? _a : '<unknown>');
+                resolvedName = name;
+            }
+            this.lastResolvedProviderName = resolvedName;
+            if (resolvedName !== this.lastDispatchedProviderName) {
+                this.lastDispatchedProviderName = resolvedName;
+                this.dispatchEvent(new CustomEvent('provider-changed', { detail: { name: resolvedName } }));
+            }
+            return provider;
+        });
+    }
     /**
      * Returns the early-stop result set by `completeSubAgent`, if any.
      * Called by a parent `ChatDriver` after running this instance as a sub-agent.
@@ -197,8 +265,12 @@ export class ChatDriver extends EventTarget {
     }
     getSuggestions(history, prompt, count, allAgentInfo) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!this.aiProvider.prompt) {
-                logger.warn('ChatDriver: AIProvider does not implement prompt()');
+            // Suggestions are an out-of-turn UI helper, not bound to any single agent —
+            // always run against the registry default. Best-effort: a default with no
+            // `prompt()` just means no suggestions, not a hard error.
+            const defaultProvider = this.providerRegistry.default();
+            if (!defaultProvider.prompt) {
+                logger.warn('ChatDriver: default AI provider does not implement prompt()');
                 return [];
             }
             let agentContext = '';
@@ -275,7 +347,7 @@ export class ChatDriver extends EventTarget {
                         `- No numbering, bullets, markdown, emojis, code blocks, or quotes around the suggestion.\n` +
                         `- No preamble, headings, summary, or commentary before or after the list.`;
             }
-            const text = yield this.aiProvider.prompt(userMessage, { systemPrompt });
+            const text = yield defaultProvider.prompt(userMessage, { systemPrompt });
             // Lenient parsing as a defensive backstop: even with the strict prompt,
             // models occasionally slip in numbering, bullets, or surrounding markdown.
             return (text
@@ -391,10 +463,6 @@ export class ChatDriver extends EventTarget {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.busy || (!userInput.trim() && !(attachments === null || attachments === void 0 ? void 0 : attachments.length)))
                 return { reason: 'done' };
-            if (!this.aiProvider.chat) {
-                logger.warn('ChatDriver: AIProvider does not implement chat()');
-                return { reason: 'done' };
-            }
             this.busy = true;
             this.subAgentCompletion = undefined;
             this.agentReleaseRequested = false;
@@ -477,7 +545,7 @@ export class ChatDriver extends EventTarget {
                 ...contextMessages,
                 ...((_b = subConfig.primerHistory) !== null && _b !== void 0 ? _b : []),
             ];
-            const child = new ChatDriver(this.aiProvider);
+            const child = new ChatDriver(this.providerRegistry);
             child.applyAgent(Object.assign(Object.assign({}, subConfig), { primerHistory: effectivePrimer }));
             // Route interactions back through this driver so widgets render in the
             // parent's (ultimately the root's) history and resolve via the same
@@ -489,7 +557,15 @@ export class ChatDriver extends EventTarget {
                     detail: { agentName: subConfig.name, history: e.detail },
                 }));
             };
+            // Re-dispatch the child's `provider-changed` so the UI reflects whichever
+            // provider is *actually* running right now (the sub-agent may use a
+            // different provider than the parent). Restoration of the parent's
+            // provider on `sub-agent-stop` is handled by the listener in main.ts.
+            const forwardProviderChanged = (e) => {
+                this.dispatchEvent(new CustomEvent('provider-changed', { detail: e.detail }));
+            };
             child.addEventListener('history-updated', forwardTrace);
+            child.addEventListener('provider-changed', forwardProviderChanged);
             // Unique per-invocation id so listeners can pair start/stop reliably even
             // when the same sub-agent runs multiple times in parallel.
             const invocationId = crypto.randomUUID();
@@ -501,6 +577,7 @@ export class ChatDriver extends EventTarget {
             }
             finally {
                 child.removeEventListener('history-updated', forwardTrace);
+                child.removeEventListener('provider-changed', forwardProviderChanged);
                 this.dispatchEvent(new CustomEvent('sub-agent-stop', { detail: lifecycleDetail }));
             }
             const trace = child.getHistory();
@@ -522,10 +599,6 @@ export class ChatDriver extends EventTarget {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.busy)
                 return { reason: 'done' };
-            if (!this.aiProvider.chat) {
-                logger.warn('ChatDriver: AIProvider does not implement chat()');
-                return { reason: 'done' };
-            }
             this.busy = true;
             this.subAgentCompletion = undefined;
             agenticActivityBus.publish('tool-loop-start', undefined);
@@ -762,10 +835,15 @@ export class ChatDriver extends EventTarget {
                     tools: this.toolDefinitions.length ? this.toolDefinitions : undefined,
                     attachments: attachmentsForCall,
                 };
+                // Resolve the active provider for this turn. Static names were validated
+                // in `applyAgent`; function-form names are validated on first resolution
+                // here and cached for the agent's lifetime.
+                // oxlint-disable-next-line no-await-in-loop
+                const activeProvider = yield this.resolveProviderForTurn(promptCtx);
                 let response;
                 try {
                     // oxlint-disable-next-line no-await-in-loop
-                    response = yield this.aiProvider.chat(historyForCall, userInputForCall, options);
+                    response = yield activeProvider.chat(historyForCall, userInputForCall, options);
                 }
                 catch (e) {
                     if (e instanceof MalformedFunctionCallError) {

package/dist/esm/components/orchestrating-driver/orchestrating-driver.js

@@ -1,4 +1,5 @@
 import { __awaiter } from "tslib";
+import { validateStaticAgentProviders } from '../../config/validate-providers';
 import { transformHistoryForAgent } from '../../utils/history-transform';
 import { logger } from '../../utils/logger';
 import { ChatDriver, REQUEST_CONTINUATION_TOOL, } from '../chat-driver/chat-driver';
@@ -50,10 +51,10 @@ function buildFallbackSystemPrompt(fallback, specialists) {
  * @beta
  */
 export class OrchestratingDriver extends EventTarget {
-    constructor(aiProvider, agents, options = {}) {
+    constructor(providerRegistry, agents, options = {}) {
         var _a, _b, _c, _d;
         super();
-        this.aiProvider = aiProvider;
+        this.providerRegistry = providerRegistry;
         this.agents = agents;
         /**
          * Aborted on driver disposal. Threaded into `AgentLifecycleContext.signal`
@@ -80,6 +81,10 @@ export class OrchestratingDriver extends EventTarget {
         this.classifierHistoryLength =
             (_c = options.classifierHistoryLength) !== null && _c !== void 0 ? _c : DEFAULT_CLASSIFIER_HISTORY_LENGTH;
         this.classifierRetries = (_d = options.classifierRetries) !== null && _d !== void 0 ? _d : DEFAULT_CLASSIFIER_RETRIES;
+        // Static-name validation: walk every agent (and nested sub-agents). Any
+        // `provider: '<name>'` that isn't registered, or resolves to a provider
+        // without `chat()`, throws now rather than at first turn.
+        validateStaticAgentProviders(agents, providerRegistry);
         // Specialists drive the classifier. `excludeFromClassifier` agents are still
         // resolvable by name (so manual pinning works) but never auto-routed.
         this.specialists = agents.filter(isSpecialist).filter((a) => !a.excludeFromClassifier);
@@ -90,7 +95,7 @@ export class OrchestratingDriver extends EventTarget {
         const rawFallback = fallbacks[0];
         this.fallback = rawFallback
             ? Object.assign(Object.assign({}, rawFallback), { systemPrompt: buildFallbackSystemPrompt(rawFallback, this.specialists) }) : undefined;
-        this.chatDriver = new ChatDriver(aiProvider, {}, [], undefined, undefined, options.maxToolIterations, options.maxFoldOperations, options.maxTurnSnapshots);
+        this.chatDriver = new ChatDriver(providerRegistry, {}, [], undefined, undefined, options.maxToolIterations, options.maxFoldOperations, options.maxTurnSnapshots);
         // Proxy events from the shared driver
         this.chatDriver.addEventListener('history-updated', (e) => {
             this.dispatchEvent(new CustomEvent('history-updated', { detail: e.detail }));
@@ -110,6 +115,9 @@ export class OrchestratingDriver extends EventTarget {
         this.chatDriver.addEventListener('interaction-stop', (e) => {
             this.dispatchEvent(new CustomEvent('interaction-stop', { detail: e.detail }));
         });
+        this.chatDriver.addEventListener('provider-changed', (e) => {
+            this.dispatchEvent(new CustomEvent('provider-changed', { detail: e.detail }));
+        });
     }
     resolveInteraction(interactionId, result) {
         this.chatDriver.resolveInteraction(interactionId, result);
@@ -117,6 +125,10 @@ export class OrchestratingDriver extends EventTarget {
     isBusy() {
         return this.chatDriver.isBusy();
     }
+    /** Currently active provider name from the underlying ChatDriver. */
+    getActiveProviderName() {
+        return this.chatDriver.getActiveProviderName();
+    }
     /**
      * Pins routing to a specific agent by name. While pinned, the classifier is
      * skipped and the continuation tool is hidden from the agent's tool list, so
@@ -427,8 +439,15 @@ export class OrchestratingDriver extends EventTarget {
                         systemPrompt: classifierPrompt,
                         tools: [routingTool],
                     };
+                    // Classification is orchestrator-level, not bound to any single agent —
+                    // always run against the registry default.
+                    const classifierProvider = this.providerRegistry.default();
+                    if (!classifierProvider.chat) {
+                        logger.warn('OrchestratingDriver: default AI provider does not implement chat() — cannot classify.');
+                        break;
+                    }
                     // oxlint-disable-next-line no-await-in-loop
-                    const response = yield this.aiProvider.chat([], input, options);
+                    const response = yield classifierProvider.chat([], input, options);
                     const tc = (_b = response.toolCalls) === null || _b === void 0 ? void 0 : _b[0];
                     const index = (tc === null || tc === void 0 ? void 0 : tc.name) === 'select_agent' ? tc.args.agent_index : -1;
                     if (index >= 0 && index < this.specialists.length) {

package/dist/esm/config/define-stateful-agent.js

@@ -107,6 +107,17 @@ export function defineStatefulAgent(opts) {
             return opts.displayName(Object.assign(Object.assign({}, ctx), { state }));
         })
         : undefined;
+    // Function-form `provider` needs `state` injected the same way the other
+    // per-turn resolvers do; the static-string form is passed through unchanged
+    // and validated up-front by OrchestratingDriver.
+    const wrappedProvider = typeof opts.provider === 'function'
+        ? (ctx) => __awaiter(this, void 0, void 0, function* () {
+            if (!state) {
+                throw new Error(`Stateful agent "${opts.name}" provider called before init`);
+            }
+            return opts.provider(Object.assign(Object.assign({}, ctx), { state }));
+        })
+        : opts.provider;
     const base = {
         name: opts.name,
         displayName: wrappedDisplayName,
@@ -116,6 +127,7 @@ export function defineStatefulAgent(opts) {
         chatInputDuringExecution: opts.chatInputDuringExecution,
         toolDefinitions: wrappedTools,
         toolHandlers: wrappedHandlers,
+        provider: wrappedProvider,
         onActivate: (ctx) => __awaiter(this, void 0, void 0, function* () {
             state = yield opts.init(ctx);
             // Sample once with the init state to fail loud on fold misuse at the

package/dist/esm/config/validate-providers.js

@@ -0,0 +1,47 @@
+/**
+ * Resolve a provider name against the registry and assert it implements
+ * `chat()` — the capability the chat tool-loop depends on. Throws with a
+ * message naming the agent so misconfigured agents are easy to track down.
+ *
+ * Used by both the up-front static walk in `OrchestratingDriver` and by
+ * `ChatDriver`'s per-turn resolver for function-form `provider` values.
+ *
+ * @internal
+ */
+export function resolveChatProvider(registry, providerName, agentName) {
+    const provider = registry.get(providerName);
+    if (!provider) {
+        const available = registry.names().join(', ') || '(none)';
+        throw new Error(`Agent "${agentName}" references unknown provider "${providerName}". Registered: ${available}`);
+    }
+    if (!provider.chat) {
+        throw new Error(`Agent "${agentName}" resolved to provider "${providerName}" which does not implement chat().`);
+    }
+    return provider;
+}
+/**
+ * Walk an agent tree (including nested `subAgents`) and validate every static
+ * `provider: string` against the registry. Function-form `provider` values are
+ * deferred — they validate on first resolution inside the driver.
+ *
+ * Throws on the first failure, with the same message shape produced by
+ * {@link resolveChatProvider}.
+ *
+ * @internal
+ */
+export function validateStaticAgentProviders(agents, registry) {
+    const visited = new Set();
+    const walk = (agent) => {
+        var _a;
+        if (visited.has(agent))
+            return;
+        visited.add(agent);
+        if (typeof agent.provider === 'string') {
+            resolveChatProvider(registry, agent.provider, agent.name);
+        }
+        for (const sub of (_a = agent.subAgents) !== null && _a !== void 0 ? _a : [])
+            walk(sub);
+    };
+    for (const root of agents)
+        walk(root);
+}

package/dist/esm/config/validate-providers.test.js

@@ -0,0 +1,100 @@
+import { __awaiter } from "tslib";
+import { assert, createLogicSuite } from '@genesislcap/foundation-testing';
+import { resolveChatProvider, validateStaticAgentProviders } from './validate-providers';
+const chatProvider = () => ({
+    chat: () => __awaiter(void 0, void 0, void 0, function* () { return ({ role: 'assistant', content: '' }); }),
+});
+const promptOnlyProvider = () => ({
+    prompt: () => __awaiter(void 0, void 0, void 0, function* () { return ''; }),
+});
+/**
+ * Minimal in-test registry — implements only what the validation helpers
+ * touch (`get`, `names`). Avoids depending on foundation-ai's concrete
+ * registry impl, and keeps these tests Node-runnable.
+ */
+const makeRegistry = (providers) => {
+    const map = new Map(Object.entries(providers));
+    return {
+        get: (name) => map.get(name),
+        default: () => map.values().next().value,
+        defaultName: () => map.keys().next().value,
+        names: () => [...map.keys()],
+        getStatus: () => __awaiter(void 0, void 0, void 0, function* () { return null; }),
+        listStatuses: () => __awaiter(void 0, void 0, void 0, function* () { return []; }),
+    };
+};
+const specialist = (overrides) => (Object.assign({ name: overrides.name, description: 'test specialist' }, overrides));
+// ---------------------------------------------------------------------------
+// resolveChatProvider
+// ---------------------------------------------------------------------------
+const resolve = createLogicSuite('resolveChatProvider');
+resolve('returns the provider when the name is registered and has chat()', () => {
+    const fast = chatProvider();
+    const registry = makeRegistry({ fast });
+    assert.is(resolveChatProvider(registry, 'fast', 'A'), fast);
+});
+resolve('throws on an unknown provider name with the agent name in the message', () => {
+    const registry = makeRegistry({ fast: chatProvider() });
+    assert.throws(() => resolveChatProvider(registry, 'deep', 'A'), /Agent "A" references unknown provider "deep"/);
+});
+resolve('throws including the registered names so the misconfiguration is debuggable', () => {
+    const registry = makeRegistry({
+        fast: chatProvider(),
+        deep: chatProvider(),
+        cheap: chatProvider(),
+    });
+    assert.throws(() => resolveChatProvider(registry, 'typo', 'A'), /Registered: fast, deep, cheap/);
+});
+resolve('throws when the resolved provider does not implement chat()', () => {
+    const registry = makeRegistry({ chrome: promptOnlyProvider() });
+    assert.throws(() => resolveChatProvider(registry, 'chrome', 'A'), /Agent "A" resolved to provider "chrome" which does not implement chat\(\)/);
+});
+resolve.run();
+// ---------------------------------------------------------------------------
+// validateStaticAgentProviders
+// ---------------------------------------------------------------------------
+const validate = createLogicSuite('validateStaticAgentProviders');
+validate('accepts agents with no `provider` field (back-compat path)', () => {
+    const registry = makeRegistry({ default: chatProvider() });
+    assert.not.throws(() => validateStaticAgentProviders([specialist({ name: 'A' })], registry));
+});
+validate('accepts agents that name a registered chat-capable provider', () => {
+    const registry = makeRegistry({ fast: chatProvider(), deep: chatProvider() });
+    assert.not.throws(() => validateStaticAgentProviders([specialist({ name: 'A', provider: 'deep' })], registry));
+});
+validate('throws when a top-level agent references an unknown provider', () => {
+    const registry = makeRegistry({ fast: chatProvider() });
+    assert.throws(() => validateStaticAgentProviders([specialist({ name: 'A', provider: 'deep' })], registry), /Agent "A" references unknown provider "deep"/);
+});
+validate('recurses into subAgents — bad provider on a sub-agent throws', () => {
+    const registry = makeRegistry({ fast: chatProvider() });
+    const sub = specialist({ name: 'Sub', provider: 'missing' });
+    assert.throws(() => validateStaticAgentProviders([specialist({ name: 'A', subAgents: [sub] })], registry), /Agent "Sub" references unknown provider "missing"/);
+});
+validate('recurses through multiple levels — bad provider on a deeply-nested sub-agent throws', () => {
+    const registry = makeRegistry({ fast: chatProvider() });
+    const deepest = specialist({ name: 'Deepest', provider: 'missing' });
+    const middle = specialist({ name: 'Middle', subAgents: [deepest] });
+    assert.throws(() => validateStaticAgentProviders([specialist({ name: 'Top', subAgents: [middle] })], registry), /Agent "Deepest" references unknown provider "missing"/);
+});
+validate('defers function-form `provider` — it is not invoked at validation time', () => {
+    const registry = makeRegistry({ fast: chatProvider() });
+    const agent = specialist({
+        name: 'A',
+        // If validateStaticAgentProviders eagerly resolved this, it would throw
+        // here. The contract is that function-form is deferred to the driver's
+        // per-turn resolver.
+        provider: () => {
+            throw new Error('function-form provider should not be invoked at validation time');
+        },
+    });
+    assert.not.throws(() => validateStaticAgentProviders([agent], registry));
+});
+validate('shared sub-agent across two parents validates cleanly', () => {
+    const registry = makeRegistry({ fast: chatProvider() });
+    const shared = specialist({ name: 'Shared', provider: 'fast' });
+    const parentA = specialist({ name: 'ParentA', subAgents: [shared] });
+    const parentB = specialist({ name: 'ParentB', subAgents: [shared] });
+    assert.not.throws(() => validateStaticAgentProviders([parentA, parentB], registry));
+});
+validate.run();