@genesislcap/ai-assistant 14.408.0 → 14.409.0-FUI-2495.2

package/dist/ai-assistant.d.ts

@@ -1,6 +1,7 @@
 import { AIProvider } from '@genesislcap/foundation-ai';
 import type { ChatAttachment } from '@genesislcap/foundation-ai';
 import type { ChatConfig } from '@genesislcap/foundation-ai';
+import type { ChatDriverResult } from '@genesislcap/foundation-ai';
 import type { ChatMessage } from '@genesislcap/foundation-ai';
 import type { ChatToolDefinition } from '@genesislcap/foundation-ai';
 import type { ChatToolHandlers } from '@genesislcap/foundation-ai';
@@ -8,42 +9,14 @@ import { GenesisElement } from '@genesislcap/web-core';
 import { ViewTemplate } from '@genesislcap/web-core';
 
 /**
- * Configuration for a single specialist agent.
+ * Configuration for an agent passed to `FoundationAiAssistant`.
  *
- * When multiple agents are provided to `FoundationAiAssistant`, an orchestrating layer
- * will route each user message to the appropriate specialist based on intent. When only
- * one agent is configured, routing is skipped.
+ * Either a specialist (requires `description`) or a fallback (requires
+ * `fallback: true`). Passing both or neither is a compile error.
  *
  * @beta
  */
-export declare interface AgentConfig {
-    /**
-     * Display name shown in the chat header when this agent is active.
-     */
-    name: string;
-    /**
-     * Plain-language description of what this agent handles.
-     * Used by the classifier to auto-generate its routing prompt.
-     */
-    description: string;
-    /**
-     * System prompt injected into every conversation turn for this agent.
-     */
-    systemPrompt?: string;
-    /**
-     * Tool definitions (JSON Schema) passed to the AI provider for this agent.
-     */
-    toolDefinitions?: ChatToolDefinition[];
-    /**
-     * Tool handler implementations for this agent.
-     */
-    toolHandlers?: ChatToolHandlers;
-    /**
-     * Optional primer history prepended to every call (not visible to the user).
-     * Used to establish agent identity and behavioural rules.
-     */
-    primerHistory?: ChatMessage[];
-}
+export declare type AgentConfig = SpecialistAgentConfig | FallbackAgentConfig;
 
 /**
  * Typed in-process event bus for AI assistant activity events.
@@ -183,6 +156,7 @@ export declare interface AiAssistantSerializedState {
     messages: ChatMessage[];
     showToolCalls: boolean;
     showThinkingSteps: boolean;
+    showAgentSwitchIndicator: boolean;
     enabledAnimations: AiAssistantAnimation[];
 }
 
@@ -205,6 +179,67 @@ export declare interface AiChatWidget {
     resolved?: boolean;
 }
 
+/**
+ * Contract for pages that support docking the AI assistant.
+ * Register an implementation with {@link getAiPopoutManager} on mount and deregister on unmount.
+ *
+ * @beta
+ */
+export declare interface AiDockProvider {
+    /**
+     * Called when the user expands the bubble. Receives the assistant element and the
+     * serialized state to restore. The provider is responsible for inserting the element
+     * into its layout and calling `applyState` once the element is connected.
+     * Resolves when the element is connected and state has been applied.
+     */
+    onDock(element: HTMLElement, state: AiAssistantSerializedState | undefined): Promise<void>;
+    /** Called when the user collapses the panel or before navigation. */
+    onUndock(): Promise<void>;
+    /**
+     * Called by `collapseIfDocked` before navigation. The provider is responsible for
+     * finding the docked assistant element and calling `handlePopout()` on it, which
+     * publishes `chat-popin` and returns the assistant to the bubble.
+     */
+    initiateCollapse(): void;
+}
+
+/**
+ * Common interface implemented by both `ChatDriver` (single-agent) and
+ * `OrchestratingDriver` (multi-agent). `FoundationAiAssistant` depends only
+ * on this interface — the concrete class is chosen at startup based on how
+ * many agents are configured.
+ *
+ * Extends `EventTarget` so consumers can subscribe to `history-updated` events
+ * without knowing the concrete implementation.
+ *
+ * @beta
+ */
+export declare interface AiDriver extends EventTarget {
+    /**
+     * Send a user message and run the tool loop to completion.
+     */
+    sendMessage(input: string, attachments?: ChatAttachment[]): Promise<ChatDriverResult>;
+    /**
+     * Continue the tool loop from the current history without appending a new
+     * user message. Used by `OrchestratingDriver` on agent handoffs — the
+     * handoff context is already in history; `transientPrimer` is injected as
+     * an invisible one-shot message for this call only.
+     */
+    continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
+    /**
+     * Resolve a pending blocking interaction with the given result.
+     */
+    resolveInteraction(interactionId: string, result: unknown): void;
+    /**
+     * Seed the driver's message history (called on state restore / pop-in).
+     */
+    loadHistory(messages: ChatMessage[]): void;
+    /**
+     * Return the full, unredacted conversation history.
+     */
+    getRawHistory?(): readonly ChatMessage[];
+}
+
 /**
  * All available animation names, derived from the registry.
  *
@@ -229,6 +264,30 @@ export declare const ANIMATION_DEFS: {
     };
 };
 
+declare interface BaseAgentConfig {
+    /**
+     * Display name shown in the chat header when this agent is active.
+     */
+    name: string;
+    /**
+     * System prompt injected into every conversation turn for this agent.
+     */
+    systemPrompt?: string;
+    /**
+     * Tool definitions (JSON Schema) passed to the AI provider for this agent.
+     */
+    toolDefinitions?: ChatToolDefinition[];
+    /**
+     * Tool handler implementations for this agent.
+     */
+    toolHandlers?: ChatToolHandlers;
+    /**
+     * Optional primer history prepended to every call (not visible to the user).
+     * Used to establish agent identity and behavioural rules.
+     */
+    primerHistory?: ChatMessage[];
+}
+
 /**
  * Plain TS class that drives a multi-turn chat conversation, including the tool-call loop.
  * Owned by `FoundationAiAssistant` — created in `connectedCallback`, torn down in `disconnectedCallback`.
@@ -237,18 +296,25 @@ export declare const ANIMATION_DEFS: {
  *
  * @beta
  */
-export declare class ChatDriver extends EventTarget {
+export declare class ChatDriver extends EventTarget implements AiDriver {
     private readonly aiProvider;
-    private readonly toolHandlers;
-    private readonly toolDefinitions;
-    private readonly systemPrompt?;
-    private readonly primerHistory?;
     private readonly maxToolIterations;
     private history;
     private busy;
     private pendingInteractions;
+    private systemPrompt?;
+    private toolDefinitions;
+    private toolHandlers;
+    private primerHistory?;
+    private activeAgentName?;
     constructor(aiProvider: AIProvider, toolHandlers?: ChatToolHandlers, toolDefinitions?: ChatToolDefinition[], systemPrompt?: string, primerHistory?: ChatMessage[], maxToolIterations?: number);
+    /**
+     * Swap in a new agent's configuration. Called by OrchestratingDriver before
+     * each specialist turn so the shared driver runs with the right tools and prompt.
+     */
+    applyAgent(config: AgentConfig): void;
     getHistory(): ReadonlyArray<ChatMessage>;
+    getRawHistory(): readonly ChatMessage[];
     isBusy(): boolean;
     /**
      * Request a custom UI interaction. Emits a new message with the interaction.
@@ -268,7 +334,14 @@ export declare class ChatDriver extends EventTarget {
      * can continue an existing conversation. Call this before the first user message.
      */
     loadHistory(messages: ChatMessage[]): void;
-    sendMessage(userInput: string, attachments?: ChatAttachment[]): Promise<void>;
+    sendMessage(userInput: string, attachments?: ChatAttachment[]): Promise<ChatDriverResult>;
+    /**
+     * Continue the tool loop from current history without appending a new user message.
+     * Used by OrchestratingDriver after an agent handoff — the handoff context is
+     * already in history; `transientPrimer` is injected as an invisible one-shot
+     * message for this call only.
+     */
+    continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
     private runToolLoop;
     private appendToHistory;
 }
@@ -280,12 +353,29 @@ export declare class ChatDriver extends EventTarget {
  */
 export declare type ChatHistoryUpdatedEvent = CustomEvent<ReadonlyArray<ChatMessage>>;
 
+/**
+ * Configuration for a fallback agent.
+ *
+ * Invoked when the classifier returns no match. Excluded from the classifier
+ * prompt. Only one fallback is permitted per agents array.
+ *
+ * @beta
+ */
+export declare interface FallbackAgentConfig extends BaseAgentConfig {
+    /**
+     * Marks this agent as the fallback for unrecognised requests.
+     */
+    fallback: true;
+    description?: never;
+}
+
 /**
  * Foundation AI Assistant component.
  *
  * @remarks
  * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents`
- * property. The component creates a `ChatDriver` to manage the conversation loop.
+ * property. The component creates a `ChatDriver` (single agent) or `OrchestratingDriver`
+ * (multiple agents) to manage the conversation loop.
  *
  * @beta
  */
@@ -314,10 +404,13 @@ export declare class FoundationAiAssistant extends GenesisElement {
     inputValue: string;
     attachments: ChatAttachment[];
     attachmentErrors: string[];
+    activeAgent?: AgentConfig;
     /** Current user-facing toggle state for tool call visibility. */
     showToolCalls: boolean;
     /** Current user-facing toggle state for thinking step visibility. */
     showThinkingSteps: boolean;
+    /** Current user-facing toggle state for agent switch indicator visibility. */
+    showAgentSwitchIndicator: boolean;
     /** Currently enabled animations. */
     enabledAnimations: AiAssistantAnimation[];
     /** Whether the loading spinner is currently visible. Controlled by the loading delay timer. */
@@ -328,11 +421,7 @@ export declare class FoundationAiAssistant extends GenesisElement {
     private loadingTimer;
     private unsubBus?;
     private haloStartPublished;
-    /**
-     * Whether the halo animation should be shown.
-     * True when the AI is actively computing (loading state, no pending interaction).
-     */
-    showHalo: boolean;
+    showHalo: 'no' | 'orchestrating' | 'agent';
     private syncShowHalo;
     /** True when there is a pending (unresolved) interaction — disables the popout button. */
     get hasActivePendingInteraction(): boolean;
@@ -363,8 +452,17 @@ export declare class FoundationAiAssistant extends GenesisElement {
     toggleSettings(): void;
     toggleShowToolCalls(): void;
     toggleShowThinkingSteps(): void;
+    toggleShowAgentSwitchIndicator(): void;
     setEnabledAnimations(animations: AiAssistantAnimation[]): void;
-    downloadHistory(): void;
+    getDebugLog(): {
+        messages: readonly ChatMessage[];
+        agentSummary: AgentConfig[];
+        host: string;
+        activeSystemPrompt: string;
+        activePrimerHistory: ChatMessage[];
+        debug: unknown;
+    };
+    downloadDebugLog(): void;
     triggerFileInput(): void;
     handleFileSelect(e: Event): void;
     removeAttachment(attachment: ChatAttachment): void;
@@ -382,6 +480,100 @@ export declare class FoundationAiAssistant extends GenesisElement {
 /** @internal */
 export declare const FoundationAiAssistantTemplate: (designSystemPrefix: string) => ViewTemplate<FoundationAiAssistant>;
 
+/**
+ * App-shell component that owns the pop-out/pop-in lifecycle for the AI assistant bubble.
+ *
+ * @remarks
+ * Place this in the persistent app shell, wrapping a `foundation-ai-chat-bubble` that
+ * contains an AI assistant element in the `dialog-content` slot. The component will
+ * auto-create a matching collapse-mode element for docking into pages, and will
+ * control the expand button visibility based on whether a dock provider is registered.
+ *
+ * Pages that support docking call `aiPopoutManager.registerDockProvider()` on mount
+ * and `aiPopoutManager.deregisterDockProvider()` on unmount.
+ *
+ * @example
+ * ```html
+ * <foundation-ai-popout-manager>
+ *   <foundation-ai-chat-bubble title="My Assistant">
+ *     <my-assistant slot="dialog-content"></my-assistant>
+ *   </foundation-ai-chat-bubble>
+ * </foundation-ai-popout-manager>
+ * ```
+ *
+ * @beta
+ */
+export declare class FoundationAiPopoutManager extends GenesisElement {
+    /** True when a dock provider is registered — controls expand button visibility. */
+    canDock: boolean;
+    private collapseEl;
+    private dockProvider;
+    private isDocked;
+    private unsubBus?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    canDockChanged(): void;
+    registerDockProvider(provider: AiDockProvider): void;
+    deregisterDockProvider(): void;
+    /**
+     * If the assistant is currently docked, collapses it back into the bubble.
+     * Await this in `onBeforeNavButtonClick` to ensure cleanup before navigation.
+     */
+    collapseIfDocked(): Promise<void>;
+}
+
+/**
+ * A warm, conversational fallback agent. Acknowledges it can't help directly,
+ * explains what the available specialists can do, and invites the user to retry.
+ *
+ * The system prompt is generated at runtime by `OrchestratingDriver` from the
+ * specialist list — no manual authoring required.
+ *
+ * @beta
+ */
+export declare const friendlyFallbackAgent: FallbackAgentConfig;
+
+/**
+ * Returns the active `FoundationAiPopoutManager` instance, or `undefined` if none is mounted.
+ * Import this in pages to call `registerDockProvider` / `deregisterDockProvider`.
+ *
+ * @beta
+ */
+export declare function getAiPopoutManager(): FoundationAiPopoutManager | undefined;
+
+/**
+ * Orchestrates multiple specialist agents. Sits between `FoundationAiAssistant`
+ * and `ChatDriver`, classifying each user message and routing it to the right
+ * specialist — each with its own focused system prompt, tools, and primer.
+ *
+ * @beta
+ */
+export declare class OrchestratingDriver extends EventTarget implements AiDriver {
+    private readonly aiProvider;
+    private readonly agents;
+    private readonly chatDriver;
+    private readonly specialists;
+    private readonly fallback?;
+    private readonly maxHandoffs;
+    private readonly classifierHistoryLength;
+    private readonly classifierRetries;
+    activeAgent?: AgentConfig;
+    constructor(aiProvider: AIProvider, agents: AgentConfig[], options?: {
+        maxHandoffs?: number;
+        classifierHistoryLength?: number;
+        classifierRetries?: number;
+        maxToolIterations?: number;
+    });
+    resolveInteraction(interactionId: string, result: unknown): void;
+    loadHistory(messages: ChatMessage[]): void;
+    getRawHistory(): readonly ChatMessage[];
+    sendMessage(input: string, attachments?: ChatAttachment[]): Promise<ChatDriverResult>;
+    continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
+    private applyAgent;
+    private classify;
+    private appendInlineMessage;
+}
+
 /**
  * Controls the pop-out button shown in the assistant header.
  * - `"expand"` — assistant is embedded in the bubble dialog; button expands it to a layout panel.
@@ -391,4 +583,34 @@ export declare const FoundationAiAssistantTemplate: (designSystemPrefix: string)
  */
 export declare type PopoutMode = 'expand' | 'collapse';
 
+/** Name reserved for the cross-agent handoff tool — injected by OrchestratingDriver. */
+export declare const REQUEST_CONTINUATION_TOOL = "request_continuation";
+
+/**
+ * Configuration for a specialist agent.
+ *
+ * Specialist agents are offered to the classifier for intent routing. The
+ * `description` is used to auto-generate the classifier prompt — no manual
+ * routing prompt authoring required.
+ *
+ * @beta
+ */
+export declare interface SpecialistAgentConfig extends BaseAgentConfig {
+    /**
+     * Plain-language description of what this agent handles.
+     * Used by the classifier to auto-generate its routing prompt.
+     */
+    description: string;
+    fallback?: never;
+}
+
+/**
+ * A brief, professional fallback agent. States what is available without
+ * elaboration. The `{{agents}}` placeholder is replaced at runtime by
+ * `OrchestratingDriver` with the generated specialist list.
+ *
+ * @beta
+ */
+export declare const strictFallbackAgent: FallbackAgentConfig;
+
 export { }

package/dist/dts/channel/ai-activity-channel.d.ts

@@ -10,6 +10,7 @@ export interface AiAssistantSerializedState {
     messages: ChatMessage[];
     showToolCalls: boolean;
     showThinkingSteps: boolean;
+    showAgentSwitchIndicator: boolean;
     enabledAnimations: AiAssistantAnimation[];
 }
 /**

package/dist/dts/channel/ai-activity-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-activity-channel.d.ts","sourceRoot":"","sources":["../../../src/channel/ai-activity-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,2FAA2F;IAC3F,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtC,iFAAiF;IACjF,WAAW,EAAE,SAAS,CAAC;IACvB,8FAA8F;IAC9F,aAAa,EAAE;QAAE,KAAK,EAAE,0BAA0B,CAAA;KAAE,CAAC;IACrD,mGAAmG;IACnG,YAAY,EAAE;QAAE,KAAK,EAAE,0BAA0B,CAAA;KAAE,CAAC;CACrD"}
+{"version":3,"file":"ai-activity-channel.d.ts","sourceRoot":"","sources":["../../../src/channel/ai-activity-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,wBAAwB,EAAE,OAAO,CAAC;IAClC,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,2FAA2F;IAC3F,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtC,iFAAiF;IACjF,WAAW,EAAE,SAAS,CAAC;IACvB,8FAA8F;IAC9F,aAAa,EAAE;QAAE,KAAK,EAAE,0BAA0B,CAAA;KAAE,CAAC;IACrD,mGAAmG;IACnG,YAAY,EAAE;QAAE,KAAK,EAAE,0BAA0B,CAAA;KAAE,CAAC;CACrD"}

package/dist/dts/components/ai-driver/ai-driver.d.ts

@@ -0,0 +1,38 @@
+import type { ChatAttachment, ChatDriverResult, ChatMessage } from '@genesislcap/foundation-ai';
+/**
+ * Common interface implemented by both `ChatDriver` (single-agent) and
+ * `OrchestratingDriver` (multi-agent). `FoundationAiAssistant` depends only
+ * on this interface — the concrete class is chosen at startup based on how
+ * many agents are configured.
+ *
+ * Extends `EventTarget` so consumers can subscribe to `history-updated` events
+ * without knowing the concrete implementation.
+ *
+ * @beta
+ */
+export interface AiDriver extends EventTarget {
+    /**
+     * Send a user message and run the tool loop to completion.
+     */
+    sendMessage(input: string, attachments?: ChatAttachment[]): Promise<ChatDriverResult>;
+    /**
+     * Continue the tool loop from the current history without appending a new
+     * user message. Used by `OrchestratingDriver` on agent handoffs — the
+     * handoff context is already in history; `transientPrimer` is injected as
+     * an invisible one-shot message for this call only.
+     */
+    continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
+    /**
+     * Resolve a pending blocking interaction with the given result.
+     */
+    resolveInteraction(interactionId: string, result: unknown): void;
+    /**
+     * Seed the driver's message history (called on state restore / pop-in).
+     */
+    loadHistory(messages: ChatMessage[]): void;
+    /**
+     * Return the full, unredacted conversation history.
+     */
+    getRawHistory?(): readonly ChatMessage[];
+}
+//# sourceMappingURL=ai-driver.d.ts.map

package/dist/dts/components/ai-driver/ai-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/ai-driver/ai-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEhG;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,mBAAmB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhF;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,aAAa,CAAC,IAAI,SAAS,WAAW,EAAE,CAAC;CAC1C"}

package/dist/dts/components/ai-driver/index.d.ts

@@ -0,0 +1,2 @@
+export type { AiDriver } from './ai-driver';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/components/ai-driver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ai-driver/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/dts/components/chat-driver/chat-driver.d.ts

@@ -1,4 +1,8 @@
-import type { AIProvider, ChatAttachment, ChatMessage, ChatToolDefinition, ChatToolHandlers } from '@genesislcap/foundation-ai';
+import type { AIProvider, ChatAttachment, ChatDriverResult, ChatMessage, ChatToolDefinition, ChatToolHandlers } from '@genesislcap/foundation-ai';
+import type { AgentConfig } from '../../config/config';
+import type { AiDriver } from '../ai-driver/ai-driver';
+/** Name reserved for the cross-agent handoff tool — injected by OrchestratingDriver. */
+export declare const REQUEST_CONTINUATION_TOOL = "request_continuation";
 /**
  * Event emitted when the chat history is updated (new message appended).
  *
@@ -13,18 +17,25 @@ export type ChatHistoryUpdatedEvent = CustomEvent<ReadonlyArray<ChatMessage>>;
  *
  * @beta
  */
-export declare class ChatDriver extends EventTarget {
+export declare class ChatDriver extends EventTarget implements AiDriver {
     private readonly aiProvider;
-    private readonly toolHandlers;
-    private readonly toolDefinitions;
-    private readonly systemPrompt?;
-    private readonly primerHistory?;
     private readonly maxToolIterations;
     private history;
     private busy;
     private pendingInteractions;
+    private systemPrompt?;
+    private toolDefinitions;
+    private toolHandlers;
+    private primerHistory?;
+    private activeAgentName?;
     constructor(aiProvider: AIProvider, toolHandlers?: ChatToolHandlers, toolDefinitions?: ChatToolDefinition[], systemPrompt?: string, primerHistory?: ChatMessage[], maxToolIterations?: number);
+    /**
+     * Swap in a new agent's configuration. Called by OrchestratingDriver before
+     * each specialist turn so the shared driver runs with the right tools and prompt.
+     */
+    applyAgent(config: AgentConfig): void;
     getHistory(): ReadonlyArray<ChatMessage>;
+    getRawHistory(): readonly ChatMessage[];
     isBusy(): boolean;
     /**
      * Request a custom UI interaction. Emits a new message with the interaction.
@@ -44,7 +55,14 @@ export declare class ChatDriver extends EventTarget {
      * can continue an existing conversation. Call this before the first user message.
      */
     loadHistory(messages: ChatMessage[]): void;
-    sendMessage(userInput: string, attachments?: ChatAttachment[]): Promise<void>;
+    sendMessage(userInput: string, attachments?: ChatAttachment[]): Promise<ChatDriverResult>;
+    /**
+     * Continue the tool loop from current history without appending a new user message.
+     * Used by OrchestratingDriver after an agent handoff — the handoff context is
+     * already in history; `transientPrimer` is injected as an invisible one-shot
+     * message for this call only.
+     */
+    continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
     private runToolLoop;
     private appendToHistory;
 }

package/dist/dts/components/chat-driver/chat-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,WAAW,EAEX,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAOpC;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,WAAW;IASvC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAbpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,mBAAmB,CAGvB;gBAGe,UAAU,EAAE,UAAU,EACtB,YAAY,GAAE,gBAAqB,EACnC,eAAe,GAAE,kBAAkB,EAAO,EAC1C,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,WAAW,EAAE,EAC7B,iBAAiB,GAAE,MAAoC;IAU1E,UAAU,IAAI,aAAa,CAAC,WAAW,CAAC;IAIxC,MAAM,IAAI,OAAO;IAIjB;;;;;;OAMG;IACU,kBAAkB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhF;;;OAGG;IACI,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAqBnE;;;OAGG;IACI,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAI3C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAoBrE,WAAW;IA2HzB,OAAO,CAAC,eAAe;CAQxB"}
+{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EAEX,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAKvD,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,WAAY,YAAW,QAAQ;IAe3D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAK3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAnBpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,mBAAmB,CAGvB;IAEJ,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAS;gBAGd,UAAU,EAAE,UAAU,EACvC,YAAY,GAAE,gBAAqB,EACnC,eAAe,GAAE,kBAAkB,EAAO,EAC1C,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,WAAW,EAAE,EACZ,iBAAiB,GAAE,MAAoC;IAS1E;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAQrC,UAAU,IAAI,aAAa,CAAC,WAAW,CAAC;IAIxC,aAAa,IAAI,SAAS,WAAW,EAAE;IAIvC,MAAM,IAAI,OAAO;IAIjB;;;;;;OAMG;IACU,kBAAkB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhF;;;OAGG;IACI,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAqBnE;;;OAGG;IACI,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAS3C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqB/F;;;;;OAKG;IACG,mBAAmB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAmBvE,WAAW;IA+IzB,OAAO,CAAC,eAAe;CAWxB"}

package/dist/dts/components/halo-overlay.d.ts

@@ -14,7 +14,19 @@ import { GenesisElement } from '@genesislcap/web-core';
  */
 export declare class AiHaloOverlay extends GenesisElement {
     active: boolean;
-    private static readonly DEG_PER_FRAME;
+    /** Rotation speed in degrees per frame. Default: 1.5 (≈ 4 s per full revolution at 60 fps). */
+    speed: number;
+    /** Rotation direction. Default: 'cw' (clockwise). */
+    direction: 'cw' | 'ccw';
+    /** Border thickness in px. Default: 3. */
+    borderSize: number;
+    /** Glow layer opacity (0–1). Default: 0.35. */
+    glowOpacity: number;
+    /** Transparent stop of the radial glow mask as a percentage (0–100). Higher = less spread. Default: 70. */
+    glowSpread: number;
+    borderSizeChanged(): void;
+    glowOpacityChanged(): void;
+    glowSpreadChanged(): void;
     private static readonly FULL_ROTATION_DEG;
     private angle;
     private animFrame?;

package/dist/dts/components/halo-overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"halo-overlay.d.ts","sourceRoot":"","sources":["../../../src/components/halo-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,cAAc,EAAQ,MAAM,uBAAuB,CAAC;AAQvF;;;;;;;;;;;;GAYG;AACH,qBAkEa,aAAc,SAAQ,cAAc;IACpB,MAAM,EAAE,OAAO,CAAS;IASnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAO;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAEhD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAC,CAAS;IAE3B,iBAAiB;IAKjB,oBAAoB;IAOpB,OAAO,CAAC,IAAI;CAKb"}
+{"version":3,"file":"halo-overlay.d.ts","sourceRoot":"","sources":["../../../src/components/halo-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,cAAc,EAAQ,MAAM,uBAAuB,CAAC;AAavF;;;;;;;;;;;;GAYG;AACH,qBA0Ea,aAAc,SAAQ,cAAc;IACpB,MAAM,EAAE,OAAO,CAAS;IACnD,+FAA+F;IACpC,KAAK,EAAE,MAAM,CAAsB;IAC9F,qDAAqD;IAC/C,SAAS,EAAE,IAAI,GAAG,KAAK,CAAQ;IACrC,0CAA0C;IAE1C,UAAU,EAAE,MAAM,CAA4B;IAC9C,+CAA+C;IAE/C,WAAW,EAAE,MAAM,CAA6B;IAChD,2GAA2G;IAE3G,UAAU,EAAE,MAAM,CAA4B;IAE9C,iBAAiB;IAIjB,kBAAkB;IAIlB,iBAAiB;IAUjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAEhD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAC,CAAS;IAE3B,iBAAiB;IAKjB,oBAAoB;IAOpB,OAAO,CAAC,IAAI;CAOb"}

package/dist/dts/components/orchestrating-driver/index.d.ts

@@ -0,0 +1,2 @@
+export { OrchestratingDriver } from './orchestrating-driver';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/components/orchestrating-driver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/orchestrating-driver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/dts/components/orchestrating-driver/orchestrating-driver.d.ts

@@ -0,0 +1,36 @@
+import type { AIProvider, ChatAttachment, ChatDriverResult, ChatMessage } from '@genesislcap/foundation-ai';
+import type { AgentConfig } from '../../config/config';
+import type { AiDriver } from '../ai-driver/ai-driver';
+/**
+ * Orchestrates multiple specialist agents. Sits between `FoundationAiAssistant`
+ * and `ChatDriver`, classifying each user message and routing it to the right
+ * specialist — each with its own focused system prompt, tools, and primer.
+ *
+ * @beta
+ */
+export declare class OrchestratingDriver extends EventTarget implements AiDriver {
+    private readonly aiProvider;
+    private readonly agents;
+    private readonly chatDriver;
+    private readonly specialists;
+    private readonly fallback?;
+    private readonly maxHandoffs;
+    private readonly classifierHistoryLength;
+    private readonly classifierRetries;
+    activeAgent?: AgentConfig;
+    constructor(aiProvider: AIProvider, agents: AgentConfig[], options?: {
+        maxHandoffs?: number;
+        classifierHistoryLength?: number;
+        classifierRetries?: number;
+        maxToolIterations?: number;
+    });
+    resolveInteraction(interactionId: string, result: unknown): void;
+    loadHistory(messages: ChatMessage[]): void;
+    getRawHistory(): readonly ChatMessage[];
+    sendMessage(input: string, attachments?: ChatAttachment[]): Promise<ChatDriverResult>;
+    continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
+    private applyAgent;
+    private classify;
+    private appendInlineMessage;
+}
+//# sourceMappingURL=orchestrating-driver.d.ts.map

package/dist/dts/components/orchestrating-driver/orchestrating-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrating-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/orchestrating-driver/orchestrating-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EAEZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAA8C,MAAM,qBAAqB,CAAC;AAEnG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAiEvD;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,WAAY,YAAW,QAAQ;IAWpE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE3C,WAAW,CAAC,EAAE,WAAW,CAAC;gBAGP,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,WAAW,EAAE,EACtC,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACvB;IAoCR,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIhE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAI1C,aAAa,IAAI,SAAS,WAAW,EAAE;IAIjC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiDrF,mBAAmB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrF,OAAO,CAAC,UAAU;YA0BJ,QAAQ;IAkEtB,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/dts/components/popout-manager/index.d.ts

@@ -0,0 +1,2 @@
+export * from './popout-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/components/popout-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/popout-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}