@genesislcap/ai-assistant 14.436.0 → 14.437.1

package/dist/ai-assistant.d.ts

@@ -5,9 +5,10 @@ import type { ChatConfig } from '@genesislcap/foundation-ai';
 import type { ChatDriverResult } from '@genesislcap/foundation-ai';
 import type { ChatInputDuringExecutionMode } from '@genesislcap/foundation-ai';
 import type { ChatMessage } from '@genesislcap/foundation-ai';
-import type { ChatToolDefinition } from '@genesislcap/foundation-ai';
+import { ChatToolDefinition } from '@genesislcap/foundation-ai';
 import type { ChatToolHandlers } from '@genesislcap/foundation-ai';
 import { GenesisElement } from '@genesislcap/web-core';
+import type { InteractionRequestOptions } from '@genesislcap/foundation-ai';
 import type { InteractionResult } from '@genesislcap/foundation-ai';
 import { ViewTemplate } from '@genesislcap/web-core';
 
@@ -375,9 +376,21 @@ export declare const ANIMATION_DEFS: {
 
 declare interface BaseAgentConfig {
     /**
-     * Display name shown in the chat header when this agent is active.
+     * Stable identity for this agent. Used for classifier routing, manual
+     * pinning, and history filtering — must not vary per turn. For a per-turn
+     * display label (e.g. "Guided Booking (Counterparties)"), supply
+     * {@link BaseAgentConfig.displayName}.
      */
     name: string;
+    /**
+     * Optional per-turn display label. Resolved each tool-loop iteration and
+     * stamped onto outgoing messages (`agentLabel`) and the debug-log timeline.
+     * Renderers fall back to `name` when this is unset. Use the function form
+     * to vary the label by current state (e.g. a state machine's step).
+     *
+     * Identity stays on `name` — this is for UX only.
+     */
+    displayName?: SystemPromptInput;
     /**
      * System prompt injected into every conversation turn for this agent.
      *
@@ -397,8 +410,13 @@ declare interface BaseAgentConfig {
     toolDefinitions?: ToolDefinitionsInput;
     /**
      * Tool handler implementations for this agent.
+     *
+     * Either a static map or a function resolved each tool-loop iteration —
+     * pick the function form to narrow the dispatchable handler set per turn,
+     * matching the function form of `toolDefinitions`.
+     * See {@link ToolHandlersInput}.
      */
-    toolHandlers?: ChatToolHandlers;
+    toolHandlers?: ToolHandlersInput;
     /**
      * Optional primer history prepended to every call (not visible to the user).
      * Used to establish agent identity and behavioural rules.
@@ -485,9 +503,31 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * in that case.
      */
     private toolDefinitionsFactory?;
+    /**
+     * Resolved tool handler map used for dispatch. When `toolHandlersFactory` is
+     * set, this is overwritten each tool-loop iteration with the factory's output
+     * — keeping it in lockstep with `toolDefinitions` so handlers don't have to
+     * defend themselves against being dispatched in states where their tool
+     * isn't advertised. Folds mutate this in place; `defineStatefulAgent`
+     * forbids folds when a factory is set, so the fold-mutation path is
+     * unreachable in that case.
+     */
     private toolHandlers;
+    /**
+     * Optional per-turn handler-map source. Mirrors `toolDefinitionsFactory` so
+     * the LLM-visible tools and the dispatchable handlers can be narrowed in
+     * lockstep. Resolved each tool-loop iteration before the LLM call.
+     */
+    private toolHandlersFactory?;
     private primerHistory?;
     private activeAgentName?;
+    /**
+     * Per-turn display label resolved from the agent's `displayName`. Stamped
+     * onto outgoing messages and turn snapshots for UX; `activeAgentName` stays
+     * stable for routing/history-transform identity matching.
+     */
+    private activeAgentLabel?;
+    private displayName?;
     /**
      * When set, `requestInteraction` delegates to this callback instead of using
      * this driver's own pending map. Wired by `invokeSubAgent` so a sub-agent's
@@ -537,7 +577,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
     /** Captured from `applyAgent` so we don't store the whole `AgentConfig`. */
     private debugSnapshotter?;
     private readonly maxTurnSnapshots;
-    constructor(aiProvider: AIProvider, toolHandlers?: ChatToolHandlers, toolDefinitions?: ToolDefinitionsInput, systemPrompt?: SystemPromptInput, primerHistory?: ChatMessage[], maxToolIterations?: number, maxFoldOperations?: number, maxTurnSnapshots?: number);
+    constructor(aiProvider: AIProvider, toolHandlers?: ToolHandlersInput, toolDefinitions?: ToolDefinitionsInput, systemPrompt?: SystemPromptInput, primerHistory?: ChatMessage[], maxToolIterations?: number, maxFoldOperations?: number, maxTurnSnapshots?: 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.
@@ -586,7 +626,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * resolves through) the parent's history and pending map. Calls chain
      * naturally: a grandchild → child → root.
      */
-    setHostInteractionRequester(fn: <T>(componentName: string, data: any) => Promise<T>): void;
+    setHostInteractionRequester(fn: <T>(componentName: string, data: any, options?: InteractionRequestOptions) => Promise<T>): void;
     /**
      * Request a custom UI interaction. Emits a new message with the interaction.
      * Tool handlers can call this to pause execution until the user completes the UI interaction.
@@ -600,8 +640,11 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      *
      * @param componentName - The custom element name to render.
      * @param data - Data to pass to the component.
+     * @param options - Optional per-call overrides, including
+     *   `chatInputDuringExecution` to hide or disable the main chat input while
+     *   the widget is awaiting user input. Reverts when the interaction resolves.
      */
-    requestInteraction<T>(componentName: string, data: any): Promise<T>;
+    requestInteraction<T>(componentName: string, data: any, options?: InteractionRequestOptions): Promise<T>;
     /**
      * Resolve a pending interaction. The wrapper component calls this on completion.
      * Marks the interaction message as resolved so it renders read-only on re-render.
@@ -891,13 +934,13 @@ export declare class FoundationAiAssistant extends GenesisElement {
     get liveSubAgentName(): string | null;
     set liveSubAgentName(value: string | null);
     /**
-     * In-flight per-call chat-input overrides pushed by `requestSubAgent`
-     * invocations. Empty means no override is active.
+     * In-flight per-call chat-input overrides pushed by `requestSubAgent` or
+     * `requestInteraction` calls. Empty means no override is active.
      */
-    get subAgentInputOverrides(): SubAgentInputOverride[];
+    get inputOverrides(): InputOverride[];
     /**
      * Resolves the effective chat-input behaviour while the assistant is
-     * executing. Sub-agent overrides take precedence over the agent-level
+     * executing. Per-call overrides take precedence over the agent-level
      * config; among overrides the most restrictive wins (`'hidden'` >
      * `'disabled'`). Falls back to the active agent's config, then `'disabled'`.
      */
@@ -1080,7 +1123,7 @@ export declare class FoundationAiAssistant extends GenesisElement {
             timestamp: string;
             host: string;
             agentSummary: ({
-                toolDefinitions: string | ToolTreeNode[];
+                toolDefinitions: string | ChatToolDefinition[];
                 toolHandlers: any;
                 onActivate: any;
                 onDeactivate: any;
@@ -1089,13 +1132,14 @@ export declare class FoundationAiAssistant extends GenesisElement {
                 fallback?: never;
                 excludeFromClassifier?: boolean;
                 name: string;
+                displayName?: SystemPromptInput;
                 systemPrompt?: SystemPromptInput;
                 primerHistory?: ChatMessage[];
                 subAgents?: AgentConfig[];
                 chatInputDuringExecution?: ChatInputDuringExecutionMode;
                 manualSelection?: ManualSelectionConfig;
             } | {
-                toolDefinitions: string | ToolTreeNode[];
+                toolDefinitions: string | ChatToolDefinition[];
                 toolHandlers: any;
                 onActivate: any;
                 onDeactivate: any;
@@ -1103,6 +1147,7 @@ export declare class FoundationAiAssistant extends GenesisElement {
                 fallback: true;
                 description?: never;
                 name: string;
+                displayName?: SystemPromptInput;
                 systemPrompt?: SystemPromptInput;
                 primerHistory?: ChatMessage[];
                 subAgents?: AgentConfig[];
@@ -1197,6 +1242,22 @@ export declare const friendlyFallbackAgent: FallbackAgentConfig;
  */
 export declare function getAiPopoutManager(): FoundationAiPopoutManager | undefined;
 
+/**
+ * A single in-flight per-call chat-input override pushed by a `requestSubAgent`
+ * or `requestInteraction` call. Tracked as an array (not a counter) so the
+ * slice can survive pop-in/pop-out and so a listener that connects
+ * mid-execution can compute the effective mode without having seen the start
+ * event.
+ *
+ * @internal
+ */
+declare interface InputOverride {
+    /** Unique per-invocation id, paired with the start/stop events. */
+    id: string;
+    /** The mode requested for this invocation. */
+    mode: ChatInputDuringExecutionMode;
+}
+
 /**
  * Opts an agent in to manual selection from the assistant's agent picker.
  *
@@ -1332,6 +1393,20 @@ export declare interface SpecialistAgentConfig extends BaseAgentConfig {
     excludeFromClassifier?: boolean;
 }
 
+/**
+ * Context passed to per-turn resolvers on a stateful agent — the standard
+ * {@link SystemPromptContext} plus the live `state` value. Used by
+ * `systemPrompt`, `displayName`, and the function form of `toolDefinitions`.
+ *
+ * Exported so consumers can lift resolvers into separate files without
+ * re-deriving the shape.
+ *
+ * @beta
+ */
+export declare type StatefulAgentContext<S> = SystemPromptContext & {
+    state: S;
+};
+
 /**
  * Init options for {@link defineStatefulAgent}. Generic over the state shape `S`
  * the agent owns (a state machine, an observable controller, anything).
@@ -1379,9 +1454,14 @@ export declare interface StatefulAgentInit<S> {
      * iteration. Use this to feed the LLM whatever the current state implies
      * (e.g. a state machine's `meta.systemPrompt` plus captured context).
      */
-    systemPrompt?: (ctx: SystemPromptContext & {
-        state: S;
-    }) => string | Promise<string>;
+    systemPrompt?: (ctx: StatefulAgentContext<S>) => string | Promise<string>;
+    /**
+     * Per-turn display label, e.g. "Guided Booking (Counterparties)". Resolved
+     * each tool-loop iteration and stamped onto outgoing messages and the
+     * debug-log timeline — display only. The agent's `name` stays as the
+     * canonical identity used for routing/history filtering.
+     */
+    displayName?: (ctx: StatefulAgentContext<S>) => string | Promise<string>;
     /**
      * Tool definitions the LLM sees. Either a static array (resolved once) or a
      * function resolved each tool-loop iteration. The function form is how a
@@ -1393,20 +1473,26 @@ export declare interface StatefulAgentInit<S> {
      * has to be in charge. Helper throws at init time if a fold-tagged handler
      * is detected.
      */
-    toolDefinitions?: ChatToolDefinition[] | ((ctx: SystemPromptContext & {
-        state: S;
-    }) => ChatToolDefinition[] | Promise<ChatToolDefinition[]>);
+    toolDefinitions?: ChatToolDefinition[] | ((ctx: StatefulAgentContext<S>) => ChatToolDefinition[] | Promise<ChatToolDefinition[]>);
     /**
-     * Factory returning the tool handler map. Called with the live `state` at
-     * `onActivate` time; the handlers it returns are cached for the lifetime of
-     * this activation. Each handler closes over `state` and any other deps you
-     * captured.
+     * Factory returning the handler map for the **current state**. Called each
+     * tool-loop iteration with the live `state` value, so the handler set the
+     * driver dispatches against matches what `toolDefinitions` exposes to the
+     * LLM that turn. Return only the handlers valid right now — no need to
+     * advertise every handler the agent might ever expose, and no defensive
+     * `if (!machine.matches(...))` guards inside each handler.
+     *
+     * Pair with the function form of `toolDefinitions` so the visible tools and
+     * the dispatchable handlers stay in lockstep.
      *
-     * The handler set returned must be the **union** of every tool name your
-     * agent might advertise across all states — `toolDefinitions` filters which
-     * are visible to the LLM per turn, but every name still needs an entry here.
+     * **Constraint:** resolved handlers must not include fold facades. Folds and
+     * state-machine-driven tool filtering both try to control the LLM's tool
+     * view — pick one. Helper samples once on activation (init state) and
+     * throws if a fold-tagged handler is detected; subsequent resolves also
+     * validate, so misuse on a non-init state surfaces when that state is
+     * reached.
      */
-    toolHandlers?: (state: S) => ChatToolHandlers;
+    toolHandlers?: (state: S) => ChatToolHandlers | Promise<ChatToolHandlers>;
     /**
      * Optional getter for the debug-log snapshot. Defaults to auto-snapshotting
      * any property on `state` that looks like a foundation-state-machine
@@ -1428,21 +1514,6 @@ export declare interface StatefulAgentInit<S> {
  */
 export declare const strictFallbackAgent: FallbackAgentConfig;
 
-/**
- * A single in-flight per-call chat-input override pushed by a `requestSubAgent`
- * invocation. Tracked as an array (not a counter) so the slice can survive
- * pop-in/pop-out and so a listener that connects mid-execution can compute the
- * effective mode without having seen the start event.
- *
- * @internal
- */
-declare interface SubAgentInputOverride {
-    /** Unique per-invocation id, paired with the start/stop events. */
-    id: string;
-    /** The mode requested for this invocation. */
-    mode: ChatInputDuringExecutionMode;
-}
-
 /**
  * State of the chat suggestions feature.
  *
@@ -1548,6 +1619,18 @@ export declare interface ToolFoldResult {
     handler: ChatToolHandlers;
 }
 
+/**
+ * Tool handlers for an agent. Either a static map (the conventional shape) or a
+ * function resolved each tool-loop iteration. The function form lets the agent
+ * narrow the dispatchable handler set per turn — pair it with the function form
+ * of `toolDefinitions` so the LLM-visible tools and the dispatchable handlers
+ * stay in lockstep, and handlers don't have to defend themselves against being
+ * dispatched in states where their tool isn't advertised.
+ *
+ * @beta
+ */
+export declare type ToolHandlersInput = ChatToolHandlers | ((ctx: SystemPromptContext) => ChatToolHandlers | Promise<ChatToolHandlers>);
+
 /**
  * A tool entry in the expanded debug tree.
  * Folds are represented as nodes with a `tools` array; regular tools have none.
@@ -1580,6 +1663,12 @@ export declare interface TurnSnapshot {
     systemPrompt?: string;
     /** Tool names sent to the LLM, in order — definitions are static per name so names alone suffice. */
     toolNames: string[];
+    /**
+     * Per-turn display label resolved from the agent's `displayName`, e.g.
+     * "Guided Booking (Counterparties)". `agentName` stays as the canonical
+     * identity used for routing/filtering.
+     */
+    agentLabel?: string;
     /** Agent-supplied snapshot — machine state/context for stateful agents, undefined otherwise. */
     agentSnapshot?: unknown;
 }

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

@@ -1,5 +1,5 @@
-import type { AIProvider, ChatAttachment, ChatDriverResult, ChatMessage, ChatToolHandlers } from '@genesislcap/foundation-ai';
-import type { AgentConfig, SystemPromptInput, ToolDefinitionsInput } from '../../config/config';
+import type { AIProvider, ChatAttachment, ChatDriverResult, ChatMessage, InteractionRequestOptions } from '@genesislcap/foundation-ai';
+import type { AgentConfig, SystemPromptInput, ToolDefinitionsInput, ToolHandlersInput } from '../../config/config';
 import type { AiDriver, AllAgentSummary } from '../ai-driver/ai-driver';
 /** Name reserved for the cross-agent handoff tool — injected by OrchestratingDriver. */
 export declare const REQUEST_CONTINUATION_TOOL = "request_continuation";
@@ -30,6 +30,12 @@ export interface TurnSnapshot {
     systemPrompt?: string;
     /** Tool names sent to the LLM, in order — definitions are static per name so names alone suffice. */
     toolNames: string[];
+    /**
+     * Per-turn display label resolved from the agent's `displayName`, e.g.
+     * "Guided Booking (Counterparties)". `agentName` stays as the canonical
+     * identity used for routing/filtering.
+     */
+    agentLabel?: string;
     /** Agent-supplied snapshot — machine state/context for stateful agents, undefined otherwise. */
     agentSnapshot?: unknown;
 }
@@ -63,9 +69,31 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * in that case.
      */
     private toolDefinitionsFactory?;
+    /**
+     * Resolved tool handler map used for dispatch. When `toolHandlersFactory` is
+     * set, this is overwritten each tool-loop iteration with the factory's output
+     * — keeping it in lockstep with `toolDefinitions` so handlers don't have to
+     * defend themselves against being dispatched in states where their tool
+     * isn't advertised. Folds mutate this in place; `defineStatefulAgent`
+     * forbids folds when a factory is set, so the fold-mutation path is
+     * unreachable in that case.
+     */
     private toolHandlers;
+    /**
+     * Optional per-turn handler-map source. Mirrors `toolDefinitionsFactory` so
+     * the LLM-visible tools and the dispatchable handlers can be narrowed in
+     * lockstep. Resolved each tool-loop iteration before the LLM call.
+     */
+    private toolHandlersFactory?;
     private primerHistory?;
     private activeAgentName?;
+    /**
+     * Per-turn display label resolved from the agent's `displayName`. Stamped
+     * onto outgoing messages and turn snapshots for UX; `activeAgentName` stays
+     * stable for routing/history-transform identity matching.
+     */
+    private activeAgentLabel?;
+    private displayName?;
     /**
      * When set, `requestInteraction` delegates to this callback instead of using
      * this driver's own pending map. Wired by `invokeSubAgent` so a sub-agent's
@@ -115,7 +143,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
     /** Captured from `applyAgent` so we don't store the whole `AgentConfig`. */
     private debugSnapshotter?;
     private readonly maxTurnSnapshots;
-    constructor(aiProvider: AIProvider, toolHandlers?: ChatToolHandlers, toolDefinitions?: ToolDefinitionsInput, systemPrompt?: SystemPromptInput, primerHistory?: ChatMessage[], maxToolIterations?: number, maxFoldOperations?: number, maxTurnSnapshots?: number);
+    constructor(aiProvider: AIProvider, toolHandlers?: ToolHandlersInput, toolDefinitions?: ToolDefinitionsInput, systemPrompt?: SystemPromptInput, primerHistory?: ChatMessage[], maxToolIterations?: number, maxFoldOperations?: number, maxTurnSnapshots?: 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.
@@ -164,7 +192,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * resolves through) the parent's history and pending map. Calls chain
      * naturally: a grandchild → child → root.
      */
-    setHostInteractionRequester(fn: <T>(componentName: string, data: any) => Promise<T>): void;
+    setHostInteractionRequester(fn: <T>(componentName: string, data: any, options?: InteractionRequestOptions) => Promise<T>): void;
     /**
      * Request a custom UI interaction. Emits a new message with the interaction.
      * Tool handlers can call this to pause execution until the user completes the UI interaction.
@@ -178,8 +206,11 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      *
      * @param componentName - The custom element name to render.
      * @param data - Data to pass to the component.
+     * @param options - Optional per-call overrides, including
+     *   `chatInputDuringExecution` to hide or disable the main chat input while
+     *   the widget is awaiting user input. Reverts when the interaction resolves.
      */
-    requestInteraction<T>(componentName: string, data: any): Promise<T>;
+    requestInteraction<T>(componentName: string, data: any, options?: InteractionRequestOptions): Promise<T>;
     /**
      * Resolve a pending interaction. The wrapper component calls this on completion.
      * Marks the interaction message as resolved so it renders read-only on re-render.

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":"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"}
+{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"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"}

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

@@ -1 +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,EACV,WAAW,EAKZ,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AAoDpC;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,WAAY,YAAW,QAAQ;IAkBpE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAlBzB,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;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAyB;IAClE,OAAO,CAAC,eAAe,CAAuB;IAE9C,WAAW,CAAC,EAAE,WAAW,CAAC;gBAGP,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,WAAW,EAAE,EACtC,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KACtB;IAoDR,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIhE,MAAM,IAAI,OAAO;IAIjB;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIzC,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAI1C,aAAa,IAAI,SAAS,WAAW,EAAE;IAIvC,4EAA4E;IAC5E,gBAAgB,IAAI,aAAa,CAAC,YAAY,CAAC;IAIzC,cAAc,CAClB,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,eAAe,EAAE,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwErF,mBAAmB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAIvE,UAAU;IAgFxB;;;;OAIG;YACW,kBAAkB;IAuBhC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBhB,QAAQ;IA+FtB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,mBAAmB;CAO5B"}
+{"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,EACV,WAAW,EAKZ,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AAoDpC;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,WAAY,YAAW,QAAQ;IAkBpE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAlBzB,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;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAyB;IAClE,OAAO,CAAC,eAAe,CAAuB;IAE9C,WAAW,CAAC,EAAE,WAAW,CAAC;gBAGP,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,WAAW,EAAE,EACtC,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KACtB;IA8DR,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIhE,MAAM,IAAI,OAAO;IAIjB;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIzC,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAI1C,aAAa,IAAI,SAAS,WAAW,EAAE;IAIvC,4EAA4E;IAC5E,gBAAgB,IAAI,aAAa,CAAC,YAAY,CAAC;IAIzC,cAAc,CAClB,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,eAAe,EAAE,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwErF,mBAAmB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAIvE,UAAU;IAgFxB;;;;OAIG;YACW,kBAAkB;IAuBhC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBhB,QAAQ;IA+FtB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/dts/config/config.d.ts

@@ -48,6 +48,17 @@ export type SystemPromptInput = string | ((ctx: SystemPromptContext) => string |
  * @beta
  */
 export type ToolDefinitionsInput = ChatToolDefinition[] | ((ctx: SystemPromptContext) => ChatToolDefinition[] | Promise<ChatToolDefinition[]>);
+/**
+ * Tool handlers for an agent. Either a static map (the conventional shape) or a
+ * function resolved each tool-loop iteration. The function form lets the agent
+ * narrow the dispatchable handler set per turn — pair it with the function form
+ * of `toolDefinitions` so the LLM-visible tools and the dispatchable handlers
+ * stay in lockstep, and handlers don't have to defend themselves against being
+ * dispatched in states where their tool isn't advertised.
+ *
+ * @beta
+ */
+export type ToolHandlersInput = ChatToolHandlers | ((ctx: SystemPromptContext) => ChatToolHandlers | Promise<ChatToolHandlers>);
 /**
  * Opts an agent in to manual selection from the assistant's agent picker.
  *
@@ -69,9 +80,21 @@ export interface ManualSelectionConfig {
 }
 interface BaseAgentConfig {
     /**
-     * Display name shown in the chat header when this agent is active.
+     * Stable identity for this agent. Used for classifier routing, manual
+     * pinning, and history filtering — must not vary per turn. For a per-turn
+     * display label (e.g. "Guided Booking (Counterparties)"), supply
+     * {@link BaseAgentConfig.displayName}.
      */
     name: string;
+    /**
+     * Optional per-turn display label. Resolved each tool-loop iteration and
+     * stamped onto outgoing messages (`agentLabel`) and the debug-log timeline.
+     * Renderers fall back to `name` when this is unset. Use the function form
+     * to vary the label by current state (e.g. a state machine's step).
+     *
+     * Identity stays on `name` — this is for UX only.
+     */
+    displayName?: SystemPromptInput;
     /**
      * System prompt injected into every conversation turn for this agent.
      *
@@ -91,8 +114,13 @@ interface BaseAgentConfig {
     toolDefinitions?: ToolDefinitionsInput;
     /**
      * Tool handler implementations for this agent.
+     *
+     * Either a static map or a function resolved each tool-loop iteration —
+     * pick the function form to narrow the dispatchable handler set per turn,
+     * matching the function form of `toolDefinitions`.
+     * See {@link ToolHandlersInput}.
      */
-    toolHandlers?: ChatToolHandlers;
+    toolHandlers?: ToolHandlersInput;
     /**
      * Optional primer history prepended to every call (not visible to the user).
      * Used to establish agent identity and behavioural rules.

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/config/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/config/config.ts"],"names":[],"mappings":"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"}

package/dist/dts/config/define-stateful-agent.d.ts

@@ -1,5 +1,18 @@
 import type { ChatMessage, ChatToolDefinition, ChatToolHandlers } from '@genesislcap/foundation-ai';
 import type { AgentConfig, AgentLifecycleContext, ChatInputDuringExecutionMode, ManualSelectionConfig, SystemPromptContext } from './config';
+/**
+ * Context passed to per-turn resolvers on a stateful agent — the standard
+ * {@link SystemPromptContext} plus the live `state` value. Used by
+ * `systemPrompt`, `displayName`, and the function form of `toolDefinitions`.
+ *
+ * Exported so consumers can lift resolvers into separate files without
+ * re-deriving the shape.
+ *
+ * @beta
+ */
+export type StatefulAgentContext<S> = SystemPromptContext & {
+    state: S;
+};
 /**
  * Init options for {@link defineStatefulAgent}. Generic over the state shape `S`
  * the agent owns (a state machine, an observable controller, anything).
@@ -47,9 +60,14 @@ export interface StatefulAgentInit<S> {
      * iteration. Use this to feed the LLM whatever the current state implies
      * (e.g. a state machine's `meta.systemPrompt` plus captured context).
      */
-    systemPrompt?: (ctx: SystemPromptContext & {
-        state: S;
-    }) => string | Promise<string>;
+    systemPrompt?: (ctx: StatefulAgentContext<S>) => string | Promise<string>;
+    /**
+     * Per-turn display label, e.g. "Guided Booking (Counterparties)". Resolved
+     * each tool-loop iteration and stamped onto outgoing messages and the
+     * debug-log timeline — display only. The agent's `name` stays as the
+     * canonical identity used for routing/history filtering.
+     */
+    displayName?: (ctx: StatefulAgentContext<S>) => string | Promise<string>;
     /**
      * Tool definitions the LLM sees. Either a static array (resolved once) or a
      * function resolved each tool-loop iteration. The function form is how a
@@ -61,20 +79,26 @@ export interface StatefulAgentInit<S> {
      * has to be in charge. Helper throws at init time if a fold-tagged handler
      * is detected.
      */
-    toolDefinitions?: ChatToolDefinition[] | ((ctx: SystemPromptContext & {
-        state: S;
-    }) => ChatToolDefinition[] | Promise<ChatToolDefinition[]>);
+    toolDefinitions?: ChatToolDefinition[] | ((ctx: StatefulAgentContext<S>) => ChatToolDefinition[] | Promise<ChatToolDefinition[]>);
     /**
-     * Factory returning the tool handler map. Called with the live `state` at
-     * `onActivate` time; the handlers it returns are cached for the lifetime of
-     * this activation. Each handler closes over `state` and any other deps you
-     * captured.
+     * Factory returning the handler map for the **current state**. Called each
+     * tool-loop iteration with the live `state` value, so the handler set the
+     * driver dispatches against matches what `toolDefinitions` exposes to the
+     * LLM that turn. Return only the handlers valid right now — no need to
+     * advertise every handler the agent might ever expose, and no defensive
+     * `if (!machine.matches(...))` guards inside each handler.
+     *
+     * Pair with the function form of `toolDefinitions` so the visible tools and
+     * the dispatchable handlers stay in lockstep.
      *
-     * The handler set returned must be the **union** of every tool name your
-     * agent might advertise across all states — `toolDefinitions` filters which
-     * are visible to the LLM per turn, but every name still needs an entry here.
+     * **Constraint:** resolved handlers must not include fold facades. Folds and
+     * state-machine-driven tool filtering both try to control the LLM's tool
+     * view — pick one. Helper samples once on activation (init state) and
+     * throws if a fold-tagged handler is detected; subsequent resolves also
+     * validate, so misuse on a non-init state surfaces when that state is
+     * reached.
      */
-    toolHandlers?: (state: S) => ChatToolHandlers;
+    toolHandlers?: (state: S) => ChatToolHandlers | Promise<ChatToolHandlers>;
     /**
      * Optional getter for the debug-log snapshot. Defaults to auto-snapshotting
      * any property on `state` that looks like a foundation-state-machine

package/dist/dts/config/define-stateful-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-stateful-agent.d.ts","sourceRoot":"","sources":["../../../src/config/define-stateful-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEpG,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,2GAA2G;IAC3G,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,gFAAgF;IAChF,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,oDAAoD;IACpD,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,qEAAqE;IACrE,wBAAwB,CAAC,EAAE,4BAA4B,CAAC;IAExD;;;OAGG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,GAAG;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErF;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EACZ,kBAAkB,EAAE,GACpB,CAAC,CACC,GAAG,EAAE,mBAAmB,GAAG;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,KACpC,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAE/D;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,gBAAgB,CAAC;IAE9C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CAC1C;AAsCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,WAAW,CAiI9E"}
+{"version":3,"file":"define-stateful-agent.d.ts","sourceRoot":"","sources":["../../../src/config/define-stateful-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEpG,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EAIpB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,mBAAmB,GAAG;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,2GAA2G;IAC3G,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,gFAAgF;IAChF,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,oDAAoD;IACpD,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,qEAAqE;IACrE,wBAAwB,CAAC,EAAE,4BAA4B,CAAC;IAExD;;;OAGG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzE;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EACZ,kBAAkB,EAAE,GACpB,CAAC,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAE7F;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE1E;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CAC1C;AAsCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,WAAW,CAoH9E"}

package/dist/dts/main/main.d.ts

@@ -93,13 +93,13 @@ export declare class FoundationAiAssistant extends GenesisElement {
     get liveSubAgentName(): string | null;
     set liveSubAgentName(value: string | null);
     /**
-     * In-flight per-call chat-input overrides pushed by `requestSubAgent`
-     * invocations. Empty means no override is active.
+     * In-flight per-call chat-input overrides pushed by `requestSubAgent` or
+     * `requestInteraction` calls. Empty means no override is active.
      */
-    get subAgentInputOverrides(): import("../state/ai-assistant-slice").SubAgentInputOverride[];
+    get inputOverrides(): import("../state/ai-assistant-slice").InputOverride[];
     /**
      * Resolves the effective chat-input behaviour while the assistant is
-     * executing. Sub-agent overrides take precedence over the agent-level
+     * executing. Per-call overrides take precedence over the agent-level
      * config; among overrides the most restrictive wins (`'hidden'` >
      * `'disabled'`). Falls back to the active agent's config, then `'disabled'`.
      */
@@ -282,7 +282,7 @@ export declare class FoundationAiAssistant extends GenesisElement {
             timestamp: string;
             host: string;
             agentSummary: ({
-                toolDefinitions: string | import("../utils/tool-fold").ToolTreeNode[];
+                toolDefinitions: string | import("@genesislcap/foundation-ai").ChatToolDefinition[];
                 toolHandlers: any;
                 onActivate: any;
                 onDeactivate: any;
@@ -291,13 +291,14 @@ export declare class FoundationAiAssistant extends GenesisElement {
                 fallback?: never;
                 excludeFromClassifier?: boolean;
                 name: string;
+                displayName?: import("../config/config").SystemPromptInput;
                 systemPrompt?: import("../config/config").SystemPromptInput;
                 primerHistory?: ChatMessage[];
                 subAgents?: AgentConfig[];
                 chatInputDuringExecution?: ChatInputDuringExecutionMode;
                 manualSelection?: import("../config/config").ManualSelectionConfig;
             } | {
-                toolDefinitions: string | import("../utils/tool-fold").ToolTreeNode[];
+                toolDefinitions: string | import("@genesislcap/foundation-ai").ChatToolDefinition[];
                 toolHandlers: any;
                 onActivate: any;
                 onDeactivate: any;
@@ -305,6 +306,7 @@ export declare class FoundationAiAssistant extends GenesisElement {
                 fallback: true;
                 description?: never;
                 name: string;
+                displayName?: import("../config/config").SystemPromptInput;
                 systemPrompt?: import("../config/config").SystemPromptInput;
                 primerHistory?: ChatMessage[];
                 subAgents?: AgentConfig[];