@genesislcap/ai-assistant 15.64.0 → 15.64.1-alpha-ddbd4ead05.0

package/dist/custom-elements.json

@@ -14282,209 +14282,129 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/agent-picker/agent-picker.constants.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AGENT_PICKER_AUTO_VALUE",
-          "type": {
-            "text": "string"
-          },
-          "default": "'__auto__'",
-          "description": "Sentinel value representing \"Auto\" where a menu row needs a string value."
-        },
-        {
-          "kind": "variable",
-          "name": "DEFAULT_ORCHESTRATION_LABEL",
-          "type": {
-            "text": "string"
-          },
-          "default": "'Orchestration'",
-          "description": "The picker's default name for orchestration: the assistant routes each message to the agent it\nsuits, as opposed to a pinned agent. Not \"Auto\", which other tools use for picking a model tier;\n\"Orchestration\" says that several agents stand behind it."
-        },
-        {
-          "kind": "variable",
-          "name": "DEFAULT_ORCHESTRATION_MENU_LABEL",
-          "type": {
-            "text": "string"
-          },
-          "default": "'Orchestration'",
-          "description": "The same choice as the picker menu's first row. The same word by default; separate so a host can say more there."
-        },
-        {
-          "kind": "variable",
-          "name": "DEFAULT_ORCHESTRATION_DESCRIPTION",
-          "type": {
-            "text": "string"
-          },
-          "default": "'Each message goes to the specialist it suits.'",
-          "description": "What orchestration does, as the menu row's hint and the pill's tooltip."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AGENT_PICKER_AUTO_VALUE",
-          "declaration": {
-            "name": "AGENT_PICKER_AUTO_VALUE",
-            "module": "src/components/agent-picker/agent-picker.constants.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "DEFAULT_ORCHESTRATION_LABEL",
-          "declaration": {
-            "name": "DEFAULT_ORCHESTRATION_LABEL",
-            "module": "src/components/agent-picker/agent-picker.constants.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "DEFAULT_ORCHESTRATION_MENU_LABEL",
-          "declaration": {
-            "name": "DEFAULT_ORCHESTRATION_MENU_LABEL",
-            "module": "src/components/agent-picker/agent-picker.constants.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "DEFAULT_ORCHESTRATION_DESCRIPTION",
-          "declaration": {
-            "name": "DEFAULT_ORCHESTRATION_DESCRIPTION",
-            "module": "src/components/agent-picker/agent-picker.constants.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/agent-picker/agent-picker.styles.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "styles",
-          "default": "css`\n  :host {\n    display: block;\n  }\n\n  :host([hidden]) {\n    display: none;\n  }\n\n  /* The picker owns the ROWS only. The panel around them — surface, border,\n     shadow, position, open/close animation — is the assistant's, so the agent\n     menu and the session menu are the same object with different contents.\n     See the composer-menu rules in main.styles.ts. */\n  .menu {\n    display: flex;\n    flex-direction: column;\n    gap: 1px;\n  }\n\n  ${menuItemStyles}\n`"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "styles",
-          "declaration": {
-            "name": "styles",
-            "module": "src/components/agent-picker/agent-picker.styles.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/agent-picker/agent-picker.template.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/agent-picker/agent-picker.ts",
+      "path": "src/components/agent-session/agent-session.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "The agent menu shown from the composer's agent button.\n\nRenders `Auto` plus each top-level agent with `manualSelection.enabled`, one\nrow apiece, tinted with the same pin colour the composer button shows once\nthat agent is pinned. Sub-agents and non-selectable specialists are excluded.\nHidden when fewer than two agents are configured or none are manually\nselectable.\n\nThe rows are all this element owns. The panel around them — surface, border,\nposition, open/close animation — belongs to the assistant, which renders this\nmenu and the session (⋮) menu into the same container so the two match.",
-          "name": "AgentPicker",
+          "description": "The stateful-agent contract: which agent is active, whether a flow or a user pin holds routing,\nand the `onActivate` / `onDeactivate` lifecycle around a swap. Either driver can own one.\n\nKnows nothing about routing, tool surfaces or transcripts — whether an agent is terminal, the\ncontinuation tool, the handoff marker in history all stay with the orchestrator, which is the\nonly thing with agents to route between.",
+          "name": "AgentSession",
           "members": [
             {
               "kind": "field",
-              "name": "mode",
-              "type": {
-                "text": "AgentPickerMode"
-              },
-              "default": "'disabled'",
-              "description": "Picker variant, sourced from the assistant's `chatConfig.picker.mode`.\n`'disabled'` hides the picker; every other value renders the same menu —\n`'select'` and `'segmented-control'` are retained so existing configuration\nstays valid, but no longer select between two layouts."
+              "name": "lifecycleAbortController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new AbortController()",
+              "description": "Aborted on disposal. Threaded into `AgentLifecycleContext.signal` so long-running\n`onActivate` work can bail if the session disconnects."
             },
             {
               "kind": "field",
-              "name": "agents",
+              "name": "active",
               "type": {
-                "text": "AgentConfig[]"
+                "text": "AgentConfig | undefined"
               },
-              "default": "[]",
-              "description": "Top-level agents passed to the assistant."
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "pinnedAgentName",
+              "name": "pinned",
               "type": {
                 "text": "string | null"
               },
+              "privacy": "private",
               "default": "null",
-              "description": "Currently pinned agent name, or `null` for Auto."
+              "description": "Sticky user pick from the picker (or the host's `setAgent` API). Only changes on explicit\nuser action. Survives flow completion: when a stateful agent releases, the user-pin stays put\nand routing falls back to it on the next turn."
             },
             {
               "kind": "field",
-              "name": "disablePinColours",
+              "name": "flowOwner",
               "type": {
-                "text": "boolean"
+                "text": "string | null"
               },
-              "default": "false",
-              "description": "When true, rows show a neutral dot instead of the per-agent brand tint."
+              "privacy": "private",
+              "default": "null",
+              "description": "Transient flow lock — set when a stateful agent activates, cleared on release. While\nnon-null, routing precedence goes to this agent and the picker is locked. Independent of\nthe user pin so completing a flow doesn't wipe the user's sticky choice."
             },
             {
               "kind": "field",
-              "name": "orchestrationLabel",
+              "name": "restoredStates",
               "type": {
-                "text": "string"
+                "text": "Record<string, unknown>"
               },
-              "default": "DEFAULT_ORCHESTRATION_MENU_LABEL",
-              "description": "The orchestration row's name, from `chatConfig.picker.orchestrationMenuLabel` (resolved by the host)."
+              "privacy": "private",
+              "default": "{}",
+              "description": "Per-agent restored state for a rehydrated session, keyed by agent name. Primed by the host on\nrestore; each entry is passed to that agent's `onActivate` as `ctx.restored` on its next\nactivation, then deleted so a later re-activation starts fresh."
             },
             {
               "kind": "field",
-              "name": "orchestrationDescription",
+              "name": "activation",
               "type": {
-                "text": "string"
+                "text": "Promise<unknown>"
               },
-              "default": "DEFAULT_ORCHESTRATION_DESCRIPTION",
-              "description": "The orchestration row's hint, from `chatConfig.picker.orchestrationDescription` (resolved by the host)."
+              "privacy": "private",
+              "description": "The tail of the activation queue — see AgentSession.activate."
             },
             {
-              "kind": "field",
-              "name": "selectableAgents",
-              "type": {
-                "text": "AgentConfig[]"
+              "kind": "method",
+              "name": "getActive",
+              "return": {
+                "type": {
+                  "text": "AgentConfig | undefined"
+                }
               },
-              "description": "Top-level agents that opted in to manual selection.",
-              "readonly": true
+              "description": "The active agent, or `undefined` before the first activation and after a release."
             },
             {
-              "kind": "field",
-              "name": "visible",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "getPinned",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
               },
-              "description": "Whether the picker should render at all.",
-              "readonly": true
+              "description": "The sticky user pin, or `null` for automatic routing."
             },
             {
               "kind": "method",
-              "name": "markStyleFor",
+              "name": "getFlowOwner",
               "return": {
                 "type": {
-                  "text": "string"
+                  "text": "string | null"
+                }
+              },
+              "description": "The transient flow lock, or `null` when no flow holds routing."
+            },
+            {
+              "kind": "method",
+              "name": "getLockedName",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              },
+              "description": "The name routing is locked to, flow lock first. A flow in progress outranks the user's\nsticky pick for the duration of the flow; neither being set means automatic routing."
+            },
+            {
+              "kind": "method",
+              "name": "setPinned",
+              "return": {
+                "type": {
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "agent",
+                  "name": "name",
                   "type": {
-                    "text": "AgentConfig"
+                    "text": "string | null"
                   }
                 }
               ],
-              "description": "Inline `--menu-item-mark` for one row, or `''` to leave the dot neutral.\n\nIndexed against the FULL agents array rather than `selectableAgents` so a\nrow's tint matches what the composer button shows when that agent is\npinned — the assistant resolves its pin colour the same way, and the two\ndisagreeing is exactly the bug this shares `pinColourAt` to avoid."
+              "description": "Set the sticky user pin. `null` returns to automatic routing."
             },
             {
               "kind": "method",
-              "name": "selectAgent",
+              "name": "setFlowOwner",
               "return": {
                 "type": {
                   "text": "void"
@@ -14497,11 +14417,12 @@
                     "text": "string | null"
                   }
                 }
-              ]
+              ],
+              "description": "Set the flow-owner lock directly — used to restore state on driver reconstruction\n(agents-array changes, pop-in/pop-out), not to steer routing. Writes without firing hooks or\nreporting a transition, because the flow it names is already running."
             },
             {
               "kind": "method",
-              "name": "selectByValue",
+              "name": "primeRestoredStates",
               "return": {
                 "type": {
                   "text": "void"
@@ -14509,36 +14430,200 @@
               },
               "parameters": [
                 {
-                  "name": "value",
+                  "name": "snapshots",
+                  "type": {
+                    "text": "Record<string, unknown>"
+                  }
+                }
+              ],
+              "description": "Prime per-agent restored state for a rehydrated session. Replaces any pending entries."
+            },
+            {
+              "kind": "method",
+              "name": "hasRestoredState",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "agentName",
                   "type": {
                     "text": "string"
                   }
                 }
               ],
-              "description": "Maps a value using AGENT_PICKER_AUTO_VALUE for Auto back to the\n`string | null` form AgentPicker.selectAgent expects. Retained for\nhosts driving the picker from a value rather than a name."
+              "description": "Whether a restored snapshot is waiting for this agent's next activation."
             },
             {
-              "kind": "field",
-              "name": "currentValue",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "activate",
+              "return": {
+                "type": {
+                  "text": "Promise<AgentTransition>"
+                }
               },
-              "description": "Current pinned agent name as a bindable value.",
-              "readonly": true
-            }
-          ],
-          "events": [
+              "parameters": [
+                {
+                  "name": "agent",
+                  "type": {
+                    "text": "AgentConfig"
+                  }
+                }
+              ],
+              "description": "Make `agent` active, firing the lifecycle hooks around the swap: outgoing `onDeactivate`\nfirst, then incoming `onActivate`. Both are awaited so heavy activation work (a machine\nrestore, say) completes before the agent's first turn runs, and a throw from either is logged\nrather than propagated — an agent whose hook fails still activates.\n\nRe-activating the same agent by name is not a switch: no hooks fire, no lock moves, and no\nhandoff is recorded. That guard matters because a per-turn re-resolve calls through here.\n\nSingle-flight (GENC-1662): calls run one after another, never interleaved. `active` is only\nset once the hooks have finished, so two overlapping calls for the same agent would otherwise\nboth see a switch and run `onActivate` twice — and a restored `init` would be overwritten by a\nfresh one that finished later. That overlap became possible when a restore started activating\nthe flow owner outside a turn, where a send can land mid-activation."
+            },
             {
-              "description": "Fired when the user changes selection with the agent name or `null` for Auto. detail: `string | null`",
-              "name": "agent-pinned"
+              "kind": "method",
+              "name": "activateNow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<AgentTransition>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "agent",
+                  "type": {
+                    "text": "AgentConfig"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "release",
+              "return": {
+                "type": {
+                  "text": "Promise<AgentTransition | undefined>"
+                }
+              },
+              "description": "Release the active agent: fire `onDeactivate` and drop the flow lock.\n\nThe user pin is intentionally **not** cleared — someone who explicitly picked this agent\nshould stay on it after the flow ends, so the next message starts a fresh flow on the same\nagent rather than routing through the classifier.\n\nReturns `undefined` when there was no active agent, so a caller can skip its events."
+            },
+            {
+              "kind": "method",
+              "name": "reportTransition",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "transition",
+                  "type": {
+                    "text": "AgentTransition"
+                  }
+                }
+              ],
+              "description": "Hand a transition to the owner. A throwing listener is logged rather than propagated, for the\nsame reason a throwing hook is: the transition has already happened, and failing the caller\nwould leave it believing it had not."
+            },
+            {
+              "kind": "method",
+              "name": "dispose",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "description": "Fire `onDeactivate` on the active agent and abort pending lifecycle work, for session\nteardown, so machines release resources cleanly. The session is not reusable afterwards: the\nabort signal stays aborted, so a later `activate` would hand its hook a dead signal.\n\n`onDeactivate` runs **before** the abort, deliberately: teardown that needs to flush state\nwould otherwise be handed an already-aborted signal and have to skip its own work. The cost is\nthat an `onActivate` still in flight keeps running until `onDeactivate` finishes — both hold\nthe same signal. Acceptable because the two are sequenced by `activate`, so overlap only\nhappens if a hook resolves before the work it started; a hook that must stop immediately\nshould own its own cancellation."
+            },
+            {
+              "kind": "method",
+              "name": "fireDeactivate",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "agent",
+                  "type": {
+                    "text": "AgentConfig"
+                  }
+                },
+                {
+                  "name": "reason",
+                  "type": {
+                    "text": "'switch' | 'release' | 'dispose'"
+                  }
+                }
+              ],
+              "description": "The one place `onDeactivate` is invoked. `reason` only reaches the warning text, which is what\ntells a log reader which path fired."
             }
-          ],
-          "superclass": {
-            "name": "GenesisElement",
-            "package": "@genesislcap/web-core"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AgentSession",
+          "declaration": {
+            "name": "AgentSession",
+            "module": "src/components/agent-session/agent-session.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/agent-session/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./agent-session"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/agent-picker/agent-picker.constants.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AGENT_PICKER_AUTO_VALUE",
+          "type": {
+            "text": "string"
           },
-          "tagName": "foundation-ai-agent-picker",
-          "customElement": true
+          "default": "'__auto__'",
+          "description": "Sentinel value representing \"Auto\" where a menu row needs a string value."
+        },
+        {
+          "kind": "variable",
+          "name": "DEFAULT_ORCHESTRATION_LABEL",
+          "type": {
+            "text": "string"
+          },
+          "default": "'Orchestration'",
+          "description": "The picker's default name for orchestration: the assistant routes each message to the agent it\nsuits, as opposed to a pinned agent. Not \"Auto\", which other tools use for picking a model tier;\n\"Orchestration\" says that several agents stand behind it."
+        },
+        {
+          "kind": "variable",
+          "name": "DEFAULT_ORCHESTRATION_MENU_LABEL",
+          "type": {
+            "text": "string"
+          },
+          "default": "'Orchestration'",
+          "description": "The same choice as the picker menu's first row. The same word by default; separate so a host can say more there."
+        },
+        {
+          "kind": "variable",
+          "name": "DEFAULT_ORCHESTRATION_DESCRIPTION",
+          "type": {
+            "text": "string"
+          },
+          "default": "'Each message goes to the specialist it suits.'",
+          "description": "What orchestration does, as the menu row's hint and the pill's tooltip."
         }
       ],
       "exports": [
@@ -14547,167 +14632,164 @@
           "name": "AGENT_PICKER_AUTO_VALUE",
           "declaration": {
             "name": "AGENT_PICKER_AUTO_VALUE",
-            "module": "src/components/agent-picker/agent-picker.ts"
+            "module": "src/components/agent-picker/agent-picker.constants.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AgentPicker",
+          "name": "DEFAULT_ORCHESTRATION_LABEL",
           "declaration": {
-            "name": "AgentPicker",
-            "module": "src/components/agent-picker/agent-picker.ts"
+            "name": "DEFAULT_ORCHESTRATION_LABEL",
+            "module": "src/components/agent-picker/agent-picker.constants.ts"
           }
         },
         {
-          "kind": "custom-element-definition",
-          "name": "foundation-ai-agent-picker",
+          "kind": "js",
+          "name": "DEFAULT_ORCHESTRATION_MENU_LABEL",
           "declaration": {
-            "name": "AgentPicker",
-            "module": "src/components/agent-picker/agent-picker.ts"
+            "name": "DEFAULT_ORCHESTRATION_MENU_LABEL",
+            "module": "src/components/agent-picker/agent-picker.constants.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DEFAULT_ORCHESTRATION_DESCRIPTION",
+          "declaration": {
+            "name": "DEFAULT_ORCHESTRATION_DESCRIPTION",
+            "module": "src/components/agent-picker/agent-picker.constants.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/agent-picker/index.ts",
-      "declarations": [],
+      "path": "src/components/agent-picker/agent-picker.styles.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "styles",
+          "default": "css`\n  :host {\n    display: block;\n  }\n\n  :host([hidden]) {\n    display: none;\n  }\n\n  /* The picker owns the ROWS only. The panel around them — surface, border,\n     shadow, position, open/close animation — is the assistant's, so the agent\n     menu and the session menu are the same object with different contents.\n     See the composer-menu rules in main.styles.ts. */\n  .menu {\n    display: flex;\n    flex-direction: column;\n    gap: 1px;\n  }\n\n  ${menuItemStyles}\n`"
+        }
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
+          "name": "styles",
           "declaration": {
-            "name": "*",
-            "package": "./agent-picker"
+            "name": "styles",
+            "module": "src/components/agent-picker/agent-picker.styles.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/agent-session/agent-session.ts",
+      "path": "src/components/agent-picker/agent-picker.template.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/agent-picker/agent-picker.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "The stateful-agent contract: which agent is active, whether a flow or a user pin holds routing,\nand the `onActivate` / `onDeactivate` lifecycle around a swap. Either driver can own one.\n\nKnows nothing about routing, tool surfaces or transcripts — whether an agent is terminal, the\ncontinuation tool, the handoff marker in history all stay with the orchestrator, which is the\nonly thing with agents to route between.",
-          "name": "AgentSession",
+          "description": "The agent menu shown from the composer's agent button.\n\nRenders `Auto` plus each top-level agent with `manualSelection.enabled`, one\nrow apiece, tinted with the same pin colour the composer button shows once\nthat agent is pinned. Sub-agents and non-selectable specialists are excluded.\nHidden when fewer than two agents are configured or none are manually\nselectable.\n\nThe rows are all this element owns. The panel around them — surface, border,\nposition, open/close animation — belongs to the assistant, which renders this\nmenu and the session (⋮) menu into the same container so the two match.",
+          "name": "AgentPicker",
           "members": [
             {
               "kind": "field",
-              "name": "lifecycleAbortController",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new AbortController()",
-              "description": "Aborted on disposal. Threaded into `AgentLifecycleContext.signal` so long-running\n`onActivate` work can bail if the session disconnects."
-            },
-            {
-              "kind": "field",
-              "name": "active",
+              "name": "mode",
               "type": {
-                "text": "AgentConfig | undefined"
+                "text": "AgentPickerMode"
               },
-              "privacy": "private"
+              "default": "'disabled'",
+              "description": "Picker variant, sourced from the assistant's `chatConfig.picker.mode`.\n`'disabled'` hides the picker; every other value renders the same menu —\n`'select'` and `'segmented-control'` are retained so existing configuration\nstays valid, but no longer select between two layouts."
             },
             {
               "kind": "field",
-              "name": "pinned",
+              "name": "agents",
               "type": {
-                "text": "string | null"
+                "text": "AgentConfig[]"
               },
-              "privacy": "private",
-              "default": "null",
-              "description": "Sticky user pick from the picker (or the host's `setAgent` API). Only changes on explicit\nuser action. Survives flow completion: when a stateful agent releases, the user-pin stays put\nand routing falls back to it on the next turn."
+              "default": "[]",
+              "description": "Top-level agents passed to the assistant."
             },
             {
               "kind": "field",
-              "name": "flowOwner",
+              "name": "pinnedAgentName",
               "type": {
                 "text": "string | null"
               },
-              "privacy": "private",
               "default": "null",
-              "description": "Transient flow lock — set when a stateful agent activates, cleared on release. While\nnon-null, routing precedence goes to this agent and the picker is locked. Independent of\nthe user pin so completing a flow doesn't wipe the user's sticky choice."
+              "description": "Currently pinned agent name, or `null` for Auto."
             },
             {
               "kind": "field",
-              "name": "restoredStates",
+              "name": "disablePinColours",
               "type": {
-                "text": "Record<string, unknown>"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "{}",
-              "description": "Per-agent restored state for a rehydrated session, keyed by agent name. Primed by the host on\nrestore; each entry is passed to that agent's `onActivate` as `ctx.restored` on its next\nactivation, then deleted so a later re-activation starts fresh."
+              "default": "false",
+              "description": "When true, rows show a neutral dot instead of the per-agent brand tint."
             },
             {
               "kind": "field",
-              "name": "activation",
+              "name": "orchestrationLabel",
               "type": {
-                "text": "Promise<unknown>"
-              },
-              "privacy": "private",
-              "description": "The tail of the activation queue — see AgentSession.activate."
-            },
-            {
-              "kind": "method",
-              "name": "getActive",
-              "return": {
-                "type": {
-                  "text": "AgentConfig | undefined"
-                }
+                "text": "string"
               },
-              "description": "The active agent, or `undefined` before the first activation and after a release."
+              "default": "DEFAULT_ORCHESTRATION_MENU_LABEL",
+              "description": "The orchestration row's name, from `chatConfig.picker.orchestrationMenuLabel` (resolved by the host)."
             },
             {
-              "kind": "method",
-              "name": "getPinned",
-              "return": {
-                "type": {
-                  "text": "string | null"
-                }
+              "kind": "field",
+              "name": "orchestrationDescription",
+              "type": {
+                "text": "string"
               },
-              "description": "The sticky user pin, or `null` for automatic routing."
+              "default": "DEFAULT_ORCHESTRATION_DESCRIPTION",
+              "description": "The orchestration row's hint, from `chatConfig.picker.orchestrationDescription` (resolved by the host)."
             },
             {
-              "kind": "method",
-              "name": "getFlowOwner",
-              "return": {
-                "type": {
-                  "text": "string | null"
-                }
+              "kind": "field",
+              "name": "selectableAgents",
+              "type": {
+                "text": "AgentConfig[]"
               },
-              "description": "The transient flow lock, or `null` when no flow holds routing."
+              "description": "Top-level agents that opted in to manual selection.",
+              "readonly": true
             },
             {
-              "kind": "method",
-              "name": "getLockedName",
-              "return": {
-                "type": {
-                  "text": "string | null"
-                }
+              "kind": "field",
+              "name": "visible",
+              "type": {
+                "text": "boolean"
               },
-              "description": "The name routing is locked to, flow lock first. A flow in progress outranks the user's\nsticky pick for the duration of the flow; neither being set means automatic routing."
+              "description": "Whether the picker should render at all.",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "setPinned",
+              "name": "markStyleFor",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "string"
                 }
               },
               "parameters": [
                 {
-                  "name": "name",
+                  "name": "agent",
                   "type": {
-                    "text": "string | null"
+                    "text": "AgentConfig"
                   }
                 }
               ],
-              "description": "Set the sticky user pin. `null` returns to automatic routing."
+              "description": "Inline `--menu-item-mark` for one row, or `''` to leave the dot neutral.\n\nIndexed against the FULL agents array rather than `selectableAgents` so a\nrow's tint matches what the composer button shows when that agent is\npinned — the assistant resolves its pin colour the same way, and the two\ndisagreeing is exactly the bug this shares `pinColourAt` to avoid."
             },
             {
               "kind": "method",
-              "name": "setFlowOwner",
+              "name": "selectAgent",
               "return": {
                 "type": {
                   "text": "void"
@@ -14720,95 +14802,11 @@
                     "text": "string | null"
                   }
                 }
-              ],
-              "description": "Set the flow-owner lock directly — used to restore state on driver reconstruction\n(agents-array changes, pop-in/pop-out), not to steer routing. Writes without firing hooks or\nreporting a transition, because the flow it names is already running."
-            },
-            {
-              "kind": "method",
-              "name": "primeRestoredStates",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "snapshots",
-                  "type": {
-                    "text": "Record<string, unknown>"
-                  }
-                }
-              ],
-              "description": "Prime per-agent restored state for a rehydrated session. Replaces any pending entries."
-            },
-            {
-              "kind": "method",
-              "name": "hasRestoredState",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "agentName",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Whether a restored snapshot is waiting for this agent's next activation."
-            },
-            {
-              "kind": "method",
-              "name": "activate",
-              "return": {
-                "type": {
-                  "text": "Promise<AgentTransition>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "agent",
-                  "type": {
-                    "text": "AgentConfig"
-                  }
-                }
-              ],
-              "description": "Make `agent` active, firing the lifecycle hooks around the swap: outgoing `onDeactivate`\nfirst, then incoming `onActivate`. Both are awaited so heavy activation work (a machine\nrestore, say) completes before the agent's first turn runs, and a throw from either is logged\nrather than propagated — an agent whose hook fails still activates.\n\nRe-activating the same agent by name is not a switch: no hooks fire, no lock moves, and no\nhandoff is recorded. That guard matters because a per-turn re-resolve calls through here.\n\nSingle-flight (GENC-1662): calls run one after another, never interleaved. `active` is only\nset once the hooks have finished, so two overlapping calls for the same agent would otherwise\nboth see a switch and run `onActivate` twice — and a restored `init` would be overwritten by a\nfresh one that finished later. That overlap became possible when a restore started activating\nthe flow owner outside a turn, where a send can land mid-activation."
-            },
-            {
-              "kind": "method",
-              "name": "activateNow",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<AgentTransition>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "agent",
-                  "type": {
-                    "text": "AgentConfig"
-                  }
-                }
               ]
             },
             {
               "kind": "method",
-              "name": "release",
-              "return": {
-                "type": {
-                  "text": "Promise<AgentTransition | undefined>"
-                }
-              },
-              "description": "Release the active agent: fire `onDeactivate` and drop the flow lock.\n\nThe user pin is intentionally **not** cleared — someone who explicitly picked this agent\nshould stay on it after the flow ends, so the next message starts a fresh flow on the same\nagent rather than routing through the classifier.\n\nReturns `undefined` when there was no active agent, so a caller can skip its events."
-            },
-            {
-              "kind": "method",
-              "name": "reportTransition",
-              "privacy": "private",
+              "name": "selectByValue",
               "return": {
                 "type": {
                   "text": "void"
@@ -14816,66 +14814,68 @@
               },
               "parameters": [
                 {
-                  "name": "transition",
+                  "name": "value",
                   "type": {
-                    "text": "AgentTransition"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Hand a transition to the owner. A throwing listener is logged rather than propagated, for the\nsame reason a throwing hook is: the transition has already happened, and failing the caller\nwould leave it believing it had not."
+              "description": "Maps a value using AGENT_PICKER_AUTO_VALUE for Auto back to the\n`string | null` form AgentPicker.selectAgent expects. Retained for\nhosts driving the picker from a value rather than a name."
             },
             {
-              "kind": "method",
-              "name": "dispose",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
+              "kind": "field",
+              "name": "currentValue",
+              "type": {
+                "text": "string"
               },
-              "description": "Fire `onDeactivate` on the active agent and abort pending lifecycle work, for session\nteardown, so machines release resources cleanly. The session is not reusable afterwards: the\nabort signal stays aborted, so a later `activate` would hand its hook a dead signal.\n\n`onDeactivate` runs **before** the abort, deliberately: teardown that needs to flush state\nwould otherwise be handed an already-aborted signal and have to skip its own work. The cost is\nthat an `onActivate` still in flight keeps running until `onDeactivate` finishes — both hold\nthe same signal. Acceptable because the two are sequenced by `activate`, so overlap only\nhappens if a hook resolves before the work it started; a hook that must stop immediately\nshould own its own cancellation."
-            },
+              "description": "Current pinned agent name as a bindable value.",
+              "readonly": true
+            }
+          ],
+          "events": [
             {
-              "kind": "method",
-              "name": "fireDeactivate",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "agent",
-                  "type": {
-                    "text": "AgentConfig"
-                  }
-                },
-                {
-                  "name": "reason",
-                  "type": {
-                    "text": "'switch' | 'release' | 'dispose'"
-                  }
-                }
-              ],
-              "description": "The one place `onDeactivate` is invoked. `reason` only reaches the warning text, which is what\ntells a log reader which path fired."
+              "description": "Fired when the user changes selection with the agent name or `null` for Auto. detail: `string | null`",
+              "name": "agent-pinned"
             }
-          ]
+          ],
+          "superclass": {
+            "name": "GenesisElement",
+            "package": "@genesislcap/web-core"
+          },
+          "tagName": "foundation-ai-agent-picker",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AgentSession",
+          "name": "AGENT_PICKER_AUTO_VALUE",
           "declaration": {
-            "name": "AgentSession",
-            "module": "src/components/agent-session/agent-session.ts"
+            "name": "AGENT_PICKER_AUTO_VALUE",
+            "module": "src/components/agent-picker/agent-picker.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AgentPicker",
+          "declaration": {
+            "name": "AgentPicker",
+            "module": "src/components/agent-picker/agent-picker.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "foundation-ai-agent-picker",
+          "declaration": {
+            "name": "AgentPicker",
+            "module": "src/components/agent-picker/agent-picker.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/agent-session/index.ts",
+      "path": "src/components/agent-picker/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -14883,7 +14883,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./agent-session"
+            "package": "./agent-picker"
           }
         }
       ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.64.0",
+  "version": "15.64.1-alpha-ddbd4ead05.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -92,31 +92,31 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-comms": "15.64.0",
-    "@genesislcap/foundation-testing": "15.64.0",
-    "@genesislcap/genx": "15.64.0",
-    "@genesislcap/ts-builder": "15.64.0",
-    "@genesislcap/uvu-playwright-builder": "15.64.0",
-    "@genesislcap/vite-builder": "15.64.0",
-    "@genesislcap/webpack-builder": "15.64.0",
+    "@genesislcap/foundation-comms": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/foundation-testing": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/genx": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/ts-builder": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/uvu-playwright-builder": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/vite-builder": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/webpack-builder": "15.64.1-alpha-ddbd4ead05.0",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.64.0",
-    "@genesislcap/foundation-logger": "15.64.0",
-    "@genesislcap/foundation-notifications": "15.64.0",
-    "@genesislcap/foundation-redux": "15.64.0",
-    "@genesislcap/foundation-ui": "15.64.0",
-    "@genesislcap/foundation-utils": "15.64.0",
-    "@genesislcap/rapid-design-system": "15.64.0",
-    "@genesislcap/web-core": "15.64.0",
+    "@genesislcap/foundation-ai": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/foundation-logger": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/foundation-notifications": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/foundation-redux": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/foundation-ui": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/foundation-utils": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/rapid-design-system": "15.64.1-alpha-ddbd4ead05.0",
+    "@genesislcap/web-core": "15.64.1-alpha-ddbd4ead05.0",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
   "peerDependencies": {
-    "@genesislcap/foundation-comms": "^15.64.0"
+    "@genesislcap/foundation-comms": "^15.64.1-alpha-ddbd4ead05.0"
   },
   "peerDependenciesMeta": {
     "@genesislcap/foundation-comms": {