@genesislcap/ai-assistant 15.18.0 → 15.19.0-DCD-4786.3

package/dist/ai-assistant.api.json

@@ -291,7 +291,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/ai-assistant!AGENT_PICKER_AUTO_VALUE:var",
-          "docComment": "/**\n * Sentinel value used by the segmented control / select to represent \"Auto\".\n */\n",
+          "docComment": "/**\n * Sentinel value representing \"Auto\" where a menu row needs a string value.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1398,7 +1398,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!AgentPicker:class",
-          "docComment": "/**\n * User-facing agent picker rendered above the chat input.\n *\n * Renders `Auto` plus each top-level agent that has `manualSelection.enabled`. Sub-agents and non-selectable specialists are excluded. Hidden when fewer than two agents are configured or none are manually selectable.\n *\n * @fires\n *\n * agent-pinned - Fired when the user changes selection with the agent name or `null` for Auto. detail: `string | null`\n *\n * @beta\n */\n",
+          "docComment": "/**\n * The agent menu shown from the composer's agent button.\n *\n * Renders `Auto` plus each top-level agent with `manualSelection.enabled`, one row apiece, tinted with the same pin colour the composer button shows once that agent is pinned. Sub-agents and non-selectable specialists are excluded. Hidden when fewer than two agents are configured or none are manually selectable.\n *\n * The rows are all this element owns. The panel around them — surface, border, position, open/close animation — belongs to the assistant, which renders this menu and the session (⋮) menu into the same container so the two match.\n *\n * @fires\n *\n * agent-pinned - Fired when the user changes selection with the agent name or `null` for Auto. detail: `string | null`\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1455,72 +1455,10 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#agentsChanged:member(1)",
-              "docComment": "/**\n * Re-measure when agents change — newly added selectable agents may push the segmented row past the container's width.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "agentsChanged(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "agentsChanged"
-            },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#connectedCallback:member(1)",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "connectedCallback(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "connectedCallback"
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#currentValue:member",
-              "docComment": "/**\n * Current pinned agent name as a value the segmented-control / select can bind to.\n */\n",
+              "docComment": "/**\n * Current pinned agent name as a bindable value.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1549,16 +1487,16 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#designSystemPrefix:member",
-              "docComment": "/**\n * Design-system tag prefix, e.g. `'rapid'` for `rapid-segmented-control`.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#disablePinColours:member",
+              "docComment": "/**\n * When true, rows show a neutral dot instead of the per-agent brand tint.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "designSystemPrefix: "
+                  "text": "disablePinColours: "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
@@ -1568,7 +1506,7 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "designSystemPrefix",
+              "name": "disablePinColours",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -1579,16 +1517,25 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#disconnectedCallback:member(1)",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#markStyleFor:member(1)",
+              "docComment": "/**\n * Inline `--menu-item-mark` for one row, or `''` to leave the dot neutral.\n *\n * Indexed against the FULL agents array rather than `selectableAgents` so a row's tint matches what the composer button shows when that agent is pinned — the assistant resolves its pin colour the same way, and the two disagreeing is exactly the bug this shares `pinColourAt` to avoid.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "disconnectedCallback(): "
+                  "text": "markStyleFor(agent: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "void"
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
@@ -1597,51 +1544,30 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "releaseTag": "Beta",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "disconnectedCallback"
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#effectiveMode:member",
-              "docComment": "/**\n * The variant actually rendered: `'select'` if user-configured or if the segmented row currently overflows; `'segmented-control'` otherwise.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get effectiveMode(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "'select' | 'segmented-control'"
-                },
+              "parameters": [
                 {
-                  "kind": "Content",
-                  "text": ";"
+                  "parameterName": "agent",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
                 }
               ],
-              "isReadonly": true,
               "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "effectiveMode",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
+              "isAbstract": false,
+              "name": "markStyleFor"
             },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#mode:member",
-              "docComment": "/**\n * Picker variant, sourced from the assistant's `chatConfig.agentPicker`.\n */\n",
+              "docComment": "/**\n * Picker variant, sourced from the assistant's `chatConfig.picker.mode`. `'disabled'` hides the picker; every other value renders the same menu — `'select'` and `'segmented-control'` are retained so existing configuration stays valid, but no longer select between two layouts.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1669,37 +1595,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#modeChanged:member(1)",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "modeChanged(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "modeChanged"
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#pinnedAgentName:member",
@@ -1816,7 +1711,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AgentPicker#selectByValue:member(1)",
-              "docComment": "/**\n * Maps a value from the segmented-control or select (which uses {@link AGENT_PICKER_AUTO_VALUE} for Auto) back to the `string | null` form expected by `selectAgent`.\n */\n",
+              "docComment": "/**\n * Maps a value using {@link AGENT_PICKER_AUTO_VALUE} for Auto back to the `string | null` form {@link AgentPicker.selectAgent} expects. Retained for hosts driving the picker from a value rather than a name.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7462,6 +7357,36 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#agentButtonLabel:member",
+              "docComment": "/**\n * Label beside the composer's agent glyph: `AUTO` while the orchestrator is routing, otherwise the pinned agent's name. The name is NOT shortened here — the button truncates with an ellipsis in CSS, so the full name stays available to a screen reader and to the `title` tooltip.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get agentButtonLabel(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "agentButtonLabel",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#agentPicker:member",
@@ -11185,6 +11110,36 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#sendButtonVisible:member",
+              "docComment": "/**\n * Whether Send is rendered at all. Hidden exactly when Stop has taken its place — so a host that suppressed Stop via `hideStopButton` keeps Send throughout, disabled for the duration, and the slot is never left empty mid-turn.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get sendButtonVisible(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "sendButtonVisible",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#sessionCostUsd:member",
@@ -13024,6 +12979,36 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#stopButtonVisible:member",
+              "docComment": "/**\n * Whether the Stop control is showing.\n *\n * While a turn runs Stop REPLACES Send rather than sitting beside it: the two are mutually exclusive actions, and a disabled Send next to a live Stop just gives the eye a dead control to skip past. Reads `busy`, so `cancelling` keeps it up (in its \"Stopping…\" state) until the turn actually winds down.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get stopButtonVisible(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "stopButtonVisible",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitMessage:member(1)",

package/dist/ai-assistant.d.ts

@@ -38,7 +38,7 @@ export declare interface ActivityBus {
     publish<K extends keyof AgenticActivityEvents>(type: K, detail: AgenticActivityEvents[K]): void;
 }
 
-/** Sentinel value used by the segmented control / select to represent "Auto". */
+/** Sentinel value representing "Auto" where a menu row needs a string value. */
 export declare const AGENT_PICKER_AUTO_VALUE = "__auto__";
 
 /**
@@ -348,11 +348,17 @@ export declare interface AgentPersistenceContext {
 }
 
 /**
- * User-facing agent picker rendered above the chat input.
+ * The agent menu shown from the composer's agent button.
  *
- * Renders `Auto` plus each top-level agent that has `manualSelection.enabled`.
- * Sub-agents and non-selectable specialists are excluded. Hidden when fewer
- * than two agents are configured or none are manually selectable.
+ * Renders `Auto` plus each top-level agent with `manualSelection.enabled`, one
+ * row apiece, tinted with the same pin colour the composer button shows once
+ * that agent is pinned. Sub-agents and non-selectable specialists are excluded.
+ * Hidden when fewer than two agents are configured or none are manually
+ * selectable.
+ *
+ * The rows are all this element owns. The panel around them — surface, border,
+ * position, open/close animation — belongs to the assistant, which renders this
+ * menu and the session (⋮) menu into the same container so the two match.
  *
  * @fires agent-pinned - Fired when the user changes selection with the
  *   agent name or `null` for Auto. detail: `string | null`
@@ -360,54 +366,40 @@ export declare interface AgentPersistenceContext {
  * @beta
  */
 export declare class AgentPicker extends GenesisElement {
-    /** Design-system tag prefix, e.g. `'rapid'` for `rapid-segmented-control`. */
-    designSystemPrefix: string;
-    /** Picker variant, sourced from the assistant's `chatConfig.agentPicker`. */
+    /**
+     * Picker variant, sourced from the assistant's `chatConfig.picker.mode`.
+     * `'disabled'` hides the picker; every other value renders the same menu —
+     * `'select'` and `'segmented-control'` are retained so existing configuration
+     * stays valid, but no longer select between two layouts.
+     */
     mode: AgentPickerMode;
     /** Top-level agents passed to the assistant. */
     agents: AgentConfig[];
     /** Currently pinned agent name, or `null` for Auto. */
     pinnedAgentName: string | null;
-    /** @internal — set via the template `${ref(...)}` binding. */
-    segmentedRowEl?: HTMLElement;
-    /**
-     * @internal — true when the segmented row's content overflows its container.
-     * Drives the fallback to `select` rendering. Only meaningful when
-     * `mode === 'segmented-control'`.
-     */
-    overflowing: boolean;
-    private resizeObserver?;
+    /** When true, rows show a neutral dot instead of the per-agent brand tint. */
+    disablePinColours: boolean;
     /** Top-level agents that opted in to manual selection. */
     get selectableAgents(): AgentConfig[];
     /** Whether the picker should render at all. */
     get visible(): boolean;
     /**
-     * The variant actually rendered: `'select'` if user-configured or if the
-     * segmented row currently overflows; `'segmented-control'` otherwise.
-     */
-    get effectiveMode(): 'select' | 'segmented-control';
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    /**
-     * Re-measure when agents change — newly added selectable agents may push the
-     * segmented row past the container's width.
-     */
-    agentsChanged(): void;
-    modeChanged(): void;
-    /**
-     * Measures whether the segmented row's natural content width exceeds the
-     * container's visible width. Bails when the row isn't currently rendered
-     * (e.g. when `mode !== 'segmented-control'`).
+     * Inline `--menu-item-mark` for one row, or `''` to leave the dot neutral.
+     *
+     * Indexed against the FULL agents array rather than `selectableAgents` so a
+     * row's tint matches what the composer button shows when that agent is
+     * pinned — the assistant resolves its pin colour the same way, and the two
+     * disagreeing is exactly the bug this shares `pinColourAt` to avoid.
      */
-    private measureOverflow;
+    markStyleFor(agent: AgentConfig): string;
     selectAgent(name: string | null): void;
     /**
-     * Maps a value from the segmented-control or select (which uses
-     * {@link AGENT_PICKER_AUTO_VALUE} for Auto) back to the `string | null` form
-     * expected by `selectAgent`.
+     * Maps a value using {@link AGENT_PICKER_AUTO_VALUE} for Auto back to the
+     * `string | null` form {@link AgentPicker.selectAgent} expects. Retained for
+     * hosts driving the picker from a value rather than a name.
      */
     selectByValue(value: string): void;
-    /** Current pinned agent name as a value the segmented-control / select can bind to. */
+    /** Current pinned agent name as a bindable value. */
     get currentValue(): string;
 }
 
@@ -3742,6 +3734,51 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * shared across pop-in/pop-out and survives driver rebuilds.
      */
     private logMeta;
+    /**
+     * Document-level dismissal for whichever composer menu is open. Bound only
+     * while one IS open — a permanently-attached listener on a component that can
+     * be mounted twice (bubble + popout panel) is a cost every click on the page
+     * pays for a menu that is usually closed.
+     *
+     * Uses `composedPath()` rather than `event.target`: the click lands on a node
+     * inside this element's shadow root, which retargets to the host, so a plain
+     * `contains()` check cannot tell "clicked the menu" from "clicked the
+     * transcript". The path crosses the boundary and carries both.
+     */
+    private _dismissPointerHandler?;
+    private _dismissKeyHandler?;
+    private _dismissResizeHandler?;
+    private closeOpenComposerMenus;
+    /**
+     * Places an open composer menu directly above the control that opened it.
+     *
+     * CSS alone cannot: the menu is a child of `.composer` — which is what lets its
+     * width be capped against the composer rather than against a button — while its
+     * anchor is a button several levels down the bar, and no selector can read a
+     * sibling's offset. So the left edge is measured on open and written as a
+     * custom property.
+     *
+     * Clamped to the composer, so a menu opened from a control near the right edge
+     * of a narrow panel slides back inside instead of overhanging. The animation
+     * origin is written separately and keeps pointing at the button's centre even
+     * after such a shift — the menu still grows out of the thing that opened it,
+     * which is the whole point of anchoring it there.
+     */
+    private positionComposerMenu;
+    /** Re-place whichever menu is open. Cheap enough to run from a resize. */
+    private repositionOpenComposerMenu;
+    private syncComposerMenuDismissal;
+    private teardownComposerMenuDismissal;
+    /**
+     * Vertical space an open menu must leave free above the button, covering BOTH
+     * the gap the menu sits off the button by (8px, declared in design units in
+     * main.styles.ts) and the breathing room wanted above it. The two are lumped
+     * together because only the second half is a free choice: the first is fixed by
+     * the stylesheet and simply has to be subtracted from the headroom, and a
+     * constant named for only one of them invites someone to "fix" a gap that is
+     * doing exactly what it should.
+     */
+    private static readonly MENU_HEADROOM_RESERVE;
     private readonly _agentPickerToggle;
     toggleAgentPicker(): void;
     /** Two-step confirm for the destructive Clear action; reset whenever the menu toggles. */
@@ -3974,6 +4011,13 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * via `chatConfig.picker.disablePinColours`.
      */
     get pinnedAgentColour(): string | undefined;
+    /**
+     * Label beside the composer's agent glyph: `AUTO` while the orchestrator is
+     * routing, otherwise the pinned agent's name. The name is NOT shortened here —
+     * the button truncates with an ellipsis in CSS, so the full name stays
+     * available to a screen reader and to the `title` tooltip.
+     */
+    get agentButtonLabel(): string;
     /**
      * Placeholder shown in the chat input. Substitutes the pinned agent's name
      * when one is selected so the user has a clearer signal of where their
@@ -4177,6 +4221,22 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * @internal
      */
     getInteractionContext(interactionId: string): InteractionContext | undefined;
+    /**
+     * Whether the Stop control is showing.
+     *
+     * While a turn runs Stop REPLACES Send rather than sitting beside it: the two
+     * are mutually exclusive actions, and a disabled Send next to a live Stop just
+     * gives the eye a dead control to skip past. Reads `busy`, so `cancelling`
+     * keeps it up (in its "Stopping…" state) until the turn actually winds down.
+     */
+    get stopButtonVisible(): boolean;
+    /**
+     * Whether Send is rendered at all. Hidden exactly when Stop has taken its
+     * place — so a host that suppressed Stop via `hideStopButton` keeps Send
+     * throughout, disabled for the duration, and the slot is never left empty
+     * mid-turn.
+     */
+    get sendButtonVisible(): boolean;
     /** Whether the message input shows a drag handle to resize its height.
      * On by default; hosts opt out via `chatConfig.ui.resizableInput: false`. */
     get isComposerResizable(): boolean;