@genesislcap/ai-assistant 14.443.1 → 14.444.1

package/dist/ai-assistant.api.json

@@ -4805,6 +4805,36 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#flowOwnerAgentName:member",
+              "docComment": "/**\n * Name of the agent that currently owns a guided flow. Set by the orchestrator when a stateful agent's `onActivate` fires, cleared when the agent calls `releaseAgent` from a terminal-state tool handler. While non-null, routing precedence goes to this agent and the picker is locked.\n *\n * Independent of `pinnedAgentName`: a flow can complete and release without disturbing the user's sticky picker choice.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get flowOwnerAgentName(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n\nset flowOwnerAgentName(value: string | null);"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "flowOwnerAgentName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#getDebugLog:member(1)",
@@ -5587,7 +5617,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#pinLocked:member",
-              "docComment": "/**\n * The pin is locked when a stateful agent (one with lifecycle hooks) is *actively running* — i.e. its `onActivate` has fired and it owns live state. Until the user sends their first message, a freshly pinned stateful agent is not yet active and the picker should remain free; the user might change their mind and unpin without anything to clean up.\n *\n * We derive from `activeAgent` (set by the orchestrator after `onActivate` completes) rather than `pinnedAgentName` (set immediately on picker click). The serialized `activeAgent` strips lifecycle hooks, so we look up the live config from `this.agents` to check for them.\n */\n",
+              "docComment": "/**\n * The pin is locked when a stateful flow is mid-stream — i.e. some agent's `onActivate` has fired and it owns live state, and it hasn't yet called `releaseAgent`. Derives directly from `flowOwnerAgentName`, the single source of truth the orchestrator writes on activation and clears on release. Until the user sends their first message, a freshly pinned stateful agent is not yet active and the picker should remain free; the user might change their mind and unpin without anything to clean up.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5677,7 +5707,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#pinnedAgentName:member",
-              "docComment": "/**\n * Name of the agent the user has pinned via the agent picker. `null` means automatic routing (Auto). Persisted on the session store, so it survives pop-in/pop-out but resets on page refresh.\n */\n",
+              "docComment": "/**\n * Name of the agent the user has pinned via the agent picker. `null` means automatic routing (Auto). Persisted on the session store, so it survives pop-in/pop-out but resets on page refresh.\n *\n * Only changes on explicit user action (picker click or host's `setAgent`). The orchestrator's auto-pin on stateful activation writes `flowOwnerAgentName` instead, so finishing a guided flow doesn't wipe the user's sticky pick.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7756,6 +7786,54 @@
               "isAbstract": false,
               "name": "sendMessage"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#setFlowOwner:member(1)",
+              "docComment": "/**\n * Set the flow-owner lock — used to restore state from Redux on driver reconstruction (agents-array changes, pop-in/pop-out). Not intended for external callers to manipulate routing; that's what `setPinnedAgent` is for.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setFlowOwner(name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "name",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setFlowOwner"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#setPinnedAgent:member(1)",

package/dist/ai-assistant.d.ts

@@ -986,9 +986,25 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * Name of the agent the user has pinned via the agent picker. `null` means
      * automatic routing (Auto). Persisted on the session store, so it survives
      * pop-in/pop-out but resets on page refresh.
+     *
+     * Only changes on explicit user action (picker click or host's `setAgent`).
+     * The orchestrator's auto-pin on stateful activation writes
+     * `flowOwnerAgentName` instead, so finishing a guided flow doesn't wipe
+     * the user's sticky pick.
      */
     get pinnedAgentName(): string | null;
     set pinnedAgentName(value: string | null);
+    /**
+     * Name of the agent that currently owns a guided flow. Set by the
+     * orchestrator when a stateful agent's `onActivate` fires, cleared when the
+     * agent calls `releaseAgent` from a terminal-state tool handler. While
+     * non-null, routing precedence goes to this agent and the picker is locked.
+     *
+     * Independent of `pinnedAgentName`: a flow can complete and release
+     * without disturbing the user's sticky picker choice.
+     */
+    get flowOwnerAgentName(): string | null;
+    set flowOwnerAgentName(value: string | null);
     get liveSubAgentTrace(): ChatMessage[];
     set liveSubAgentTrace(value: ChatMessage[]);
     get liveSubAgentName(): string | null;
@@ -1160,16 +1176,13 @@ export declare class FoundationAiAssistant extends GenesisElement {
     /** Hint text for the currently pinned agent, if any. Used in the toggle button tooltip. */
     get pinnedAgentHint(): string | undefined;
     /**
-     * The pin is locked when a stateful agent (one with lifecycle hooks) is
-     * *actively running* — i.e. its `onActivate` has fired and it owns live
-     * state. Until the user sends their first message, a freshly pinned stateful
-     * agent is not yet active and the picker should remain free; the user might
-     * change their mind and unpin without anything to clean up.
-     *
-     * We derive from `activeAgent` (set by the orchestrator after `onActivate`
-     * completes) rather than `pinnedAgentName` (set immediately on picker
-     * click). The serialized `activeAgent` strips lifecycle hooks, so we look
-     * up the live config from `this.agents` to check for them.
+     * The pin is locked when a stateful flow is mid-stream — i.e. some agent's
+     * `onActivate` has fired and it owns live state, and it hasn't yet called
+     * `releaseAgent`. Derives directly from `flowOwnerAgentName`, the
+     * single source of truth the orchestrator writes on activation and clears
+     * on release. Until the user sends their first message, a freshly pinned
+     * stateful agent is not yet active and the picker should remain free; the
+     * user might change their mind and unpin without anything to clean up.
      */
     get pinLocked(): boolean;
     /** Tooltip shown on the picker toggle button. */
@@ -1408,7 +1421,21 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
      * so long-running `onActivate` work can bail if the session disconnects.
      */
     private readonly lifecycleAbortController;
+    /**
+     * Sticky user pick from the picker (or the host's `setAgent` API). Only
+     * changes on explicit user action. Survives flow completion: when a stateful
+     * agent releases, the user-pin stays put and routing falls back to it on
+     * the next turn.
+     */
     private pinnedAgentName;
+    /**
+     * Transient flow lock — set when a stateful agent's `onActivate` fires,
+     * cleared by `releaseActiveAgent`. While non-null, routing precedence goes
+     * to this agent and the picker is locked. Independent of
+     * `pinnedAgentName` so completing a flow doesn't wipe the user's sticky
+     * choice.
+     */
+    private flowOwnerAgentName;
     activeAgent?: AgentConfig;
     constructor(aiProvider: AIProvider, agents: AgentConfig[], options?: {
         sessionKey?: string;
@@ -1428,6 +1455,13 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
      * return to automatic routing.
      */
     setPinnedAgent(name: string | null): void;
+    /**
+     * Set the flow-owner lock — used to restore state from Redux on driver
+     * reconstruction (agents-array changes, pop-in/pop-out). Not intended for
+     * external callers to manipulate routing; that's what `setPinnedAgent` is
+     * for.
+     */
+    setFlowOwner(name: string | null): void;
     loadHistory(messages: ChatMessage[]): void;
     getRawHistory(): readonly ChatMessage[];
     /** Delegates to the inner {@link ChatDriver} — turns are captured there. */
@@ -1437,9 +1471,15 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
     continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
     private applyAgent;
     /**
-     * Release the current stateful agent: fire `onDeactivate`, clear the pin,
-     * dispatch events so the host (and Redux) reflect the unpinned state. Called
-     * automatically when a tool handler invokes `context.releaseAgent`.
+     * Release the current stateful agent: fire `onDeactivate`, clear the
+     * flow-owner lock, dispatch events so the host (and Redux) reflect the
+     * unlocked state. Called automatically when a tool handler invokes
+     * `context.releaseAgent`.
+     *
+     * The user-pin (`pinnedAgentName`) is intentionally *not* cleared — a user
+     * who explicitly picked this agent should stay on it after the flow ends,
+     * so the next message starts a fresh flow on the same agent rather than
+     * routing through the classifier.
      */
     private releaseActiveAgent;
     /**
@@ -1450,9 +1490,12 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
     dispose(): Promise<void>;
     private classify;
     /**
-     * Returns the pinned agent if `pinnedAgentName` matches a known specialist or
-     * fallback. Logs and returns `undefined` if pinned to a name that no longer
-     * exists in the agents array — caller falls back to the classifier.
+     * Returns the agent that the current turn is locked to, if any. Flow-owner
+     * (transient, set by stateful-agent activation) wins over user-pin (sticky,
+     * set by picker click). `undefined` falls back to the classifier.
+     *
+     * Logs and returns `undefined` if a name no longer matches the agents array
+     * — protects against stale state after an agents-array reassignment.
      */
     private resolvePinnedAgent;
     private appendInlineMessage;

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

@@ -24,7 +24,21 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
      * so long-running `onActivate` work can bail if the session disconnects.
      */
     private readonly lifecycleAbortController;
+    /**
+     * Sticky user pick from the picker (or the host's `setAgent` API). Only
+     * changes on explicit user action. Survives flow completion: when a stateful
+     * agent releases, the user-pin stays put and routing falls back to it on
+     * the next turn.
+     */
     private pinnedAgentName;
+    /**
+     * Transient flow lock — set when a stateful agent's `onActivate` fires,
+     * cleared by `releaseActiveAgent`. While non-null, routing precedence goes
+     * to this agent and the picker is locked. Independent of
+     * `pinnedAgentName` so completing a flow doesn't wipe the user's sticky
+     * choice.
+     */
+    private flowOwnerAgentName;
     activeAgent?: AgentConfig;
     constructor(aiProvider: AIProvider, agents: AgentConfig[], options?: {
         sessionKey?: string;
@@ -44,6 +58,13 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
      * return to automatic routing.
      */
     setPinnedAgent(name: string | null): void;
+    /**
+     * Set the flow-owner lock — used to restore state from Redux on driver
+     * reconstruction (agents-array changes, pop-in/pop-out). Not intended for
+     * external callers to manipulate routing; that's what `setPinnedAgent` is
+     * for.
+     */
+    setFlowOwner(name: string | null): void;
     loadHistory(messages: ChatMessage[]): void;
     getRawHistory(): readonly ChatMessage[];
     /** Delegates to the inner {@link ChatDriver} — turns are captured there. */
@@ -53,9 +74,15 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
     continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
     private applyAgent;
     /**
-     * Release the current stateful agent: fire `onDeactivate`, clear the pin,
-     * dispatch events so the host (and Redux) reflect the unpinned state. Called
-     * automatically when a tool handler invokes `context.releaseAgent`.
+     * Release the current stateful agent: fire `onDeactivate`, clear the
+     * flow-owner lock, dispatch events so the host (and Redux) reflect the
+     * unlocked state. Called automatically when a tool handler invokes
+     * `context.releaseAgent`.
+     *
+     * The user-pin (`pinnedAgentName`) is intentionally *not* cleared — a user
+     * who explicitly picked this agent should stay on it after the flow ends,
+     * so the next message starts a fresh flow on the same agent rather than
+     * routing through the classifier.
      */
     private releaseActiveAgent;
     /**
@@ -66,9 +93,12 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
     dispose(): Promise<void>;
     private classify;
     /**
-     * Returns the pinned agent if `pinnedAgentName` matches a known specialist or
-     * fallback. Logs and returns `undefined` if pinned to a name that no longer
-     * exists in the agents array — caller falls back to the classifier.
+     * Returns the agent that the current turn is locked to, if any. Flow-owner
+     * (transient, set by stateful-agent activation) wins over user-pin (sticky,
+     * set by picker click). `undefined` falls back to the classifier.
+     *
+     * Logs and returns `undefined` if a name no longer matches the agents array
+     * — protects against stale state after an agents-array reassignment.
      */
     private resolvePinnedAgent;
     private appendInlineMessage;

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;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"}
+{"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;IAgCpE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAhCzB,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;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAAuB;IAC9C;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAAuB;IAEjD,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;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIvC,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;IAuFxB;;;;;;;;;;OAUG;YACW,kBAAkB;IAuBhC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBhB,QAAQ;IA+FtB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,mBAAmB;CAO5B"}

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

@@ -100,9 +100,25 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * Name of the agent the user has pinned via the agent picker. `null` means
      * automatic routing (Auto). Persisted on the session store, so it survives
      * pop-in/pop-out but resets on page refresh.
+     *
+     * Only changes on explicit user action (picker click or host's `setAgent`).
+     * The orchestrator's auto-pin on stateful activation writes
+     * `flowOwnerAgentName` instead, so finishing a guided flow doesn't wipe
+     * the user's sticky pick.
      */
     get pinnedAgentName(): string | null;
     set pinnedAgentName(value: string | null);
+    /**
+     * Name of the agent that currently owns a guided flow. Set by the
+     * orchestrator when a stateful agent's `onActivate` fires, cleared when the
+     * agent calls `releaseAgent` from a terminal-state tool handler. While
+     * non-null, routing precedence goes to this agent and the picker is locked.
+     *
+     * Independent of `pinnedAgentName`: a flow can complete and release
+     * without disturbing the user's sticky picker choice.
+     */
+    get flowOwnerAgentName(): string | null;
+    set flowOwnerAgentName(value: string | null);
     get liveSubAgentTrace(): ChatMessage[];
     set liveSubAgentTrace(value: ChatMessage[]);
     get liveSubAgentName(): string | null;
@@ -274,16 +290,13 @@ export declare class FoundationAiAssistant extends GenesisElement {
     /** Hint text for the currently pinned agent, if any. Used in the toggle button tooltip. */
     get pinnedAgentHint(): string | undefined;
     /**
-     * The pin is locked when a stateful agent (one with lifecycle hooks) is
-     * *actively running* — i.e. its `onActivate` has fired and it owns live
-     * state. Until the user sends their first message, a freshly pinned stateful
-     * agent is not yet active and the picker should remain free; the user might
-     * change their mind and unpin without anything to clean up.
-     *
-     * We derive from `activeAgent` (set by the orchestrator after `onActivate`
-     * completes) rather than `pinnedAgentName` (set immediately on picker
-     * click). The serialized `activeAgent` strips lifecycle hooks, so we look
-     * up the live config from `this.agents` to check for them.
+     * The pin is locked when a stateful flow is mid-stream — i.e. some agent's
+     * `onActivate` has fired and it owns live state, and it hasn't yet called
+     * `releaseAgent`. Derives directly from `flowOwnerAgentName`, the
+     * single source of truth the orchestrator writes on activation and clears
+     * on release. Until the user sends their first message, a freshly pinned
+     * stateful agent is not yet active and the picker should remain free; the
+     * user might change their mind and unpin without anything to clean up.
      */
     get pinLocked(): boolean;
     /** Tooltip shown on the picker toggle button. */

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

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

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

@@ -40,9 +40,20 @@ export interface AiAssistantSessionState {
     /**
      * Name of the agent the user has pinned via the picker. `null` means the
      * orchestrator chooses each turn (Auto). Survives lifecycle events but
-     * resets on page refresh.
+     * resets on page refresh. Only changed by explicit user picker action (or
+     * the host's `setAgent` API) — never by the orchestrator's auto-pin on
+     * stateful activation. See {@link flowOwnerAgentName} for that.
      */
     pinnedAgentName: string | null;
+    /**
+     * Name of the agent that currently owns a guided flow — set by the
+     * orchestrator when a stateful agent's `onActivate` fires, cleared by
+     * `releaseAgent` or session teardown. While non-null, routing precedence
+     * goes to this agent and the picker is locked. Independent of
+     * {@link pinnedAgentName}: a flow can wrap up and release without
+     * disturbing the user's sticky picker choice.
+     */
+    flowOwnerAgentName: string | null;
     /**
      * Whether the agent picker slide-out panel is currently open. Lives in the
      * slice so the bubble-dialog and popout-panel instances stay in sync as the
@@ -78,6 +89,7 @@ export declare const aiAssistantSlice: import("@reduxjs/toolkit").Slice<AiAssist
     setActiveModel(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string | undefined>): void;
     setActiveAgent(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<Omit<AgentConfig, "toolHandlers"> | undefined>): void;
     setPinnedAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string | null>): void;
+    setFlowOwnerAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string | null>): void;
     setAgentPickerOpen(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<boolean>): void;
     setInputValue(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<string>): void;
     setLiveSubAgentTrace(state: import("immer").WritableDraft<AiAssistantSessionState>, action: PayloadAction<ChatMessage[]>): void;

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

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

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

@@ -14,6 +14,7 @@ declare function makeStore(devTools: boolean | undefined): import("@genesislcap/
     setActiveModel(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string | undefined>): void;
     setActiveAgent(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<Omit<import("..").AgentConfig, "toolHandlers"> | undefined>): void;
     setPinnedAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string | null>): void;
+    setFlowOwnerAgentName(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string | null>): void;
     setAgentPickerOpen(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<boolean>): void;
     setInputValue(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<string>): void;
     setLiveSubAgentTrace(state: import("immer").WritableDraft<AiAssistantSessionState>, action: import("@reduxjs/toolkit").PayloadAction<import("@genesislcap/foundation-ai").ChatMessage[]>): void;

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

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

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

@@ -60,7 +60,21 @@ export class OrchestratingDriver extends EventTarget {
          * so long-running `onActivate` work can bail if the session disconnects.
          */
         this.lifecycleAbortController = new AbortController();
+        /**
+         * Sticky user pick from the picker (or the host's `setAgent` API). Only
+         * changes on explicit user action. Survives flow completion: when a stateful
+         * agent releases, the user-pin stays put and routing falls back to it on
+         * the next turn.
+         */
         this.pinnedAgentName = null;
+        /**
+         * Transient flow lock — set when a stateful agent's `onActivate` fires,
+         * cleared by `releaseActiveAgent`. While non-null, routing precedence goes
+         * to this agent and the picker is locked. Independent of
+         * `pinnedAgentName` so completing a flow doesn't wipe the user's sticky
+         * choice.
+         */
+        this.flowOwnerAgentName = null;
         this.sessionKey = (_a = options.sessionKey) !== null && _a !== void 0 ? _a : '';
         this.maxHandoffs = (_b = options.maxHandoffs) !== null && _b !== void 0 ? _b : DEFAULT_MAX_HANDOFFS;
         this.classifierHistoryLength =
@@ -112,6 +126,15 @@ export class OrchestratingDriver extends EventTarget {
     setPinnedAgent(name) {
         this.pinnedAgentName = name;
     }
+    /**
+     * Set the flow-owner lock — used to restore state from Redux on driver
+     * reconstruction (agents-array changes, pop-in/pop-out). Not intended for
+     * external callers to manipulate routing; that's what `setPinnedAgent` is
+     * for.
+     */
+    setFlowOwner(name) {
+        this.flowOwnerAgentName = name;
+    }
     loadHistory(messages) {
         this.chatDriver.loadHistory(messages);
     }
@@ -238,24 +261,30 @@ export class OrchestratingDriver extends EventTarget {
                 }
             }
             const hasLifecycleHooks = !!(agent.onActivate || agent.onDeactivate);
-            // Stateful agents auto-pin on activation. The pin guarantees the machine
-            // survives subsequent turns (the classifier would otherwise be free to
-            // route away mid-flow, tearing the machine down). Release happens when the
-            // agent calls `releaseAgent` from a terminal-state tool handler — see the
-            // post-sendMessage check below.
-            if (isSwitch && hasLifecycleHooks && this.pinnedAgentName !== agent.name) {
-                this.pinnedAgentName = agent.name;
-                this.dispatchEvent(new CustomEvent('pinned-changed', { detail: agent.name }));
+            // Stateful agents auto-lock the flow on activation. The lock guarantees
+            // the machine survives subsequent turns (the classifier would otherwise be
+            // free to route away mid-flow, tearing the machine down). Release happens
+            // when the agent calls `releaseAgent` from a terminal-state tool handler
+            // — see the post-sendMessage check below. We write `flowOwnerAgentName`
+            // rather than `pinnedAgentName` so completing a flow doesn't wipe the
+            // user's sticky picker choice.
+            if (isSwitch && hasLifecycleHooks && this.flowOwnerAgentName !== agent.name) {
+                this.flowOwnerAgentName = agent.name;
+                this.dispatchEvent(new CustomEvent('flow-owner-changed', { detail: agent.name }));
             }
-            // Terminal agents do not get the cross-agent handoff tool. Three cases:
-            //   • fallback — already a leaf; handoff would loop
-            //   • pinned   — user explicitly selected this agent; do not auto-route away
-            //   • stateful — agents with lifecycle hooks own state for the duration of
-            //                their flow. Initiating a handoff mid-flow would abandon
-            //                that state with no clean exit and dump the user into the
-            //                classifier mid-machine. Capture the tool loop until the
-            //                user (or the agent itself, via `releaseAgent`) releases.
-            const isTerminal = isFallback(agent) || this.pinnedAgentName !== null || hasLifecycleHooks;
+            // Terminal agents do not get the cross-agent handoff tool. Four cases:
+            //   • fallback     — already a leaf; handoff would loop
+            //   • user-pinned  — user explicitly selected this agent; do not auto-route away
+            //   • flow-owner   — a stateful flow is mid-stream; do not auto-route away
+            //   • stateful     — agents with lifecycle hooks own state for the duration of
+            //                    their flow. Initiating a handoff mid-flow would abandon
+            //                    that state with no clean exit and dump the user into the
+            //                    classifier mid-machine. Capture the tool loop until the
+            //                    user (or the agent itself, via `releaseAgent`) releases.
+            const isTerminal = isFallback(agent) ||
+                this.pinnedAgentName !== null ||
+                this.flowOwnerAgentName !== null ||
+                hasLifecycleHooks;
             let agentToApply = agent;
             if (!isTerminal) {
                 const declaredTools = agent.toolDefinitions;
@@ -280,9 +309,15 @@ export class OrchestratingDriver extends EventTarget {
         });
     }
     /**
-     * Release the current stateful agent: fire `onDeactivate`, clear the pin,
-     * dispatch events so the host (and Redux) reflect the unpinned state. Called
-     * automatically when a tool handler invokes `context.releaseAgent`.
+     * Release the current stateful agent: fire `onDeactivate`, clear the
+     * flow-owner lock, dispatch events so the host (and Redux) reflect the
+     * unlocked state. Called automatically when a tool handler invokes
+     * `context.releaseAgent`.
+     *
+     * The user-pin (`pinnedAgentName`) is intentionally *not* cleared — a user
+     * who explicitly picked this agent should stay on it after the flow ends,
+     * so the next message starts a fresh flow on the same agent rather than
+     * routing through the classifier.
      */
     releaseActiveAgent() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -302,9 +337,9 @@ export class OrchestratingDriver extends EventTarget {
                 }
             }
             this.activeAgent = undefined;
-            if (this.pinnedAgentName !== null) {
-                this.pinnedAgentName = null;
-                this.dispatchEvent(new CustomEvent('pinned-changed', { detail: null }));
+            if (this.flowOwnerAgentName !== null) {
+                this.flowOwnerAgentName = null;
+                this.dispatchEvent(new CustomEvent('flow-owner-changed', { detail: null }));
             }
             this.dispatchEvent(new CustomEvent('agent-released', { detail: agent }));
             this.dispatchEvent(new CustomEvent('agent-changed', { detail: undefined }));
@@ -418,16 +453,21 @@ export class OrchestratingDriver extends EventTarget {
         });
     }
     /**
-     * Returns the pinned agent if `pinnedAgentName` matches a known specialist or
-     * fallback. Logs and returns `undefined` if pinned to a name that no longer
-     * exists in the agents array — caller falls back to the classifier.
+     * Returns the agent that the current turn is locked to, if any. Flow-owner
+     * (transient, set by stateful-agent activation) wins over user-pin (sticky,
+     * set by picker click). `undefined` falls back to the classifier.
+     *
+     * Logs and returns `undefined` if a name no longer matches the agents array
+     * — protects against stale state after an agents-array reassignment.
      */
     resolvePinnedAgent() {
-        if (this.pinnedAgentName === null)
+        var _a;
+        const name = (_a = this.flowOwnerAgentName) !== null && _a !== void 0 ? _a : this.pinnedAgentName;
+        if (name === null)
             return undefined;
-        const match = this.agents.find((a) => a.name === this.pinnedAgentName);
+        const match = this.agents.find((a) => a.name === name);
         if (!match) {
-            logger.warn(`OrchestratingDriver: pinned agent "${this.pinnedAgentName}" not found in agents array — falling back to classifier.`);
+            logger.warn(`OrchestratingDriver: pinned agent "${name}" not found in agents array — falling back to classifier.`);
             return undefined;
         }
         return match;

package/dist/esm/main/main.js

@@ -303,6 +303,11 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
      * Name of the agent the user has pinned via the agent picker. `null` means
      * automatic routing (Auto). Persisted on the session store, so it survives
      * pop-in/pop-out but resets on page refresh.
+     *
+     * Only changes on explicit user action (picker click or host's `setAgent`).
+     * The orchestrator's auto-pin on stateful activation writes
+     * `flowOwnerAgentName` instead, so finishing a guided flow doesn't wipe
+     * the user's sticky pick.
      */
     get pinnedAgentName() {
         var _a, _b;
@@ -322,6 +327,26 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             this.fetchSuggestions();
         }
     }
+    /**
+     * Name of the agent that currently owns a guided flow. Set by the
+     * orchestrator when a stateful agent's `onActivate` fires, cleared when the
+     * agent calls `releaseAgent` from a terminal-state tool handler. While
+     * non-null, routing precedence goes to this agent and the picker is locked.
+     *
+     * Independent of `pinnedAgentName`: a flow can complete and release
+     * without disturbing the user's sticky picker choice.
+     */
+    get flowOwnerAgentName() {
+        var _a, _b;
+        return (_b = (_a = this._sessionRef) === null || _a === void 0 ? void 0 : _a.store.aiAssistant.flowOwnerAgentName) !== null && _b !== void 0 ? _b : null;
+    }
+    set flowOwnerAgentName(value) {
+        var _a;
+        (_a = this._sessionRef) === null || _a === void 0 ? void 0 : _a.actions.aiAssistant.setFlowOwnerAgentName(value);
+        if (this.driver instanceof OrchestratingDriver) {
+            this.driver.setFlowOwner(value);
+        }
+    }
     get liveSubAgentTrace() {
         var _a, _b;
         return (_b = (_a = this._sessionRef) === null || _a === void 0 ? void 0 : _a.store.aiAssistant.liveSubAgentTrace) !== null && _b !== void 0 ? _b : [];
@@ -517,6 +542,13 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         if (oldDriver && 'dispose' in oldDriver && typeof oldDriver.dispose === 'function') {
             void oldDriver.dispose();
         }
+        // Clear any in-flight flow-owner lock from Redux too. The old machine has
+        // been disposed; we don't want the new driver re-locking to a flow that
+        // no longer has state behind it. User-pin survives — it's the user's
+        // sticky picker choice, not flow state.
+        if (this.flowOwnerAgentName !== null) {
+            this.flowOwnerAgentName = null;
+        }
         this.driver = getOrCreateDriver(key, () => this.createDriver());
         this.wireDriver();
         if (history.length)
@@ -679,9 +711,11 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             () => driver.removeEventListener('interaction-stop', onInteractionStop),
         ];
         if (driver instanceof OrchestratingDriver) {
-            // Restore any pinned agent from the session store onto the freshly built
-            // driver, so pop-in/pop-out and agents-array reassignment preserve the pin.
+            // Restore the user pin and flow-owner lock from the session store onto
+            // the freshly built driver, so pop-in/pop-out and agents-array
+            // reassignment preserve both.
             driver.setPinnedAgent(this.pinnedAgentName);
+            driver.setFlowOwner(this.flowOwnerAgentName);
             const onOrchStart = () => {
                 this.showHalo = 'orchestrating';
             };
@@ -692,10 +726,12 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             const onAgentChanged = (e) => {
                 this.activeAgent = e.detail;
             };
-            // Orchestrator-initiated pin changes (auto-pin on stateful activation,
-            // auto-clear on release). User-initiated pins flow the other direction
-            // via the `pinnedAgentName` setter, which already calls setPinnedAgent
-            // back into the driver — guard against the redundant round-trip.
+            // User-initiated pin changes flow into the driver via the
+            // `pinnedAgentName` setter, which already calls setPinnedAgent — no
+            // event-driven mirror needed in this direction. The driver does still
+            // emit `'pinned-changed'` if other code ever calls `setPinnedAgent`
+            // directly, so keep the mirror for safety; guard against the redundant
+            // round-trip caused by our own setter call.
             const onPinnedChanged = (e) => {
                 var _a, _b;
                 const name = e.detail;
@@ -703,11 +739,22 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
                     (_b = this._sessionRef) === null || _b === void 0 ? void 0 : _b.actions.aiAssistant.setPinnedAgentName(name);
                 }
             };
+            // Orchestrator-initiated flow-owner changes (auto-lock on stateful
+            // activation, auto-clear on release). Mirror to Redux so the UI freeze
+            // state and `pinLocked` survive component remount.
+            const onFlowOwnerChanged = (e) => {
+                var _a, _b;
+                const name = e.detail;
+                if (((_a = this._sessionRef) === null || _a === void 0 ? void 0 : _a.store.aiAssistant.flowOwnerAgentName) !== name) {
+                    (_b = this._sessionRef) === null || _b === void 0 ? void 0 : _b.actions.aiAssistant.setFlowOwnerAgentName(name);
+                }
+            };
             driver.addEventListener('orchestrating-start', onOrchStart);
             driver.addEventListener('orchestrating-stop', onOrchStop);
             driver.addEventListener('agent-changed', onAgentChanged);
             driver.addEventListener('pinned-changed', onPinnedChanged);
-            cleanups.push(() => driver.removeEventListener('orchestrating-start', onOrchStart), () => driver.removeEventListener('orchestrating-stop', onOrchStop), () => driver.removeEventListener('agent-changed', onAgentChanged), () => driver.removeEventListener('pinned-changed', onPinnedChanged));
+            driver.addEventListener('flow-owner-changed', onFlowOwnerChanged);
+            cleanups.push(() => driver.removeEventListener('orchestrating-start', onOrchStart), () => driver.removeEventListener('orchestrating-stop', onOrchStop), () => driver.removeEventListener('agent-changed', onAgentChanged), () => driver.removeEventListener('pinned-changed', onPinnedChanged), () => driver.removeEventListener('flow-owner-changed', onFlowOwnerChanged));
         }
         this.driverCleanup = () => {
             for (const fn of cleanups)
@@ -1024,25 +1071,16 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         return (_c = (_b = (_a = this.agents) === null || _a === void 0 ? void 0 : _a.find((a) => a.name === this.pinnedAgentName)) === null || _b === void 0 ? void 0 : _b.manualSelection) === null || _c === void 0 ? void 0 : _c.hint;
     }
     /**
-     * The pin is locked when a stateful agent (one with lifecycle hooks) is
-     * *actively running* — i.e. its `onActivate` has fired and it owns live
-     * state. Until the user sends their first message, a freshly pinned stateful
-     * agent is not yet active and the picker should remain free; the user might
-     * change their mind and unpin without anything to clean up.
-     *
-     * We derive from `activeAgent` (set by the orchestrator after `onActivate`
-     * completes) rather than `pinnedAgentName` (set immediately on picker
-     * click). The serialized `activeAgent` strips lifecycle hooks, so we look
-     * up the live config from `this.agents` to check for them.
+     * The pin is locked when a stateful flow is mid-stream — i.e. some agent's
+     * `onActivate` has fired and it owns live state, and it hasn't yet called
+     * `releaseAgent`. Derives directly from `flowOwnerAgentName`, the
+     * single source of truth the orchestrator writes on activation and clears
+     * on release. Until the user sends their first message, a freshly pinned
+     * stateful agent is not yet active and the picker should remain free; the
+     * user might change their mind and unpin without anything to clean up.
      */
     get pinLocked() {
-        var _a;
-        if (!this.activeAgent)
-            return false;
-        const live = (_a = this.agents) === null || _a === void 0 ? void 0 : _a.find((a) => a.name === this.activeAgent.name);
-        if (!live)
-            return false;
-        return !!(live.onActivate || live.onDeactivate);
+        return this.flowOwnerAgentName !== null;
     }
     /** Tooltip shown on the picker toggle button. */
     get agentToggleTitle() {

package/dist/esm/state/ai-assistant-slice.js

@@ -13,6 +13,7 @@ export const defaultSessionState = {
     activeModel: undefined,
     activeAgent: undefined,
     pinnedAgentName: null,
+    flowOwnerAgentName: null,
     agentPickerOpen: false,
     inputValue: '',
     liveSubAgentTrace: [],
@@ -62,6 +63,9 @@ export const aiAssistantSlice = createSlice({
         setPinnedAgentName(state, action) {
             state.pinnedAgentName = action.payload;
         },
+        setFlowOwnerAgentName(state, action) {
+            state.flowOwnerAgentName = action.payload;
+        },
         setAgentPickerOpen(state, action) {
             state.agentPickerOpen = action.payload;
         },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "14.443.1",
+  "version": "14.444.1",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -64,24 +64,24 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.443.1",
-    "@genesislcap/genx": "14.443.1",
-    "@genesislcap/rollup-builder": "14.443.1",
-    "@genesislcap/ts-builder": "14.443.1",
-    "@genesislcap/uvu-playwright-builder": "14.443.1",
-    "@genesislcap/vite-builder": "14.443.1",
-    "@genesislcap/webpack-builder": "14.443.1",
+    "@genesislcap/foundation-testing": "14.444.1",
+    "@genesislcap/genx": "14.444.1",
+    "@genesislcap/rollup-builder": "14.444.1",
+    "@genesislcap/ts-builder": "14.444.1",
+    "@genesislcap/uvu-playwright-builder": "14.444.1",
+    "@genesislcap/vite-builder": "14.444.1",
+    "@genesislcap/webpack-builder": "14.444.1",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.443.1",
-    "@genesislcap/foundation-logger": "14.443.1",
-    "@genesislcap/foundation-redux": "14.443.1",
-    "@genesislcap/foundation-ui": "14.443.1",
-    "@genesislcap/foundation-utils": "14.443.1",
-    "@genesislcap/rapid-design-system": "14.443.1",
-    "@genesislcap/web-core": "14.443.1",
+    "@genesislcap/foundation-ai": "14.444.1",
+    "@genesislcap/foundation-logger": "14.444.1",
+    "@genesislcap/foundation-redux": "14.444.1",
+    "@genesislcap/foundation-ui": "14.444.1",
+    "@genesislcap/foundation-utils": "14.444.1",
+    "@genesislcap/rapid-design-system": "14.444.1",
+    "@genesislcap/web-core": "14.444.1",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
@@ -93,5 +93,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "a10ca31c4ba209c31a50b507dc473ecd5791fc21"
+  "gitHead": "837befe80b4972686cb48fe7d86334c5d819ced6"
 }

package/src/components/orchestrating-driver/orchestrating-driver.ts

@@ -91,7 +91,21 @@ export class OrchestratingDriver extends EventTarget implements AiDriver {
    * so long-running `onActivate` work can bail if the session disconnects.
    */
   private readonly lifecycleAbortController = new AbortController();
+  /**
+   * Sticky user pick from the picker (or the host's `setAgent` API). Only
+   * changes on explicit user action. Survives flow completion: when a stateful
+   * agent releases, the user-pin stays put and routing falls back to it on
+   * the next turn.
+   */
   private pinnedAgentName: string | null = null;
+  /**
+   * Transient flow lock — set when a stateful agent's `onActivate` fires,
+   * cleared by `releaseActiveAgent`. While non-null, routing precedence goes
+   * to this agent and the picker is locked. Independent of
+   * `pinnedAgentName` so completing a flow doesn't wipe the user's sticky
+   * choice.
+   */
+  private flowOwnerAgentName: string | null = null;
 
   activeAgent?: AgentConfig;
 
@@ -186,6 +200,16 @@ export class OrchestratingDriver extends EventTarget implements AiDriver {
     this.pinnedAgentName = name;
   }
 
+  /**
+   * Set the flow-owner lock — used to restore state from Redux on driver
+   * reconstruction (agents-array changes, pop-in/pop-out). Not intended for
+   * external callers to manipulate routing; that's what `setPinnedAgent` is
+   * for.
+   */
+  setFlowOwner(name: string | null): void {
+    this.flowOwnerAgentName = name;
+  }
+
   loadHistory(messages: ChatMessage[]): void {
     this.chatDriver.loadHistory(messages);
   }
@@ -329,25 +353,32 @@ export class OrchestratingDriver extends EventTarget implements AiDriver {
 
     const hasLifecycleHooks = !!(agent.onActivate || agent.onDeactivate);
 
-    // Stateful agents auto-pin on activation. The pin guarantees the machine
-    // survives subsequent turns (the classifier would otherwise be free to
-    // route away mid-flow, tearing the machine down). Release happens when the
-    // agent calls `releaseAgent` from a terminal-state tool handler — see the
-    // post-sendMessage check below.
-    if (isSwitch && hasLifecycleHooks && this.pinnedAgentName !== agent.name) {
-      this.pinnedAgentName = agent.name;
-      this.dispatchEvent(new CustomEvent('pinned-changed', { detail: agent.name }));
+    // Stateful agents auto-lock the flow on activation. The lock guarantees
+    // the machine survives subsequent turns (the classifier would otherwise be
+    // free to route away mid-flow, tearing the machine down). Release happens
+    // when the agent calls `releaseAgent` from a terminal-state tool handler
+    // — see the post-sendMessage check below. We write `flowOwnerAgentName`
+    // rather than `pinnedAgentName` so completing a flow doesn't wipe the
+    // user's sticky picker choice.
+    if (isSwitch && hasLifecycleHooks && this.flowOwnerAgentName !== agent.name) {
+      this.flowOwnerAgentName = agent.name;
+      this.dispatchEvent(new CustomEvent('flow-owner-changed', { detail: agent.name }));
     }
 
-    // Terminal agents do not get the cross-agent handoff tool. Three cases:
-    //   • fallback — already a leaf; handoff would loop
-    //   • pinned   — user explicitly selected this agent; do not auto-route away
-    //   • stateful — agents with lifecycle hooks own state for the duration of
-    //                their flow. Initiating a handoff mid-flow would abandon
-    //                that state with no clean exit and dump the user into the
-    //                classifier mid-machine. Capture the tool loop until the
-    //                user (or the agent itself, via `releaseAgent`) releases.
-    const isTerminal = isFallback(agent) || this.pinnedAgentName !== null || hasLifecycleHooks;
+    // Terminal agents do not get the cross-agent handoff tool. Four cases:
+    //   • fallback     — already a leaf; handoff would loop
+    //   • user-pinned  — user explicitly selected this agent; do not auto-route away
+    //   • flow-owner   — a stateful flow is mid-stream; do not auto-route away
+    //   • stateful     — agents with lifecycle hooks own state for the duration of
+    //                    their flow. Initiating a handoff mid-flow would abandon
+    //                    that state with no clean exit and dump the user into the
+    //                    classifier mid-machine. Capture the tool loop until the
+    //                    user (or the agent itself, via `releaseAgent`) releases.
+    const isTerminal =
+      isFallback(agent) ||
+      this.pinnedAgentName !== null ||
+      this.flowOwnerAgentName !== null ||
+      hasLifecycleHooks;
 
     let agentToApply: AgentConfig = agent;
     if (!isTerminal) {
@@ -377,9 +408,15 @@ export class OrchestratingDriver extends EventTarget implements AiDriver {
   }
 
   /**
-   * Release the current stateful agent: fire `onDeactivate`, clear the pin,
-   * dispatch events so the host (and Redux) reflect the unpinned state. Called
-   * automatically when a tool handler invokes `context.releaseAgent`.
+   * Release the current stateful agent: fire `onDeactivate`, clear the
+   * flow-owner lock, dispatch events so the host (and Redux) reflect the
+   * unlocked state. Called automatically when a tool handler invokes
+   * `context.releaseAgent`.
+   *
+   * The user-pin (`pinnedAgentName`) is intentionally *not* cleared — a user
+   * who explicitly picked this agent should stay on it after the flow ends,
+   * so the next message starts a fresh flow on the same agent rather than
+   * routing through the classifier.
    */
   private async releaseActiveAgent(): Promise<void> {
     const agent = this.activeAgent;
@@ -396,9 +433,9 @@ export class OrchestratingDriver extends EventTarget implements AiDriver {
       }
     }
     this.activeAgent = undefined;
-    if (this.pinnedAgentName !== null) {
-      this.pinnedAgentName = null;
-      this.dispatchEvent(new CustomEvent('pinned-changed', { detail: null }));
+    if (this.flowOwnerAgentName !== null) {
+      this.flowOwnerAgentName = null;
+      this.dispatchEvent(new CustomEvent('flow-owner-changed', { detail: null }));
     }
     this.dispatchEvent(new CustomEvent('agent-released', { detail: agent }));
     this.dispatchEvent(new CustomEvent('agent-changed', { detail: undefined }));
@@ -522,16 +559,20 @@ export class OrchestratingDriver extends EventTarget implements AiDriver {
   }
 
   /**
-   * Returns the pinned agent if `pinnedAgentName` matches a known specialist or
-   * fallback. Logs and returns `undefined` if pinned to a name that no longer
-   * exists in the agents array — caller falls back to the classifier.
+   * Returns the agent that the current turn is locked to, if any. Flow-owner
+   * (transient, set by stateful-agent activation) wins over user-pin (sticky,
+   * set by picker click). `undefined` falls back to the classifier.
+   *
+   * Logs and returns `undefined` if a name no longer matches the agents array
+   * — protects against stale state after an agents-array reassignment.
    */
   private resolvePinnedAgent(): AgentConfig | undefined {
-    if (this.pinnedAgentName === null) return undefined;
-    const match = this.agents.find((a) => a.name === this.pinnedAgentName);
+    const name = this.flowOwnerAgentName ?? this.pinnedAgentName;
+    if (name === null) return undefined;
+    const match = this.agents.find((a) => a.name === name);
     if (!match) {
       logger.warn(
-        `OrchestratingDriver: pinned agent "${this.pinnedAgentName}" not found in agents array — falling back to classifier.`,
+        `OrchestratingDriver: pinned agent "${name}" not found in agents array — falling back to classifier.`,
       );
       return undefined;
     }

package/src/main/main.ts

@@ -329,6 +329,11 @@ export class FoundationAiAssistant extends GenesisElement {
    * Name of the agent the user has pinned via the agent picker. `null` means
    * automatic routing (Auto). Persisted on the session store, so it survives
    * pop-in/pop-out but resets on page refresh.
+   *
+   * Only changes on explicit user action (picker click or host's `setAgent`).
+   * The orchestrator's auto-pin on stateful activation writes
+   * `flowOwnerAgentName` instead, so finishing a guided flow doesn't wipe
+   * the user's sticky pick.
    */
   get pinnedAgentName(): string | null {
     return this._sessionRef?.store.aiAssistant.pinnedAgentName ?? null;
@@ -347,6 +352,25 @@ export class FoundationAiAssistant extends GenesisElement {
     }
   }
 
+  /**
+   * Name of the agent that currently owns a guided flow. Set by the
+   * orchestrator when a stateful agent's `onActivate` fires, cleared when the
+   * agent calls `releaseAgent` from a terminal-state tool handler. While
+   * non-null, routing precedence goes to this agent and the picker is locked.
+   *
+   * Independent of `pinnedAgentName`: a flow can complete and release
+   * without disturbing the user's sticky picker choice.
+   */
+  get flowOwnerAgentName(): string | null {
+    return this._sessionRef?.store.aiAssistant.flowOwnerAgentName ?? null;
+  }
+  set flowOwnerAgentName(value: string | null) {
+    this._sessionRef?.actions.aiAssistant.setFlowOwnerAgentName(value);
+    if (this.driver instanceof OrchestratingDriver) {
+      this.driver.setFlowOwner(value);
+    }
+  }
+
   get liveSubAgentTrace(): ChatMessage[] {
     return this._sessionRef?.store.aiAssistant.liveSubAgentTrace ?? [];
   }
@@ -590,6 +614,13 @@ export class FoundationAiAssistant extends GenesisElement {
     if (oldDriver && 'dispose' in oldDriver && typeof oldDriver.dispose === 'function') {
       void oldDriver.dispose();
     }
+    // Clear any in-flight flow-owner lock from Redux too. The old machine has
+    // been disposed; we don't want the new driver re-locking to a flow that
+    // no longer has state behind it. User-pin survives — it's the user's
+    // sticky picker choice, not flow state.
+    if (this.flowOwnerAgentName !== null) {
+      this.flowOwnerAgentName = null;
+    }
     this.driver = getOrCreateDriver(key, () => this.createDriver());
     this.wireDriver();
     if (history.length) this.driver.loadHistory([...history]);
@@ -766,9 +797,11 @@ export class FoundationAiAssistant extends GenesisElement {
     ];
 
     if (driver instanceof OrchestratingDriver) {
-      // Restore any pinned agent from the session store onto the freshly built
-      // driver, so pop-in/pop-out and agents-array reassignment preserve the pin.
+      // Restore the user pin and flow-owner lock from the session store onto
+      // the freshly built driver, so pop-in/pop-out and agents-array
+      // reassignment preserve both.
       driver.setPinnedAgent(this.pinnedAgentName);
+      driver.setFlowOwner(this.flowOwnerAgentName);
       const onOrchStart = () => {
         this.showHalo = 'orchestrating';
       };
@@ -778,25 +811,38 @@ export class FoundationAiAssistant extends GenesisElement {
       const onAgentChanged = (e: Event) => {
         this.activeAgent = (e as CustomEvent<AgentConfig>).detail;
       };
-      // Orchestrator-initiated pin changes (auto-pin on stateful activation,
-      // auto-clear on release). User-initiated pins flow the other direction
-      // via the `pinnedAgentName` setter, which already calls setPinnedAgent
-      // back into the driver — guard against the redundant round-trip.
+      // User-initiated pin changes flow into the driver via the
+      // `pinnedAgentName` setter, which already calls setPinnedAgent — no
+      // event-driven mirror needed in this direction. The driver does still
+      // emit `'pinned-changed'` if other code ever calls `setPinnedAgent`
+      // directly, so keep the mirror for safety; guard against the redundant
+      // round-trip caused by our own setter call.
       const onPinnedChanged = (e: Event) => {
         const name = (e as CustomEvent<string | null>).detail;
         if (this._sessionRef?.store.aiAssistant.pinnedAgentName !== name) {
           this._sessionRef?.actions.aiAssistant.setPinnedAgentName(name);
         }
       };
+      // Orchestrator-initiated flow-owner changes (auto-lock on stateful
+      // activation, auto-clear on release). Mirror to Redux so the UI freeze
+      // state and `pinLocked` survive component remount.
+      const onFlowOwnerChanged = (e: Event) => {
+        const name = (e as CustomEvent<string | null>).detail;
+        if (this._sessionRef?.store.aiAssistant.flowOwnerAgentName !== name) {
+          this._sessionRef?.actions.aiAssistant.setFlowOwnerAgentName(name);
+        }
+      };
       driver.addEventListener('orchestrating-start', onOrchStart);
       driver.addEventListener('orchestrating-stop', onOrchStop);
       driver.addEventListener('agent-changed', onAgentChanged);
       driver.addEventListener('pinned-changed', onPinnedChanged);
+      driver.addEventListener('flow-owner-changed', onFlowOwnerChanged);
       cleanups.push(
         () => driver.removeEventListener('orchestrating-start', onOrchStart),
         () => driver.removeEventListener('orchestrating-stop', onOrchStop),
         () => driver.removeEventListener('agent-changed', onAgentChanged),
         () => driver.removeEventListener('pinned-changed', onPinnedChanged),
+        () => driver.removeEventListener('flow-owner-changed', onFlowOwnerChanged),
       );
     }
 
@@ -1144,23 +1190,17 @@ export class FoundationAiAssistant extends GenesisElement {
   }
 
   /**
-   * The pin is locked when a stateful agent (one with lifecycle hooks) is
-   * *actively running* — i.e. its `onActivate` has fired and it owns live
-   * state. Until the user sends their first message, a freshly pinned stateful
-   * agent is not yet active and the picker should remain free; the user might
-   * change their mind and unpin without anything to clean up.
-   *
-   * We derive from `activeAgent` (set by the orchestrator after `onActivate`
-   * completes) rather than `pinnedAgentName` (set immediately on picker
-   * click). The serialized `activeAgent` strips lifecycle hooks, so we look
-   * up the live config from `this.agents` to check for them.
+   * The pin is locked when a stateful flow is mid-stream — i.e. some agent's
+   * `onActivate` has fired and it owns live state, and it hasn't yet called
+   * `releaseAgent`. Derives directly from `flowOwnerAgentName`, the
+   * single source of truth the orchestrator writes on activation and clears
+   * on release. Until the user sends their first message, a freshly pinned
+   * stateful agent is not yet active and the picker should remain free; the
+   * user might change their mind and unpin without anything to clean up.
    */
   @volatile
   get pinLocked(): boolean {
-    if (!this.activeAgent) return false;
-    const live = this.agents?.find((a) => a.name === this.activeAgent!.name);
-    if (!live) return false;
-    return !!(live.onActivate || live.onDeactivate);
+    return this.flowOwnerAgentName !== null;
   }
 
   /** Tooltip shown on the picker toggle button. */

package/src/state/ai-assistant-slice.ts

@@ -43,9 +43,20 @@ export interface AiAssistantSessionState {
   /**
    * Name of the agent the user has pinned via the picker. `null` means the
    * orchestrator chooses each turn (Auto). Survives lifecycle events but
-   * resets on page refresh.
+   * resets on page refresh. Only changed by explicit user picker action (or
+   * the host's `setAgent` API) — never by the orchestrator's auto-pin on
+   * stateful activation. See {@link flowOwnerAgentName} for that.
    */
   pinnedAgentName: string | null;
+  /**
+   * Name of the agent that currently owns a guided flow — set by the
+   * orchestrator when a stateful agent's `onActivate` fires, cleared by
+   * `releaseAgent` or session teardown. While non-null, routing precedence
+   * goes to this agent and the picker is locked. Independent of
+   * {@link pinnedAgentName}: a flow can wrap up and release without
+   * disturbing the user's sticky picker choice.
+   */
+  flowOwnerAgentName: string | null;
   /**
    * Whether the agent picker slide-out panel is currently open. Lives in the
    * slice so the bubble-dialog and popout-panel instances stay in sync as the
@@ -81,6 +92,7 @@ export const defaultSessionState: AiAssistantSessionState = {
   activeModel: undefined,
   activeAgent: undefined,
   pinnedAgentName: null,
+  flowOwnerAgentName: null,
   agentPickerOpen: false,
   inputValue: '',
   liveSubAgentTrace: [],
@@ -131,6 +143,9 @@ export const aiAssistantSlice = createSlice({
     setPinnedAgentName(state, action: PayloadAction<string | null>) {
       state.pinnedAgentName = action.payload;
     },
+    setFlowOwnerAgentName(state, action: PayloadAction<string | null>) {
+      state.flowOwnerAgentName = action.payload;
+    },
     setAgentPickerOpen(state, action: PayloadAction<boolean>) {
       state.agentPickerOpen = action.payload;
     },